{"id":15365942,"url":"https://github.com/andywer/srv","last_synced_at":"2025-10-31T10:32:58.722Z","repository":{"id":37706271,"uuid":"177009704","full_name":"andywer/srv","owner":"andywer","description":"📡 Functional node server. Composable routing. Take a request, return a response.","archived":false,"fork":false,"pushed_at":"2023-01-23T22:24:14.000Z","size":326,"stargazers_count":9,"open_issues_count":9,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-24T11:44:13.020Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/andywer.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}},"created_at":"2019-03-21T19:17:39.000Z","updated_at":"2022-06-22T06:52:04.000Z","dependencies_parsed_at":"2023-02-02T08:02:34.290Z","dependency_job_id":null,"html_url":"https://github.com/andywer/srv","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/andywer/srv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andywer%2Fsrv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andywer%2Fsrv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andywer%2Fsrv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andywer%2Fsrv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andywer","download_url":"https://codeload.github.com/andywer/srv/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andywer%2Fsrv/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266953064,"owners_count":24011522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-25T02:00:09.625Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-10-01T13:16:45.489Z","updated_at":"2025-10-31T10:32:58.629Z","avatar_url":"https://github.com/andywer.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eSRV\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eNode.js servers rethought: Functional, lean, performant.\u003c/b\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://travis-ci.org/andywer/srv\"\u003e\u003cimg alt=\"Travis build status\" src=\"https://img.shields.io/travis/andywer/srv.svg?logo=travis\u0026style=flat-square\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@andywer/srv\"\u003e\u003cimg alt=\"Travis build status\" src=\"https://img.shields.io/npm/v/@andywer/srv.svg?logo=npm\u0026style=flat-square\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cbr /\u003e\n\nWhat if we were to write [express](https://github.com/expressjs/express) from scratch in 2019…?\n\nWould we use async functions and promises? Would we make it more functional? With TypeScript in mind?\n\nSure we would! So here we go.\n\n🚀\u0026nbsp;\u0026nbsp;**Built for ES2017+ \u0026 TypeScript**\u003cbr/\u003e\n🔌\u0026nbsp;\u0026nbsp;**Functional - Take a request, return a response**\u003cbr/\u003e\n☝️\u0026nbsp;\u0026nbsp;**Explicit - Clear static types**\u003cbr/\u003e\n🗜\u0026nbsp;\u0026nbsp;**Almost no dependencies \u0026 less than 1000 lines of code**\u003cbr/\u003e\n\n\u003cbr /\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003e⚠️ Status: Experimental ⚠️\u003c/b\u003e\n\u003c/p\u003e\n\n## At a glance\n\n```ts\nimport {\n  Response,\n  Route,\n  Router,\n  Service\n} from \"@andywer/srv\"\n\nconst greet = Route.GET(\"/welcome\", async (request) =\u003e {\n  const name = request.query.name\n\n  return Response.JSON({\n    name: \"Greeting service\",\n    welcome: name ? `Hello, ${name}!` : `Hi there!`\n  })\n})\n\nconst service = Service(Router([ greet ]))\n\nservice.listen(8080)\n  .catch(console.error)\n```\n\n## Documentation\n\nFind some documentation and sample code here. Work in progress right now.\n\n\u003c!-- Basics --\u003e\n* [Routing](./docs/routing.md)\n* [Middleware](./docs/middleware.md)\n\n## Features\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eAsync functions\u003c/b\u003e\u003c/summary\u003e\n\nNo callbacks. Leverage modern day features instead for an optimal developer experience.\n\n```ts\nimport { Response, Route } from \"@andywer/srv\"\n\nconst greet = Route.GET(\"/health\", async () =\u003e {\n  try {\n    const stats = await fetchHealthMetrics()\n    return Response.JSON({\n      operational: true,\n      stats\n    })\n  } catch (error) {\n    return Response.JSON(500, {\n      operational: false\n    })\n  }\n})\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eFunctional route handlers\u003c/b\u003e\u003c/summary\u003e\n\nTake a request, return a response. Lean, clean, easy to test and debug.\n\n```ts\nimport { Response, Route, Router } from \"@andywer/srv\"\nimport { queryUserByID } from \"./database/users\"\n\nconst getUser = Route.GET(\"/user/:id\", async request =\u003e {\n  const userID = request.params.id\n  const user = await queryUserByID(userID)\n\n  if (!user) {\n    return Response.JSON(404, {\n      message: `User ${userID} not found`\n    })\n  }\n\n  const headers = {\n    \"Last-Modified\": user.updated_at || user.created_at\n  }\n  return Response.JSON(200, headers, user)\n})\n\nexport const router = Router([\n  getUser\n])\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eNo mutations\u003c/b\u003e\u003c/summary\u003e\n\nStop passing data from middlewares to route handlers by dumping it in an untypeable `context`. Take the request object, extend it, pass it down to the route handler.\n\nBy applying middlewares in a direct and explicit manner, the passed requests and responses are completely type-safe, even if customized by middlewares.\n\n```ts\nimport { Middleware, Request, RequestHandler, Service } from \"@andywer/srv\"\nimport { Logger } from \"./logger\"\n\nexport default function LoggingMiddleware(logger: Logger): Middleware {\n  return async (request: Request, next: RequestHandler) =\u003e {\n    const requestWithLogger = request.derive({\n      log: logger\n    })\n    // typeof requestWithLogger.log === Logger\n    return next(requestWithLogger)\n  }\n}\n```\n\n```ts\nimport { composeMiddlewares, Service } from \"@andywer/srv\"\nimport logger from \"./logger\"\nimport router from \"./routes\"\n\nconst applyMiddlewares = composeMiddlewares(\n  LoggingMiddleware(logger),\n  SomeOtherMiddleware()\n)\n\nconst service = Service(applyMiddlewares(router))\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eEverything is a function\u003c/b\u003e\u003c/summary\u003e\n\nThe code base is relatively simple. Middlewares, routes and routers, they are all just implementations of the following function type:\n\n```ts\ntype RequestHandler = (request: Request, next?: NextCallback) =\u003e Response | Promise\u003cResponse\u003e\n```\n\n```ts\ntype NextCallback = (req: Request) =\u003e Response | Promise\u003cResponse\u003e\n```\n\u003c/details\u003e\n\n## Debugging\n\nSet the `DEBUG` environment variable to `srv:*` to get some debug logging:\n\n```\n$ DEBUG=srv:* node ./dist/my-server\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandywer%2Fsrv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandywer%2Fsrv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandywer%2Fsrv/lists"}