@bsv/overlay 2.3.0 → 2.6.1

package/dist/types/src/storage/mongo/MongoAdmissionStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoAdmissionStorage.d.ts","sourceRoot":"","sources":["../../../../../src/storage/mongo/MongoAdmissionStorage.ts"],"names":[],"mappings":"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"}

package/dist/types/src/storage/mongo/MongoOverlayStorage.d.ts

@@ -0,0 +1,71 @@
+import type { Db } from 'mongodb';
+import type { Output } from '../../Output.js';
+import type { AppliedTransaction, Storage } from '../Storage.js';
+import { type AdmissionPayloadRef, type HistoryFence, type StorageScope } from '../AdmissionStorage.js';
+import { MongoAdmissionStorage, type MongoAdmissionStorageOptions } from './MongoAdmissionStorage.js';
+/**
+ * Opt-in Mongo Storage adapter that advertises overlay-admission-v1 only because
+ * commitAdmission actually honors majority ack, spends, history, and outbox.
+ */
+export declare class MongoOverlayStorage implements Storage {
+    private readonly db;
+    readonly admission: MongoAdmissionStorage;
+    readonly admissionScope: StorageScope;
+    private readonly payloads;
+    constructor(db: Db, scope: StorageScope, options?: MongoAdmissionStorageOptions);
+    enlistedIndexTargets(): readonly string[];
+    getHistoryFence(topic: string): Promise<HistoryFence>;
+    publishAdmissionPayload(input: {
+        kind: AdmissionPayloadRef['kind'];
+        bytes: Uint8Array;
+        txid?: string;
+    }): Promise<AdmissionPayloadRef>;
+    close(): Promise<void>;
+    insertOutput(utxo: Output): Promise<void>;
+    private persistTransactionBeef;
+    findOutput(txid: string, outputIndex: number, topic?: string, spent?: boolean, includeBEEF?: boolean): Promise<Output | null>;
+    findOutputsForTransaction(txid: string, includeBEEF?: boolean): Promise<Output[]>;
+    findUTXOsForTopic(topic: string, since?: number, limit?: number, includeBEEF?: boolean): Promise<Output[]>;
+    /**
+     * Maps a batch of raw output documents to `Output`s, dropping any that
+     * `toOutput` treats as non-serving (see its docstring). Every current
+     * caller's query already excludes `state: 'evicted'`, so this filter is
+     * defense in depth rather than the primary guard.
+     */
+    private toOutputs;
+    deleteOutput(txid: string, outputIndex: number, topic: string): Promise<void>;
+    markUTXOAsSpent(txid: string, outputIndex: number, topic: string, spendingTxid?: string): Promise<void>;
+    updateConsumedBy(txid: string, outputIndex: number, topic: string, consumedBy: Array<{
+        txid: string;
+        outputIndex: number;
+    }>): Promise<void>;
+    updateTransactionBEEF(txid: string, _beef: number[]): Promise<void>;
+    insertAppliedTransaction(tx: AppliedTransaction): Promise<void>;
+    doesAppliedTransactionExist(tx: AppliedTransaction): Promise<boolean>;
+    updateLastInteraction(host: string, topic: string, since: number): Promise<void>;
+    getLastInteraction(host: string, topic: string): Promise<number>;
+    private outputId;
+    private toSafeNumber;
+    /**
+     * Maps a raw output document to an `Output`, or `null` when the document
+     * is not currently serving as overlay state. An admission eviction leaves
+     * its row in place (state: 'evicted') for audit/history, and it must never
+     * be reported as a live, unspent output — every caller that reaches here
+     * must treat a `null` result the same as "not found", regardless of
+     * whether its own query already excluded `evicted` rows.
+     */
+    private toOutput;
+    /**
+     * Reads consumption edges persisted for this output (by either
+     * MongoAdmissionStorage.insertEdge during a commit, or
+     * MongoOverlayStorage.updateConsumedBy on the classic storage path) and
+     * returns the opposite endpoint of each matching edge: querying by the
+     * consumer side returns `outputsConsumed` (what this output's transaction
+     * spent), and querying by the source side returns `consumedBy` (what has
+     * since spent this output).
+     */
+    private readConsumptionEdges;
+    private readScript;
+    private readBeef;
+}
+//# sourceMappingURL=MongoOverlayStorage.d.ts.map

package/dist/types/src/storage/mongo/MongoOverlayStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoOverlayStorage.d.ts","sourceRoot":"","sources":["../../../../../src/storage/mongo/MongoOverlayStorage.ts"],"names":[],"mappings":"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"}

package/dist/types/src/storage/mongo/MongoPayloadStore.d.ts

@@ -0,0 +1,134 @@
+import { type ClientSession, type Db } from 'mongodb';
+import { type MongoChainScope } from './MongoSchema.js';
+/** Content types intentionally do not encode a caller's ownership domain. */
+export type MongoPayloadKind = 'raw-transaction' | 'merkle-path' | 'beef-manifest' | 'locking-script' | 'outbox-data';
+export type MongoPayloadReferenceOwnerKind = 'transaction' | 'applied-history' | 'output' | 'gasp-graph' | 'gasp-node' | 'basm-job' | 'lookup-outbox' | 'propagation-outbox' | 'manifest' | 'pin';
+export interface MongoPayloadInput {
+    kind: MongoPayloadKind;
+    /** SHA-256 of the canonical bytes, provided before upload to obtain a fenced reservation. */
+    digest: string;
+    bytes: AsyncIterable<Uint8Array>;
+    /** Canonical decimal uint64. The stream must contain exactly this many bytes. */
+    byteLength: string;
+    /** Required when the caller has already derived the raw transaction identity. */
+    txid?: string;
+    signal?: AbortSignal;
+}
+export interface MongoPayloadRef {
+    kind: MongoPayloadKind;
+    digest: string;
+    byteLength: string;
+    /** Bitcoin display-order txid, only for raw transaction payloads. */
+    txid?: string;
+}
+export interface MongoPayloadReference {
+    scope: MongoChainScope & {
+        nodeId: string;
+    };
+    payload: Pick<MongoPayloadRef, 'kind' | 'digest'>;
+    ownerKind: MongoPayloadReferenceOwnerKind;
+    ownerId: string;
+    slot: string;
+    /** Explicit pins are the sole reference class permitted to expire. */
+    expiresAt?: Date;
+}
+/** A manifest is an ordered list of independent content-addressed components. */
+export interface MongoManifestComponent {
+    manifestId: string;
+    ordinal: string;
+    kind: MongoPayloadKind;
+    payload: Pick<MongoPayloadRef, 'kind' | 'digest'>;
+}
+export interface MongoPayloadStoreOptions {
+    /** Kept deliberately far below Mongo's document cap. */
+    inlineCeilingBytes?: number;
+    /** A GridFS chunk must remain below the BSON document cap with ample overhead. */
+    gridFsChunkBytes?: number;
+    uploadLeaseMs?: number;
+    /** Application-level byte bound; BSON/GridFS are not an admission resource limit. */
+    maxPayloadBytes?: bigint;
+    now?: () => Date;
+    /** Narrow I/O seam used only to exercise crash boundaries. */
+    hooks?: Partial<Record<'afterGridFsUploaded' | 'afterGridFsPublished' | 'beforeReadyCas' | 'afterDeleteClaim', () => Promise<void> | void>>;
+}
+/** Per-operation cancellation/deadline controls supplied by the admission body. */
+export interface MongoPayloadOperationOptions {
+    timeoutMS?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Content-addressed blob primitives for the Mongo adapter. The store deliberately
+ * has no Engine/Storage methods: S03 combines its reference operations with the
+ * owner record in an admission transaction.
+ */
+export declare class MongoPayloadStore {
+    private readonly db;
+    private readonly options;
+    private readonly inlineCeiling;
+    private readonly gridFsChunkBytes;
+    private readonly uploadLeaseMs;
+    private readonly maxPayloadBytes;
+    private readonly now;
+    private readonly bucket;
+    private readonly scope;
+    private readonly writeConcern;
+    constructor(db: Db, scope: MongoChainScope & {
+        nodeId: string;
+    }, options?: MongoPayloadStoreOptions);
+    read(payload: Pick<MongoPayloadRef, 'kind' | 'digest'>, range?: {
+        offset: string;
+        byteLength: string;
+    }): Promise<Uint8Array>;
+    publish(input: MongoPayloadInput): Promise<MongoPayloadRef>;
+    /** Must be called in the same transaction that creates the referenced owner record. */
+    addReference(session: ClientSession, reference: MongoPayloadReference, operation?: MongoPayloadOperationOptions): Promise<void>;
+    /**
+     * Refreshes an existing pin's expiry when the same slot is re-added: an
+     * expired pin is reactivated with the caller's new expiry, and a still-live
+     * pin may only be extended, never silently shortened. Called only after the
+     * caller's {_id: payloadId, state: 'ready'} CAS has already matched in this
+     * transaction, so this stays serialized against a concurrent GC claim.
+     */
+    private refreshPinExpiry;
+    /** Must be called in the transaction that releases the owner record's payload obligation. */
+    releaseReference(session: ClientSession, reference: MongoPayloadReference, operation?: MongoPayloadOperationOptions): Promise<void>;
+    /**
+     * Creates one bounded manifest component and its durable pin in one caller
+     * transaction. S03 can combine this with its manifest owner record; this
+     * method does not parse or reconstruct BEEF.
+     */
+    addManifestComponent(session: ClientSession, component: MongoManifestComponent): Promise<void>;
+    /** Claims logical deletion inside a caller transaction; physical deletion resumes outside it. */
+    claimGarbage(session: ClientSession, payload: Pick<MongoPayloadRef, 'kind' | 'digest'>, operation?: MongoPayloadOperationOptions): Promise<boolean>;
+    /** Safe to retry after process death. It only deletes the file named by the deleting record. */
+    finishGarbage(payload: Pick<MongoPayloadRef, 'kind' | 'digest'>): Promise<boolean>;
+    /** Recovery may retain content; it never guesses that a missing external owner is disposable. */
+    recoverUploads(): Promise<void>;
+    private completeUpload;
+    private assertStreamedPayload;
+    private stageGridFsUpload;
+    private abandonUpload;
+    private recoverStaleUpload;
+    private reserveUpload;
+    private tryClaimUpload;
+    private streamInput;
+    private consumePayloadChunk;
+    private spillInlineToGridFs;
+    private finishPayloadUpload;
+    private fitsInline;
+    private retireOwnedFile;
+    private readBytes;
+    private verifyGridFs;
+    private refFor;
+    private payloadId;
+    private validateInput;
+    private validateReference;
+    private assertTransaction;
+    private assertOperation;
+    private nextWithAbort;
+    private awaitAbort;
+    private raceAbort;
+    private throwIfAborted;
+    private isUint64;
+}
+//# sourceMappingURL=MongoPayloadStore.d.ts.map

package/dist/types/src/storage/mongo/MongoPayloadStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoPayloadStore.d.ts","sourceRoot":"","sources":["../../../../../src/storage/mongo/MongoPayloadStore.ts"],"names":[],"mappings":"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"}

package/dist/types/src/storage/mongo/MongoReadGuards.d.ts

@@ -0,0 +1,44 @@
+import type { ClientSession, Db } from 'mongodb';
+import type { StorageScope } from '../AdmissionStorage.js';
+export interface MongoReadGuard {
+    scope: StorageScope;
+    /** A bounded logical-record identifier, never a dynamic BSON key. */
+    key: string;
+    /** `null` is an actual absent-record predicate, represented by a sentinel row. */
+    expectedVersion: string | null;
+}
+export interface MongoReadGuardOperationOptions {
+    timeoutMS?: number;
+    signal?: AbortSignal;
+}
+/** A semantic predicate conflict, as distinct from a transient Mongo transaction retry. */
+export declare class MongoReadGuardConflictError extends Error {
+    readonly code = "mongo-read-guard-conflict";
+    constructor(read: MongoReadGuard);
+}
+/**
+ * Durable optimistic read predicates for the Mongo admission transaction.
+ * Call `initialize` before starting a transaction; `check` and `changeVersion`
+ * intentionally require an active transaction and always write the sentinel.
+ */
+export declare class MongoReadGuards {
+    private readonly db;
+    constructor(db: Db);
+    /**
+     * Creates a version-null sentinel with majority+journal durability. This must
+     * run before the caller opens the admission transaction, so a negative read
+     * has a real row to conflict with a concurrent writer.
+     */
+    initialize(scope: StorageScope, key: string, operation?: MongoReadGuardOperationOptions): Promise<void>;
+    /** Checks a persisted version predicate by updating its random guard inside the transaction. */
+    check(session: ClientSession, read: MongoReadGuard, operation?: MongoReadGuardOperationOptions): Promise<void>;
+    /** Changes version and guard in one transactionally fenced row write. */
+    changeVersion(session: ClientSession, read: MongoReadGuard, nextVersion: string | null, operation?: MongoReadGuardOperationOptions): Promise<void>;
+    private collection;
+    private idFor;
+    private validateVersion;
+    private validatePart;
+    private assertTransaction;
+    private assertOperation;
+}
+//# sourceMappingURL=MongoReadGuards.d.ts.map

package/dist/types/src/storage/mongo/MongoReadGuards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoReadGuards.d.ts","sourceRoot":"","sources":["../../../../../src/storage/mongo/MongoReadGuards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,EAAE,EAAY,MAAM,SAAS,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAK1D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,CAAA;IACnB,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAA;IACX,kFAAkF;IAClF,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAeD,2FAA2F;AAC3F,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,SAAgB,IAAI,+BAA8B;IAElD,YAAmB,IAAI,EAAE,cAAc,EAGtC;CACF;AAED;;;;GAIG;AACH,qBAAa,eAAe;IACP,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAtC,YAAoC,EAAE,EAAE,EAAE,EAAI;IAE9C;;;;OAIG;IACU,UAAU,CACrB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,8BAAmC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAgDf;IAED,gGAAgG;IACnF,KAAK,CAChB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,cAAc,EACpB,SAAS,GAAE,8BAAmC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAYf;IAED,yEAAyE;IAC5D,aAAa,CACxB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,cAAc,EACpB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,SAAS,GAAE,8BAAmC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAaf;IAED,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,eAAe;CAYxB"}

package/dist/types/src/storage/mongo/MongoSchema.d.ts

@@ -0,0 +1,67 @@
+import type { Db, Document, IndexDescription } from 'mongodb';
+import { type StorageScope, type StorageUint64 } from '../AdmissionStorage.js';
+/** The immutable chain namespace shared by all Overlay nodes. */
+export interface MongoChainScope {
+    network: string;
+    genesisHash: string;
+}
+export declare const MongoCollectionNames: {
+    readonly schema: 'overlay_schema';
+    readonly payloads: 'overlay_payloads';
+    readonly payloadReferences: 'overlay_payload_references';
+    readonly submissionOperations: 'overlay_submission_operations';
+    readonly readGuards: 'overlay_read_guards';
+    readonly transactions: 'overlay_transactions';
+    readonly transactionProofs: 'overlay_transaction_proofs';
+    readonly outputs: 'overlay_outputs';
+    readonly consumptionEdges: 'overlay_consumption_edges';
+    readonly appliedTransactions: 'overlay_applied_transactions';
+    readonly topicGenerations: 'overlay_topic_generations';
+    readonly topicAnchors: 'overlay_topic_anchors';
+    readonly topicAnchorTips: 'overlay_topic_anchor_tips';
+    readonly basmRecoveryJobs: 'overlay_basm_recovery_jobs';
+    readonly basmComparisons: 'overlay_basm_comparisons';
+    readonly gaspCursors: 'overlay_gasp_cursors';
+    readonly gaspGraphs: 'overlay_gasp_graphs';
+    readonly gaspNodes: 'overlay_gasp_nodes';
+    readonly manifestComponents: 'overlay_manifest_components';
+    readonly lookupOutbox: 'overlay_lookup_outbox';
+    readonly propagationOutbox: 'overlay_propagation_outbox';
+    readonly shipRecords: 'overlay_ship_records';
+    readonly slapRecords: 'overlay_slap_records';
+    readonly bannedRecords: 'overlay_banned_records';
+};
+/** GridFS bucket for payload bytes that cannot be stored inline. */
+export declare const MongoGridFsBucketName = "overlayPayloads";
+/**
+ * A length-framed, UTF-8 tuple. It remains unambiguous when values contain
+ * dots, colons, or separators and is safe to use only as a BSON value, never
+ * as a dynamic BSON field name.
+ */
+export declare function mongoRecordKey(...parts: string[]): string;
+export declare function mongoChainKey(scope: MongoChainScope): string;
+export declare function mongoNodeKey(scope: StorageScope): string;
+/** Stores a canonical S01 uint64 in an exact, lexically sortable BSON string. */
+export declare function encodeMongoUint64(value: string): string;
+/** Strict inverse of encodeMongoUint64; rejects non-canonical padded values. */
+export declare function decodeMongoUint64(value: string): StorageUint64;
+/** Validates the wire uint32 domain and returns its canonical decimal spelling. */
+export declare function encodeMongoOutputIndex(value: string): string;
+export interface MongoCollectionDefinition {
+    readonly name: (typeof MongoCollectionNames)[keyof typeof MongoCollectionNames];
+    readonly validator: Document;
+    readonly indexes: readonly IndexDescription[];
+}
+export declare const MongoCollectionDefinitions: readonly MongoCollectionDefinition[];
+export interface MongoOverlayCapability {
+    readonly topology: 'replica-set';
+    readonly schemaVersion: 1;
+    readonly scope: Readonly<StorageScope>;
+    readonly collections: readonly string[];
+}
+/**
+ * Creates only empty Overlay-owned collections and refuses all incompatible
+ * pre-existing schema. It never drops, migrates, or relaxes validation.
+ */
+export declare function bootstrapMongoOverlay(db: Db, scope: StorageScope): Promise<MongoOverlayCapability>;
+//# sourceMappingURL=MongoSchema.d.ts.map

package/dist/types/src/storage/mongo/MongoSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoSchema.d.ts","sourceRoot":"","sources":["../../../../../src/storage/mongo/MongoSchema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC7E,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAA;AAE/B,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,eAAO,MAAM,oBAAoB;aAC/B,MAAM,EAAE,gBAAgB;aACxB,QAAQ,EAAE,kBAAkB;aAC5B,iBAAiB,EAAE,4BAA4B;aAC/C,oBAAoB,EAAE,+BAA+B;aACrD,UAAU,EAAE,qBAAqB;aACjC,YAAY,EAAE,sBAAsB;aACpC,iBAAiB,EAAE,4BAA4B;aAC/C,OAAO,EAAE,iBAAiB;aAC1B,gBAAgB,EAAE,2BAA2B;aAC7C,mBAAmB,EAAE,8BAA8B;aACnD,gBAAgB,EAAE,2BAA2B;aAC7C,YAAY,EAAE,uBAAuB;aACrC,eAAe,EAAE,2BAA2B;aAC5C,gBAAgB,EAAE,4BAA4B;aAC9C,eAAe,EAAE,0BAA0B;aAC3C,WAAW,EAAE,sBAAsB;aACnC,UAAU,EAAE,qBAAqB;aACjC,SAAS,EAAE,oBAAoB;aAC/B,kBAAkB,EAAE,6BAA6B;aACjD,YAAY,EAAE,uBAAuB;aACrC,iBAAiB,EAAE,4BAA4B;aAC/C,WAAW,EAAE,sBAAsB;aACnC,WAAW,EAAE,sBAAsB;aACnC,aAAa,EAAE,wBAAwB;CAC/B,CAAA;AAEV,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,oBAAoB,CAAA;AAuBtD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CASzD;AAgBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAG5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAGxD;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAO9D;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D;AAkED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAA;IAC/E,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAC9C;AAmkBD,eAAO,MAAM,0BAA0B,EAAE,SAAS,yBAAyB,EAAgB,CAAA;AAqB3F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,sBAAsB,CAAC,CAoBjC"}

package/dist/types/src/storage/mongo/MongoTransactionRunner.d.ts

@@ -0,0 +1,69 @@
+import { type ClientSession, type Db } from 'mongodb';
+import { type AdmissionCommitResult, type AdmissionIdentity, type AdmissionOperationKey, type AdmissionReceipt, type AdmissionReconcileResult, type StorageScope } from '../AdmissionStorage.js';
+export interface MongoTransactionRequest {
+    key: AdmissionOperationKey;
+    identity: AdmissionIdentity;
+    receipt: AdmissionReceipt;
+}
+export interface MongoTransactionOptions {
+    /** Total call budget, including claim, body and commit. Range 1..50000 ms. */
+    timeoutMS?: number;
+    signal?: AbortSignal;
+}
+export interface MongoTransactionRunnerOptions {
+    maxBodyAttempts?: number;
+    maxCommitAttempts?: number;
+    /** Persisted ownership lease; expiry permits a fenced abort, never implies one. */
+    leaseMS?: number;
+    /** Unresolved sessions are retained for same-session commit reconciliation. */
+    maxRetainedSessions?: number;
+}
+export interface MongoTransactionContext {
+    readonly session: ClientSession;
+    /** Obtain immediately before EACH database operation; do not cache or omit it. */
+    options: () => {
+        session: ClientSession;
+        timeoutMS: number;
+    };
+    /** Cooperative body gate. Mongo write deadlines use timeoutMS, not signal. */
+    readonly signal: AbortSignal;
+}
+/**
+ * Database-only transaction foundation, NOT an AdmissionStorage adapter. The
+ * trusted body must enlist all its reads/writes using context.options(), finish
+ * all its work before returning, and perform no uploads, plug-ins or network I/O.
+ * The caller remains responsible for admission, read guards, spends and payloads.
+ */
+export declare class MongoTransactionRunner {
+    private readonly db;
+    private readonly scope;
+    private readonly owner;
+    private readonly attempts;
+    private readonly maxBodyAttempts;
+    private readonly maxCommitAttempts;
+    private readonly leaseMS;
+    private readonly maxRetainedSessions;
+    private closed;
+    private reservations;
+    private calls;
+    constructor(db: Db, scope: StorageScope, options?: MongoTransactionRunnerOptions);
+    private collection;
+    private id;
+    private read;
+    private result;
+    private fence;
+    private release;
+    private abort;
+    private commit;
+    private claim;
+    run(request: MongoTransactionRequest, body: (context: MongoTransactionContext) => Promise<void>, options?: MongoTransactionOptions): Promise<AdmissionCommitResult>;
+    private rejectRun;
+    private ensureClaimableRow;
+    private observeClaimWinner;
+    private executeTrustedBody;
+    private runBodyAttempt;
+    reconcile(key: AdmissionOperationKey, attemptId?: string, options?: MongoTransactionOptions): Promise<AdmissionReconcileResult>;
+    /** Shutdown only. Persisted receipt/fenced orphan reconciliation survives it. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=MongoTransactionRunner.d.ts.map

package/dist/types/src/storage/mongo/MongoTransactionRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoTransactionRunner.d.ts","sourceRoot":"","sources":["../../../../../src/storage/mongo/MongoTransactionRunner.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,KAAK,aAAa,EAAE,KAAK,EAAE,EAAiB,MAAM,SAAS,CAAA;AAC5E,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAA;AAS/B,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,qBAAqB,CAAA;IAC1B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,OAAO,EAAE,gBAAgB,CAAA;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,kFAAkF;IAClF,OAAO,EAAE,MAAM;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5D,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B;AA+HD;;;;;GAKG;AACH,qBAAa,sBAAsB;IAYrB,OAAO,CAAC,QAAQ,CAAC,EAAE;IAX/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;IAC5C,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,KAAK,CAAI;IAEjB,YAA6B,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,6BAAkC,EAOpG;IAED,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,EAAE;YAOI,IAAI;IAIlB,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,KAAK;YAIC,OAAO;YAKP,KAAK;YAgBL,MAAM;YAuBN,KAAK;IAiBb,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAsB5K;IAED,OAAO,CAAC,SAAS;YAcH,kBAAkB;YAkBlB,kBAAkB;YAWlB,kBAAkB;YAmClB,cAAc;IAgBtB,SAAS,CAAC,GAAG,EAAE,qBAAqB,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA+BxI;IAED,iFAAiF;IAC3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3B;CACF"}

package/dist/types/src/storage/mongo.d.ts

@@ -0,0 +1,9 @@
+/** Opt-in Mongo primitives. Importing the root Overlay entry does not load this driver. */
+export * from './mongo/MongoSchema.js';
+export * from './mongo/MongoPayloadStore.js';
+export * from './mongo/MongoReadGuards.js';
+export * from './mongo/MongoTransactionRunner.js';
+export * from './mongo/MongoAdmissionPlan.js';
+export * from './mongo/MongoAdmissionStorage.js';
+export * from './mongo/MongoOverlayStorage.js';
+//# sourceMappingURL=mongo.d.ts.map

package/dist/types/src/storage/mongo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.d.ts","sourceRoot":"","sources":["../../../../src/storage/mongo.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,cAAc,wBAAwB,CAAA;AACtC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mCAAmC,CAAA;AACjD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,kCAAkC,CAAA;AAChD,cAAc,gCAAgC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/overlay",
-  "version": "2.3.0",
+  "version": "2.6.1",
   "sideEffects": false,
   "engines": {
     "node": ">=22"
@@ -17,7 +17,9 @@
     "dist",
     "!dist/**/*.tsbuildinfo",
     "README.md",
-    "LICENSE.txt"
+    "LICENSE.txt",
+    "THIRD_PARTY_NOTICES.md",
+    "LICENSES"
   ],
   "exports": {
     ".": {
@@ -90,12 +92,14 @@
   },
   "homepage": "https://github.com/bsv-blockchain/ts-stack/tree/main/packages/overlays/overlay#readme",
   "devDependencies": {
-    "@bsv/sdk": "^2.3.0",
+    "@bsv/sdk": "^2.8.0",
     "@types/jest": "^30.0.0",
     "@types/node": "^26.1.2",
     "@typescript/native": "npm:typescript@7.0.2",
     "fast-check": "^4.9.0",
     "jest": "^30.4.2",
+    "mongodb": "7.5.0",
+    "mongodb-memory-server": "^11.2.0",
     "oxlint": "^1.76.0",
     "ts-jest": "^29.4.12",
     "ts2md": "^0.2.8",
@@ -103,15 +107,19 @@
     "typescript": "npm:@typescript/typescript6@6.0.2"
   },
   "dependencies": {
-    "@bsv/gasp": "^1.3.5",
+    "@bsv/gasp": "^1.3.7",
     "knex": "^3.3.0"
   },
   "peerDependencies": {
-    "@bsv/sdk": "^2.1.6"
+    "@bsv/sdk": "^2.1.6",
+    "mongodb": "^7.5.0"
   },
   "peerDependenciesMeta": {
     "@bsv/sdk": {
       "optional": false
+    },
+    "mongodb": {
+      "optional": true
     }
   },
   "typesVersions": {
@@ -138,7 +146,7 @@
     "format:check": "pnpm --workspace-root exec prettier --check \"packages/overlays/overlay/{README.md,jest.config.js,mod.ts,package.json,tsconfig*.json}\"",
     "lint": "oxlint mod.ts src jest.config.js --deny-warnings",
     "lint:ci": "pnpm lint",
-    "pack:check": "pnpm build && node ../../../scripts/check-package-artifact.mjs . --exports BASM_ZERO_HASH,Engine,KnexStorage,KnexStorageMigrations,computeBasmRoot,computeTac,extractMerkleProofMetadata,serializeErrorForLog,serializeLogValue --entry-exports \"./storage=;./storage/knex/KnexStorage=KnexStorage\"",
+    "pack:check": "pnpm build && node ../../../scripts/check-package-artifact.mjs . --exports admissionSemanticDigest,canAdvanceGaspCursor,getAdmissionStorage,isRecoveryLeaseCurrent,isReplaySafeProjection,parseStorageUint64,parseStorageOutputIndex,storageHasAdmission,BASM_ZERO_HASH,Engine,KnexStorage,KnexStorageMigrations,computeBasmRoot,computeTac,extractMerkleProofMetadata,serializeErrorForLog,serializeLogValue --entry-exports \"./storage=storageHasAdmission;./storage/knex/KnexStorage=KnexStorage\"",
     "typecheck": "tsc --project tsconfig.base.json --noEmit --incremental false",
     "build": "tsc -b && tsconfig-to-dual-package tsconfig.cjs.json",
     "dev": "tsc -b -w",