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

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

@@ -1,31 +0,0 @@
-import type { DynamoDBClient } from '@aws-sdk/client-dynamodb';
-import type { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
-import type { SerializerProtocol } from '@langchain/langgraph-checkpoint';
-import type { CompressionConfig } from '../../shared/codec/compression';
-import { S3Offloader } from '../../shared/codec/s3/offloader';
-import type { RetryOptions } from '../../shared/dynamodb/retry';
-import { type Logger } from '../../shared/logging/logger';
-import type { TtlOption } from '../../shared/validation/ttl';
-import type { CorruptMessagePolicy, DynamoDBChatMessageHistoryOptions } from '../types';
-/** Resolved collaborators shared by every chat-history action. */
-export interface HistoryContext {
-    client: DynamoDBDocument;
-    tableName: string;
-    serde: SerializerProtocol;
-    compression?: CompressionConfig;
-    offloader?: S3Offloader;
-    ttl?: TtlOption;
-    logger: Logger;
-    ulid: () => string;
-    onCorruptMessage: CorruptMessagePolicy;
-    /** Retry budget and backoff for every DynamoDB call, with the retry debug log attached. */
-    retry?: RetryOptions;
-}
-/** Result of wiring up a chat-history adapter from its options. */
-export interface HistorySetup {
-    context: HistoryContext;
-    ddbClient: DynamoDBClient | undefined;
-    ownsClient: boolean;
-}
-/** Resolve the client, optional S3 offloader, and serializer into a context. */
-export declare function setUpHistory(options: DynamoDBChatMessageHistoryOptions): HistorySetup;

package/dist/history/internal/setup.js

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setUpHistory = setUpHistory;
-const json_serde_1 = require("../../shared/codec/json-serde");
-const adapter_config_1 = require("../../shared/codec/s3/adapter-config");
-const offloader_1 = require("../../shared/codec/s3/offloader");
-const client_1 = require("../../shared/dynamodb/client");
-const retry_policy_1 = require("../../shared/dynamodb/retry-policy");
-const errors_1 = require("../../shared/errors/errors");
-const logger_1 = require("../../shared/logging/logger");
-const ulid_1 = require("../../shared/ulid");
-const options_1 = require("../../shared/validation/options");
-const CORRUPT_MESSAGE_POLICIES = ['skip', 'throw'];
-/** Resolve the client, optional S3 offloader, and serializer into a context. */
-function setUpHistory(options) {
-    (0, options_1.validateBaseAdapterOptions)(options);
-    if (options.onCorruptMessage !== undefined &&
-        !CORRUPT_MESSAGE_POLICIES.includes(options.onCorruptMessage)) {
-        throw new errors_1.ValidationError(`onCorruptMessage must be one of ${CORRUPT_MESSAGE_POLICIES.join(' | ')}`, 'onCorruptMessage');
-    }
-    const logger = (0, logger_1.resolveLogger)(options.logger);
-    const resolved = (0, client_1.resolveDynamoDBClient)(options);
-    if (!resolved.ownsClient)
-        void (0, client_1.warnOnStackedRetries)(resolved.client, logger);
-    return {
-        context: {
-            client: resolved.client,
-            tableName: options.tableName,
-            serde: options.serde ?? json_serde_1.JSON_SERDE,
-            compression: options.compression,
-            offloader: options.s3
-                ? new offloader_1.S3Offloader((0, adapter_config_1.offloaderConfigFor)(options.s3, 'history', options.clientConfig))
-                : undefined,
-            ttl: options.ttl,
-            logger,
-            retry: (0, retry_policy_1.resolveRetryPolicy)(options.retry, logger),
-            ulid: (0, ulid_1.createUlidFactory)(),
-            onCorruptMessage: options.onCorruptMessage ?? 'skip',
-        },
-        ddbClient: resolved.ddbClient,
-        ownsClient: resolved.ownsClient,
-    };
-}

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

@@ -1,12 +0,0 @@
-import type { StoredMessage } from '@langchain/core/messages';
-/**
- * Derive a session title from the first human message's text content, at most
- * {@link MAX_TITLE_LENGTH} characters including the ellipsis. Returns undefined
- * when there is no usable text.
- *
- * Truncation counts *code points*, not UTF-16 code units: slicing by index
- * could cut a surrogate pair in half, leaving a lone surrogate that no longer
- * round-trips through UTF-8. The ellipsis is also counted against the maximum
- * rather than appended past it.
- */
-export declare function deriveTitle(messages: StoredMessage[]): string | undefined;

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

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.deriveTitle = deriveTitle;
-const MAX_TITLE_LENGTH = 80;
-function isTextBlock(block) {
-    const candidate = block;
-    return candidate.type === 'text' && typeof candidate.text === 'string';
-}
-/**
- * The human-readable text of a message's `content`: the string itself, or the
- * first `text` block of a content-block array (a multimodal message carries
- * image and text blocks side by side). Undefined when neither yields text.
- */
-function textOf(content) {
-    if (typeof content === 'string')
-        return content;
-    if (!Array.isArray(content))
-        return undefined;
-    const block = content.find((entry) => typeof entry === 'object' && entry !== null && isTextBlock(entry));
-    return block?.text;
-}
-/**
- * Derive a session title from the first human message's text content, at most
- * {@link MAX_TITLE_LENGTH} characters including the ellipsis. Returns undefined
- * when there is no usable text.
- *
- * Truncation counts *code points*, not UTF-16 code units: slicing by index
- * could cut a surrogate pair in half, leaving a lone surrogate that no longer
- * round-trips through UTF-8. The ellipsis is also counted against the maximum
- * rather than appended past it.
- */
-function deriveTitle(messages) {
-    const firstHuman = messages.find((message) => message.type === 'human');
-    const content = firstHuman === undefined ? undefined : textOf(firstHuman.data.content);
-    if (content === undefined || content.length === 0)
-        return undefined;
-    const codePoints = [...content];
-    if (codePoints.length <= MAX_TITLE_LENGTH)
-        return content;
-    return `${codePoints.slice(0, MAX_TITLE_LENGTH - 1).join('')}…`;
-}

package/dist/history/internal/ttl-anchor.d.ts

@@ -1,24 +0,0 @@
-import type { HistoryContext } from './setup';
-/** The resolved ttl anchor plus whether the persisted SESSION-row value must be force-refreshed. */
-export interface TtlAnchorResult {
-    ttlTimestamp: number;
-    refresh: boolean;
-}
-/**
- * Resolve the session's creation-anchored TTL: the value already stored on the
- * SESSION item, if one exists AND is still in the future; otherwise the
- * supplied `candidate`, with `refresh: true` so the caller force-overwrites
- * the stale/missing persisted anchor instead of leaving it stuck (DynamoDB's
- * `if_not_exists` would otherwise never correct an already-expired anchor).
- * This is a strongly-consistent read, never a write, so it cannot leave a
- * metadata-only orphan row when the following append transaction fails.
- *
- * When a stale anchor is healed, only the persisted SESSION row's `ttl` is
- * force-refreshed — the message rows already written under the expired
- * anchor keep their own (already-expired) `ttl` and get swept independently
- * by DynamoDB's TTL sweep. Until that sweep runs (and until
- * `reconcileMessageCount` repairs the count), `messageCount` can therefore be
- * temporarily overstated relative to what `getMessages` actually returns.
- * This is expected, not a bug.
- */
-export declare function resolveTtlAnchor(context: HistoryContext, sessionId: string, candidate: number, signal?: AbortSignal): Promise<TtlAnchorResult>;

package/dist/history/internal/ttl-anchor.js

@@ -1,38 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveTtlAnchor = resolveTtlAnchor;
-const clock_1 = require("../../shared/clock");
-const retry_1 = require("../../shared/dynamodb/retry");
-const retry_policy_1 = require("../../shared/dynamodb/retry-policy");
-const keys_1 = require("./keys");
-/**
- * Resolve the session's creation-anchored TTL: the value already stored on the
- * SESSION item, if one exists AND is still in the future; otherwise the
- * supplied `candidate`, with `refresh: true` so the caller force-overwrites
- * the stale/missing persisted anchor instead of leaving it stuck (DynamoDB's
- * `if_not_exists` would otherwise never correct an already-expired anchor).
- * This is a strongly-consistent read, never a write, so it cannot leave a
- * metadata-only orphan row when the following append transaction fails.
- *
- * When a stale anchor is healed, only the persisted SESSION row's `ttl` is
- * force-refreshed — the message rows already written under the expired
- * anchor keep their own (already-expired) `ttl` and get swept independently
- * by DynamoDB's TTL sweep. Until that sweep runs (and until
- * `reconcileMessageCount` repairs the count), `messageCount` can therefore be
- * temporarily overstated relative to what `getMessages` actually returns.
- * This is expected, not a bug.
- */
-async function resolveTtlAnchor(context, sessionId, candidate, signal) {
-    const result = await (0, retry_1.withDynamoDBRetry)(() => context.client.get({
-        TableName: context.tableName,
-        Key: { PK: (0, keys_1.sessionPartition)(sessionId), SK: keys_1.SESSION_SORT_KEY },
-        ConsistentRead: true,
-        ProjectionExpression: '#ttl',
-        ExpressionAttributeNames: { '#ttl': 'ttl' },
-    }), (0, retry_policy_1.retryFor)(context, signal));
-    const ttl = result.Item?.ttl;
-    if (typeof ttl === 'number' && ttl > (0, clock_1.nowSeconds)()) {
-        return { ttlTimestamp: ttl, refresh: false };
-    }
-    return { ttlTimestamp: candidate, refresh: true };
-}

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

@@ -1,25 +0,0 @@
-import { type StoredMessage } from '@langchain/core/messages';
-import type { MessageWindow } from '../types';
-/**
- * Validate a session id is a non-blank, separator- and control-char-free string
- * of at most 1024 bytes. Applied on every entry point, not just the write path: a bad value
- * used to reach DynamoDB and surface as a raw AWS SDK exception on reads,
- * while the identical value threw this library's typed `ValidationError` on a
- * write.
- */
-export declare function validateSessionId(sessionId: string): void;
-/**
- * Reject a message this adapter could never read back. The check *is* the
- * read side's own rebuild (`mapStoredMessagesToChatMessages`), so write and
- * read agree by construction: a `RemoveMessage`, or a tool, function or
- * generic message missing its required field, fails here with a typed error
- * instead of being persisted and then skipped or thrown by `getMessages`.
- */
-export declare function validateStorableMessages(stored: StoredMessage[]): void;
-/**
- * Validate a `getMessages` window: `limit`, when given, a positive integer;
- * `before`, when given, a valid `Date`. Checked before any DynamoDB call so a
- * bad value fails with a typed error rather than a raw `ValidationException`
- * (or, for an invalid Date, a NaN-derived sort key that matches nothing).
- */
-export declare function validateMessageWindow(window: MessageWindow): void;

package/dist/history/internal/validation.js

@@ -1,53 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateSessionId = validateSessionId;
-exports.validateStorableMessages = validateStorableMessages;
-exports.validateMessageWindow = validateMessageWindow;
-const messages_1 = require("@langchain/core/messages");
-const constants_1 = require("../../shared/constants");
-const errors_1 = require("../../shared/errors/errors");
-const primitives_1 = require("../../shared/validation/primitives");
-const keys_1 = require("./keys");
-/**
- * Validate a session id is a non-blank, separator- and control-char-free string
- * of at most 1024 bytes. Applied on every entry point, not just the write path: a bad value
- * used to reach DynamoDB and surface as a raw AWS SDK exception on reads,
- * while the identical value threw this library's typed `ValidationError` on a
- * write.
- */
-function validateSessionId(sessionId) {
-    (0, primitives_1.validateIdentifier)(sessionId, keys_1.SORT_KEY_SEPARATOR, 'sessionId', constants_1.MAX_PARTITION_ID_BYTES);
-}
-/**
- * Reject a message this adapter could never read back. The check *is* the
- * read side's own rebuild (`mapStoredMessagesToChatMessages`), so write and
- * read agree by construction: a `RemoveMessage`, or a tool, function or
- * generic message missing its required field, fails here with a typed error
- * instead of being persisted and then skipped or thrown by `getMessages`.
- */
-function validateStorableMessages(stored) {
-    stored.forEach((message, index) => {
-        try {
-            (0, messages_1.mapStoredMessagesToChatMessages)([message]);
-        }
-        catch (error) {
-            throw new errors_1.ValidationError(`messages[${index}] of type "${message.type}" cannot be stored: ${error.message}`, 'messages');
-        }
-    });
-}
-/**
- * Validate a `getMessages` window: `limit`, when given, a positive integer;
- * `before`, when given, a valid `Date`. Checked before any DynamoDB call so a
- * bad value fails with a typed error rather than a raw `ValidationException`
- * (or, for an invalid Date, a NaN-derived sort key that matches nothing).
- */
-function validateMessageWindow(window) {
-    if (window.limit !== undefined && (!Number.isInteger(window.limit) || window.limit < 1)) {
-        throw new errors_1.ValidationError('limit must be a positive integer', 'limit');
-    }
-    if (window.before !== undefined) {
-        const time = typeof window.before.getTime === 'function' ? window.before.getTime() : Number.NaN;
-        if (!Number.isFinite(time))
-            throw new errors_1.ValidationError('before must be a valid Date', 'before');
-    }
-}

package/dist/history/session-adapter.d.ts

@@ -1,29 +0,0 @@
-import { BaseListChatMessageHistory } from '@langchain/core/chat_history';
-import type { BaseMessage } from '@langchain/core/messages';
-/** The read window an adapter applies to every `getMessages`. */
-export type AdapterWindow = {
-    limit?: number;
-};
-/** The session-scoped operations a single-session adapter delegates to. */
-export interface SessionBackend {
-    getMessages(sessionId: string, window?: AdapterWindow): Promise<BaseMessage[]>;
-    addMessages(sessionId: string, messages: BaseMessage[]): Promise<void>;
-    clear(sessionId: string): Promise<void>;
-}
-/**
- * Single-session view over a {@link SessionBackend}, implementing LangChain's
- * `BaseListChatMessageHistory` so it can drive `RunnableWithMessageHistory`.
- * A `window` bounds what every read hands the chain — `{ limit: 50 }` feeds it
- * the newest fifty messages instead of the whole session.
- */
-export declare class DynamoDBSessionChatMessageHistory extends BaseListChatMessageHistory {
-    private readonly backend;
-    private readonly sessionId;
-    private readonly window?;
-    lc_namespace: string[];
-    constructor(backend: SessionBackend, sessionId: string, window?: AdapterWindow | undefined);
-    getMessages(): Promise<BaseMessage[]>;
-    addMessage(message: BaseMessage): Promise<void>;
-    addMessages(messages: BaseMessage[]): Promise<void>;
-    clear(): Promise<void>;
-}

package/dist/history/session-adapter.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DynamoDBSessionChatMessageHistory = void 0;
-const chat_history_1 = require("@langchain/core/chat_history");
-/**
- * Single-session view over a {@link SessionBackend}, implementing LangChain's
- * `BaseListChatMessageHistory` so it can drive `RunnableWithMessageHistory`.
- * A `window` bounds what every read hands the chain — `{ limit: 50 }` feeds it
- * the newest fifty messages instead of the whole session.
- */
-class DynamoDBSessionChatMessageHistory extends chat_history_1.BaseListChatMessageHistory {
-    backend;
-    sessionId;
-    window;
-    lc_namespace = ['langchain', 'stores', 'message', 'dynamodb'];
-    constructor(backend, sessionId, window) {
-        super();
-        this.backend = backend;
-        this.sessionId = sessionId;
-        this.window = window;
-    }
-    getMessages() {
-        return this.backend.getMessages(this.sessionId, this.window);
-    }
-    addMessage(message) {
-        return this.backend.addMessages(this.sessionId, [message]);
-    }
-    addMessages(messages) {
-        return this.backend.addMessages(this.sessionId, messages);
-    }
-    clear() {
-        return this.backend.clear(this.sessionId);
-    }
-}
-exports.DynamoDBSessionChatMessageHistory = DynamoDBSessionChatMessageHistory;

package/dist/history/types.d.ts

@@ -1,69 +0,0 @@
-import type { SerializerProtocol } from '@langchain/langgraph-checkpoint';
-import type { PayloadDescriptor } from '../shared/codec/codec';
-import type { BaseAdapterOptions, CancelOptions, CodecOptions } from '../shared/options';
-/** Options for {@link DynamoDBChatMessageHistory}. */
-export type DynamoDBChatMessageHistoryOptions = BaseAdapterOptions & CodecOptions & {
-    /** Optional serializer override (defaults to the JSON serializer). */
-    serde?: SerializerProtocol;
-    /**
-     * What `getMessages` does when a stored message cannot be decoded — a
-     * decompression-guard trip, an unsupported `serdeType` after a config
-     * change, or genuinely corrupted bytes. `'skip'` (the default) drops the
-     * item, logs it at `error` with its sort key so an operator can locate
-     * it, and returns the rest; `'throw'` fails the whole read, which is
-     * all-or-nothing but leaves the session unreadable until the bad row is
-     * removed out of band.
-     */
-    onCorruptMessage?: CorruptMessagePolicy;
-};
-/** How `getMessages` handles an item it cannot decode. */
-export type CorruptMessagePolicy = 'skip' | 'throw';
-/**
- * Which slice of a session `getMessages` returns. Both bounds are optional
- * and combine: `{ limit: 50, before }` is the fifty messages just before
- * `before`.
- */
-export interface MessageWindow {
-    /** Return only the newest `limit` messages — still in chronological order. */
-    limit?: number;
-    /** Return only messages appended before this instant (millisecond precision). */
-    before?: Date;
-}
-/** Options for `getMessages`: the read window plus cancellation. */
-export type GetMessagesOptions = MessageWindow & CancelOptions;
-/** Options for `listSessions`: the scan caps plus cancellation. */
-export interface ListSessionsOptions extends CancelOptions {
-    /** Cap on scan pages before `ResultTruncatedError` (default 1000). */
-    maxIterations?: number;
-    /** Cap on rows read into memory before `ResultTruncatedError` (default 10 000). */
-    maxItems?: number;
-}
-/** Summary of a stored chat session. */
-export interface SessionMetadata {
-    sessionId: string;
-    title?: string;
-    messageCount: number;
-    createdAt: string;
-    updatedAt: string;
-    /** When the session's TTL expires, as an ISO-8601 instant; absent when no TTL is stored. */
-    expiresAt?: string;
-}
-/** A single stored chat message item (one per message, ordered by its ULID). */
-export interface ChatMessageItem {
-    PK: string;
-    SK: string;
-    sessionId: string;
-    message: PayloadDescriptor;
-    ttl?: number;
-}
-/** The per-session metadata item, updated atomically as messages are appended. */
-export interface ChatSessionItem {
-    PK: string;
-    SK: string;
-    sessionId: string;
-    messageCount: number;
-    title?: string;
-    createdAt: string;
-    updatedAt: string;
-    ttl?: number;
-}

package/dist/index.d.ts

@@ -1,29 +0,0 @@
-export { DynamoDBSaver } from './checkpointer/saver';
-export type { DynamoDBSaverOptions } from './checkpointer/types';
-export { DynamoDBStore } from './store/store';
-export type { DynamoDBStoreOptions } from './store/types';
-export type { VectorReconcileResult } from './store/actions/reconcile-vector-index';
-export type { VectorBackend, VectorMatch, VectorRef } from './store/vector-backend';
-export type { VectorScoreDirection } from './store/internal/score-direction';
-export { DynamoDBChatMessageHistory } from './history/chat-message-history';
-export { DynamoDBSessionChatMessageHistory } from './history/session-adapter';
-export type { AdapterWindow, SessionBackend } from './history/session-adapter';
-export type { CorruptMessagePolicy, DynamoDBChatMessageHistoryOptions, GetMessagesOptions, ListSessionsOptions, MessageWindow, SessionMetadata, } from './history/types';
-export { DynamoDBFactory } from './factory/factory';
-export type { AdapterSection, CreateAllOptions, CreatedAdapters, FactoryBaseOptions, } from './factory/types';
-export { DynamoDBLangGraphError, isDynamoDBLangGraphError } from './shared/errors/base-error';
-export type { ErrorContext } from './shared/errors/base-error';
-export { ErrorCode } from './shared/errors/error-code';
-export { AbortError, BatchWriteAllIncompleteError, BatchWriteIncompleteError, CompensationFailedError, ConflictError, ResultTruncatedError, RetryExhaustedError, ValidationError, } from './shared/errors/errors';
-export { UpstreamError } from './shared/errors/upstream-error';
-export type { Logger, LogArgument } from './shared/logging/logger';
-export { redactLogger, redactSecrets } from './shared/logging/redaction';
-export type { RedactLoggerOptions } from './shared/logging/redaction';
-export type { Redactable } from './shared/logging/redaction-walk';
-export type { CancelOptions, BaseAdapterOptions, CodecOptions } from './shared/options';
-export type { RetryAttemptInfo, RetryOptions } from './shared/dynamodb/retry';
-export type { RetryPolicy } from './shared/dynamodb/retry-policy';
-export type { TtlOption } from './shared/validation/ttl';
-export type { CompressionConfig } from './shared/codec/compression';
-export type { S3OffloadConfig } from './shared/codec/s3/config';
-export type { S3ClientConfigLike, S3ClientLike, S3ClientOption, S3ClientOptions, S3CommandLike, S3RegionLike, } from './shared/codec/s3/client-types';

package/dist/index.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.redactSecrets = exports.redactLogger = exports.UpstreamError = exports.ValidationError = exports.RetryExhaustedError = exports.ResultTruncatedError = exports.ConflictError = exports.CompensationFailedError = exports.BatchWriteIncompleteError = exports.BatchWriteAllIncompleteError = exports.AbortError = exports.ErrorCode = exports.isDynamoDBLangGraphError = exports.DynamoDBLangGraphError = exports.DynamoDBFactory = exports.DynamoDBSessionChatMessageHistory = exports.DynamoDBChatMessageHistory = exports.DynamoDBStore = exports.DynamoDBSaver = void 0;
-var saver_1 = require("./checkpointer/saver");
-Object.defineProperty(exports, "DynamoDBSaver", { enumerable: true, get: function () { return saver_1.DynamoDBSaver; } });
-var store_1 = require("./store/store");
-Object.defineProperty(exports, "DynamoDBStore", { enumerable: true, get: function () { return store_1.DynamoDBStore; } });
-var chat_message_history_1 = require("./history/chat-message-history");
-Object.defineProperty(exports, "DynamoDBChatMessageHistory", { enumerable: true, get: function () { return chat_message_history_1.DynamoDBChatMessageHistory; } });
-var session_adapter_1 = require("./history/session-adapter");
-Object.defineProperty(exports, "DynamoDBSessionChatMessageHistory", { enumerable: true, get: function () { return session_adapter_1.DynamoDBSessionChatMessageHistory; } });
-var factory_1 = require("./factory/factory");
-Object.defineProperty(exports, "DynamoDBFactory", { enumerable: true, get: function () { return factory_1.DynamoDBFactory; } });
-var base_error_1 = require("./shared/errors/base-error");
-Object.defineProperty(exports, "DynamoDBLangGraphError", { enumerable: true, get: function () { return base_error_1.DynamoDBLangGraphError; } });
-Object.defineProperty(exports, "isDynamoDBLangGraphError", { enumerable: true, get: function () { return base_error_1.isDynamoDBLangGraphError; } });
-var error_code_1 = require("./shared/errors/error-code");
-Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return error_code_1.ErrorCode; } });
-var errors_1 = require("./shared/errors/errors");
-Object.defineProperty(exports, "AbortError", { enumerable: true, get: function () { return errors_1.AbortError; } });
-Object.defineProperty(exports, "BatchWriteAllIncompleteError", { enumerable: true, get: function () { return errors_1.BatchWriteAllIncompleteError; } });
-Object.defineProperty(exports, "BatchWriteIncompleteError", { enumerable: true, get: function () { return errors_1.BatchWriteIncompleteError; } });
-Object.defineProperty(exports, "CompensationFailedError", { enumerable: true, get: function () { return errors_1.CompensationFailedError; } });
-Object.defineProperty(exports, "ConflictError", { enumerable: true, get: function () { return errors_1.ConflictError; } });
-Object.defineProperty(exports, "ResultTruncatedError", { enumerable: true, get: function () { return errors_1.ResultTruncatedError; } });
-Object.defineProperty(exports, "RetryExhaustedError", { enumerable: true, get: function () { return errors_1.RetryExhaustedError; } });
-Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
-var upstream_error_1 = require("./shared/errors/upstream-error");
-Object.defineProperty(exports, "UpstreamError", { enumerable: true, get: function () { return upstream_error_1.UpstreamError; } });
-var redaction_1 = require("./shared/logging/redaction");
-Object.defineProperty(exports, "redactLogger", { enumerable: true, get: function () { return redaction_1.redactLogger; } });
-Object.defineProperty(exports, "redactSecrets", { enumerable: true, get: function () { return redaction_1.redactSecrets; } });

package/dist/shared/clock.d.ts

@@ -1,8 +0,0 @@
-/** Current time as an ISO-8601 string, derived from the (test-freezable) clock. */
-export declare function nowIso(): string;
-/**
- * Current time as whole epoch seconds, the unit DynamoDB TTL uses. Every
- * expiry stamp, expiry filter and ttl-anchor comparison reads this one seam
- * so they agree with each other under a frozen or skewed clock.
- */
-export declare function nowSeconds(): number;

package/dist/shared/clock.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.nowIso = nowIso;
-exports.nowSeconds = nowSeconds;
-/** Current time as an ISO-8601 string, derived from the (test-freezable) clock. */
-function nowIso() {
-    return new Date(Date.now()).toISOString();
-}
-/**
- * Current time as whole epoch seconds, the unit DynamoDB TTL uses. Every
- * expiry stamp, expiry filter and ttl-anchor comparison reads this one seam
- * so they agree with each other under a frozen or skewed clock.
- */
-function nowSeconds() {
-    return Math.floor(Date.now() / 1000);
-}

package/dist/shared/codec/codec.d.ts

@@ -1,53 +0,0 @@
-import type { SerializerProtocol } from '@langchain/langgraph-checkpoint';
-import { CompressionConfig } from './compression';
-import type { S3Offloader } from './s3/offloader';
-/** Where an encoded payload lives. */
-export declare enum PayloadLocation {
-    INLINE = "INLINE",
-    S3 = "S3"
-}
-/**
- * Version of the persisted descriptor shape. Absent on rows written before it
- * existed, which read as version 1; a higher value marks a row written by a
- * newer library and is refused rather than misread.
- */
-export declare const DESCRIPTOR_SCHEMA_VERSION = 1;
-/** Fields every descriptor carries, whatever its location. */
-interface DescriptorBase {
-    schemaVersion?: number;
-    serdeType: string;
-    compressed: boolean;
-}
-/** A payload stored inline as bytes in the DynamoDB item. */
-interface InlinePayloadDescriptor extends DescriptorBase {
-    location: PayloadLocation.INLINE;
-    bytes: Uint8Array;
-}
-/** A payload offloaded to S3, referenced by key. */
-interface S3PayloadDescriptor extends DescriptorBase {
-    location: PayloadLocation.S3;
-    s3Key: string;
-}
-/** The result of encoding a payload. */
-export type PayloadDescriptor = InlinePayloadDescriptor | S3PayloadDescriptor;
-/** Collaborators for the codec. */
-export interface CodecDeps {
-    serde: SerializerProtocol;
-    compression?: CompressionConfig;
-    offloader?: S3Offloader;
-}
-/**
- * Fetch a descriptor's bytes — an S3 download when offloaded — and undo
- * compression. Infrastructure only, no deserialization: a caller that needs to
- * tell a transport or permission failure from bad data does this step and
- * `loadsTyped` separately (see `history/actions/get-messages.ts`).
- *
- * `scope` is the row's own leading key parts (`[threadId]`, `[...namespace,
- * key]`, `[sessionId]`): an offloaded key is downloaded only when it lies under
- * the path those parts produce, so a row can never point this adapter at an
- * object it does not own.
- */
-export declare function readPayloadBytes(descriptor: PayloadDescriptor, deps: CodecDeps, scope: readonly string[]): Promise<Uint8Array>;
-/** Decode a {@link PayloadDescriptor} produced by `encodePayload`; see {@link readPayloadBytes} for `scope`. */
-export declare function decodePayload<T>(descriptor: PayloadDescriptor, deps: CodecDeps, scope: readonly string[]): Promise<T>;
-export {};

package/dist/shared/codec/codec.js

@@ -1,66 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DESCRIPTOR_SCHEMA_VERSION = exports.PayloadLocation = void 0;
-exports.readPayloadBytes = readPayloadBytes;
-exports.decodePayload = decodePayload;
-const errors_1 = require("../errors/errors");
-const compression_1 = require("./compression");
-/** Where an encoded payload lives. */
-var PayloadLocation;
-(function (PayloadLocation) {
-    PayloadLocation["INLINE"] = "INLINE";
-    PayloadLocation["S3"] = "S3";
-})(PayloadLocation || (exports.PayloadLocation = PayloadLocation = {}));
-/**
- * Version of the persisted descriptor shape. Absent on rows written before it
- * existed, which read as version 1; a higher value marks a row written by a
- * newer library and is refused rather than misread.
- */
-exports.DESCRIPTOR_SCHEMA_VERSION = 1;
-function requireOffloader(deps) {
-    if (!deps.offloader) {
-        throw new errors_1.ValidationError("this row's payload is offloaded to S3 but the adapter has no `s3` configuration; " +
-            'configure the bucket the writer used', 's3');
-    }
-    return deps.offloader;
-}
-/** Refuse a descriptor this version cannot read: a newer schema, or an unknown location. */
-function assertReadableDescriptor(descriptor) {
-    const version = descriptor.schemaVersion ?? exports.DESCRIPTOR_SCHEMA_VERSION;
-    if (version > exports.DESCRIPTOR_SCHEMA_VERSION) {
-        throw new errors_1.ValidationError(`payload descriptor schemaVersion ${version} was written by a newer version of this ` +
-            'library; upgrade to read it', 'descriptor');
-    }
-    const locations = Object.values(PayloadLocation);
-    if (!locations.includes(descriptor.location)) {
-        throw new errors_1.ValidationError(`payload descriptor has an unknown location ${JSON.stringify(descriptor.location)}`, 'descriptor');
-    }
-}
-/**
- * Fetch a descriptor's bytes — an S3 download when offloaded — and undo
- * compression. Infrastructure only, no deserialization: a caller that needs to
- * tell a transport or permission failure from bad data does this step and
- * `loadsTyped` separately (see `history/actions/get-messages.ts`).
- *
- * `scope` is the row's own leading key parts (`[threadId]`, `[...namespace,
- * key]`, `[sessionId]`): an offloaded key is downloaded only when it lies under
- * the path those parts produce, so a row can never point this adapter at an
- * object it does not own.
- */
-async function readPayloadBytes(descriptor, deps, scope) {
-    assertReadableDescriptor(descriptor);
-    let raw;
-    if (descriptor.location === PayloadLocation.S3) {
-        const offloader = requireOffloader(deps);
-        offloader.assertOwnedKey(descriptor.s3Key, scope);
-        raw = await offloader.download(descriptor.s3Key);
-    }
-    else {
-        raw = descriptor.bytes;
-    }
-    return (0, compression_1.decompress)(raw, descriptor.compressed, deps.compression?.maxDecompressedBytes);
-}
-/** Decode a {@link PayloadDescriptor} produced by `encodePayload`; see {@link readPayloadBytes} for `scope`. */
-async function decodePayload(descriptor, deps, scope) {
-    return deps.serde.loadsTyped(descriptor.serdeType, await readPayloadBytes(descriptor, deps, scope));
-}

package/dist/shared/codec/compression.d.ts

@@ -1,24 +0,0 @@
-/** Configuration for payload compression. */
-export interface CompressionConfig {
-    enabled: boolean;
-    minSizeBytes?: number;
-    level?: number;
-    maxDecompressedBytes?: number;
-}
-/** The bytes to store plus whether they were gzip-compressed. */
-export interface CompressionResult {
-    bytes: Uint8Array;
-    compressed: boolean;
-}
-/**
- * Gzip `data` when it is at least `minSizeBytes` and compression actually saves
- * space. Returns the bytes to store and a `compressed` flag the caller records
- * in the payload descriptor; compression is never inferred from the bytes.
- */
-export declare function compress(data: Uint8Array, config: CompressionConfig): Promise<CompressionResult>;
-/**
- * Gunzip `data` when `compressed` is true; otherwise return it unchanged. Throws
- * a {@link DynamoDBLangGraphError} with code `COMPRESSION_LIMIT` if the output
- * would exceed `maxBytes` (bomb guard).
- */
-export declare function decompress(data: Uint8Array, compressed: boolean, maxBytes?: number): Promise<Uint8Array>;