@farukada/aws-langgraph-dynamodb-ts 0.2.0 → 0.3.0

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

@@ -1,75 +0,0 @@
-/**
- * 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;
-/**
- * Recursively clone an object, replacing values at any secret-looking key with
- * `[REDACTED]`. Cycles are broken with a WeakSet. Leaves primitives and non-
- * enumerable values untouched. Does not mutate the input.
- *
- * @param value - Arbitrary value to redact
- * @param patterns - Lower-cased substrings to match against each key
- */
-export declare function redactSecrets(value: unknown, patterns?: readonly string[]): unknown;
-/**
- * Wrap an existing logger with automatic secret redaction applied to the
- * variadic args (the message string itself is passed through unchanged — don't
- * interpolate secrets into messages). Strings in args are left as-is; only
- * object properties whose keys match a secret pattern are replaced.
- *
- * @example
- * ```ts
- * import { setGlobalLogger, redactLogger, getLogger } from '@farukada/aws-langgraph-dynamodb-ts';
- * setGlobalLogger(redactLogger(getLogger()));
- * ```
- *
- * @param inner - Logger to wrap
- * @param options.extraKeys - Additional lower-cased substrings to treat as secret keys
- */
-export declare function redactLogger(inner: Logger, options?: {
-    extraKeys?: readonly string[];
-}): Logger;
-//# sourceMappingURL=logger.d.ts.map

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

@@ -1 +0,0 @@
-{"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;AA8BD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,SAAS,MAAM,EAAgC,GACxD,OAAO,CA0BT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GAC9C,MAAM,CAWR"}

package/dist/shared/utils/logger.js

@@ -1,148 +0,0 @@
-"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;
-exports.redactSecrets = redactSecrets;
-exports.redactLogger = redactLogger;
-/**
- * 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;
-}
-/**
- * Default field names treated as secrets. Case-insensitive substring match — so
- * `AccessKeyId`, `aws_access_key_id`, `X-Amz-Security-Token`, `authorization`
- * all get caught. Extend via {@link redactLogger}'s `extraKeys` option if your
- * workload introduces more sensitive fields (e.g. `api_key`, `bearer`).
- */
-const DEFAULT_SECRET_KEY_PATTERNS = [
-    'accesskey',
-    'secretkey',
-    'secret',
-    'sessiontoken',
-    'securitytoken',
-    'authorization',
-    'password',
-    'credential',
-    'apikey',
-    'bearer',
-    'token',
-    'privatekey',
-];
-const REDACTED_PLACEHOLDER = '[REDACTED]';
-function isSecretKey(key, patterns) {
-    const lc = key.toLowerCase();
-    return patterns.some((p) => lc.includes(p));
-}
-/**
- * Recursively clone an object, replacing values at any secret-looking key with
- * `[REDACTED]`. Cycles are broken with a WeakSet. Leaves primitives and non-
- * enumerable values untouched. Does not mutate the input.
- *
- * @param value - Arbitrary value to redact
- * @param patterns - Lower-cased substrings to match against each key
- */
-function redactSecrets(value, patterns = DEFAULT_SECRET_KEY_PATTERNS) {
-    const seen = new WeakSet();
-    const walk = (v) => {
-        if (v === null || typeof v !== 'object')
-            return v;
-        if (seen.has(v))
-            return '[Circular]';
-        seen.add(v);
-        if (Array.isArray(v)) {
-            return v.map((el) => walk(el));
-        }
-        // Preserve Error shapes so stack traces survive redaction.
-        // eslint-disable-next-line no-instanceof/no-instanceof
-        if (v instanceof Error) {
-            return v;
-        }
-        const out = {};
-        for (const [k, val] of Object.entries(v)) {
-            out[k] = isSecretKey(k, patterns) ? REDACTED_PLACEHOLDER : walk(val);
-        }
-        return out;
-    };
-    return walk(value);
-}
-/**
- * Wrap an existing logger with automatic secret redaction applied to the
- * variadic args (the message string itself is passed through unchanged — don't
- * interpolate secrets into messages). Strings in args are left as-is; only
- * object properties whose keys match a secret pattern are replaced.
- *
- * @example
- * ```ts
- * import { setGlobalLogger, redactLogger, getLogger } from '@farukada/aws-langgraph-dynamodb-ts';
- * setGlobalLogger(redactLogger(getLogger()));
- * ```
- *
- * @param inner - Logger to wrap
- * @param options.extraKeys - Additional lower-cased substrings to treat as secret keys
- */
-function redactLogger(inner, options = {}) {
-    const patterns = options.extraKeys
-        ? [...DEFAULT_SECRET_KEY_PATTERNS, ...options.extraKeys.map((k) => k.toLowerCase())]
-        : DEFAULT_SECRET_KEY_PATTERNS;
-    const wrap = (args) => args.map((a) => redactSecrets(a, patterns));
-    return {
-        info: (msg, ...args) => inner.info(msg, ...wrap(args)),
-        warn: (msg, ...args) => inner.warn(msg, ...wrap(args)),
-        error: (msg, ...args) => inner.error(msg, ...wrap(args)),
-        debug: (msg, ...args) => inner.debug(msg, ...wrap(args)),
-    };
-}
-//# sourceMappingURL=logger.js.map

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

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

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

@@ -1,26 +0,0 @@
-/**
- * Retry utilities for handling transient DynamoDB errors
- * Shared between store and checkpointer
- */
-export interface RetryOptions {
-    maxAttempts?: number;
-    baseDelayMs?: number;
-    maxDelayMs?: number;
-    retryableErrors?: string[];
-    /**
-     * Optional abort signal. When aborted, any in-flight sleep between retries
-     * resolves immediately and `withRetry` rejects with the signal's abort reason.
-     * The signal is checked before every attempt, so an abort mid-backoff short-
-     * circuits the remaining retries rather than consuming the full schedule.
-     */
-    signal?: AbortSignal;
-}
-/**
- * Retry a function with exponential backoff
- */
-export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
-/**
- * Specialized retry for DynamoDB operations
- */
-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 +0,0 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,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;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA0FD;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAkE/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

@@ -1,169 +0,0 @@
-"use strict";
-/**
- * Retry utilities for handling transient DynamoDB errors
- * Shared between store and checkpointer
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.withRetry = withRetry;
-exports.withDynamoDBRetry = withDynamoDBRetry;
-const sleep_1 = require("./sleep");
-// TransactionCanceledException is NOT retried here: its CancellationReasons include
-// permanent failures (ConditionalCheckFailed, ValidationError, ItemCollectionSizeLimitExceeded)
-// that must not be retried blindly. Callers that need to retry on specific sub-reasons
-// (e.g. ThrottlingError) must inspect CancellationReasons themselves.
-//
-// TransactionConflictException (the *transient* sibling — one row racing with another
-// concurrent transaction) IS retried. It's the recommended retry path for writes under
-// contention and is distinct from TransactionCanceledException.
-const DEFAULT_OPTIONS = {
-    maxAttempts: 5,
-    baseDelayMs: 100,
-    maxDelayMs: 5000,
-    retryableErrors: [
-        // DynamoDB throttling / capacity
-        'ProvisionedThroughputExceededException',
-        'ThrottlingException',
-        'RequestLimitExceeded',
-        // Service-side transient
-        'InternalServerError',
-        'ServiceUnavailable',
-        // Transaction contention (transient — distinct from TransactionCanceledException)
-        'TransactionConflictException',
-        // Node-level network transients. Matched against both the error `code` and
-        // `name` fields so we catch plain socket errors as well as SDK-wrapped ones.
-        'ECONNRESET',
-        'ECONNREFUSED',
-        'ETIMEDOUT',
-        'EPIPE',
-        'EAI_AGAIN',
-        'NetworkingError',
-        'TimeoutError',
-    ],
-};
-/**
- * Calculate delay with full jitter (AWS recommended) and a max-delay cap.
- *
- * `delay = random(0, min(cap, base * 2^(attempt-1)))` — spreads retries
- * uniformly across the backoff window so concurrent clients don't synchronize
- * into a thundering herd.
- * See https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/
- */
-function calculateDelay(attempt, baseDelayMs, maxDelayMs) {
-    const exponentialDelay = baseDelayMs * Math.pow(2, attempt - 1);
-    const cap = Math.min(exponentialDelay, maxDelayMs);
-    return Math.random() * cap;
-}
-/**
- * Check if an error is retryable.
- *
- * Matches against the error's `name` and `code` fields (and, when available,
- * a nested `$metadata`/`cause`) so we catch AWS SDK exceptions, Node socket
- * errors (`ECONNRESET`, `ETIMEDOUT`, …), and wrapped `cause` chains.
- */
-function isRetryableError(error, retryableErrors) {
-    if (!error)
-        return false;
-    const seen = new WeakSet();
-    const signals = [];
-    // Bound recursion depth — WeakSet breaks cycles but does not bound unique chain
-    // length. An attacker (or a buggy SDK middleware) could craft a 10k-deep
-    // `cause` chain and stack-overflow the process. 32 is generous: realistic AWS
-    // SDK wrapping nests 3-5 deep.
-    const MAX_CAUSE_DEPTH = 32;
-    const collect = (err, depth) => {
-        if (depth > MAX_CAUSE_DEPTH)
-            return;
-        if (!err || typeof err !== 'object')
-            return;
-        if (seen.has(err))
-            return;
-        seen.add(err);
-        const o = err;
-        if (typeof o.name === 'string')
-            signals.push(o.name);
-        if (typeof o.code === 'string')
-            signals.push(o.code);
-        if (typeof o.errno === 'string')
-            signals.push(o.errno);
-        if (typeof o.syscall === 'string')
-            signals.push(o.syscall);
-        collect(o.cause, depth + 1);
-    };
-    collect(error, 0);
-    if (signals.length === 0)
-        return false;
-    return retryableErrors.some((retryable) => signals.some((sig) => sig.includes(retryable)));
-}
-/**
- * Retry a function with exponential backoff
- */
-async function withRetry(fn, options = {}) {
-    const { signal, ...rest } = options;
-    const opts = { ...DEFAULT_OPTIONS, ...rest };
-    let lastError;
-    // Surface pre-aborted signals before consuming an attempt.
-    if (signal?.aborted) {
-        throw signal.reason ?? new Error('Aborted');
-    }
-    for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {
-        try {
-            return await fn();
-        }
-        catch (error) {
-            lastError = error;
-            // Don't retry if this is the last attempt
-            if (attempt === opts.maxAttempts) {
-                break;
-            }
-            // Don't retry if the error is not retryable
-            if (!isRetryableError(error, opts.retryableErrors)) {
-                // Convert to Error if needed, preserving properties
-                // eslint-disable-next-line no-instanceof/no-instanceof
-                if (error instanceof Error) {
-                    throw 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);
-                }
-                throw wrappedError;
-            }
-            // Abort mid-backoff short-circuits the remaining retries — sleep() rejects
-            // with the signal's reason, which we re-throw so the caller sees the abort
-            // rather than the last retry error.
-            const delay = calculateDelay(attempt, opts.baseDelayMs, opts.maxDelayMs);
-            await (0, sleep_1.sleep)(delay, signal);
-        }
-    }
-    // Ensure we always throw an Error object
-    if (!lastError) {
-        throw new Error('Retry failed without error');
-    }
-    // eslint-disable-next-line no-instanceof/no-instanceof
-    if (lastError instanceof Error) {
-        throw lastError;
-    }
-    // Convert to Error while preserving properties
-    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);
-    }
-    throw wrappedError;
-}
-/**
- * Specialized retry for DynamoDB operations
- */
-async function withDynamoDBRetry(fn, overrides) {
-    return withRetry(fn, {
-        maxAttempts: 5,
-        baseDelayMs: 100,
-        maxDelayMs: 5000,
-        ...overrides,
-    });
-}
-//# sourceMappingURL=retry.js.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,153 +0,0 @@
-/**
- * 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 (`'AES256'` or `'aws:kms'`).
-     * Defaults to `'AES256'` — pass an explicit value to override (e.g. `'aws:kms'`
-     * together with `sseKmsKeyId`).
-     */
-    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.
-     *
-     * 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
-     */
-    private buildLifecycleRuleId;
-    /**
-     * Release underlying S3 client resources
-     */
-    destroy(): void;
-}
-//# sourceMappingURL=s3-offloader.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"s3-offloader.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/s3-offloader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA+BH;;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;;;;OAIG;IACH,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,CAAS;IAC9C,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;IAmB5D;;;;;;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;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}