@squiz/dx-common-lib 1.72.1 → 1.72.3

package/lib/stream/EventStreamHandler.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEventStreamHandler = createEventStreamHandler;
+/**
+ * DynamoDB stream Lambda handler factory for mapping stream records to domain events and publishing via the event bus.
+ *
+ * Handles:
+ * - Record batching by configurable size
+ * - Tenant extraction from stream ARN and/or stream record (via `extractTenantId`)
+ * - Entity type detection via prefix matching
+ * - Mapper invocation for known entity types
+ * - Event grouping by tenant
+ * - Batch event publishing with retry tracking
+ * - Failure reporting for Lambda retry mechanism
+ */
+function createEventStreamHandler(config) {
+    const { logger, eventBusService, tableServiceIdentifier, entityTypePrefixMap, mappers, extractTenantId, batchSize = 10, } = config;
+    function extractEntityType(record) {
+        var _a, _b, _c;
+        const pk = (_c = (_b = (_a = record.dynamodb) === null || _a === void 0 ? void 0 : _a.Keys) === null || _b === void 0 ? void 0 : _b.pk) === null || _c === void 0 ? void 0 : _c.S;
+        if (!pk) {
+            return undefined;
+        }
+        for (const [prefix, entityType] of Object.entries(entityTypePrefixMap)) {
+            if (pk.startsWith(prefix)) {
+                return entityType;
+            }
+        }
+        return undefined;
+    }
+    return async function handler(event, context) {
+        logger.info('Processing DynamoDB stream batch', {
+            recordCount: event.Records.length,
+            requestId: context.awsRequestId,
+            service: tableServiceIdentifier,
+        });
+        const mappedRecords = [];
+        // Process records in batches
+        for (let i = 0; i < event.Records.length; i += batchSize) {
+            const batch = event.Records.slice(i, i + batchSize);
+            const batchResults = await Promise.all(batch.map(async (record, batchIndex) => {
+                var _a, _b, _c, _d, _e, _f;
+                try {
+                    if (!record.eventSourceARN) {
+                        throw new Error('Missing eventSourceARN on stream record');
+                    }
+                    const tenantId = extractTenantId(record.eventSourceARN, tableServiceIdentifier, record);
+                    const tableName = record.eventSourceARN.split('/')[1];
+                    const entityType = extractEntityType(record);
+                    logger.info('Processed stream record', {
+                        eventName: record.eventName,
+                        tenantId,
+                        tableName,
+                        entityType,
+                        pk: (_c = (_b = (_a = record.dynamodb) === null || _a === void 0 ? void 0 : _a.Keys) === null || _b === void 0 ? void 0 : _b.pk) === null || _c === void 0 ? void 0 : _c.S,
+                        sk: (_f = (_e = (_d = record.dynamodb) === null || _d === void 0 ? void 0 : _d.Keys) === null || _e === void 0 ? void 0 : _e.sk) === null || _f === void 0 ? void 0 : _f.S,
+                    });
+                    if (entityType !== undefined) {
+                        const mapper = mappers[entityType];
+                        if (mapper) {
+                            // Note: For CMP, mappers return 0 or 1 event per record
+                            const events = await mapper(record);
+                            return { recordIndex: i + batchIndex, record, tenantId, events };
+                        }
+                        else {
+                            logger.debug(`No event mapper registered for entity type: ${entityType}`);
+                            return { recordIndex: i + batchIndex, record, tenantId, events: [] };
+                        }
+                    }
+                    return { recordIndex: i + batchIndex, record, tenantId, events: [] };
+                }
+                catch (error) {
+                    logger.error('Failed to process record', {
+                        error: error instanceof Error ? error.message : String(error),
+                        eventSourceARN: record.eventSourceARN,
+                    });
+                    return { recordIndex: i + batchIndex, record, tenantId: 'unknown', events: [] };
+                }
+            }));
+            mappedRecords.push(...batchResults);
+        }
+        // Group events by tenant and publish separately for each tenant
+        const eventsByTenant = new Map();
+        for (const { recordIndex, record, tenantId, events } of mappedRecords) {
+            if (events.length > 0) {
+                const existing = eventsByTenant.get(tenantId) || [];
+                existing.push({ recordIndex, record, events });
+                eventsByTenant.set(tenantId, existing);
+            }
+        }
+        // Track failed records for retry
+        const failedRecordIndices = new Set();
+        // Publish batches for each tenant with their own context in parallel
+        await Promise.all(Array.from(eventsByTenant.entries()).map(async ([tenantId, recordsWithEvents]) => {
+            var _a;
+            const events = recordsWithEvents.flatMap((r) => r.events);
+            logger.info('Publishing batch of events for tenant', { tenantId, eventCount: events.length });
+            try {
+                eventBusService.setTenantId(tenantId);
+                await eventBusService.publishEvents(events);
+                logger.info('Successfully published all events for tenant', { tenantId });
+            }
+            catch (error) {
+                logger.error('Failed to publish events for tenant', {
+                    tenantId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                // Mark all records for this tenant as failed
+                for (const { record } of recordsWithEvents) {
+                    const sequenceNumber = (_a = record.dynamodb) === null || _a === void 0 ? void 0 : _a.SequenceNumber;
+                    if (sequenceNumber) {
+                        failedRecordIndices.add(sequenceNumber);
+                    }
+                }
+            }
+        }));
+        const batchItemFailures = Array.from(failedRecordIndices).map((sequenceNumber) => ({
+            itemIdentifier: sequenceNumber,
+        }));
+        logger.info('Batch processing complete', {
+            totalRecords: event.Records.length,
+            failedRecords: batchItemFailures.length,
+            service: tableServiceIdentifier,
+        });
+        return { batchItemFailures };
+    };
+}
+//# sourceMappingURL=EventStreamHandler.js.map

package/lib/stream/EventStreamHandler.js.map

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

package/lib/stream/EventStreamHandler.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/stream/EventStreamHandler.spec.js

@@ -0,0 +1,364 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/*!
+ * @license
+ * Copyright Squiz Australia Pty Ltd. All Rights Reserved.
+ */
+const EventStreamHandler_1 = require("./EventStreamHandler");
+describe('EventStreamHandler', () => {
+    let mockLogger;
+    let mockEventBusService;
+    beforeEach(() => {
+        mockLogger = {
+            info: jest.fn(),
+            debug: jest.fn(),
+            error: jest.fn(),
+        };
+        mockEventBusService = {
+            setTenantId: jest.fn(),
+            publishEvents: jest.fn().mockResolvedValue(undefined),
+        };
+    });
+    const createMockRecord = (overrides = {}) => {
+        return {
+            eventID: '1',
+            eventVersion: '1.0',
+            dynamodb: {
+                Keys: {
+                    pk: { S: 'cv#component-123' },
+                    sk: { S: 'v#1.0.0' },
+                },
+                SequenceNumber: '111',
+                SizeBytes: 26,
+                StreamViewType: 'NEW_AND_OLD_IMAGES',
+            },
+            awsRegion: 'us-east-1',
+            eventName: 'INSERT',
+            eventSource: 'aws:dynamodb',
+            eventSourceARN: 'arn:aws:dynamodb:us-east-1:123456789012:table/dev.cmp-service.tenant123/stream/2024-01-01T00:00:00.000',
+            ...overrides,
+        };
+    };
+    const createMockContext = () => ({
+        awsRequestId: 'test-request-id',
+        invokeid: 'test-invoke-id',
+        logGroupName: 'test-log-group',
+        logStreamName: 'test-log-stream',
+        functionName: 'test-function',
+        memoryLimitInMB: '128',
+        functionVersion: '1',
+        getRemainingTimeInMillis: jest.fn(() => 30000),
+        done: jest.fn(),
+        fail: jest.fn(),
+        succeed: jest.fn(),
+    });
+    describe('createEventStreamHandler', () => {
+        it('should successfully process records with mapped events', async () => {
+            const mockMapper = jest.fn(async () => [
+                { detailType: 'component.change.create', detail: { name: 'test' } },
+            ]);
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cv#': 'componentVersion' },
+                mappers: { componentVersion: mockMapper },
+                extractTenantId: (arn, _identifier) => {
+                    const tableName = arn.split('/')[1];
+                    const parts = tableName.split('.');
+                    return parts[parts.length - 1];
+                },
+                batchSize: 10,
+            });
+            const event = {
+                Records: [createMockRecord()],
+            };
+            const response = await handle(event, createMockContext());
+            expect(mockLogger.info).toHaveBeenCalledWith('Processing DynamoDB stream batch', expect.any(Object));
+            expect(mockEventBusService.setTenantId).toHaveBeenCalledWith('tenant123');
+            expect(mockEventBusService.publishEvents).toHaveBeenCalledWith([
+                { detailType: 'component.change.create', detail: { name: 'test' } },
+            ]);
+            expect(response.batchItemFailures).toHaveLength(0);
+        });
+        it('should pass the stream record as the third argument to extractTenantId', async () => {
+            const extractTenantId = jest.fn((arn, _identifier, _record) => {
+                const tableName = arn.split('/')[1];
+                const parts = tableName.split('.');
+                return parts[parts.length - 1];
+            });
+            const mockMapper = jest.fn(async () => [{ detailType: 'component.change.create', detail: {} }]);
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cv#': 'componentVersion' },
+                mappers: { componentVersion: mockMapper },
+                extractTenantId,
+            });
+            const streamRecord = createMockRecord();
+            await handle({ Records: [streamRecord] }, createMockContext());
+            expect(extractTenantId).toHaveBeenCalledWith(streamRecord.eventSourceARN, 'cmp', streamRecord);
+        });
+        it('should handle records with no mapper registered', async () => {
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cv#': 'componentVersion' },
+                mappers: {},
+                extractTenantId: (arn, _identifier) => {
+                    const tableName = arn.split('/')[1];
+                    const parts = tableName.split('.');
+                    return parts[parts.length - 1];
+                },
+            });
+            const event = {
+                Records: [createMockRecord()],
+            };
+            const response = await handle(event, createMockContext());
+            expect(mockLogger.debug).toHaveBeenCalledWith('No event mapper registered for entity type: componentVersion');
+            expect(mockEventBusService.publishEvents).not.toHaveBeenCalled();
+            expect(response.batchItemFailures).toHaveLength(0);
+        });
+        it('should handle records with unknown entity types', async () => {
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cs#': 'componentSet' },
+                mappers: {},
+                extractTenantId: (arn, _identifier) => {
+                    const tableName = arn.split('/')[1];
+                    const parts = tableName.split('.');
+                    return parts[parts.length - 1];
+                },
+            });
+            const event = {
+                Records: [createMockRecord()],
+            };
+            const response = await handle(event, createMockContext());
+            expect(mockEventBusService.publishEvents).not.toHaveBeenCalled();
+            expect(response.batchItemFailures).toHaveLength(0);
+        });
+        it('should handle records without eventSourceARN', async () => {
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cv#': 'componentVersion' },
+                mappers: {},
+                extractTenantId: (arn, _identifier) => {
+                    const tableName = arn.split('/')[1];
+                    const parts = tableName.split('.');
+                    return parts[parts.length - 1];
+                },
+            });
+            const event = {
+                Records: [createMockRecord({ eventSourceARN: undefined })],
+            };
+            const response = await handle(event, createMockContext());
+            expect(mockLogger.error).toHaveBeenCalledWith('Failed to process record', expect.any(Object));
+            expect(response.batchItemFailures).toHaveLength(0);
+        });
+        it('should batch records according to batchSize', async () => {
+            const mockMapper = jest.fn(async () => [{ detailType: 'component.change.create', detail: {} }]);
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cv#': 'componentVersion' },
+                mappers: { componentVersion: mockMapper },
+                extractTenantId: (arn, _identifier) => {
+                    const tableName = arn.split('/')[1];
+                    const parts = tableName.split('.');
+                    return parts[parts.length - 1];
+                },
+                batchSize: 2,
+            });
+            const records = [
+                createMockRecord({ eventID: '1' }),
+                createMockRecord({ eventID: '2' }),
+                createMockRecord({ eventID: '3' }),
+            ];
+            const event = { Records: records };
+            await handle(event, createMockContext());
+            expect(mockMapper).toHaveBeenCalledTimes(3);
+        });
+        it('should mark records as failed when event publishing fails', async () => {
+            const mockMapper = jest.fn(async () => [
+                { detailType: 'component.change.create', detail: { name: 'test' } },
+            ]);
+            mockEventBusService.publishEvents.mockRejectedValue(new Error('Publishing failed'));
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cv#': 'componentVersion' },
+                mappers: { componentVersion: mockMapper },
+                extractTenantId: (arn, _identifier) => {
+                    const tableName = arn.split('/')[1];
+                    const parts = tableName.split('.');
+                    return parts[parts.length - 1];
+                },
+            });
+            const event = {
+                Records: [createMockRecord()],
+            };
+            const response = await handle(event, createMockContext());
+            expect(mockLogger.error).toHaveBeenCalledWith('Failed to publish events for tenant', expect.any(Object));
+            expect(response.batchItemFailures).toHaveLength(1);
+            expect(response.batchItemFailures[0].itemIdentifier).toBe('111');
+        });
+        it('should handle mapper returning empty events', async () => {
+            const mockMapper = jest.fn(async () => []);
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cv#': 'componentVersion' },
+                mappers: { componentVersion: mockMapper },
+                extractTenantId: (arn, _identifier) => {
+                    const tableName = arn.split('/')[1];
+                    const parts = tableName.split('.');
+                    return parts[parts.length - 1];
+                },
+            });
+            const event = {
+                Records: [createMockRecord()],
+            };
+            const response = await handle(event, createMockContext());
+            expect(mockEventBusService.publishEvents).not.toHaveBeenCalled();
+            expect(response.batchItemFailures).toHaveLength(0);
+        });
+        it('should handle multiple mappers for different entity types', async () => {
+            const cvMapper = jest.fn(async () => [
+                { detailType: 'component.change.create', detail: { type: 'cv' } },
+            ]);
+            const csMapper = jest.fn(async () => [{ detailType: 'set.change.create', detail: { type: 'cs' } }]);
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cv#': 'componentVersion', 'cs#': 'componentSet' },
+                mappers: { componentVersion: cvMapper, componentSet: csMapper },
+                extractTenantId: (arn, _identifier) => {
+                    const tableName = arn.split('/')[1];
+                    const parts = tableName.split('.');
+                    return parts[parts.length - 1];
+                },
+            });
+            const event = {
+                Records: [
+                    createMockRecord({ eventID: '1' }),
+                    createMockRecord({ eventID: '2', dynamodb: { Keys: { pk: { S: 'cs#set-123' } } } }),
+                ],
+            };
+            await handle(event, createMockContext());
+            expect(cvMapper).toHaveBeenCalledTimes(1);
+            expect(csMapper).toHaveBeenCalledTimes(1);
+        });
+        it('should handle mapper errors gracefully', async () => {
+            const mockMapper = jest.fn(async () => {
+                throw new Error('Mapper failed');
+            });
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cv#': 'componentVersion' },
+                mappers: { componentVersion: mockMapper },
+                extractTenantId: (arn, _identifier) => {
+                    const tableName = arn.split('/')[1];
+                    const parts = tableName.split('.');
+                    return parts[parts.length - 1];
+                },
+            });
+            const event = {
+                Records: [createMockRecord()],
+            };
+            const response = await handle(event, createMockContext());
+            expect(mockLogger.error).toHaveBeenCalledWith('Failed to process record', expect.any(Object));
+            expect(response.batchItemFailures).toHaveLength(0);
+        });
+        it('should group events by tenant and publish separately', async () => {
+            const mockMapper = jest.fn(async () => [{ detailType: 'component.change.create', detail: {} }]);
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cv#': 'componentVersion' },
+                mappers: { componentVersion: mockMapper },
+                extractTenantId: (arn) => {
+                    if (arn.includes('tenant1'))
+                        return 'tenant1';
+                    if (arn.includes('tenant2'))
+                        return 'tenant2';
+                    return 'unknown';
+                },
+            });
+            const event = {
+                Records: [
+                    createMockRecord({
+                        eventID: '1',
+                        eventSourceARN: 'arn:aws:dynamodb:us-east-1:123456789012:table/dev.cmp-service.tenant1/stream/ts',
+                    }),
+                    createMockRecord({
+                        eventID: '2',
+                        eventSourceARN: 'arn:aws:dynamodb:us-east-1:123456789012:table/dev.cmp-service.tenant2/stream/ts',
+                    }),
+                ],
+            };
+            await handle(event, createMockContext());
+            expect(mockEventBusService.setTenantId).toHaveBeenCalledWith('tenant1');
+            expect(mockEventBusService.setTenantId).toHaveBeenCalledWith('tenant2');
+            expect(mockEventBusService.publishEvents).toHaveBeenCalledTimes(2);
+        });
+        it('should handle records without primary key', async () => {
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cv#': 'componentVersion' },
+                mappers: {},
+                extractTenantId: (arn, _identifier) => {
+                    const tableName = arn.split('/')[1];
+                    const parts = tableName.split('.');
+                    return parts[parts.length - 1];
+                },
+            });
+            const event = {
+                Records: [createMockRecord({ dynamodb: { SequenceNumber: '111', SizeBytes: 0 } })],
+            };
+            const response = await handle(event, createMockContext());
+            expect(response.batchItemFailures).toHaveLength(0);
+        });
+        it('should log batch processing summary', async () => {
+            const mockMapper = jest.fn(async () => [{ detailType: 'component.change.create', detail: {} }]);
+            const handle = (0, EventStreamHandler_1.createEventStreamHandler)({
+                logger: mockLogger,
+                eventBusService: mockEventBusService,
+                tableServiceIdentifier: 'cmp',
+                entityTypePrefixMap: { 'cv#': 'componentVersion' },
+                mappers: { componentVersion: mockMapper },
+                extractTenantId: (arn, _identifier) => {
+                    const tableName = arn.split('/')[1];
+                    const parts = tableName.split('.');
+                    return parts[parts.length - 1];
+                },
+            });
+            const event = {
+                Records: [createMockRecord()],
+            };
+            await handle(event, createMockContext());
+            const finalLog = mockLogger.info.mock.calls.find((call) => call[0] === 'Batch processing complete');
+            expect(finalLog).toBeDefined();
+            expect(finalLog[1]).toEqual({
+                totalRecords: 1,
+                failedRecords: 0,
+                service: 'cmp',
+            });
+        });
+    });
+});
+//# sourceMappingURL=EventStreamHandler.spec.js.map

package/lib/stream/EventStreamHandler.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventStreamHandler.spec.js","sourceRoot":"","sources":["../../src/stream/EventStreamHandler.spec.ts"],"names":[],"mappings":"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"}

package/lib/stream/StreamUtils.d.ts

@@ -0,0 +1,38 @@
+/*!
+ * @license
+ * Copyright Squiz Australia Pty Ltd. All Rights Reserved.
+ */
+/**
+ * Extracts tenant ID from a DynamoDB stream ARN
+ *
+ * ARN format: arn:aws:dynamodb:region:account:table/tableName/stream/timestamp
+ * Table name format: {stackPrefix}.{tableServiceName}-service.{tenantId}
+ *
+ * @param arn - The event source ARN from the DynamoDB stream record
+ * @param tableServiceIdentifier - The service identifier (e.g., 'cmp', 'content') to validate in table name
+ * @returns The tenant ID extracted from the table name
+ * @throws Error if ARN or table name format is invalid
+ */
+export declare function extractTenantIdFromArn(arn: string, tableServiceIdentifier: string): string;
+/**
+ * Extracts string or number value from DynamoDB attribute format
+ *
+ * DynamoDB represents attributes as objects with type keys (e.g., { S: "value" }, { N: "123" })
+ * This helper extracts the actual value.
+ *
+ * @param value - The DynamoDB attribute value object
+ * @returns The extracted string value, or undefined if the attribute is empty
+ */
+export declare function getDynamoValue(value?: {
+    S?: string;
+    N?: string;
+}): string | undefined;
+/**
+ * Determines the action type based on DynamoDB event name
+ *
+ * Maps DynamoDB stream event types to semantic action types suitable for event publishing.
+ *
+ * @param eventName - The DynamoDB stream event name (INSERT, MODIFY, REMOVE)
+ * @returns The corresponding action: 'create', 'update', or 'delete'
+ */
+export declare function getActionType(eventName?: string): 'create' | 'update' | 'delete';

package/lib/stream/StreamUtils.js

@@ -0,0 +1,59 @@
+"use strict";
+/*!
+ * @license
+ * Copyright Squiz Australia Pty Ltd. All Rights Reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTenantIdFromArn = extractTenantIdFromArn;
+exports.getDynamoValue = getDynamoValue;
+exports.getActionType = getActionType;
+/**
+ * Extracts tenant ID from a DynamoDB stream ARN
+ *
+ * ARN format: arn:aws:dynamodb:region:account:table/tableName/stream/timestamp
+ * Table name format: {stackPrefix}.{tableServiceName}-service.{tenantId}
+ *
+ * @param arn - The event source ARN from the DynamoDB stream record
+ * @param tableServiceIdentifier - The service identifier (e.g., 'cmp', 'content') to validate in table name
+ * @returns The tenant ID extracted from the table name
+ * @throws Error if ARN or table name format is invalid
+ */
+function extractTenantIdFromArn(arn, tableServiceIdentifier) {
+    const tableName = arn.split('/')[1];
+    if (!tableName) {
+        throw new Error(`Invalid ARN format: ${arn}`);
+    }
+    const parts = tableName.split('.');
+    if (parts.length < 3 || parts[1] !== `${tableServiceIdentifier}-service`) {
+        throw new Error(`Invalid ${tableServiceIdentifier} table name format: ${tableName}. Expected format: {prefix}.${tableServiceIdentifier}-service.{tenantId}`);
+    }
+    return parts[parts.length - 1];
+}
+/**
+ * Extracts string or number value from DynamoDB attribute format
+ *
+ * DynamoDB represents attributes as objects with type keys (e.g., { S: "value" }, { N: "123" })
+ * This helper extracts the actual value.
+ *
+ * @param value - The DynamoDB attribute value object
+ * @returns The extracted string value, or undefined if the attribute is empty
+ */
+function getDynamoValue(value) {
+    return (value === null || value === void 0 ? void 0 : value.S) || (value === null || value === void 0 ? void 0 : value.N);
+}
+/**
+ * Determines the action type based on DynamoDB event name
+ *
+ * Maps DynamoDB stream event types to semantic action types suitable for event publishing.
+ *
+ * @param eventName - The DynamoDB stream event name (INSERT, MODIFY, REMOVE)
+ * @returns The corresponding action: 'create', 'update', or 'delete'
+ */
+function getActionType(eventName) {
+    if (eventName === 'INSERT')
+        return 'create';
+    if (eventName === 'REMOVE')
+        return 'delete';
+    return 'update';
+}
+//# sourceMappingURL=StreamUtils.js.map

package/lib/stream/StreamUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamUtils.js","sourceRoot":"","sources":["../../src/stream/StreamUtils.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAaH,wDAcC;AAWD,wCAEC;AAUD,sCAIC;AApDD;;;;;;;;;;GAUG;AACH,SAAgB,sBAAsB,CAAC,GAAW,EAAE,sBAA8B;IAChF,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,sBAAsB,UAAU,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CACb,WAAW,sBAAsB,uBAAuB,SAAS,+BAA+B,sBAAsB,qBAAqB,CAC5I,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,cAAc,CAAC,KAAkC;IAC/D,OAAO,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,CAAC,MAAI,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,CAAC,CAAA,CAAC;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,SAAkB;IAC9C,IAAI,SAAS,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,SAAS,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC5C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/lib/stream/StreamUtils.spec.d.ts

@@ -0,0 +1 @@
+export {};