{"id":15393027,"url":"https://github.com/shgysk8zer0/lambda-http","last_synced_at":"2025-04-15T23:33:38.428Z","repository":{"id":250374474,"uuid":"833848634","full_name":"shgysk8zer0/lambda-http","owner":"shgysk8zer0","description":"A collection of node \u003e+ 20 utilities for Netlify Functions and AWS Lambda","archived":false,"fork":false,"pushed_at":"2025-02-28T15:24:57.000Z","size":3906,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-28T20:18:00.866Z","etag":null,"topics":["aws","formdata","lambda","netlify","npm","request","response"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@shgysk8zer0/lambda-http","language":"JavaScript","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/shgysk8zer0.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"shgysk8zer0","liberapay":"shgysk8zer0"}},"created_at":"2024-07-25T22:17:19.000Z","updated_at":"2025-02-28T15:25:00.000Z","dependencies_parsed_at":"2024-12-12T22:26:41.082Z","dependency_job_id":"6b1d967f-2a67-496c-a68d-a55d799091cc","html_url":"https://github.com/shgysk8zer0/lambda-http","commit_stats":{"total_commits":80,"total_committers":3,"mean_commits":"26.666666666666668","dds":0.475,"last_synced_commit":"e7431fe00e332cad4221e1a814225278aa1e3745"},"previous_names":["shgysk8zer0/lambda-http"],"tags_count":25,"template":false,"template_full_name":"shgysk8zer0/npm-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shgysk8zer0%2Flambda-http","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shgysk8zer0%2Flambda-http/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shgysk8zer0%2Flambda-http/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shgysk8zer0%2Flambda-http/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shgysk8zer0","download_url":"https://codeload.github.com/shgysk8zer0/lambda-http/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241226831,"owners_count":19930488,"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","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":["aws","formdata","lambda","netlify","npm","request","response"],"created_at":"2024-10-01T15:17:21.381Z","updated_at":"2025-02-28T20:31:47.040Z","avatar_url":"https://github.com/shgysk8zer0.png","language":"JavaScript","readme":"# `@shgysk8zer0/lambda-http`\n\nA collection of node \u003e= 20 utilities for Netlify Functions and AWS Lambda\n\n[![CodeQL](https://github.com/shgysk8zer0/lambda-http/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/shgysk8zer0/lambda-http/actions/workflows/codeql-analysis.yml)\n![Node CI](https://github.com/shgysk8zer0/lambda-http/workflows/Node%20CI/badge.svg)\n![Lint Code Base](https://github.com/shgysk8zer0/lambda-http/workflows/Lint%20Code%20Base/badge.svg)\n\n[![GitHub license](https://img.shields.io/github/license/shgysk8zer0/lambda-http.svg)](https://github.com/shgysk8zer0/lambda-http/blob/master/LICENSE)\n[![GitHub last commit](https://img.shields.io/github/last-commit/shgysk8zer0/lambda-http.svg)](https://github.com/shgysk8zer0/lambda-http/commits/master)\n[![GitHub release](https://img.shields.io/github/release/shgysk8zer0/lambda-http?logo=github)](https://github.com/shgysk8zer0/lambda-http/releases)\n[![GitHub Sponsors](https://img.shields.io/github/sponsors/shgysk8zer0?logo=github)](https://github.com/sponsors/shgysk8zer0)\n\n[![npm](https://img.shields.io/npm/v/@shgysk8zer0/lambda-http)](https://www.npmjs.com/package/@shgysk8zer0/lambda-http)\n![node-current](https://img.shields.io/node/v/@shgysk8zer0/lambda-http)\n![npm bundle size gzipped](https://img.shields.io/bundlephobia/minzip/@shgysk8zer0/lambda-http)\n[![npm](https://img.shields.io/npm/dw/@shgysk8zer0/lambda-http?logo=npm)](https://www.npmjs.com/package/@shgysk8zer0/lambda-http)\n\n[![GitHub followers](https://img.shields.io/github/followers/shgysk8zer0.svg?style=social)](https://github.com/shgysk8zer0)\n![GitHub forks](https://img.shields.io/github/forks/shgysk8zer0/lambda-http.svg?style=social)\n![GitHub stars](https://img.shields.io/github/stars/shgysk8zer0/lambda-http.svg?style=social)\n[![Twitter Follow](https://img.shields.io/twitter/follow/shgysk8zer0.svg?style=social)](https://twitter.com/shgysk8zer0)\n\n[![Donate using Liberapay](https://img.shields.io/liberapay/receives/shgysk8zer0.svg?logo=liberapay)](https://liberapay.com/shgysk8zer0/donate \"Donate using Liberapay\")\n- - -\n\n- [Code of Conduct](./.github/CODE_OF_CONDUCT.md)\n- [Contributing](./.github/CONTRIBUTING.md)\n\u003c!-- - [Security Policy](./.github/SECURITY.md) --\u003e\n\nThis package makes use of node \u003e= 20 having support for the familiar [`Request`](https://developer.mozilla.org/en-US/docs/Web/API/Request)\n\u0026 [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response) objects to provide easier and more standards-based\nway of creating [ Netlify Functions](https://docs.netlify.com/functions/overview/) and (theoretically) AWS Lambda.\n\n## Benefits\n- Familiar `Request` \u0026 `Response` objects\n- Built-in support for `FormData` \u0026 `File`s \u0026 `Blob`s\n- Easy support for CORS while still being customizable\n- Convenient `{ [method]: async handler(requset) }` syntax\n- Constants for HTTP Status Codes \u0026 common Mime-Types\n- A custom HTTPError class\n- Currently weighs in at only 42.5 kB (unpacked size, including ESM \u0026 CJS \u0026 \u0026 README LICENSE \u0026 CHANGELOG)\n\n## Example\n\n```js\nimport { createHandler, HTTPError, HTTP_STATUS } from '@shgysk8zer0/lambda-http';\n\nexport default createHandler({\n  async get(req) {\n    return Response.json({\n      url: req.url,\n      method: req.method,\n      headers: Object.fromEntries(req.headers),\n    });\n  },\n  async post(req) {\n    const data = await req.formData();\n    // Or `req.json()`\n\n    if (! (data.has('email') \u0026\u0026 data.has('password'))) {\n      throw new HTTPError('Email and password are required', HTTP_STATUS.BAD_REQUEST);\n    } else {\n      // Sign-in logic here\n      return Response.json(user);\n    }\n  },\n  async put(req) {\n    const blob = await req.blob();\n    // Or use `req.arrayBuffer()`\n    // Maybe save it as a file...\n\n    return new Response(null, { status: HTTP_STATUS.NO_CONTENT });\n  }\n  async delete(req) {\n    const params = new URLSearchParams(req.url);\n\n    if (params.has('id')) {\n      // Handle some delete operation\n    } else {\n      throw new HTTPError('Missing required id.', HTTP_STATUS.BAD_REQUEST);\n    }\n  }\n}, {\n  allowOrigins: ['https://example.com'],\n  allowHeaders: ['Authorization'],\n  exposeHeaders: ['X-Foo'],\n  allowCredentials: true,\n  logger(err, req) {\n    console.error({ err, req });\n  }\n});\n```\n\n## CommonJS (`require()`) Note\n\nThis is primarily intended for use with ES Modules, though CJS files are generated via Rollup.\nBecause of this, bear in mind that default exports and named exports do not perfectly translate,\nand you cannot just use `const createHandler = require('@shgysk8zer0/lambda-http')` like you can\nwith modules. You'll have to use `const { createHandler } = require('@shgysk8zer0/lambda-http')`\nor `const { default: createHandler } = require('@shgysk8zer0/lambda-http')`.\n","funding_links":["https://github.com/sponsors/shgysk8zer0","https://liberapay.com/shgysk8zer0","https://liberapay.com/shgysk8zer0/donate"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshgysk8zer0%2Flambda-http","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshgysk8zer0%2Flambda-http","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshgysk8zer0%2Flambda-http/lists"}