{"_id":"@standard-server/aws-lambda","_rev":"4-a202f372a5f19d91e065dee08f25a682","name":"@standard-server/aws-lambda","dist-tags":{"latest":"0.9.2"},"versions":{"0.8.3":{"name":"@standard-server/aws-lambda","version":"0.8.3","keywords":["standard-server","aws","lambda","aws-lambda","serverless","adapter","response-streaming","server","request","response","streaming","typescript"],"license":"MIT","_id":"@standard-server/aws-lambda@0.8.3","maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"dist":{"shasum":"81886aff82ed8de5dc30e38b9435ae41f31720bb","tarball":"https://registry.npmjs.org/@standard-server/aws-lambda/-/aws-lambda-0.8.3.tgz","fileCount":3,"integrity":"sha512-SCKs0UruhOFbymf1n9eVIyA3c85J0XBsi2D63aw5EzehDQuAsqXbp3mrfSvey6RGFSAd5F1pclvI36JtOp+tZA==","signatures":[{"sig":"MEUCIQCAEuB0spoAkeUzdT9BPoOdX5H2IPnVyVYjl0T4VMU8UgIgLpqeBzJWaFh3BfzvpEbrvl4l5UXXHvNqXSkwWLk+K68=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27017},"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/aws-lambda"},"description":"AWS Lambda adapter for Standard Server: transport-agnostic requests and responses with Lambda response streaming support","directories":{},"sideEffects":false,"dependencies":{"@standard-server/core":"0.8.3","@standard-server/node":"0.8.3","@standard-server/fetch":"0.8.3","@standard-server/shared":"0.8.3"},"_hasShrinkwrap":false,"devDependencies":{"@types/node":"^26.4.1","@types/aws-lambda":"^8.10.162"},"_npmOperationalInternal":{"tmp":"tmp/aws-lambda_0.8.3_1788683265610_0.9936745964873073","host":"s3://npm-registry-packages-npm-production"}},"0.9.0":{"name":"@standard-server/aws-lambda","version":"0.9.0","keywords":["standard-server","aws","lambda","aws-lambda","serverless","adapter","response-streaming","server","request","response","streaming","typescript"],"license":"MIT","_id":"@standard-server/aws-lambda@0.9.0","maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"dist":{"shasum":"cbdadaff02a457863f2f6516373d49130b5d4d2a","tarball":"https://registry.npmjs.org/@standard-server/aws-lambda/-/aws-lambda-0.9.0.tgz","fileCount":6,"integrity":"sha512-5soOS+nCIvqwODXC0gwnuW1ypoYYEervAN6TNt3tPlaDzgcd+V1Al94ZajhmtjzUyr2+x1k+O1eoLYRGfycS8w==","signatures":[{"sig":"MEQCIHRKX/jazhYYRtJO2AfogeAwXltXbLSqVe8PWpcnGMxIAiA+j9lAIc/6aFsJ2dxarwZNeSJYH3HC7eHzxtf7hXEETQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDuEvW0HefcSZI0f/v9hvU3KPeUjAw7Musu50XtkEU9LAIgZHakn9A0GVwiOpEVsd6XozBeZSe/akssnAD722q5JJU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@standard-server%2faws-lambda@0.9.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":46284},"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:ae49e4cf-c1ac-430c-9f0d-a3f68d5c295b"}},"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/aws-lambda"},"description":"AWS Lambda adapter for Standard Server: transport-agnostic requests and responses with Lambda response streaming support","directories":{},"sideEffects":false,"dependencies":{"@standard-server/core":"0.9.0","@standard-server/node":"0.9.0","@standard-server/fetch":"0.9.0","@standard-server/shared":"0.9.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/node":"^26.4.1","@types/aws-lambda":"^8.10.162"},"_npmOperationalInternal":{"tmp":"tmp/aws-lambda_0.9.0_1788683716894_0.6899379156520287","host":"s3://npm-registry-packages-npm-production"}},"0.9.1":{"name":"@standard-server/aws-lambda","version":"0.9.1","keywords":["standard-server","aws","lambda","aws-lambda","serverless","adapter","response-streaming","server","request","response","streaming","typescript"],"license":"MIT","_id":"@standard-server/aws-lambda@0.9.1","maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"dist":{"shasum":"7130c6eecda1c82a4cdc8d674a3aba8e6a3371ac","tarball":"https://registry.npmjs.org/@standard-server/aws-lambda/-/aws-lambda-0.9.1.tgz","fileCount":6,"integrity":"sha512-tuxRWy9usi7tcu0eWgPrC094eHTCXqD9dTYbVXbUXCcOzeipw90djj0WbHhFm+OasCXJK9qYX/+cUoT1UmE1Cw==","signatures":[{"sig":"MEUCIQD5320livoKrvoOHk4MY54SyzPtBMdTq6tEzWxOHeqI2wIgIAfhRLRmpIc70EKRHzBeIfV3yQhDYJ57gtWC+x55P+Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDB8YXxHdpuU+WOH4Ca5W9P01qScXXZ8l9pMH6MD5GIzQIgOd6maSNZePIwMfwo1wyvl9oR0lHj9u5o4dOyWFdIGLE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@standard-server%2faws-lambda@0.9.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":48097},"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:ae49e4cf-c1ac-430c-9f0d-a3f68d5c295b"}},"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/aws-lambda"},"description":"AWS Lambda adapter for Standard Server: transport-agnostic requests and responses with Lambda response streaming support","directories":{},"sideEffects":false,"dependencies":{"@standard-server/core":"0.9.1","@standard-server/node":"0.9.1","@standard-server/fetch":"0.9.1","@standard-server/shared":"0.9.1"},"_hasShrinkwrap":false,"devDependencies":{"@types/node":"^26.4.1","@types/aws-lambda":"^8.10.162"},"_npmOperationalInternal":{"tmp":"tmp/aws-lambda_0.9.1_1789548966535_0.8728047093758751","host":"s3://npm-registry-packages-npm-production"}},"0.9.2":{"_id":"@standard-server/aws-lambda@0.9.2","dist":{"shasum":"3f7a8159e878ce69dc4fa9fb5c6a0c313a0c609d","tarball":"https://registry.npmjs.org/@standard-server/aws-lambda/-/aws-lambda-0.9.2.tgz","fileCount":6,"integrity":"sha512-29ra5sHSQL1/WZd2Vj1hEAiv45zkcU7yEsRDQ0r/C2u+96zW4Zhpn1XMZ6p9eKy8H74IWMqrK7W43OaLaAX3vg==","signatures":[{"sig":"MEQCIG9lVwK/YNq0Eo6/5MvKIiGk3odhjDISNAlfeFErlerDAiBDxlETqttx6AjDt+97SbGaoU1/SrFeSzqQGDc8GMGj1A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCID479rTlxnvxtbn7AOeI8sRwfPygLttkxcA9/JaCMStwAiBqqdapo4odzG2XtxvSl11s8fhvIRy+Jaj/1DMmEML4lA=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@standard-server%2faws-lambda@0.9.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":48377},"name":"@standard-server/aws-lambda","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:ae49e4cf-c1ac-430c-9f0d-a3f68d5c295b"}},"keywords":["standard-server","aws","lambda","aws-lambda","serverless","adapter","response-streaming","server","request","response","streaming","typescript"],"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/aws-lambda"},"description":"AWS Lambda adapter for Standard Server: transport-agnostic requests and responses with Lambda response streaming support","directories":{},"maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"sideEffects":false,"dependencies":{"@standard-server/core":"0.9.2","@standard-server/node":"0.9.2","@standard-server/fetch":"0.9.2","@standard-server/shared":"0.9.2"},"_hasShrinkwrap":false,"devDependencies":{"@types/node":"^26.4.1","@types/aws-lambda":"^8.10.162"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aws-lambda_0.9.2_1789805876590_0.47822193123786483"}}},"time":{"created":"2026-09-06T08:27:45.451Z","modified":"2026-09-19T08:17:57.014Z","0.8.3":"2026-09-06T08:27:45.741Z","0.9.0":"2026-09-06T08:35:16.974Z","0.9.1":"2026-09-16T08:56:06.627Z","0.9.2":"2026-09-19T08:17:56.688Z"},"license":"MIT","keywords":["standard-server","aws","lambda","aws-lambda","serverless","adapter","response-streaming","server","request","response","streaming","typescript"],"repository":{"url":"git+https://github.com/middleapi/standard-server.git","type":"git","directory":"packages/aws-lambda"},"description":"AWS Lambda adapter for Standard Server: transport-agnostic requests and responses with Lambda response streaming support","maintainers":[{"name":"dinwwwh","email":"dinwwwh@gmail.com"}],"readme":"# @standard-server/aws-lambda\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/aws-lambda` adapts AWS Lambda events and response streams 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 AWS Lambda adapter for that model. It converts an API Gateway proxy event β€” payload format version 1.0 or 2.0, the latter also used by Lambda Function URLs β€” into a `StandardLazyRequest`, and writes a `StandardResponse` back through the stream provided by `awslambda.streamifyResponse`, so streaming bodies such as server-sent events flow to the client as they are produced instead of being buffered.\n\n## Package overview\n\nThe package exposes these helpers:\n\n| Group | Exports | Purpose |\n| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |\n| Request and response | `toStandardLazyRequest()`, `sendStandardResponse()` | Adapt Lambda events and response streams to Standard Server |\n| Lower-level helpers | `toStandardUrl()`, `toStandardHeaders()`, `getEventHeader()`, `toStandardBody()`, `toLambdaHeaders()` | Convert individual pieces of an event |\n| Types and option shapes | `APIGatewayProxyEvent`, `APIGatewayProxyEventV2`, `AnyAPIGatewayProxyEvent`, `HttpResponseStream`, `AwsLambdaGlobal`, `SendStandardResponseOptions` | Type handler inputs and serializer options |\n\n`APIGatewayProxyEvent` and `APIGatewayProxyEventV2` are structural subsets of the same-named types from `@types/aws-lambda`, so events typed with either work; the adapter accepts both via `AnyAPIGatewayProxyEvent` and tells them apart by the top-level `httpMethod` field only payload format 1.0 carries. `AwsLambdaGlobal` describes the `awslambda` global the Lambda Node.js runtime injects β€” the package deliberately does not `declare global`, so importing it never pollutes your project's global types. Declare the global yourself where you need typed access to `awslambda.streamifyResponse`.\n\n## Server-side request handling\n\nUse `toStandardLazyRequest()` to convert the incoming event into a `StandardLazyRequest`, then `sendStandardResponse()` to write the resulting `StandardResponse` back through the response stream. The handler must be wrapped with `awslambda.streamifyResponse`, and the function must run on the AWS Lambda Node.js runtime with response streaming enabled.\n\n```ts\nimport type { AwsLambdaGlobal } from '@standard-server/aws-lambda'\nimport type { StandardLazyRequest, StandardResponse } from '@standard-server/core'\nimport { sendStandardResponse, toStandardLazyRequest } from '@standard-server/aws-lambda'\n\n// injected by the AWS Lambda Node.js runtime when response streaming is enabled\ndeclare const awslambda: AwsLambdaGlobal\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\nexport const handler = awslambda.streamifyResponse(async (event, responseStream, context) => {\n const standardRequest = toStandardLazyRequest(event, responseStream)\n const standardResponse = await handle(standardRequest)\n\n await sendStandardResponse(responseStream, standardResponse, {/** options */})\n})\n```\n\n`sendStandardResponse()` sends the status, headers, and cookies as the response stream metadata prelude via `awslambda.HttpResponseStream.from()`, then streams the body. It resolves once the response is fully flushed, and rejects if the stream errors.\n\n> [!TIP]\n> When sending responses, you can pass additional options such as event-stream keep-alive.\n\n## Resolving Body\n\nThe event carries the request body as a fully buffered, optionally base64-encoded string. `resolveBody(hint?)` decodes it and then 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\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## Lambda behavior to be aware of\n\n- **Response streaming must be enabled.** `sendStandardResponse()` relies on the `awslambda` global, which only exists on the AWS Lambda Node.js runtime, and on the metadata prelude of `awslambda.HttpResponseStream`, which the platform only interprets for streaming-enabled invocations.\n- **`set-cookie` is sent via metadata cookies.** Multiple cookies survive because they are sent through the dedicated `cookies` metadata field; every other multi-value header is joined with `, `.\n- **Request bodies are buffered.** API Gateway delivers the whole request body at once, so request-side streaming degrades to a single buffered chunk. Response-side streaming is real streaming.\n- **Payload format 1.0 query strings are re-encoded.** API Gateway delivers them url-decoded, so the adapter re-encodes them when reconstructing the standard url. Payload format 2.0 provides the already encoded `rawQueryString`, which is used as-is.\n- **Decoded paths are re-escaped.** HTTP APIs deliver the request path url-decoded (payload format 2.0 `rawPath` included), while REST APIs and Lambda Function URLs deliver it still encoded. The adapter percent-encodes the same characters the WHATWG [`URL`](https://url.spec.whatwg.org/#path-percent-encode-set) parser escapes in a pathname (`?`, `#`, spaces, non-ascii, ...), so encoded paths pass through unchanged and a decoded `?` or `#` cannot be mistaken for the query string or fragment. Characters API Gateway already decoded into url syntax (`%2F` β†’ `/`) or dropped cannot be recovered.\n- **Payload format 2.0 cookies are restored.** API Gateway strips the `cookie` header into the separate `cookies` field, and the adapter joins them back into a `cookie` header on the standard request.\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":""}