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

package/dist/history/internal/item-mapper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"item-mapper.js","sourceRoot":"","sources":["../../../src/history/internal/item-mapper.ts"],"names":[],"mappings":";;;;AAEA,oDAAwF;AAExF,iCAA0D;AAG1D,SAAS,SAAS,CAAC,OAAuB;IACxC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;AAClG,CAAC;AAED;;;;GAIG;AACI,KAAK,2BACV,OAAuB,EACvB,SAAiB,EACjB,IAAY,EACZ,OAAsB,EACtB,YAAqB;IAErB,MAAM,UAAU,GAAG,MAAM,IAAA,qBAAa,EAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE;QAClE,QAAQ,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC;KAC5B,CAAC,CAAC;IACH,MAAM,IAAI,GAAoB;QAC5B,EAAE,EAAE,IAAA,uBAAgB,EAAC,SAAS,CAAC;QAC/B,EAAE,EAAE,IAAA,qBAAc,EAAC,IAAI,CAAC;QACxB,SAAS;QACT,OAAO,EAAE,UAAU;KACpB,CAAC;IACF,IAAI,YAAY,KAAK,SAAS;QAAE,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iEAAiE;AAC1D,KAAK,4BACV,OAAuB,EACvB,IAAqB;IAErB,OAAO,IAAA,qBAAa,EAAgB,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/dist/history/internal/keys.d.ts

@@ -1,17 +0,0 @@
-/** Reserved separator joining sort-key segments; forbidden inside a session id. */
-export declare const SORT_KEY_SEPARATOR = "#";
-/** Fixed sort key for the per-session metadata item. */
-export declare const SESSION_SORT_KEY = "HISTORY#SESSION";
-/** Partition key for a chat session: the adapter tag plus the session id. */
-export declare function sessionPartition(sessionId: string): string;
-/** Sort key for a single message item, ordered by its monotonic ULID. */
-export declare function messageSortKey(ulid: string): string;
-/**
- * True when `sortKey` is one this adapter writes. A partition query carries no
- * sort-key condition, so a partition-wide delete uses this to leave any row it
- * does not own in place rather than deleting the whole partition blindly.
- */
-export declare function isHistorySortKey(sortKey: string): boolean;
-/** `begins_with` prefix selecting every message item in a session. */
-export declare function messageSortKeyPrefix(): string;
-//# sourceMappingURL=keys.d.ts.map

package/dist/history/internal/keys.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/history/internal/keys.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAatC,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,oBAA6B,CAAC;AAW3D,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/history/internal/keys.js

@@ -1,49 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SESSION_SORT_KEY = exports.SORT_KEY_SEPARATOR = void 0;
-exports.sessionPartition = sessionPartition;
-exports.messageSortKey = messageSortKey;
-exports.isHistorySortKey = isHistorySortKey;
-exports.messageSortKeyPrefix = messageSortKeyPrefix;
-/** Reserved separator joining sort-key segments; forbidden inside a session id. */
-exports.SORT_KEY_SEPARATOR = '#';
-/**
- * Item-kind tag distinguishing this adapter's sort keys from another
- * adapter's on a table shared via `DynamoDBFactory.createAll()` — matches the
- * pattern the checkpointer module already uses for its own META#/PAYLOAD#/
- * WRITE# keys. Without it, `SESSION_SORT_KEY` alone was a bare, common-word
- * literal a store caller could produce by accident (e.g.
- * `store.put([sessionId], 'SESSION', ...)`, since `sortKey` collapses a
- * single-element namespace down to just the key).
- */
-const ADAPTER_PREFIX = `HISTORY${exports.SORT_KEY_SEPARATOR}`;
-/** Fixed sort key for the per-session metadata item. */
-exports.SESSION_SORT_KEY = `${ADAPTER_PREFIX}SESSION`;
-const MESSAGE_PREFIX = `${ADAPTER_PREFIX}MSG#`;
-/**
- * Adapter tag prefixed to every chat-history partition key — see the
- * equivalent in checkpointer/internal/keys.ts for why the three adapters'
- * partitions must not overlap on a shared table.
- */
-const ADAPTER_PARTITION_PREFIX = `HIST${exports.SORT_KEY_SEPARATOR}`;
-/** Partition key for a chat session: the adapter tag plus the session id. */
-function sessionPartition(sessionId) {
-    return `${ADAPTER_PARTITION_PREFIX}${sessionId}`;
-}
-/** Sort key for a single message item, ordered by its monotonic ULID. */
-function messageSortKey(ulid) {
-    return `${MESSAGE_PREFIX}${ulid}`;
-}
-/**
- * True when `sortKey` is one this adapter writes. A partition query carries no
- * sort-key condition, so a partition-wide delete uses this to leave any row it
- * does not own in place rather than deleting the whole partition blindly.
- */
-function isHistorySortKey(sortKey) {
-    return sortKey.startsWith(ADAPTER_PREFIX);
-}
-/** `begins_with` prefix selecting every message item in a session. */
-function messageSortKeyPrefix() {
-    return MESSAGE_PREFIX;
-}
-//# sourceMappingURL=keys.js.map

package/dist/history/internal/keys.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/history/internal/keys.ts"],"names":[],"mappings":";;;;;;;AAAA,mFAAmF;AACtE,QAAA,kBAAkB,GAAG,GAAG,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,cAAc,GAAG,UAAU,QAAA,kBAAkB,EAAE,CAAC;AAEtD,wDAAwD;AAC3C,QAAA,gBAAgB,GAAG,GAAG,cAAc,SAAS,CAAC;AAE3D,MAAM,cAAc,GAAG,GAAG,cAAc,MAAM,CAAC;AAE/C;;;;GAIG;AACH,MAAM,wBAAwB,GAAG,OAAO,QAAA,kBAAkB,EAAE,CAAC;AAE7D,6EAA6E;AAC7E,0BAAiC,SAAiB;IAChD,OAAO,GAAG,wBAAwB,GAAG,SAAS,EAAE,CAAC;AACnD,CAAC;AAED,yEAAyE;AACzE,wBAA+B,IAAY;IACzC,OAAO,GAAG,cAAc,GAAG,IAAI,EAAE,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,0BAAiC,OAAe;IAC9C,OAAO,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AAC5C,CAAC;AAED,sEAAsE;AACtE;IACE,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/history/internal/message-chunker.d.ts

@@ -1,14 +0,0 @@
-import type { ChatMessageItem } from '../types';
-/**
- * Conservatively estimate a message item's stored size, so chunks can stay under
- * the DynamoDB transaction byte limit. The overhead allowance keeps the estimate
- * on the safe side of the real marshalled size.
- */
-export declare function estimateItemBytes(item: ChatMessageItem): number;
-/**
- * Split message items into transaction-sized chunks bounded by both the item
- * count and the aggregate byte budget. A single item larger than the budget is
- * placed alone rather than dropped.
- */
-export declare function chunkBySize(items: ChatMessageItem[], maxItems: number, maxBytes: number): ChatMessageItem[][];
-//# sourceMappingURL=message-chunker.d.ts.map

package/dist/history/internal/message-chunker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"message-chunker.d.ts","sourceRoot":"","sources":["../../../src/history/internal/message-chunker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AA4BhD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAQ/D;AAaD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EAAE,EACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,eAAe,EAAE,EAAE,CAgBrB"}

package/dist/history/internal/message-chunker.js

@@ -1,68 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.estimateItemBytes = estimateItemBytes;
-exports.chunkBySize = chunkBySize;
-const codec_1 = require("../../shared/codec/codec");
-/**
- * Per-item allowance added to the measured field bytes to cover what the size
- * estimate does not count directly: DynamoDB attribute names, the document
- * marshalling envelope, and descriptor scaffolding. Deliberately generous so the
- * estimate stays at or above the real marshalled item size and chunks never
- * overshoot the transaction byte limit.
- */
-const ITEM_OVERHEAD_BYTES = 256;
-/**
- * Byte length of a string as DynamoDB stores it. `String.length` counts UTF-16
- * code units, which understates every non-ASCII character — the wrong
- * direction for an estimate documented to sit at or above the real size.
- */
-function utf8Bytes(value) {
-    return Buffer.byteLength(value, 'utf8');
-}
-function descriptorBytes(descriptor) {
-    const body = descriptor.location === codec_1.PayloadLocation.INLINE
-        ? descriptor.bytes.length
-        : utf8Bytes(descriptor.s3Key);
-    return body + utf8Bytes(descriptor.serdeType);
-}
-/**
- * Conservatively estimate a message item's stored size, so chunks can stay under
- * the DynamoDB transaction byte limit. The overhead allowance keeps the estimate
- * on the safe side of the real marshalled size.
- */
-function estimateItemBytes(item) {
-    return (utf8Bytes(item.PK) +
-        utf8Bytes(item.SK) +
-        utf8Bytes(item.sessionId) +
-        descriptorBytes(item.message) +
-        ITEM_OVERHEAD_BYTES);
-}
-function shouldFlush(count, bytes, next, max, maxBytes) {
-    if (count === 0)
-        return false;
-    return count >= max || bytes + next > maxBytes;
-}
-/**
- * Split message items into transaction-sized chunks bounded by both the item
- * count and the aggregate byte budget. A single item larger than the budget is
- * placed alone rather than dropped.
- */
-function chunkBySize(items, maxItems, maxBytes) {
-    const chunks = [];
-    let current = [];
-    let currentBytes = 0;
-    for (const item of items) {
-        const size = estimateItemBytes(item);
-        if (shouldFlush(current.length, currentBytes, size, maxItems, maxBytes)) {
-            chunks.push(current);
-            current = [];
-            currentBytes = 0;
-        }
-        current.push(item);
-        currentBytes += size;
-    }
-    if (current.length > 0)
-        chunks.push(current);
-    return chunks;
-}
-//# sourceMappingURL=message-chunker.js.map

package/dist/history/internal/message-chunker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"message-chunker.js","sourceRoot":"","sources":["../../../src/history/internal/message-chunker.ts"],"names":[],"mappings":";;;;AAAA,oDAAmF;AAGnF;;;;;;GAMG;AACH,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC;;;;GAIG;AACH,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,eAAe,CAAC,UAA6B;IACpD,MAAM,IAAI,GACR,UAAU,CAAC,QAAQ,KAAK,uBAAe,CAAC,MAAM;QAC5C,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM;QACzB,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,2BAAkC,IAAqB;IACrD,OAAO,CACL,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAClB,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAClB,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;QACzB,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;QAC7B,mBAAmB,CACpB,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,KAAa,EACb,KAAa,EACb,IAAY,EACZ,GAAW,EACX,QAAgB;IAEhB,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,KAAK,IAAI,GAAG,IAAI,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,qBACE,KAAwB,EACxB,QAAgB,EAChB,QAAgB;IAEhB,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,IAAI,OAAO,GAAsB,EAAE,CAAC;IACpC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;YACxE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,GAAG,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,YAAY,IAAI,IAAI,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/history/internal/message-transaction.d.ts

@@ -1,26 +0,0 @@
-import type { ChatMessageItem } from '../types';
-import { type SessionUpdateFields } from './session-update';
-import type { HistoryContext } from './setup';
-/** Per-call retry seams (injected in tests to keep backoff instant). */
-export interface ChunkRetryOptions {
-    rng?: () => number;
-    signal?: AbortSignal;
-}
-/**
- * Atomically write a chunk of message items together with the session-metadata
- * count update in one {@link https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactWriteItems.html | TransactWriteItems}
- * call, so `messageCount` can never disagree with the messages that landed. A
- * single `ClientRequestToken` is used per attempt so a re-sent commit (e.g.
- * after a lost response) is idempotent and never double-applies the count
- * `ADD`. When `fields.forceTtlRefresh` is set, the session update carries a
- * monotonic ConditionExpression (see session-update.ts); if — and only if —
- * that specific condition loses a race against a concurrent caller who just
- * healed the same anchor, this retries the identical chunk once with
- * `forceTtlRefresh: false` (safe: `if_not_exists` then converges to whatever
- * already won) rather than losing the message writes to a benign ttl race. A
- * cancellation caused by any other item (a genuine message-row conflict) is
- * not retried here — it propagates for the normal transient-conflict retry
- * budget inside `withDynamoDBRetry` to handle, or to the caller otherwise.
- */
-export declare function writeMessageChunk(context: HistoryContext, items: ChatMessageItem[], fields: SessionUpdateFields, retry?: ChunkRetryOptions): Promise<void>;
-//# sourceMappingURL=message-transaction.d.ts.map

package/dist/history/internal/message-transaction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"message-transaction.d.ts","sourceRoot":"","sources":["../../../src/history/internal/message-transaction.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAuCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,eAAe,EAAE,EACxB,MAAM,EAAE,mBAAmB,EAC3B,KAAK,GAAE,iBAAsB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/history/internal/message-transaction.js

@@ -1,60 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.writeMessageChunk = writeMessageChunk;
-const node_crypto_1 = require("node:crypto");
-const constants_1 = require("../../shared/constants");
-const cancellation_1 = require("../../shared/dynamodb/cancellation");
-const retry_1 = require("../../shared/dynamodb/retry");
-const session_update_1 = require("./session-update");
-/** True when a TransactWriteItems cancellation was caused solely by the SESSION update's ttl condition (always TransactItems index 0 — see buildInput below), not by any message item. */
-function isTtlConditionLoss(error) {
-    const reasons = (0, cancellation_1.getCancellationReasons)(error);
-    return (reasons?.[0]?.Code === 'ConditionalCheckFailed' &&
-        reasons.slice(1).every((reason) => reason.Code === 'None'));
-}
-function buildInput(context, items, fields) {
-    return {
-        TransactItems: [
-            (0, session_update_1.buildSessionUpdateItem)(context.tableName, fields),
-            ...items.map((item) => ({ Put: { TableName: context.tableName, Item: item } })),
-        ],
-        ClientRequestToken: (0, node_crypto_1.randomUUID)(),
-    };
-}
-async function attempt(context, items, fields, retry) {
-    const input = buildInput(context, items, fields);
-    await (0, retry_1.withDynamoDBRetry)(() => context.client.transactWrite(input), {
-        maxAttempts: constants_1.MESSAGE_APPEND_RETRY_MAX_ATTEMPTS,
-        rng: retry.rng,
-        signal: retry.signal,
-    });
-}
-/**
- * Atomically write a chunk of message items together with the session-metadata
- * count update in one {@link https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactWriteItems.html | TransactWriteItems}
- * call, so `messageCount` can never disagree with the messages that landed. A
- * single `ClientRequestToken` is used per attempt so a re-sent commit (e.g.
- * after a lost response) is idempotent and never double-applies the count
- * `ADD`. When `fields.forceTtlRefresh` is set, the session update carries a
- * monotonic ConditionExpression (see session-update.ts); if — and only if —
- * that specific condition loses a race against a concurrent caller who just
- * healed the same anchor, this retries the identical chunk once with
- * `forceTtlRefresh: false` (safe: `if_not_exists` then converges to whatever
- * already won) rather than losing the message writes to a benign ttl race. A
- * cancellation caused by any other item (a genuine message-row conflict) is
- * not retried here — it propagates for the normal transient-conflict retry
- * budget inside `withDynamoDBRetry` to handle, or to the caller otherwise.
- */
-async function writeMessageChunk(context, items, fields, retry = {}) {
-    try {
-        await attempt(context, items, fields, retry);
-    }
-    catch (error) {
-        if (fields.forceTtlRefresh && isTtlConditionLoss(error)) {
-            await attempt(context, items, { ...fields, forceTtlRefresh: false }, retry);
-            return;
-        }
-        throw error;
-    }
-}
-//# sourceMappingURL=message-transaction.js.map

package/dist/history/internal/message-transaction.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"message-transaction.js","sourceRoot":"","sources":["../../../src/history/internal/message-transaction.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAEzC,sDAA2E;AAC3E,qEAA4E;AAC5E,uDAAgE;AAEhE,qDAI0B;AAS1B,0LAA0L;AAC1L,SAAS,kBAAkB,CAAC,KAAY;IACtC,MAAM,OAAO,GAAG,IAAA,qCAAsB,EAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,CACL,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,wBAAwB;QAC/C,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAC3D,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,OAAuB,EACvB,KAAwB,EACxB,MAA2B;IAE3B,OAAO;QACL,aAAa,EAAE;YACb,IAAA,uCAAsB,EAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;YACjD,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;SAChF;QACD,kBAAkB,EAAE,IAAA,wBAAU,GAAE;KACjC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,OAAuB,EACvB,KAAwB,EACxB,MAA2B,EAC3B,KAAwB;IAExB,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,IAAA,yBAAiB,EAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE;QACjE,WAAW,EAAE,6CAAiC;QAC9C,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACI,KAAK,4BACV,OAAuB,EACvB,KAAwB,EACxB,MAA2B,EAC3B,KAAK,GAAsB,EAAE;IAE7B,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,eAAe,IAAI,kBAAkB,CAAC,KAAc,CAAC,EAAE,CAAC;YACjE,MAAM,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;YAC5E,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -1,10 +0,0 @@
-import type { QueryCommandInput } from '@aws-sdk/lib-dynamodb';
-/** Options for {@link sessionItemsQuery}. */
-export interface SessionItemsQueryOptions {
-    consistent?: boolean;
-}
-/** Query input selecting every item in a session's partition (messages + metadata). */
-export declare function sessionItemsQuery(tableName: string, sessionId: string, options?: SessionItemsQueryOptions): QueryCommandInput;
-/** Query input selecting a session's message items in chronological order. */
-export declare function messageQuery(tableName: string, sessionId: string): QueryCommandInput;
-//# sourceMappingURL=query.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/history/internal/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAI/D,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CASnB;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAWpF"}

package/dist/history/internal/query.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sessionItemsQuery = sessionItemsQuery;
-exports.messageQuery = messageQuery;
-const keys_1 = require("./keys");
-/** Query input selecting every item in a session's partition (messages + metadata). */
-function sessionItemsQuery(tableName, sessionId, options = {}) {
-    const params = {
-        TableName: tableName,
-        KeyConditionExpression: '#pk = :pk',
-        ExpressionAttributeNames: { '#pk': 'PK' },
-        ExpressionAttributeValues: { ':pk': (0, keys_1.sessionPartition)(sessionId) },
-    };
-    if (options.consistent)
-        params.ConsistentRead = true;
-    return params;
-}
-/** Query input selecting a session's message items in chronological order. */
-function messageQuery(tableName, sessionId) {
-    return {
-        TableName: tableName,
-        KeyConditionExpression: '#pk = :pk AND begins_with(#sk, :skp)',
-        ExpressionAttributeNames: { '#pk': 'PK', '#sk': 'SK' },
-        ExpressionAttributeValues: {
-            ':pk': (0, keys_1.sessionPartition)(sessionId),
-            ':skp': (0, keys_1.messageSortKeyPrefix)(),
-        },
-        ScanIndexForward: true,
-    };
-}
-//# sourceMappingURL=query.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/history/internal/query.ts"],"names":[],"mappings":";;;;AAEA,iCAAgE;AAOhE,uFAAuF;AACvF,2BACE,SAAiB,EACjB,SAAiB,EACjB,OAAO,GAA6B,EAAE;IAEtC,MAAM,MAAM,GAAsB;QAChC,SAAS,EAAE,SAAS;QACpB,sBAAsB,EAAE,WAAW;QACnC,wBAAwB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;QACzC,yBAAyB,EAAE,EAAE,KAAK,EAAE,IAAA,uBAAgB,EAAC,SAAS,CAAC,EAAE;KAClE,CAAC;IACF,IAAI,OAAO,CAAC,UAAU;QAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IACrD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,sBAA6B,SAAiB,EAAE,SAAiB;IAC/D,OAAO;QACL,SAAS,EAAE,SAAS;QACpB,sBAAsB,EAAE,sCAAsC;QAC9D,wBAAwB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;QACtD,yBAAyB,EAAE;YACzB,KAAK,EAAE,IAAA,uBAAgB,EAAC,SAAS,CAAC;YAClC,MAAM,EAAE,IAAA,2BAAoB,GAAE;SAC/B;QACD,gBAAgB,EAAE,IAAI;KACvB,CAAC;AACJ,CAAC"}

package/dist/history/internal/session-count.d.ts

@@ -1,41 +0,0 @@
-import type { HistoryContext } from './setup';
-/**
- * Subtract a previously-added count from the session, leaving it consistent.
- * Guarded so a concurrently-deleted SESSION row is never resurrected as a
- * permanent, ttl-less junk row: if the row is already gone there is nothing
- * to revert, so that specific condition failure is swallowed rather than
- * surfaced — this runs only from an already-in-progress rollback, where a
- * spurious error for a no-op would misrepresent what happened.
- *
- * Deliberately does not revert a `forceTtlRefresh`-driven ttl SET from an
- * earlier committed chunk: the healed anchor is never shorter than what
- * was there before, so leaving it in place after a rollback only means the
- * session's metadata row outlives its content a bit longer than ideal —
- * self-healing (the next successful append, or DynamoDB's own TTL sweep,
- * resolves it), unlike reverting, which would need to re-check for a
- * concurrent legitimate extension to avoid regressing it. See README.md's
- * "TTL expiry" section.
- */
-export declare function revertSessionCount(context: HistoryContext, sessionId: string, delta: number): Promise<void>;
-/**
- * Undo a rolled-back append's effect on the session row.
- *
- * When this call is the one that created the row — `createdAt` still equals
- * this call's timestamp, and the only messages counted on it are the ones
- * being reverted — the whole row is deleted. Without that, a failed first
- * append left a "ghost session": `title`, `createdAt` and `sessionId` are all
- * written via `if_not_exists`, so they were never reverted and never set
- * again, leaving `listSessions()` reporting a session with `messageCount: 0`
- * whose title still held up to 80 characters of a message the caller was told
- * had not persisted, with no API to clear it.
- *
- * Both conditions are load-bearing. `createdAt = :now` establishes that this
- * call created the row; `messageCount = :total` establishes that nothing else
- * has added to it since. A concurrent append to the same brand-new session
- * fails the count check, because deleting the row would destroy that caller's
- * committed messages — so it falls through to the plain decrement, and then
- * strips just the title this call contributed, which is the only part of the
- * row still carrying rolled-back message content.
- */
-export declare function revertSessionCreation(context: HistoryContext, sessionId: string, total: number, createdAt: string, title?: string): Promise<void>;
-//# sourceMappingURL=session-count.d.ts.map

package/dist/history/internal/session-count.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-count.d.ts","sourceRoot":"","sources":["../../../src/history/internal/session-count.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAe9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/history/internal/session-count.js

@@ -1,109 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.revertSessionCount = revertSessionCount;
-exports.revertSessionCreation = revertSessionCreation;
-const node_crypto_1 = require("node:crypto");
-const cancellation_1 = require("../../shared/dynamodb/cancellation");
-const retry_1 = require("../../shared/dynamodb/retry");
-const keys_1 = require("./keys");
-const session_title_1 = require("./session-title");
-/**
- * True when a TransactWriteItems cancellation was caused by a
- * ConditionalCheckFailed reason. Named distinctly from
- * checkpointer/actions/put-writes.ts's isConditionalCheckFailed, which
- * checks a different thing entirely (a raw PutItem exception name, not a
- * transaction cancellation reason) — this function had that same name
- * until now, a real trap for whoever read one assuming it was the other.
- */
-function isCancelledByCondition(error) {
-    const reasons = (0, cancellation_1.getCancellationReasons)(error);
-    return reasons?.[0]?.Code === 'ConditionalCheckFailed';
-}
-/**
- * Subtract a previously-added count from the session, leaving it consistent.
- * Guarded so a concurrently-deleted SESSION row is never resurrected as a
- * permanent, ttl-less junk row: if the row is already gone there is nothing
- * to revert, so that specific condition failure is swallowed rather than
- * surfaced — this runs only from an already-in-progress rollback, where a
- * spurious error for a no-op would misrepresent what happened.
- *
- * Deliberately does not revert a `forceTtlRefresh`-driven ttl SET from an
- * earlier committed chunk: the healed anchor is never shorter than what
- * was there before, so leaving it in place after a rollback only means the
- * session's metadata row outlives its content a bit longer than ideal —
- * self-healing (the next successful append, or DynamoDB's own TTL sweep,
- * resolves it), unlike reverting, which would need to re-check for a
- * concurrent legitimate extension to avoid regressing it. See README.md's
- * "TTL expiry" section.
- */
-async function revertSessionCount(context, sessionId, delta) {
-    if (delta === 0)
-        return;
-    const update = {
-        TableName: context.tableName,
-        Key: { PK: (0, keys_1.sessionPartition)(sessionId), SK: keys_1.SESSION_SORT_KEY },
-        UpdateExpression: 'ADD #count :neg',
-        ConditionExpression: 'attribute_exists(PK)',
-        ExpressionAttributeNames: { '#count': 'messageCount' },
-        ExpressionAttributeValues: { ':neg': -delta },
-    };
-    const input = { TransactItems: [{ Update: update }], ClientRequestToken: (0, node_crypto_1.randomUUID)() };
-    try {
-        await (0, retry_1.withDynamoDBRetry)(() => context.client.transactWrite(input));
-    }
-    catch (error) {
-        if (isCancelledByCondition(error))
-            return;
-        throw error;
-    }
-}
-/**
- * Undo a rolled-back append's effect on the session row.
- *
- * When this call is the one that created the row — `createdAt` still equals
- * this call's timestamp, and the only messages counted on it are the ones
- * being reverted — the whole row is deleted. Without that, a failed first
- * append left a "ghost session": `title`, `createdAt` and `sessionId` are all
- * written via `if_not_exists`, so they were never reverted and never set
- * again, leaving `listSessions()` reporting a session with `messageCount: 0`
- * whose title still held up to 80 characters of a message the caller was told
- * had not persisted, with no API to clear it.
- *
- * Both conditions are load-bearing. `createdAt = :now` establishes that this
- * call created the row; `messageCount = :total` establishes that nothing else
- * has added to it since. A concurrent append to the same brand-new session
- * fails the count check, because deleting the row would destroy that caller's
- * committed messages — so it falls through to the plain decrement, and then
- * strips just the title this call contributed, which is the only part of the
- * row still carrying rolled-back message content.
- */
-async function revertSessionCreation(context, sessionId, total, createdAt, title) {
-    if (total === 0)
-        return;
-    const input = {
-        TransactItems: [
-            {
-                Delete: {
-                    TableName: context.tableName,
-                    Key: { PK: (0, keys_1.sessionPartition)(sessionId), SK: keys_1.SESSION_SORT_KEY },
-                    ConditionExpression: '#count = :total AND #c = :now',
-                    ExpressionAttributeNames: { '#count': 'messageCount', '#c': 'createdAt' },
-                    ExpressionAttributeValues: { ':total': total, ':now': createdAt },
-                },
-            },
-        ],
-        ClientRequestToken: (0, node_crypto_1.randomUUID)(),
-    };
-    try {
-        await (0, retry_1.withDynamoDBRetry)(() => context.client.transactWrite(input));
-        return;
-    }
-    catch (error) {
-        if (!isCancelledByCondition(error))
-            throw error;
-    }
-    await revertSessionCount(context, sessionId, total);
-    if (title !== undefined)
-        await (0, session_title_1.removeRolledBackTitle)(context, sessionId, createdAt, title);
-}
-//# sourceMappingURL=session-count.js.map

package/dist/history/internal/session-count.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-count.js","sourceRoot":"","sources":["../../../src/history/internal/session-count.ts"],"names":[],"mappings":";;;;AAAA,6CAAyC;AAEzC,qEAA4E;AAC5E,uDAAgE;AAChE,iCAA4D;AAC5D,mDAAwD;AAGxD;;;;;;;GAOG;AACH,SAAS,sBAAsB,CAAC,KAAY;IAC1C,MAAM,OAAO,GAAG,IAAA,qCAAsB,EAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,wBAAwB,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,6BACV,OAAuB,EACvB,SAAiB,EACjB,KAAa;IAEb,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO;IACxB,MAAM,MAAM,GAAG;QACb,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,EAAE,EAAE,EAAE,EAAE,IAAA,uBAAgB,EAAC,SAAS,CAAC,EAAE,EAAE,EAAE,uBAAgB,EAAE;QAC9D,gBAAgB,EAAE,iBAAiB;QACnC,mBAAmB,EAAE,sBAAsB;QAC3C,wBAAwB,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE;QACtD,yBAAyB,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE;KAC9C,CAAC;IACF,MAAM,KAAK,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,kBAAkB,EAAE,IAAA,wBAAU,GAAE,EAAE,CAAC;IACxF,IAAI,CAAC;QACH,MAAM,IAAA,yBAAiB,EAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,sBAAsB,CAAC,KAAc,CAAC;YAAE,OAAO;QACnD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACI,KAAK,gCACV,OAAuB,EACvB,SAAiB,EACjB,KAAa,EACb,SAAiB,EACjB,KAAc;IAEd,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO;IACxB,MAAM,KAAK,GAAG;QACZ,aAAa,EAAE;YACb;gBACE,MAAM,EAAE;oBACN,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,GAAG,EAAE,EAAE,EAAE,EAAE,IAAA,uBAAgB,EAAC,SAAS,CAAC,EAAE,EAAE,EAAE,uBAAgB,EAAE;oBAC9D,mBAAmB,EAAE,+BAA+B;oBACpD,wBAAwB,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE;oBACzE,yBAAyB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE;iBAClE;aACF;SACF;QACD,kBAAkB,EAAE,IAAA,wBAAU,GAAE;KACjC,CAAC;IACF,IAAI,CAAC;QACH,MAAM,IAAA,yBAAiB,EAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,sBAAsB,CAAC,KAAc,CAAC;YAAE,MAAM,KAAK,CAAC;IAC3D,CAAC;IACD,MAAM,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAA,qCAAqB,EAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAC7F,CAAC"}

package/dist/history/internal/session-title.d.ts

@@ -1,20 +0,0 @@
-import type { HistoryContext } from './setup';
-/**
- * Strip a title this call contributed to a session row it created, when the
- * row itself could not be deleted because a concurrent append has since added
- * messages to it.
- *
- * Without this, that narrow window reopens exactly the leak C4 closes: the
- * title is derived from the first human message of an append the caller was
- * told had failed, and `if_not_exists` means nothing ever overwrites it — so
- * a row that now belongs to a different caller keeps up to 80 characters of
- * rolled-back message content.
- *
- * Both guards are load-bearing. `createdAt = :now` establishes that this call
- * created the row, and `title = :title` that the title on it is still the one
- * this call wrote — so a pre-existing title, or one a concurrent caller won
- * the `if_not_exists` race for, is never removed. A condition rejection means
- * exactly that and is not an error; anything else is.
- */
-export declare function removeRolledBackTitle(context: HistoryContext, sessionId: string, createdAt: string, title: string): Promise<void>;
-//# sourceMappingURL=session-title.d.ts.map

package/dist/history/internal/session-title.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-title.d.ts","sourceRoot":"","sources":["../../../src/history/internal/session-title.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAO9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/history/internal/session-title.js

@@ -1,44 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeRolledBackTitle = removeRolledBackTitle;
-const retry_1 = require("../../shared/dynamodb/retry");
-const keys_1 = require("./keys");
-/** True when a plain UpdateItem was turned away by its ConditionExpression. */
-function isConditionRejected(error) {
-    return error.name === 'ConditionalCheckFailedException';
-}
-/**
- * Strip a title this call contributed to a session row it created, when the
- * row itself could not be deleted because a concurrent append has since added
- * messages to it.
- *
- * Without this, that narrow window reopens exactly the leak C4 closes: the
- * title is derived from the first human message of an append the caller was
- * told had failed, and `if_not_exists` means nothing ever overwrites it — so
- * a row that now belongs to a different caller keeps up to 80 characters of
- * rolled-back message content.
- *
- * Both guards are load-bearing. `createdAt = :now` establishes that this call
- * created the row, and `title = :title` that the title on it is still the one
- * this call wrote — so a pre-existing title, or one a concurrent caller won
- * the `if_not_exists` race for, is never removed. A condition rejection means
- * exactly that and is not an error; anything else is.
- */
-async function removeRolledBackTitle(context, sessionId, createdAt, title) {
-    try {
-        await (0, retry_1.withDynamoDBRetry)(() => context.client.update({
-            TableName: context.tableName,
-            Key: { PK: (0, keys_1.sessionPartition)(sessionId), SK: keys_1.SESSION_SORT_KEY },
-            UpdateExpression: 'REMOVE #title',
-            ConditionExpression: '#c = :now AND #title = :title',
-            ExpressionAttributeNames: { '#title': 'title', '#c': 'createdAt' },
-            ExpressionAttributeValues: { ':now': createdAt, ':title': title },
-        }));
-    }
-    catch (error) {
-        if (isConditionRejected(error))
-            return;
-        throw error;
-    }
-}
-//# sourceMappingURL=session-title.js.map

package/dist/history/internal/session-title.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-title.js","sourceRoot":"","sources":["../../../src/history/internal/session-title.ts"],"names":[],"mappings":";;;AAAA,uDAAgE;AAChE,iCAA4D;AAG5D,+EAA+E;AAC/E,SAAS,mBAAmB,CAAC,KAAY;IACvC,OAAO,KAAK,CAAC,IAAI,KAAK,iCAAiC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,gCACV,OAAuB,EACvB,SAAiB,EACjB,SAAiB,EACjB,KAAa;IAEb,IAAI,CAAC;QACH,MAAM,IAAA,yBAAiB,EAAC,GAAG,EAAE,CAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,GAAG,EAAE,EAAE,EAAE,EAAE,IAAA,uBAAgB,EAAC,SAAS,CAAC,EAAE,EAAE,EAAE,uBAAgB,EAAE;YAC9D,gBAAgB,EAAE,eAAe;YACjC,mBAAmB,EAAE,+BAA+B;YACpD,wBAAwB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE;YAClE,yBAAyB,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE;SAClE,CAAC,CACH,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,mBAAmB,CAAC,KAAc,CAAC;YAAE,OAAO;QAChD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/history/internal/session-update.d.ts

@@ -1,28 +0,0 @@
-import type { TransactWriteCommandInput } from '@aws-sdk/lib-dynamodb';
-/** One member of a {@link TransactWriteCommandInput} `TransactItems` list. */
-export type HistoryTransactItem = NonNullable<TransactWriteCommandInput['TransactItems']>[number];
-/** Fields driving the per-session metadata update inside the append transaction. */
-export interface SessionUpdateFields {
-    sessionId: string;
-    count: number;
-    now: string;
-    title?: string;
-    ttlTimestamp?: number;
-    forceTtlRefresh?: boolean;
-}
-/**
- * Build the metadata `Update` transact-item: `ADD` the message count and `SET`
- * `updatedAt` every time, while `createdAt`, `sessionId`, `title`, and the `ttl`
- * anchor are written once via `if_not_exists`. Folding the `ttl` anchor in here
- * means the first append fixes one shared expiry atomically with the count, with
- * no separate pre-write that could orphan a metadata-only row. When
- * `forceTtlRefresh` is set (because {@link resolveTtlAnchor} found the persisted
- * anchor missing or already expired), the `ttl` clause instead does a plain
- * `SET`, so the SESSION row's own stale attribute actually heals instead of
- * being permanently blocked by `if_not_exists`. When forceTtlRefresh is set,
- * the SET is additionally guarded by a ConditionExpression so a concurrent
- * caller's already-healed anchor can never be regressed backward — see
- * message-transaction.ts for how a lost race is retried without forcing.
- */
-export declare function buildSessionUpdateItem(tableName: string, fields: SessionUpdateFields): HistoryTransactItem;
-//# sourceMappingURL=session-update.d.ts.map

package/dist/history/internal/session-update.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-update.d.ts","sourceRoot":"","sources":["../../../src/history/internal/session-update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAI7F,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,yBAAyB,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAElG,oFAAoF;AACpF,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,GAC1B,mBAAmB,CAiDrB"}