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

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

@@ -0,0 +1,48 @@
+/**
+ * Configurable logger for the library
+ *
+ * Provides a pluggable logging interface so consumers can integrate
+ * with their preferred logging framework (pino, winston, etc.)
+ *
+ * @example
+ * ```TypeScript
+ * import { setGlobalLogger } from '@farukada/aws-langgraph-dynamodb-ts';
+ *
+ * // Use a custom logger
+ * setGlobalLogger({
+ *   info: (msg, ...args) => myLogger.info(msg, ...args),
+ *   warn: (msg, ...args) => myLogger.warn(msg, ...args),
+ *   error: (msg, ...args) => myLogger.error(msg, ...args),
+ *   debug: (msg, ...args) => myLogger.debug(msg, ...args),
+ * });
+ *
+ * // Disable logging entirely
+ * setGlobalLogger({ info: () => {}, warn: () => {}, error: () => {}, debug: () => {} });
+ * ```
+ */
+/**
+ * Logger interface - consumers can provide their own implementation
+ */
+export interface Logger {
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    debug(message: string, ...args: unknown[]): void;
+}
+/**
+ * Set a custom global logger for the library
+ *
+ * @param logger - Custom logger implementation
+ */
+export declare function setGlobalLogger(logger: Logger): void;
+/**
+ * Get the current global logger
+ *
+ * @returns The currently configured logger
+ */
+export declare function getLogger(): Logger;
+/**
+ * Reset the logger to the default console-based implementation
+ */
+export declare function resetLogger(): void;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAuBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/shared/utils/logger.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Configurable logger for the library
+ *
+ * Provides a pluggable logging interface so consumers can integrate
+ * with their preferred logging framework (pino, winston, etc.)
+ *
+ * @example
+ * ```TypeScript
+ * import { setGlobalLogger } from '@farukada/aws-langgraph-dynamodb-ts';
+ *
+ * // Use a custom logger
+ * setGlobalLogger({
+ *   info: (msg, ...args) => myLogger.info(msg, ...args),
+ *   warn: (msg, ...args) => myLogger.warn(msg, ...args),
+ *   error: (msg, ...args) => myLogger.error(msg, ...args),
+ *   debug: (msg, ...args) => myLogger.debug(msg, ...args),
+ * });
+ *
+ * // Disable logging entirely
+ * setGlobalLogger({ info: () => {}, warn: () => {}, error: () => {}, debug: () => {} });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setGlobalLogger = setGlobalLogger;
+exports.getLogger = getLogger;
+exports.resetLogger = resetLogger;
+/**
+ * Default logger using console
+ */
+/* eslint-disable no-console -- default logger intentionally uses console; override via setGlobalLogger() */
+const defaultLogger = {
+    info: (message, ...args) => console.info(`[langgraph-dynamodb] ${message}`, ...args),
+    warn: (message, ...args) => console.warn(`[langgraph-dynamodb] ${message}`, ...args),
+    error: (message, ...args) => console.error(`[langgraph-dynamodb] ${message}`, ...args),
+    debug: (message, ...args) => console.debug(`[langgraph-dynamodb] ${message}`, ...args),
+};
+/* eslint-enable no-console */
+let globalLogger = defaultLogger;
+/**
+ * Set a custom global logger for the library
+ *
+ * @param logger - Custom logger implementation
+ */
+function setGlobalLogger(logger) {
+    globalLogger = logger;
+}
+/**
+ * Get the current global logger
+ *
+ * @returns The currently configured logger
+ */
+function getLogger() {
+    return globalLogger;
+}
+/**
+ * Reset the logger to the default console-based implementation
+ */
+function resetLogger() {
+    globalLogger = defaultLogger;
+}
+//# sourceMappingURL=logger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/shared/utils/logger.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;AAsCH,0CAEC;AAOD,8BAEC;AAKD,kCAEC;AA5CD;;GAEG;AACH,4GAA4G;AAC5G,MAAM,aAAa,GAAW;IAC5B,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAC5C,OAAO,CAAC,IAAI,CAAC,wBAAwB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC;IAE1D,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAC5C,OAAO,CAAC,IAAI,CAAC,wBAAwB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC;IAE1D,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAC7C,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC;IAE3D,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAC7C,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC;CAC5D,CAAC;AACF,8BAA8B;AAE9B,IAAI,YAAY,GAAW,aAAa,CAAC;AAEzC;;;;GAIG;AACH,SAAgB,eAAe,CAAC,MAAc;IAC5C,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS;IACvB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW;IACzB,YAAY,GAAG,aAAa,CAAC;AAC/B,CAAC"}

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

@@ -15,5 +15,5 @@ export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOption
 /**
  * Specialized retry for DynamoDB operations
  */
-export declare function withDynamoDBRetry<T>(fn: () => Promise<T>): Promise<T>;
+export declare function withDynamoDBRetry<T>(fn: () => Promise<T>, overrides?: Partial<RetryOptions>): Promise<T>;
 //# sourceMappingURL=retry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAyCD;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAkD/F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAM3E"}
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AA2CD;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CA0D/F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/shared/utils/retry.js

@@ -7,7 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.withRetry = withRetry;
 exports.withDynamoDBRetry = withDynamoDBRetry;
 const DEFAULT_OPTIONS = {
-    maxAttempts: 3,
+    maxAttempts: 5,
     baseDelayMs: 100,
     maxDelayMs: 5000,
     retryableErrors: [
@@ -16,6 +16,7 @@ const DEFAULT_OPTIONS = {
         'RequestLimitExceeded',
         'InternalServerError',
         'ServiceUnavailable',
+        'TransactionCanceledException',
     ],
 };
 /**
@@ -38,7 +39,8 @@ function calculateDelay(attempt, baseDelayMs, maxDelayMs) {
 function isRetryableError(error, retryableErrors) {
     if (!error)
         return false;
-    const errorName = error.name || error.code || '';
+    const errObj = error;
+    const errorName = String(errObj.name ?? errObj.code ?? '');
     return retryableErrors.some((retryable) => errorName.includes(retryable));
 }
 /**
@@ -64,7 +66,9 @@ async function withRetry(fn, options = {}) {
                 if (error instanceof Error) {
                     throw error;
                 }
-                const wrappedError = new Error(error?.message || String(error));
+                const wrappedError = new Error(error && typeof error === 'object' && 'message' in error
+                    ? String(error.message)
+                    : String(error));
                 // Preserve name and other properties from the original error
                 if (error && typeof error === 'object') {
                     Object.assign(wrappedError, error);
@@ -85,7 +89,9 @@ async function withRetry(fn, options = {}) {
         throw lastError;
     }
     // Convert to Error while preserving properties
-    const wrappedError = new Error(lastError?.message || String(lastError));
+    const wrappedError = new Error(lastError && typeof lastError === 'object' && 'message' in lastError
+        ? String(lastError.message)
+        : String(lastError));
     if (lastError && typeof lastError === 'object') {
         Object.assign(wrappedError, lastError);
     }
@@ -94,11 +100,12 @@ async function withRetry(fn, options = {}) {
 /**
  * Specialized retry for DynamoDB operations
  */
-async function withDynamoDBRetry(fn) {
+async function withDynamoDBRetry(fn, overrides) {
     return withRetry(fn, {
-        maxAttempts: 3,
+        maxAttempts: 5,
         baseDelayMs: 100,
         maxDelayMs: 5000,
+        ...overrides,
     });
 }
 //# sourceMappingURL=retry.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/shared/utils/retry.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAmDH,8BAkDC;AAKD,8CAMC;AAvGD,MAAM,eAAe,GAA2B;IAC9C,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,IAAI;IAChB,eAAe,EAAE;QACf,wCAAwC;QACxC,qBAAqB;QACrB,sBAAsB;QACtB,qBAAqB;QACrB,oBAAoB;KACrB;CACF,CAAC;AAEF;;GAEG;AACH,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,OAAe,EAAE,WAAmB,EAAE,UAAkB;IAC9E,MAAM,gBAAgB,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,gBAAgB,CAAC,CAAC,uBAAuB;IAC9E,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAU,EAAE,eAAyB;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;IACjD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,SAAS,CAAI,EAAoB,EAAE,UAAwB,EAAE;IACjF,MAAM,IAAI,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IAChD,IAAI,SAAc,CAAC;IAEnB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAElB,0CAA0C;YAC1C,IAAI,OAAO,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjC,MAAM;YACR,CAAC;YAED,4CAA4C;YAC5C,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnD,oDAAoD;gBACpD,uDAAuD;gBACvD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;oBAC3B,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,MAAM,YAAY,GAAG,IAAI,KAAK,CAAE,KAAa,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACzE,6DAA6D;gBAC7D,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACvC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;gBACrC,CAAC;gBACD,MAAM,YAAY,CAAC;YACrB,CAAC;YAED,2BAA2B;YAC3B,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACzE,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IACD,uDAAuD;IACvD,IAAI,SAAS,YAAY,KAAK,EAAE,CAAC;QAC/B,MAAM,SAAS,CAAC;IAClB,CAAC;IACD,+CAA+C;IAC/C,MAAM,YAAY,GAAG,IAAI,KAAK,CAAE,SAAiB,EAAE,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACjF,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,YAAY,CAAC;AACrB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,iBAAiB,CAAI,EAAoB;IAC7D,OAAO,SAAS,CAAC,EAAE,EAAE;QACnB,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,GAAG;QAChB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/shared/utils/retry.ts"],"names":[],"mappings":"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"}

package/dist/shared/utils/s3-offloader.d.ts

@@ -0,0 +1,146 @@
+/**
+ * S3 offloader for large checkpoint payloads
+ *
+ * DynamoDB has a hard 400KB item size limit. This utility transparently
+ * offloads payloads exceeding a configurable threshold (default: 350KB)
+ * to S3, storing only an S3 key reference in DynamoDB.
+ *
+ * Requires `@aws-sdk/client-s3` as an optional peer dependency.
+ *
+ * @remarks
+ * This module uses synchronous `require()` for lazy loading of the S3 SDK
+ * to avoid making the DynamoDBSaver constructor async. This means it
+ * requires a CommonJS-compatible environment (Node.js with CJS, or a
+ * bundler that polyfills require). Pure ESM environments are not supported.
+ */
+/**
+ * Configuration for S3 offloading
+ */
+export interface S3OffloadConfig {
+    /** S3 bucket name for storing offloaded payloads (required) */
+    bucketName: string;
+    /** Key prefix for S3 objects (default: 'langgraph-checkpoints/') */
+    keyPrefix?: string;
+    /** Payload size threshold in bytes that triggers offloading (default: 358400 = 350KB) */
+    thresholdBytes?: number;
+    /** Server-side encryption algorithm (e.g., 'AES256' or 'aws:kms'). Not set by default. */
+    serverSideEncryption?: string;
+    /** KMS key ID or ARN. Only used when serverSideEncryption is 'aws:kms'. */
+    sseKmsKeyId?: string;
+    /**
+     * Optional S3 client configuration (region, credentials, endpoint, etc.).
+     * Accepts any valid S3ClientConfig properties from @aws-sdk/client-s3.
+     */
+    clientConfig?: {
+        region?: string;
+        endpoint?: string;
+        credentials?: unknown;
+        [key: string]: unknown;
+    };
+}
+/**
+ * S3 offloader for large checkpoint payloads
+ *
+ * Transparently uploads large payloads to S3 and returns S3 key references
+ * for storage in DynamoDB. On read, downloads from S3 when a reference is present.
+ *
+ * @example
+ * ```typescript
+ * const offloader = new S3Offloader({
+ *   bucketName: 'my-checkpoints-bucket',
+ *   keyPrefix: 'langgraph/',
+ *   thresholdBytes: 350 * 1024,
+ * });
+ *
+ * if (offloader.shouldOffload(data)) {
+ *   const key = await offloader.upload('thread/checkpoint/field.bin', data);
+ *   // Store `key` in DynamoDB instead of `data`
+ * }
+ * ```
+ */
+export declare class S3Offloader {
+    private s3Client?;
+    private readonly bucketName;
+    private readonly keyPrefix;
+    private readonly thresholdBytes;
+    private readonly serverSideEncryption?;
+    private readonly sseKmsKeyId?;
+    private readonly clientConfig?;
+    constructor(config: S3OffloadConfig);
+    /**
+     * Get or lazily create the S3 client on first use.
+     * Defers S3Client construction so the constructor remains lightweight and sync.
+     */
+    private getClient;
+    /**
+     * Check whether a payload should be offloaded to S3
+     *
+     * @param data - Serialized payload
+     * @returns true if the payload exceeds the threshold
+     */
+    shouldOffload(data: Uint8Array): boolean;
+    /**
+     * Build a fully-qualified S3 key for a checkpoint field
+     *
+     * @param threadId - Thread identifier
+     * @param checkpointId - Checkpoint identifier
+     * @param field - Field name (e.g., 'checkpoint', 'metadata', 'write-0')
+     * @returns Fully-qualified S3 key
+     */
+    buildKey(threadId: string, checkpointId: string, field: string): string;
+    /**
+     * Upload data to S3
+     *
+     * @param key - S3 object key
+     * @param data - Data to upload
+     * @returns The S3 key that was used
+     */
+    upload(key: string, data: Uint8Array): Promise<string>;
+    /**
+     * Download data from S3
+     *
+     * @param key - S3 object key to download
+     * @returns The downloaded data as Uint8Array
+     * @throws Error if the download fails or body is empty
+     */
+    download(key: string): Promise<Uint8Array>;
+    /**
+     * Delete a single object from S3
+     *
+     * @param key - S3 object key to delete
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Batch delete multiple objects from S3
+     *
+     * @param keys - Array of S3 object keys to delete
+     */
+    deleteBatch(keys: string[]): Promise<void>;
+    /**
+     * Get the configured key prefix (useful for logging)
+     */
+    getKeyPrefix(): string;
+    /**
+     * Ensure an S3 lifecycle rule exists for automatic object expiration.
+     *
+     * This method is **idempotent**: it reads existing lifecycle rules and only
+     * adds or updates the langgraph-specific rule. User-defined rules on the
+     * bucket are preserved.
+     *
+     * @param ttlDays - Expiration in days (S3 lifecycle uses day-level precision)
+     * @throws Error if the S3 API calls fail (callers should catch gracefully)
+     */
+    ensureLifecycleRule(ttlDays: number): Promise<void>;
+    /**
+     * Generate a deterministic lifecycle rule ID for idempotency.
+     *
+     * @param ttlDays - Expiration in days
+     * @returns Rule ID string
+     */
+    private buildLifecycleRuleId;
+    /**
+     * Release underlying S3 client resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=s3-offloader.d.ts.map

package/dist/shared/utils/s3-offloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-offloader.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/s3-offloader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAuBH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0FAA0F;IAC1F,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,CAA6D;IAC9E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAkC;gBAEpD,MAAM,EAAE,eAAe;IASnC;;;OAGG;IACH,OAAO,CAAC,SAAS;IAQjB;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAIxC;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAIvE;;;;;;OAMG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB5D;;;;;;OAMG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBhD;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxC;;;;OAIG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgChD;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;;;;OASG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8EzD;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/shared/utils/s3-offloader.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * S3 offloader for large checkpoint payloads
+ *
+ * DynamoDB has a hard 400KB item size limit. This utility transparently
+ * offloads payloads exceeding a configurable threshold (default: 350KB)
+ * to S3, storing only an S3 key reference in DynamoDB.
+ *
+ * Requires `@aws-sdk/client-s3` as an optional peer dependency.
+ *
+ * @remarks
+ * This module uses synchronous `require()` for lazy loading of the S3 SDK
+ * to avoid making the DynamoDBSaver constructor async. This means it
+ * requires a CommonJS-compatible environment (Node.js with CJS, or a
+ * bundler that polyfills require). Pure ESM environments are not supported.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3Offloader = void 0;
+const logger_1 = require("./logger");
+/** Default threshold: 350KB (leaves 50KB headroom below DynamoDB's 400KB limit) */
+const DEFAULT_THRESHOLD_BYTES = 350 * 1024;
+/** Default S3 key prefix for offloaded payloads */
+const DEFAULT_KEY_PREFIX = 'langgraph-checkpoints/';
+/* eslint-disable @typescript-eslint/no-require-imports -- TODO: migrate to dynamic import() when Jest ESM support is stable */
+// Lazy-loaded S3 SDK — uses require() for Jest CJS compatibility.
+// Replace with import() when the test runner supports --experimental-vm-modules.
+let s3Sdk;
+function getS3Sdk() {
+    if (!s3Sdk) {
+        s3Sdk = require('@aws-sdk/client-s3');
+    }
+    return s3Sdk;
+}
+/**
+ * S3 offloader for large checkpoint payloads
+ *
+ * Transparently uploads large payloads to S3 and returns S3 key references
+ * for storage in DynamoDB. On read, downloads from S3 when a reference is present.
+ *
+ * @example
+ * ```typescript
+ * const offloader = new S3Offloader({
+ *   bucketName: 'my-checkpoints-bucket',
+ *   keyPrefix: 'langgraph/',
+ *   thresholdBytes: 350 * 1024,
+ * });
+ *
+ * if (offloader.shouldOffload(data)) {
+ *   const key = await offloader.upload('thread/checkpoint/field.bin', data);
+ *   // Store `key` in DynamoDB instead of `data`
+ * }
+ * ```
+ */
+class S3Offloader {
+    s3Client;
+    bucketName;
+    keyPrefix;
+    thresholdBytes;
+    serverSideEncryption;
+    sseKmsKeyId;
+    clientConfig;
+    constructor(config) {
+        this.bucketName = config.bucketName;
+        this.keyPrefix = config.keyPrefix ?? DEFAULT_KEY_PREFIX;
+        this.thresholdBytes = config.thresholdBytes ?? DEFAULT_THRESHOLD_BYTES;
+        this.serverSideEncryption = config.serverSideEncryption;
+        this.sseKmsKeyId = config.sseKmsKeyId;
+        this.clientConfig = config.clientConfig;
+    }
+    /**
+     * Get or lazily create the S3 client on first use.
+     * Defers S3Client construction so the constructor remains lightweight and sync.
+     */
+    getClient() {
+        if (!this.s3Client) {
+            const { S3Client } = getS3Sdk();
+            this.s3Client = new S3Client((this.clientConfig ?? {}));
+        }
+        return this.s3Client;
+    }
+    /**
+     * Check whether a payload should be offloaded to S3
+     *
+     * @param data - Serialized payload
+     * @returns true if the payload exceeds the threshold
+     */
+    shouldOffload(data) {
+        return data.length >= this.thresholdBytes;
+    }
+    /**
+     * Build a fully-qualified S3 key for a checkpoint field
+     *
+     * @param threadId - Thread identifier
+     * @param checkpointId - Checkpoint identifier
+     * @param field - Field name (e.g., 'checkpoint', 'metadata', 'write-0')
+     * @returns Fully-qualified S3 key
+     */
+    buildKey(threadId, checkpointId, field) {
+        return `${this.keyPrefix}${threadId}/${checkpointId}/${field}.bin`;
+    }
+    /**
+     * Upload data to S3
+     *
+     * @param key - S3 object key
+     * @param data - Data to upload
+     * @returns The S3 key that was used
+     */
+    async upload(key, data) {
+        const { PutObjectCommand } = getS3Sdk();
+        const client = this.getClient();
+        await client.send(new PutObjectCommand({
+            Bucket: this.bucketName,
+            Key: key,
+            Body: data,
+            ContentType: 'application/octet-stream',
+            ...(this.serverSideEncryption && {
+                ServerSideEncryption: this
+                    .serverSideEncryption,
+            }),
+            ...(this.sseKmsKeyId && { SSEKMSKeyId: this.sseKmsKeyId }),
+        }));
+        return key;
+    }
+    /**
+     * Download data from S3
+     *
+     * @param key - S3 object key to download
+     * @returns The downloaded data as Uint8Array
+     * @throws Error if the download fails or body is empty
+     */
+    async download(key) {
+        const { GetObjectCommand } = getS3Sdk();
+        const client = this.getClient();
+        const response = await client.send(new GetObjectCommand({
+            Bucket: this.bucketName,
+            Key: key,
+        }));
+        if (!response.Body) {
+            throw new Error(`S3 object body is empty for key: ${key}`);
+        }
+        // Convert the readable stream to Uint8Array
+        const byteArray = await response.Body.transformToByteArray();
+        return new Uint8Array(byteArray);
+    }
+    /**
+     * Delete a single object from S3
+     *
+     * @param key - S3 object key to delete
+     */
+    async delete(key) {
+        const { DeleteObjectCommand } = getS3Sdk();
+        const client = this.getClient();
+        await client.send(new DeleteObjectCommand({
+            Bucket: this.bucketName,
+            Key: key,
+        }));
+    }
+    /**
+     * Batch delete multiple objects from S3
+     *
+     * @param keys - Array of S3 object keys to delete
+     */
+    async deleteBatch(keys) {
+        if (keys.length === 0)
+            return;
+        const { DeleteObjectsCommand } = getS3Sdk();
+        const client = this.getClient();
+        // S3 DeleteObjects supports up to 1000 keys per request
+        const batchSize = 1000;
+        for (let i = 0; i < keys.length; i += batchSize) {
+            const batch = keys.slice(i, i + batchSize);
+            const response = await client.send(new DeleteObjectsCommand({
+                Bucket: this.bucketName,
+                Delete: {
+                    Objects: batch.map((key) => ({ Key: key })),
+                    Quiet: true,
+                },
+            }));
+            // Log any failed deletions (Quiet mode still reports errors)
+            if (response.Errors && response.Errors.length > 0) {
+                const failedKeys = response.Errors.map((err) => `${err.Key} (${err.Code}: ${err.Message})`).join(', ');
+                (0, logger_1.getLogger)().warn(`S3 deleteBatch: ${response.Errors.length} objects failed to delete: ${failedKeys}`);
+            }
+        }
+    }
+    /**
+     * Get the configured key prefix (useful for logging)
+     */
+    getKeyPrefix() {
+        return this.keyPrefix;
+    }
+    /**
+     * Ensure an S3 lifecycle rule exists for automatic object expiration.
+     *
+     * This method is **idempotent**: it reads existing lifecycle rules and only
+     * adds or updates the langgraph-specific rule. User-defined rules on the
+     * bucket are preserved.
+     *
+     * @param ttlDays - Expiration in days (S3 lifecycle uses day-level precision)
+     * @throws Error if the S3 API calls fail (callers should catch gracefully)
+     */
+    async ensureLifecycleRule(ttlDays) {
+        const { GetBucketLifecycleConfigurationCommand, PutBucketLifecycleConfigurationCommand } = getS3Sdk();
+        const client = this.getClient();
+        const ruleId = this.buildLifecycleRuleId(ttlDays);
+        // 1. Read existing lifecycle configuration
+        let existingRules = [];
+        try {
+            const existing = await client.send(new GetBucketLifecycleConfigurationCommand({ Bucket: this.bucketName }));
+            existingRules = existing.Rules ?? [];
+        }
+        catch (error) {
+            // NoSuchLifecycleConfiguration means bucket has no lifecycle config — treat as empty
+            if (error &&
+                typeof error === 'object' &&
+                'name' in error &&
+                error.name === 'NoSuchLifecycleConfiguration') {
+                existingRules = [];
+            }
+            else {
+                throw error;
+            }
+        }
+        // 2. Check if a matching rule already exists (by ID)
+        const existingRule = existingRules.find((r) => r.ID === ruleId);
+        if (existingRule &&
+            existingRule.Status === 'Enabled' &&
+            existingRule.Expiration &&
+            existingRule.Expiration.Days === ttlDays) {
+            // Rule already exists with correct settings — nothing to do
+            (0, logger_1.getLogger)().info(`S3 lifecycle rule '${ruleId}' already exists with ${ttlDays}-day expiration — skipping`);
+            return;
+        }
+        // 3. Build the new rule
+        const newRule = {
+            ID: ruleId,
+            Filter: { Prefix: this.keyPrefix },
+            Status: 'Enabled',
+            Expiration: { Days: ttlDays },
+        };
+        // 4. Merge: replace existing rule with same ID or append
+        const mergedRules = existingRule
+            ? existingRules.map((r) => (r.ID === ruleId ? newRule : r))
+            : [...existingRules, newRule];
+        // 5. Write back
+        await client.send(new PutBucketLifecycleConfigurationCommand({
+            Bucket: this.bucketName,
+            LifecycleConfiguration: {
+                Rules: mergedRules,
+            },
+        }));
+        (0, logger_1.getLogger)().info(`S3 lifecycle rule '${ruleId}' configured: ${ttlDays}-day expiration on prefix '${this.keyPrefix}'`);
+    }
+    /**
+     * Generate a deterministic lifecycle rule ID for idempotency.
+     *
+     * @param ttlDays - Expiration in days
+     * @returns Rule ID string
+     */
+    buildLifecycleRuleId(ttlDays) {
+        return `langgraph-ttl-${ttlDays}d`;
+    }
+    /**
+     * Release underlying S3 client resources
+     */
+    destroy() {
+        this.s3Client?.destroy();
+    }
+}
+exports.S3Offloader = S3Offloader;
+//# sourceMappingURL=s3-offloader.js.map

package/dist/shared/utils/s3-offloader.js.map

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

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

@@ -3,7 +3,14 @@
  * Provide centralized TTL calculation for DynamoDB items
  */
 /**
- * Calculate Unix timestamp for TTL expiration
+ * Calculate Unix timestamp for TTL expiration from seconds
+ *
+ * @param ttlSeconds - Number of seconds until expiration
+ * @returns Unix timestamp in seconds for DynamoDB TTL attribute
+ */
+export declare function calculateTTLTimestampFromSeconds(ttlSeconds: number): number;
+/**
+ * Calculate Unix timestamp for TTL expiration from days
  *
  * @param ttlDays - Number of days until expiration
  * @returns Unix timestamp in seconds for DynamoDB TTL attribute

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

@@ -1 +1 @@
-{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/ttl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU7D"}
+{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/ttl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D"}