@zdavison/matador 2.0.7 → 2.0.9

package/dist/errors/retry-errors.js

@@ -1,155 +0,0 @@
-import assert from 'node:assert';
-/**
- * Base class for retry control errors.
- * These errors control the retry behavior of message processing.
- */
-export class RetryControlError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = this.constructor.name;
-        // Ensure name is preserved when serialized
-        Object.defineProperty(this, 'name', {
-            value: this.constructor.name,
-            enumerable: true,
-            configurable: false,
-            writable: false,
-        });
-    }
-    /**
-     * Returns a serializable representation for logging/monitoring.
-     */
-    toJSON() {
-        return {
-            name: this.name,
-            message: this.message,
-            description: this.description,
-            stack: this.stack,
-        };
-    }
-}
-/**
- * Forces retry regardless of subscriber idempotency setting.
- * Use when you know the operation is safe to retry.
- *
- * ACTION: Check subscriber code to understand why retry was forced.
- * This overrides default retry behavior based on idempotency settings.
- */
-export class DoRetry extends RetryControlError {
-    description = 'A subscriber explicitly requested retry by throwing DoRetry. ' +
-        'ACTION: Check the subscriber code to understand why retry was forced. ' +
-        'This overrides the default retry behavior based on idempotency settings.';
-    constructor(message = 'Forced retry requested') {
-        super(message);
-    }
-}
-/**
- * Prevents retry regardless of subscriber idempotency setting.
- * Use for permanent failures that should not be retried.
- *
- * ACTION: Check subscriber code to understand why retry was disabled.
- * Typically used for permanent failures like invalid data or business rule violations.
- */
-export class DontRetry extends RetryControlError {
-    description = 'A subscriber explicitly prevented retry by throwing DontRetry. ' +
-        'ACTION: Check the subscriber code to understand why retry was disabled. ' +
-        'Typically used for permanent failures like invalid data or business rule violations. ' +
-        'The message will be sent to the dead-letter queue for manual review.';
-    constructor(message = 'Retry explicitly disabled') {
-        super(message);
-    }
-}
-/**
- * Thrown by `assertEvent` in the event of a failed assertion.
- *
- * This error indicates that an event was in an unexpected state when it reached the subscriber.
- * Throwing this error will indicate to Matador NOT to retry the event - it will be sent
- * directly to the undeliverable dead-letter queue.
- *
- * Use `assertEvent` in your subscribers to assert properties about an event payload.
- * This is useful in scenarios where you would expect an event payload to contain a field
- * based on the types, but something unexpected caused it to not be present.
- *
- * @see assertEvent
- */
-export class EventAssertionError extends Error {
-    description = 'Thrown to indicate that an event was in an unexpected state when it reached the subscriber. ' +
-        'Throwing this error will indicate to Matador NOT to retry the event. ' +
-        'Matador does not throw this error directly - it is thrown by assertEvent, which you can ' +
-        'use in your subscribers to assert properties about an event. ' +
-        'This can be useful in scenarios where you would expect an event payload to contain a field ' +
-        'based on the types, but something unexpected caused it to not be present. ' +
-        'Using this instead of the NodeJS assert allows Matador to not retry the event subscriber.';
-    /** The envelope that failed the assertion */
-    envelope;
-    constructor(envelope, message) {
-        super(message);
-        this.name = 'EventAssertionError';
-        this.envelope = envelope;
-        Object.defineProperty(this, 'name', {
-            value: 'EventAssertionError',
-            enumerable: true,
-            configurable: false,
-            writable: false,
-        });
-    }
-    toJSON() {
-        return {
-            name: this.name,
-            message: this.message,
-            description: this.description,
-            envelope: this.envelope,
-            stack: this.stack,
-        };
-    }
-}
-/**
- * Checks if an error forces a retry.
- */
-export function isDoRetry(error) {
-    return error instanceof DoRetry;
-}
-/**
- * Checks if an error prevents retry.
- */
-export function isDontRetry(error) {
-    return error instanceof DontRetry;
-}
-/**
- * Checks if an error is an assertion error (never retry).
- */
-export function isAssertionError(error) {
-    return error instanceof EventAssertionError;
-}
-/**
- * Same as Node.js `assert`, but throws an `EventAssertionError` if the assertion fails.
- *
- * `EventAssertionError`s thrown within a subscriber do not cause the subscriber to be retried.
- * The event will be delivered to the undeliverable dead-letter queue instead.
- *
- * @see https://nodejs.org/api/assert.html#assertvalue-message
- * @param envelope - The envelope this assertion relates to.
- * @param value - The value to assert. If falsy, the assertion fails.
- * @param message - The message to include in the error if the assertion fails.
- * @throws {EventAssertionError} If the assertion fails.
- *
- * @example
- * ```typescript
- * const subscriber = createSubscriber<MyEvent>({
- *   name: 'my-subscriber',
- *   description: 'Processes MyEvent',
- *   callback: async (envelope) => {
- *     // Assert that userId exists - if not, event goes to DLQ without retry
- *     assertEvent(envelope, envelope.data.userId, 'userId is required');
- *     // ... rest of processing
- *   },
- * });
- * ```
- */
-export function assertEvent(envelope, value, message) {
-    try {
-        assert(value, message);
-    }
-    catch {
-        throw new EventAssertionError(envelope, message);
-    }
-}

package/dist/errors/retry-errors.test.d.ts

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

package/dist/errors/retry-errors.test.d.ts.map

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

package/dist/errors/retry-errors.test.js

@@ -1,136 +0,0 @@
-import { describe, expect, it } from 'bun:test';
-import { createEnvelope } from '../types/envelope.js';
-import { assertEvent, DontRetry, DoRetry, EventAssertionError, isAssertionError, isDontRetry, isDoRetry, } from './retry-errors.js';
-function createTestEnvelope(data = { foo: 'bar' }) {
-    return createEnvelope({
-        data,
-        eventKey: 'test.event',
-        targetSubscriber: 'test-subscriber',
-        importance: 'can-ignore',
-    });
-}
-describe('retry-errors', () => {
-    describe('DoRetry', () => {
-        it('should have correct name', () => {
-            const error = new DoRetry('test message');
-            expect(error.name).toBe('DoRetry');
-        });
-        it('should have description', () => {
-            const error = new DoRetry('test message');
-            expect(error.description).toBeDefined();
-        });
-        it('should serialize to JSON', () => {
-            const error = new DoRetry('test message');
-            const json = error.toJSON();
-            expect(json.name).toBe('DoRetry');
-            expect(json.message).toBe('test message');
-            expect(json.description).toBeDefined();
-        });
-    });
-    describe('DontRetry', () => {
-        it('should have correct name', () => {
-            const error = new DontRetry('test message');
-            expect(error.name).toBe('DontRetry');
-        });
-        it('should have description', () => {
-            const error = new DontRetry('test message');
-            expect(error.description).toBeDefined();
-        });
-        it('should serialize to JSON', () => {
-            const error = new DontRetry('test message');
-            const json = error.toJSON();
-            expect(json.name).toBe('DontRetry');
-            expect(json.message).toBe('test message');
-            expect(json.description).toBeDefined();
-        });
-    });
-    describe('EventAssertionError', () => {
-        it('should have correct name', () => {
-            const envelope = createTestEnvelope();
-            const error = new EventAssertionError(envelope, 'assertion failed');
-            expect(error.name).toBe('EventAssertionError');
-        });
-        it('should store the envelope', () => {
-            const envelope = createTestEnvelope();
-            const error = new EventAssertionError(envelope, 'assertion failed');
-            expect(error.envelope).toBe(envelope);
-        });
-        it('should have description', () => {
-            const envelope = createTestEnvelope();
-            const error = new EventAssertionError(envelope, 'assertion failed');
-            expect(error.description).toBeDefined();
-            expect(error.description).toContain('NOT to retry');
-        });
-        it('should serialize to JSON with envelope', () => {
-            const envelope = createTestEnvelope();
-            const error = new EventAssertionError(envelope, 'assertion failed');
-            const json = error.toJSON();
-            expect(json.name).toBe('EventAssertionError');
-            expect(json.message).toBe('assertion failed');
-            expect(json.envelope).toBe(envelope);
-            expect(json.description).toBeDefined();
-        });
-    });
-    describe('assertEvent', () => {
-        it('should not throw when value is truthy', () => {
-            const envelope = createTestEnvelope();
-            expect(() => assertEvent(envelope, true, 'should be true')).not.toThrow();
-            expect(() => assertEvent(envelope, 'string', 'should be string')).not.toThrow();
-            expect(() => assertEvent(envelope, 1, 'should be number')).not.toThrow();
-            expect(() => assertEvent(envelope, {}, 'should be object')).not.toThrow();
-            expect(() => assertEvent(envelope, [], 'should be array')).not.toThrow();
-        });
-        it('should throw EventAssertionError when value is falsy', () => {
-            const envelope = createTestEnvelope();
-            expect(() => assertEvent(envelope, false, 'value was false')).toThrow(EventAssertionError);
-            expect(() => assertEvent(envelope, null, 'value was null')).toThrow(EventAssertionError);
-            expect(() => assertEvent(envelope, undefined, 'value was undefined')).toThrow(EventAssertionError);
-            expect(() => assertEvent(envelope, 0, 'value was zero')).toThrow(EventAssertionError);
-            expect(() => assertEvent(envelope, '', 'value was empty string')).toThrow(EventAssertionError);
-        });
-        it('should include envelope in thrown error', () => {
-            const envelope = createTestEnvelope();
-            try {
-                assertEvent(envelope, false, 'assertion failed');
-                expect.unreachable('should have thrown');
-            }
-            catch (error) {
-                expect(error).toBeInstanceOf(EventAssertionError);
-                expect(error.envelope).toBe(envelope);
-                expect(error.message).toBe('assertion failed');
-            }
-        });
-        it('should include message in thrown error', () => {
-            const envelope = createTestEnvelope();
-            try {
-                assertEvent(envelope, null, 'userId is required');
-                expect.unreachable('should have thrown');
-            }
-            catch (error) {
-                expect(error).toBeInstanceOf(EventAssertionError);
-                expect(error.message).toBe('userId is required');
-            }
-        });
-    });
-    describe('type guards', () => {
-        it('isDoRetry should identify DoRetry errors', () => {
-            expect(isDoRetry(new DoRetry('test'))).toBe(true);
-            expect(isDoRetry(new DontRetry('test'))).toBe(false);
-            expect(isDoRetry(new Error('test'))).toBe(false);
-            expect(isDoRetry(null)).toBe(false);
-        });
-        it('isDontRetry should identify DontRetry errors', () => {
-            expect(isDontRetry(new DontRetry('test'))).toBe(true);
-            expect(isDontRetry(new DoRetry('test'))).toBe(false);
-            expect(isDontRetry(new Error('test'))).toBe(false);
-            expect(isDontRetry(null)).toBe(false);
-        });
-        it('isAssertionError should identify EventAssertionError', () => {
-            const envelope = createTestEnvelope();
-            expect(isAssertionError(new EventAssertionError(envelope, 'test'))).toBe(true);
-            expect(isAssertionError(new DoRetry('test'))).toBe(false);
-            expect(isAssertionError(new Error('test'))).toBe(false);
-            expect(isAssertionError(null)).toBe(false);
-        });
-    });
-});

package/dist/hooks/index.d.ts

@@ -1,4 +0,0 @@
-export type { DecodeErrorContext, EnqueueErrorContext, EnqueueSuccessContext, Logger, MatadorHooks, TransportFallbackContext, WorkerErrorContext, WorkerExecuteFn, WorkerSuccessContext, } from './types.js';
-export { consoleLogger } from './types.js';
-export { SafeHooks } from './safe-hooks.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,MAAM,EACN,YAAY,EACZ,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/hooks/index.js

@@ -1,2 +0,0 @@
-export { consoleLogger } from './types.js';
-export { SafeHooks } from './safe-hooks.js';

package/dist/hooks/safe-hooks.d.ts

@@ -1,33 +0,0 @@
-import type { CheckpointClearedContext, CheckpointHitContext, CheckpointLoadedContext, CheckpointMissContext } from '../checkpoint/index.js';
-import type { ConnectionState } from '../transport/index.js';
-import type { Envelope, SubscriberDefinition } from '../types/index.js';
-import { type DecodeErrorContext, type EnqueueErrorContext, type EnqueueSuccessContext, type Logger, type MatadorHooks, type WorkerErrorContext, type WorkerExecuteFn, type WorkerSuccessContext } from './types.js';
-/**
- * Wraps hooks with error handling to prevent hook errors from breaking processing.
- * All hooks become safe to call and will catch any errors internally.
- */
-export declare class SafeHooks {
-    private readonly hooks;
-    /** The logger instance used by Matador. */
-    readonly logger: Logger;
-    constructor(hooks?: MatadorHooks);
-    onEnqueueSuccess(context: EnqueueSuccessContext): Promise<void>;
-    onEnqueueError(context: EnqueueErrorContext): Promise<void>;
-    onWorkerWrap(envelope: Envelope, subscriber: SubscriberDefinition, execute: WorkerExecuteFn): Promise<void>;
-    onWorkerBeforeProcess(envelope: Envelope, subscriber: SubscriberDefinition): Promise<void>;
-    onWorkerSuccess(context: WorkerSuccessContext): Promise<void>;
-    onWorkerError(context: WorkerErrorContext): Promise<void>;
-    onDecodeError(context: DecodeErrorContext): Promise<void>;
-    onConnectionStateChange(state: ConnectionState): Promise<void>;
-    loadUniversalMetadata(): Promise<Record<string, unknown>>;
-    getQueueConcurrency(queueName: string): Promise<number | undefined>;
-    getRetryDelay(envelope: Envelope, attemptNumber: number): Promise<number | undefined>;
-    getAttempts(envelope: Envelope): Promise<number | undefined>;
-    getMaxDeliveries(envelope: Envelope): Promise<number | undefined>;
-    onCheckpointLoaded(context: CheckpointLoadedContext): Promise<void>;
-    onCheckpointHit(context: CheckpointHitContext): Promise<void>;
-    onCheckpointMiss(context: CheckpointMissContext): Promise<void>;
-    onCheckpointCleared(context: CheckpointClearedContext): Promise<void>;
-    private safeCall;
-}
-//# sourceMappingURL=safe-hooks.d.ts.map

package/dist/hooks/safe-hooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"safe-hooks.d.ts","sourceRoot":"","sources":["../../src/hooks/safe-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAE1B,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAErC,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,KAAK,GAAE,YAAiB;IAK9B,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,YAAY,CAChB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,oBAAoB,EAChC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAiBV,qBAAqB,CACzB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAMV,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7D,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9D,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAiBzD,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAgBnE,aAAa,CACjB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAaxB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAa5D,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAkBjE,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnE,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7D,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D,mBAAmB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;YAM7D,QAAQ;CAUvB"}

package/dist/hooks/safe-hooks.js

@@ -1,132 +0,0 @@
-import { consoleLogger, } from './types.js';
-/**
- * Wraps hooks with error handling to prevent hook errors from breaking processing.
- * All hooks become safe to call and will catch any errors internally.
- */
-export class SafeHooks {
-    hooks;
-    /** The logger instance used by Matador. */
-    logger;
-    constructor(hooks = {}) {
-        this.hooks = hooks;
-        this.logger = hooks.logger ?? consoleLogger;
-    }
-    async onEnqueueSuccess(context) {
-        await this.safeCall('onEnqueueSuccess', () => this.hooks.onEnqueueSuccess?.(context));
-    }
-    async onEnqueueError(context) {
-        await this.safeCall('onEnqueueError', () => this.hooks.onEnqueueError?.(context));
-    }
-    async onWorkerWrap(envelope, subscriber, execute) {
-        if (this.hooks.onWorkerWrap) {
-            try {
-                await this.hooks.onWorkerWrap(envelope, subscriber, execute);
-            }
-            catch (error) {
-                this.logger.warn('[Matador] 🟡 Hook onWorkerWrap threw an error', error);
-                // Still try to execute if wrap failed
-                await execute();
-            }
-        }
-        else {
-            await execute();
-        }
-    }
-    async onWorkerBeforeProcess(envelope, subscriber) {
-        await this.safeCall('onWorkerBeforeProcess', () => this.hooks.onWorkerBeforeProcess?.(envelope, subscriber));
-    }
-    async onWorkerSuccess(context) {
-        await this.safeCall('onWorkerSuccess', () => this.hooks.onWorkerSuccess?.(context));
-    }
-    async onWorkerError(context) {
-        await this.safeCall('onWorkerError', () => this.hooks.onWorkerError?.(context));
-    }
-    async onDecodeError(context) {
-        await this.safeCall('onDecodeError', () => this.hooks.onDecodeError?.(context));
-    }
-    async onConnectionStateChange(state) {
-        await this.safeCall('onConnectionStateChange', () => this.hooks.onConnectionStateChange?.(state));
-    }
-    async loadUniversalMetadata() {
-        if (!this.hooks.loadUniversalMetadata) {
-            return {};
-        }
-        try {
-            const result = await this.hooks.loadUniversalMetadata();
-            return result ?? {};
-        }
-        catch (error) {
-            this.logger.warn('[Matador] 🟡 Hook loadUniversalMetadata threw an error', error);
-            return {};
-        }
-    }
-    async getQueueConcurrency(queueName) {
-        if (!this.hooks.getQueueConcurrency) {
-            return undefined;
-        }
-        try {
-            return await this.hooks.getQueueConcurrency(queueName);
-        }
-        catch (error) {
-            this.logger.warn('[Matador] 🟡 Hook getQueueConcurrency threw an error', error);
-            return undefined;
-        }
-    }
-    async getRetryDelay(envelope, attemptNumber) {
-        if (!this.hooks.getRetryDelay) {
-            return undefined;
-        }
-        try {
-            return await this.hooks.getRetryDelay(envelope, attemptNumber);
-        }
-        catch (error) {
-            this.logger.warn('[Matador] 🟡 Hook getRetryDelay threw an error', error);
-            return undefined;
-        }
-    }
-    async getAttempts(envelope) {
-        if (!this.hooks.getAttempts) {
-            return undefined;
-        }
-        try {
-            return await this.hooks.getAttempts(envelope);
-        }
-        catch (error) {
-            this.logger.warn('[Matador] 🟡 Hook getAttempts threw an error', error);
-            return undefined;
-        }
-    }
-    async getMaxDeliveries(envelope) {
-        if (!this.hooks.getMaxDeliveries) {
-            return undefined;
-        }
-        try {
-            return await this.hooks.getMaxDeliveries(envelope);
-        }
-        catch (error) {
-            this.logger.warn('[Matador] 🟡 Hook getMaxDeliveries threw an error', error);
-            return undefined;
-        }
-    }
-    // === Checkpoint Hooks ===
-    async onCheckpointLoaded(context) {
-        await this.safeCall('onCheckpointLoaded', () => this.hooks.onCheckpointLoaded?.(context));
-    }
-    async onCheckpointHit(context) {
-        await this.safeCall('onCheckpointHit', () => this.hooks.onCheckpointHit?.(context));
-    }
-    async onCheckpointMiss(context) {
-        await this.safeCall('onCheckpointMiss', () => this.hooks.onCheckpointMiss?.(context));
-    }
-    async onCheckpointCleared(context) {
-        await this.safeCall('onCheckpointCleared', () => this.hooks.onCheckpointCleared?.(context));
-    }
-    async safeCall(hookName, fn) {
-        try {
-            await fn();
-        }
-        catch (error) {
-            this.logger.warn(`[Matador] 🟡 Hook ${hookName} threw an error`, error);
-        }
-    }
-}

package/dist/hooks/types.d.ts

@@ -1,176 +0,0 @@
-import type { CheckpointClearedContext, CheckpointHitContext, CheckpointLoadedContext, CheckpointMissContext } from '../checkpoint/index.js';
-import type { RetryDecision } from '../retry/index.js';
-import type { ConnectionState, Transport } from '../transport/index.js';
-import type { Envelope, SubscriberDefinition } from '../types/index.js';
-/**
- * Logger interface for Matador internal logging.
- */
-export interface Logger {
-    debug(message: string, ...args: unknown[]): void;
-    info(message: string, ...args: unknown[]): void;
-    warn(message: string, ...args: unknown[]): void;
-    error(message: string, ...args: unknown[]): void;
-}
-/**
- * Default logger that uses console.
- */
-export declare const consoleLogger: Logger;
-/**
- * Context for enqueue success hook.
- */
-export interface EnqueueSuccessContext {
-    readonly envelope: Envelope;
-    readonly queue: string;
-    /** The transport that was used (e.g., 'local', 'rabbitmq') */
-    readonly transport: string;
-}
-/**
- * Context for transport fallback hook.
- */
-export interface TransportFallbackContext {
-    /** The envelope that was being sent */
-    readonly envelope: Envelope;
-    /** The queue the message was being sent to */
-    readonly queue: string;
-    /** The transport that failed */
-    readonly failedTransport: Transport['name'];
-    /** The transport that will be tried next */
-    readonly nextTransport: Transport['name'];
-    /** The error from the failed transport */
-    readonly error: Error;
-}
-/**
- * Context for enqueue error hook.
- */
-export interface EnqueueErrorContext {
-    readonly envelope: Envelope;
-    readonly error: Error;
-    /** The transport that failed (e.g., 'local', 'rabbitmq') */
-    readonly transport: string;
-}
-/**
- * Context for decode error hook.
- */
-export interface DecodeErrorContext {
-    readonly error: Error;
-    readonly rawMessage: Uint8Array;
-    readonly sourceQueue: string;
-    /** The transport that received the message (e.g., 'local', 'rabbitmq') */
-    readonly transport: string;
-}
-/**
- * Context for worker success hook.
- */
-export interface WorkerSuccessContext {
-    readonly envelope: Envelope;
-    readonly subscriber: SubscriberDefinition;
-    readonly result: unknown;
-    readonly durationMs: number;
-    /** The transport that received the message (e.g., 'local', 'rabbitmq') */
-    readonly transport: string;
-}
-/**
- * Context for worker error hook.
- */
-export interface WorkerErrorContext {
-    readonly envelope: Envelope;
-    readonly subscriber: SubscriberDefinition;
-    readonly error: Error;
-    readonly durationMs: number;
-    readonly decision: RetryDecision;
-    /** The transport that received the message (e.g., 'local', 'rabbitmq') */
-    readonly transport: string;
-}
-/**
- * Execution function passed to onWorkerWrap for APM wrapping.
- */
-export type WorkerExecuteFn = () => Promise<void>;
-/**
- * All available hooks for Matador.
- */
-export interface MatadorHooks {
-    /**
-     * Logger for internal Matador logging.
-     * Defaults to console logger if not provided.
-     */
-    logger?: Logger;
-    /**
-     * Called when an event is successfully enqueued.
-     */
-    onEnqueueSuccess?(context: EnqueueSuccessContext): void | Promise<void>;
-    /**
-     * Called when transport fallback occurs during send.
-     * Only fires when using MultiTransport with fallbackEnabled=true.
-     */
-    onTransportFallback?(context: TransportFallbackContext): void | Promise<void>;
-    /**
-     * Called when enqueue fails completely.
-     */
-    onEnqueueError?(context: EnqueueErrorContext): void | Promise<void>;
-    /**
-     * Wraps entire worker processing (for APM context).
-     * Must call execute() to run the actual processing.
-     */
-    onWorkerWrap?(envelope: Envelope, subscriber: SubscriberDefinition, execute: WorkerExecuteFn): Promise<void>;
-    /**
-     * Called before processing begins.
-     */
-    onWorkerBeforeProcess?(envelope: Envelope, subscriber: SubscriberDefinition): void | Promise<void>;
-    /**
-     * Called after successful processing.
-     */
-    onWorkerSuccess?(context: WorkerSuccessContext): void | Promise<void>;
-    /**
-     * Called after processing error.
-     */
-    onWorkerError?(context: WorkerErrorContext): void | Promise<void>;
-    /**
-     * Called when message decoding fails.
-     */
-    onDecodeError?(context: DecodeErrorContext): void | Promise<void>;
-    /**
-     * Called when transport connection state changes.
-     */
-    onConnectionStateChange?(state: ConnectionState): void | Promise<void>;
-    /**
-     * Loads universal metadata to add to all envelopes.
-     */
-    loadUniversalMetadata?(): Record<string, unknown> | Promise<Record<string, unknown>>;
-    /**
-     * Dynamic queue concurrency lookup.
-     */
-    getQueueConcurrency?(queueName: string): number | undefined | Promise<number | undefined>;
-    /**
-     * Dynamic retry delay lookup.
-     */
-    getRetryDelay?(envelope: Envelope, attemptNumber: number): number | undefined | Promise<number | undefined>;
-    /**
-     * Dynamic max attempts lookup.
-     */
-    getAttempts?(envelope: Envelope): number | undefined | Promise<number | undefined>;
-    /**
-     * Dynamic max deliveries (poison threshold) lookup.
-     */
-    getMaxDeliveries?(envelope: Envelope): number | undefined | Promise<number | undefined>;
-    /**
-     * Called when a checkpoint is loaded for a retry.
-     * Only fires for resumable subscribers on retry attempts.
-     */
-    onCheckpointLoaded?(context: CheckpointLoadedContext): void | Promise<void>;
-    /**
-     * Called when an io() operation uses a cached value (checkpoint hit).
-     * Useful for observability and metrics.
-     */
-    onCheckpointHit?(context: CheckpointHitContext): void | Promise<void>;
-    /**
-     * Called when an io() operation executes (cache miss).
-     * Useful for observability and metrics.
-     */
-    onCheckpointMiss?(context: CheckpointMissContext): void | Promise<void>;
-    /**
-     * Called when a checkpoint is cleared.
-     * Fires on successful completion or when moving to dead-letter queue.
-     */
-    onCheckpointCleared?(context: CheckpointClearedContext): void | Promise<void>;
-}
-//# sourceMappingURL=types.d.ts.map

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

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