@zdavison/matador 2.0.1

package/dist/checkpoint/stores/stores.test.js

@@ -0,0 +1,146 @@
+import { beforeEach, describe, expect, it } from 'bun:test';
+import { MemoryCheckpointStore } from './memory.js';
+import { NoOpCheckpointStore } from './noop.js';
+describe('MemoryCheckpointStore', () => {
+    let store;
+    beforeEach(() => {
+        store = new MemoryCheckpointStore();
+    });
+    describe('get()', () => {
+        it('should return undefined for non-existent checkpoint', async () => {
+            const result = await store.get('non-existent');
+            expect(result).toBeUndefined();
+        });
+        it('should return stored checkpoint', async () => {
+            const checkpoint = {
+                envelopeId: 'test-id',
+                subscriberName: 'test-subscriber',
+                completedSteps: { 'step-1': 'result-1' },
+            };
+            await store.set('test-id', checkpoint);
+            const result = await store.get('test-id');
+            expect(result).toEqual(checkpoint);
+        });
+    });
+    describe('set()', () => {
+        it('should store checkpoint', async () => {
+            const checkpoint = {
+                envelopeId: 'test-id',
+                subscriberName: 'test-subscriber',
+                completedSteps: {},
+            };
+            await store.set('test-id', checkpoint);
+            expect(store.size).toBe(1);
+        });
+        it('should overwrite existing checkpoint', async () => {
+            const checkpoint1 = {
+                envelopeId: 'test-id',
+                subscriberName: 'test-subscriber',
+                completedSteps: { 'step-1': 'old' },
+            };
+            const checkpoint2 = {
+                envelopeId: 'test-id',
+                subscriberName: 'test-subscriber',
+                completedSteps: { 'step-1': 'new', 'step-2': 'added' },
+            };
+            await store.set('test-id', checkpoint1);
+            await store.set('test-id', checkpoint2);
+            const result = await store.get('test-id');
+            expect(result).toEqual(checkpoint2);
+            expect(store.size).toBe(1);
+        });
+    });
+    describe('delete()', () => {
+        it('should delete checkpoint', async () => {
+            const checkpoint = {
+                envelopeId: 'test-id',
+                subscriberName: 'test-subscriber',
+                completedSteps: {},
+            };
+            await store.set('test-id', checkpoint);
+            expect(store.size).toBe(1);
+            await store.delete('test-id');
+            expect(store.size).toBe(0);
+        });
+        it('should not throw when deleting non-existent checkpoint', async () => {
+            await expect(store.delete('non-existent')).resolves.toBeUndefined();
+        });
+    });
+    describe('utility methods', () => {
+        it('size should return number of checkpoints', async () => {
+            expect(store.size).toBe(0);
+            await store.set('id-1', {
+                envelopeId: 'id-1',
+                subscriberName: 'sub',
+                completedSteps: {},
+            });
+            expect(store.size).toBe(1);
+            await store.set('id-2', {
+                envelopeId: 'id-2',
+                subscriberName: 'sub',
+                completedSteps: {},
+            });
+            expect(store.size).toBe(2);
+        });
+        it('clear() should remove all checkpoints', async () => {
+            await store.set('id-1', {
+                envelopeId: 'id-1',
+                subscriberName: 'sub',
+                completedSteps: {},
+            });
+            await store.set('id-2', {
+                envelopeId: 'id-2',
+                subscriberName: 'sub',
+                completedSteps: {},
+            });
+            expect(store.size).toBe(2);
+            store.clear();
+            expect(store.size).toBe(0);
+        });
+        it('keys() should return all checkpoint IDs', async () => {
+            await store.set('id-1', {
+                envelopeId: 'id-1',
+                subscriberName: 'sub',
+                completedSteps: {},
+            });
+            await store.set('id-2', {
+                envelopeId: 'id-2',
+                subscriberName: 'sub',
+                completedSteps: {},
+            });
+            const keys = store.keys();
+            expect(keys).toContain('id-1');
+            expect(keys).toContain('id-2');
+            expect(keys).toHaveLength(2);
+        });
+    });
+});
+describe('NoOpCheckpointStore', () => {
+    let store;
+    beforeEach(() => {
+        store = new NoOpCheckpointStore();
+    });
+    describe('get()', () => {
+        it('should always return undefined', async () => {
+            const result = await store.get('any-id');
+            expect(result).toBeUndefined();
+        });
+    });
+    describe('set()', () => {
+        it('should not store anything (no-op)', async () => {
+            const checkpoint = {
+                envelopeId: 'test-id',
+                subscriberName: 'test-subscriber',
+                completedSteps: { 'step-1': 'result-1' },
+            };
+            await store.set('test-id', checkpoint);
+            const result = await store.get('test-id');
+            expect(result).toBeUndefined();
+        });
+    });
+    describe('delete()', () => {
+        it('should not throw', async () => {
+            await expect(store.delete('any-id')).resolves.toBeUndefined();
+        });
+    });
+});

package/dist/checkpoint/types.d.ts

@@ -0,0 +1,119 @@
+import type { Envelope, SubscriberDefinition } from '../types/index.js';
+/**
+ * Type constraint ensuring values can be JSON serialized.
+ * Used to enforce type safety for io() return values.
+ */
+export type JsonSerializable = string | number | boolean | null | JsonSerializable[] | {
+    [key: string]: JsonSerializable;
+};
+/**
+ * Checkpoint data persisted between retries.
+ * Contains cached results from completed io() operations.
+ */
+export interface Checkpoint {
+    /** Unique envelope ID this checkpoint belongs to */
+    readonly envelopeId: string;
+    /** Subscriber name (for debugging/admin) */
+    readonly subscriberName: string;
+    /** Map of io() keys to their cached results */
+    readonly completedSteps: Record<string, JsonSerializable>;
+}
+/**
+ * Interface for checkpoint persistence.
+ * Implementations must handle concurrent access safely.
+ */
+export interface CheckpointStore {
+    /**
+     * Retrieve checkpoint for an envelope.
+     * @param envelopeId - Unique envelope identifier
+     * @returns Checkpoint if exists, undefined otherwise
+     */
+    get(envelopeId: string): Promise<Checkpoint | undefined>;
+    /**
+     * Save or update checkpoint.
+     * @param envelopeId - Unique envelope identifier
+     * @param checkpoint - Checkpoint data to persist
+     */
+    set(envelopeId: string, checkpoint: Checkpoint): Promise<void>;
+    /**
+     * Delete checkpoint (on success or dead-letter).
+     * @param envelopeId - Unique envelope identifier
+     */
+    delete(envelopeId: string): Promise<void>;
+    /**
+     * Optional: TTL-based cleanup for orphaned checkpoints.
+     * @param olderThan - Delete checkpoints older than this date
+     * @returns Number of checkpoints deleted
+     */
+    cleanup?(olderThan: Date): Promise<number>;
+}
+/**
+ * Context provided to resumable subscriber callbacks.
+ * Contains the io() function for checkpointed operations.
+ */
+export interface SubscriberContext {
+    /**
+     * Wraps a side-effectful operation for caching/replay.
+     * On first execution: runs the lambda and caches the result.
+     * On retry: returns cached result without re-executing.
+     *
+     * @param key - Unique identifier for this operation within this subscriber.
+     *              Must be stable across retries. Use descriptive names like
+     *              'fetch-user', 'send-email', 'charge-payment'.
+     * @param fn - The side-effectful operation to execute
+     * @returns The result of fn (or cached result on retry)
+     * @throws DuplicateIoKeyError if key was already used in this execution
+     */
+    io<T extends JsonSerializable>(key: string, fn: () => Promise<T> | T): Promise<T>;
+    /**
+     * Execute multiple io() operations in parallel.
+     * Each operation requires its own unique key.
+     *
+     * @param ops - Array of [key, fn] tuples to execute in parallel
+     * @returns Array of results in the same order as input
+     */
+    all<T extends readonly [
+        string,
+        () => Promise<JsonSerializable> | JsonSerializable
+    ][]>(ops: T): Promise<{
+        [K in keyof T]: T[K] extends [string, () => Promise<infer R> | infer R] ? R : never;
+    }>;
+    /** Current attempt number (1-based) */
+    readonly attempt: number;
+    /** Whether this is a retry (attempt > 1) */
+    readonly isRetry: boolean;
+}
+/**
+ * Context for checkpoint loaded hook.
+ */
+export interface CheckpointLoadedContext {
+    readonly envelope: Envelope;
+    readonly subscriber: SubscriberDefinition;
+    readonly checkpoint: Checkpoint;
+    readonly cachedSteps: number;
+}
+/**
+ * Context for checkpoint hit hook (cache used).
+ */
+export interface CheckpointHitContext {
+    readonly envelope: Envelope;
+    readonly subscriber: SubscriberDefinition;
+    readonly stepKey: string;
+}
+/**
+ * Context for checkpoint miss hook (operation executed).
+ */
+export interface CheckpointMissContext {
+    readonly envelope: Envelope;
+    readonly subscriber: SubscriberDefinition;
+    readonly stepKey: string;
+}
+/**
+ * Context for checkpoint cleared hook.
+ */
+export interface CheckpointClearedContext {
+    readonly envelope: Envelope;
+    readonly subscriber: SubscriberDefinition;
+    readonly reason: 'success' | 'dead-letter';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/checkpoint/types.d.ts.map

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

package/dist/checkpoint/types.js

@@ -0,0 +1 @@
+export {};

package/dist/codec/codec.d.ts

@@ -0,0 +1,29 @@
+import type { HasDescription } from '../errors/index.js';
+import type { Envelope } from '../types/index.js';
+/**
+ * Codec interface for serializing/deserializing envelopes.
+ */
+export interface Codec {
+    /**
+     * Encodes an envelope to a buffer for transport.
+     */
+    encode(envelope: Envelope): Uint8Array;
+    /**
+     * Decodes a buffer back to an envelope.
+     * @throws Error if the buffer is invalid or cannot be decoded
+     */
+    decode(buffer: Uint8Array): Envelope;
+    /**
+     * MIME content type for this codec.
+     */
+    readonly contentType: string;
+}
+/**
+ * Error thrown when decoding fails.
+ */
+export declare class CodecDecodeError extends Error implements HasDescription {
+    readonly cause?: unknown | undefined;
+    readonly description: string;
+    constructor(message: string, cause?: unknown | undefined);
+}
+//# sourceMappingURL=codec.d.ts.map

package/dist/codec/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/codec/codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC;IAEvC;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAM,YAAW,cAAc;aASjD,KAAK,CAAC,EAAE,OAAO;IARjC,QAAQ,CAAC,WAAW,SAIqD;gBAGvE,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC"}

package/dist/codec/codec.js

@@ -0,0 +1,15 @@
+/**
+ * Error thrown when decoding fails.
+ */
+export class CodecDecodeError extends Error {
+    cause;
+    description = 'Failed to decode a message from the transport. This typically indicates ' +
+        'corrupted data, incompatible codec versions, or messages from a different ' +
+        'system. Check the cause property for the underlying parsing error. ' +
+        'The message will be sent to the dead-letter queue for investigation.';
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'CodecDecodeError';
+    }
+}

package/dist/codec/header-aware-codec.d.ts

@@ -0,0 +1,36 @@
+import type { Envelope } from '../types/index.js';
+/**
+ * Result of encoding an envelope with header support.
+ */
+export interface EncodedMessage {
+    /** Serialized message body */
+    readonly body: Uint8Array;
+    /** Headers to attach to the message */
+    readonly headers: Record<string, unknown>;
+    /** MIME content type */
+    readonly contentType: string;
+}
+/**
+ * Codec interface for transports that support message headers (e.g., RabbitMQ).
+ *
+ * Unlike the basic Codec interface, this allows metadata to be stored in
+ * headers rather than duplicated in the body, which is more efficient and
+ * enables transport-level filtering/routing.
+ */
+export interface HeaderAwareCodec {
+    /**
+     * Encodes an envelope into a body buffer and headers.
+     * The body should contain only the essential payload data.
+     * Routing and observability metadata should go in headers.
+     */
+    encode(envelope: Envelope): EncodedMessage;
+    /**
+     * Decodes a body buffer and headers back into an envelope.
+     */
+    decode(body: Uint8Array, headers: Record<string, unknown>): Envelope;
+    /**
+     * MIME content type for the body.
+     */
+    readonly contentType: string;
+}
+//# sourceMappingURL=header-aware-codec.d.ts.map

package/dist/codec/header-aware-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-aware-codec.d.ts","sourceRoot":"","sources":["../../src/codec/header-aware-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE1C,wBAAwB;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC;IAE3C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC;IAErE;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}

package/dist/codec/header-aware-codec.js

@@ -0,0 +1 @@
+export {};

package/dist/codec/index.d.ts

@@ -0,0 +1,6 @@
+export type { Codec } from './codec.js';
+export { CodecDecodeError } from './codec.js';
+export { JsonCodec } from './json-codec.js';
+export type { EncodedMessage, HeaderAwareCodec, } from './header-aware-codec.js';
+export { RabbitMQCodec } from './rabbitmq-codec.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/codec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codec/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,YAAY,EACV,cAAc,EACd,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/codec/index.js

@@ -0,0 +1,3 @@
+export { CodecDecodeError } from './codec.js';
+export { JsonCodec } from './json-codec.js';
+export { RabbitMQCodec } from './rabbitmq-codec.js';

package/dist/codec/json-codec.d.ts

@@ -0,0 +1,13 @@
+import type { Envelope } from '../types/index.js';
+import type { Codec } from './codec.js';
+/**
+ * JSON codec for envelope serialization.
+ * Uses standard JSON.stringify/parse with Date handling.
+ */
+export declare class JsonCodec implements Codec {
+    readonly contentType = "application/json";
+    encode(envelope: Envelope): Uint8Array;
+    decode(buffer: Uint8Array): Envelope;
+    private isValidEnvelope;
+}
+//# sourceMappingURL=json-codec.d.ts.map

package/dist/codec/json-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-codec.d.ts","sourceRoot":"","sources":["../../src/codec/json-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC;;;GAGG;AACH,qBAAa,SAAU,YAAW,KAAK;IACrC,QAAQ,CAAC,WAAW,sBAAsB;IAE1C,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU;IAKtC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ;IA0BpC,OAAO,CAAC,eAAe;CA0BxB"}

package/dist/codec/json-codec.js

@@ -0,0 +1,64 @@
+import { CodecDecodeError } from './codec.js';
+/**
+ * JSON codec for envelope serialization.
+ * Uses standard JSON.stringify/parse with Date handling.
+ */
+export class JsonCodec {
+    contentType = 'application/json';
+    encode(envelope) {
+        const json = JSON.stringify(envelope);
+        return new TextEncoder().encode(json);
+    }
+    decode(buffer) {
+        if (buffer.length === 0) {
+            throw new CodecDecodeError('Cannot decode empty buffer');
+        }
+        let json;
+        try {
+            json = new TextDecoder('utf-8').decode(buffer);
+        }
+        catch (error) {
+            throw new CodecDecodeError('Invalid UTF-8 encoding', error);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(json);
+        }
+        catch (error) {
+            throw new CodecDecodeError('Invalid JSON', error);
+        }
+        if (!this.isValidEnvelope(parsed)) {
+            throw new CodecDecodeError('Invalid envelope structure');
+        }
+        return parsed;
+    }
+    isValidEnvelope(value) {
+        if (typeof value !== 'object' || value === null) {
+            return false;
+        }
+        const envelope = value;
+        // Required top-level fields
+        if (typeof envelope['id'] !== 'string')
+            return false;
+        if (!('data' in envelope))
+            return false;
+        if (typeof envelope['docket'] !== 'object' || envelope['docket'] === null)
+            return false;
+        // Validate docket (routing, processing state, observability)
+        const docket = envelope['docket'];
+        // Routing
+        if (typeof docket['eventKey'] !== 'string')
+            return false;
+        if (typeof docket['targetSubscriber'] !== 'string')
+            return false;
+        // Processing state
+        if (typeof docket['attempts'] !== 'number')
+            return false;
+        if (typeof docket['createdAt'] !== 'string')
+            return false;
+        // Observability
+        if (typeof docket['importance'] !== 'string')
+            return false;
+        return true;
+    }
+}

package/dist/codec/rabbitmq-codec.d.ts

@@ -0,0 +1,28 @@
+import type { Envelope } from '../types/index.js';
+import type { EncodedMessage, HeaderAwareCodec } from './header-aware-codec.js';
+/**
+ * RabbitMQ-specific codec that stores routing/metadata in headers.
+ *
+ * Benefits:
+ * - No duplication between body and headers
+ * - RabbitMQ can route/filter based on headers
+ * - Smaller message body
+ * - v1 message format compatibility built-in
+ */
+export declare class RabbitMQCodec implements HeaderAwareCodec {
+    readonly contentType = "application/json";
+    encode(envelope: Envelope): EncodedMessage;
+    decode(body: Uint8Array, headers: Record<string, unknown>): Envelope;
+    private isV1Body;
+    private isV2Body;
+    private decodeV2;
+    /**
+     * Decodes a v1 format message for backwards compatibility.
+     * v1 format: { key, data, metadata, universal, targetSubscriber, ... }
+     */
+    private decodeV1;
+    private requireStringHeader;
+    private requireNumberHeader;
+    private optionalStringHeader;
+}
+//# sourceMappingURL=rabbitmq-codec.d.ts.map

package/dist/codec/rabbitmq-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rabbitmq-codec.d.ts","sourceRoot":"","sources":["../../src/codec/rabbitmq-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAwDhF;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IACpD,QAAQ,CAAC,WAAW,sBAAsB;IAE1C,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc;IAgD1C,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ;IAgCpE,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,QAAQ;IAmDhB;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAsEhB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,oBAAoB;CAS7B"}