@zdavison/matador 2.0.9 → 2.0.10

package/dist/checkpoint/context.d.ts

@@ -0,0 +1,59 @@
+import type { Envelope, SubscriberDefinition } from '../types/index.js';
+import type { Checkpoint, CheckpointHitContext, CheckpointMissContext, CheckpointStore, JsonSerializable, SubscriberContext } from './types.js';
+/**
+ * Hooks for observability during context operations.
+ */
+export interface ResumableContextHooks {
+    onCheckpointHit?(context: CheckpointHitContext): void | Promise<void>;
+    onCheckpointMiss?(context: CheckpointMissContext): void | Promise<void>;
+}
+/**
+ * Configuration for creating a ResumableContext.
+ */
+export interface ResumableContextConfig {
+    readonly store: CheckpointStore;
+    readonly envelope: Envelope;
+    readonly subscriber: SubscriberDefinition;
+    readonly existingCheckpoint?: Checkpoint | undefined;
+    readonly hooks?: ResumableContextHooks | undefined;
+}
+/**
+ * Implementation of SubscriberContext that provides io() caching.
+ *
+ * On first execution, io() calls execute their lambdas and cache results.
+ * On retry (when existingCheckpoint is provided), cached results are returned
+ * without re-executing the lambda.
+ */
+export declare class ResumableContext implements SubscriberContext {
+    private checkpoint;
+    private readonly usedKeys;
+    private readonly store;
+    private readonly envelope;
+    private readonly subscriber;
+    private readonly hooks;
+    constructor(config: ResumableContextConfig);
+    get attempt(): number;
+    get isRetry(): boolean;
+    io<T extends JsonSerializable>(key: string, fn: () => Promise<T> | T): Promise<T>;
+    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;
+    }>;
+    /**
+     * Clears the checkpoint from storage.
+     * Called after successful completion or dead-letter.
+     */
+    clear(): Promise<void>;
+    /**
+     * Gets the current checkpoint state.
+     * Useful for debugging and testing.
+     */
+    getCheckpoint(): Checkpoint;
+    /**
+     * Gets the number of cached steps.
+     */
+    get cachedStepCount(): number;
+}
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/checkpoint/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,gBAAgB,CAAC,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CACpD;AAED;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;gBAE9C,MAAM,EAAE,sBAAsB;IAa1C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAEK,EAAE,CAAC,CAAC,SAAS,gBAAgB,EACjC,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC;IA0CP,GAAG,CACP,CAAC,SAAS,SAAS;QACjB,MAAM;QACN,MAAM,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB;KACnD,EAAE,EAEH,GAAG,EAAE,CAAC,GACL,OAAO,CAAC;SACR,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GACnE,CAAC,GACD,KAAK;KACV,CAAC;IAoEF;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACH,aAAa,IAAI,UAAU;IAI3B;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;CACF"}

package/dist/checkpoint/context.js

@@ -0,0 +1,140 @@
+import { DuplicateIoKeyError } from '../errors/index.js';
+/**
+ * Implementation of SubscriberContext that provides io() caching.
+ *
+ * On first execution, io() calls execute their lambdas and cache results.
+ * On retry (when existingCheckpoint is provided), cached results are returned
+ * without re-executing the lambda.
+ */
+export class ResumableContext {
+    checkpoint;
+    usedKeys = new Set();
+    store;
+    envelope;
+    subscriber;
+    hooks;
+    constructor(config) {
+        this.store = config.store;
+        this.envelope = config.envelope;
+        this.subscriber = config.subscriber;
+        this.hooks = config.hooks;
+        this.checkpoint = config.existingCheckpoint ?? {
+            envelopeId: config.envelope.id,
+            subscriberName: config.subscriber.name,
+            completedSteps: {},
+        };
+    }
+    get attempt() {
+        return this.envelope.docket.attempts;
+    }
+    get isRetry() {
+        return this.attempt > 1;
+    }
+    async io(key, fn) {
+        // Validate key uniqueness within this execution
+        if (this.usedKeys.has(key)) {
+            throw new DuplicateIoKeyError(key, this.subscriber.name);
+        }
+        this.usedKeys.add(key);
+        // Check cache first
+        if (key in this.checkpoint.completedSteps) {
+            await this.hooks?.onCheckpointHit?.({
+                envelope: this.envelope,
+                subscriber: this.subscriber,
+                stepKey: key,
+            });
+            return this.checkpoint.completedSteps[key];
+        }
+        // Notify cache miss
+        await this.hooks?.onCheckpointMiss?.({
+            envelope: this.envelope,
+            subscriber: this.subscriber,
+            stepKey: key,
+        });
+        // Execute the function - errors propagate, no caching on failure
+        const result = await fn();
+        // Cache the result
+        this.checkpoint = {
+            ...this.checkpoint,
+            completedSteps: {
+                ...this.checkpoint.completedSteps,
+                [key]: result,
+            },
+        };
+        // Persist checkpoint immediately (incremental persistence)
+        await this.store.set(this.envelope.id, this.checkpoint);
+        return result;
+    }
+    async all(ops) {
+        // First, check for duplicates within this all() call
+        const keysInThisCall = new Set();
+        for (const [key] of ops) {
+            if (keysInThisCall.has(key)) {
+                throw new DuplicateIoKeyError(key, this.subscriber.name);
+            }
+            keysInThisCall.add(key);
+        }
+        // Then validate against previously used keys
+        for (const [key] of ops) {
+            if (this.usedKeys.has(key)) {
+                throw new DuplicateIoKeyError(key, this.subscriber.name);
+            }
+        }
+        // Mark all keys as used
+        for (const [key] of ops) {
+            this.usedKeys.add(key);
+        }
+        // Execute all operations in parallel
+        const results = await Promise.all(ops.map(async ([key, fn]) => {
+            // Check cache first
+            if (key in this.checkpoint.completedSteps) {
+                await this.hooks?.onCheckpointHit?.({
+                    envelope: this.envelope,
+                    subscriber: this.subscriber,
+                    stepKey: key,
+                });
+                return this.checkpoint.completedSteps[key];
+            }
+            // Notify cache miss
+            await this.hooks?.onCheckpointMiss?.({
+                envelope: this.envelope,
+                subscriber: this.subscriber,
+                stepKey: key,
+            });
+            // Execute - errors propagate
+            const result = await fn();
+            // Cache individually (in local state, will persist after Promise.all)
+            this.checkpoint = {
+                ...this.checkpoint,
+                completedSteps: {
+                    ...this.checkpoint.completedSteps,
+                    [key]: result,
+                },
+            };
+            return result;
+        }));
+        // Persist after all parallel operations complete
+        await this.store.set(this.envelope.id, this.checkpoint);
+        return results;
+    }
+    /**
+     * Clears the checkpoint from storage.
+     * Called after successful completion or dead-letter.
+     */
+    async clear() {
+        await this.store.delete(this.envelope.id);
+    }
+    /**
+     * Gets the current checkpoint state.
+     * Useful for debugging and testing.
+     */
+    getCheckpoint() {
+        return this.checkpoint;
+    }
+    /**
+     * Gets the number of cached steps.
+     */
+    get cachedStepCount() {
+        return Object.keys(this.checkpoint.completedSteps).length;
+    }
+}

package/dist/checkpoint/context.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.test.d.ts.map

package/dist/checkpoint/context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.test.d.ts","sourceRoot":"","sources":["../../src/checkpoint/context.test.ts"],"names":[],"mappings":""}

package/dist/checkpoint/context.test.js

@@ -0,0 +1,424 @@
+import { beforeEach, describe, expect, it, vi } from 'bun:test';
+import { DuplicateIoKeyError } from '../errors/index.js';
+import { ResumableContext } from './context.js';
+import { MemoryCheckpointStore } from './stores/memory.js';
+function createTestEnvelope(id = 'test-envelope-id', attempts = 1) {
+    return {
+        id,
+        data: { userId: '123' },
+        docket: {
+            eventKey: 'test.event',
+            targetSubscriber: 'test-subscriber',
+            importance: 'should-investigate',
+            attempts,
+            createdAt: new Date().toISOString(),
+        },
+    };
+}
+function createTestSubscriber(name = 'test-subscriber') {
+    return {
+        name,
+        description: 'Test subscriber',
+        idempotent: 'resumable',
+        importance: 'should-investigate',
+    };
+}
+describe('ResumableContext', () => {
+    let store;
+    let envelope;
+    let subscriber;
+    beforeEach(() => {
+        store = new MemoryCheckpointStore();
+        envelope = createTestEnvelope();
+        subscriber = createTestSubscriber();
+    });
+    describe('io()', () => {
+        it('should execute function and cache result on first call', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            let executeCount = 0;
+            const result = await context.io('step-1', () => {
+                executeCount++;
+                return 'result-1';
+            });
+            expect(result).toBe('result-1');
+            expect(executeCount).toBe(1);
+            expect(store.size).toBe(1);
+        });
+        it('should return cached result on retry without re-executing', async () => {
+            // First execution - cache the result
+            const firstContext = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            let executeCount = 0;
+            await firstContext.io('step-1', () => {
+                executeCount++;
+                return 'result-1';
+            });
+            expect(executeCount).toBe(1);
+            // Simulate retry - load existing checkpoint
+            const checkpoint = await store.get(envelope.id);
+            const retryContext = new ResumableContext({
+                store,
+                envelope: createTestEnvelope(envelope.id, 2),
+                subscriber,
+                existingCheckpoint: checkpoint,
+            });
+            const result = await retryContext.io('step-1', () => {
+                executeCount++;
+                return 'should-not-be-used';
+            });
+            expect(result).toBe('result-1');
+            expect(executeCount).toBe(1); // Still 1, not re-executed
+        });
+        it('should throw DuplicateIoKeyError on duplicate key within same execution', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            await context.io('same-key', () => 'first');
+            await expect(context.io('same-key', () => 'second')).rejects.toThrow(DuplicateIoKeyError);
+        });
+        it('should handle async functions', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            const result = await context.io('async-step', async () => {
+                await new Promise((resolve) => setTimeout(resolve, 10));
+                return { value: 42 };
+            });
+            expect(result).toEqual({ value: 42 });
+        });
+        it('should not cache failed operations', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            // First attempt - fails
+            await expect(context.io('failing-step', () => {
+                throw new Error('Operation failed');
+            })).rejects.toThrow('Operation failed');
+            // Checkpoint should not contain the failed step
+            const checkpoint = await store.get(envelope.id);
+            expect(checkpoint?.completedSteps['failing-step']).toBeUndefined();
+        });
+        it('should persist checkpoint after each io() call', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            await context.io('step-1', () => 'result-1');
+            let checkpoint = await store.get(envelope.id);
+            expect(Object.keys(checkpoint.completedSteps)).toHaveLength(1);
+            await context.io('step-2', () => 'result-2');
+            checkpoint = await store.get(envelope.id);
+            expect(Object.keys(checkpoint.completedSteps)).toHaveLength(2);
+        });
+        it('should support various JSON-serializable return types', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            expect(await context.io('string', () => 'hello')).toBe('hello');
+            expect(await context.io('number', () => 42)).toBe(42);
+            expect(await context.io('boolean', () => true)).toBe(true);
+            expect(await context.io('null', () => null)).toBe(null);
+            expect(await context.io('array', () => [1, 2, 3])).toEqual([1, 2, 3]);
+            expect(await context.io('object', () => ({ foo: 'bar' }))).toEqual({
+                foo: 'bar',
+            });
+        });
+    });
+    describe('all()', () => {
+        it('should execute multiple operations in parallel', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            const executionOrder = [];
+            const [a, b, c] = await context.all([
+                [
+                    'fetch-a',
+                    () => {
+                        executionOrder.push('a');
+                        return 'result-a';
+                    },
+                ],
+                [
+                    'fetch-b',
+                    () => {
+                        executionOrder.push('b');
+                        return 'result-b';
+                    },
+                ],
+                [
+                    'fetch-c',
+                    () => {
+                        executionOrder.push('c');
+                        return 'result-c';
+                    },
+                ],
+            ]);
+            expect(a).toBe('result-a');
+            expect(b).toBe('result-b');
+            expect(c).toBe('result-c');
+            expect(executionOrder).toHaveLength(3);
+        });
+        it('should cache all results on retry', async () => {
+            // First execution
+            const firstContext = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            let executeCount = 0;
+            await firstContext.all([
+                [
+                    'fetch-a',
+                    () => {
+                        executeCount++;
+                        return 'result-a';
+                    },
+                ],
+                [
+                    'fetch-b',
+                    () => {
+                        executeCount++;
+                        return 'result-b';
+                    },
+                ],
+            ]);
+            expect(executeCount).toBe(2);
+            // Retry with cached checkpoint
+            const checkpoint = await store.get(envelope.id);
+            const retryContext = new ResumableContext({
+                store,
+                envelope: createTestEnvelope(envelope.id, 2),
+                subscriber,
+                existingCheckpoint: checkpoint,
+            });
+            const [a, b] = await retryContext.all([
+                [
+                    'fetch-a',
+                    () => {
+                        executeCount++;
+                        return 'new-a';
+                    },
+                ],
+                [
+                    'fetch-b',
+                    () => {
+                        executeCount++;
+                        return 'new-b';
+                    },
+                ],
+            ]);
+            expect(a).toBe('result-a'); // Cached
+            expect(b).toBe('result-b'); // Cached
+            expect(executeCount).toBe(2); // Still 2, not re-executed
+        });
+        it('should throw on duplicate key in all()', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            await expect(context.all([
+                ['same-key', () => 'first'],
+                ['same-key', () => 'second'],
+            ])).rejects.toThrow(DuplicateIoKeyError);
+        });
+        it('should throw if all() key conflicts with previous io() key', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            await context.io('used-key', () => 'first');
+            await expect(context.all([
+                ['used-key', () => 'second'],
+                ['new-key', () => 'third'],
+            ])).rejects.toThrow(DuplicateIoKeyError);
+        });
+    });
+    describe('attempt and isRetry', () => {
+        it('should report attempt number from envelope', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope: createTestEnvelope('test', 3),
+                subscriber,
+            });
+            expect(context.attempt).toBe(3);
+        });
+        it('should report isRetry as false for first attempt', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope: createTestEnvelope('test', 1),
+                subscriber,
+            });
+            expect(context.isRetry).toBe(false);
+        });
+        it('should report isRetry as true for subsequent attempts', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope: createTestEnvelope('test', 2),
+                subscriber,
+            });
+            expect(context.isRetry).toBe(true);
+        });
+    });
+    describe('clear()', () => {
+        it('should delete checkpoint from store', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            await context.io('step-1', () => 'result');
+            expect(store.size).toBe(1);
+            await context.clear();
+            expect(store.size).toBe(0);
+        });
+    });
+    describe('hooks', () => {
+        it('should call onCheckpointHit when using cached value', async () => {
+            const onCheckpointHit = vi.fn();
+            // First execution - populate cache
+            const firstContext = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            await firstContext.io('cached-step', () => 'cached-result');
+            // Retry with hooks
+            const checkpoint = await store.get(envelope.id);
+            const retryContext = new ResumableContext({
+                store,
+                envelope: createTestEnvelope(envelope.id, 2),
+                subscriber,
+                existingCheckpoint: checkpoint,
+                hooks: { onCheckpointHit },
+            });
+            await retryContext.io('cached-step', () => 'new-result');
+            expect(onCheckpointHit).toHaveBeenCalledWith({
+                envelope: expect.anything(),
+                subscriber,
+                stepKey: 'cached-step',
+            });
+        });
+        it('should call onCheckpointMiss when executing fresh', async () => {
+            const onCheckpointMiss = vi.fn();
+            const context = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+                hooks: { onCheckpointMiss },
+            });
+            await context.io('fresh-step', () => 'result');
+            expect(onCheckpointMiss).toHaveBeenCalledWith({
+                envelope,
+                subscriber,
+                stepKey: 'fresh-step',
+            });
+        });
+    });
+    describe('real-world scenarios', () => {
+        it('should replay cached steps and execute new ones on retry', async () => {
+            const executionLog = [];
+            let shouldFail = true;
+            // First attempt - fails after step-1
+            const firstContext = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            try {
+                await firstContext.io('step-0', () => {
+                    executionLog.push('step-0');
+                    return 'result-0';
+                });
+                await firstContext.io('step-1', () => {
+                    executionLog.push('step-1');
+                    return 'result-1';
+                });
+                if (shouldFail) {
+                    shouldFail = false;
+                    throw new Error('Simulated failure');
+                }
+                await firstContext.io('step-2', () => {
+                    executionLog.push('step-2');
+                    return 'result-2';
+                });
+            }
+            catch {
+                // Expected failure
+            }
+            expect(executionLog).toEqual(['step-0', 'step-1']);
+            // Retry - step-0 and step-1 use cache, step-2 executes
+            executionLog.length = 0;
+            const checkpoint = await store.get(envelope.id);
+            const retryContext = new ResumableContext({
+                store,
+                envelope: createTestEnvelope(envelope.id, 2),
+                subscriber,
+                existingCheckpoint: checkpoint,
+            });
+            await retryContext.io('step-0', () => {
+                executionLog.push('step-0');
+                return 'should-not-use';
+            });
+            await retryContext.io('step-1', () => {
+                executionLog.push('step-1');
+                return 'should-not-use';
+            });
+            await retryContext.io('step-2', () => {
+                executionLog.push('step-2');
+                return 'result-2';
+            });
+            expect(executionLog).toEqual(['step-2']); // Only step-2 executed!
+        });
+        it('should handle conditional io() calls correctly', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope: { ...envelope, data: { sendEmail: true } },
+                subscriber,
+            });
+            const result = await context.io('send-email', () => ({
+                messageId: 'msg-123',
+            }));
+            expect(result).toEqual({ messageId: 'msg-123' });
+        });
+        it('should handle dynamic loop with unique keys', async () => {
+            const context = new ResumableContext({
+                store,
+                envelope,
+                subscriber,
+            });
+            const items = [
+                { id: 'item-1', value: 10 },
+                { id: 'item-2', value: 20 },
+                { id: 'item-3', value: 30 },
+            ];
+            const results = [];
+            for (const item of items) {
+                const processed = await context.io(`process-${item.id}`, () => {
+                    return item.value * 2;
+                });
+                results.push(processed);
+            }
+            expect(results).toEqual([20, 40, 60]);
+        });
+    });
+});

package/dist/checkpoint/index.d.ts

@@ -0,0 +1,7 @@
+export type { Checkpoint, CheckpointClearedContext, CheckpointHitContext, CheckpointLoadedContext, CheckpointMissContext, CheckpointStore, JsonSerializable, SubscriberContext, } from './types.js';
+export type { ResumableContextConfig, ResumableContextHooks, } from './context.js';
+export { ResumableContext } from './context.js';
+export { MemoryCheckpointStore } from './stores/memory.js';
+export { NoOpCheckpointStore } from './stores/noop.js';
+export { CheckpointStoreError, DuplicateIoKeyError, isCheckpointStoreError, isDuplicateIoKeyError, } from '../errors/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checkpoint/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,UAAU,EACV,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC"}

package/dist/checkpoint/index.js

@@ -0,0 +1,6 @@
+export { ResumableContext } from './context.js';
+// Stores
+export { MemoryCheckpointStore } from './stores/memory.js';
+export { NoOpCheckpointStore } from './stores/noop.js';
+// Errors (re-exported from ../errors for convenience)
+export { CheckpointStoreError, DuplicateIoKeyError, isCheckpointStoreError, isDuplicateIoKeyError, } from '../errors/index.js';

package/dist/checkpoint/stores/memory.d.ts

@@ -0,0 +1,29 @@
+import type { Checkpoint, CheckpointStore } from '../types.js';
+/**
+ * In-memory checkpoint store for testing and development.
+ * Checkpoints are lost when the process restarts.
+ *
+ * For production use, implement a persistent store (e.g., RedisCheckpointStore).
+ */
+export declare class MemoryCheckpointStore implements CheckpointStore {
+    private readonly checkpoints;
+    get(envelopeId: string): Promise<Checkpoint | undefined>;
+    set(envelopeId: string, checkpoint: Checkpoint): Promise<void>;
+    delete(envelopeId: string): Promise<void>;
+    /**
+     * Gets the number of stored checkpoints.
+     * Useful for testing.
+     */
+    get size(): number;
+    /**
+     * Clears all stored checkpoints.
+     * Useful for testing.
+     */
+    clear(): void;
+    /**
+     * Gets all stored checkpoint IDs.
+     * Useful for testing.
+     */
+    keys(): string[];
+}
+//# sourceMappingURL=memory.d.ts.map