@farukada/aws-langgraph-dynamodb-ts 0.2.2 → 0.3.1

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

@@ -1,281 +0,0 @@
-"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/';
-/**
- * Default server-side encryption. Matches S3's own default (SSE-S3, AES256) since
- * January 2023, but asserting it on the PutObject makes the intent explicit for
- * compliance reviews and protects users running against older buckets or custom
- * endpoints that don't inherit the modern default.
- */
-const DEFAULT_SERVER_SIDE_ENCRYPTION = 'AES256';
-/* 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 ?? DEFAULT_SERVER_SIDE_ENCRYPTION;
-        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',
-            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();
-        // 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.
-     *
-     * The ID is scoped to the configured key prefix but intentionally TTL-independent:
-     * changing ttlDays updates the existing rule in place instead of leaving a stale
-     * rule behind that would still expire objects at the old cadence.
-     *
-     * @returns Rule ID string
-     */
-    buildLifecycleRuleId() {
-        // Normalize the prefix into a lifecycle-rule-safe slug, trimming the trailing slash.
-        const slug = this.keyPrefix.replace(/\/+$/, '').replace(/[^a-zA-Z0-9-]/g, '-') || 'default';
-        return `langgraph-ttl-${slug}`;
-    }
-    /**
-     * 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

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

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

@@ -1,16 +0,0 @@
-/**
- * Best-effort S3 orphan cleanup shared by checkpointer writers.
- *
- * When a DynamoDB write fails *after* payloads have already been uploaded to S3,
- * this helper deletes the uploaded objects so they don't linger until the
- * lifecycle rule sweeps them.
- *
- * Transient S3 errors (503 SlowDown, 500 InternalError, throttling, socket
- * blips) get bounded retries with full-jitter backoff so a single bad minute
- * doesn't leak objects. Persistent failures are only logged — the lifecycle
- * rule is the ultimate backstop and failing the caller's write *after* DDB has
- * already rolled back would add confusion, not safety.
- */
-import type { S3Offloader } from './s3-offloader';
-export declare function cleanUpS3Orphans(offloader: S3Offloader, keys: ReadonlyArray<string | undefined>, context: string): Promise<void>;
-//# sourceMappingURL=s3-orphans.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"s3-orphans.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/s3-orphans.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAqClD,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,WAAW,EACtB,IAAI,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

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

@@ -1,79 +0,0 @@
-"use strict";
-/**
- * Best-effort S3 orphan cleanup shared by checkpointer writers.
- *
- * When a DynamoDB write fails *after* payloads have already been uploaded to S3,
- * this helper deletes the uploaded objects so they don't linger until the
- * lifecycle rule sweeps them.
- *
- * Transient S3 errors (503 SlowDown, 500 InternalError, throttling, socket
- * blips) get bounded retries with full-jitter backoff so a single bad minute
- * doesn't leak objects. Persistent failures are only logged — the lifecycle
- * rule is the ultimate backstop and failing the caller's write *after* DDB has
- * already rolled back would add confusion, not safety.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.cleanUpS3Orphans = cleanUpS3Orphans;
-const logger_1 = require("./logger");
-const sleep_1 = require("./sleep");
-const ORPHAN_CLEANUP_MAX_ATTEMPTS = 3;
-const ORPHAN_CLEANUP_BASE_DELAY_MS = 100;
-const ORPHAN_CLEANUP_MAX_DELAY_MS = 2_000;
-/** Error codes/names that indicate an S3 request is worth re-issuing. */
-const RETRYABLE_S3_SIGNALS = [
-    'SlowDown',
-    'InternalError',
-    'ServiceUnavailable',
-    'RequestTimeout',
-    'ThrottlingException',
-    'ProvisionedThroughputExceededException',
-    // Node-level network transients (also caught by @aws-sdk/client-s3 wrappers).
-    'ECONNRESET',
-    'ECONNREFUSED',
-    'ETIMEDOUT',
-    'EPIPE',
-    'NetworkingError',
-    'TimeoutError',
-];
-function isTransientS3Error(err) {
-    if (!err || typeof err !== 'object')
-        return false;
-    const signals = [];
-    const e = err;
-    if (typeof e.name === 'string')
-        signals.push(e.name);
-    if (typeof e.code === 'string')
-        signals.push(e.code);
-    const status = e.$metadata?.httpStatusCode;
-    if (typeof status === 'number' && (status === 429 || (status >= 500 && status < 600))) {
-        return true;
-    }
-    return RETRYABLE_S3_SIGNALS.some((s) => signals.some((sig) => sig.includes(s)));
-}
-async function cleanUpS3Orphans(offloader, keys, context) {
-    const orphans = keys.filter((k) => typeof k === 'string' && k.length > 0);
-    if (orphans.length === 0)
-        return;
-    let delay = ORPHAN_CLEANUP_BASE_DELAY_MS;
-    let lastErr;
-    for (let attempt = 1; attempt <= ORPHAN_CLEANUP_MAX_ATTEMPTS; attempt++) {
-        try {
-            await offloader.deleteBatch(orphans);
-            return;
-        }
-        catch (err) {
-            lastErr = err;
-            if (attempt >= ORPHAN_CLEANUP_MAX_ATTEMPTS || !isTransientS3Error(err)) {
-                break;
-            }
-            await (0, sleep_1.sleep)((0, sleep_1.fullJitter)(delay));
-            delay = Math.min(delay * 2, ORPHAN_CLEANUP_MAX_DELAY_MS);
-        }
-    }
-    const msg = lastErr && typeof lastErr === 'object' && 'message' in lastErr
-        ? String(lastErr.message)
-        : String(lastErr);
-    (0, logger_1.getLogger)().warn(`Failed to clean up orphaned S3 objects after ${context} ` +
-        `(${ORPHAN_CLEANUP_MAX_ATTEMPTS} attempts, lifecycle rule will sweep): ${msg}`);
-}
-//# sourceMappingURL=s3-orphans.js.map

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

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

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

@@ -1,48 +0,0 @@
-/**
- * Backoff helper shared by the UnprocessedItems / UnprocessedKeys retry loops
- * in batch-write and BatchGetItem paths. Centralized so both call sites use
- * the same cap, growth, and sleep semantics.
- */
-/**
- * Sleep for `ms` milliseconds, optionally cancellable via an `AbortSignal`.
- *
- * If `signal` is already aborted the returned promise rejects synchronously with
- * the signal's abort reason. Otherwise the timer resolves on the normal path and
- * the abort listener is removed to avoid leaking handlers.
- *
- * The `settled` flag is a belt-and-braces guard: `{ once: true }` already
- * prevents the listener from firing twice, but the guard also ensures we never
- * resolve *and* reject (which would produce an unhandled rejection if the timer
- * and abort event fire in the same microtask turn).
- */
-export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
-/**
- * Exponential-backoff delay calculator. Given the *previous* delay, returns the
- * next delay — double it, capped at `max`. Use with {@link sleep} and
- * {@link fullJitter} so concurrent retriers don't synchronize.
- *
- *   let delay = INITIAL_DELAY_MS;
- *   while (keep_going) {
- *     await sleep(fullJitter(delay));
- *     delay = nextBackoffDelay(delay);
- *   }
- */
-export declare function nextBackoffDelay(currentMs: number, maxMs?: number): number;
-/**
- * Apply full jitter (AWS recommended) to a backoff delay.
- *
- * Returns a uniform random value in `[0, delayMs)`. Spreading retries across the
- * backoff window prevents the thundering-herd pattern where every throttled
- * client wakes up at the same instant and re-throttles the service.
- * See https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/
- */
-export declare function fullJitter(delayMs: number): number;
-/**
- * Starting delay for UnprocessedItems / UnprocessedKeys retry loops.
- */
-export declare const INITIAL_BACKOFF_DELAY_MS = 100;
-/**
- * Maximum delay for UnprocessedItems / UnprocessedKeys retry loops.
- */
-export declare const MAX_BACKOFF_DELAY_MS = 5000;
-//# sourceMappingURL=sleep.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/sleep.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAA6B,GAAG,MAAM,CAEhG;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,MAA2B,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,oBAAoB,OAAuB,CAAC"}

package/dist/shared/utils/sleep.js

@@ -1,82 +0,0 @@
-"use strict";
-/**
- * Backoff helper shared by the UnprocessedItems / UnprocessedKeys retry loops
- * in batch-write and BatchGetItem paths. Centralized so both call sites use
- * the same cap, growth, and sleep semantics.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_BACKOFF_DELAY_MS = exports.INITIAL_BACKOFF_DELAY_MS = void 0;
-exports.sleep = sleep;
-exports.nextBackoffDelay = nextBackoffDelay;
-exports.fullJitter = fullJitter;
-const DEFAULT_INITIAL_DELAY_MS = 100;
-const DEFAULT_MAX_DELAY_MS = 5000;
-/**
- * Sleep for `ms` milliseconds, optionally cancellable via an `AbortSignal`.
- *
- * If `signal` is already aborted the returned promise rejects synchronously with
- * the signal's abort reason. Otherwise the timer resolves on the normal path and
- * the abort listener is removed to avoid leaking handlers.
- *
- * The `settled` flag is a belt-and-braces guard: `{ once: true }` already
- * prevents the listener from firing twice, but the guard also ensures we never
- * resolve *and* reject (which would produce an unhandled rejection if the timer
- * and abort event fire in the same microtask turn).
- */
-function sleep(ms, signal) {
-    if (signal?.aborted) {
-        return Promise.reject(signal.reason ?? new Error('Aborted'));
-    }
-    return new Promise((resolve, reject) => {
-        let settled = false;
-        const timer = setTimeout(() => {
-            if (settled)
-                return;
-            settled = true;
-            signal?.removeEventListener('abort', onAbort);
-            resolve();
-        }, ms);
-        const onAbort = () => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            reject(signal?.reason ?? new Error('Aborted'));
-        };
-        signal?.addEventListener('abort', onAbort, { once: true });
-    });
-}
-/**
- * Exponential-backoff delay calculator. Given the *previous* delay, returns the
- * next delay — double it, capped at `max`. Use with {@link sleep} and
- * {@link fullJitter} so concurrent retriers don't synchronize.
- *
- *   let delay = INITIAL_DELAY_MS;
- *   while (keep_going) {
- *     await sleep(fullJitter(delay));
- *     delay = nextBackoffDelay(delay);
- *   }
- */
-function nextBackoffDelay(currentMs, maxMs = DEFAULT_MAX_DELAY_MS) {
-    return Math.min(currentMs * 2, maxMs);
-}
-/**
- * Apply full jitter (AWS recommended) to a backoff delay.
- *
- * Returns a uniform random value in `[0, delayMs)`. Spreading retries across the
- * backoff window prevents the thundering-herd pattern where every throttled
- * client wakes up at the same instant and re-throttles the service.
- * See https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/
- */
-function fullJitter(delayMs) {
-    return Math.random() * delayMs;
-}
-/**
- * Starting delay for UnprocessedItems / UnprocessedKeys retry loops.
- */
-exports.INITIAL_BACKOFF_DELAY_MS = DEFAULT_INITIAL_DELAY_MS;
-/**
- * Maximum delay for UnprocessedItems / UnprocessedKeys retry loops.
- */
-exports.MAX_BACKOFF_DELAY_MS = DEFAULT_MAX_DELAY_MS;
-//# sourceMappingURL=sleep.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../src/shared/utils/sleep.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAiBH,sBAoBC;AAaD,4CAEC;AAUD,gCAEC;AA9DD,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,SAAgB,KAAK,CAAC,EAAU,EAAE,MAAoB;IACpD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,gBAAgB,CAAC,SAAiB,EAAE,QAAgB,oBAAoB;IACtF,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,OAAe;IACxC,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC;AACjC,CAAC;AAED;;GAEG;AACU,QAAA,wBAAwB,GAAG,wBAAwB,CAAC;AAEjE;;GAEG;AACU,QAAA,oBAAoB,GAAG,oBAAoB,CAAC"}

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

@@ -1,24 +0,0 @@
-/**
- * TTL (Time-To-Live) utility functions
- * Provide centralized TTL calculation for DynamoDB items
- */
-/**
- * Calculate Unix timestamp for TTL expiration from seconds.
- *
- * Validates the input so callers can't silently produce absurd timestamps
- * (e.g. `Number.MAX_SAFE_INTEGER`) that DynamoDB would reject at write time.
- *
- * @param ttlSeconds - Number of seconds until expiration (integer > 0, ≤ 100 years)
- * @returns Unix timestamp in seconds for DynamoDB TTL attribute
- * @throws Error if ttlSeconds is not a positive finite integer within the allowed range
- */
-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
- * @throws Error if ttlDays would cause overflow
- */
-export declare function calculateTTLTimestamp(ttlDays: number): number;
-//# sourceMappingURL=ttl.d.ts.map

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

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

package/dist/shared/utils/ttl.js

@@ -1,43 +0,0 @@
-"use strict";
-/**
- * TTL (Time-To-Live) utility functions
- * Provide centralized TTL calculation for DynamoDB items
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateTTLTimestampFromSeconds = calculateTTLTimestampFromSeconds;
-exports.calculateTTLTimestamp = calculateTTLTimestamp;
-/** 100 years in seconds — comfortable upper bound for any TTL use case. */
-const MAX_TTL_SECONDS = 100 * 365 * 24 * 60 * 60;
-/**
- * Calculate Unix timestamp for TTL expiration from seconds.
- *
- * Validates the input so callers can't silently produce absurd timestamps
- * (e.g. `Number.MAX_SAFE_INTEGER`) that DynamoDB would reject at write time.
- *
- * @param ttlSeconds - Number of seconds until expiration (integer > 0, ≤ 100 years)
- * @returns Unix timestamp in seconds for DynamoDB TTL attribute
- * @throws Error if ttlSeconds is not a positive finite integer within the allowed range
- */
-function calculateTTLTimestampFromSeconds(ttlSeconds) {
-    if (typeof ttlSeconds !== 'number' || !Number.isInteger(ttlSeconds)) {
-        throw new Error('ttlSeconds must be an integer');
-    }
-    if (ttlSeconds <= 0) {
-        throw new Error('ttlSeconds must be positive');
-    }
-    if (ttlSeconds > MAX_TTL_SECONDS) {
-        throw new Error(`ttlSeconds cannot exceed ${MAX_TTL_SECONDS} (100 years)`);
-    }
-    return Math.floor(Date.now() / 1000) + ttlSeconds;
-}
-/**
- * Calculate Unix timestamp for TTL expiration from days
- *
- * @param ttlDays - Number of days until expiration
- * @returns Unix timestamp in seconds for DynamoDB TTL attribute
- * @throws Error if ttlDays would cause overflow
- */
-function calculateTTLTimestamp(ttlDays) {
-    return calculateTTLTimestampFromSeconds(ttlDays * 24 * 60 * 60);
-}
-//# sourceMappingURL=ttl.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ttl.js","sourceRoot":"","sources":["../../../src/shared/utils/ttl.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAeH,4EAWC;AASD,sDAEC;AAnCD,2EAA2E;AAC3E,MAAM,eAAe,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAEjD;;;;;;;;;GASG;AACH,SAAgB,gCAAgC,CAAC,UAAkB;IACjE,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,UAAU,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,4BAA4B,eAAe,cAAc,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,OAAO,gCAAgC,CAAC,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;AAClE,CAAC"}

package/dist/store/actions/get-operation.d.ts

@@ -1,11 +0,0 @@
-import type { Item } from '@langchain/langgraph';
-import type { GetOperationActionParams } from '../types';
-/**
- * Get a memory item from DynamoDB
- *
- * @param params - Parameters for the get operation
- * @returns The item if found, null if not found
- * @throws Error if the operation fails or validation fails
- */
-export declare const getOperationAction: (params: GetOperationActionParams) => Promise<Item | null>;
-//# sourceMappingURL=get-operation.d.ts.map

package/dist/store/actions/get-operation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-operation.d.ts","sourceRoot":"","sources":["../../../src/store/actions/get-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAGzD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,wBAAwB,KAC/B,OAAO,CAAC,IAAI,GAAG,IAAI,CAoCrB,CAAC"}