{"_id":"@standard-server/core","_rev":"4-61b8b0661e7ff6d0a14dbbc6b697d703","name":"@standard-server/core","dist-tags":{"latest":"0.9.2"},"versions":{"0.8.3":{"name":"@standard-server/core","version":"0.8.3","keywords":["standard-server","http","server","client","request","response","transport-agnostic","body-parser","validator","sse","server-sent-events","streaming","typescript"],"license":"MIT","_id":"@standard-server/core@0.8.3","maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"dist":{"shasum":"184e0c05d0dc0a71c20f411b9fcb7c47484d3b1e","tarball":"https://registry.npmjs.org/@standard-server/core/-/core-0.8.3.tgz","fileCount":3,"integrity":"sha512-A/+pOyfFnl52M7+u8jnZNBM3kpBcOxgY9zHc9SmX/u+9yPpHOwQCvx6i+ruvyqEcOmXRXkHLCaLsFS38v8OBKA==","signatures":[{"sig":"MEUCIArgf1MXrQzLT7J9T5yByIN6WWPe+wubjMGHAEj2zbCJAiEA9F1SXRWatK/A10F+cmgK8k9uWwoFc42sW/I66ViEfgo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38516},"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/core"},"description":"The Standard Server contract: transport-agnostic request, response, body, and streaming types with body parsing rules, runtime validators, and SSE helpers shared by every adapter","directories":{},"sideEffects":false,"dependencies":{"@standard-server/shared":"0.8.3"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/core_0.8.3_1788683259227_0.04257135161506276","host":"s3://npm-registry-packages-npm-production"}},"0.9.0":{"name":"@standard-server/core","version":"0.9.0","keywords":["standard-server","http","server","client","request","response","transport-agnostic","body-parser","validator","sse","server-sent-events","streaming","typescript"],"license":"MIT","_id":"@standard-server/core@0.9.0","maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"dist":{"shasum":"bb153de452d6733c832386f086304961b0247d62","tarball":"https://registry.npmjs.org/@standard-server/core/-/core-0.9.0.tgz","fileCount":6,"integrity":"sha512-yznlhJHHdZETepUuEjUomJjSsZm4BiNaFgrbCKxTvCNLYntcky0mTfgP2fJk6NTGb5Zh+tHjKcPPaYGytVF27Q==","signatures":[{"sig":"MEYCIQC4abghd/hMyhdIvTlHzCmyKZH5gqYU/nfSw+C/7QXumQIhAJSJypVAvXLhD5nQefIn1ZR4n18wWnBz2NanrUmooa9G","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIBrbHz8WphbOYEmRO40qHCxjMe5p4zVsz5Grvx5920klAiBFsg/BHKHcoW6GJkzSC6WhtfaFs0WnEPsjxtY9/oWr5A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@standard-server%2fcore@0.9.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":65335},"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:65935932-a786-477f-bf9f-c34f45e704bf"}},"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/core"},"description":"The Standard Server contract: transport-agnostic request, response, body, and streaming types with body parsing rules, runtime validators, and SSE helpers shared by every adapter","directories":{},"sideEffects":false,"dependencies":{"@standard-server/shared":"0.9.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/core_0.9.0_1788683693280_0.8035215764075125","host":"s3://npm-registry-packages-npm-production"}},"0.9.1":{"name":"@standard-server/core","version":"0.9.1","keywords":["standard-server","http","server","client","request","response","transport-agnostic","body-parser","validator","sse","server-sent-events","streaming","typescript"],"license":"MIT","_id":"@standard-server/core@0.9.1","maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"dist":{"shasum":"485a9954a4822c68bcaeb181b64c92d1631412c3","tarball":"https://registry.npmjs.org/@standard-server/core/-/core-0.9.1.tgz","fileCount":6,"integrity":"sha512-wdCAdCH3M/GxNqEnDW/YQnzNz1T5hWuALzjh7lVyWwIZ2i9OBsOp4PFqFDhkAO2erfhOT1zVSrnJn9t8v6LbkQ==","signatures":[{"sig":"MEQCIDSkXr2hq89n4D3zf2tLBJVdk8QC5yRXB2dMomnecj+JAiAjh8QIKrNJRxamqGabbdUXe82SZsJtDgwXCCPZPTKFYw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDr0BEkRgGOgwnvvkvXfmFyoI0Dos2guTazEz9UUxE9JAIgeG1H2w+YtRl9552+lBq4VIdpiEqd5UtSeNLWVI8DKXA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@standard-server%2fcore@0.9.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":66142},"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:65935932-a786-477f-bf9f-c34f45e704bf"}},"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/core"},"description":"The Standard Server contract: transport-agnostic request, response, body, and streaming types with body parsing rules, runtime validators, and SSE helpers shared by every adapter","directories":{},"sideEffects":false,"dependencies":{"@standard-server/shared":"0.9.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/core_0.9.1_1789548907754_0.7234557360244633","host":"s3://npm-registry-packages-npm-production"}},"0.9.2":{"_id":"@standard-server/core@0.9.2","dist":{"shasum":"8eafe87ab9c6388cf9e5a99adaf909a5d8972ad0","tarball":"https://registry.npmjs.org/@standard-server/core/-/core-0.9.2.tgz","fileCount":6,"integrity":"sha512-P1tlRyxyM9n/toFH69/4O5Xn2V33iFszCy2xgZlqpng03nNNmFFH1ua6holdGbQ5CMeRMoJvlb8iezUhfak6Cw==","signatures":[{"sig":"MEUCIBscEFFGwT9QjOGIqPPv7MorC/V4WnWudD/ApzS3U+6rAiEAzAoli2Q4VH4ZU4qYXejLPJBVNbXMvBVuINQUUSQVVS8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAUp1gV7Y8rhPNEe/dnHJ02AXRjz35RtjZvkJSZZr8AEAiEArS9DEgqRYBSEasCxDF25gpMmvF/7NUdDrpx16S5Jv0s="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@standard-server%2fcore@0.9.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":66156},"name":"@standard-server/core","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:65935932-a786-477f-bf9f-c34f45e704bf"}},"keywords":["standard-server","http","server","client","request","response","transport-agnostic","body-parser","validator","sse","server-sent-events","streaming","typescript"],"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/core"},"description":"The Standard Server contract: transport-agnostic request, response, body, and streaming types with body parsing rules, runtime validators, and SSE helpers shared by every adapter","directories":{},"maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"sideEffects":false,"dependencies":{"@standard-server/shared":"0.9.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/core_0.9.2_1789805759986_0.2649887684184582"}}},"time":{"created":"2026-09-06T08:27:39.102Z","modified":"2026-09-19T08:16:00.413Z","0.8.3":"2026-09-06T08:27:39.356Z","0.9.0":"2026-09-06T08:34:53.377Z","0.9.1":"2026-09-16T08:55:07.854Z","0.9.2":"2026-09-19T08:16:00.062Z"},"license":"MIT","keywords":["standard-server","http","server","client","request","response","transport-agnostic","body-parser","validator","sse","server-sent-events","streaming","typescript"],"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/core"},"description":"The Standard Server contract: transport-agnostic request, response, body, and streaming types with body parsing rules, runtime validators, and SSE helpers shared by every adapter","maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"readme":"# Standard Server\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/core` is the shared contract package for **Standard Server** — a unified interface for client-server communication across HTTP and message-based transports. It lets you keep handler and client code transport-agnostic by working with the same request, response, body, and streaming abstractions whether the transport is Fetch, Node.js HTTP, 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 foundation of that model. It defines the request and response types every adapter converts to and from, the body parsing rules they all share, runtime validators, header and URL utilities, and event stream (SSE) helpers.\n\n## Request and response types\n\nThe package exposes four transport-agnostic shapes:\n\n| Export | Description |\n| ---------------------- | --------------------------------------------------------------- |\n| `StandardRequest` | Eager request object with a parsed `body` |\n| `StandardLazyRequest` | Request object with `resolveBody(hint?)` for lazy body parsing |\n| `StandardResponse` | Eager response object with a parsed `body` |\n| `StandardLazyResponse` | Response object with `resolveBody(hint?)` for lazy body parsing |\n\nSupporting primitives:\n\n| Export | Description |\n| ------------------ | ------------------------------------------------------------- |\n| `StandardMethod` | Common HTTP verbs plus any custom string value |\n| `StandardUrl` | A request URL that must start with `/` and exclude the origin |\n| `StandardHeaders` | `Record` |\n| `StandardBodyHint` | Parsing hint for lazy body resolution |\n| `StandardBody` | Shared body union used by requests and responses |\n\nBy convention, adapters normalize headers to lowercase keys. `signal` is part of `StandardRequest` only and is used to propagate request cancellation.\n\n```ts\nimport type { StandardLazyRequest, StandardResponse } from '@standard-server/core'\n\nexport async 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```\n\n## Body types\n\n`StandardBodyHint` and `StandardBody` describe the shared body contract used across adapters:\n\n| Hint | `StandardBody` value | Typical content type | Notes |\n| ------------------- | ------------------------------ | ----------------------------------- | ----------------------------------------------------- |\n| `json` | `unknown` | `application/json` | Primitives, objects, and arrays |\n| `form-data` | `FormData` | `multipart/form-data` | Multipart form submissions |\n| `url-search-params` | `URLSearchParams` | `application/x-www-form-urlencoded` | URL-encoded forms |\n| `event-stream` | `AsyncIteratorObject` | `text/event-stream` | Server-Sent Events (SSE) |\n| `octet-stream` | `ReadableStream` | any | Binary streaming |\n| `file` | `File` | any | Fixed-size binary payloads for both `File` and `Blob` |\n| `none` | `undefined` | | Empty body |\n\n### JSON body\n\nStandard Server treats primitive values, objects, and arrays as JSON.\n\n```ts\nimport type { StandardRequest } from '@standard-server/core'\n\nconst request: StandardRequest = {\n method: 'POST',\n url: '/submit',\n headers: {},\n body: { name: 'John Doe', email: 'john.doe@example.com' },\n}\n```\n\n### FormData and URLSearchParams body\n\nStandard Server treats [FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData) and [URLSearchParams](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams) as form submissions.\n\n```ts\nimport type { StandardRequest } from '@standard-server/core'\n\nconst requestWithURLSearchParams: StandardRequest = {\n method: 'POST',\n url: '/submit',\n headers: {},\n body: new URLSearchParams({ name: 'John Doe', email: 'john.doe@example.com' }),\n}\n\nconst formData = new FormData()\nformData.append('name', 'John Doe')\nformData.append('file', new Blob(['Hello, World!'], { type: 'text/plain' }), 'hello.txt')\n\nconst requestWithFormData: StandardRequest = {\n method: 'POST',\n url: '/submit',\n headers: {},\n body: formData,\n}\n```\n\n> [!TIP]\n> HTML forms submit data as `application/x-www-form-urlencoded` or `multipart/form-data`, so these body types are especially helpful there.\n\n### File and Blob body\n\nStandard Server treats [File](https://developer.mozilla.org/en-US/docs/Web/API/File) and [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob) as fixed-size binary payloads.\n\n> [!NOTE]\n> Since `File` extends `Blob`, `resolveBody` always returns a `File` when representing either `File` or `Blob` bodies.\n\n```ts\nimport type { StandardResponse } from '@standard-server/core'\n\nconst response: StandardResponse = {\n status: 200,\n headers: {\n 'content-disposition': [], // <- remove auto-set header\n },\n body: new File(['Hello, World!'], 'hello.txt', { type: 'text/plain' }),\n}\n```\n\nWhen sending a file or blob body, adapters automatically set the `content-length`, `content-type`, `content-disposition`, and `standard-server` headers based on the provided body. You can override any of them by explicitly providing a header value, or remove one entirely by assigning an empty array.\n\n### Event-stream body\n\nStandard Server uses [AsyncIteratorObject](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncIterator) to represent an event stream body, and you can use `withEventMeta()` to attach additional [SSE event metadata](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#event_stream_format) to each emitted event.\n\n```ts\nimport type { StandardResponse } from '@standard-server/core'\nimport { ErrorEvent, withEventMeta } from '@standard-server/core'\n\nconst response: StandardResponse = {\n status: 200,\n headers: {},\n async* body() {\n yield withEventMeta(\n { message: 'Hello, World!' },\n { id: '1', retry: 3000, comments: ['hidden'] },\n )\n\n throw new ErrorEvent({ message: 'Something went wrong' })\n\n return { message: 'This is the end of the stream' }\n },\n}\n```\n\nEvents are interpreted as follows: `yield` emits a `message`, `throw` emits an `error`, and `return` emits a `close` event. Note that `close` does not cause [EventSource](https://developer.mozilla.org/en-US/docs/Web/API/EventSource) to close the connection because it is not part of the SSE specification. However, when using Standard Server for client-side streaming, `close` is treated as the end of the stream, so the connection is closed and no reconnection is attempted.\n\nFor explicit SSE encoding, decoding, and metadata handling, see the [Event-Stream Helpers](#event-stream-helpers) below.\n\n### Octet-stream body\n\nStandard Server uses [ReadableStream](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream) to represent a binary streaming body.\n\n```ts\nimport type { StandardResponse } from '@standard-server/core'\n\nconst response: StandardResponse = {\n status: 200,\n headers: {\n 'content-type': 'application/octet-stream',\n },\n body: new ReadableStream({\n start(controller) {\n const encoder = new TextEncoder()\n controller.enqueue(encoder.encode('Hello, World!'))\n controller.close()\n },\n }),\n}\n```\n\nWhen sending a binary streaming body, adapters automatically set the `content-type` and `standard-server` headers. You can override `content-type` by providing an explicit header value, or remove it entirely by assigning an empty array.\n\n## How body parsing works\n\n> [!NOTE]\n> This section applies to the HTTP adapters (Fetch, Node.js, Fastify, AWS Lambda). It does not apply to the [peer adapter](https://github.com/middleapi/standard-server/blob/main/packages/peer/README.md#body-resolution), which identifies body types through its own message protocol — a different but fairly similar mechanism.\n\n`resolveBody(hint?)` on `StandardLazyRequest` and `StandardLazyResponse` resolves the body lazily — the underlying stream is only consumed once you call it. The `StandardBodyHint` that decides how the raw body is parsed comes from three places: an explicit `hint` argument, the `standard-server` header, or inference from the content headers.\n\n### The `standard-server` header\n\nA `StandardBody` is richer than what HTTP content headers can describe. `content-type` tells the receiver the _media type_ of the bytes, but not which `StandardBody` representation the sender intended:\n\n- A file upload can legitimately carry `content-type: application/json`. Without more information, the receiver would parse it into a JSON value when the sender meant a `File` to be stored as-is.\n- A fixed-size binary payload (`file`) and a binary stream (`octet-stream`) can share any content type. Telling them apart otherwise depends on `content-length`, which proxies may rewrite and some runtimes drop when the payload is empty.\n\nThe `standard-server` header closes this gap. It carries the sender's `StandardBodyHint` verbatim — `json`, `form-data`, `url-search-params`, `event-stream`, `octet-stream`, `file`, or `none` — so the receiver reconstructs exactly the body representation the sender had.\n\nAdapters set the header automatically for the ambiguous body types: a `Blob` or `File` body is sent with `standard-server: file`, and a `ReadableStream` body with `standard-server: octet-stream`, alongside the usual content headers. A header you set yourself always wins, and assigning an empty array removes it entirely. For the other body types, the content headers are enough, so adapters clear it.\n\nThe header is optional: when it is absent or invalid, the receiver falls back to content-header inference, so plain HTTP clients work as-is. Just set the header yourself whenever the content type alone could be misread:\n\n```ts\nconst response = await fetch('/upload', {\n method: 'POST',\n headers: {\n 'content-type': 'application/json',\n 'standard-server': 'file', // <- keep the payload a File on the server\n },\n body: new Blob(['{\"message\": \"Hello, world!\"}'], { type: 'application/json' }),\n})\n```\n\n### Resolution order\n\nThe hint is chosen in this order:\n\n1. **Explicit `hint` argument.** If you pass a hint to `resolveBody(hint)`, it always wins.\n2. **The `standard-server` header.** If present and holding a valid hint value, it is used verbatim. Unknown values are ignored.\n3. **Content-header inference:**\n 1. No `content-type`, and `content-length` absent or `0` → `none`.\n 2. A common `content-type` → `application/json` parses as `json`, `multipart/form-data` as `form-data`, `application/x-www-form-urlencoded` as `url-search-params`, and `text/event-stream` as `event-stream`. Media type casing and parameters such as `; charset=utf-8` are ignored.\n 3. A `content-disposition` carrying a filename, or any `content-length` → `file`.\n 4. Anything else → `octet-stream`.\n\nThis resolution is implemented once in this package as `resolveStandardBodyHint(headers)` and shared by every HTTP adapter, so the same body parses the same way regardless of which HTTP transport carried it:\n\n```ts\nimport { resolveStandardBodyHint } from '@standard-server/core'\n\nresolveStandardBodyHint({ 'content-type': 'application/json' })\n// 'json'\n\nresolveStandardBodyHint({\n 'content-type': 'application/json',\n 'standard-server': 'file',\n})\n// 'file'\n\nresolveStandardBodyHint({})\n// 'none'\n```\n\nUse it when building a custom adapter, or when you need to know how a body will parse without consuming it.\n\n## Utilities\n\nThe package also exports a small set of helpers for common header and URL operations.\n\n### Content-Disposition helpers\n\nUse `generateContentDisposition()` to produce a safe `Content-Disposition` value and `getFilenameFromContentDisposition()` to read a filename back from an existing header.\n\n```ts\nimport {\n generateContentDisposition,\n getFilenameFromContentDisposition,\n} from '@standard-server/core'\n\nconst disposition = generateContentDisposition('report \"Q2\".csv')\n// inline; filename=\"report \\\"Q2\\\".csv\"; filename*=utf-8''report%20%22Q2%22.csv\n\nconst filename = getFilenameFromContentDisposition(disposition)\n// 'report \"Q2\".csv'\n```\n\n`generateContentDisposition()` preserves an ASCII-safe `filename=\"...\"` value and also emits `filename*=` for UTF-8 aware clients.\n\n### Header helpers\n\n`mergeStandardHeaders()` combines two `StandardHeaders` objects while preserving duplicate values, and `flattenStandardHeader()` turns a single header value into a plain string when needed.\n\n```ts\nimport {\n flattenStandardHeader,\n mergeStandardHeaders,\n} from '@standard-server/core'\n\nconst headers = mergeStandardHeaders(\n { 'accept': 'application/json', 'set-cookie': ['a=1'] },\n { 'set-cookie': 'b=2', 'vary': 'accept', 'warning': undefined },\n)\n// {\n// accept: 'application/json',\n// 'set-cookie': ['a=1', 'b=2'],\n// vary: 'accept',\n// }\n\nconst cookieHeader = flattenStandardHeader(headers['set-cookie'])\n// 'a=1, b=2'\n```\n\n### URL parsing\n\n`parseStandardUrl()` splits a `StandardUrl` into `[pathname, search, hash]` without requiring a full origin.\n\n```ts\nimport { parseStandardUrl } from '@standard-server/core'\n\nconst [pathname, search, hash] = parseStandardUrl('/users/123?tab=settings#profile')\n// pathname => '/users/123'\n// search => '?tab=settings'\n// hash => '#profile'\n```\n\n## Validators\n\nRuntime type guards are useful when requests or responses cross process, transport, or message boundaries.\n\n| Export | Checks |\n| ---------------------- | ------------------------------------------------------ |\n| `isStandardMethod()` | Any string value |\n| `isStandardUrl()` | A string starting with `/` |\n| `isStandardHeaders()` | Object values are `string`, `string[]`, or `undefined` |\n| `isStandardRequest()` | |\n| `isStandardResponse()` | |\n\n```ts\nimport { isStandardRequest } from '@standard-server/core'\n\nexport function expectStandardRequest(input: unknown) {\n if (!isStandardRequest(input)) {\n throw new TypeError('Expected a StandardRequest-compatible value')\n }\n\n return input\n}\n```\n\n## Event-Stream Helpers\n\nUse Event-Stream Helpers when you need explicit SSE encoding, decoding, or metadata handling.\n\n### Message types and codecs\n\nThe event-stream helpers include:\n\n- `EventMeta` for `id`, `retry`, and `comments`\n- `EventStreamMessage` for complete SSE messages\n- `encodeEventStreamMessage()` and `decodeEventStreamMessage()` for single-message codec operations\n- `EventStreamDecoder` and `EventStreamDecoderStream` for chunked stream decoding\n\n```ts\nimport {\n decodeEventStreamMessage,\n encodeEventStreamMessage,\n} from '@standard-server/core'\n\nconst encoded = encodeEventStreamMessage({\n comments: ['bootstrap'],\n event: 'message',\n id: '42',\n retry: 3000,\n data: 'hello\\nworld',\n})\n\nconst decoded = decodeEventStreamMessage(encoded)\n// {\n// comments: ['bootstrap'],\n// event: 'message',\n// id: '42',\n// retry: 3000,\n// data: 'hello\\nworld',\n// }\n```\n\nFor streaming decode, pipe text chunks through `EventStreamDecoderStream`:\n\n```ts\nimport { EventStreamDecoderStream } from '@standard-server/core'\n\nconst messages = response.body!\n .pipeThrough(new TextDecoderStream())\n .pipeThrough(new EventStreamDecoderStream())\n```\n\n### Iterator metadata helpers\n\n`StandardBody` uses async iterators for event-stream bodies. To attach SSE metadata to a yielded value without changing its visible shape, use `withEventMeta()`.\n\n```ts\nimport type { StandardResponse } from '@standard-server/core'\nimport { getEventMeta, unwrapEvent, withEventMeta } from '@standard-server/core'\n\nconst event = withEventMeta(\n { message: 'hello' },\n { id: '1', retry: 3000, comments: ['bootstrap'] },\n)\n\nconst [data, meta] = unwrapEvent(event)\n// data => { message: 'hello' }\n// meta => { id: '1', retry: 3000, comments: ['bootstrap'] }\n\nconst extractedMeta = getEventMeta(event)\n// { id: '1', retry: 3000, comments: ['bootstrap'] }\n\nconst response: StandardResponse = {\n status: 200,\n headers: {},\n async* body() {\n yield event\n },\n}\n```\n\n> [!WARNING]\n> Metadata is validated before it is attached: `id`, `event`, and comments must not contain line breaks, and `retry` must be a non-negative integer.\n\n### Errors and low-level assertions\n\nThe package also exports:\n\n- `EventStreamEncoderError` for invalid outbound SSE messages\n- `EventStreamDecoderError` for incomplete or invalid inbound stream decoding\n- `ErrorEvent` for wrapping structured event-stream error payloads in an `Error`\n- `assertEventStreamMessageId()`, `assertEventStreamMessageName()`, `assertEventStreamMessageRetry()`, and `assertEventStreamMessageComment()` for low-level validation when building custom SSE tooling\n\n```ts\nimport { ErrorEvent } from '@standard-server/core'\n\nconst error = new ErrorEvent(\n { code: 'E_STREAM', detail: 'Connection lost' },\n { message: 'stream error' },\n)\n\nerror.message\n// 'stream error'\n\nerror.data\n// { code: 'E_STREAM', detail: 'Connection lost' }\n```\n\n## Learn more\n\nFor transport-specific quick-starts and options, see the adapter documentation: [Fetch](https://github.com/middleapi/standard-server/blob/main/packages/fetch/README.md) · [Node.js](https://github.com/middleapi/standard-server/blob/main/packages/node/README.md) · [Fastify](https://github.com/middleapi/standard-server/blob/main/packages/fastify/README.md) · [AWS Lambda](https://github.com/middleapi/standard-server/blob/main/packages/aws-lambda/README.md) · [Peer](https://github.com/middleapi/standard-server/blob/main/packages/peer/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":""}