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

package/dist/store/internal/persist.d.ts

@@ -1,27 +0,0 @@
-import type { StoreItemRecord } from '../types';
-import type { ExistingRecordMeta } from './read-existing';
-import type { StoreContext } from './setup';
-/**
- * Put the record and clean up whichever side is now dead.
- *
- * The compare-and-swap path runs **only when an offloader is configured**:
- * without one there is no S3 object to orphan, so a plain last-write-wins put
- * stays correct and costs no extra write capacity (DynamoDB charges for a
- * failed conditional write too). With one, the swap is what lets this call
- * delete exactly the payload it superseded rather than a descriptor a racer may
- * already have replaced.
- *
- * Every failure reaching the catch arrives after at least one put was issued —
- * `putWithRevisionSwap` only re-reads from inside its own catch — so none of
- * them proves a non-commit on its own: a put can commit server-side and lose
- * its response, and a `ConditionalCheckFailedException` is as consistent with
- * hitting the row this call just wrote as with a competitor's win. The row is
- * therefore read back (`verifyWriteLanded`) before anything is deleted. Only a
- * confirmed `'not-landed'` deletes this record's own nonced object; a confirmed
- * `'landed'` cleans up the previous object like the success path and swallows
- * the error, and an `'unverified'` read deletes nothing and rethrows — leaking
- * one object at worst rather than stranding a live row pointing at a deleted
- * one. An inline payload has no object to leak, so it needs no read.
- */
-export declare function persistRecord(context: StoreContext, record: StoreItemRecord, existing: ExistingRecordMeta): Promise<void>;
-//# sourceMappingURL=persist.d.ts.map

package/dist/store/internal/persist.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../../src/store/internal/persist.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAa5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/store/internal/persist.js

@@ -1,59 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.persistRecord = persistRecord;
-const codec_1 = require("../../shared/codec/codec");
-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 overwrite_swap_1 = require("./overwrite-swap");
-const write_verify_1 = require("./write-verify");
-/** Best-effort delete of one descriptor's S3 object. */
-async function cleanUp(context, descriptor, label) {
-    if (!context.offloader || !descriptor)
-        return;
-    await (0, orphans_1.cleanUpS3Orphans)(context.offloader, (0, descriptor_keys_1.collectS3Keys)([descriptor]), label, context.logger);
-}
-/**
- * Put the record and clean up whichever side is now dead.
- *
- * The compare-and-swap path runs **only when an offloader is configured**:
- * without one there is no S3 object to orphan, so a plain last-write-wins put
- * stays correct and costs no extra write capacity (DynamoDB charges for a
- * failed conditional write too). With one, the swap is what lets this call
- * delete exactly the payload it superseded rather than a descriptor a racer may
- * already have replaced.
- *
- * Every failure reaching the catch arrives after at least one put was issued —
- * `putWithRevisionSwap` only re-reads from inside its own catch — so none of
- * them proves a non-commit on its own: a put can commit server-side and lose
- * its response, and a `ConditionalCheckFailedException` is as consistent with
- * hitting the row this call just wrote as with a competitor's win. The row is
- * therefore read back (`verifyWriteLanded`) before anything is deleted. Only a
- * confirmed `'not-landed'` deletes this record's own nonced object; a confirmed
- * `'landed'` cleans up the previous object like the success path and swallows
- * the error, and an `'unverified'` read deletes nothing and rethrows — leaking
- * one object at worst rather than stranding a live row pointing at a deleted
- * one. An inline payload has no object to leak, so it needs no read.
- */
-async function persistRecord(context, record, existing) {
-    let superseded = existing;
-    try {
-        if (context.offloader) {
-            superseded = await (0, overwrite_swap_1.putWithRevisionSwap)(context, record, existing);
-        }
-        else {
-            await (0, retry_1.withDynamoDBRetry)(() => context.client.put({ TableName: context.tableName, Item: record }));
-        }
-    }
-    catch (error) {
-        const verdict = record.value.location === codec_1.PayloadLocation.S3
-            ? await (0, write_verify_1.verifyWriteLanded)(context, record, record.value.s3Key)
-            : 'not-landed';
-        if (verdict === 'not-landed')
-            await cleanUp(context, record.value, 'store.put');
-        if (verdict !== 'landed')
-            throw error;
-    }
-    await cleanUp(context, superseded.value, 'store.put.overwrite');
-}
-//# sourceMappingURL=persist.js.map

package/dist/store/internal/persist.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"persist.js","sourceRoot":"","sources":["../../../src/store/internal/persist.ts"],"names":[],"mappings":";;;AAAA,oDAAmF;AACnF,wEAAmE;AACnE,2DAAiE;AACjE,uDAAgE;AAEhE,qDAAuD;AAGvD,iDAAsE;AAEtE,wDAAwD;AACxD,KAAK,UAAU,OAAO,CACpB,OAAqB,EACrB,UAAyC,EACzC,KAAa;IAEb,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,UAAU;QAAE,OAAO;IAC9C,MAAM,IAAA,0BAAgB,EAAC,OAAO,CAAC,SAAS,EAAE,IAAA,+BAAa,EAAC,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AAChG,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,KAAK,wBACV,OAAqB,EACrB,MAAuB,EACvB,QAA4B;IAE5B,IAAI,UAAU,GAAG,QAAQ,CAAC;IAC1B,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,UAAU,GAAG,MAAM,IAAA,oCAAmB,EAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,MAAM,IAAA,yBAAiB,EAAC,GAAG,EAAE,CAC3B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CACnE,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GACX,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,uBAAe,CAAC,EAAE;YAC1C,CAAC,CAAC,MAAM,IAAA,gCAAiB,EAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;YAC9D,CAAC,CAAC,YAAY,CAAC;QACnB,IAAI,OAAO,KAAK,YAAY;YAAE,MAAM,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAChF,IAAI,OAAO,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;IACxC,CAAC;IACD,MAAM,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;AAClE,CAAC"}

package/dist/store/internal/query.d.ts

@@ -1,6 +0,0 @@
-import type { QueryCommandInput, ScanCommandInput } from '@aws-sdk/lib-dynamodb';
-/** Query input for a scoped prefix (PK = prefix[0], optional SK begins_with). */
-export declare function scopedQuery(tableName: string, prefix: string[]): QueryCommandInput;
-/** Scan input for the rootless case, filtered to store items only. */
-export declare function storeScan(tableName: string): ScanCommandInput;
-//# sourceMappingURL=query.d.ts.map

package/dist/store/internal/query.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/store/internal/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIjF,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAgBlF;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAM7D"}

package/dist/store/internal/query.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.scopedQuery = scopedQuery;
-exports.storeScan = storeScan;
-const keys_1 = require("./keys");
-/** Query input for a scoped prefix (PK = prefix[0], optional SK begins_with). */
-function scopedQuery(tableName, prefix) {
-    const skPrefix = (0, keys_1.sortKeyPrefix)(prefix);
-    if (skPrefix.length === 0) {
-        return {
-            TableName: tableName,
-            KeyConditionExpression: '#pk = :pk',
-            ExpressionAttributeNames: { '#pk': 'PK' },
-            ExpressionAttributeValues: { ':pk': (0, keys_1.partitionKey)(prefix) },
-        };
-    }
-    return {
-        TableName: tableName,
-        KeyConditionExpression: '#pk = :pk AND begins_with(#sk, :skp)',
-        ExpressionAttributeNames: { '#pk': 'PK', '#sk': 'SK' },
-        ExpressionAttributeValues: { ':pk': (0, keys_1.partitionKey)(prefix), ':skp': skPrefix },
-    };
-}
-/** Scan input for the rootless case, filtered to store items only. */
-function storeScan(tableName) {
-    return {
-        TableName: tableName,
-        FilterExpression: 'attribute_exists(#ns)',
-        ExpressionAttributeNames: { '#ns': 'namespace' },
-    };
-}
-//# sourceMappingURL=query.js.map

package/dist/store/internal/query.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/store/internal/query.ts"],"names":[],"mappings":";;;;AAEA,iCAAqD;AAErD,iFAAiF;AACjF,qBAA4B,SAAiB,EAAE,MAAgB;IAC7D,MAAM,QAAQ,GAAG,IAAA,oBAAa,EAAC,MAAM,CAAC,CAAC;IACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,SAAS,EAAE,SAAS;YACpB,sBAAsB,EAAE,WAAW;YACnC,wBAAwB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;YACzC,yBAAyB,EAAE,EAAE,KAAK,EAAE,IAAA,mBAAY,EAAC,MAAM,CAAC,EAAE;SAC3D,CAAC;IACJ,CAAC;IACD,OAAO;QACL,SAAS,EAAE,SAAS;QACpB,sBAAsB,EAAE,sCAAsC;QAC9D,wBAAwB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;QACtD,yBAAyB,EAAE,EAAE,KAAK,EAAE,IAAA,mBAAY,EAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE;KAC7E,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,mBAA0B,SAAiB;IACzC,OAAO;QACL,SAAS,EAAE,SAAS;QACpB,gBAAgB,EAAE,uBAAuB;QACzC,wBAAwB,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;KACjD,CAAC;AACJ,CAAC"}

package/dist/store/internal/ranker.d.ts

@@ -1,13 +0,0 @@
-import type { Item, SearchItem } from '@langchain/langgraph-checkpoint';
-/** A decoded item plus its stored embedding, awaiting ranking. */
-export interface RankCandidate {
-    item: Item;
-    embedding?: number[];
-}
-/**
- * Rank candidates by cosine similarity to `queryVector`, descending. Throws a
- * {@link ValidationError} when the candidate count exceeds `maxCandidates`
- * (steer large corpora to an external VectorBackend).
- */
-export declare function rankInMemory(candidates: RankCandidate[], queryVector: number[], maxCandidates: number): SearchItem[];
-//# sourceMappingURL=ranker.d.ts.map

package/dist/store/internal/ranker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ranker.d.ts","sourceRoot":"","sources":["../../../src/store/internal/ranker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAQxE,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,aAAa,EAAE,EAC3B,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,GACpB,UAAU,EAAE,CAiBd"}

package/dist/store/internal/ranker.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.rankInMemory = rankInMemory;
-const errors_1 = require("../../shared/errors/errors");
-const semantic_search_1 = require("./semantic-search");
-/** Sort weight for an item without an embedding; below the −1 cosine minimum. */
-const UNSCORED_RANK = -2;
-/**
- * Rank candidates by cosine similarity to `queryVector`, descending. Throws a
- * {@link ValidationError} when the candidate count exceeds `maxCandidates`
- * (steer large corpora to an external VectorBackend).
- */
-function rankInMemory(candidates, queryVector, maxCandidates) {
-    if (candidates.length > maxCandidates) {
-        throw new errors_1.ValidationError(`Semantic search candidate set (${candidates.length}) exceeds maxSearchCandidates ` +
-            `(${maxCandidates}); use a dedicated VectorBackend for large corpora`, 'maxSearchCandidates');
-    }
-    return candidates
-        .map(({ item, embedding }) => ({
-        ...item,
-        score: embedding && embedding.length === queryVector.length
-            ? (0, semantic_search_1.cosineSimilarity)(queryVector, embedding)
-            : undefined,
-    }))
-        .sort((a, b) => rankValue(b) - rankValue(a));
-}
-/** Sort weight: real cosine score, or a value below the cosine minimum for unscored items. */
-function rankValue(item) {
-    return item.score ?? UNSCORED_RANK;
-}
-//# sourceMappingURL=ranker.js.map

package/dist/store/internal/ranker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ranker.js","sourceRoot":"","sources":["../../../src/store/internal/ranker.ts"],"names":[],"mappings":";;;AAEA,uDAA6D;AAC7D,uDAAqD;AAErD,iFAAiF;AACjF,MAAM,aAAa,GAAG,CAAC,CAAC,CAAC;AAQzB;;;;GAIG;AACH,sBACE,UAA2B,EAC3B,WAAqB,EACrB,aAAqB;IAErB,IAAI,UAAU,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACtC,MAAM,IAAI,wBAAe,CACvB,kCAAkC,UAAU,CAAC,MAAM,gCAAgC;YACjF,IAAI,aAAa,oDAAoD,EACvE,qBAAqB,CACtB,CAAC;IACJ,CAAC;IACD,OAAO,UAAU;SACd,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7B,GAAG,IAAI;QACP,KAAK,EACH,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM;YAClD,CAAC,CAAC,IAAA,kCAAgB,EAAC,WAAW,EAAE,SAAS,CAAC;YAC1C,CAAC,CAAC,SAAS;KAChB,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,8FAA8F;AAC9F,SAAS,SAAS,CAAC,IAAgB;IACjC,OAAO,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC;AACrC,CAAC"}

package/dist/store/internal/read-existing.d.ts

@@ -1,19 +0,0 @@
-import type { PayloadDescriptor } from '../../shared/codec/codec';
-import type { StoreContext } from './setup';
-/** The previous row's createdAt, payload descriptor and revision. */
-export interface ExistingRecordMeta {
-    exists: boolean;
-    createdAt?: string;
-    value?: PayloadDescriptor;
-    revision?: string;
-}
-/**
- * Read the fields a put needs from the row it is about to replace, in one
- * strongly-consistent projection: `createdAt` to preserve, `value` to clean up
- * afterwards, and the revision the compare-and-swap pins.
- *
- * Lives apart from `actions/put.ts` so `persist.ts` can re-read on a lost swap
- * without importing its own caller.
- */
-export declare function readExisting(context: StoreContext, pk: string, sk: string): Promise<ExistingRecordMeta>;
-//# sourceMappingURL=read-existing.d.ts.map

package/dist/store/internal/read-existing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"read-existing.d.ts","sourceRoot":"","sources":["../../../src/store/internal/read-existing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,kBAAkB,CAAC,CAgB7B"}

package/dist/store/internal/read-existing.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readExisting = readExisting;
-const conditional_put_1 = require("../../shared/dynamodb/conditional-put");
-const retry_1 = require("../../shared/dynamodb/retry");
-/**
- * Read the fields a put needs from the row it is about to replace, in one
- * strongly-consistent projection: `createdAt` to preserve, `value` to clean up
- * afterwards, and the revision the compare-and-swap pins.
- *
- * Lives apart from `actions/put.ts` so `persist.ts` can re-read on a lost swap
- * without importing its own caller.
- */
-async function readExisting(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, #v, #r',
-        ExpressionAttributeNames: { '#c': 'createdAt', '#v': 'value', '#r': conditional_put_1.REVISION_ATTRIBUTE },
-    }));
-    return {
-        exists: existing.Item !== undefined,
-        createdAt: existing.Item?.createdAt,
-        value: existing.Item?.value,
-        revision: existing.Item?.[conditional_put_1.REVISION_ATTRIBUTE],
-    };
-}
-//# sourceMappingURL=read-existing.js.map

package/dist/store/internal/read-existing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"read-existing.js","sourceRoot":"","sources":["../../../src/store/internal/read-existing.ts"],"names":[],"mappings":";;;AACA,2EAA2E;AAC3E,uDAAgE;AAWhE;;;;;;;GAOG;AACI,KAAK,uBACV,OAAqB,EACrB,EAAU,EACV,EAAU;IAEV,MAAM,QAAQ,GAAG,MAAM,IAAA,yBAAiB,EAAC,GAAG,EAAE,CAC5C,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACvB,cAAc,EAAE,IAAI;QACpB,oBAAoB,EAAE,YAAY;QAClC,wBAAwB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,oCAAkB,EAAE;KACzF,CAAC,CACH,CAAC;IACF,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,IAAI,KAAK,SAAS;QACnC,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,SAA+B;QACzD,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAsC;QAC5D,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,oCAAkB,CAAuB;KACpE,CAAC;AACJ,CAAC"}

package/dist/store/internal/score-direction.d.ts

@@ -1,32 +0,0 @@
-import type { VectorMatch } from '../vector-backend';
-/** Which direction a {@link VectorBackend} reports its score in. */
-export type VectorScoreDirection = 'relevance' | 'distance';
-/** Every direction {@link toRelevanceScores} recognises, for validating input. */
-export declare const VECTOR_SCORE_DIRECTIONS: readonly VectorScoreDirection[];
-/**
- * Normalise a backend's matches to the relevance direction upstream
- * `SearchItem.score` documents — "higher scores indicate better matches",
- * typically a cosine similarity between -1 and 1.
- *
- * A distance is converted by **negation** rather than `1 / (1 + d)`: negation
- * is monotone over the whole real line, needs no non-negativity precondition,
- * and is exactly invertible, so the original distance is simply `-score`. A
- * reciprocal would silently imply a different `(0, 1]` scale and is undefined
- * at `d === -1`. Negative scores are already in range for this contract, so
- * nothing is lost by producing them.
- *
- * Results are re-sorted after conversion so a backend that returns its matches
- * in some other order still ranks correctly. Anything that is not `'distance'`
- * is returned untouched — its own order stays authoritative, exactly as before.
- *
- * The test is for `'distance'` rather than against `'relevance'` on purpose:
- * converting is the destructive branch, so only the exact value that asks for
- * it may reach it. Testing the other way round made every unrecognised
- * string — `'Distance'`, a typo, a value read from a config file — reverse the
- * ranking silently, with no error and no warning (the ascending-score warning
- * lives downstream of this conversion, so it could never fire). `setUpStore`
- * rejects such a value outright; this keeps the failure harmless for any
- * caller that reaches the function some other way.
- */
-export declare function toRelevanceScores(matches: VectorMatch[], direction: VectorScoreDirection): VectorMatch[];
-//# sourceMappingURL=score-direction.d.ts.map

package/dist/store/internal/score-direction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"score-direction.d.ts","sourceRoot":"","sources":["../../../src/store/internal/score-direction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,UAAU,CAAC;AAE5D,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,EAAE,SAAS,oBAAoB,EAA8B,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EAAE,EACtB,SAAS,EAAE,oBAAoB,GAC9B,WAAW,EAAE,CAKf"}

package/dist/store/internal/score-direction.js

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VECTOR_SCORE_DIRECTIONS = void 0;
-exports.toRelevanceScores = toRelevanceScores;
-/** Every direction {@link toRelevanceScores} recognises, for validating input. */
-exports.VECTOR_SCORE_DIRECTIONS = ['relevance', 'distance'];
-/**
- * Normalise a backend's matches to the relevance direction upstream
- * `SearchItem.score` documents — "higher scores indicate better matches",
- * typically a cosine similarity between -1 and 1.
- *
- * A distance is converted by **negation** rather than `1 / (1 + d)`: negation
- * is monotone over the whole real line, needs no non-negativity precondition,
- * and is exactly invertible, so the original distance is simply `-score`. A
- * reciprocal would silently imply a different `(0, 1]` scale and is undefined
- * at `d === -1`. Negative scores are already in range for this contract, so
- * nothing is lost by producing them.
- *
- * Results are re-sorted after conversion so a backend that returns its matches
- * in some other order still ranks correctly. Anything that is not `'distance'`
- * is returned untouched — its own order stays authoritative, exactly as before.
- *
- * The test is for `'distance'` rather than against `'relevance'` on purpose:
- * converting is the destructive branch, so only the exact value that asks for
- * it may reach it. Testing the other way round made every unrecognised
- * string — `'Distance'`, a typo, a value read from a config file — reverse the
- * ranking silently, with no error and no warning (the ascending-score warning
- * lives downstream of this conversion, so it could never fire). `setUpStore`
- * rejects such a value outright; this keeps the failure harmless for any
- * caller that reaches the function some other way.
- */
-function toRelevanceScores(matches, direction) {
-    if (direction !== 'distance')
-        return matches;
-    return matches
-        .map((match) => ({ ...match, score: -match.score }))
-        .sort((left, right) => right.score - left.score);
-}
-//# sourceMappingURL=score-direction.js.map

package/dist/store/internal/score-direction.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"score-direction.js","sourceRoot":"","sources":["../../../src/store/internal/score-direction.ts"],"names":[],"mappings":";;;;AAKA,kFAAkF;AACrE,QAAA,uBAAuB,GAAoC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,2BACE,OAAsB,EACtB,SAA+B;IAE/B,IAAI,SAAS,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC;IAC7C,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;SACnD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC"}

package/dist/store/internal/search-filter.d.ts

@@ -1,4 +0,0 @@
-import type { Item, SearchOperation } from '@langchain/langgraph-checkpoint';
-/** True when `item` satisfies the search operation's optional metadata filter. */
-export declare function passesFilter(item: Item, op: SearchOperation): boolean;
-//# sourceMappingURL=search-filter.d.ts.map

package/dist/store/internal/search-filter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"search-filter.d.ts","sourceRoot":"","sources":["../../../src/store/internal/search-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAI7E,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,eAAe,GAAG,OAAO,CAMrE"}

package/dist/store/internal/search-filter.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.passesFilter = passesFilter;
-const filter_1 = require("./filter");
-/** True when `item` satisfies the search operation's optional metadata filter. */
-function passesFilter(item, op) {
-    if (!op.filter)
-        return true;
-    return (0, filter_1.matchesStoreFilter)(item.value, op.filter);
-}
-//# sourceMappingURL=search-filter.js.map

package/dist/store/internal/search-filter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"search-filter.js","sourceRoot":"","sources":["../../../src/store/internal/search-filter.ts"],"names":[],"mappings":";;;AAEA,qCAA8D;AAE9D,kFAAkF;AAClF,sBAA6B,IAAU,EAAE,EAAmB;IAC1D,IAAI,CAAC,EAAE,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,IAAA,2BAAkB,EACvB,IAAI,CAAC,KAAkC,EACvC,EAAE,CAAC,MAAmC,CACvC,CAAC;AACJ,CAAC"}

package/dist/store/internal/semantic-search.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"semantic-search.d.ts","sourceRoot":"","sources":["../../../src/store/internal/semantic-search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAYjE;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAOtF;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAChC,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAK/B"}

package/dist/store/internal/semantic-search.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"semantic-search.js","sourceRoot":"","sources":["../../../src/store/internal/semantic-search.ts"],"names":[],"mappings":";;;;;AAAA,0EAAgE;AAKhE,oFAAoF;AACpF,0BAAiC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACzC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,gFAAgF;AAChF,qBAA4B,KAAgC,EAAE,MAAgB;IAC5E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,KAAK,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;;YAChD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAA,oCAAa,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACI,KAAK,qBACV,OAAqB,EACrB,KAAgC,EAChC,cAAyB;IAEzB,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACjF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC"}

package/dist/store/internal/setup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/store/internal/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAEvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAQ9D,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEvF,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,UAAU,EAAE,OAAO,CAAC;CACrB;AA4CD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAoCpE"}

package/dist/store/internal/setup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/store/internal/setup.ts"],"names":[],"mappings":";;;AAMA,8DAA2D;AAC3D,yDAAuE;AACvE,+DAA8D;AAC9D,sDAIgC;AAChC,yDAAqE;AACrE,uDAA6D;AAC7D,wDAAyE;AAIzE,uDAAuF;AAyBvF;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CAAC,KAAmB;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,UAAU,GAAoC,KAAK,CAAC,UAAU,CAAC;IACrE,IAAI,OAAO,UAAU,EAAE,UAAU,KAAK,UAAU,EAAE,CAAC;QACjD,MAAM,IAAI,wBAAe,CACvB,iFAAiF;YAC/E,gEAAgE,EAClE,OAAO,CACR,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,oBAAoB,CAAC,SAAgC;IAC5D,IAAI,SAAS,KAAK,SAAS,IAAI,yCAAuB,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO;IACnF,MAAM,IAAI,wBAAe,CACvB,uCAAuC,yCAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa;QACrF,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,2DAA2D;QACvF,yCAAyC,EAC3C,sBAAsB,CACvB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,oBAA2B,OAA6B;IACtD,IAAI,OAAO,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC5C,MAAM,IAAI,wBAAe,CACvB,qFAAqF;YACnF,uFAAuF;YACvF,8BAA8B,EAChC,eAAe,CAChB,CAAC;IACJ,CAAC;IACD,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,oBAAoB,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAChD,OAAO;QACL,OAAO,EAAE;YACP,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,uBAAU;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,EAAE;gBACnB,CAAC,CAAC,IAAI,uBAAW,CAAC;oBACd,GAAG,OAAO,CAAC,EAAE;oBACb,SAAS,EACP,OAAO,CAAC,EAAE,CAAC,SAAS,IAAI,IAAA,gCAAuB,EAAC,iCAAqB,EAAE,OAAO,CAAC;iBAClF,CAAC;gBACJ,CAAC,CAAC,SAAS;YACb,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,IAAA,sBAAa,EAAC,OAAO,CAAC,MAAM,CAAC;YACrC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,WAAW;YACjE,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,yCAA6B;YACjF,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,qCAAyB;SAChE;QACD,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC;AACJ,CAAC"}

package/dist/store/internal/validation.d.ts

@@ -1,13 +0,0 @@
-/** Validate search/listNamespaces paging is non-negative integers. */
-export declare function validatePaging(offset: number, limit: number): void;
-/** Validate the namespace is non-empty and each element is a valid identifier. */
-export declare function validateNamespace(namespace: string[]): void;
-/** Validate an item key is a non-empty, separator- and control-char-free string. */
-export declare function validateKey(key: string): void;
-/**
- * Validate an optional namespace depth cap. Left unchecked, a negative value
- * silently inverted truncation via `Array.prototype.slice(0, -n)`, which drops
- * the *last* n elements rather than erroring.
- */
-export declare function validateMaxDepth(maxDepth?: number): void;
-//# sourceMappingURL=validation.d.ts.map

package/dist/store/internal/validation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/store/internal/validation.ts"],"names":[],"mappings":"AAOA,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGlE;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAK3D;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAGxD"}

package/dist/store/internal/validation.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validatePaging = validatePaging;
-exports.validateNamespace = validateNamespace;
-exports.validateKey = validateKey;
-exports.validateMaxDepth = validateMaxDepth;
-const primitives_1 = require("../../shared/validation/primitives");
-const keys_1 = require("./keys");
-/** Validate search/listNamespaces paging is non-negative integers. */
-function validatePaging(offset, limit) {
-    (0, primitives_1.validateInteger)(offset, 'offset', { min: 0 });
-    (0, primitives_1.validateInteger)(limit, 'limit', { min: 0 });
-}
-/** Validate the namespace is non-empty and each element is a valid identifier. */
-function validateNamespace(namespace) {
-    (0, primitives_1.validateNonEmptyArray)(namespace, 'namespace');
-    for (const element of namespace) {
-        (0, primitives_1.validateIdentifier)(element, keys_1.NAMESPACE_SEPARATOR, 'namespace element');
-    }
-}
-/** Validate an item key is a non-empty, separator- and control-char-free string. */
-function validateKey(key) {
-    (0, primitives_1.validateIdentifier)(key, keys_1.NAMESPACE_SEPARATOR, 'key');
-}
-/**
- * Validate an optional namespace depth cap. Left unchecked, a negative value
- * silently inverted truncation via `Array.prototype.slice(0, -n)`, which drops
- * the *last* n elements rather than erroring.
- */
-function validateMaxDepth(maxDepth) {
-    if (maxDepth === undefined)
-        return;
-    (0, primitives_1.validateInteger)(maxDepth, 'maxDepth', { min: 1 });
-}
-//# sourceMappingURL=validation.js.map

package/dist/store/internal/validation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/store/internal/validation.ts"],"names":[],"mappings":";;;;;;AAAA,mEAI4C;AAC5C,iCAA6C;AAE7C,sEAAsE;AACtE,wBAA+B,MAAc,EAAE,KAAa;IAC1D,IAAA,4BAAe,EAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAA,4BAAe,EAAC,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,kFAAkF;AAClF,2BAAkC,SAAmB;IACnD,IAAA,kCAAqB,EAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC9C,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;QAChC,IAAA,+BAAkB,EAAC,OAAO,EAAE,0BAAmB,EAAE,mBAAmB,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,qBAA4B,GAAW;IACrC,IAAA,+BAAkB,EAAC,GAAG,EAAE,0BAAmB,EAAE,KAAK,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,0BAAiC,QAAiB;IAChD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO;IACnC,IAAA,4BAAe,EAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/store/internal/write-verify.d.ts

@@ -1,37 +0,0 @@
-import type { StoreContext } from './setup';
-/** True when `error` is a {@link RetryExhaustedError} — by name, not `instanceof` (banned repo-wide). */
-export declare function isRetryExhausted(error: Error): boolean;
-/**
- * True when the row is confirmed absent — used to resolve an ambiguous
- * retry-exhausted *delete*, where the delete may well have landed server-side
- * and only its acknowledgement was lost. A failure reading this is not treated
- * as confirmation, which is fail-safe here: the caller only rethrows, and
- * nothing is deleted on the strength of a `false`.
- */
-export declare function rowIsAbsent(context: StoreContext, key: {
-    PK: string;
-    SK: string;
-}): Promise<boolean>;
-/** What a post-failure verification read could establish about a write. */
-export type WriteVerdict = 'landed' | 'not-landed' | 'unverified';
-/**
- * Read `record`'s row back to establish what an ambiguous write actually did.
- *
- * - `'landed'`: the row holds `expectedS3Key`, so the write committed
- *   server-side and only its acknowledgement was lost.
- * - `'not-landed'`: the row was read and holds something else, or nothing, so
- *   this call's own nonced upload is dead and safe to delete.
- * - `'unverified'`: the read itself failed, so nothing is established.
- *
- * The third answer used to be folded into the second as a plain `false`, which
- * made a partition that blocked both the put and this read delete the object a
- * possibly-live row points at — permanently breaking every later read of that
- * item. Only a *confirmed* non-commit may delete the new upload: leaking one
- * object (reclaimed by `ensureS3LifecycleRule`) is recoverable, stranding a
- * live row is not.
- */
-export declare function verifyWriteLanded(context: StoreContext, record: {
-    PK: string;
-    SK: string;
-}, expectedS3Key: string): Promise<WriteVerdict>;
-//# sourceMappingURL=write-verify.d.ts.map

package/dist/store/internal/write-verify.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"write-verify.d.ts","sourceRoot":"","sources":["../../../src/store/internal/write-verify.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,yGAAyG;AACzG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEtD;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9B,OAAO,CAAC,OAAO,CAAC,CAelB;AAED,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAClC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,YAAY,CAAC,CAkBvB"}

package/dist/store/internal/write-verify.js

@@ -1,68 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isRetryExhausted = isRetryExhausted;
-exports.rowIsAbsent = rowIsAbsent;
-exports.verifyWriteLanded = verifyWriteLanded;
-const codec_1 = require("../../shared/codec/codec");
-const retry_1 = require("../../shared/dynamodb/retry");
-/** True when `error` is a {@link RetryExhaustedError} — by name, not `instanceof` (banned repo-wide). */
-function isRetryExhausted(error) {
-    return error.name === 'RetryExhaustedError';
-}
-/**
- * True when the row is confirmed absent — used to resolve an ambiguous
- * retry-exhausted *delete*, where the delete may well have landed server-side
- * and only its acknowledgement was lost. A failure reading this is not treated
- * as confirmation, which is fail-safe here: the caller only rethrows, and
- * nothing is deleted on the strength of a `false`.
- */
-async function rowIsAbsent(context, key) {
-    try {
-        const result = await (0, retry_1.withDynamoDBRetry)(() => context.client.get({
-            TableName: context.tableName,
-            Key: key,
-            ConsistentRead: true,
-            ProjectionExpression: '#v',
-            ExpressionAttributeNames: { '#v': 'value' },
-        }));
-        return result.Item === undefined;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Read `record`'s row back to establish what an ambiguous write actually did.
- *
- * - `'landed'`: the row holds `expectedS3Key`, so the write committed
- *   server-side and only its acknowledgement was lost.
- * - `'not-landed'`: the row was read and holds something else, or nothing, so
- *   this call's own nonced upload is dead and safe to delete.
- * - `'unverified'`: the read itself failed, so nothing is established.
- *
- * The third answer used to be folded into the second as a plain `false`, which
- * made a partition that blocked both the put and this read delete the object a
- * possibly-live row points at — permanently breaking every later read of that
- * item. Only a *confirmed* non-commit may delete the new upload: leaking one
- * object (reclaimed by `ensureS3LifecycleRule`) is recoverable, stranding a
- * live row is not.
- */
-async function verifyWriteLanded(context, record, expectedS3Key) {
-    try {
-        const result = await (0, retry_1.withDynamoDBRetry)(() => context.client.get({
-            TableName: context.tableName,
-            Key: { PK: record.PK, SK: record.SK },
-            ConsistentRead: true,
-            ProjectionExpression: '#v',
-            ExpressionAttributeNames: { '#v': 'value' },
-        }));
-        const value = result.Item?.value;
-        return value?.location === codec_1.PayloadLocation.S3 && value.s3Key === expectedS3Key
-            ? 'landed'
-            : 'not-landed';
-    }
-    catch {
-        return 'unverified';
-    }
-}
-//# sourceMappingURL=write-verify.js.map

package/dist/store/internal/write-verify.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"write-verify.js","sourceRoot":"","sources":["../../../src/store/internal/write-verify.ts"],"names":[],"mappings":";;;;;AAAA,oDAAmF;AACnF,uDAAgE;AAGhE,yGAAyG;AACzG,0BAAiC,KAAY;IAC3C,OAAO,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACI,KAAK,sBACV,OAAqB,EACrB,GAA+B;IAE/B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAiB,EAAC,GAAG,EAAE,CAC1C,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;YACjB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,GAAG,EAAE,GAAG;YACR,cAAc,EAAE,IAAI;YACpB,oBAAoB,EAAE,IAAI;YAC1B,wBAAwB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SAC5C,CAAC,CACH,CAAC;QACF,OAAO,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAKD;;;;;;;;;;;;;;;GAeG;AACI,KAAK,4BACV,OAAqB,EACrB,MAAkC,EAClC,aAAqB;IAErB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAiB,EAAC,GAAG,EAAE,CAC1C,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;YACjB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,GAAG,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE;YACrC,cAAc,EAAE,IAAI;YACpB,oBAAoB,EAAE,IAAI;YAC1B,wBAAwB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SAC5C,CAAC,CACH,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,KAAsC,CAAC;QAClE,OAAO,KAAK,EAAE,QAAQ,KAAK,uBAAe,CAAC,EAAE,IAAI,KAAK,CAAC,KAAK,KAAK,aAAa;YAC5E,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,YAAY,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC;IACtB,CAAC;AACH,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store/store.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAET,KAAK,SAAS,EACd,KAAK,gBAAgB,EAEtB,MAAM,iCAAiC,CAAC;AAMzC,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,kCAAkC,CAAC;AAG1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAIpD;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6C;IAEvE,YAAY,OAAO,EAAE,oBAAoB,EAMxC;IAED,OAAO,CAAC,QAAQ;IAOV,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,EAAE,UAAU,EAAE,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAMjF;IAED;;;OAGG;IACH,oBAAoB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAE9E;IAED,yEAAyE;IACzE,OAAO,IAAI,IAAI,CAGd;IAED;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3C;CACF"}

package/dist/store/store.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/store/store.ts"],"names":[],"mappings":";;;AAAA,0EAMyC;AAEzC,kDAA8D;AAC9D,uCAAwC;AACxC,+DAA2D;AAC3D,uCAAwC;AACxC,6EAG0C;AAC1C,6CAA+C;AAC/C,4CAAiE;AAKjE;;;;GAIG;AACH,mBAA2B,SAAQ,gCAAS;IACzB,OAAO,CAAe;IACtB,UAAU,CAAU;IACpB,SAAS,CAA6C;IAEvE,YAAY,OAA6B;QACvC,KAAK,EAAE,CAAC;QACR,MAAM,KAAK,GAAG,IAAA,kBAAU,EAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IACnC,CAAC;IAEO,QAAQ,CAAC,SAAoB;QACnC,IAAI,iBAAiB,IAAI,SAAS;YAAE,OAAO,IAAA,oBAAW,EAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAChF,IAAI,OAAO,IAAI,SAAS;YAAE,OAAO,IAAA,aAAO,EAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAClE,IAAI,KAAK,IAAI,SAAS;YAAE,OAAO,IAAA,aAAO,EAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;QACzF,OAAO,IAAA,gCAAc,EAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,KAAK,CAAyB,UAAc;QAChD,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,OAA+B,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,oBAAoB,CAAC,eAAyB;QAC5C,OAAO,IAAA,6CAA0B,EAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACnE,CAAC;IAED,yEAAyE;IACzE,OAAO;QACL,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,UAAU;YAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;IACjD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG;YAAE,OAAO;QACzD,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAA,wBAAkB,EAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACzF,CAAC;CACF"}

package/dist/store/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAEvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,yCAAyC;AACzC,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,GACnD,YAAY,GAAG;IACb,0EAA0E;IAC1E,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,sEAAsE;IACtE,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,mFAAmF;IACnF,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gJAAgJ;IAChJ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C,CAAC;AAEJ,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}

package/dist/store/types.js.map

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

package/dist/store/vector-backend.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vector-backend.d.ts","sourceRoot":"","sources":["../../src/store/vector-backend.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;;;;OAWG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E;;;;OAIG;IACH,KAAK,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9F,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD;;;;OAIG;IACH,QAAQ,CAAC,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CAC5D"}

package/dist/store/vector-backend.js.map

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