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

package/dist/shared/options.d.ts

@@ -0,0 +1,32 @@
+import type { DynamoDBClient, DynamoDBClientConfig } from '@aws-sdk/client-dynamodb';
+import type { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
+import type { CompressionConfig } from './codec/compression';
+import type { S3OffloadConfig } from './codec/s3/config';
+import type { Logger } from './logging/logger';
+import type { TtlOption } from './validation/ttl';
+/**
+ * Options common to every adapter (the unified options shape). An adapter
+ * either reuses an injected `client` or builds one from `clientConfig`.
+ */
+export interface BaseAdapterOptions {
+    /** DynamoDB table name. */
+    tableName: string;
+    /** Pre-built DocumentClient to reuse; when set, the adapter does not own it. */
+    client?: DynamoDBDocument;
+    /** Config used to build a client when `client` is not provided. */
+    clientConfig?: DynamoDBClientConfig;
+    /** Factory seam for constructing the underlying client (testing). */
+    createClient?: (config: DynamoDBClientConfig) => DynamoDBClient;
+    /** Optional time-to-live applied to written items. */
+    ttl?: TtlOption;
+    /** Optional per-instance logger (defaults to a silent logger). */
+    logger?: Logger;
+}
+/** Options enabling payload compression and/or S3 offloading. */
+export interface CodecOptions {
+    /** Gzip compression configuration. */
+    compression?: CompressionConfig;
+    /** S3 offload configuration for payloads over DynamoDB's item limit. */
+    s3?: S3OffloadConfig;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/shared/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/shared/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,mEAAmE;IACnE,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,qEAAqE;IACrE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,cAAc,CAAC;IAChE,sDAAsD;IACtD,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,wEAAwE;IACxE,EAAE,CAAC,EAAE,eAAe,CAAC;CACtB"}

package/dist/shared/options.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=options.js.map

package/dist/shared/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/shared/options.ts"],"names":[],"mappings":""}

package/dist/shared/ulid.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Build a monotonic ULID generator: lexicographically sortable 26-char ids
+ * whose first 10 chars encode the millisecond timestamp. Ids strictly increase
+ * even when the clock regresses or the same-millisecond random space overflows:
+ * any non-advancing clock reuses the last timestamp and increments the random
+ * component, carrying into the timestamp on overflow. `now`/`rng` are seams for
+ * deterministic tests.
+ */
+export declare function createUlidFactory(now?: () => number, rng?: () => number): () => string;
+//# sourceMappingURL=ulid.d.ts.map

package/dist/shared/ulid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ulid.d.ts","sourceRoot":"","sources":["../../src/shared/ulid.ts"],"names":[],"mappings":"AAyCA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,GAAE,MAAM,MAAiB,EAC5B,GAAG,GAAE,MAAM,MAAoB,GAC9B,MAAM,MAAM,CAmBd"}

package/dist/shared/ulid.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUlidFactory = createUlidFactory;
+const ENCODING = '0123456789ABCDEFGHJKMNPQRSTVWXYZ';
+const ENCODING_LEN = 32;
+const TIME_CHARS = 10;
+const RANDOM_CHARS = 16;
+function encodeTime(timeMs) {
+    let remaining = Math.floor(timeMs);
+    let out = '';
+    for (let i = 0; i < TIME_CHARS; i++) {
+        out = ENCODING[remaining % ENCODING_LEN] + out;
+        remaining = Math.floor(remaining / ENCODING_LEN);
+    }
+    return out;
+}
+function randomDigits(rng) {
+    const digits = [];
+    for (let i = 0; i < RANDOM_CHARS; i++) {
+        digits.push(Math.floor(rng() * ENCODING_LEN));
+    }
+    return digits;
+}
+function incrementDigits(digits) {
+    const next = [...digits];
+    for (let i = RANDOM_CHARS - 1; i >= 0; i--) {
+        if (next[i] < ENCODING_LEN - 1) {
+            next[i] += 1;
+            return { digits: next, overflowed: false };
+        }
+        next[i] = 0;
+    }
+    return { digits: next, overflowed: true };
+}
+/**
+ * Build a monotonic ULID generator: lexicographically sortable 26-char ids
+ * whose first 10 chars encode the millisecond timestamp. Ids strictly increase
+ * even when the clock regresses or the same-millisecond random space overflows:
+ * any non-advancing clock reuses the last timestamp and increments the random
+ * component, carrying into the timestamp on overflow. `now`/`rng` are seams for
+ * deterministic tests.
+ */
+function createUlidFactory(now = Date.now, rng = Math.random) {
+    let lastTime = -1;
+    let lastRandom = [];
+    return () => {
+        const time = now();
+        if (time > lastTime) {
+            lastTime = time;
+            lastRandom = randomDigits(rng);
+        }
+        else {
+            const result = incrementDigits(lastRandom);
+            if (result.overflowed) {
+                lastTime += 1;
+                lastRandom = randomDigits(rng);
+            }
+            else {
+                lastRandom = result.digits;
+            }
+        }
+        return encodeTime(lastTime) + lastRandom.map((digit) => ENCODING[digit]).join('');
+    };
+}
+//# sourceMappingURL=ulid.js.map

package/dist/shared/ulid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ulid.js","sourceRoot":"","sources":["../../src/shared/ulid.ts"],"names":[],"mappings":";;AAiDA,8CAsBC;AAvED,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AACpD,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,SAAS,UAAU,CAAC,MAAc;IAChC,IAAI,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,GAAG,GAAG,QAAQ,CAAC,SAAS,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC;QAC/C,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,YAAY,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,GAAiB;IACrC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAQD,SAAS,eAAe,CAAC,MAAgB;IACvC,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,YAAY,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACb,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAC/B,MAAoB,IAAI,CAAC,GAAG,EAC5B,MAAoB,IAAI,CAAC,MAAM;IAE/B,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClB,IAAI,UAAU,GAAa,EAAE,CAAC;IAC9B,OAAO,GAAG,EAAE;QACV,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC;QACnB,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YACpB,QAAQ,GAAG,IAAI,CAAC;YAChB,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;YAC3C,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,QAAQ,IAAI,CAAC,CAAC;gBACd,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;YAC7B,CAAC;QACH,CAAC;QACD,OAAO,UAAU,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC,CAAC;AACJ,CAAC"}

package/dist/shared/validation/primitives.d.ts

@@ -0,0 +1,17 @@
+import type { Redactable } from '../logging/redaction';
+/** Throw {@link ValidationError} unless `value` is a non-empty string. */
+export declare function validateNonEmptyString(value: string, field: string): void;
+/** Throw {@link ValidationError} unless `value` is an integer within bounds. */
+export declare function validateInteger(value: number, field: string, bounds?: {
+    min?: number;
+    max?: number;
+}): void;
+/** Throw {@link ValidationError} unless `value` is a non-empty array. */
+export declare function validateNonEmptyArray<T>(value: T[], field: string): void;
+/** Throw {@link ValidationError} if `value` contains an ASCII control character. */
+export declare function assertNoControlChars(value: string, field: string): void;
+/** Throw {@link ValidationError} if `value` contains the reserved `separator`. */
+export declare function assertNoSeparator(value: string, separator: string, field: string): void;
+/** Throw {@link ValidationError} if nested-array depth exceeds `maxDepth`. */
+export declare function validateArrayMaxDepth(value: Redactable[], field: string, maxDepth: number): void;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/shared/validation/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/shared/validation/primitives.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIzE;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1C,IAAI,CAUN;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxE;AAaD,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIvE;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOvF;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAahG"}

package/dist/shared/validation/primitives.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateNonEmptyString = validateNonEmptyString;
+exports.validateInteger = validateInteger;
+exports.validateNonEmptyArray = validateNonEmptyArray;
+exports.assertNoControlChars = assertNoControlChars;
+exports.assertNoSeparator = assertNoSeparator;
+exports.validateArrayMaxDepth = validateArrayMaxDepth;
+const errors_1 = require("../errors/errors");
+/** Throw {@link ValidationError} unless `value` is a non-empty string. */
+function validateNonEmptyString(value, field) {
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new errors_1.ValidationError(`${field} must be a non-empty string`, field);
+    }
+}
+/** Throw {@link ValidationError} unless `value` is an integer within bounds. */
+function validateInteger(value, field, bounds = {}) {
+    if (typeof value !== 'number' || !Number.isInteger(value)) {
+        throw new errors_1.ValidationError(`${field} must be an integer`, field);
+    }
+    if (bounds.min !== undefined && value < bounds.min) {
+        throw new errors_1.ValidationError(`${field} must be >= ${bounds.min}`, field);
+    }
+    if (bounds.max !== undefined && value > bounds.max) {
+        throw new errors_1.ValidationError(`${field} must be <= ${bounds.max}`, field);
+    }
+}
+/** Throw {@link ValidationError} unless `value` is a non-empty array. */
+function validateNonEmptyArray(value, field) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new errors_1.ValidationError(`${field} must be a non-empty array`, field);
+    }
+}
+/** Return `true` if `value` contains any ASCII control character. */
+function hasControlChar(value) {
+    for (let i = 0; i < value.length; i++) {
+        const code = value.charCodeAt(i);
+        if (code <= 0x1f || code === 0x7f) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Throw {@link ValidationError} if `value` contains an ASCII control character. */
+function assertNoControlChars(value, field) {
+    if (hasControlChar(value)) {
+        throw new errors_1.ValidationError(`${field} must not contain control characters`, field);
+    }
+}
+/** Throw {@link ValidationError} if `value` contains the reserved `separator`. */
+function assertNoSeparator(value, separator, field) {
+    if (value.includes(separator)) {
+        throw new errors_1.ValidationError(`${field} must not contain the reserved "${separator}" separator`, field);
+    }
+}
+/** Throw {@link ValidationError} if nested-array depth exceeds `maxDepth`. */
+function validateArrayMaxDepth(value, field, maxDepth) {
+    const depthOf = (node, depth) => {
+        if (!Array.isArray(node)) {
+            return depth;
+        }
+        if (depth > maxDepth) {
+            return depth;
+        }
+        return node.reduce((max, child) => Math.max(max, depthOf(child, depth + 1)), depth);
+    };
+    if (depthOf(value, 0) > maxDepth) {
+        throw new errors_1.ValidationError(`${field} exceeds maximum array depth of ${maxDepth}`, field);
+    }
+}
+//# sourceMappingURL=primitives.js.map

package/dist/shared/validation/primitives.js.map

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

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

@@ -0,0 +1,16 @@
+/** Time-to-live expressed in whole days or whole seconds. */
+export type TtlOption = {
+    days: number;
+} | {
+    seconds: number;
+};
+/** Validate a {@link TtlOption} and resolve it to a positive number of seconds. */
+export declare function resolveTtlSeconds(ttl: TtlOption): number;
+/**
+ * Resolve a {@link TtlOption} into a DynamoDB TTL attribute value: the Unix
+ * epoch (seconds) at which the item expires.
+ *
+ * @param now - Clock seam returning epoch milliseconds. Defaults to `Date.now`.
+ */
+export declare function calculateTtlTimestamp(ttl: TtlOption, now?: () => number): number;
+//# sourceMappingURL=ttl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../../src/shared/validation/ttl.ts"],"names":[],"mappings":"AAKA,6DAA6D;AAC7D,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAOxD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,GAAE,MAAM,MAAiB,GAAG,MAAM,CAE1F"}

package/dist/shared/validation/ttl.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTtlSeconds = resolveTtlSeconds;
+exports.calculateTtlTimestamp = calculateTtlTimestamp;
+const constants_1 = require("../constants");
+const primitives_1 = require("./primitives");
+const SECONDS_PER_DAY = 24 * 60 * 60;
+/** Validate a {@link TtlOption} and resolve it to a positive number of seconds. */
+function resolveTtlSeconds(ttl) {
+    if ('days' in ttl) {
+        (0, primitives_1.validateInteger)(ttl.days, 'ttl.days', { min: 1, max: constants_1.MAX_TTL_DAYS });
+        return ttl.days * SECONDS_PER_DAY;
+    }
+    (0, primitives_1.validateInteger)(ttl.seconds, 'ttl.seconds', { min: 1, max: constants_1.MAX_TTL_SECONDS });
+    return ttl.seconds;
+}
+/**
+ * Resolve a {@link TtlOption} into a DynamoDB TTL attribute value: the Unix
+ * epoch (seconds) at which the item expires.
+ *
+ * @param now - Clock seam returning epoch milliseconds. Defaults to `Date.now`.
+ */
+function calculateTtlTimestamp(ttl, now = Date.now) {
+    return Math.floor(now() / 1000) + resolveTtlSeconds(ttl);
+}
+//# sourceMappingURL=ttl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.js","sourceRoot":"","sources":["../../../src/shared/validation/ttl.ts"],"names":[],"mappings":";;AASA,8CAOC;AAQD,sDAEC;AA1BD,4CAA6D;AAC7D,6CAA+C;AAE/C,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAKrC,mFAAmF;AACnF,SAAgB,iBAAiB,CAAC,GAAc;IAC9C,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClB,IAAA,4BAAe,EAAC,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,wBAAY,EAAE,CAAC,CAAC;QACrE,OAAO,GAAG,CAAC,IAAI,GAAG,eAAe,CAAC;IACpC,CAAC;IACD,IAAA,4BAAe,EAAC,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,2BAAe,EAAE,CAAC,CAAC;IAC9E,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,GAAc,EAAE,MAAoB,IAAI,CAAC,GAAG;IAChF,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { Item } from '@langchain/langgraph-checkpoint';
+import type { StoreContext } from '../internal/setup';
+/** Retrieve a single item by namespace and key (strongly consistent), or null. */
+export declare function getItem(context: StoreContext, namespace: string[], key: string): Promise<Item | null>;
+//# sourceMappingURL=get.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/store/actions/get.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAK5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,kFAAkF;AAClF,wBAAsB,OAAO,CAC3B,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,EAAE,EACnB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAYtB"}

package/dist/store/actions/get.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getItem = getItem;
+const retry_1 = require("../../shared/dynamodb/retry");
+const item_mapper_1 = require("../internal/item-mapper");
+const keys_1 = require("../internal/keys");
+const validation_1 = require("../internal/validation");
+/** Retrieve a single item by namespace and key (strongly consistent), or null. */
+async function getItem(context, namespace, key) {
+    (0, validation_1.validateNamespace)(namespace);
+    (0, validation_1.validateKey)(key);
+    const result = await (0, retry_1.withDynamoDBRetry)(() => context.client.get({
+        TableName: context.tableName,
+        Key: { PK: (0, keys_1.partitionKey)(namespace), SK: (0, keys_1.sortKey)(namespace, key) },
+        ConsistentRead: true,
+    }));
+    if (!result.Item)
+        return null;
+    return (0, item_mapper_1.readStoreItem)(context, result.Item);
+}
+//# sourceMappingURL=get.js.map

package/dist/store/actions/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/store/actions/get.ts"],"names":[],"mappings":";;AAUA,0BAgBC;AAxBD,uDAAgE;AAChE,yDAAwD;AACxD,2CAAyD;AAEzD,uDAAwE;AAGxE,kFAAkF;AAC3E,KAAK,UAAU,OAAO,CAC3B,OAAqB,EACrB,SAAmB,EACnB,GAAW;IAEX,IAAA,8BAAiB,EAAC,SAAS,CAAC,CAAC;IAC7B,IAAA,wBAAW,EAAC,GAAG,CAAC,CAAC;IACjB,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAiB,EAAC,GAAG,EAAE,CAC1C,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,EAAE,EAAE,EAAE,EAAE,IAAA,mBAAY,EAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAA,cAAO,EAAC,SAAS,EAAE,GAAG,CAAC,EAAE;QACjE,cAAc,EAAE,IAAI;KACrB,CAAC,CACH,CAAC;IACF,IAAI,CAAC,MAAM,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,IAAA,2BAAa,EAAC,OAAO,EAAE,MAAM,CAAC,IAAuB,CAAC,CAAC;AAChE,CAAC"}

package/dist/store/actions/list-namespaces.d.ts

@@ -0,0 +1,9 @@
+import type { ListNamespacesOperation } from '@langchain/langgraph-checkpoint';
+import type { StoreContext } from '../internal/setup';
+/**
+ * List distinct namespaces (truncated to `maxDepth`) that satisfy every match
+ * condition, sorted, with offset/limit applied. A concrete prefix root scopes
+ * the read to a native Query; otherwise it falls back to a filtered Scan.
+ */
+export declare function listNamespaces(context: StoreContext, op: ListNamespacesOperation): Promise<string[][]>;
+//# sourceMappingURL=list-namespaces.d.ts.map

package/dist/store/actions/list-namespaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-namespaces.d.ts","sourceRoot":"","sources":["../../../src/store/actions/list-namespaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAQ/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWtD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EACrB,EAAE,EAAE,uBAAuB,GAC1B,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAsBrB"}

package/dist/store/actions/list-namespaces.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listNamespaces = listNamespaces;
+const paginate_1 = require("../../shared/dynamodb/paginate");
+const scan_1 = require("../../shared/dynamodb/scan");
+const item_mapper_1 = require("../internal/item-mapper");
+const keys_1 = require("../internal/keys");
+const namespace_match_1 = require("../internal/namespace-match");
+const query_1 = require("../internal/query");
+const validation_1 = require("../internal/validation");
+function namespaceSource(context, op) {
+    const root = (0, namespace_match_1.prefixRoot)(op.matchConditions);
+    if (root.length > 0) {
+        return (0, paginate_1.paginateQuery)({ client: context.client, params: (0, query_1.scopedQuery)(context.tableName, root) });
+    }
+    return (0, scan_1.paginateScan)({ client: context.client, params: (0, query_1.storeScan)(context.tableName) });
+}
+/**
+ * List distinct namespaces (truncated to `maxDepth`) that satisfy every match
+ * condition, sorted, with offset/limit applied. A concrete prefix root scopes
+ * the read to a native Query; otherwise it falls back to a filtered Scan.
+ */
+async function listNamespaces(context, op) {
+    (0, validation_1.validatePaging)(op.offset, op.limit);
+    const seen = new Set();
+    const namespaces = [];
+    for await (const raw of namespaceSource(context, op)) {
+        const record = (0, item_mapper_1.narrowStoreRecord)(raw);
+        if (!record)
+            continue;
+        const namespace = record.namespace;
+        if (op.matchConditions &&
+            !op.matchConditions.every((condition) => (0, namespace_match_1.matchNamespace)(namespace, condition))) {
+            continue;
+        }
+        const truncated = (0, namespace_match_1.truncateDepth)(namespace, op.maxDepth);
+        const dedupeKey = truncated.join(keys_1.NAMESPACE_SEPARATOR);
+        if (seen.has(dedupeKey))
+            continue;
+        seen.add(dedupeKey);
+        namespaces.push(truncated);
+    }
+    namespaces.sort((a, b) => a.join(keys_1.NAMESPACE_SEPARATOR).localeCompare(b.join(keys_1.NAMESPACE_SEPARATOR)));
+    return namespaces.slice(op.offset, op.offset + op.limit);
+}
+//# sourceMappingURL=list-namespaces.js.map

package/dist/store/actions/list-namespaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-namespaces.js","sourceRoot":"","sources":["../../../src/store/actions/list-namespaces.ts"],"names":[],"mappings":";;AAwBA,wCAyBC;AA/CD,6DAA+D;AAC/D,qDAA0D;AAC1D,yDAA4D;AAC5D,2CAAuD;AACvD,iEAAwF;AACxF,6CAA2D;AAE3D,uDAAwD;AAExD,SAAS,eAAe,CAAC,OAAqB,EAAE,EAA2B;IACzE,MAAM,IAAI,GAAG,IAAA,4BAAU,EAAC,EAAE,CAAC,eAAe,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,IAAA,wBAAa,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAA,mBAAW,EAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,IAAA,mBAAY,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAA,iBAAS,EAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AACxF,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAClC,OAAqB,EACrB,EAA2B;IAE3B,IAAA,2BAAc,EAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,UAAU,GAAe,EAAE,CAAC;IAClC,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,IAAA,+BAAiB,EAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,IACE,EAAE,CAAC,eAAe;YAClB,CAAC,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAA,gCAAc,EAAC,SAAS,EAAE,SAAS,CAAC,CAAC,EAC9E,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,IAAA,+BAAa,EAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,0BAAmB,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,SAAS;QAClC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpB,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IACD,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,0BAAmB,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,0BAAmB,CAAC,CAAC,CAAC,CAAC;IAClG,OAAO,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC"}

package/dist/store/actions/put.d.ts

@@ -0,0 +1,11 @@
+import type { PutOperation } from '@langchain/langgraph-checkpoint';
+import type { StoreContext } from '../internal/setup';
+/**
+ * Store, update, or delete an item. A null value deletes; otherwise the value
+ * is encoded (with optional compression/S3 offload), `createdAt` is preserved
+ * across updates, and an embedding is computed when indexing is enabled. When a
+ * `vectorBackend` is configured the embedding is sent there (and not stored on
+ * the item); DynamoDB always holds the canonical item.
+ */
+export declare function putItem(context: StoreContext, op: PutOperation): Promise<void>;
+//# sourceMappingURL=put.d.ts.map

package/dist/store/actions/put.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"put.d.ts","sourceRoot":"","sources":["../../../src/store/actions/put.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAYpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAiEtD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBpF"}

package/dist/store/actions/put.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.putItem = putItem;
+const clock_1 = require("../../shared/clock");
+const descriptor_keys_1 = require("../../shared/codec/descriptor-keys");
+const orphans_1 = require("../../shared/codec/s3/orphans");
+const retry_1 = require("../../shared/dynamodb/retry");
+const ttl_1 = require("../../shared/validation/ttl");
+const index_sync_1 = require("../internal/index-sync");
+const item_mapper_1 = require("../internal/item-mapper");
+const keys_1 = require("../internal/keys");
+const semantic_search_1 = require("../internal/semantic-search");
+const validation_1 = require("../internal/validation");
+async function readCreatedAt(context, pk, sk) {
+    const existing = await (0, retry_1.withDynamoDBRetry)(() => context.client.get({
+        TableName: context.tableName,
+        Key: { PK: pk, SK: sk },
+        ConsistentRead: true,
+        ProjectionExpression: '#c',
+        ExpressionAttributeNames: { '#c': 'createdAt' },
+    }));
+    return existing.Item?.createdAt;
+}
+/** Delete the item and, when a vector backend is configured, drop its vector. */
+async function deleteStoreItem(context, op, pk, sk) {
+    await (0, retry_1.withDynamoDBRetry)(() => context.client.delete({ TableName: context.tableName, Key: { PK: pk, SK: sk } }));
+    if (context.vectorBackend) {
+        await (0, index_sync_1.syncVectorIndex)(context.vectorBackend, op.namespace, op.key, undefined, context.logger);
+    }
+}
+/** Compute the embedding for a put, honoring `op.index` (false disables it). */
+async function resolveEmbedding(context, op, value) {
+    if (op.index === false)
+        return undefined;
+    return (0, semantic_search_1.embedValue)(context, value, Array.isArray(op.index) ? op.index : undefined);
+}
+/** Put the record; on failure best-effort clean any S3 objects it referenced. */
+async function persistRecord(context, record) {
+    try {
+        await (0, retry_1.withDynamoDBRetry)(() => context.client.put({ TableName: context.tableName, Item: record }));
+    }
+    catch (error) {
+        if (context.offloader) {
+            await (0, orphans_1.cleanUpS3Orphans)(context.offloader, (0, descriptor_keys_1.collectS3Keys)([record.value]), 'store.put', context.logger);
+        }
+        throw error;
+    }
+}
+/**
+ * Store, update, or delete an item. A null value deletes; otherwise the value
+ * is encoded (with optional compression/S3 offload), `createdAt` is preserved
+ * across updates, and an embedding is computed when indexing is enabled. When a
+ * `vectorBackend` is configured the embedding is sent there (and not stored on
+ * the item); DynamoDB always holds the canonical item.
+ */
+async function putItem(context, op) {
+    (0, validation_1.validateNamespace)(op.namespace);
+    (0, validation_1.validateKey)(op.key);
+    const pk = (0, keys_1.partitionKey)(op.namespace);
+    const sk = (0, keys_1.sortKey)(op.namespace, op.key);
+    if (op.value === null) {
+        await deleteStoreItem(context, op, pk, sk);
+        return;
+    }
+    const value = op.value;
+    const timestamp = (0, clock_1.nowIso)();
+    const createdAt = (await readCreatedAt(context, pk, sk)) ?? timestamp;
+    const embedding = await resolveEmbedding(context, op, value);
+    const ttlTimestamp = context.ttl ? (0, ttl_1.calculateTtlTimestamp)(context.ttl) : undefined;
+    const record = await (0, item_mapper_1.buildStoreItem)(context, op.namespace, op.key, value, {
+        createdAt,
+        updatedAt: timestamp,
+        embedding: context.vectorBackend ? undefined : embedding,
+        ttlTimestamp,
+    });
+    await persistRecord(context, record);
+    if (context.vectorBackend) {
+        await (0, index_sync_1.syncVectorIndex)(context.vectorBackend, op.namespace, op.key, embedding, context.logger);
+    }
+}
+//# sourceMappingURL=put.js.map

package/dist/store/actions/put.js.map

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

package/dist/store/actions/reconcile-vector-index.d.ts

@@ -0,0 +1,17 @@
+import type { StoreContext } from '../internal/setup';
+/** Counts returned by {@link reconcileVectorIndex}. */
+export interface VectorReconcileResult {
+    upserted: number;
+    pruned: number;
+}
+/**
+ * Repair the vector backend against the canonical DynamoDB items under
+ * `namespacePrefix`: re-push every live embedding, and — when the backend
+ * implements {@link VectorBackend.listKeys} — prune vectors with no canonical
+ * item. A maintenance tool for backend drift; run it when the namespace is
+ * idle. Re-embeds with the store's configured fields, so per-put `index` field
+ * overrides are not reproduced. Requires a configured `index` and
+ * `vectorBackend`; the prefix must be a non-empty namespace.
+ */
+export declare function reconcileVectorIndex(context: StoreContext, namespacePrefix: string[]): Promise<VectorReconcileResult>;
+//# sourceMappingURL=reconcile-vector-index.d.ts.map

package/dist/store/actions/reconcile-vector-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-vector-index.d.ts","sourceRoot":"","sources":["../../../src/store/actions/reconcile-vector-index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,qBAAqB,CAAC,CAUhC"}

package/dist/store/actions/reconcile-vector-index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reconcileVectorIndex = reconcileVectorIndex;
+const errors_1 = require("../../shared/errors/errors");
+const index_reconcile_1 = require("../internal/index-reconcile");
+const validation_1 = require("../internal/validation");
+/**
+ * Repair the vector backend against the canonical DynamoDB items under
+ * `namespacePrefix`: re-push every live embedding, and — when the backend
+ * implements {@link VectorBackend.listKeys} — prune vectors with no canonical
+ * item. A maintenance tool for backend drift; run it when the namespace is
+ * idle. Re-embeds with the store's configured fields, so per-put `index` field
+ * overrides are not reproduced. Requires a configured `index` and
+ * `vectorBackend`; the prefix must be a non-empty namespace.
+ */
+async function reconcileVectorIndex(context, namespacePrefix) {
+    (0, validation_1.validateNamespace)(namespacePrefix);
+    if (!context.index || !context.vectorBackend) {
+        throw new errors_1.ValidationError('reconcileVectorIndex requires a configured index and vectorBackend');
+    }
+    const backend = context.vectorBackend;
+    const targets = await (0, index_reconcile_1.collectReconcileTargets)(context, namespacePrefix);
+    const upserted = await (0, index_reconcile_1.pushEmbeddings)(backend, targets);
+    const pruned = await (0, index_reconcile_1.pruneOrphans)(context, backend, namespacePrefix, targets);
+    return { upserted, pruned };
+}
+//# sourceMappingURL=reconcile-vector-index.js.map

package/dist/store/actions/reconcile-vector-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-vector-index.js","sourceRoot":"","sources":["../../../src/store/actions/reconcile-vector-index.ts"],"names":[],"mappings":";;AAoBA,oDAaC;AAjCD,uDAA6D;AAC7D,iEAAoG;AAEpG,uDAA2D;AAQ3D;;;;;;;;GAQG;AACI,KAAK,UAAU,oBAAoB,CACxC,OAAqB,EACrB,eAAyB;IAEzB,IAAA,8BAAiB,EAAC,eAAe,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,IAAI,wBAAe,CAAC,oEAAoE,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAuB,EAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,MAAM,IAAA,gCAAc,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAY,EAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/dist/store/actions/search.d.ts

@@ -0,0 +1,10 @@
+import type { SearchItem, SearchOperation } from '@langchain/langgraph-checkpoint';
+import type { StoreContext } from '../internal/setup';
+/**
+ * Search items under a namespace prefix: metadata filtering plus optional
+ * semantic ranking. A non-empty prefix uses a native Query; an empty prefix
+ * falls back to a (filtered) Scan. Semantic ranking uses the configured
+ * VectorBackend when present, else an in-memory cosine ranking (capped).
+ */
+export declare function searchItems(context: StoreContext, op: SearchOperation): Promise<SearchItem[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/store/actions/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/store/actions/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,UAAU,EACV,eAAe,EAChB,MAAM,iCAAiC,CAAC;AASzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAuDtD;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,YAAY,EACrB,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CAuBvB"}