@farukada/aws-langgraph-dynamodb-ts 0.0.10 → 0.1.0

package/dist/history/utils/update-expression-builder.js

@@ -1,59 +1,126 @@
 "use strict";
 /**
- * Update expression builder for chat message history
- * Provides centralized logic for building DynamoDB update expressions
+ * Item builder utilities for per-message chat history storage
+ * Builds DynamoDB items for metadata and individual messages
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildMessageUpdateExpression = buildMessageUpdateExpression;
+exports.formatMessageIndex = formatMessageIndex;
+exports.buildMessageSK = buildMessageSK;
+exports.buildMessageItems = buildMessageItems;
+exports.buildMetadataUpdateExpression = buildMetadataUpdateExpression;
+exports.buildAtomicMetadataUpdate = buildAtomicMetadataUpdate;
+const messages_1 = require("@langchain/core/messages");
 const shared_1 = require("../../shared");
 /**
- * Build DynamoDB update expression for adding messages to a session
- * Handles both single messages and message arrays
+ * Format a message index as a zero-padded 6-digit string
+ * Supports up to 999,999 messages per session while maintaining sort order
+ */
+function formatMessageIndex(index) {
+    return String(index).padStart(6, '0');
+}
+/**
+ * Build the sort key for a message item
+ *
+ * @param sessionId - Session identifier
+ * @param messageIndex - Zero-based message index
+ * @returns Composite SK like "sessionId#msg#000001"
+ */
+function buildMessageSK(sessionId, messageIndex) {
+    return `${sessionId}#msg#${formatMessageIndex(messageIndex)}`;
+}
+/**
+ * Build DynamoDB message items from BaseMessage array
  *
- * @param params - Parameters for building the expression
- * @returns Update expression and attribute values
+ * @param userId - User identifier
+ * @param sessionId - Session identifier
+ * @param messages - Messages to serialize
+ * @param startIndex - Starting message index (for appending to existing session)
+ * @param ttlDays - Optional TTL in days
+ * @returns Array of DynamoDB message items
  */
-function buildMessageUpdateExpression(params) {
-    const { messages, title, ttlDays } = params;
+function buildMessageItems(userId, sessionId, messages, startIndex, ttlDays) {
+    const storedMessages = (0, messages_1.mapChatMessagesToStoredMessages)(messages);
+    const ttl = ttlDays !== undefined ? (0, shared_1.calculateTTLTimestamp)(ttlDays) : undefined;
+    return storedMessages.map((storedMessage, i) => {
+        const messageIndex = startIndex + i;
+        const item = {
+            userId,
+            sessionId: buildMessageSK(sessionId, messageIndex),
+            itemType: 'message',
+            messageIndex,
+            message: storedMessage,
+        };
+        if (ttl !== undefined) {
+            item.ttl = ttl;
+        }
+        return item;
+    });
+}
+/**
+ * Build or update a session metadata item
+ *
+ * @param userId - User identifier
+ * @param sessionId - Session identifier
+ * @param title - Session title
+ * @param messageCount - New total message count
+ * @param ttlDays - Optional TTL in days
+ * @param isNew - Whether this is a new session (sets createdAt)
+ */
+function buildMetadataUpdateExpression(title, messageCount, ttlDays) {
     const now = Date.now();
-    const isArray = Array.isArray(messages);
-    const messageArray = isArray ? messages : [messages];
-    const messageCount = messageArray.length;
-    // Build update expression parts
-    const updateExpressionParts = ['updatedAt = :updatedAt'];
+    const updateParts = [
+        'updatedAt = :updatedAt',
+        'messageCount = :messageCount',
+        'itemType = :itemType',
+        'title = if_not_exists(title, :title)',
+        'createdAt = if_not_exists(createdAt, :createdAt)',
+    ];
     const expressionAttributeValues = {
         ':updatedAt': now,
         ':createdAt': now,
-        ':emptyList': [],
-        ':zero': 0,
+        ':messageCount': messageCount,
+        ':itemType': 'metadata',
+        ':title': title,
     };
-    // Add title if provided
-    if (title) {
-        updateExpressionParts.push('title = if_not_exists(title, :title)');
-        expressionAttributeValues[':title'] = title;
-    }
-    // Add messages
-    if (isArray) {
-        updateExpressionParts.push('messages = list_append(if_not_exists(messages, :emptyList), :messages)');
-        updateExpressionParts.push('messageCount = if_not_exists(messageCount, :zero) + :messageCount');
-        expressionAttributeValues[':messages'] = messageArray;
-        expressionAttributeValues[':messageCount'] = messageCount;
-    }
-    else {
-        updateExpressionParts.push('messages = list_append(if_not_exists(messages, :emptyList), :message)');
-        updateExpressionParts.push('messageCount = if_not_exists(messageCount, :zero) + :one');
-        expressionAttributeValues[':message'] = messageArray;
-        expressionAttributeValues[':one'] = 1;
+    if (ttlDays !== undefined) {
+        updateParts.push('ttl = :ttl');
+        expressionAttributeValues[':ttl'] = (0, shared_1.calculateTTLTimestamp)(ttlDays);
     }
-    // Add TTL if configured
+    return {
+        updateExpression: `SET ${updateParts.join(', ')}`,
+        expressionAttributeValues,
+    };
+}
+/**
+ * Build an atomic metadata update expression using DynamoDB's ADD operation
+ * Atomically increments messageCount by incrementBy, preventing race conditions
+ *
+ * @param title - Session title (only set if not already present via if_not_exists)
+ * @param incrementBy - Number to add to messageCount
+ * @param ttlDays - Optional TTL in days
+ * @returns UpdateExpression and ExpressionAttributeValues for DynamoDB update
+ */
+function buildAtomicMetadataUpdate(title, incrementBy, ttlDays) {
+    const now = Date.now();
+    const setParts = [
+        'updatedAt = :updatedAt',
+        'itemType = :itemType',
+        'title = if_not_exists(title, :title)',
+        'createdAt = if_not_exists(createdAt, :createdAt)',
+    ];
+    const expressionAttributeValues = {
+        ':updatedAt': now,
+        ':createdAt': now,
+        ':inc': incrementBy,
+        ':itemType': 'metadata',
+        ':title': title,
+    };
     if (ttlDays !== undefined) {
-        updateExpressionParts.push('ttl = :ttl');
+        setParts.push('ttl = :ttl');
         expressionAttributeValues[':ttl'] = (0, shared_1.calculateTTLTimestamp)(ttlDays);
     }
-    // Build final update expression
-    const updateExpression = `SET ${updateExpressionParts.join(', ')}, createdAt = if_not_exists(createdAt, :createdAt)`;
     return {
-        updateExpression,
+        updateExpression: `SET ${setParts.join(', ')} ADD messageCount :inc`,
         expressionAttributeValues,
     };
 }

package/dist/history/utils/update-expression-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-expression-builder.js","sourceRoot":"","sources":["../../../src/history/utils/update-expression-builder.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAmCH,oEAuDC;AAtFD,yCAAqD;AAwBrD;;;;;;GAMG;AACH,SAAgB,4BAA4B,CAC1C,MAA0C;IAE1C,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC;IAEzC,gCAAgC;IAChC,MAAM,qBAAqB,GAAa,CAAC,wBAAwB,CAAC,CAAC;IACnE,MAAM,yBAAyB,GAAwB;QACrD,YAAY,EAAE,GAAG;QACjB,YAAY,EAAE,GAAG;QACjB,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,CAAC;KACX,CAAC;IAEF,wBAAwB;IACxB,IAAI,KAAK,EAAE,CAAC;QACV,qBAAqB,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACnE,yBAAyB,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IAC9C,CAAC;IAED,eAAe;IACf,IAAI,OAAO,EAAE,CAAC;QACZ,qBAAqB,CAAC,IAAI,CACxB,wEAAwE,CACzE,CAAC;QACF,qBAAqB,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;QAChG,yBAAyB,CAAC,WAAW,CAAC,GAAG,YAAY,CAAC;QACtD,yBAAyB,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,qBAAqB,CAAC,IAAI,CACxB,uEAAuE,CACxE,CAAC;QACF,qBAAqB,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QACvF,yBAAyB,CAAC,UAAU,CAAC,GAAG,YAAY,CAAC;QACrD,yBAAyB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,yBAAyB,CAAC,MAAM,CAAC,GAAG,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,gCAAgC;IAChC,MAAM,gBAAgB,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,oDAAoD,CAAC;IAErH,OAAO;QACL,gBAAgB;QAChB,yBAAyB;KAC1B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"update-expression-builder.js","sourceRoot":"","sources":["../../../src/history/utils/update-expression-builder.ts"],"names":[],"mappings":"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"}

package/dist/history/utils/validation.d.ts

@@ -57,4 +57,12 @@ export declare function validateLimit(limit: any): void;
  * @throws HistoryValidationError if validation fails
  */
 export declare function validateTTLDays(ttlDays: number | undefined): void;
+/**
+ * Validate total estimated size of messages for DynamoDB transaction limits.
+ * Prevents runtime `TransactionCanceledException` due to 4MB size exceeded.
+ *
+ * @param messages - Array of BaseMessage objects to validate
+ * @throws HistoryValidationError if estimated size exceeds 4MB
+ */
+export declare function validateMessagesSize(messages: BaseMessage[]): void;
 //# sourceMappingURL=validation.d.ts.map

package/dist/history/utils/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/history/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAUvD;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAoBhD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,CAoBtD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAa1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAyB9D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAc9C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAgB9C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOjE"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/history/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAUvD;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAoBhD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,CAoBtD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAa1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAyB9D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAc9C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAgB9C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOjE;AAOD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAYlE"}

package/dist/history/utils/validation.js

@@ -11,6 +11,7 @@ exports.validateMessages = validateMessages;
 exports.validateTitle = validateTitle;
 exports.validateLimit = validateLimit;
 exports.validateTTLDays = validateTTLDays;
+exports.validateMessagesSize = validateMessagesSize;
 const utils_1 = require("../../shared/utils");
 const MAX_USER_ID_LENGTH = 256;
 const MAX_SESSION_ID_LENGTH = 256;
@@ -168,4 +169,25 @@ function validateTTLDays(ttlDays) {
         throw new HistoryValidationError(error instanceof Error ? error.message : String(error));
     }
 }
+/** DynamoDB transactWrite limit: 4MB total across all items */
+const MAX_TRANSACTION_SIZE_BYTES = 4 * 1024 * 1024;
+/** Estimated per-item overhead: PK, SK, itemType, messageIndex, ttl, DynamoDB encoding */
+const PER_ITEM_OVERHEAD_BYTES = 500;
+/**
+ * Validate total estimated size of messages for DynamoDB transaction limits.
+ * Prevents runtime `TransactionCanceledException` due to 4MB size exceeded.
+ *
+ * @param messages - Array of BaseMessage objects to validate
+ * @throws HistoryValidationError if estimated size exceeds 4MB
+ */
+function validateMessagesSize(messages) {
+    let totalSize = 0;
+    for (const message of messages) {
+        const content = typeof message.content === 'string' ? message.content : JSON.stringify(message.content);
+        totalSize += new TextEncoder().encode(content).byteLength + PER_ITEM_OVERHEAD_BYTES;
+    }
+    if (totalSize > MAX_TRANSACTION_SIZE_BYTES) {
+        throw new HistoryValidationError(`Estimated batch size (~${Math.round(totalSize / 1024)}KB) exceeds DynamoDB transaction limit of 4MB`);
+    }
+}
 //# sourceMappingURL=validation.js.map

package/dist/history/utils/validation.js.map

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

package/dist/index.d.ts

@@ -5,4 +5,6 @@ export type { DynamoDBStoreOptions } from './store/types';
 export { DynamoDBChatMessageHistory } from './history';
 export type { DynamoDBChatMessageHistoryOptions, SessionMetadata } from './history/types';
 export { DynamoDBFactory } from './factory';
+export { setGlobalLogger, getLogger, resetLogger } from './shared/utils/logger';
+export type { Logger } from './shared/utils/logger';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AACvD,YAAY,EAAE,iCAAiC,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AACvD,YAAY,EAAE,iCAAiC,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAChF,YAAY,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DynamoDBFactory = exports.DynamoDBChatMessageHistory = exports.DynamoDBStore = exports.DynamoDBSaver = void 0;
+exports.resetLogger = exports.getLogger = exports.setGlobalLogger = exports.DynamoDBFactory = exports.DynamoDBChatMessageHistory = exports.DynamoDBStore = exports.DynamoDBSaver = void 0;
 var checkpointer_1 = require("./checkpointer");
 Object.defineProperty(exports, "DynamoDBSaver", { enumerable: true, get: function () { return checkpointer_1.DynamoDBSaver; } });
 var store_1 = require("./store");
@@ -9,4 +9,8 @@ var history_1 = require("./history");
 Object.defineProperty(exports, "DynamoDBChatMessageHistory", { enumerable: true, get: function () { return history_1.DynamoDBChatMessageHistory; } });
 var factory_1 = require("./factory");
 Object.defineProperty(exports, "DynamoDBFactory", { enumerable: true, get: function () { return factory_1.DynamoDBFactory; } });
+var logger_1 = require("./shared/utils/logger");
+Object.defineProperty(exports, "setGlobalLogger", { enumerable: true, get: function () { return logger_1.setGlobalLogger; } });
+Object.defineProperty(exports, "getLogger", { enumerable: true, get: function () { return logger_1.getLogger; } });
+Object.defineProperty(exports, "resetLogger", { enumerable: true, get: function () { return logger_1.resetLogger; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+CAA+C;AAAtC,6GAAA,aAAa,OAAA;AAEtB,iCAAwC;AAA/B,sGAAA,aAAa,OAAA;AAEtB,qCAAuD;AAA9C,qHAAA,0BAA0B,OAAA;AAEnC,qCAA4C;AAAnC,0GAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+CAA+C;AAAtC,6GAAA,aAAa,OAAA;AAEtB,iCAAwC;AAA/B,sGAAA,aAAa,OAAA;AAEtB,qCAAuD;AAA9C,qHAAA,0BAA0B,OAAA;AAEnC,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AACxB,gDAAgF;AAAvE,yGAAA,eAAe,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,qGAAA,WAAW,OAAA"}

package/dist/shared/utils/batch-write.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared batch write utilities with UnprocessedItems retry logic
+ * Eliminates duplication of the retry pattern across checkpointer, store, and history modules
+ */
+import type { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
+interface PutWriteRequest {
+    PutRequest: {
+        Item: object;
+    };
+}
+interface DeleteWriteRequest {
+    DeleteRequest: {
+        Key: object;
+    };
+}
+type WriteRequest = PutWriteRequest | DeleteWriteRequest;
+/**
+ * Execute a single batchWrite call with exponential backoff retry for UnprocessedItems
+ *
+ * @param client - DynamoDB Document client
+ * @param tableName - Target DynamoDB table name
+ * @param requestItems - Array of write requests (PutRequest or DeleteRequest objects)
+ * @throws Error if retries are exhausted with remaining unprocessed items
+ */
+export declare function batchWriteWithRetry(client: DynamoDBDocument, tableName: string, requestItems: WriteRequest[]): Promise<void>;
+/**
+ * Execute batch writes for an arbitrary number of items, chunking into batches of 25
+ *
+ * @param client - DynamoDB Document client
+ * @param tableName - Target DynamoDB table name
+ * @param requestItems - Array of write requests (can exceed 25)
+ * @throws Error if any batch fails after exhausting retries
+ */
+export declare function batchWriteAllWithRetry(client: DynamoDBDocument, tableName: string, requestItems: WriteRequest[]): Promise<void>;
+export {};
+//# sourceMappingURL=batch-write.d.ts.map

package/dist/shared/utils/batch-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-write.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/batch-write.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAK9D,UAAU,eAAe;IACvB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,UAAU,kBAAkB;IAC1B,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,KAAK,YAAY,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,YAAY,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,YAAY,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/shared/utils/batch-write.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Shared batch write utilities with UnprocessedItems retry logic
+ * Eliminates duplication of the retry pattern across checkpointer, store, and history modules
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.batchWriteWithRetry = batchWriteWithRetry;
+exports.batchWriteAllWithRetry = batchWriteAllWithRetry;
+const constants_1 = require("./constants");
+const retry_1 = require("./retry");
+/**
+ * Execute a single batchWrite call with exponential backoff retry for UnprocessedItems
+ *
+ * @param client - DynamoDB Document client
+ * @param tableName - Target DynamoDB table name
+ * @param requestItems - Array of write requests (PutRequest or DeleteRequest objects)
+ * @throws Error if retries are exhausted with remaining unprocessed items
+ */
+async function batchWriteWithRetry(client, tableName, requestItems) {
+    if (requestItems.length === 0)
+        return;
+    await (0, retry_1.withDynamoDBRetry)(async () => {
+        const result = await client.batchWrite({
+            RequestItems: {
+                [tableName]: requestItems,
+            },
+        });
+        let unprocessed = result.UnprocessedItems?.[tableName];
+        let retryDelay = 100;
+        let retryCount = 0;
+        while (unprocessed && unprocessed.length > 0) {
+            retryCount++;
+            if (retryCount > constants_1.MAX_UNPROCESSED_RETRIES) {
+                throw new Error(`Failed to process all items after ${constants_1.MAX_UNPROCESSED_RETRIES} retries. ` +
+                    `${unprocessed.length} items remain unprocessed.`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, retryDelay));
+            retryDelay = Math.min(retryDelay * 2, 5000);
+            const retryResult = await client.batchWrite({
+                RequestItems: { [tableName]: unprocessed },
+            });
+            unprocessed = retryResult.UnprocessedItems?.[tableName];
+        }
+    });
+}
+/**
+ * Execute batch writes for an arbitrary number of items, chunking into batches of 25
+ *
+ * @param client - DynamoDB Document client
+ * @param tableName - Target DynamoDB table name
+ * @param requestItems - Array of write requests (can exceed 25)
+ * @throws Error if any batch fails after exhausting retries
+ */
+async function batchWriteAllWithRetry(client, tableName, requestItems) {
+    if (requestItems.length === 0)
+        return;
+    for (let i = 0; i < requestItems.length; i += constants_1.BATCH_WRITE_MAX) {
+        const batch = requestItems.slice(i, i + constants_1.BATCH_WRITE_MAX);
+        await batchWriteWithRetry(client, tableName, batch);
+    }
+}
+//# sourceMappingURL=batch-write.js.map

package/dist/shared/utils/batch-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-write.js","sourceRoot":"","sources":["../../../src/shared/utils/batch-write.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAyBH,kDAiCC;AAUD,wDAWC;AA3ED,2CAAuE;AACvE,mCAA4C;AAY5C;;;;;;;GAOG;AACI,KAAK,UAAU,mBAAmB,CACvC,MAAwB,EACxB,SAAiB,EACjB,YAA4B;IAE5B,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEtC,MAAM,IAAA,yBAAiB,EAAC,KAAK,IAAI,EAAE;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;YACrC,YAAY,EAAE;gBACZ,CAAC,SAAS,CAAC,EAAE,YAAY;aAC1B;SACF,CAAC,CAAC;QAEH,IAAI,WAAW,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC,SAAS,CAAC,CAAC;QACvD,IAAI,UAAU,GAAG,GAAG,CAAC;QACrB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,OAAO,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,UAAU,EAAE,CAAC;YACb,IAAI,UAAU,GAAG,mCAAuB,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CACb,qCAAqC,mCAAuB,YAAY;oBACtE,GAAG,WAAW,CAAC,MAAM,4BAA4B,CACpD,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;YAChE,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;gBAC1C,YAAY,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE;aAC3C,CAAC,CAAC;YACH,WAAW,GAAG,WAAW,CAAC,gBAAgB,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,sBAAsB,CAC1C,MAAwB,EACxB,SAAiB,EACjB,YAA4B;IAE5B,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,IAAI,2BAAe,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,2BAAe,CAAC,CAAC;QACzD,MAAM,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/shared/utils/compressor.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Checkpoint compression utility using Node.js built-in zlib
+ * Provides transparent gzip compression/decompression with smart thresholds
+ */
+/**
+ * Configuration for checkpoint compression
+ */
+export interface CompressionConfig {
+    /** Whether compression is enabled (default: false) */
+    enabled: boolean;
+    /** Minimum payload size in bytes to trigger compression (default: 1024 = 1KB) */
+    minSizeBytes?: number;
+    /** Gzip compression level 1-9 (default: 6 = balanced speed/ratio) */
+    level?: number;
+}
+/**
+ * Compressor for checkpoint data using gzip
+ *
+ * Features:
+ * - Smart threshold: skips compression for payloads below `minSizeBytes`
+ * - Auto-detection: `decompress()` transparently handles both compressed and uncompressed data
+ * - Zero dependencies: uses Node.js built-in `zlib`
+ */
+export declare class Compressor {
+    private readonly minSizeBytes;
+    private readonly level;
+    constructor(config: CompressionConfig);
+    /**
+     * Compress data if above the minimum size threshold
+     *
+     * @param data - Raw data to compress
+     * @returns Compressed data (gzip) or original data if below threshold
+     */
+    compress(data: Uint8Array): Promise<Uint8Array>;
+    /**
+     * Decompress data if gzip magic header is detected, otherwise passthrough
+     * This provides full backward compatibility with uncompressed data
+     *
+     * @param data - Potentially compressed data
+     * @returns Decompressed data
+     */
+    decompress(data: Uint8Array): Promise<Uint8Array>;
+    /**
+     * Check if data starts with the gzip magic number
+     */
+    static isGzipped(data: Uint8Array): boolean;
+}
+//# sourceMappingURL=compressor.d.ts.map

package/dist/shared/utils/compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressor.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/compressor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,MAAM,EAAE,iBAAiB;IAKrC;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAgBrD;;;;;;OAMG;IACG,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAQvD;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;CAG5C"}

package/dist/shared/utils/compressor.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Checkpoint compression utility using Node.js built-in zlib
+ * Provides transparent gzip compression/decompression with smart thresholds
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Compressor = void 0;
+const node_util_1 = require("node:util");
+const node_zlib_1 = require("node:zlib");
+const gzipAsync = (0, node_util_1.promisify)(node_zlib_1.gzip);
+const gunzipAsync = (0, node_util_1.promisify)(node_zlib_1.gunzip);
+/** Gzip magic number bytes for auto-detection */
+const GZIP_MAGIC = new Uint8Array([0x1f, 0x8b]);
+/**
+ * Compressor for checkpoint data using gzip
+ *
+ * Features:
+ * - Smart threshold: skips compression for payloads below `minSizeBytes`
+ * - Auto-detection: `decompress()` transparently handles both compressed and uncompressed data
+ * - Zero dependencies: uses Node.js built-in `zlib`
+ */
+class Compressor {
+    minSizeBytes;
+    level;
+    constructor(config) {
+        this.minSizeBytes = config.minSizeBytes ?? 1024;
+        this.level = config.level ?? 6;
+    }
+    /**
+     * Compress data if above the minimum size threshold
+     *
+     * @param data - Raw data to compress
+     * @returns Compressed data (gzip) or original data if below threshold
+     */
+    async compress(data) {
+        if (data.length < this.minSizeBytes) {
+            return data;
+        }
+        const compressed = new Uint8Array(await gzipAsync(data, { level: this.level }));
+        // Only use compressed output if it saves at least 10% space.
+        // This avoids data expansion for already-compressed or random binary payloads.
+        if (compressed.length >= data.length * 0.9) {
+            return data;
+        }
+        return compressed;
+    }
+    /**
+     * Decompress data if gzip magic header is detected, otherwise passthrough
+     * This provides full backward compatibility with uncompressed data
+     *
+     * @param data - Potentially compressed data
+     * @returns Decompressed data
+     */
+    async decompress(data) {
+        if (!Compressor.isGzipped(data)) {
+            return data;
+        }
+        return new Uint8Array(await gunzipAsync(data));
+    }
+    /**
+     * Check if data starts with the gzip magic number
+     */
+    static isGzipped(data) {
+        return data.length >= 2 && data[0] === GZIP_MAGIC[0] && data[1] === GZIP_MAGIC[1];
+    }
+}
+exports.Compressor = Compressor;
+//# sourceMappingURL=compressor.js.map

package/dist/shared/utils/compressor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressor.js","sourceRoot":"","sources":["../../../src/shared/utils/compressor.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,yCAAsC;AACtC,yCAAyC;AAEzC,MAAM,SAAS,GAAG,IAAA,qBAAS,EAAC,gBAAI,CAAC,CAAC;AAClC,MAAM,WAAW,GAAG,IAAA,qBAAS,EAAC,kBAAM,CAAC,CAAC;AAEtC,iDAAiD;AACjD,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAchD;;;;;;;GAOG;AACH,MAAa,UAAU;IACJ,YAAY,CAAS;IACrB,KAAK,CAAS;IAE/B,YAAY,MAAyB;QACnC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAgB;QAC7B,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAEhF,6DAA6D;QAC7D,+EAA+E;QAC/E,IAAI,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,IAAgB;QAC/B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,UAAU,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAgB;QAC/B,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC;IACpF,CAAC;CACF;AApDD,gCAoDC"}

package/dist/shared/utils/constants.d.ts

@@ -4,6 +4,8 @@
 export declare const MAX_TTL_DAYS: number;
 export declare const MAX_LOOP_ITERATIONS = 100;
 export declare const MAX_TOTAL_ITEMS_IN_MEMORY = 10000;
+export declare const BATCH_WRITE_MAX = 25;
+export declare const MAX_UNPROCESSED_RETRIES = 10;
 /**
  * Validate TTL days (shared logic)
  */

package/dist/shared/utils/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,YAAY,QAAU,CAAC;AACpC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAE/C;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAuBjE"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,YAAY,QAAU,CAAC;AACpC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAC/C,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgBjE"}

package/dist/shared/utils/constants.js

@@ -3,12 +3,14 @@
  * Shared constants for validation across store and checkpointer
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_TOTAL_ITEMS_IN_MEMORY = exports.MAX_LOOP_ITERATIONS = exports.MAX_TTL_DAYS = void 0;
+exports.MAX_UNPROCESSED_RETRIES = exports.BATCH_WRITE_MAX = exports.MAX_TOTAL_ITEMS_IN_MEMORY = exports.MAX_LOOP_ITERATIONS = exports.MAX_TTL_DAYS = void 0;
 exports.validateTTLDays = validateTTLDays;
 // Common DynamoDB limits
 exports.MAX_TTL_DAYS = 365 * 5; // 5 years
 exports.MAX_LOOP_ITERATIONS = 100; // Maximum loop iterations to prevent infinite loops
 exports.MAX_TOTAL_ITEMS_IN_MEMORY = 10000; // Maximum items to collect in memory
+exports.BATCH_WRITE_MAX = 25; // DynamoDB BatchWriteItem limit per request
+exports.MAX_UNPROCESSED_RETRIES = 10; // Maximum retries for UnprocessedItems loops
 /**
  * Validate TTL days (shared logic)
  */
@@ -25,11 +27,5 @@ function validateTTLDays(ttlDays) {
     if (ttlDays > exports.MAX_TTL_DAYS) {
         throw new Error(`TTL days cannot exceed ${exports.MAX_TTL_DAYS}`);
     }
-    // Check for overflow when converting to Unix timestamp
-    const futureTimestamp = Math.floor(Date.now() / 1000) + ttlDays * 24 * 60 * 60;
-    if (futureTimestamp > 2147483647) {
-        // Max 32-bit integer
-        throw new Error('TTL would overflow Unix timestamp (max date: 2038-01-19)');
-    }
 }
 //# sourceMappingURL=constants.js.map

package/dist/shared/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/shared/utils/constants.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAUH,0CAuBC;AA/BD,yBAAyB;AACZ,QAAA,YAAY,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU;AAClC,QAAA,mBAAmB,GAAG,GAAG,CAAC,CAAC,oDAAoD;AAC/E,QAAA,yBAAyB,GAAG,KAAK,CAAC,CAAC,qCAAqC;AAErF;;GAEG;AACH,SAAgB,eAAe,CAAC,OAA2B;IACzD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,GAAG,oBAAY,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,0BAA0B,oBAAY,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,uDAAuD;IACvD,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAC/E,IAAI,eAAe,GAAG,UAAU,EAAE,CAAC;QACjC,qBAAqB;QACrB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/shared/utils/constants.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAYH,0CAgBC;AA1BD,yBAAyB;AACZ,QAAA,YAAY,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU;AAClC,QAAA,mBAAmB,GAAG,GAAG,CAAC,CAAC,oDAAoD;AAC/E,QAAA,yBAAyB,GAAG,KAAK,CAAC,CAAC,qCAAqC;AACxE,QAAA,eAAe,GAAG,EAAE,CAAC,CAAC,4CAA4C;AAClE,QAAA,uBAAuB,GAAG,EAAE,CAAC,CAAC,6CAA6C;AAExF;;GAEG;AACH,SAAgB,eAAe,CAAC,OAA2B;IACzD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,GAAG,oBAAY,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,0BAA0B,oBAAY,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/shared/utils/index.d.ts

@@ -1,7 +1,11 @@
 /**
  * Shared utilities and types
  */
+export * from './compressor';
 export * from './constants';
+export * from './logger';
 export * from './retry';
+export * from './s3-offloader';
+export * from './batch-write';
 export * from './ttl';
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC"}

package/dist/shared/utils/index.js

@@ -17,7 +17,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./compressor"), exports);
 __exportStar(require("./constants"), exports);
+__exportStar(require("./logger"), exports);
 __exportStar(require("./retry"), exports);
+__exportStar(require("./s3-offloader"), exports);
+__exportStar(require("./batch-write"), exports);
 __exportStar(require("./ttl"), exports);
 //# sourceMappingURL=index.js.map

package/dist/shared/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,8CAA4B;AAC5B,0CAAwB;AACxB,wCAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,8CAA4B;AAC5B,2CAAyB;AACzB,0CAAwB;AACxB,iDAA+B;AAC/B,gDAA8B;AAC9B,wCAAsB"}