@vyriy/handler 0.5.6 → 0.6.5

package/README.md

@@ -122,6 +122,42 @@ export const handler = sns(async (event) => {
 });
 ```
 
+Use a prebuilt DynamoDB Streams handler chain:
+
+```ts
+import { dynamodb } from '@vyriy/handler';
+
+export const handler = dynamodb(async (event) => {
+  for (const record of event.Records) {
+    console.info(record.eventName);
+  }
+});
+```
+
+Use a prebuilt S3 event handler chain:
+
+```ts
+import { s3 } from '@vyriy/handler';
+
+export const handler = s3(async (event) => {
+  for (const record of event.Records) {
+    console.info(record.s3.bucket.name, record.s3.object.key);
+  }
+});
+```
+
+Use a prebuilt SES receipt handler chain:
+
+```ts
+import { ses } from '@vyriy/handler';
+
+export const handler = ses(async (event) => {
+  for (const record of event.Records) {
+    console.info(record.ses.mail.messageId, record.ses.mail.source);
+  }
+});
+```
+
 Use a prebuilt schedule handler chain:
 
 ```ts
@@ -132,6 +168,16 @@ export const handler = schedule(async (event) => {
 });
 ```
 
+Use a prebuilt EventBridge custom event handler chain:
+
+```ts
+import { eventBridge } from '@vyriy/handler';
+
+export const handler = eventBridge(async (event) => {
+  console.info('EventBridge event:', event.source, event['detail-type'], event.detail);
+});
+```
+
 Compose a custom handler pipeline from individual helpers:
 
 ```ts
@@ -193,6 +239,18 @@ export const handler = compose(
 - `streamApi`
   Response streaming API Gateway chain with the same wrapper behavior as `api`. Handlers receive `(event, responseStream, context)` and write directly to the Lambda response stream.
 
+- `dynamodb`
+  DynamoDB Streams chain with logging, timeout handling, context setup, smoke checks, and rethrown errors.
+
+- `eventBridge`
+  EventBridge custom event chain with logging, timeout handling, context setup, smoke checks, and rethrown errors.
+
+- `s3`
+  S3 event chain with logging, timeout handling, context setup, smoke checks, and rethrown errors.
+
+- `ses`
+  SES receipt rule chain for incoming email processing with logging, timeout handling, context setup, smoke checks, and rethrown errors.
+
 - `schedule`
   EventBridge schedule chain with logging, timeout handling, context setup, smoke checks, and rethrown errors.
 
@@ -364,7 +422,7 @@ export const handler = withSmoke()(async () => {
 });
 ```
 
-`withSmoke()` is used by the API, schedule, SNS, and SQS chains.
+`withSmoke()` is used by the API, DynamoDB Streams, S3, SES receipt, schedule, SNS, and SQS chains.
 
 ## Types
 
@@ -377,5 +435,6 @@ import type { Context, Decorator, Handler, HandlerParams, Response } from '@vyri
 ## Notes
 
 - `api` includes API-specific wrappers such as healthcheck handling, default headers, and CORS preflight handling
-- `schedule`, `sns`, and `sqs` use `withError()` so failures are rethrown for event-source retry behavior
+- `dynamodb`, `s3`, `ses`, `schedule`, `sns`, and `sqs` use `withError()` so failures are rethrown for event-source retry behavior
+- `ses` targets SES receipt rule Lambda events for incoming email; SES event publishing notifications can still be handled through the `sns` chain when delivered via SNS
 - `withSmoke()` delegates matching to `@vyriy/smoke` and returns its API Gateway-compatible response

package/api.js

@@ -9,16 +9,16 @@ import { streamWithHeaders, withHeaders } from './wrapper/headers.js';
 import { streamWithCors, withCors } from './wrapper/cors.js';
 import { streamWithChaos, withChaos } from './wrapper/chaos.js';
 export const api = compose(withApiError(), withLogger(), withTimeout(), withContext(), withSmoke(), withHealthcheck(), withHeaders({
-    'Access-Control-Allow-Origin': '*',
-    'Access-Control-Allow-Methods': 'GET, POST, PUT, PATCH, DELETE, OPTIONS',
-    'Access-Control-Allow-Headers': 'Content-Type, Authorization, X-Requested-With, X-Api-Key, Accept, User-Agent, X-CSRF-Token',
-    'Content-Type': 'application/json',
-    'X-Robots-Tag': 'noindex, nofollow',
+    'access-control-allow-origin': '*',
+    'access-control-allow-methods': 'GET, POST, PUT, PATCH, DELETE, OPTIONS',
+    'access-control-allow-headers': 'Content-Type, Authorization, X-Requested-With, X-Api-Key, Accept, User-Agent, X-CSRF-Token',
+    'content-type': 'application/json',
+    'x-robots-tag': 'noindex, nofollow',
 }), withCors(), withChaos());
 export const streamApi = streamCompose(streamWithApiError(), streamWithLogger(), streamWithTimeout(), streamWithContext(), streamWithSmoke(), streamWithHealthcheck(), streamWithHeaders({
-    'Access-Control-Allow-Origin': '*',
-    'Access-Control-Allow-Methods': 'GET, POST, PUT, PATCH, DELETE, OPTIONS',
-    'Access-Control-Allow-Headers': 'Content-Type, Authorization, X-Requested-With, X-Api-Key, Accept, User-Agent, X-CSRF-Token',
-    'Content-Type': 'application/json',
-    'X-Robots-Tag': 'noindex, nofollow',
+    'access-control-allow-origin': '*',
+    'access-control-allow-methods': 'GET, POST, PUT, PATCH, DELETE, OPTIONS',
+    'access-control-allow-headers': 'Content-Type, Authorization, X-Requested-With, X-Api-Key, Accept, User-Agent, X-CSRF-Token',
+    'content-type': 'application/json',
+    'x-robots-tag': 'noindex, nofollow',
 }), streamWithCors(), streamWithChaos());

package/dynamodb.d.ts

@@ -0,0 +1,2 @@
+import type { DynamoDBStreamEvent } from 'aws-lambda';
+export declare const dynamodb: import("./types.js").Decorator<DynamoDBStreamEvent, void>;

package/dynamodb.js

@@ -0,0 +1,7 @@
+import { compose } from './compose.js';
+import { withError } from './wrapper/error.js';
+import { withLogger } from './wrapper/logger.js';
+import { withTimeout } from './wrapper/timeout.js';
+import { withContext } from './wrapper/context.js';
+import { withSmoke } from './wrapper/smoke.js';
+export const dynamodb = compose(withError(), withLogger(), withTimeout(), withContext(), withSmoke());

package/eventBridge.d.ts

@@ -0,0 +1,2 @@
+import type { EventBridgeEvent } from 'aws-lambda';
+export declare const eventBridge: import("./types.js").Decorator<EventBridgeEvent<string, unknown>, void>;

package/eventBridge.js

@@ -0,0 +1,7 @@
+import { compose } from './compose.js';
+import { withError } from './wrapper/error.js';
+import { withLogger } from './wrapper/logger.js';
+import { withTimeout } from './wrapper/timeout.js';
+import { withContext } from './wrapper/context.js';
+import { withSmoke } from './wrapper/smoke.js';
+export const eventBridge = compose(withError(), withLogger(), withTimeout(), withContext(), withSmoke());

package/index.d.ts

@@ -1,7 +1,11 @@
 export * from './api.js';
 export * from './compose.js';
+export * from './dynamodb.js';
+export * from './eventBridge.js';
 export * from './factory.js';
+export * from './s3.js';
 export * from './schedule.js';
+export * from './ses.js';
 export * from './sns.js';
 export * from './sqs.js';
 export * from './wrapper/context.js';

package/index.js

@@ -1,7 +1,11 @@
 export * from './api.js';
 export * from './compose.js';
+export * from './dynamodb.js';
+export * from './eventBridge.js';
 export * from './factory.js';
+export * from './s3.js';
 export * from './schedule.js';
+export * from './ses.js';
 export * from './sns.js';
 export * from './sqs.js';
 export * from './wrapper/context.js';

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@vyriy/handler",
-  "version": "0.5.6",
+  "version": "0.6.5",
   "description": "Composable AWS Lambda handler chains and wrappers for Vyriy projects",
   "type": "module",
   "dependencies": {
-    "@types/aws-lambda": "^8.10.161",
-    "@vyriy/chaos": "0.5.6",
-    "@vyriy/config": "0.5.6",
-    "@vyriy/logger": "0.5.6",
-    "@vyriy/smoke": "0.5.6",
-    "@vyriy/timeout": "0.5.6"
+    "@types/aws-lambda": "^8.10.162",
+    "@vyriy/chaos": "0.6.5",
+    "@vyriy/config": "0.6.5",
+    "@vyriy/logger": "0.6.5",
+    "@vyriy/smoke": "0.6.5",
+    "@vyriy/timeout": "0.6.5"
   },
   "agents": "./AGENTS.md",
   "license": "MIT",
@@ -46,6 +46,26 @@
       "import": "./compose.js",
       "default": "./compose.js"
     },
+    "./dynamodb": {
+      "types": "./dynamodb.d.ts",
+      "import": "./dynamodb.js",
+      "default": "./dynamodb.js"
+    },
+    "./dynamodb.js": {
+      "types": "./dynamodb.d.ts",
+      "import": "./dynamodb.js",
+      "default": "./dynamodb.js"
+    },
+    "./eventBridge": {
+      "types": "./eventBridge.d.ts",
+      "import": "./eventBridge.js",
+      "default": "./eventBridge.js"
+    },
+    "./eventBridge.js": {
+      "types": "./eventBridge.d.ts",
+      "import": "./eventBridge.js",
+      "default": "./eventBridge.js"
+    },
     "./factory": {
       "types": "./factory.d.ts",
       "import": "./factory.js",
@@ -66,6 +86,16 @@
       "import": "./index.js",
       "default": "./index.js"
     },
+    "./s3": {
+      "types": "./s3.d.ts",
+      "import": "./s3.js",
+      "default": "./s3.js"
+    },
+    "./s3.js": {
+      "types": "./s3.d.ts",
+      "import": "./s3.js",
+      "default": "./s3.js"
+    },
     "./schedule": {
       "types": "./schedule.d.ts",
       "import": "./schedule.js",
@@ -76,6 +106,16 @@
       "import": "./schedule.js",
       "default": "./schedule.js"
     },
+    "./ses": {
+      "types": "./ses.d.ts",
+      "import": "./ses.js",
+      "default": "./ses.js"
+    },
+    "./ses.js": {
+      "types": "./ses.d.ts",
+      "import": "./ses.js",
+      "default": "./ses.js"
+    },
     "./sns": {
       "types": "./sns.d.ts",
       "import": "./sns.js",

package/s3.d.ts

@@ -0,0 +1,2 @@
+import type { S3Event } from 'aws-lambda';
+export declare const s3: import("./types.js").Decorator<S3Event, void>;

package/s3.js

@@ -0,0 +1,7 @@
+import { compose } from './compose.js';
+import { withError } from './wrapper/error.js';
+import { withLogger } from './wrapper/logger.js';
+import { withTimeout } from './wrapper/timeout.js';
+import { withContext } from './wrapper/context.js';
+import { withSmoke } from './wrapper/smoke.js';
+export const s3 = compose(withError(), withLogger(), withTimeout(), withContext(), withSmoke());

package/ses.d.ts

@@ -0,0 +1,2 @@
+import type { SESEvent } from 'aws-lambda';
+export declare const ses: import("./types.js").Decorator<SESEvent, void>;

package/ses.js

@@ -0,0 +1,7 @@
+import { compose } from './compose.js';
+import { withError } from './wrapper/error.js';
+import { withLogger } from './wrapper/logger.js';
+import { withTimeout } from './wrapper/timeout.js';
+import { withContext } from './wrapper/context.js';
+import { withSmoke } from './wrapper/smoke.js';
+export const ses = compose(withError(), withLogger(), withTimeout(), withContext(), withSmoke());

package/wrapper/headers.js

@@ -1,9 +1,10 @@
 import { factory, streamFactory } from '../factory.js';
 import { responseStream } from './stream.js';
+const normalizeHeaders = (headers) => Object.fromEntries(Object.entries(headers ?? {}).map(([key, value]) => [key.toLowerCase(), value]));
 const mergeHeaders = (result, options) => {
     result.headers = {
-        ...options,
-        ...result.headers,
+        ...normalizeHeaders(options),
+        ...normalizeHeaders(result.headers),
     };
     return result;
 };
@@ -13,5 +14,5 @@ export const withHeaders = factory(async (handler, args, options = {}) => {
 });
 export const streamWithHeaders = streamFactory(async (handler, args, options = {}) => {
     const [event, stream, context] = args;
-    await handler(event, responseStream(stream, { headers: options }), context);
+    await handler(event, responseStream(stream, { headers: normalizeHeaders(options) }), context);
 });

package/wrapper/stream.js

@@ -1,4 +1,7 @@
-const getContentType = (headers) => headers?.['content-type'] ?? headers?.['Content-Type'];
+const getContentType = (headers) => {
+    const contentType = Object.entries(headers ?? {}).find(([key]) => key.toLowerCase() === 'content-type')?.[1];
+    return typeof contentType === 'string' ? contentType : undefined;
+};
 export const responseStream = (stream, metadata = {}) => {
     const runtimeStream = globalThis.awslambda?.HttpResponseStream?.from?.(stream, {
         headers: metadata.headers,
@@ -9,7 +12,7 @@ export const responseStream = (stream, metadata = {}) => {
     }
     const contentType = getContentType(metadata.headers);
     if (contentType) {
-        stream.setContentType?.(String(contentType));
+        stream.setContentType?.(contentType);
     }
     return stream;
 };