@step-func-emailer/handlers 0.2.0

package/dist/handlers/__tests__/bounce-handler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bounce-handler.test.d.ts.map

package/dist/handlers/__tests__/bounce-handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounce-handler.test.d.ts","sourceRoot":"","sources":["../../../src/handlers/__tests__/bounce-handler.test.ts"],"names":[],"mappings":""}

package/dist/handlers/__tests__/bounce-handler.test.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const mockResolveConfig = vitest_1.vi.fn();
+const mockWriteSuppression = vitest_1.vi.fn();
+const mockSetProfileFlag = vitest_1.vi.fn();
+const mockStopAllExecutions = vitest_1.vi.fn();
+vitest_1.vi.mock("../../lib/ssm-config.js", () => ({
+    resolveConfig: () => mockResolveConfig(),
+}));
+vitest_1.vi.mock("../../lib/dynamo-client.js", () => ({
+    writeSuppression: (...args) => mockWriteSuppression(...args),
+    setProfileFlag: (...args) => mockSetProfileFlag(...args),
+}));
+vitest_1.vi.mock("../../lib/execution-stopper.js", () => ({
+    stopAllExecutions: (...args) => mockStopAllExecutions(...args),
+}));
+const { handler } = await import("../bounce-handler.js");
+const CONFIG = { tableName: "TestTable" };
+function snsEvent(message) {
+    return {
+        Records: [
+            {
+                Sns: { Message: JSON.stringify(message) },
+            },
+        ],
+    };
+}
+beforeEach(() => {
+    mockResolveConfig.mockReset().mockResolvedValue(CONFIG);
+    mockWriteSuppression.mockReset().mockResolvedValue(undefined);
+    mockSetProfileFlag.mockReset().mockResolvedValue(undefined);
+    mockStopAllExecutions.mockReset().mockResolvedValue(undefined);
+});
+describe("bounce-handler", () => {
+    it("suppresses subscriber on permanent bounce", async () => {
+        const event = snsEvent({
+            notificationType: "Bounce",
+            bounce: {
+                bounceType: "Permanent",
+                bouncedRecipients: [{ emailAddress: "bounced@example.com" }],
+                feedbackId: "feedback-1",
+            },
+        });
+        await handler(event);
+        expect(mockWriteSuppression).toHaveBeenCalledWith("TestTable", "bounced@example.com", "bounce", "Permanent", "feedback-1");
+        expect(mockSetProfileFlag).toHaveBeenCalledWith("TestTable", "bounced@example.com", "suppressed");
+        expect(mockStopAllExecutions).toHaveBeenCalledWith("TestTable", "bounced@example.com");
+    });
+    it("ignores transient bounces", async () => {
+        const event = snsEvent({
+            notificationType: "Bounce",
+            bounce: {
+                bounceType: "Transient",
+                bouncedRecipients: [{ emailAddress: "user@example.com" }],
+                feedbackId: "feedback-2",
+            },
+        });
+        await handler(event);
+        expect(mockWriteSuppression).not.toHaveBeenCalled();
+        expect(mockSetProfileFlag).not.toHaveBeenCalled();
+        expect(mockStopAllExecutions).not.toHaveBeenCalled();
+    });
+    it("suppresses subscriber on complaint", async () => {
+        const event = snsEvent({
+            notificationType: "Complaint",
+            complaint: {
+                complainedRecipients: [{ emailAddress: "complainer@example.com" }],
+                feedbackId: "feedback-3",
+            },
+        });
+        await handler(event);
+        expect(mockWriteSuppression).toHaveBeenCalledWith("TestTable", "complainer@example.com", "complaint", undefined, "feedback-3");
+        expect(mockSetProfileFlag).toHaveBeenCalledWith("TestTable", "complainer@example.com", "suppressed");
+        expect(mockStopAllExecutions).toHaveBeenCalledWith("TestTable", "complainer@example.com");
+    });
+    it("handles multiple recipients in a bounce", async () => {
+        const event = snsEvent({
+            notificationType: "Bounce",
+            bounce: {
+                bounceType: "Permanent",
+                bouncedRecipients: [
+                    { emailAddress: "a@example.com" },
+                    { emailAddress: "b@example.com" },
+                ],
+                feedbackId: "feedback-4",
+            },
+        });
+        await handler(event);
+        expect(mockWriteSuppression).toHaveBeenCalledTimes(2);
+        expect(mockSetProfileFlag).toHaveBeenCalledTimes(2);
+        expect(mockStopAllExecutions).toHaveBeenCalledTimes(2);
+    });
+    it("handles multiple SNS records", async () => {
+        const event = {
+            Records: [
+                {
+                    Sns: {
+                        Message: JSON.stringify({
+                            notificationType: "Bounce",
+                            bounce: {
+                                bounceType: "Permanent",
+                                bouncedRecipients: [{ emailAddress: "a@example.com" }],
+                                feedbackId: "f1",
+                            },
+                        }),
+                    },
+                },
+                {
+                    Sns: {
+                        Message: JSON.stringify({
+                            notificationType: "Complaint",
+                            complaint: {
+                                complainedRecipients: [{ emailAddress: "b@example.com" }],
+                                feedbackId: "f2",
+                            },
+                        }),
+                    },
+                },
+            ],
+        };
+        await handler(event);
+        expect(mockWriteSuppression).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=bounce-handler.test.js.map

package/dist/handlers/__tests__/bounce-handler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounce-handler.test.js","sourceRoot":"","sources":["../../../src/handlers/__tests__/bounce-handler.test.ts"],"names":[],"mappings":";;AAAA,mCAA4B;AAG5B,MAAM,iBAAiB,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;AAClC,MAAM,oBAAoB,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;AACrC,MAAM,kBAAkB,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;AACnC,MAAM,qBAAqB,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;AAEtC,WAAE,CAAC,IAAI,CAAC,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;IACxC,aAAa,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE;CACzC,CAAC,CAAC,CAAC;AAEJ,WAAE,CAAC,IAAI,CAAC,4BAA4B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3C,gBAAgB,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;IACvE,cAAc,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;CACpE,CAAC,CAAC,CAAC;AAEJ,WAAE,CAAC,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/C,iBAAiB,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC;CAC1E,CAAC,CAAC,CAAC;AAEJ,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAEzD,MAAM,MAAM,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AAE1C,SAAS,QAAQ,CAAC,OAAgB;IAChC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;aAC1C;SACF;KACU,CAAC;AAChB,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACd,iBAAiB,CAAC,SAAS,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACxD,oBAAoB,CAAC,SAAS,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC9D,kBAAkB,CAAC,SAAS,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC5D,qBAAqB,CAAC,SAAS,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AACjE,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,KAAK,GAAG,QAAQ,CAAC;YACrB,gBAAgB,EAAE,QAAQ;YAC1B,MAAM,EAAE;gBACN,UAAU,EAAE,WAAW;gBACvB,iBAAiB,EAAE,CAAC,EAAE,YAAY,EAAE,qBAAqB,EAAE,CAAC;gBAC5D,UAAU,EAAE,YAAY;aACzB;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QAErB,MAAM,CAAC,oBAAoB,CAAC,CAAC,oBAAoB,CAC/C,WAAW,EACX,qBAAqB,EACrB,QAAQ,EACR,WAAW,EACX,YAAY,CACb,CAAC;QACF,MAAM,CAAC,kBAAkB,CAAC,CAAC,oBAAoB,CAC7C,WAAW,EACX,qBAAqB,EACrB,YAAY,CACb,CAAC;QACF,MAAM,CAAC,qBAAqB,CAAC,CAAC,oBAAoB,CAChD,WAAW,EACX,qBAAqB,CACtB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,KAAK,GAAG,QAAQ,CAAC;YACrB,gBAAgB,EAAE,QAAQ;YAC1B,MAAM,EAAE;gBACN,UAAU,EAAE,WAAW;gBACvB,iBAAiB,EAAE,CAAC,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC;gBACzD,UAAU,EAAE,YAAY;aACzB;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QAErB,MAAM,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACpD,MAAM,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAClD,MAAM,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,KAAK,GAAG,QAAQ,CAAC;YACrB,gBAAgB,EAAE,WAAW;YAC7B,SAAS,EAAE;gBACT,oBAAoB,EAAE,CAAC,EAAE,YAAY,EAAE,wBAAwB,EAAE,CAAC;gBAClE,UAAU,EAAE,YAAY;aACzB;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QAErB,MAAM,CAAC,oBAAoB,CAAC,CAAC,oBAAoB,CAC/C,WAAW,EACX,wBAAwB,EACxB,WAAW,EACX,SAAS,EACT,YAAY,CACb,CAAC;QACF,MAAM,CAAC,kBAAkB,CAAC,CAAC,oBAAoB,CAC7C,WAAW,EACX,wBAAwB,EACxB,YAAY,CACb,CAAC;QACF,MAAM,CAAC,qBAAqB,CAAC,CAAC,oBAAoB,CAChD,WAAW,EACX,wBAAwB,CACzB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,KAAK,GAAG,QAAQ,CAAC;YACrB,gBAAgB,EAAE,QAAQ;YAC1B,MAAM,EAAE;gBACN,UAAU,EAAE,WAAW;gBACvB,iBAAiB,EAAE;oBACjB,EAAE,YAAY,EAAE,eAAe,EAAE;oBACjC,EAAE,YAAY,EAAE,eAAe,EAAE;iBAClC;gBACD,UAAU,EAAE,YAAY;aACzB;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QAErB,MAAM,CAAC,oBAAoB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,kBAAkB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,qBAAqB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,KAAK,GAAa;YACtB,OAAO,EAAE;gBACP;oBACE,GAAG,EAAE;wBACH,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;4BACtB,gBAAgB,EAAE,QAAQ;4BAC1B,MAAM,EAAE;gCACN,UAAU,EAAE,WAAW;gCACvB,iBAAiB,EAAE,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;gCACtD,UAAU,EAAE,IAAI;6BACjB;yBACF,CAAC;qBACH;iBACF;gBACD;oBACE,GAAG,EAAE;wBACH,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;4BACtB,gBAAgB,EAAE,WAAW;4BAC7B,SAAS,EAAE;gCACT,oBAAoB,EAAE,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;gCACzD,UAAU,EAAE,IAAI;6BACjB;yBACF,CAAC;qBACH;iBACF;aACF;SACU,CAAC;QAEd,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QAErB,MAAM,CAAC,oBAAoB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/handlers/__tests__/check-condition.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=check-condition.test.d.ts.map

package/dist/handlers/__tests__/check-condition.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-condition.test.d.ts","sourceRoot":"","sources":["../../../src/handlers/__tests__/check-condition.test.ts"],"names":[],"mappings":""}

package/dist/handlers/__tests__/check-condition.test.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const mockResolveConfig = vitest_1.vi.fn();
+const mockGetSubscriberProfile = vitest_1.vi.fn();
+const mockHasBeenSent = vitest_1.vi.fn();
+vitest_1.vi.mock("../../lib/ssm-config.js", () => ({
+    resolveConfig: () => mockResolveConfig(),
+}));
+vitest_1.vi.mock("../../lib/dynamo-client.js", () => ({
+    getSubscriberProfile: (...args) => mockGetSubscriberProfile(...args),
+    hasBeenSent: (...args) => mockHasBeenSent(...args),
+}));
+const { handler } = await import("../check-condition.js");
+const CONFIG = { tableName: "TestTable" };
+beforeEach(() => {
+    mockResolveConfig.mockReset().mockResolvedValue(CONFIG);
+    mockGetSubscriberProfile.mockReset();
+    mockHasBeenSent.mockReset();
+});
+describe("check-condition handler", () => {
+    describe("subscriber_field_exists", () => {
+        it("returns true when field exists and has a value", async () => {
+            mockGetSubscriberProfile.mockResolvedValueOnce({
+                attributes: { platform: "web" },
+            });
+            const result = await handler({
+                check: "subscriber_field_exists",
+                field: "platform",
+                subscriber: { email: "user@example.com", firstName: "Jane" },
+            });
+            expect(result).toEqual({ result: true });
+        });
+        it("returns false when field is empty string", async () => {
+            mockGetSubscriberProfile.mockResolvedValueOnce({
+                attributes: { platform: "" },
+            });
+            const result = await handler({
+                check: "subscriber_field_exists",
+                field: "platform",
+                subscriber: { email: "user@example.com", firstName: "Jane" },
+            });
+            expect(result).toEqual({ result: false });
+        });
+        it("returns false when field is undefined", async () => {
+            mockGetSubscriberProfile.mockResolvedValueOnce({
+                attributes: {},
+            });
+            const result = await handler({
+                check: "subscriber_field_exists",
+                field: "platform",
+                subscriber: { email: "user@example.com", firstName: "Jane" },
+            });
+            expect(result).toEqual({ result: false });
+        });
+        it("returns false when profile does not exist", async () => {
+            mockGetSubscriberProfile.mockResolvedValueOnce(null);
+            const result = await handler({
+                check: "subscriber_field_exists",
+                field: "platform",
+                subscriber: { email: "user@example.com", firstName: "Jane" },
+            });
+            expect(result).toEqual({ result: false });
+        });
+    });
+    describe("subscriber_field_equals", () => {
+        it("returns true when field matches value", async () => {
+            mockGetSubscriberProfile.mockResolvedValueOnce({
+                attributes: { plan: "pro" },
+            });
+            const result = await handler({
+                check: "subscriber_field_equals",
+                field: "plan",
+                value: "pro",
+                subscriber: { email: "user@example.com", firstName: "Jane" },
+            });
+            expect(result).toEqual({ result: true });
+        });
+        it("returns false when field does not match", async () => {
+            mockGetSubscriberProfile.mockResolvedValueOnce({
+                attributes: { plan: "free" },
+            });
+            const result = await handler({
+                check: "subscriber_field_equals",
+                field: "plan",
+                value: "pro",
+                subscriber: { email: "user@example.com", firstName: "Jane" },
+            });
+            expect(result).toEqual({ result: false });
+        });
+        it("returns false when profile is null", async () => {
+            mockGetSubscriberProfile.mockResolvedValueOnce(null);
+            const result = await handler({
+                check: "subscriber_field_equals",
+                field: "plan",
+                value: "pro",
+                subscriber: { email: "user@example.com", firstName: "Jane" },
+            });
+            expect(result).toEqual({ result: false });
+        });
+    });
+    describe("has_been_sent", () => {
+        it("returns true when template has been sent", async () => {
+            mockHasBeenSent.mockResolvedValueOnce(true);
+            const result = await handler({
+                check: "has_been_sent",
+                templateKey: "onboarding/welcome",
+                subscriber: { email: "user@example.com", firstName: "Jane" },
+            });
+            expect(result).toEqual({ result: true });
+        });
+        it("returns false when template has not been sent", async () => {
+            mockHasBeenSent.mockResolvedValueOnce(false);
+            const result = await handler({
+                check: "has_been_sent",
+                templateKey: "onboarding/welcome",
+                subscriber: { email: "user@example.com", firstName: "Jane" },
+            });
+            expect(result).toEqual({ result: false });
+        });
+        it("returns false when templateKey is missing", async () => {
+            const result = await handler({
+                check: "has_been_sent",
+                subscriber: { email: "user@example.com", firstName: "Jane" },
+            });
+            expect(result).toEqual({ result: false });
+            expect(mockHasBeenSent).not.toHaveBeenCalled();
+        });
+    });
+    describe("unknown check", () => {
+        it("returns false for unknown check type", async () => {
+            const result = await handler({
+                check: "unknown_check",
+                subscriber: { email: "user@example.com", firstName: "Jane" },
+            });
+            expect(result).toEqual({ result: false });
+        });
+    });
+});
+//# sourceMappingURL=check-condition.test.js.map

package/dist/handlers/__tests__/check-condition.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-condition.test.js","sourceRoot":"","sources":["../../../src/handlers/__tests__/check-condition.test.ts"],"names":[],"mappings":"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"}

package/dist/handlers/__tests__/engagement-handler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=engagement-handler.test.d.ts.map

package/dist/handlers/__tests__/engagement-handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement-handler.test.d.ts","sourceRoot":"","sources":["../../../src/handlers/__tests__/engagement-handler.test.ts"],"names":[],"mappings":""}

package/dist/handlers/__tests__/engagement-handler.test.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const mockResolveConfig = vitest_1.vi.fn();
+const mockSend = vitest_1.vi.fn();
+vitest_1.vi.mock("../../lib/ssm-config.js", () => ({
+    resolveConfig: () => mockResolveConfig(),
+}));
+vitest_1.vi.mock("@aws-sdk/client-dynamodb", () => ({
+    DynamoDBClient: class {
+        send = mockSend;
+    },
+    PutItemCommand: class {
+        input;
+        constructor(input) { this.input = input; }
+    },
+}));
+// Re-export real marshall/unmarshall
+vitest_1.vi.mock("@aws-sdk/util-dynamodb", async () => {
+    const actual = await vitest_1.vi.importActual("@aws-sdk/util-dynamodb");
+    return actual;
+});
+const { handler } = await import("../engagement-handler.js");
+const CONFIG = {
+    tableName: "TestTable",
+    eventsTableName: "EventsTable",
+};
+function snsEvent(message) {
+    return {
+        Records: [
+            { Sns: { Message: JSON.stringify(message) } },
+        ],
+    };
+}
+const baseHeaders = [
+    { name: "Subject", value: "Welcome!" },
+    { name: "X-Template-Key", value: "onboarding/welcome" },
+    { name: "X-Sequence-Id", value: "onboarding" },
+];
+beforeEach(() => {
+    mockResolveConfig.mockReset().mockResolvedValue(CONFIG);
+    mockSend.mockReset().mockResolvedValue({});
+});
+describe("engagement-handler", () => {
+    it("writes delivery event to events table", async () => {
+        const event = snsEvent({
+            eventType: "Delivery",
+            mail: {
+                messageId: "msg-1",
+                destination: ["user@example.com"],
+                headers: baseHeaders,
+            },
+            delivery: { timestamp: "2026-01-15T10:00:00.000Z" },
+        });
+        await handler(event);
+        expect(mockSend).toHaveBeenCalledOnce();
+        const cmd = mockSend.mock.calls[0][0];
+        expect(cmd.input.TableName).toBe("EventsTable");
+    });
+    it("writes click event with link URL", async () => {
+        const event = snsEvent({
+            eventType: "Click",
+            mail: {
+                messageId: "msg-2",
+                destination: ["user@example.com"],
+                headers: baseHeaders,
+            },
+            click: {
+                timestamp: "2026-01-15T10:00:00.000Z",
+                link: "https://example.com/promo",
+                userAgent: "Mozilla/5.0",
+            },
+        });
+        await handler(event);
+        expect(mockSend).toHaveBeenCalledOnce();
+    });
+    it("writes open event with user agent", async () => {
+        const event = snsEvent({
+            eventType: "Open",
+            mail: {
+                messageId: "msg-3",
+                destination: ["user@example.com"],
+                headers: baseHeaders,
+            },
+            open: {
+                timestamp: "2026-01-15T10:00:00.000Z",
+                userAgent: "Apple Mail",
+            },
+        });
+        await handler(event);
+        expect(mockSend).toHaveBeenCalledOnce();
+    });
+    it("handles bounce event with multiple recipients", async () => {
+        const event = snsEvent({
+            eventType: "Bounce",
+            mail: {
+                messageId: "msg-4",
+                destination: ["a@example.com"],
+                headers: baseHeaders,
+            },
+            bounce: {
+                bounceType: "Permanent",
+                bouncedRecipients: [
+                    { emailAddress: "a@example.com" },
+                    { emailAddress: "b@example.com" },
+                ],
+                timestamp: "2026-01-15T10:00:00.000Z",
+            },
+        });
+        await handler(event);
+        expect(mockSend).toHaveBeenCalledTimes(2);
+    });
+    it("defaults sequenceId to fire_and_forget when header missing", async () => {
+        const event = snsEvent({
+            eventType: "Delivery",
+            mail: {
+                messageId: "msg-5",
+                destination: ["user@example.com"],
+                headers: [{ name: "Subject", value: "Hello" }],
+            },
+            delivery: { timestamp: "2026-01-15T10:00:00.000Z" },
+        });
+        await handler(event);
+        expect(mockSend).toHaveBeenCalledOnce();
+    });
+    it("skips unknown event types", async () => {
+        const event = snsEvent({
+            eventType: "UnknownType",
+            mail: {
+                messageId: "msg-6",
+                destination: ["user@example.com"],
+                headers: baseHeaders,
+            },
+        });
+        await handler(event);
+        expect(mockSend).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=engagement-handler.test.js.map

package/dist/handlers/__tests__/engagement-handler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement-handler.test.js","sourceRoot":"","sources":["../../../src/handlers/__tests__/engagement-handler.test.ts"],"names":[],"mappings":"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"}

package/dist/handlers/__tests__/send-email.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=send-email.test.d.ts.map

package/dist/handlers/__tests__/send-email.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-email.test.d.ts","sourceRoot":"","sources":["../../../src/handlers/__tests__/send-email.test.ts"],"names":[],"mappings":""}