@farukada/aws-langgraph-dynamodb-ts 1.0.0-rc.1 → 1.0.0-rc.2

package/dist/store/vector-backend.js

@@ -1,2 +1,17 @@
 "use strict";
+/**
+ * Hides which vector index the store talks to.
+ *
+ * The store sees only `VectorBackend` — upsert, query, delete and an optional
+ * listing — with what it promises and requires stated per method, so any
+ * index that keeps those terms plugs in without the store changing. The table
+ * stays the truth: a backend may lag it and may score by distance, and every
+ * match is re-read before a caller sees it.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.VECTOR_SCORE_DIRECTIONS = void 0;
+/**
+ * Every direction `toRelevanceScores` (store/internal/vector-index.ts)
+ * recognises, for validating input.
+ */
+exports.VECTOR_SCORE_DIRECTIONS = ['relevance', 'distance'];

package/package.json

@@ -1,25 +1,32 @@
 {
   "name": "@farukada/aws-langgraph-dynamodb-ts",
-  "version": "1.0.0-rc.1",
+  "version": "1.0.0-rc.2",
   "license": "MIT",
-  "description": "AWS DynamoDB implementation for LangGraph Memory Store and Checkpoint Saver in TypeScript",
+  "description": "DynamoDB persistence for LangGraph.js: checkpoint saver, long-term memory store with semantic search, and chat message history, with optional S3 offload, compression and TTL",
   "keywords": [
     "aws",
     "dynamodb",
     "langchain",
     "langgraph",
     "checkpointer",
-    "memory-store"
+    "checkpoint-saver",
+    "memory-store",
+    "long-term-memory",
+    "chat-history",
+    "semantic-search",
+    "s3",
+    "typescript"
   ],
   "author": "Faruk Ada <info@farukada.com>",
   "homepage": "https://github.com/FarukAda/aws-langgraph-dynamodb-ts",
   "repository": {
     "type": "git",
-    "url": "https://github.com/FarukAda/aws-langgraph-dynamodb-ts"
+    "url": "git+https://github.com/FarukAda/aws-langgraph-dynamodb-ts.git"
   },
   "bugs": {
     "url": "https://github.com/FarukAda/aws-langgraph-dynamodb-ts/issues"
   },
+  "type": "commonjs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -36,7 +43,7 @@
     "npm": ">=10.0.0"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "node scripts/clean.mjs && tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.build.json --noEmit",
     "typecheck:all": "tsc --noEmit",
     "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\" \"*.config.ts\" \"**/*.mjs\" --no-error-on-unmatched-pattern",
@@ -48,30 +55,37 @@
     "test:conformance": "jest --config jest.conformance.config.ts",
     "test:aws": "jest --config jest.aws.config.ts",
     "test:static": "jest test/static",
+    "test:scripts": "node --test \"test/scripts/**/*.test.mjs\"",
     "test:package-smoke": "node --test test/package-smoke/smoke.test.mjs",
+    "test:consumer-types": "node --test test/package-smoke/consumer-types.test.mjs",
+    "test:surface": "node scripts/run-with-timeout.mjs 150 -- node --test --test-timeout=120000 test/surface/surface.test.mjs",
+    "test:surface:update": "node scripts/update-surface-baseline.mjs",
     "prepublishOnly": "npm run typecheck && npm run typecheck:all && npm run lint && npm run build && npm test",
     "docs": "typedoc",
     "docs:watch": "typedoc --watch",
+    "check:docs": "node scripts/check-doc-samples.mjs",
+    "check:links": "node scripts/check-doc-links.mjs",
     "unused": "knip",
     "depcheck": "depcheck .",
+    "peer-floors": "node scripts/peer-floors.mjs",
+    "ci:require-green": "node scripts/require-green-ci.mjs",
+    "changelog-section": "node scripts/changelog-section.mjs",
+    "sbom": "node scripts/generate-sbom.mjs",
     "cpd": "jscpd ./src --threshold 2 --min-lines 3 --reporters console --silent --format typescript,javascript",
     "cpd:full": "jscpd ./src --threshold 2 --min-lines 3 --reporters console-full --format typescript,javascript",
     "cpd:test": "jscpd ./test --threshold 2 --min-lines 3 --reporters console-full --format typescript,javascript",
     "pack:check": "node scripts/pack-check.mjs && publint && attw --pack . --profile node16"
   },
   "dependencies": {
-    "@aws-sdk/client-dynamodb": "^3.1116.0",
-    "@aws-sdk/lib-dynamodb": "^3.1116.0",
+    "@aws-sdk/client-dynamodb": "^3.1132.0",
+    "@aws-sdk/lib-dynamodb": "^3.1132.0",
     "@aws-sdk/util-dynamodb": "^3.996.9"
   },
   "peerDependencies": {
-    "@aws-sdk/client-s3": "^3.901.0",
-    "@langchain/core": "^1.2.9",
+    "@aws-sdk/client-s3": "^3.1132.0",
+    "@langchain/core": "^1.2.11",
     "@langchain/langgraph-checkpoint": "^1.1.5"
   },
-  "overrides": {
-    "uuid": ">=11.1.1"
-  },
   "peerDependenciesMeta": {
     "@aws-sdk/client-s3": {
       "optional": true
@@ -79,37 +93,39 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
-    "@aws-sdk/client-s3": "^3.1116.0",
+    "@aws-sdk/client-s3": "^3.1132.0",
     "@eslint/js": "^10.0.1",
-    "@langchain/aws": "^1.4.4",
-    "@langchain/langgraph": "^1.3.2",
+    "@langchain/aws": "^1.4.5",
+    "@langchain/langgraph": "^1.4.15",
     "@langchain/langgraph-checkpoint-validation": "^1.1.1",
     "@types/jest": "^30.0.0",
-    "@types/node": "^26.2.0",
+    "@types/node": "^26.5.1",
     "@typescript/native": "npm:typescript@^7.0.2",
     "aws-sdk-client-mock": "^4.1.0",
     "depcheck": "^1.4.7",
-    "eslint": "^10.9.0",
+    "eslint": "^10.10.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-no-instanceof": "^1.0.1",
-    "eslint-plugin-perfectionist": "^5.10.1",
+    "eslint-plugin-perfectionist": "^5.11.0",
     "eslint-plugin-prettier": "^5.5.6",
     "eslint-plugin-unused-imports": "^4.4.1",
     "expect-type": "^1.4.0",
-    "fast-check": "^4.9.0",
-    "jest": "^30.4.2",
+    "fast-check": "^4.10.0",
+    "jest": "^30.5.1",
+    "jest-environment-node": "^30.5.1",
     "jiti": "^2.7.0",
-    "jscpd": "^5.0.16",
-    "knip": "^6.32.2",
+    "jscpd": "^5.2.0",
+    "knip": "^6.35.1",
+    "langchain": "^1.5.11",
     "prettier": "^3.9.6",
     "publint": "^0.3.24",
     "ts-jest": "^29.4.12",
     "ts-node": "^10.9.2",
     "typedoc": "^0.28.20",
-    "typedoc-plugin-markdown": "^4.12.0",
+    "typedoc-plugin-markdown": "^4.13.0",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
-    "typescript-eslint": "^8.67.0",
-    "zod": "^4.4.3"
+    "typescript-eslint": "^8.70.0",
+    "zod": "^4.6.5"
   },
   "prettier": {
     "semi": true,

package/dist/checkpointer/internal/assemble.d.ts

@@ -1,17 +0,0 @@
-import type { CheckpointMetadata, CheckpointTuple } from '@langchain/langgraph-checkpoint';
-import type { CheckpointMetaItem } from '../types';
-import type { CheckpointerContext } from './setup';
-/** How a tuple is assembled: cancellation, read consistency, and metadata already decoded by the caller. */
-export interface AssembleOptions {
-    signal?: AbortSignal;
-    /** `true` for `getTuple` (read-your-writes), `false` for the eventually-consistent `list` path. */
-    consistent: boolean;
-    /** Metadata the caller decoded to apply a filter, so it is not decoded (or downloaded) twice. */
-    metadata?: CheckpointMetadata;
-}
-/**
- * Assemble a full {@link CheckpointTuple} from a META item: fetch and decode its
- * payload, metadata, and pending writes, attaching a parent config when present.
- * Returns undefined when the payload item is missing (inconsistent state).
- */
-export declare function assembleTuple(context: CheckpointerContext, threadId: string, checkpointNs: string, meta: CheckpointMetaItem, options: AssembleOptions): Promise<CheckpointTuple | undefined>;

package/dist/checkpointer/internal/assemble.js

@@ -1,38 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assembleTuple = assembleTuple;
-const fetch_1 = require("./fetch");
-const item_reader_1 = require("./item-reader");
-const pending_sends_1 = require("./pending-sends");
-/** Build a config that addresses a specific checkpoint. */
-function configFor(threadId, checkpointNs, checkpointId) {
-    return {
-        configurable: { thread_id: threadId, checkpoint_ns: checkpointNs, checkpoint_id: checkpointId },
-    };
-}
-/**
- * Assemble a full {@link CheckpointTuple} from a META item: fetch and decode its
- * payload, metadata, and pending writes, attaching a parent config when present.
- * Returns undefined when the payload item is missing (inconsistent state).
- */
-async function assembleTuple(context, threadId, checkpointNs, meta, options) {
-    const read = { signal: options.signal, consistent: options.consistent };
-    const payload = await (0, fetch_1.fetchPayload)(context, threadId, checkpointNs, meta.checkpointId, read);
-    if (!payload)
-        return undefined;
-    const [checkpoint, metadata, pendingWrites] = await Promise.all([
-        (0, item_reader_1.readCheckpoint)(context, payload, threadId).then((stored) => (0, pending_sends_1.migratePendingSends)(context, stored, threadId, checkpointNs, meta.parentCheckpointId, read)),
-        options.metadata ?? (0, item_reader_1.readMetadata)(context, meta, threadId),
-        (0, fetch_1.fetchPendingWrites)(context, threadId, checkpointNs, meta.checkpointId, read),
-    ]);
-    const tuple = {
-        config: configFor(threadId, checkpointNs, meta.checkpointId),
-        checkpoint,
-        metadata,
-        pendingWrites,
-    };
-    if (meta.parentCheckpointId !== undefined) {
-        tuple.parentConfig = configFor(threadId, checkpointNs, meta.parentCheckpointId);
-    }
-    return tuple;
-}

package/dist/checkpointer/internal/checkpoint-write-verify.d.ts

@@ -1,24 +0,0 @@
-import type { CheckpointMetaItem, CheckpointPayloadItem } from '../types';
-import type { CheckpointerContext } from './setup';
-/** What a post-failure verification read could establish about a put. */
-export type CheckpointWriteVerdict = 'landed' | 'not-landed' | 'unverified';
-/**
- * Read one of the two rows back after the META+PAYLOAD transaction failed and
- * report what that failure actually did — never assuming it did nothing.
- *
- * No rejection is proof of a non-commit: `withDynamoDBRetry` re-issues a
- * transaction whose response was lost, and the re-issues can time out at the
- * transport without reaching DynamoDB, so the budget is spent on a
- * `RetryExhaustedError` while the rows are committed. Deleting the uploads on
- * that basis stranded the head checkpoint of a thread on a `NoSuchKey`.
- *
- * Keys are nonced per call (see `buildCheckpointItems`), so "the row holds
- * this attempt's key" is the same statement as "this attempt's write is
- * live". When neither descriptor is offloaded there is nothing to delete, so
- * the answer is simply "safe to clean up", a no-op for the caller.
- *
- * A read failure establishes nothing; the caller then leaks one object at
- * worst (reclaimed by `ensureS3LifecycleRule`) rather than deleting one a live
- * row may point at — the same trade `store/internal/persist.ts` makes.
- */
-export declare function verifyCheckpointLanded(context: CheckpointerContext, meta: CheckpointMetaItem, payload: CheckpointPayloadItem): Promise<CheckpointWriteVerdict>;

package/dist/checkpointer/internal/checkpoint-write-verify.js

@@ -1,67 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.verifyCheckpointLanded = verifyCheckpointLanded;
-const codec_1 = require("../../shared/codec/codec");
-const retry_1 = require("../../shared/dynamodb/retry");
-/** The S3 key an offloaded descriptor points at, or undefined for inline/absent. */
-function offloadedKey(descriptor) {
-    return descriptor?.location === codec_1.PayloadLocation.S3 ? descriptor.s3Key : undefined;
-}
-/**
- * Pick the row carrying an offloaded descriptor. The META and PAYLOAD rows
- * commit in one transaction, so one of them is enough; with neither offloaded
- * there is nothing to protect and no read to spend.
- */
-function chooseProbe(meta, payload) {
-    const metaKey = offloadedKey(meta.metadata);
-    if (metaKey !== undefined) {
-        return { key: { PK: meta.PK, SK: meta.SK }, attribute: 'metadata', expected: metaKey };
-    }
-    const payloadKey = offloadedKey(payload.checkpoint);
-    if (payloadKey !== undefined) {
-        return {
-            key: { PK: payload.PK, SK: payload.SK },
-            attribute: 'checkpoint',
-            expected: payloadKey,
-        };
-    }
-    return undefined;
-}
-/**
- * Read one of the two rows back after the META+PAYLOAD transaction failed and
- * report what that failure actually did — never assuming it did nothing.
- *
- * No rejection is proof of a non-commit: `withDynamoDBRetry` re-issues a
- * transaction whose response was lost, and the re-issues can time out at the
- * transport without reaching DynamoDB, so the budget is spent on a
- * `RetryExhaustedError` while the rows are committed. Deleting the uploads on
- * that basis stranded the head checkpoint of a thread on a `NoSuchKey`.
- *
- * Keys are nonced per call (see `buildCheckpointItems`), so "the row holds
- * this attempt's key" is the same statement as "this attempt's write is
- * live". When neither descriptor is offloaded there is nothing to delete, so
- * the answer is simply "safe to clean up", a no-op for the caller.
- *
- * A read failure establishes nothing; the caller then leaks one object at
- * worst (reclaimed by `ensureS3LifecycleRule`) rather than deleting one a live
- * row may point at — the same trade `store/internal/persist.ts` makes.
- */
-async function verifyCheckpointLanded(context, meta, payload) {
-    const probe = chooseProbe(meta, payload);
-    if (!probe)
-        return 'not-landed';
-    try {
-        const result = await (0, retry_1.withDynamoDBRetry)(() => context.client.get({
-            TableName: context.tableName,
-            Key: probe.key,
-            ConsistentRead: true,
-            ProjectionExpression: '#d',
-            ExpressionAttributeNames: { '#d': probe.attribute },
-        }), context.retry);
-        const stored = result.Item?.[probe.attribute];
-        return offloadedKey(stored) === probe.expected ? 'landed' : 'not-landed';
-    }
-    catch {
-        return 'unverified';
-    }
-}

package/dist/checkpointer/internal/configurable.d.ts

@@ -1,12 +0,0 @@
-import type { RunnableConfig } from '@langchain/core/runnables';
-/** The thread/namespace/checkpoint identifiers extracted from a config. */
-export interface ResolvedConfigurable {
-    threadId: string;
-    checkpointNs: string;
-    checkpointId?: string;
-}
-/**
- * Narrow `RunnableConfig.configurable` to the identifiers the saver needs,
- * defaulting the namespace to empty and validating that a thread id is present.
- */
-export declare function readConfigurable(config: RunnableConfig): ResolvedConfigurable;

package/dist/checkpointer/internal/configurable.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readConfigurable = readConfigurable;
-const validation_1 = require("./validation");
-/**
- * Narrow `RunnableConfig.configurable` to the identifiers the saver needs,
- * defaulting the namespace to empty and validating that a thread id is present.
- */
-function readConfigurable(config) {
-    const configurable = (config.configurable ?? {});
-    (0, validation_1.validateThreadId)(configurable.thread_id);
-    const checkpointNs = configurable.checkpoint_ns ?? '';
-    (0, validation_1.validateCheckpointNs)(checkpointNs);
-    /**
-     * `null`, `''` and the legacy `thread_ts` alias resolve the way the reference's
-     * `getCheckpointId` does: a falsy id addresses the latest checkpoint rather
-     * than failing a config that was built from JSON or ported from another saver.
-     */
-    const rawId = configurable.checkpoint_id ?? configurable.thread_ts;
-    const checkpointId = rawId ? rawId : undefined;
-    if (checkpointId !== undefined)
-        (0, validation_1.validateCheckpointId)(checkpointId);
-    return { threadId: configurable.thread_id, checkpointNs, checkpointId };
-}

package/dist/checkpointer/internal/fetch.d.ts

@@ -1,19 +0,0 @@
-import type { CheckpointPendingWrite } from '@langchain/langgraph-checkpoint';
-import type { CheckpointMetaItem, CheckpointPayloadItem } from '../types';
-import type { CheckpointerContext } from './setup';
-/** Per-read options for the payload and writes reads. */
-export interface ReadOptions {
-    signal?: AbortSignal;
-    /** `false` for bulk reads (`list`) that trade read-your-writes for half the read cost. */
-    consistent?: boolean;
-}
-/**
- * Fetch the target META item: by id when given, else the newest in the
- * namespace. The newest-first read pages one row at a time past any foreign
- * row until it finds a real checkpoint.
- */
-export declare function fetchTargetMeta(context: CheckpointerContext, threadId: string, checkpointNs: string, checkpointId?: string, signal?: AbortSignal): Promise<CheckpointMetaItem | undefined>;
-/** Fetch the PAYLOAD item for a checkpoint. */
-export declare function fetchPayload(context: CheckpointerContext, threadId: string, checkpointNs: string, checkpointId: string, read?: ReadOptions): Promise<CheckpointPayloadItem | undefined>;
-/** Fetch and decode every pending write for a checkpoint, in write order. */
-export declare function fetchPendingWrites(context: CheckpointerContext, threadId: string, checkpointNs: string, checkpointId: string, read?: ReadOptions): Promise<CheckpointPendingWrite[]>;

package/dist/checkpointer/internal/fetch.js

@@ -1,88 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchTargetMeta = fetchTargetMeta;
-exports.fetchPayload = fetchPayload;
-exports.fetchPendingWrites = fetchPendingWrites;
-const clock_1 = require("../../shared/clock");
-const constants_1 = require("../../shared/constants");
-const expiry_1 = require("../../shared/dynamodb/expiry");
-const paginate_1 = require("../../shared/dynamodb/paginate");
-const retry_1 = require("../../shared/dynamodb/retry");
-const retry_policy_1 = require("../../shared/dynamodb/retry-policy");
-const item_reader_1 = require("./item-reader");
-const keys_1 = require("./keys");
-const query_1 = require("./query");
-/**
- * Fetch the target META item: by id when given, else the newest in the
- * namespace. The newest-first read pages one row at a time past any foreign
- * row until it finds a real checkpoint.
- */
-async function fetchTargetMeta(context, threadId, checkpointNs, checkpointId, signal) {
-    /** Expired rows are absent to every reader, however long DynamoDB's sweep lags. */
-    const now = (0, clock_1.nowSeconds)();
-    if (checkpointId !== undefined) {
-        const result = await (0, retry_1.withDynamoDBRetry)(() => context.client.get({
-            TableName: context.tableName,
-            Key: { PK: (0, keys_1.partitionKey)(threadId), SK: (0, keys_1.metaSortKey)(checkpointNs, checkpointId) },
-            ConsistentRead: true,
-        }), (0, retry_policy_1.retryFor)(context, signal));
-        const meta = (0, item_reader_1.narrowHead)(context, result.Item);
-        return meta && !(0, expiry_1.isExpiredRow)(meta, now) ? meta : undefined;
-    }
-    const params = (0, query_1.beginsWithQuery)(context.tableName, (0, keys_1.partitionKey)(threadId), (0, keys_1.metaSortKeyPrefix)(checkpointNs), {
-        limit: 1,
-        consistent: true,
-    });
-    const rows = (0, paginate_1.paginateQuery)({
-        retry: (0, retry_policy_1.retryFor)(context, signal),
-        signal,
-        client: context.client,
-        params: (0, expiry_1.withoutExpired)(params, now),
-        maxItems: Number.POSITIVE_INFINITY,
-        maxIterations: Number.POSITIVE_INFINITY,
-    });
-    for await (const raw of rows) {
-        const meta = (0, item_reader_1.narrowHead)(context, raw);
-        if (meta && !(0, expiry_1.isExpiredRow)(meta, now))
-            return meta;
-    }
-    return undefined;
-}
-/** Fetch the PAYLOAD item for a checkpoint. */
-async function fetchPayload(context, threadId, checkpointNs, checkpointId, read = {}) {
-    const result = await (0, retry_1.withDynamoDBRetry)(() => context.client.get({
-        TableName: context.tableName,
-        Key: { PK: (0, keys_1.partitionKey)(threadId), SK: (0, keys_1.payloadSortKey)(checkpointNs, checkpointId) },
-        ConsistentRead: read.consistent ?? true,
-    }), (0, retry_policy_1.retryFor)(context, read.signal));
-    return result.Item;
-}
-/** Fetch and decode every pending write for a checkpoint, in write order. */
-async function fetchPendingWrites(context, threadId, checkpointNs, checkpointId, read = {}) {
-    const params = (0, query_1.beginsWithQuery)(context.tableName, (0, keys_1.partitionKey)(threadId), (0, keys_1.writeSortKeyPrefix)(checkpointNs, checkpointId), { ascending: true, consistent: read.consistent ?? true });
-    /**
-     * Unbounded: the read must be complete to be correct, and a Send fan-out
-     * retried with a changed write order leaves superseded rows behind that
-     * count toward any cap. Past the warning threshold the read still succeeds,
-     * but an operator is told the checkpoint is unusually heavy.
-     */
-    const items = [];
-    for await (const item of (0, paginate_1.paginateQuery)({
-        retry: (0, retry_policy_1.retryFor)(context, read.signal),
-        signal: read.signal,
-        client: context.client,
-        params,
-        maxItems: Number.POSITIVE_INFINITY,
-        maxIterations: Number.POSITIVE_INFINITY,
-    })) {
-        items.push(item);
-    }
-    if (items.length >= constants_1.LIST_SCAN_WARN_THRESHOLD) {
-        context.logger.warn('getTuple: a checkpoint carries very many pending-write rows; the read is complete but slow', {
-            threadId,
-            checkpointId,
-            rows: items.length,
-        });
-    }
-    return (0, item_reader_1.toPendingWrites)(context, items, threadId);
-}

package/dist/checkpointer/internal/filter-match.d.ts

@@ -1,13 +0,0 @@
-/** A JSON-comparable value used in metadata filters. */
-export type FilterValue = string | number | boolean | null | FilterValue[] | {
-    [key: string]: FilterValue;
-};
-/**
- * True when every key in `filter` is present in `metadata` with a deeply equal
- * value. Equality is structural and key-order-independent for nested objects,
- * order-significant for arrays, and type-strict (no `3` vs `'3'` coercion). An
- * empty filter matches everything. Only own properties count: a filter on
- * `constructor` or `toString` compares against nothing, not against the
- * prototype's function, the same rule the store's filter applies.
- */
-export declare function matchesFilter(metadata: Record<string, FilterValue>, filter: Record<string, FilterValue>): boolean;

package/dist/checkpointer/internal/filter-match.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.matchesFilter = matchesFilter;
-const node_util_1 = require("node:util");
-/**
- * True when every key in `filter` is present in `metadata` with a deeply equal
- * value. Equality is structural and key-order-independent for nested objects,
- * order-significant for arrays, and type-strict (no `3` vs `'3'` coercion). An
- * empty filter matches everything. Only own properties count: a filter on
- * `constructor` or `toString` compares against nothing, not against the
- * prototype's function, the same rule the store's filter applies.
- */
-function matchesFilter(metadata, filter) {
-    return Object.entries(filter).every(([key, value]) => (0, node_util_1.isDeepStrictEqual)(Object.hasOwn(metadata, key) ? metadata[key] : undefined, value));
-}

package/dist/checkpointer/internal/item-reader.d.ts

@@ -1,66 +0,0 @@
-import type { Checkpoint, CheckpointMetadata, CheckpointPendingWrite } from '@langchain/langgraph-checkpoint';
-import type { DocItem } from '../../shared/dynamodb/types';
-import type { CheckpointMetaItem, CheckpointPayloadItem, CheckpointWriteItem } from '../types';
-import type { CheckpointerContext } from './setup';
-/**
- * Narrow a raw row to a {@link CheckpointMetaItem}, or `undefined` for a row
- * that merely shares the `META#` sort-key prefix. Replaces an unchecked cast
- * at the one boundary where a row may not have been written by this adapter.
- */
-export declare function narrowMetaItem(raw: DocItem): CheckpointMetaItem | undefined;
-/**
- * Narrow a candidate head row, warning when a row that merely shares the
- * `META#` prefix is not a checkpoint meta item. Returning such a row used to
- * make `assembleTuple` miss its payload and report the thread as empty, so
- * LangGraph started a new run on top of the real history; a foreign row is
- * skipped and logged instead, exactly as `list()` treats it.
- */
-export declare function narrowHead(context: CheckpointerContext, raw: DocItem | undefined): CheckpointMetaItem | undefined;
-/**
- * Decode the checkpoint stored in a PAYLOAD item. `threadId` is the caller's
- * (from the config), never the row's: it scopes which S3 object the row may
- * point at, so it must come from the partition the caller asked for.
- */
-export declare function readCheckpoint(context: CheckpointerContext, item: CheckpointPayloadItem, threadId: string): Promise<Checkpoint>;
-/** Decode the metadata stored in a META item; see {@link readCheckpoint} for `threadId`. */
-export declare function readMetadata(context: CheckpointerContext, item: CheckpointMetaItem, threadId: string): Promise<CheckpointMetadata>;
-/**
- * Drop rows a later `putWrites` call added for a task and channel an earlier
- * call had already committed.
- *
- * A regular write's index is its position in the caller's array, so a retried
- * task whose write mix changed can place an already-committed channel at a
- * second index — a new row, which would replay that channel's value twice. For
- * an accumulating channel (a `messages` add-reducer, a Topic) that
- * double-counts. Every row carries the `writeGroup` of the call that wrote it,
- * which distinguishes that case from a channel a *single* call legitimately
- * wrote more than once (a task emitting two Sends), where both values must
- * survive.
- *
- * Write groups are time-ordered ULIDs, so the smallest one for a `(task,
- * channel)` pair identifies the earliest committed call — first-write-wins,
- * the same rule the write-side guard applies, extended to the case the guard
- * cannot see. Selecting by *order encountered* would not do: rows arrive
- * sorted by index, and a retry emitting fewer writes moves an
- * already-committed channel to a smaller index, where it sorts ahead of the
- * original row and would hand back the later call's value instead. The
- * superseded row stays in DynamoDB and is removed by `deleteThread` or TTL
- * like any other.
- *
- * Identity is `(task, channel, occurrence)`, not `(task, channel)`. Keying on
- * the channel alone treated *any* second row for a channel as a superseding
- * duplicate — including one a retry added at an occurrence no earlier call had
- * ever written, which the write-side guard accepted cleanly. That row was then
- * discarded on read, silently returning fewer values than were written, with
- * `putWrites()` having reported success. For that specific shape — a retry
- * that legitimately emits a channel *more* often than the original call —
- * keeping the occurrence restores the upstream outcome: `MemorySaver` keys
- * first-write-wins on `(taskId, idx)`, so a grown retry keeps both values
- * there too. That is not a claim of parity in general: a retry that reorders
- * or shrinks its writes is still resolved to the earliest call per `(task,
- * channel, occurrence)` as above, which is what keeps an accumulating channel
- * from being double-counted — a case `MemorySaver` does not have to handle.
- */
-export declare function dropSupersededWrites(items: CheckpointWriteItem[]): CheckpointWriteItem[];
-/** Decode WRITE items into `[taskId, channel, value]` pending-write tuples. */
-export declare function toPendingWrites(context: CheckpointerContext, items: CheckpointWriteItem[], threadId: string): Promise<CheckpointPendingWrite[]>;