Merge branch 'main' into event-handler/throw-middleware-no-await-next

Author: dreamorosi

docs/features/event-handler/rest.md

@@ -3,4 +3,4 @@ mkdocs-material==9.6.20
 mkdocs-git-revision-date-plugin==0.3.2
 mkdocs-exclude==1.0.2
 mkdocs-typedoc==1.0.4
-mkdocs-llmstxt==0.3.1
+mkdocs-llmstxt==0.3.2

docs/requirements.in

@@ -274,9 +274,9 @@ mkdocs-get-deps==0.2.0 \
 mkdocs-git-revision-date-plugin==0.3.2 \
     --hash=sha256:2e67956cb01823dd2418e2833f3623dee8604cdf223bddd005fe36226a56f6ef
     # via -r requirements.in
-mkdocs-llmstxt==0.3.1 \
-    --hash=sha256:123119d9b984c1d1224ed5af250bfbc49879ad83decdaff59d8b0ebb459ddc54 \
-    --hash=sha256:31f5b6aaae6123c09a2b1c32912c3eb21ccb356b5db7abb867f105e8cc392653
+mkdocs-llmstxt==0.3.2 \
+    --hash=sha256:dd63acb8257fca3244058fd820acd4700c1626dbe48ad3a1a2cc9c599f8e4b7f \
+    --hash=sha256:fb363205d6f1452411dc5069f62012cb6b29e1788f6db9cc17793bdca7eabea8
     # via -r requirements.in
 mkdocs-material==9.6.20 \
     --hash=sha256:b8d8c8b0444c7c06dd984b55ba456ce731f0035c5a1533cc86793618eb1e6c82 \

docs/requirements.txt

@@ -29,7 +29,7 @@
   },
   "devDependencies": {
     "@types/aws-lambda": "^8.10.152",
-    "@types/node": "24.5.1",
+    "@types/node": "24.5.2",
     "aws-cdk-lib": "^2.214.0",
     "constructs": "^10.4.2",
     "source-map-support": "^0.5.21",
@@ -48,10 +48,10 @@
     "@aws-sdk/lib-dynamodb": "^3.888.0",
     "@middy/core": "^4.7.0",
     "@types/aws-lambda": "^8.10.152",
-    "@types/node": "24.5.1",
+    "@types/node": "24.5.2",
     "aws-cdk": "^2.1029.1",
     "constructs": "^10.4.2",
-    "esbuild": "^0.25.9",
+    "esbuild": "^0.25.10",
     "typescript": "^5.9.2"
   }
 }

examples/app/package.json

@@ -0,0 +1,21 @@
+import { readFile } from 'node:fs/promises';
+import { Router } from '@aws-lambda-powertools/event-handler/experimental-rest';
+import { compress } from '@aws-lambda-powertools/event-handler/experimental-rest/middleware';
+import type { Context } from 'aws-lambda';
+
+const app = new Router();
+
+app.get('/logo', [compress()], async () => {
+  const logoFile = await readFile(`${process.env.LAMBDA_TASK_ROOT}/logo.png`);
+  return {
+    body: logoFile.toString('base64'),
+    isBase64Encoded: true,
+    headers: {
+      'Content-Type': 'image/png',
+    },
+    statusCode: 200,
+  };
+});
+
+export const handler = async (event: unknown, context: Context) =>
+  app.resolve(event, context);

examples/snippets/event-handler/rest/advanced_binary_responses.ts

@@ -0,0 +1,17 @@
+declare function getTodoById<T>(todoId: unknown): Promise<{ id: string } & T>;
+
+import { Router } from '@aws-lambda-powertools/event-handler/experimental-rest';
+import { compress } from '@aws-lambda-powertools/event-handler/experimental-rest/middleware';
+import type { Context } from 'aws-lambda';
+
+const app = new Router();
+
+app.use(compress());
+
+app.get('/todos/:todoId', async ({ todoId }) => {
+  const todo = await getTodoById(todoId);
+  return { todo };
+});
+
+export const handler = async (event: unknown, context: Context) =>
+  app.resolve(event, context);

examples/snippets/event-handler/rest/advanced_compress.ts

@@ -0,0 +1,26 @@
+declare function getTodoById<T>(todoId: unknown): Promise<{ id: string } & T>;
+
+import { Router } from '@aws-lambda-powertools/event-handler/experimental-rest';
+import { cors } from '@aws-lambda-powertools/event-handler/experimental-rest/middleware';
+import type { Context } from 'aws-lambda';
+
+const app = new Router();
+
+app.use(
+  cors({
+    origin: 'https://example.com',
+    maxAge: 300,
+  })
+);
+
+app.get('/todos/:todoId', async ({ todoId }) => {
+  const todo = await getTodoById(todoId);
+  return { todo };
+});
+
+app.get('/health', [cors({ origin: '*' })], async () => {
+  return { status: 'ok' };
+});
+
+export const handler = async (event: unknown, context: Context) =>
+  app.resolve(event, context);

examples/snippets/event-handler/rest/advanced_cors_per_route.ts

@@ -0,0 +1,22 @@
+declare function getTodoById<T>(todoId: unknown): Promise<{ id: string } & T>;
+
+import { Router } from '@aws-lambda-powertools/event-handler/experimental-rest';
+import { cors } from '@aws-lambda-powertools/event-handler/experimental-rest/middleware';
+import type { Context } from 'aws-lambda';
+
+const app = new Router();
+
+app.use(
+  cors({
+    origin: 'https://example.com',
+    maxAge: 300,
+  })
+);
+
+app.get('/todos/:todoId', async ({ todoId }) => {
+  const todo = await getTodoById(todoId);
+  return { todo };
+});
+
+export const handler = async (event: unknown, context: Context) =>
+  app.resolve(event, context);

examples/snippets/event-handler/rest/advanced_cors_simple.ts

@@ -23,7 +23,7 @@ app.get('/todos', async () => {
   });
 });
 
-app.post('/todos', async (params, reqCtx) => {
+app.post('/todos', async (_, reqCtx) => {
   const body = await reqCtx.request.json();
   const todo = await createTodo(body.title);
 
@@ -36,6 +36,5 @@ app.post('/todos', async (params, reqCtx) => {
   });
 });
 
-export const handler = async (event: unknown, context: Context) => {
-  return app.resolve(event, context);
-};
+export const handler = async (event: unknown, context: Context) =>
+  app.resolve(event, context);