{"id":35221512,"url":"https://github.com/thaitype/nammatham","last_synced_at":"2026-04-04T12:57:33.689Z","repository":{"id":65384284,"uuid":"584158114","full_name":"thaitype/nammatham","owner":"thaitype","description":"Azure Functions Framework","archived":false,"fork":false,"pushed_at":"2024-12-24T11:41:45.000Z","size":2618,"stargazers_count":71,"open_issues_count":57,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-04T12:57:20.915Z","etag":null,"topics":["azure","azure-functions","faas","functions","hacktoberfest","nammatham","nodejs","serverless","typescript"],"latest_commit_sha":null,"homepage":"https://nammatham.thaitype.dev/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thaitype.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-01T16:16:58.000Z","updated_at":"2025-10-15T22:33:08.000Z","dependencies_parsed_at":"2023-03-10T18:45:03.134Z","dependency_job_id":"9d56fc2e-fc84-4ec8-a3d7-5e04b0752846","html_url":"https://github.com/thaitype/nammatham","commit_stats":null,"previous_names":["mildronize/nammatham","mildronize/azure-functions"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/thaitype/nammatham","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thaitype%2Fnammatham","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thaitype%2Fnammatham/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thaitype%2Fnammatham/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thaitype%2Fnammatham/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thaitype","download_url":"https://codeload.github.com/thaitype/nammatham/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thaitype%2Fnammatham/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31400460,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["azure","azure-functions","faas","functions","hacktoberfest","nammatham","nodejs","serverless","typescript"],"created_at":"2025-12-30T00:05:37.106Z","updated_at":"2026-04-04T12:57:33.678Z","avatar_url":"https://github.com/thaitype.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"http://thadaw.com/\" target=\"blank\"\u003e\u003cimg src=\"https://i.ibb.co/QmTh7x4/Nammatham-Logo-v2.png\" width=\"120\" alt=\"Nammatham Logo\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\nType-safe Serverless Library for Azure Functions and friends \n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://www.npmjs.com/package/nammatham\"\u003e\u003cimg alt=\"NPM Version (with dist tag)\" src=\"https://img.shields.io/npm/v/nammatham/alpha\"\u003e\n \u003ca href=\"https://www.npmjs.com/package/nammatham\"\u003e\u003cimg src=\"https://img.shields.io/npm/dt/nammatham\" alt=\"npm download\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n\n\u003e 🚧 Alpha Stage: Internal Use Only 🚧\n\u003e \n\u003e Please note that Nammatham v2 is currently in its Alpha stage and is intended for internal use only. As we actively develop and refine the platform, be aware that the API may undergo frequent changes. [Tracking v2 Roadmap](https://github.com/thaitype/nammatham/issues?q=is%3Aissue+is%3Aopen+label%3Av2-blocker)\n\u003e \n\u003e Note: [Nammatham v1](https://www.npmjs.com/package/nammatham) is currently in maintenance mode. no new features are actively being developed\n\nYou're reading v2 docs\n\n\n| Version | Status      | Azure Functions \u003cbr\u003eNode.js Lib | Branch       | Build Status                                                                                                                                                                                                                                                                                                                |\n| ------- | ----------- | ----------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| v1.x    | Maintenance | v3.x                    | [v1.x][v1.x] | [![Build \u0026 Test](https://github.com/thaitype/nammatham/actions/workflows/test.yml/badge.svg?branch=v1.x)](https://github.com/thaitype/nammatham/actions/workflows/test.yml) [![codecov](https://codecov.io/gh/thaitype/nammatham/branch/v1.x/graph/badge.svg?token=Y7ZMDKFPAN)](https://codecov.io/gh/thaitype/nammatham) |\n| v2.x    | Alpha       | v4.x                    | [main][main] | [![Build \u0026 Test](https://github.com/thaitype/nammatham/actions/workflows/test.yml/badge.svg?branch=main.unittest)](https://github.com/thaitype/nammatham/actions/workflows/test.yml) [![codecov](https://codecov.io/gh/thaitype/nammatham/branch/main/graph/badge.svg?token=Y7ZMDKFPAN)](https://codecov.io/gh/thaitype/nammatham)                                                                                                                                        |\n\n[v1.x]: https://github.com/thaitype/nammatham/tree/v1.x\n[main]: https://github.com/thaitype/nammatham/tree/main\n\n## Description\nNammatham (นามธรรม in Thai, pronounced `/naam ma tham/`, means **abstract** in Thai) is Azure Function Nodejs.\n\n## Getting Started for Azure Functions\n\n### Install\n\n```bash\n# Including all packages\nnpm install nammatham@alpha\n```\n\n### Example\n\nYou can see [examples](examples) or follow the minimal app getting started below:\n\n\u003e `initNammatham.create()` is a factory function for creating Nammatham App, it's a wrapper for Azure Functions App.\n\n```typescript\nimport { initNammatham, expressPlugin } from 'nammatham';\n\nconst n = initNammatham.create();\nconst func = n.func;\nconst app = n.app;\n\nconst helloFunction = func\n  .httpGet('hello', {\n    route: 'hello-world',\n  })\n  .handler(async c =\u003e {\n    c.context.log('HTTP trigger function processed a request.');\n    c.context.debug(`Http function processed request for url \"${c.trigger.url}\"`);\n    const name = c.trigger.query.get('name') || (await c.trigger.text()) || 'world';\n    return c.text(`Hello, ${name}!`);\n  });\n\napp.addFunctions(helloFunction);\n\nconst dev = process.env.NODE_ENV === 'development';\napp.register(expressPlugin({ dev }));\napp.start();\n```\n\nThen edit `package.json` like this;\n\n```json\n{\n  \"main\": \"dist/src/main.js\",\n  \"scripts\": {\n    \"dev\": \"cross-env NODE_ENV=development tsx watch src/main.ts\",\n    \"start\": \"tsc \u0026\u0026 func start\"\n  }\n}\n```\n\nRun Dev Server on locally, (For dev server use `tsx watch` for reloading run dev server using `express` )\n\n```\nnpm run dev\n```\n\nRun Azure Functions on locally (Using Official Azure Functions Node.js)\n\n```\nnpm start\n```\n\n\n## Nammatham Packages\n\n- [core][@nammatham/core], Nammatham Core package for initializing Nammatham App\n\n### Available Adatpers\n\n- [azure-functions][@nammatham/azure-functions], Azure Functions Adapter for Nammatham, internally, Azure Functions in local dev mode is dependend on Express.js.\n\n### Available Plugins\n\n- [express][@nammatham/express], Express Plugin for run server. Nammatham itself doesn't contain any server, enabling this plugin to provide better DX than the original server e.g. Azure Functions Runtime\n- [trpc-azure-functions][@nammatham/trpc-azure-functions], provide [tRPC](https://trpc.io/) Plugin for Azure Functions, inclduing [express][@nammatham/express] server for local testing.\n\n[@nammatham/core]: packages/core\n[@nammatham/azure-functions]: packages/azure-functions\n[@nammatham/express]: packages/express\n[@nammatham/trpc-azure-functions]: packages/trpc-azure-functions\n\n\n## Talks \nEmpowering TypeScript on Azure Functions with Nammatham, Azure Open Source Day @ Microsoft Thailand, 25 Mar 2023\n[![](docs/imgs/azure-open-source-day-2023.png)](https://www.youtube.com/watch?v=n6B4-5Lt2h0) (Thai speech, subtitle will added later)\n- Slides: https://docs.google.com/presentation/d/1WUIXaUxXaiixZ2bgGCfx-f4Gdrmjl4RfbwKaEfAC6t4/edit?usp=sharing\n\n\n\u003c!-- ## What's different with Azure Functions v4 (Official Library) --\u003e\n\n## Local Dev Setup\n\n```bash\n# Install dependencies\npnpm install\n# Before dev (Update workspace to local dependencies)\npnpm pre-local \u0026\u0026 pnpm install\n# While dev\npnpm dev\n# After dev before submitting PRs (Update workspace to actual dependencies), `pnpm install` for making sure lockfile is correct.\npnpm post-local \u0026\u0026 pnpm install\n# Release package\npnpm release\n```\n\n## Inspiration \n- [Azure Functions .NET](https://learn.microsoft.com/en-us/azure/azure-functions/create-first-function-cli-csharp?tabs=azure-cli%2Cin-process)\n- [inversify-express-utils](https://github.com/inversify/inversify-express-utils) - We use inversify as a Dependency Injection Tool.\n- [Nestjs](https://nestjs.com/)\n- [typestack/routing-controllers](https://github.com/typestack/routing-controllers)\n- [azure-middleware](https://github.com/emanuelcasco/azure-middleware) - Azure Functions Middleware Libray\n\n## Author\n- Thada Wangthammang, Software Engineer, Thailand","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthaitype%2Fnammatham","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthaitype%2Fnammatham","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthaitype%2Fnammatham/lists"}