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

package/dist/checkpointer/types/index.d.ts

@@ -1,232 +0,0 @@
-import type { DynamoDBClientConfig } from '@aws-sdk/client-dynamodb';
-import { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
-import { RunnableConfig } from '@langchain/core/runnables';
-import { Checkpoint, CheckpointMetadata, PendingWrite, SerializerProtocol } from '@langchain/langgraph-checkpoint';
-import type { CompressionConfig, Compressor, S3OffloadConfig, S3Offloader } from '../../shared';
-/**
- * Configuration options for DynamoDBSaver
- *
- * @property checkpointsTableName - Name of the DynamoDB table for storing checkpoints
- * @property writesTableName - Name of the DynamoDB table for storing pending writes
- * @property ttlDays - Optional TTL in days for automatic item expiration (max 1825 days)
- * @property serde - Optional custom serializer protocol for checkpoint serialization
- * @property clientConfig - Optional DynamoDB client configuration
- */
-export interface DynamoDBSaverOptions {
-    checkpointsTableName: string;
-    writesTableName: string;
-    ttlDays?: number;
-    /** TTL in seconds for automatic item expiration (overrides ttlDays if both set) */
-    ttlSeconds?: number;
-    /** Optional compression configuration for checkpoint data */
-    compression?: CompressionConfig;
-    /** Optional S3 offloading for payloads exceeding DynamoDB's 400KB item limit */
-    s3OffloadConfig?: S3OffloadConfig;
-    serde?: SerializerProtocol;
-    clientConfig?: DynamoDBClientConfig;
-    /** Optional pre-built DynamoDBDocument client (takes precedence over clientConfig) */
-    client?: DynamoDBDocument;
-}
-/**
- * Properties for creating a Writer instance
- *
- * @property thread_id - Unique identifier for the conversation thread
- * @property checkpoint_ns - Namespace for checkpoint isolation (default: '')
- * @property checkpoint_id - Unique identifier for the checkpoint
- * @property task_id - Unique identifier for the task that created the write
- * @property idx - Index of the write within the task (0-based)
- * @property channel - Channel name for the write
- * @property type - Type identifier for deserialization
- * @property value - Serialized value as binary data
- */
-export interface WriterProps {
-    thread_id: string;
-    checkpoint_ns: string;
-    checkpoint_id: string;
-    task_id: string;
-    idx: number;
-    channel: string;
-    type: string;
-    value: Uint8Array;
-}
-/**
- * DynamoDB representation of a pending write
- * Uses composite keys for efficient querying
- *
- * @property thread_id_checkpoint_id_checkpoint_ns - Composite partition key (format: "thread_id:::checkpoint_id:::checkpoint_ns")
- * @property task_id_idx - Composite sort key (format: "task_id:::idx")
- * @property channel - Channel name for the write
- * @property type - Type identifier for deserialization
- * @property value - Serialized value as binary data
- */
-export interface DynamoDBWriteItem {
-    thread_id_checkpoint_id_checkpoint_ns: string;
-    task_id_idx: string;
-    channel: string;
-    type: string;
-    value: Uint8Array;
-    /** Optional TTL timestamp for automatic item expiration */
-    ttl?: number;
-    /** S3 key reference when value was offloaded to S3 */
-    s3_value_key?: string;
-}
-/**
- * Sort key prefix for payload items in the checkpoints table.
- * Payload items store the heavy checkpoint blob separately from metadata
- * to reduce RCU consumption on list() queries.
- *
- * UUID checkpoint IDs (hex chars 0-9, a-f) sort before 'PAYLOAD#' in ASCII,
- * so key condition `checkpoint_id < PAYLOAD#` naturally excludes payload items.
- */
-export declare const PAYLOAD_SK_PREFIX = "PAYLOAD#";
-/**
- * DynamoDB representation of a checkpoint metadata item.
- * Stores lightweight metadata; the heavy checkpoint blob lives in a separate payload item.
- *
- * @property thread_id - Unique identifier for the conversation thread (partition key)
- * @property checkpoint_ns - Namespace for checkpoint isolation
- * @property checkpoint_id - Unique identifier for the checkpoint (sort key)
- * @property parent_checkpoint_id - Optional ID of the parent checkpoint for checkpoint chains
- * @property type - Type identifier for deserialization
- * @property metadata - Serialized metadata as binary
- * @property checkpoint - Present only for backward compatibility with legacy single-item format
- */
-export interface CheckpointItem {
-    thread_id: string;
-    checkpoint_ns: string;
-    checkpoint_id: string;
-    parent_checkpoint_id?: string;
-    type: string;
-    metadata: Uint8Array;
-    /** S3 key reference when checkpoint data was offloaded to S3 */
-    s3_checkpoint_key?: string;
-    /** S3 key reference when metadata was offloaded to S3 */
-    s3_metadata_key?: string;
-    /**
-     * Legacy field: present only on old single-item checkpoint items.
-     * New items store the checkpoint blob in a separate payload item.
-     */
-    checkpoint?: Uint8Array;
-}
-/**
- * DynamoDB representation of a checkpoint payload item.
- * Contains only the heavy serialized checkpoint blob.
- *
- * @property thread_id - Partition key (same as metadata item)
- * @property checkpoint_id - Sort key with PAYLOAD# prefix
- * @property checkpoint - Serialized checkpoint data as binary
- */
-export interface CheckpointPayloadItem {
-    thread_id: string;
-    checkpoint_id: string;
-    checkpoint: Uint8Array;
-}
-/**
- * Validated configurable parameters from RunnableConfig
- *
- * @property thread_id - Validated unique identifier for the conversation thread
- * @property checkpoint_ns - Validated namespace for checkpoint isolation (empty string if not provided)
- * @property checkpoint_id - Optional validated checkpoint identifier
- */
-export interface ValidatedConfigurable {
-    thread_id: string;
-    checkpoint_ns: string;
-    checkpoint_id: string | undefined;
-}
-/**
- * Parameters for deleteThread action
- *
- * @property client - DynamoDB Document client instance
- * @property checkpointsTableName - Name of the checkpoints table
- * @property writesTableName - Name of the pending writes table
- * @property threadId - Thread identifier to delete
- */
-export interface DeleteThreadActionParams {
-    client: DynamoDBDocument;
-    checkpointsTableName: string;
-    writesTableName: string;
-    threadId: string;
-    /** Optional S3 offloader for cleaning up offloaded payloads */
-    s3Offloader?: S3Offloader;
-    /** Optional AbortSignal for cancelling in-flight retries */
-    signal?: AbortSignal;
-}
-/**
- * Parameters for getTuple action
- *
- * @property client - DynamoDB Document client instance
- * @property checkpointsTableName - Name of the checkpoints table
- * @property writesTableName - Name of the pending writes table
- * @property serde - Serialization protocol for checkpoint data
- * @property config - Runnable configuration with thread_id and optional checkpoint_id
- */
-export interface GetTupleActionParams {
-    client: DynamoDBDocument;
-    checkpointsTableName: string;
-    writesTableName: string;
-    serde: SerializerProtocol;
-    config: RunnableConfig;
-    /** Optional compressor for decompressing checkpoint data */
-    compressor?: Compressor;
-    /** Optional S3 offloader for downloading offloaded payloads */
-    s3Offloader?: S3Offloader;
-    /** Optional AbortSignal for cancelling in-flight retries */
-    signal?: AbortSignal;
-}
-/**
- * Parameters for put action
- *
- * @property client - DynamoDB Document client instance
- * @property checkpointsTableName - Name of the checkpoints table
- * @property serde - Serialization protocol for checkpoint data
- * @property config - Runnable configuration with thread_id and namespace
- * @property checkpoint - Checkpoint data to save
- * @property metadata - Checkpoint metadata to save
- * @property ttlDays - Optional TTL in days for automatic expiration (max 1825 days)
- */
-export interface PutActionParams {
-    client: DynamoDBDocument;
-    checkpointsTableName: string;
-    serde: SerializerProtocol;
-    config: RunnableConfig;
-    checkpoint: Checkpoint;
-    metadata: CheckpointMetadata;
-    ttlDays?: number;
-    /** TTL in seconds (overrides ttlDays if both set) */
-    ttlSeconds?: number;
-    /** Optional compressor for compressing checkpoint data */
-    compressor?: Compressor;
-    /** Optional S3 offloader for large payloads */
-    s3Offloader?: S3Offloader;
-    /** Optional AbortSignal for cancelling in-flight retries */
-    signal?: AbortSignal;
-}
-/**
- * Parameters for putWrites action
- *
- * @property client - DynamoDB Document client instance
- * @property writesTableName - Name of the pending writes table
- * @property serde - Serialization protocol for write data
- * @property config - Runnable configuration with thread_id, checkpoint_id, and namespace
- * @property writes - Array of pending writes to save (max 1000 items)
- * @property taskId - Task identifier that created these writes
- * @property ttlDays - Optional TTL in days for automatic expiration (max 1825 days)
- */
-export interface PutWritesActionParams {
-    client: DynamoDBDocument;
-    writesTableName: string;
-    serde: SerializerProtocol;
-    config: RunnableConfig;
-    writes: PendingWrite[];
-    taskId: string;
-    ttlDays?: number;
-    /** TTL in seconds (overrides ttlDays if both set) */
-    ttlSeconds?: number;
-    /** Optional compressor for compressing write data */
-    compressor?: Compressor;
-    /** Optional S3 offloader for large write payloads */
-    s3Offloader?: S3Offloader;
-    /** Optional AbortSignal for cancelling in-flight retries */
-    signal?: AbortSignal;
-}
-//# sourceMappingURL=index.d.ts.map

package/dist/checkpointer/types/index.d.ts.map

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

package/dist/checkpointer/types/index.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PAYLOAD_SK_PREFIX = void 0;
-/**
- * Sort key prefix for payload items in the checkpoints table.
- * Payload items store the heavy checkpoint blob separately from metadata
- * to reduce RCU consumption on list() queries.
- *
- * UUID checkpoint IDs (hex chars 0-9, a-f) sort before 'PAYLOAD#' in ASCII,
- * so key condition `checkpoint_id < PAYLOAD#` naturally excludes payload items.
- */
-exports.PAYLOAD_SK_PREFIX = 'PAYLOAD#';
-//# sourceMappingURL=index.js.map

package/dist/checkpointer/types/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/checkpointer/types/index.ts"],"names":[],"mappings":";;;AAkFA;;;;;;;GAOG;AACU,QAAA,iBAAiB,GAAG,UAAU,CAAC"}

package/dist/checkpointer/utils/deserialization.d.ts

@@ -1,20 +0,0 @@
-/**
- * Checkpoint deserialization utilities
- * Provides centralized checkpoint tuple conversion
- */
-import type { CheckpointTuple, SerializerProtocol } from '@langchain/langgraph-checkpoint';
-import type { Compressor, S3Offloader } from '../../shared';
-import type { CheckpointItem } from '../types';
-/**
- * Deserialize a DynamoDB checkpoint metadata item into a CheckpointTuple.
- * The heavy checkpoint blob is provided separately (from a payload item or S3).
- *
- * @param item - DynamoDB checkpoint metadata item
- * @param checkpointData - Raw checkpoint blob (from payload item, S3, or legacy inline field)
- * @param serde - Serializer protocol for deserialization
- * @param compressor - Optional compressor for decompression (auto-detects gzip)
- * @param s3Offloader - Optional S3 offloader for downloading offloaded metadata
- * @returns CheckpointTuple with deserialized checkpoint and metadata
- */
-export declare function deserializeCheckpointTuple(item: CheckpointItem, checkpointData: Uint8Array, serde: SerializerProtocol, compressor?: Compressor, s3Offloader?: S3Offloader): Promise<CheckpointTuple>;
-//# sourceMappingURL=deserialization.d.ts.map

package/dist/checkpointer/utils/deserialization.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"deserialization.d.ts","sourceRoot":"","sources":["../../../src/checkpointer/utils/deserialization.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAGV,eAAe,EACf,kBAAkB,EACnB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,cAAc,EACpB,cAAc,EAAE,UAAU,EAC1B,KAAK,EAAE,kBAAkB,EACzB,UAAU,CAAC,EAAE,UAAU,EACvB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,eAAe,CAAC,CAqE1B"}

package/dist/checkpointer/utils/deserialization.js

@@ -1,81 +0,0 @@
-"use strict";
-/**
- * Checkpoint deserialization utilities
- * Provides centralized checkpoint tuple conversion
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.deserializeCheckpointTuple = deserializeCheckpointTuple;
-/**
- * Deserialize a DynamoDB checkpoint metadata item into a CheckpointTuple.
- * The heavy checkpoint blob is provided separately (from a payload item or S3).
- *
- * @param item - DynamoDB checkpoint metadata item
- * @param checkpointData - Raw checkpoint blob (from payload item, S3, or legacy inline field)
- * @param serde - Serializer protocol for deserialization
- * @param compressor - Optional compressor for decompression (auto-detects gzip)
- * @param s3Offloader - Optional S3 offloader for downloading offloaded metadata
- * @returns CheckpointTuple with deserialized checkpoint and metadata
- */
-async function deserializeCheckpointTuple(item, checkpointData, serde, compressor, s3Offloader) {
-    // Download checkpoint from S3 if offloaded (checked first to maintain original S3 call order)
-    let rawCheckpoint = checkpointData;
-    if (item.s3_checkpoint_key) {
-        if (!s3Offloader) {
-            throw new Error(`Checkpoint references S3 key '${item.s3_checkpoint_key}' but no S3 offloader is configured. ` +
-                `Pass s3OffloadConfig when constructing DynamoDBSaver to read offloaded checkpoints.`);
-        }
-        rawCheckpoint = await s3Offloader.download(item.s3_checkpoint_key);
-    }
-    // Download metadata from S3 if offloaded, otherwise use DynamoDB data
-    let rawMetadata = item.metadata;
-    if (item.s3_metadata_key) {
-        if (!s3Offloader) {
-            throw new Error(`Checkpoint metadata references S3 key '${item.s3_metadata_key}' but no S3 offloader is configured. ` +
-                `Pass s3OffloadConfig when constructing DynamoDBSaver to read offloaded metadata.`);
-        }
-        rawMetadata = await s3Offloader.download(item.s3_metadata_key);
-    }
-    const decompressedCheckpoint = compressor
-        ? await compressor.decompress(rawCheckpoint)
-        : rawCheckpoint;
-    const decompressedMetadata = compressor ? await compressor.decompress(rawMetadata) : rawMetadata;
-    // Deserialization failures are the canonical signal of data corruption, a broken
-    // serializer, or a mismatched library version. Bare serde errors are opaque
-    // ("unexpected token") — re-throw with thread/checkpoint context so production
-    // incidents are diagnosable from a single log line.
-    const checkpoint = await loadWithContext(serde, item.type, decompressedCheckpoint, 'checkpoint', item);
-    const metadata = await loadWithContext(serde, item.type, decompressedMetadata, 'metadata', item);
-    return {
-        config: {
-            configurable: {
-                thread_id: item.thread_id,
-                checkpoint_ns: item.checkpoint_ns,
-                checkpoint_id: item.checkpoint_id,
-            },
-        },
-        checkpoint,
-        metadata,
-        parentConfig: item.parent_checkpoint_id
-            ? {
-                configurable: {
-                    thread_id: item.thread_id,
-                    checkpoint_ns: item.checkpoint_ns,
-                    checkpoint_id: item.parent_checkpoint_id,
-                },
-            }
-            : undefined,
-    };
-}
-async function loadWithContext(serde, type, data, field, item) {
-    try {
-        return (await serde.loadsTyped(type, data));
-    }
-    catch (err) {
-        const message = err && typeof err === 'object' && 'message' in err
-            ? String(err.message)
-            : String(err);
-        throw new Error(`Failed to deserialize ${field} for thread_id=${item.thread_id}, ` +
-            `checkpoint_id=${item.checkpoint_id}, type=${type}: ${message}`, { cause: err });
-    }
-}
-//# sourceMappingURL=deserialization.js.map

package/dist/checkpointer/utils/deserialization.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"deserialization.js","sourceRoot":"","sources":["../../../src/checkpointer/utils/deserialization.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAuBH,gEA2EC;AAtFD;;;;;;;;;;GAUG;AACI,KAAK,UAAU,0BAA0B,CAC9C,IAAoB,EACpB,cAA0B,EAC1B,KAAyB,EACzB,UAAuB,EACvB,WAAyB;IAEzB,8FAA8F;IAC9F,IAAI,aAAa,GAAe,cAAc,CAAC;IAC/C,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,CAAC,iBAAiB,uCAAuC;gBAC5F,qFAAqF,CACxF,CAAC;QACJ,CAAC;QACD,aAAa,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACrE,CAAC;IAED,sEAAsE;IACtE,IAAI,WAAW,GAAe,IAAI,CAAC,QAAQ,CAAC;IAC5C,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,0CAA0C,IAAI,CAAC,eAAe,uCAAuC;gBACnG,kFAAkF,CACrF,CAAC;QACJ,CAAC;QACD,WAAW,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,sBAAsB,GAAG,UAAU;QACvC,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,aAAa,CAAC;QAC5C,CAAC,CAAC,aAAa,CAAC;IAClB,MAAM,oBAAoB,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IAEjG,iFAAiF;IACjF,4EAA4E;IAC5E,+EAA+E;IAC/E,oDAAoD;IACpD,MAAM,UAAU,GAAG,MAAM,eAAe,CACtC,KAAK,EACL,IAAI,CAAC,IAAI,EACT,sBAAsB,EACtB,YAAY,EACZ,IAAI,CACL,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,eAAe,CACpC,KAAK,EACL,IAAI,CAAC,IAAI,EACT,oBAAoB,EACpB,UAAU,EACV,IAAI,CACL,CAAC;IAEF,OAAO;QACL,MAAM,EAAE;YACN,YAAY,EAAE;gBACZ,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC;SACF;QACD,UAAU;QACV,QAAQ;QACR,YAAY,EAAE,IAAI,CAAC,oBAAoB;YACrC,CAAC,CAAC;gBACE,YAAY,EAAE;oBACZ,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,aAAa,EAAE,IAAI,CAAC,aAAa;oBACjC,aAAa,EAAE,IAAI,CAAC,oBAAoB;iBACzC;aACF;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,KAAyB,EACzB,IAAY,EACZ,IAAgB,EAChB,KAAgC,EAChC,IAAoB;IAEpB,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAM,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GACX,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG;YAChD,CAAC,CAAC,MAAM,CAAE,GAA4B,CAAC,OAAO,CAAC;YAC/C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,yBAAyB,KAAK,kBAAkB,IAAI,CAAC,SAAS,IAAI;YAChE,iBAAiB,IAAI,CAAC,aAAa,UAAU,IAAI,KAAK,OAAO,EAAE,EACjE,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -1,7 +0,0 @@
-/**
- * Checkpointer utilities
- */
-export * from './validation';
-export * from './deserialization';
-export { withDynamoDBRetry, withRetry, type RetryOptions } from '../../shared/utils';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/checkpointer/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/checkpointer/utils/index.js

@@ -1,27 +0,0 @@
-"use strict";
-/**
- * Checkpointer utilities
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-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 });
-exports.withRetry = exports.withDynamoDBRetry = void 0;
-__exportStar(require("./validation"), exports);
-__exportStar(require("./deserialization"), exports);
-// Retry utilities re-exported from shared
-var utils_1 = require("../../shared/utils");
-Object.defineProperty(exports, "withDynamoDBRetry", { enumerable: true, get: function () { return utils_1.withDynamoDBRetry; } });
-Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return utils_1.withRetry; } });
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/checkpointer/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,oDAAkC;AAClC,0CAA0C;AAC1C,4CAAqF;AAA5E,0GAAA,iBAAiB,OAAA;AAAE,kGAAA,SAAS,OAAA"}

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

@@ -1,48 +0,0 @@
-/**
- * Validation utilities for checkpointer operations
- */
-export declare class CheckpointerValidationError extends Error {
-    constructor(message: string);
-}
-/**
- * Validate thread ID
- */
-export declare function validateThreadId(threadId: unknown): asserts threadId is string;
-/**
- * Validate checkpoint ID
- */
-export declare function validateCheckpointId(checkpointId: unknown, required?: boolean): void;
-/**
- * Validate checkpoint namespace
- */
-export declare function validateCheckpointNs(checkpointNs: unknown): void;
-/**
- * Validate task ID
- */
-export declare function validateTaskId(taskId: unknown): asserts taskId is string;
-/**
- * Validate channel name
- */
-export declare function validateChannel(channel: unknown): asserts channel is string;
-/**
- * Validate writes array length
- */
-export declare function validateWritesCount(writesCount: unknown): void;
-/**
- * Validate list limit parameter
- */
-export declare function validateListLimit(limit: unknown): void;
-/**
- * Validate TTL days (wraps shared validation with a checkpointer-specific error type)
- */
-export declare function validateTTLDays(ttlDays: number | undefined): void;
-/**
- * Export constants for use in other modules
- */
-export declare const CheckpointerValidationConstants: {
-    readonly MAX_DELETE_BATCH_SIZE: 100000;
-    readonly MAX_WRITES_PER_BATCH: 1000;
-    readonly MAX_LIST_LIMIT: 1000;
-    readonly SEPARATOR: ":::";
-};
-//# sourceMappingURL=validation.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/checkpointer/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqBH,qBAAa,2BAA4B,SAAQ,KAAK;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAyB9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,GAAE,OAAe,GAAG,IAAI,CA+D3F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,OAAO,GAAG,IAAI,CAyBhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAyBxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAoB3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,CAc9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAgBtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOjE;AAED;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;;CAKlC,CAAC"}