@angriff36/manifest 2.18.0

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

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

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

@@ -0,0 +1,81 @@
+/**
+ * PostgresOutboxStore — durable OutboxStore adapter backed by PostgreSQL.
+ *
+ * Companion schema: src/manifest/outbox/stores/postgres.sql.
+ *
+ * Concurrency model: `claim` uses `FOR UPDATE SKIP LOCKED` so concurrent
+ * dispatcher workers receive disjoint batches without lock contention.
+ * See https://www.postgresql.org/docs/current/sql-select.html § "The
+ * Locking Clause" for the official semantics.
+ *
+ * Transactional enqueue: when callers pass a PoolClient via `tx`, the
+ * INSERT runs inside that transaction so state mutation and outbox
+ * persistence commit atomically. This is the load-bearing piece of the
+ * "transactional outbox" pattern. Without a `tx`, enqueue runs on its
+ * own pool connection — durable but NOT atomic w.r.t. mutation.
+ *
+ * Idempotency: ON CONFLICT (entry_id) DO NOTHING — a retried enqueue with
+ * the same entryId is silently ignored.
+ *
+ * DO NOT import this file in browser code — it requires `pg`.
+ */
+import type { Pool } from 'pg';
+import type { OutboxEntry, OutboxStore } from '../outbox-store';
+export interface PostgresOutboxStoreOptions {
+    /** A pg Pool. The store does NOT own the pool's lifecycle. */
+    pool: Pool;
+    /** Table name override. Default: `manifest_outbox_entries`. */
+    tableName?: string;
+    /**
+     * When true, project `event.subject.entity` and `event.subject.id` into
+     * the `subject_entity` and `subject_id` columns at enqueue time. Requires
+     * the optional columns from the companion schema (postgres.sql). Default: false.
+     */
+    projectSubject?: boolean;
+}
+export declare class PostgresOutboxStore implements OutboxStore {
+    private pool;
+    private tableName;
+    private projectSubject;
+    constructor(opts: PostgresOutboxStoreOptions);
+    /**
+     * Enqueue entries. If `tx` is a PoolClient bound to an open transaction,
+     * the INSERT participates in that transaction (the transactional outbox
+     * guarantee). Otherwise, the INSERT runs on a fresh pool connection.
+     */
+    enqueue(entries: OutboxEntry[], tx?: unknown): Promise<void>;
+    /**
+     * Claim up to `batchSize` pending entries for delivery.
+     *
+     * Atomicity guarantee: a single UPDATE … WHERE entry_id IN (SELECT … FOR
+     * UPDATE SKIP LOCKED) runs in one implicit transaction. The inner SELECT
+     * holds row locks on the matching rows until the outer UPDATE commits, so
+     * two concurrent workers calling `claim` cannot lock the same row.
+     *
+     * Re-claim safety: after commit, the row's `claimed_at` is non-NULL, and
+     * the WHERE clause filters `claimed_at IS NULL` — so even though `status`
+     * is still 'pending', a follow-up `claim` call will not return the same
+     * row. The dispatcher worker MUST eventually call `markDelivered` or
+     * `markFailed` to flip status off 'pending'. See § "Crash Recovery" in
+     * docs/spec/adapters.md for the documented stale-claim recovery path
+     * (a worker that crashes after claiming but before marking leaves the
+     * row stuck until an operator resets `claimed_at`).
+     *
+     * Increments `attempts` and stamps `claimed_at = NOW()` on every claim.
+     */
+    claim(batchSize: number): Promise<OutboxEntry[]>;
+    /**
+     * Reset `claimed_at` to NULL for the given entry ids without changing
+     * `status`. Use after a dispatcher worker crash to re-enqueue stale
+     * claims for re-delivery. Not part of the OutboxStore contract — exposed
+     * here so operators have a documented recovery path. Callers MUST be
+     * confident the worker is dead; releasing a claim held by a live worker
+     * can produce duplicate delivery attempts.
+     */
+    releaseStaleClaims(entryIds: string[]): Promise<void>;
+    /** Mark entries delivered. Idempotent — repeated calls have no effect. */
+    markDelivered(entryIds: string[]): Promise<void>;
+    /** Mark entries failed and record the last error message. */
+    markFailed(entryIds: string[], error: string): Promise<void>;
+}
+//# sourceMappingURL=postgres.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../../src/manifest/outbox/stores/postgres.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAqB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnF,MAAM,WAAW,0BAA0B;IACzC,8DAA8D;IAC9D,IAAI,EAAE,IAAI,CAAC;IACX,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA+BD,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAU;gBAEpB,IAAI,EAAE,0BAA0B;IAM5C;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA6ClE;;;;;;;;;;;;;;;;;;OAkBG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA2BtD;;;;;;;OAOG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D,0EAA0E;IACpE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtD,6DAA6D;IACvD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CASnE"}

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

@@ -0,0 +1,182 @@
+/**
+ * PostgresOutboxStore — durable OutboxStore adapter backed by PostgreSQL.
+ *
+ * Companion schema: src/manifest/outbox/stores/postgres.sql.
+ *
+ * Concurrency model: `claim` uses `FOR UPDATE SKIP LOCKED` so concurrent
+ * dispatcher workers receive disjoint batches without lock contention.
+ * See https://www.postgresql.org/docs/current/sql-select.html § "The
+ * Locking Clause" for the official semantics.
+ *
+ * Transactional enqueue: when callers pass a PoolClient via `tx`, the
+ * INSERT runs inside that transaction so state mutation and outbox
+ * persistence commit atomically. This is the load-bearing piece of the
+ * "transactional outbox" pattern. Without a `tx`, enqueue runs on its
+ * own pool connection — durable but NOT atomic w.r.t. mutation.
+ *
+ * Idempotency: ON CONFLICT (entry_id) DO NOTHING — a retried enqueue with
+ * the same entryId is silently ignored.
+ *
+ * DO NOT import this file in browser code — it requires `pg`.
+ */
+const DEFAULT_TABLE = 'manifest_outbox_entries';
+function quoteIdent(identifier) {
+    return `"${identifier.replace(/"/g, '""')}"`;
+}
+function rowToEntry(row) {
+    const entry = {
+        entryId: row.entry_id,
+        enqueuedAt: typeof row.enqueued_at === 'string' ? Number(row.enqueued_at) : row.enqueued_at,
+        event: row.event,
+        status: row.status,
+        attempts: row.attempts,
+    };
+    if (row.last_error !== null && row.last_error !== undefined) {
+        entry.lastError = row.last_error;
+    }
+    return entry;
+}
+export class PostgresOutboxStore {
+    pool;
+    tableName;
+    projectSubject;
+    constructor(opts) {
+        this.pool = opts.pool;
+        this.tableName = opts.tableName ?? DEFAULT_TABLE;
+        this.projectSubject = opts.projectSubject ?? false;
+    }
+    /**
+     * Enqueue entries. If `tx` is a PoolClient bound to an open transaction,
+     * the INSERT participates in that transaction (the transactional outbox
+     * guarantee). Otherwise, the INSERT runs on a fresh pool connection.
+     */
+    async enqueue(entries, tx) {
+        if (entries.length === 0)
+            return;
+        const runner = (tx ?? this.pool);
+        if (this.projectSubject) {
+            const sql = `
+        INSERT INTO ${quoteIdent(this.tableName)} (
+          entry_id, enqueued_at, event, status, attempts, last_error,
+          subject_entity, subject_id
+        ) VALUES ($1, $2, $3::jsonb, $4, $5, $6, $7, $8)
+        ON CONFLICT (entry_id) DO NOTHING
+      `;
+            for (const entry of entries) {
+                await runner.query(sql, [
+                    entry.entryId,
+                    entry.enqueuedAt,
+                    JSON.stringify(entry.event),
+                    entry.status,
+                    entry.attempts,
+                    entry.lastError ?? null,
+                    entry.event.subject?.entity ?? null,
+                    entry.event.subject?.id ?? null,
+                ]);
+            }
+        }
+        else {
+            const sql = `
+        INSERT INTO ${quoteIdent(this.tableName)} (
+          entry_id, enqueued_at, event, status, attempts, last_error
+        ) VALUES ($1, $2, $3::jsonb, $4, $5, $6)
+        ON CONFLICT (entry_id) DO NOTHING
+      `;
+            for (const entry of entries) {
+                await runner.query(sql, [
+                    entry.entryId,
+                    entry.enqueuedAt,
+                    JSON.stringify(entry.event),
+                    entry.status,
+                    entry.attempts,
+                    entry.lastError ?? null,
+                ]);
+            }
+        }
+    }
+    /**
+     * Claim up to `batchSize` pending entries for delivery.
+     *
+     * Atomicity guarantee: a single UPDATE … WHERE entry_id IN (SELECT … FOR
+     * UPDATE SKIP LOCKED) runs in one implicit transaction. The inner SELECT
+     * holds row locks on the matching rows until the outer UPDATE commits, so
+     * two concurrent workers calling `claim` cannot lock the same row.
+     *
+     * Re-claim safety: after commit, the row's `claimed_at` is non-NULL, and
+     * the WHERE clause filters `claimed_at IS NULL` — so even though `status`
+     * is still 'pending', a follow-up `claim` call will not return the same
+     * row. The dispatcher worker MUST eventually call `markDelivered` or
+     * `markFailed` to flip status off 'pending'. See § "Crash Recovery" in
+     * docs/spec/adapters.md for the documented stale-claim recovery path
+     * (a worker that crashes after claiming but before marking leaves the
+     * row stuck until an operator resets `claimed_at`).
+     *
+     * Increments `attempts` and stamps `claimed_at = NOW()` on every claim.
+     */
+    async claim(batchSize) {
+        if (batchSize <= 0)
+            return [];
+        const sql = `
+      UPDATE ${quoteIdent(this.tableName)} AS o
+      SET attempts = o.attempts + 1,
+          claimed_at = NOW()
+      WHERE o.entry_id IN (
+        SELECT entry_id FROM ${quoteIdent(this.tableName)}
+        WHERE status = 'pending' AND claimed_at IS NULL
+        ORDER BY enqueued_at, entry_id
+        LIMIT $1
+        FOR UPDATE SKIP LOCKED
+      )
+      RETURNING entry_id, enqueued_at, event, status, attempts, last_error
+    `;
+        const result = await this.pool.query(sql, [batchSize]);
+        // RETURNING row order is not guaranteed to match the claim subquery ORDER BY.
+        result.rows.sort((a, b) => {
+            const ta = typeof a.enqueued_at === 'string' ? Number(a.enqueued_at) : a.enqueued_at;
+            const tb = typeof b.enqueued_at === 'string' ? Number(b.enqueued_at) : b.enqueued_at;
+            return ta - tb || String(a.entry_id).localeCompare(String(b.entry_id));
+        });
+        return result.rows.map(rowToEntry);
+    }
+    /**
+     * Reset `claimed_at` to NULL for the given entry ids without changing
+     * `status`. Use after a dispatcher worker crash to re-enqueue stale
+     * claims for re-delivery. Not part of the OutboxStore contract — exposed
+     * here so operators have a documented recovery path. Callers MUST be
+     * confident the worker is dead; releasing a claim held by a live worker
+     * can produce duplicate delivery attempts.
+     */
+    async releaseStaleClaims(entryIds) {
+        if (entryIds.length === 0)
+            return;
+        const sql = `
+      UPDATE ${quoteIdent(this.tableName)}
+      SET claimed_at = NULL
+      WHERE entry_id = ANY($1::text[]) AND status = 'pending'
+    `;
+        await this.pool.query(sql, [entryIds]);
+    }
+    /** Mark entries delivered. Idempotent — repeated calls have no effect. */
+    async markDelivered(entryIds) {
+        if (entryIds.length === 0)
+            return;
+        const sql = `
+      UPDATE ${quoteIdent(this.tableName)}
+      SET status = 'delivered', delivered_at = NOW()
+      WHERE entry_id = ANY($1::text[])
+    `;
+        await this.pool.query(sql, [entryIds]);
+    }
+    /** Mark entries failed and record the last error message. */
+    async markFailed(entryIds, error) {
+        if (entryIds.length === 0)
+            return;
+        const sql = `
+      UPDATE ${quoteIdent(this.tableName)}
+      SET status = 'failed', last_error = $2, failed_at = NOW()
+      WHERE entry_id = ANY($1::text[])
+    `;
+        await this.pool.query(sql, [entryIds, error]);
+    }
+}
+//# sourceMappingURL=postgres.js.map

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

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

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

@@ -0,0 +1,95 @@
+/**
+ * RedisOutboxStore — Redis Streams implementation of the OutboxStore contract.
+ *
+ * Uses Redis Streams (XADD, XREADGROUP, XACK) for durable event queuing with
+ * consumer group support. Streams provide built-in persistence, delivery tracking,
+ * and consumer group semantics similar to Kafka.
+ *
+ * 'ioredis' 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 Redis
+ * pipeline for transactional outbox pattern — state mutation and event
+ * persistence can be batched together.
+ *
+ * Stream naming: Entries are stored in a stream keyed by the entity name
+ * prefixed with the configured key prefix (default: 'manifest:outbox:').
+ *
+ * Consumer groups: Creates a consumer group named 'manifest-dispatcher' on
+ * first use. Multiple dispatcher workers can join this group for parallel
+ * delivery with automatic load balancing.
+ */
+import type { OutboxEntry, OutboxStore } from '../outbox-store';
+export interface RedisOutboxStoreConfig {
+    /** Redis connection URL (redis://user:pass@host:port/db or rediss:// for TLS) */
+    url?: string;
+    /** Redis host (alternative to url) */
+    host?: string;
+    /** Redis port (alternative to url) */
+    port?: number;
+    /** Redis database number (0-15) */
+    db?: number;
+    /** Redis password */
+    password?: string;
+    /** Stream key prefix (default: 'manifest:outbox:') */
+    keyPrefix?: string;
+    /** Consumer group name (default: 'manifest-dispatcher') */
+    consumerGroup?: string;
+    /** Consumer name for this instance (default: 'dispatcher-{random}') */
+    consumerName?: string;
+    /** Connection timeout in milliseconds (default: 10000) */
+    connectTimeout?: number;
+}
+export interface RedisOutboxStoreOptions {
+    /** 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 RedisOutboxStore implements OutboxStore {
+    private client;
+    private keyPrefix;
+    private consumerGroup;
+    private consumerName;
+    private generateId;
+    private now;
+    private ready;
+    private streamKey;
+    constructor(config?: RedisOutboxStoreConfig, opts?: RedisOutboxStoreOptions);
+    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>;
+    /**
+     * Release stale claims for entries that were claimed but never marked
+     * delivered/failed (e.g., dispatcher crash). This allows other consumers
+     * to re-claim them.
+     */
+    releaseStaleClaims(entryIds: string[]): Promise<void>;
+    /**
+     * Get the current length of the outbox stream.
+     * Useful for monitoring and backlog tracking.
+     */
+    getLength(): Promise<number>;
+    /**
+     * Get pending entries info for the consumer group.
+     * Returns the number of entries pending delivery per consumer.
+     */
+    getPendingInfo(): Promise<Record<string, number>>;
+    /**
+     * Trim the stream to keep only the last N entries.
+     * Use for storage management — old delivered entries can be trimmed.
+     */
+    trim(maxLength: number): Promise<number>;
+    close(): Promise<void>;
+    private streamFieldsToEntry;
+    /**
+     * Get the underlying Redis client for advanced operations.
+     * Use with caution — direct manipulation bypasses the OutboxStore abstraction.
+     */
+    getRawClient(): any;
+}
+//# sourceMappingURL=redis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../../src/manifest/outbox/stores/redis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,sBAAsB;IACrC,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1B,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAiB,YAAW,WAAW;IAElD,OAAO,CAAC,MAAM,CAAO;IACrB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,GAAE,sBAA2B,EAAE,IAAI,GAAE,uBAA4B;YAUrE,IAAI;YAoDJ,WAAW;IAInB,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC5D,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAwDhD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBhD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlE;;;;OAIG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAKlC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAgBvD;;;OAGG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,OAAO,CAAC,mBAAmB;IAmB3B;;;OAGG;IAEH,YAAY,IAAI,GAAG;CAGpB"}

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

@@ -0,0 +1,248 @@
+/**
+ * RedisOutboxStore — Redis Streams implementation of the OutboxStore contract.
+ *
+ * Uses Redis Streams (XADD, XREADGROUP, XACK) for durable event queuing with
+ * consumer group support. Streams provide built-in persistence, delivery tracking,
+ * and consumer group semantics similar to Kafka.
+ *
+ * 'ioredis' 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 Redis
+ * pipeline for transactional outbox pattern — state mutation and event
+ * persistence can be batched together.
+ *
+ * Stream naming: Entries are stored in a stream keyed by the entity name
+ * prefixed with the configured key prefix (default: 'manifest:outbox:').
+ *
+ * Consumer groups: Creates a consumer group named 'manifest-dispatcher' on
+ * first use. Multiple dispatcher workers can join this group for parallel
+ * delivery with automatic load balancing.
+ */
+export class RedisOutboxStore {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    client;
+    keyPrefix;
+    consumerGroup;
+    consumerName;
+    generateId;
+    now;
+    ready;
+    streamKey;
+    constructor(config = {}, opts = {}) {
+        this.keyPrefix = config.keyPrefix ?? 'manifest:outbox:';
+        this.consumerGroup = config.consumerGroup ?? 'manifest-dispatcher';
+        this.consumerName = config.consumerName ?? `dispatcher-${Math.random().toString(36).slice(2)}`;
+        this.generateId = opts.generateId ?? (() => crypto.randomUUID());
+        this.now = opts.now ?? (() => Date.now());
+        this.streamKey = `${this.keyPrefix}entries`;
+        this.ready = this.init(config);
+    }
+    async init(config) {
+        let Redis;
+        try {
+            // 'ioredis' is an optional peer dependency, resolved at runtime via dynamic import; its absence is handled by the catch below.
+            const mod = await import('ioredis');
+            Redis = mod.Redis;
+        }
+        catch {
+            throw new Error(`RedisOutboxStore requires 'ioredis' to be installed.\n` +
+                `Run: npm install ioredis`);
+        }
+        const options = {
+            connectTimeout: config.connectTimeout ?? 10000,
+            db: config.db ?? 0,
+        };
+        if (config.password) {
+            options.password = config.password;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.client = new Redis(config.url ?? {
+            host: config.host ?? 'localhost',
+            port: config.port ?? 6379,
+            ...options,
+        });
+        // Wait for connection
+        await new Promise((resolve, reject) => {
+            this.client.once('ready', resolve);
+            this.client.once('error', reject);
+        });
+        // Create consumer group if it doesn't exist
+        try {
+            await this.client.xgroup_create(this.streamKey, this.consumerGroup, '0', { MKSTREAM: true });
+        }
+        catch (err) {
+            // Ignore BUSYGROUP error — group already exists
+            const redisErr = err;
+            if (redisErr.message && !redisErr.message.includes('BUSYGROUP')) {
+                throw err;
+            }
+        }
+    }
+    async ensureReady() {
+        await this.ready;
+    }
+    async enqueue(entries, tx) {
+        await this.ensureReady();
+        if (entries.length === 0)
+            return;
+        const pipeline = tx ?? this.client;
+        for (const entry of entries) {
+            const entryId = entry.entryId ?? this.generateId();
+            const enqueuedAt = entry.enqueuedAt ?? this.now();
+            const status = entry.status ?? 'pending';
+            const attempts = entry.attempts ?? 0;
+            // Add entry to stream as a field-value map
+            const fields = {
+                entryId,
+                enqueuedAt: enqueuedAt.toString(),
+                event: JSON.stringify(entry.event),
+                status,
+                attempts: attempts.toString(),
+            };
+            if (entry.lastError) {
+                fields.lastError = entry.lastError;
+            }
+            // XADD returns the new entry ID (stream-specific, not our entryId)
+            await pipeline.xadd(this.streamKey, '*', fields);
+        }
+        // If we're using a pipeline (not a transaction), flush it
+        if (!tx && pipeline !== this.client && typeof pipeline.exec === 'function') {
+            await pipeline.exec();
+        }
+    }
+    async claim(batchSize) {
+        await this.ensureReady();
+        if (batchSize <= 0)
+            return [];
+        const now = this.now();
+        const out = [];
+        // Use XREADGROUP to claim entries for this consumer
+        // BLOCK 0 for non-blocking read, COUNT for batch size
+        const results = await this.client.xreadgroup('GROUP', this.consumerGroup, this.consumerName, 'COUNT', batchSize, 'BLOCK', 0, 'STREAMS', this.streamKey, '>' // '>' means new entries not yet delivered to other consumers
+        );
+        if (!results || results.length === 0)
+            return [];
+        // Parse results: XREADGROUP returns [[streamName, [[entryId, fields...]]]]
+        for (const result of results) {
+            for (const [streamId, entries] of result) {
+                if (streamId === this.streamKey) {
+                    for (const [id, fields] of entries) {
+                        out.push(this.streamFieldsToEntry(id, fields));
+                    }
+                }
+            }
+        }
+        // Update claimed status atomically
+        for (const entry of out) {
+            // Store the stream entry ID for ACK
+            entry._streamId = entry.entryId;
+            // In our implementation, we update the attempts field on claim
+            // The stream is immutable, so we use a separate hash for mutable state
+            await this.client.hset(`${this.keyPrefix}state:${entry.entryId}`, 'claimedAt', now.toString(), 'attempts', (entry.attempts + 1).toString());
+        }
+        return out;
+    }
+    async markDelivered(entryIds) {
+        await this.ensureReady();
+        if (entryIds.length === 0)
+            return;
+        // Get stream IDs from state hash
+        const streamIds = [];
+        for (const entryId of entryIds) {
+            const state = await this.client.hgetall(`${this.keyPrefix}state:${entryId}`);
+            if (state._streamId) {
+                streamIds.push(state._streamId);
+            }
+            // Clean up state hash
+            await this.client.del(`${this.keyPrefix}state:${entryId}`);
+        }
+        // ACK entries in the stream
+        if (streamIds.length > 0) {
+            await this.client.xack(this.streamKey, this.consumerGroup, ...streamIds);
+        }
+    }
+    async markFailed(entryIds, error) {
+        await this.ensureReady();
+        if (entryIds.length === 0)
+            return;
+        // Update state hash with error info
+        for (const entryId of entryIds) {
+            await this.client.hset(`${this.keyPrefix}state:${entryId}`, 'status', 'failed', 'lastError', error);
+        }
+    }
+    /**
+     * Release stale claims for entries that were claimed but never marked
+     * delivered/failed (e.g., dispatcher crash). This allows other consumers
+     * to re-claim them.
+     */
+    async releaseStaleClaims(entryIds) {
+        await this.ensureReady();
+        if (entryIds.length === 0)
+            return;
+        for (const entryId of entryIds) {
+            await this.client.hdel(`${this.keyPrefix}state:${entryId}`, 'claimedAt');
+        }
+    }
+    /**
+     * Get the current length of the outbox stream.
+     * Useful for monitoring and backlog tracking.
+     */
+    async getLength() {
+        await this.ensureReady();
+        return await this.client.xlen(this.streamKey);
+    }
+    /**
+     * Get pending entries info for the consumer group.
+     * Returns the number of entries pending delivery per consumer.
+     */
+    async getPendingInfo() {
+        await this.ensureReady();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const info = await this.client.xinfo('CONSUMERS', this.streamKey, this.consumerGroup);
+        const result = {};
+        for (const consumer of info) {
+            const name = consumer.name;
+            const pending = consumer.pending;
+            result[name] = pending;
+        }
+        return result;
+    }
+    /**
+     * Trim the stream to keep only the last N entries.
+     * Use for storage management — old delivered entries can be trimmed.
+     */
+    async trim(maxLength) {
+        await this.ensureReady();
+        return await this.client.xtrim(this.streamKey, 'MAXLEN', '~', maxLength);
+    }
+    async close() {
+        await this.ready;
+        await this.client.quit();
+    }
+    streamFieldsToEntry(streamId, fields) {
+        const entry = {
+            entryId: fields.entryId,
+            enqueuedAt: Number(fields.enqueuedAt),
+            event: JSON.parse(fields.event),
+            status: fields.status,
+            attempts: Number(fields.attempts),
+        };
+        if (fields.lastError) {
+            entry.lastError = fields.lastError;
+        }
+        // Store stream ID for later ACK
+        entry._streamId = streamId;
+        return entry;
+    }
+    /**
+     * Get the underlying Redis client for advanced operations.
+     * Use with caution — direct manipulation bypasses the OutboxStore abstraction.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getRawClient() {
+        return this.client;
+    }
+}
+//# sourceMappingURL=redis.js.map

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

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