{"_id":"@standard-server/fastify","_rev":"4-7243d2790d3fde89196abd475e65449c","name":"@standard-server/fastify","dist-tags":{"latest":"0.9.2"},"versions":{"0.8.3":{"name":"@standard-server/fastify","version":"0.8.3","keywords":["standard-server","fastify","adapter","http","server","request","response","streaming","sse","typescript"],"license":"MIT","_id":"@standard-server/fastify@0.8.3","maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"dist":{"shasum":"57e062b2e3c1e1cc1a011eb10da8ce790a7c22af","tarball":"https://registry.npmjs.org/@standard-server/fastify/-/fastify-0.8.3.tgz","fileCount":3,"integrity":"sha512-oo966otu8Rx+iIKWEfJyJGUjOhq+DnKrFLc3wCW0/AXnqjsoggdZGCeAQNWMW56fvKa1HD4nSuBLqwVzyHqytA==","signatures":[{"sig":"MEQCIEV5K4VD6dFnPEy9fd27q1THxbLoz0dYLSX5GeddfUliAiAeWlFbyDNtxdSPWwyObKNixdI9hRVrLoJaXb8zVYUJKA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27133},"type":"module","exports":{".":{"types":"./dist/index.d.mts","import":"./dist/index.mjs","default":"./dist/index.mjs"},"./package.json":"./package.json"},"funding":["https://github.com/sponsors/dinwwwh","https://opencollective.com/middleapi"],"scripts":{"build":"unbuild","type:check":"tsc -b"},"_npmUser":{"name":"dinwwwh","email":"dinwwwh@gmail.com"},"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/fastify"},"description":"Fastify adapter for Standard Server: transport-agnostic requests, responses, and streaming on top of Fastify's request and reply objects","directories":{},"sideEffects":false,"dependencies":{"@standard-server/core":"0.8.3","@standard-server/node":"0.8.3"},"_hasShrinkwrap":false,"devDependencies":{"fastify":"^5.11.0","supertest":"^7.1.4","@types/node":"^26.4.1","@fastify/cookie":"^11.1.2","@types/supertest":"^7.2.1"},"peerDependencies":{"fastify":">=5.6.1"},"peerDependenciesMeta":{"fastify":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/fastify_0.8.3_1788683267222_0.38527286978031694","host":"s3://npm-registry-packages-npm-production"}},"0.9.0":{"name":"@standard-server/fastify","version":"0.9.0","keywords":["standard-server","fastify","adapter","http","server","request","response","streaming","sse","typescript"],"license":"MIT","_id":"@standard-server/fastify@0.9.0","maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"dist":{"shasum":"b1a02c7ca8d29a56f738ee5d4229f1ea4dbe9170","tarball":"https://registry.npmjs.org/@standard-server/fastify/-/fastify-0.9.0.tgz","fileCount":6,"integrity":"sha512-c/OVKgmAG6SJXEjAUxBPuFTjUYCE4fh03e+OQ5sNynmiYyWImY2z1aH7Q+spXT1Mg+LntzH2CY9c00+EvMxBGQ==","signatures":[{"sig":"MEYCIQClfzUb0D3Y36yB7OnDbqiRJaSDkpNu+Hg4YDf1koWKuQIhAOfsnqLn0th97xe2AYL/t8AxpFxIcWvNKC2SL1mTJ0AV","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@standard-server%2ffastify@0.9.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":30981},"type":"module","exports":{".":{"types":"./dist/index.d.mts","import":"./dist/index.mjs","default":"./dist/index.mjs"},"./package.json":"./package.json"},"funding":["https://github.com/sponsors/dinwwwh","https://opencollective.com/middleapi"],"scripts":{"build":"unbuild","type:check":"tsc -b"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:0b45d3c7-fd8e-40b6-84b7-af714e5fe827"}},"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/fastify"},"description":"Fastify adapter for Standard Server: transport-agnostic requests, responses, and streaming on top of Fastify's request and reply objects","directories":{},"sideEffects":false,"dependencies":{"@standard-server/core":"0.9.0","@standard-server/node":"0.9.0"},"_hasShrinkwrap":false,"devDependencies":{"fastify":"^5.11.0","supertest":"^7.1.4","@types/node":"^26.4.1","@fastify/cookie":"^11.1.2","@types/supertest":"^7.2.1"},"peerDependencies":{"fastify":">=5.6.1"},"peerDependenciesMeta":{"fastify":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/fastify_0.9.0_1788683668909_0.06905983389981207","host":"s3://npm-registry-packages-npm-production"}},"0.9.1":{"name":"@standard-server/fastify","version":"0.9.1","keywords":["standard-server","fastify","adapter","http","server","request","response","streaming","sse","typescript"],"license":"MIT","_id":"@standard-server/fastify@0.9.1","maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"dist":{"shasum":"6aa708403ff049faee06e8c8bd54cd4df5c0870c","tarball":"https://registry.npmjs.org/@standard-server/fastify/-/fastify-0.9.1.tgz","fileCount":6,"integrity":"sha512-O5+CfuRh7S+1HB8OpGTQoMVpSz1RASsrSQmD//VNgW6C6JVs0POZ5y+th1FVtPVoWAkAgQOzsp1k5mWcbb0TJQ==","signatures":[{"sig":"MEUCIQD/mA09GuVqOx6F3UtsMCsJteQEr9y+iySXT7cY8ACWqQIgGAUOIyGq/N43GXF0OpIjL6EsSqvdQeX8stFoFbIUDMw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@standard-server%2ffastify@0.9.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":31753},"type":"module","exports":{".":{"types":"./dist/index.d.mts","import":"./dist/index.mjs","default":"./dist/index.mjs"},"./package.json":"./package.json"},"funding":["https://github.com/sponsors/dinwwwh","https://opencollective.com/middleapi"],"scripts":{"build":"unbuild","type:check":"tsc -b"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:0b45d3c7-fd8e-40b6-84b7-af714e5fe827"}},"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/fastify"},"description":"Fastify adapter for Standard Server: transport-agnostic requests, responses, and streaming on top of Fastify's request and reply objects","directories":{},"sideEffects":false,"dependencies":{"@standard-server/core":"0.9.1","@standard-server/node":"0.9.1"},"_hasShrinkwrap":false,"devDependencies":{"fastify":"^5.11.0","supertest":"^7.1.4","@types/node":"^26.4.1","@fastify/cookie":"^11.1.2","@types/supertest":"^7.2.1"},"peerDependencies":{"fastify":">=5.6.1"},"peerDependenciesMeta":{"fastify":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/fastify_0.9.1_1789548873063_0.4401227133173151","host":"s3://npm-registry-packages-npm-production"}},"0.9.2":{"_id":"@standard-server/fastify@0.9.2","dist":{"shasum":"0b6f0004977d754cce38ec48776748caf0009fbd","tarball":"https://registry.npmjs.org/@standard-server/fastify/-/fastify-0.9.2.tgz","fileCount":6,"integrity":"sha512-/3WuZxXIMYS59lVjUnD28ois0OMXRVwRlaGksIesu+DoiQJecc1zc8nkx5Rsh6Znfup+M2MvhVECyIqbzs8TFg==","signatures":[{"sig":"MEYCIQCxUrILoPsuSySKJRq4D9nsw6aRcXGVIx2R/3b1hbIUtwIhAII+Z9KyEG2+yfkEKvcIV7Ge+1Ma0IBdBgcpbYqUev8K","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCeuhVsvVdymjxwj/6P2MCGDb4cKr42Pt+/Wotzp9VzYAIgP5xa+/jucqoEw+zoZvghD+3HKXAvQEHOcKpKcQ3UU08="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@standard-server%2ffastify@0.9.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":31780},"name":"@standard-server/fastify","type":"module","exports":{".":{"types":"./dist/index.d.mts","import":"./dist/index.mjs","default":"./dist/index.mjs"},"./package.json":"./package.json"},"funding":["https://github.com/sponsors/dinwwwh","https://opencollective.com/middleapi"],"license":"MIT","scripts":{"build":"unbuild","type:check":"tsc -b"},"version":"0.9.2","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:0b45d3c7-fd8e-40b6-84b7-af714e5fe827"}},"keywords":["standard-server","fastify","adapter","http","server","request","response","streaming","sse","typescript"],"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/fastify"},"description":"Fastify adapter for Standard Server: transport-agnostic requests, responses, and streaming on top of Fastify's request and reply objects","directories":{},"maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"sideEffects":false,"dependencies":{"@standard-server/core":"0.9.2","@standard-server/node":"0.9.2"},"_hasShrinkwrap":false,"devDependencies":{"fastify":"^5.11.0","supertest":"^7.1.4","@types/node":"^26.4.1","@fastify/cookie":"^11.1.2","@types/supertest":"^7.2.1"},"peerDependencies":{"fastify":">=5.6.1"},"peerDependenciesMeta":{"fastify":{"optional":true}},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fastify_0.9.2_1789805849100_0.8337879457010553"}}},"time":{"created":"2026-09-06T08:27:47.049Z","modified":"2026-09-19T08:17:29.510Z","0.8.3":"2026-09-06T08:27:47.364Z","0.9.0":"2026-09-06T08:34:29.039Z","0.9.1":"2026-09-16T08:54:33.182Z","0.9.2":"2026-09-19T08:17:29.187Z"},"license":"MIT","keywords":["standard-server","fastify","adapter","http","server","request","response","streaming","sse","typescript"],"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/fastify"},"description":"Fastify adapter for Standard Server: transport-agnostic requests, responses, and streaming on top of Fastify's request and reply objects","maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"readme":"# @standard-server/fastify\n\n
\n \n \"codecov\"\n \n \n \"weekly\n \n \n \"CodSpeed\"\n \n \n \"MIT\n \n \n \"Discord\"\n \n \n \"Ask\n \n
\n\n`@standard-server/fastify` adapts Fastify request and reply objects to the transport-agnostic request and response model defined by Standard Server.\n\nStandard Server provides a unified interface for client-server communication across HTTP and message-based transports. It lets you write handlers against the same request, response, body, and streaming primitives whether the underlying transport is the Fetch API, Node.js HTTP, HTTP/2, or a peer-style message channel.\n\nStandard Server ships as a small ecosystem of packages:\n\n| Package | Description |\n| --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |\n| [`@standard-server/core`](https://github.com/middleapi/standard-server/blob/main/packages/core/README.md) | The shared contract: types, body parsing rules, validators, and SSE helpers |\n| [`@standard-server/fetch`](https://github.com/middleapi/standard-server/blob/main/packages/fetch/README.md) | Fetch API adapter for browsers, workers, and other Fetch-based runtimes |\n| [`@standard-server/node`](https://github.com/middleapi/standard-server/blob/main/packages/node/README.md) | Node.js HTTP and HTTP/2 adapter |\n| [`@standard-server/fastify`](https://github.com/middleapi/standard-server/blob/main/packages/fastify/README.md) | Fastify adapter built on the Node.js adapter |\n| [`@standard-server/aws-lambda`](https://github.com/middleapi/standard-server/blob/main/packages/aws-lambda/README.md) | AWS Lambda adapter with response streaming |\n| [`@standard-server/peer`](https://github.com/middleapi/standard-server/blob/main/packages/peer/README.md) | Message-based adapter for WebSocket, MessagePort, and custom transports |\n| [`@standard-server/shared`](https://github.com/middleapi/standard-server/blob/main/packages/shared/README.md) | Internal utilities shared across the ecosystem |\n\nThis package is the Fastify adapter for that model. It builds on [`@standard-server/node`](https://github.com/middleapi/standard-server/blob/main/packages/node/README.md), reusing the same body, URL, and abort-signal primitives, while routing the response back through Fastify's reply lifecycle so hooks, plugins, and serializers keep working. Both `Fastify()` and `Fastify({ http2: true })` instances are supported.\n\n`fastify` is a peer dependency, so the adapter always uses the Fastify version installed in your project.\n\n## Package overview\n\nThe package exposes two helpers and their option shapes:\n\n| Group | Exports | Purpose |\n| ----------------------- | ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |\n| Request and response | `toStandardLazyRequest()`, `sendStandardResponse()` | Adapt Fastify request and reply objects to Standard Server |\n| Types and option shapes | `AnyFastifyRequest`, `AnyFastifyReply`, `FastifyRequest`, `FastifyReply`, `SendStandardResponseOptions` | Type handler inputs and serializer options |\n\nBoth helpers accept `AnyFastifyRequest` and `AnyFastifyReply`, which are `FastifyRequest` and `FastifyReply` widened over every raw server. That is what lets the same call site work for `Fastify()`, `Fastify({ http2: true })`, typed route generics, hooks, and encapsulated plugins alike.\n\nLower-level helpers such as `toStandardBody()`, `toNodeHttpBody()`, and `toEventStream()` are not re-exported here β€” import them from [`@standard-server/node`](https://github.com/middleapi/standard-server/blob/main/packages/node/README.md) when you need them.\n\n## Server-side request handling\n\nUse `toStandardLazyRequest()` to convert an incoming Fastify request into a `StandardLazyRequest`, then `sendStandardResponse()` to write the resulting `StandardResponse` back through the reply.\n\n```ts\nimport type { StandardLazyRequest, StandardResponse } from '@standard-server/core'\nimport { sendStandardResponse, toStandardLazyRequest } from '@standard-server/fastify'\nimport Fastify from 'fastify'\n\nasync function handle(request: StandardLazyRequest): Promise {\n const body = await request.resolveBody()\n\n return {\n status: 200,\n headers: { 'content-type': 'application/json' },\n body: {\n ok: true,\n method: request.method,\n url: request.url,\n received: body,\n },\n }\n}\n\nconst fastify = Fastify()\n\nfastify.all('/*', async (req, reply) => {\n const standardRequest = toStandardLazyRequest(req, reply)\n const standardResponse = await handle(standardRequest)\n\n await sendStandardResponse(reply, standardResponse, {/** options */})\n})\n\nawait fastify.listen({ port: 3000 })\n```\n\n`sendStandardResponse()` resolves once the response is fully flushed, and rejects if the underlying connection errors. Do not return a value from the route handler afterwards β€” Fastify would try to send a second response.\n\n> [!TIP]\n> When sending responses, you can pass additional options such as event-stream keep-alive.\n\n## Resolving Body\n\n`resolveBody(hint?)` returns the body Fastify already parsed with its own content type parsers, if there is one. Otherwise it falls back to `toStandardBody()` from `@standard-server/node`, which follows the shared Standard Server resolution rules: an explicit `hint` wins, then the [`standard-server` header](https://github.com/middleapi/standard-server/blob/main/packages/core/README.md#the-standard-server-header), then inference from the content headers. See [how body parsing works](https://github.com/middleapi/standard-server/blob/main/packages/core/README.md#how-body-parsing-works) in the core README for the full algorithm.\n\nBecause Fastify's own parsers win, a `hint` only applies to bodies Fastify left unparsed. Fastify ships parsers for `application/json` and `text/plain`, and rejects every other content type with `415 Unsupported Media Type` unless you register one. To let the adapter own body parsing end to end, register a catch-all parser that leaves the body untouched:\n\n```ts\n// optional: also drop fastify's built-in json and text/plain parsers\nfastify.removeAllContentTypeParsers()\n\nfastify.addContentTypeParser('*', (req, payload, done) => {\n done(null, undefined)\n})\n```\n\nRegister it inside an encapsulated plugin if you only want it to apply to the routes that serve Standard Server handlers.\n\n> [!TIP]\n> For efficient communication, set the `standard-server` header to explicitly hint the body type, especially for file or binary streaming. For example, if you upload a file with a common `content-type` such as `application/json` but omit the `standard-server` header, the server may interpret it as JSON and parse it unexpectedly.\n\n## Fastify behavior to be aware of\n\nFastify owns the reply lifecycle, so a few of its rules apply to the response the adapter writes:\n\n- **Empty `content-type` is rejected.** A `Blob` or `File` without a type is sent with an empty `content-type` header, which Fastify answers with `415 Unsupported Media Type` before your handler runs. Normalize it first if clients may send one:\n\n ```ts\n fastify.addHook('onRequest', async (req) => {\n if (req.headers['content-type'] === '') {\n delete req.headers['content-type']\n }\n })\n ```\n\n- **JSON responses gain a charset.** Fastify rewrites any `content-type` whose media type contains `json` to include `; charset=utf-8`. The payload itself is never serialized twice, because the adapter always hands Fastify an already-encoded string or stream.\n- **`set-cookie` is merged, not replaced.** Cookies set by plugins such as `@fastify/cookie` are kept, and the ones on your `StandardResponse` are appended to them. Every other header is overwritten.\n- **Streams are managed by Fastify.** Streaming bodies are piped and destroyed by Fastify itself, including when the client aborts mid-response.\n\n## Learn more\n\nFor the project overview and the shared contract, see the [core documentation](https://github.com/middleapi/standard-server/blob/main/packages/core/README.md). For the Node.js primitives this adapter is built on, see the [Node.js adapter documentation](https://github.com/middleapi/standard-server/blob/main/packages/node/README.md).\n\n## Sponsors\n\nLike what we build over at [middleapi](https://github.com/middleapi)? You can help keep it going through [GitHub Sponsors](https://github.com/sponsors/dinwwwh) or [Open Collective](https://opencollective.com/middleapi). Every bit helps! πŸš€\n\n\n \n \n \n \n \n \n \n \n \n
\"ScreenshotOne.com\"/ScreenshotOne.com
The screenshot API for developers
\"Yuzu\"/Yuzu
We're hiring NYC based engineers
\"MisskeyHQ\"/MisskeyHQ
Decentralized microblogging SNS born on Earth
\n\n### Special Sponsors\n\n\n \n \n \n
\"Guillermo
Guillermo Rauch
\n\n### Organization Sponsors\n\n\n \n \n \n
\"LN
LN Markets
\n\n### Sponsors\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
\"Reece
Reece McDonald		\"あわわわとーにゅ\"/
あわわわとーにゅ		\"nk\"/
nk		\"supastarter\"/
supastarter		\"Dexter
Dexter Miguel		\"herrfugbaum\"/
herrfugbaum
\"Ryota
Ryota Murakami		\"David
David Cramer		\"Valerii
Valerii Petryniak		\"Valerii
Valerii Strilets		\"Kyle
Kyle Mistele		\"christ12938\"/
christ12938
\"Ryan
Ryan Soderberg		\"shota\"/
shota		\"Ellis
Ellis Driscoll		\"Hoang
Hoang Nguyen		\"Orestis
Orestis Ioannou		\"Stefan
Stefan Smiljkovic
\n\n### Backers\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
\"David
David Walsh		\"IPv4Addr\"/
IPv4Addr		\"Robbe
Robbe Vaes		\"Aidan
Aidan Sunbury		\"soonoo\"/
soonoo		\"Kevin
Kevin Porten		\"Denis\"/
Denis
\"Christopher
Christopher Kapic		\"Tom
Tom Ballinger		\"Sam\"/
Sam		\"Titoine\"/
Titoine		\"Igor
Igor Makowski		\"hanayashiki\"/
hanayashiki		\"Lev
Lev Dubinets
\"Kelly
Kelly Peilin Chan		\"Guy
Guy Ariely		\"PaulSenon\"/
PaulSenon		\"Alex\"/
Alex		\"Andrey
Andrey Gubanov
\n\nWith thanks to [36 past sponsors](https://htmlpreview.github.io/?https://github.com/middleapi/static/blob/main/sponsors.svg) who helped get us here.\n\n## License\n\nDistributed under the MIT License. See [LICENCE](https://github.com/middleapi/standard-server/blob/main/LICENCE) for more information.\n","readmeFilename":""}