@vyriy/handler 0.5.5 → 0.6.0

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
@@ -193,6 +229,15 @@ 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.
+
+- `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 +409,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 +422,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/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/index.d.ts

@@ -1,7 +1,10 @@
 export * from './api.js';
 export * from './compose.js';
+export * from './dynamodb.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,10 @@
 export * from './api.js';
 export * from './compose.js';
+export * from './dynamodb.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.5",
+  "version": "0.6.0",
   "description": "Composable AWS Lambda handler chains and wrappers for Vyriy projects",
   "type": "module",
   "dependencies": {
     "@types/aws-lambda": "^8.10.161",
-    "@vyriy/chaos": "0.5.5",
-    "@vyriy/config": "0.5.5",
-    "@vyriy/logger": "0.5.5",
-    "@vyriy/smoke": "0.5.5",
-    "@vyriy/timeout": "0.5.5"
+    "@vyriy/chaos": "0.6.0",
+    "@vyriy/config": "0.6.0",
+    "@vyriy/logger": "0.6.0",
+    "@vyriy/smoke": "0.6.0",
+    "@vyriy/timeout": "0.6.0"
   },
   "agents": "./AGENTS.md",
   "license": "MIT",
@@ -46,6 +46,16 @@
       "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"
+    },
     "./factory": {
       "types": "./factory.d.ts",
       "import": "./factory.js",
@@ -66,6 +76,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 +96,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());