@angriff36/manifest 2.18.0

package/dist/manifest/outbox/stores/dynamodb.js

@@ -0,0 +1,239 @@
+/**
+ * DynamoDBOutboxStore — OutboxStore adapter backed by AWS DynamoDB.
+ *
+ * The outbox pattern requires a transactional guarantee: when a command
+ * mutates entity state, the semantic event must be persisted atomically
+ * with that state change. DynamoDB provides this via TransactWriteItems,
+ * which groups up to 100 actions (Put / Update / Delete / ConditionCheck)
+ * into a single ACID transaction.
+ *
+ * Concurrency model for `claim`: dispatchers scan the table for pending
+ * entries and atomically update each to "claimed" via a conditional
+ * UpdateItem with `ConditionExpression: status = 'pending'`. The first
+ * worker to win the condition race claims the entry; the rest get a
+ * `ConditionalCheckFailedException` and move on. This provides safe
+ * concurrent dispatch without explicit row locks.
+ *
+ * Stream integration: the companion `manifest_outbox_table` is configured
+ * with DynamoDB Streams. A Lambda or Kinesis consumer can process the
+ * stream for at-least-once delivery to downstream sinks (SNS, SQS, EventBridge).
+ * The `claim`/`markDelivered`/`markFailed` methods are the pull-based
+ * alternative; stream consumers implement their own tracking.
+ *
+ * Item shape:
+ *   {
+ *     pk:         "OUTBOX#<entryId>",   // partition key
+ *     sk:         "META",                // sort key (single-table friendly)
+ *     entry_id:   string,
+ *     enqueued_at: number,               // ms since epoch
+ *     event:      object,                // EmittedEvent payload
+ *     status:     "pending" | "delivered" | "failed",
+ *     attempts:   number,
+ *     last_error: string | null,
+ *     claimed_at: number | null,
+ *     delivered_at: number | null,
+ *     failed_at:   number | null,
+ *     subject_entity: string | null,     // optional projection
+ *     subject_id:     string | null,
+ *   }
+ *
+ * DO NOT import this file in browser code — it requires the AWS SDK.
+ */
+const DEFAULT_TABLE = 'manifest_outbox_table';
+function itemToEntry(item) {
+    const entry = {
+        entryId: item.entry_id,
+        enqueuedAt: item.enqueued_at,
+        event: item.event,
+        status: item.status,
+        attempts: item.attempts,
+    };
+    if (item.last_error) {
+        entry.lastError = item.last_error;
+    }
+    return entry;
+}
+export class DynamoDBOutboxStore {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    client;
+    tableName;
+    partitionKey;
+    sortKey;
+    projectSubject;
+    constructor(opts) {
+        this.client = opts.client;
+        this.tableName = opts.tableName ?? DEFAULT_TABLE;
+        this.partitionKey = opts.partitionKey ?? 'pk';
+        this.sortKey = opts.sortKey ?? 'sk';
+        this.projectSubject = opts.projectSubject ?? false;
+    }
+    buildKey(entryId) {
+        return { [this.partitionKey]: `OUTBOX#${entryId}`, [this.sortKey]: 'META' };
+    }
+    /**
+     * Enqueue entries. The DynamoDB adapter batches up to 100 items per
+     * TransactWriteItems call. The `tx` parameter is accepted for contract
+     * compatibility with other outbox stores (e.g. Postgres), but DynamoDB
+     * transactions are scoped to a single client invocation and cannot be
+     * shared across separate API calls. Therefore, the transactional
+     * guarantee is always within a single `enqueue` call: either all
+     * entries in the batch are persisted, or none are.
+     *
+     * If you need to atomically enqueue entries together with entity state
+     * mutations, use the `TransactWriteItems` API directly and group the
+     * outbox PutItems with the entity PutItems in a single call.
+     */
+    async enqueue(entries, tx) {
+        if (entries.length === 0)
+            return;
+        void tx; // intentionally unused - see JSDoc above
+        // DynamoDB TransactWriteItems supports up to 100 actions per call.
+        const BATCH_SIZE = 100;
+        for (let i = 0; i < entries.length; i += BATCH_SIZE) {
+            const batch = entries.slice(i, i + BATCH_SIZE);
+            const transactItems = batch.map((entry) => {
+                const pk = `OUTBOX#${entry.entryId}`;
+                const sk = 'META';
+                const item = {
+                    pk,
+                    sk,
+                    [this.partitionKey]: pk,
+                    [this.sortKey]: sk,
+                    entry_id: entry.entryId,
+                    enqueued_at: entry.enqueuedAt,
+                    event: entry.event,
+                    status: entry.status,
+                    attempts: entry.attempts,
+                    last_error: entry.lastError ?? null,
+                    claimed_at: null,
+                    delivered_at: null,
+                    failed_at: null,
+                };
+                if (this.projectSubject && entry.event.subject) {
+                    item.subject_entity = entry.event.subject.entity;
+                    item.subject_id = entry.event.subject.id;
+                }
+                return {
+                    Put: {
+                        TableName: this.tableName,
+                        Item: item,
+                        // Idempotency: a retried enqueue with the same entryId is ignored.
+                        ConditionExpression: 'attribute_not_exists(#pk)',
+                        ExpressionAttributeNames: { '#pk': this.partitionKey },
+                    },
+                };
+            });
+            await this.client.send(new this.client.TransactWriteCommand({ TransactItems: transactItems }));
+        }
+    }
+    /**
+     * Claim up to `batchSize` pending entries. Scans the table for
+     * 'pending' entries and atomically transitions each to 'claimed'
+     * via a conditional UpdateItem. The first worker to win the
+     * condition race claims the entry.
+     *
+     * Note: Scan is used here for simplicity. For high-volume outboxes,
+     * maintain a GSI on `status` to enable efficient Query.
+     */
+    async claim(batchSize) {
+        if (batchSize <= 0)
+            return [];
+        // 1. Find candidate entries
+        const scan = await this.client.send(new this.client.ScanCommand({
+            TableName: this.tableName,
+            FilterExpression: '#st = :pending',
+            ExpressionAttributeNames: { '#st': 'status' },
+            ExpressionAttributeValues: { ':pending': 'pending' },
+            Limit: batchSize,
+        }));
+        const candidates = (scan.Items ?? []);
+        if (candidates.length === 0)
+            return [];
+        // 2. Attempt to claim each via a conditional update
+        const claimed = [];
+        for (const item of candidates) {
+            if (claimed.length >= batchSize)
+                break;
+            try {
+                const result = await this.client.send(new this.client.UpdateCommand({
+                    TableName: this.tableName,
+                    Key: this.buildKey(item.entry_id),
+                    UpdateExpression: 'SET #st = :claimed, #att = #att + :one, #cat = :now',
+                    ConditionExpression: '#st = :pending',
+                    ExpressionAttributeNames: {
+                        '#st': 'status',
+                        '#att': 'attempts',
+                        '#cat': 'claimed_at',
+                    },
+                    ExpressionAttributeValues: {
+                        ':claimed': 'pending', // status remains pending; claimed_at tracks
+                        ':one': 1,
+                        ':pending': 'pending',
+                        ':now': Date.now(),
+                    },
+                    ReturnValues: 'ALL_NEW',
+                }));
+                if (result.Attributes) {
+                    claimed.push(itemToEntry(result.Attributes));
+                }
+            }
+            catch (err) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const error = err;
+                if (error?.name === 'ConditionalCheckFailedException') {
+                    // Another worker claimed it; skip.
+                    continue;
+                }
+                throw err;
+            }
+        }
+        return claimed;
+    }
+    /** Mark entries delivered. */
+    async markDelivered(entryIds) {
+        if (entryIds.length === 0)
+            return;
+        const BATCH_SIZE = 100;
+        for (let i = 0; i < entryIds.length; i += BATCH_SIZE) {
+            const batch = entryIds.slice(i, i + BATCH_SIZE);
+            const transactItems = batch.map((id) => ({
+                Update: {
+                    TableName: this.tableName,
+                    Key: this.buildKey(id),
+                    UpdateExpression: 'SET #st = :delivered, #dat = :now',
+                    ExpressionAttributeNames: { '#st': 'status', '#dat': 'delivered_at' },
+                    ExpressionAttributeValues: { ':delivered': 'delivered', ':now': Date.now() },
+                },
+            }));
+            await this.client.send(new this.client.TransactWriteCommand({ TransactItems: transactItems }));
+        }
+    }
+    /** Mark entries failed with a reason. */
+    async markFailed(entryIds, error) {
+        if (entryIds.length === 0)
+            return;
+        const BATCH_SIZE = 100;
+        for (let i = 0; i < entryIds.length; i += BATCH_SIZE) {
+            const batch = entryIds.slice(i, i + BATCH_SIZE);
+            const transactItems = batch.map((id) => ({
+                Update: {
+                    TableName: this.tableName,
+                    Key: this.buildKey(id),
+                    UpdateExpression: 'SET #st = :failed, #le = :err, #fat = :now',
+                    ExpressionAttributeNames: {
+                        '#st': 'status',
+                        '#le': 'last_error',
+                        '#fat': 'failed_at',
+                    },
+                    ExpressionAttributeValues: {
+                        ':failed': 'failed',
+                        ':err': error,
+                        ':now': Date.now(),
+                    },
+                },
+            }));
+            await this.client.send(new this.client.TransactWriteCommand({ TransactItems: transactItems }));
+        }
+    }
+}
+//# sourceMappingURL=dynamodb.js.map

package/dist/manifest/outbox/stores/dynamodb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamodb.js","sourceRoot":"","sources":["../../../../src/manifest/outbox/stores/dynamodb.ts"],"names":[],"mappings":"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"}

package/dist/manifest/outbox/stores/memory.d.ts

@@ -0,0 +1,54 @@
+/**
+ * MemoryOutboxStore — first-party in-memory implementation of the
+ * OutboxStore contract (src/manifest/outbox/outbox-store.ts).
+ *
+ * Intended use:
+ *   - Unit and conformance tests
+ *   - Local development and sample applications
+ *   - Reference for downstream durable implementations
+ *
+ * Durability: none. State lives in process memory only.
+ *
+ * Transactionality: the in-memory store ignores the `tx` argument passed to
+ * `enqueue` — there is no shared transaction boundary in the in-memory
+ * runtime today. Durable adapters MUST honor `tx` to inherit the
+ * transactional outbox guarantee.
+ *
+ * Concurrency: a per-entry `claimed` flag stands in for SELECT … FOR UPDATE
+ * SKIP LOCKED semantics; concurrent callers of `claim` never receive the
+ * same entry, and entries already delivered/failed never re-appear from
+ * `claim` regardless of status transitions.
+ */
+import type { OutboxEntry, OutboxStore } from '../outbox-store';
+export interface MemoryOutboxStoreOptions {
+    /** Provide a stable id generator for entries that arrive without one. */
+    generateId?: () => string;
+    /** Wall-clock function for enqueuedAt/claimedAt/etc. Defaults to Date.now. */
+    now?: () => number;
+}
+export declare class MemoryOutboxStore implements OutboxStore {
+    private entries;
+    private seenEntryIds;
+    private generateId;
+    private now;
+    constructor(opts?: MemoryOutboxStoreOptions);
+    enqueue(entries: OutboxEntry[], _tx?: unknown): Promise<void>;
+    claim(batchSize: number): Promise<OutboxEntry[]>;
+    markDelivered(entryIds: string[]): Promise<void>;
+    markFailed(entryIds: string[], error: string): Promise<void>;
+    /**
+     * Diagnostic helper: return a snapshot of all entries (defensive copy).
+     * Not part of the OutboxStore contract — for tests and observability.
+     */
+    list(): OutboxEntry[];
+    /** Number of entries currently stored. */
+    size(): number;
+    /**
+     * Release a claim without delivering or failing. Useful for tests that
+     * need to simulate a worker crash mid-delivery. Not part of the contract.
+     */
+    releaseClaim(entryIds: string[]): void;
+    clear(): void;
+    private exposeEntry;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/manifest/outbox/stores/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/manifest/outbox/stores/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAcD,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,GAAG,CAAe;gBAEd,IAAI,GAAE,wBAA6B;IAKzC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7D,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkBhD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE;;;OAGG;IACH,IAAI,IAAI,WAAW,EAAE;IAIrB,0CAA0C;IAC1C,IAAI,IAAI,MAAM;IAId;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAStC,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,WAAW;CAWpB"}

package/dist/manifest/outbox/stores/memory.js

@@ -0,0 +1,131 @@
+/**
+ * MemoryOutboxStore — first-party in-memory implementation of the
+ * OutboxStore contract (src/manifest/outbox/outbox-store.ts).
+ *
+ * Intended use:
+ *   - Unit and conformance tests
+ *   - Local development and sample applications
+ *   - Reference for downstream durable implementations
+ *
+ * Durability: none. State lives in process memory only.
+ *
+ * Transactionality: the in-memory store ignores the `tx` argument passed to
+ * `enqueue` — there is no shared transaction boundary in the in-memory
+ * runtime today. Durable adapters MUST honor `tx` to inherit the
+ * transactional outbox guarantee.
+ *
+ * Concurrency: a per-entry `claimed` flag stands in for SELECT … FOR UPDATE
+ * SKIP LOCKED semantics; concurrent callers of `claim` never receive the
+ * same entry, and entries already delivered/failed never re-appear from
+ * `claim` regardless of status transitions.
+ */
+export class MemoryOutboxStore {
+    entries = [];
+    seenEntryIds = new Set();
+    generateId;
+    now;
+    constructor(opts = {}) {
+        this.generateId = opts.generateId ?? (() => crypto.randomUUID());
+        this.now = opts.now ?? (() => Date.now());
+    }
+    async enqueue(entries, _tx) {
+        for (const entry of entries) {
+            const entryId = entry.entryId ?? this.generateId();
+            if (this.seenEntryIds.has(entryId)) {
+                continue;
+            }
+            this.seenEntryIds.add(entryId);
+            this.entries.push({
+                ...entry,
+                entryId,
+                enqueuedAt: entry.enqueuedAt ?? this.now(),
+                status: entry.status ?? 'pending',
+                attempts: entry.attempts ?? 0,
+                claimed: false,
+            });
+        }
+    }
+    async claim(batchSize) {
+        if (batchSize <= 0)
+            return [];
+        const claimedAt = this.now();
+        const out = [];
+        for (const entry of this.entries) {
+            if (out.length >= batchSize)
+                break;
+            if (entry.status !== 'pending')
+                continue;
+            if (entry.claimed)
+                continue;
+            entry.claimed = true;
+            entry.claimedAt = claimedAt;
+            entry.attempts += 1;
+            out.push(this.exposeEntry(entry));
+        }
+        return out;
+    }
+    async markDelivered(entryIds) {
+        const ids = new Set(entryIds);
+        const deliveredAt = this.now();
+        for (const entry of this.entries) {
+            if (!ids.has(entry.entryId))
+                continue;
+            entry.status = 'delivered';
+            entry.claimed = false;
+            entry.deliveredAt = deliveredAt;
+        }
+    }
+    async markFailed(entryIds, error) {
+        const ids = new Set(entryIds);
+        const failedAt = this.now();
+        for (const entry of this.entries) {
+            if (!ids.has(entry.entryId))
+                continue;
+            entry.status = 'failed';
+            entry.lastError = error;
+            entry.claimed = false;
+            entry.failedAt = failedAt;
+        }
+    }
+    /**
+     * Diagnostic helper: return a snapshot of all entries (defensive copy).
+     * Not part of the OutboxStore contract — for tests and observability.
+     */
+    list() {
+        return this.entries.map(e => this.exposeEntry(e));
+    }
+    /** Number of entries currently stored. */
+    size() {
+        return this.entries.length;
+    }
+    /**
+     * Release a claim without delivering or failing. Useful for tests that
+     * need to simulate a worker crash mid-delivery. Not part of the contract.
+     */
+    releaseClaim(entryIds) {
+        const ids = new Set(entryIds);
+        for (const entry of this.entries) {
+            if (!ids.has(entry.entryId))
+                continue;
+            entry.claimed = false;
+            entry.claimedAt = undefined;
+        }
+    }
+    clear() {
+        this.entries = [];
+        this.seenEntryIds.clear();
+    }
+    exposeEntry(entry) {
+        const exposed = {
+            entryId: entry.entryId,
+            enqueuedAt: entry.enqueuedAt,
+            event: entry.event,
+            status: entry.status,
+            attempts: entry.attempts,
+        };
+        if (entry.lastError !== undefined)
+            exposed.lastError = entry.lastError;
+        return exposed;
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/manifest/outbox/stores/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../src/manifest/outbox/stores/memory.ts"],"names":[],"mappings":"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"}

package/dist/manifest/outbox/stores/mongodb.d.ts

@@ -0,0 +1,58 @@
+/**
+ * MongoDBOutboxStore — MongoDB implementation of the OutboxStore contract.
+ *
+ * Uses MongoDB's `findOneAndUpdate` with atomic filter conditions to simulate
+ * the `SELECT … FOR UPDATE SKIP LOCKED` semantics used by the PostgreSQL
+ * adapter. Change streams on the outbox collection enable reactive dispatch.
+ *
+ * 'mongodb' is an optional peer dependency. It is loaded via dynamic import
+ * at construction time. If the package is not installed, a clear error is
+ * thrown.
+ *
+ * Transaction support: the `tx` parameter in `enqueue` accepts a MongoDB
+ * `ClientSession` for transactional outbox pattern — state mutation and
+ * event persistence share the same session/transaction boundary.
+ */
+import type { OutboxEntry, OutboxStore } from '../outbox-store';
+export interface MongoDBOutboxStoreConfig {
+    connectionString: string;
+    databaseName?: string;
+    collectionName?: string;
+}
+export interface MongoDBOutboxStoreOptions {
+    /** Provide a stable id generator for entries that arrive without one. */
+    generateId?: () => string;
+    /** Wall-clock function for timestamps. Defaults to Date.now. */
+    now?: () => number;
+}
+export declare class MongoDBOutboxStore implements OutboxStore {
+    private client;
+    private collection;
+    private collectionName;
+    private databaseName;
+    private generateId;
+    private now;
+    private ready;
+    constructor(config: MongoDBOutboxStoreConfig, opts?: MongoDBOutboxStoreOptions);
+    private init;
+    private ensureReady;
+    enqueue(entries: OutboxEntry[], tx?: unknown): Promise<void>;
+    claim(batchSize: number): Promise<OutboxEntry[]>;
+    markDelivered(entryIds: string[]): Promise<void>;
+    markFailed(entryIds: string[], error: string): Promise<void>;
+    /**
+     * Start watching the outbox collection for new entries via MongoDB change
+     * streams. Returns a change stream that emits 'insert' events for reactive
+     * dispatch.
+     *
+     * This is NOT part of the OutboxStore contract — it's a MongoDB-specific
+     * utility for consumers that want push-based event dispatch instead of
+     * polling with `claim()`.
+     *
+     * Requires a MongoDB replica set or sharded cluster.
+     */
+    watch(): Promise<any>;
+    close(): Promise<void>;
+    private docToEntry;
+}
+//# sourceMappingURL=mongodb.d.ts.map

package/dist/manifest/outbox/stores/mongodb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb.d.ts","sourceRoot":"","sources":["../../../../src/manifest/outbox/stores/mongodb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1B,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,kBAAmB,YAAW,WAAW;IAEpD,OAAO,CAAC,MAAM,CAAO;IAErB,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,KAAK,CAAgB;gBAEjB,MAAM,EAAE,wBAAwB,EAAE,IAAI,GAAE,yBAA8B;YAQpE,IAAI;YAuBJ,WAAW;IAInB,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B5D,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA0BhD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlE;;;;;;;;;;OAUG;IAEG,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAQrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,CAAC,UAAU;CAWnB"}

package/dist/manifest/outbox/stores/mongodb.js

@@ -0,0 +1,151 @@
+/**
+ * MongoDBOutboxStore — MongoDB implementation of the OutboxStore contract.
+ *
+ * Uses MongoDB's `findOneAndUpdate` with atomic filter conditions to simulate
+ * the `SELECT … FOR UPDATE SKIP LOCKED` semantics used by the PostgreSQL
+ * adapter. Change streams on the outbox collection enable reactive dispatch.
+ *
+ * 'mongodb' is an optional peer dependency. It is loaded via dynamic import
+ * at construction time. If the package is not installed, a clear error is
+ * thrown.
+ *
+ * Transaction support: the `tx` parameter in `enqueue` accepts a MongoDB
+ * `ClientSession` for transactional outbox pattern — state mutation and
+ * event persistence share the same session/transaction boundary.
+ */
+export class MongoDBOutboxStore {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    client;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    collection;
+    collectionName;
+    databaseName;
+    generateId;
+    now;
+    ready;
+    constructor(config, opts = {}) {
+        this.collectionName = config.collectionName || '_manifest_outbox';
+        this.databaseName = config.databaseName || 'manifest';
+        this.generateId = opts.generateId ?? (() => crypto.randomUUID());
+        this.now = opts.now ?? (() => Date.now());
+        this.ready = this.init(config);
+    }
+    async init(config) {
+        let MongoClient;
+        try {
+            // 'mongodb' is an optional peer dependency, resolved at runtime via dynamic import; its absence is handled by the catch below.
+            const mod = await import('mongodb');
+            MongoClient = mod.MongoClient;
+        }
+        catch {
+            throw new Error(`MongoDBOutboxStore requires 'mongodb' to be installed.\n` +
+                `Run: npm install mongodb`);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.client = new MongoClient(config.connectionString);
+        await this.client.connect();
+        const db = this.client.db(this.databaseName);
+        this.collection = db.collection(this.collectionName);
+        // Ensure indexes for efficient claim queries
+        await this.collection.createIndex({ entryId: 1 }, { unique: true });
+        await this.collection.createIndex({ status: 1, claimed: 1 });
+    }
+    async ensureReady() {
+        await this.ready;
+    }
+    async enqueue(entries, tx) {
+        await this.ensureReady();
+        if (entries.length === 0)
+            return;
+        const docs = entries.map(entry => ({
+            entryId: entry.entryId ?? this.generateId(),
+            enqueuedAt: entry.enqueuedAt ?? this.now(),
+            event: entry.event,
+            status: entry.status ?? 'pending',
+            attempts: entry.attempts ?? 0,
+            claimed: false,
+            lastError: entry.lastError,
+        }));
+        // Use session for transactional outbox if provided
+        const options = { ordered: false };
+        if (tx) {
+            options.session = tx;
+        }
+        try {
+            await this.collection.insertMany(docs, options);
+        }
+        catch (err) {
+            // Ignore duplicate key errors (idempotent enqueue)
+            const mongoErr = err;
+            if (mongoErr.code !== 11000)
+                throw err;
+        }
+    }
+    async claim(batchSize) {
+        await this.ensureReady();
+        if (batchSize <= 0)
+            return [];
+        const claimedAt = this.now();
+        const out = [];
+        // Atomically claim entries one at a time using findOneAndUpdate.
+        // This is analogous to PostgreSQL's SELECT … FOR UPDATE SKIP LOCKED.
+        for (let i = 0; i < batchSize; i++) {
+            const result = await this.collection.findOneAndUpdate({ status: 'pending', claimed: false }, {
+                $set: { claimed: true, claimedAt },
+                $inc: { attempts: 1 },
+            }, { returnDocument: 'after' });
+            if (!result)
+                break;
+            out.push(this.docToEntry(result));
+        }
+        return out;
+    }
+    async markDelivered(entryIds) {
+        await this.ensureReady();
+        if (entryIds.length === 0)
+            return;
+        const deliveredAt = this.now();
+        await this.collection.updateMany({ entryId: { $in: entryIds } }, { $set: { status: 'delivered', claimed: false, deliveredAt } });
+    }
+    async markFailed(entryIds, error) {
+        await this.ensureReady();
+        if (entryIds.length === 0)
+            return;
+        const failedAt = this.now();
+        await this.collection.updateMany({ entryId: { $in: entryIds } }, { $set: { status: 'failed', claimed: false, lastError: error, failedAt } });
+    }
+    /**
+     * Start watching the outbox collection for new entries via MongoDB change
+     * streams. Returns a change stream that emits 'insert' events for reactive
+     * dispatch.
+     *
+     * This is NOT part of the OutboxStore contract — it's a MongoDB-specific
+     * utility for consumers that want push-based event dispatch instead of
+     * polling with `claim()`.
+     *
+     * Requires a MongoDB replica set or sharded cluster.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async watch() {
+        await this.ensureReady();
+        return this.collection.watch([{ $match: { operationType: 'insert' } }], { fullDocument: 'updateLookup' });
+    }
+    async close() {
+        if (this.client) {
+            await this.client.close();
+        }
+    }
+    docToEntry(doc) {
+        const entry = {
+            entryId: doc.entryId,
+            enqueuedAt: doc.enqueuedAt,
+            event: doc.event,
+            status: doc.status,
+            attempts: doc.attempts,
+        };
+        if (doc.lastError !== undefined)
+            entry.lastError = doc.lastError;
+        return entry;
+    }
+}
+//# sourceMappingURL=mongodb.js.map