@zdavison/matador 2.0.8 → 2.0.9

package/dist/transport/transport.d.ts

@@ -1,152 +0,0 @@
-import type { Topology } from '../topology/types.js';
-import type { Envelope } from '../types/index.js';
-import type { TransportCapabilities } from './capabilities.js';
-/**
- * Transport-specific send options.
- * Each transport can define its own options under its transport name key.
- */
-export interface TransportSendOptions {
-    /** RabbitMQ-specific send options */
-    readonly rabbitmq?: RabbitMQSendOptions | undefined;
-}
-/**
- * RabbitMQ-specific options for sending messages.
- */
-export interface RabbitMQSendOptions {
-    /** Message expiration in milliseconds */
-    readonly expiration?: number | undefined;
-    /** Message persistence mode */
-    readonly persistent?: boolean | undefined;
-    /** Routing key override */
-    readonly routingKey?: string | undefined;
-}
-/**
- * Options for sending a message.
- */
-export interface SendOptions {
-    /** Delay delivery by this many milliseconds */
-    readonly delay?: number | undefined;
-    /** Priority level (0-255, higher = more important) */
-    readonly priority?: number | undefined;
-    /** Transport-specific options */
-    readonly transport?: TransportSendOptions | undefined;
-}
-/**
- * Transport-specific subscribe options.
- * Each transport can define its own options under its transport name key.
- */
-export interface TransportSubscribeOptions {
-    /** RabbitMQ-specific subscribe options */
-    readonly rabbitmq?: RabbitMQSubscribeOptions | undefined;
-}
-/**
- * RabbitMQ-specific options for subscribing.
- */
-export interface RabbitMQSubscribeOptions {
-    /** Consumer tag */
-    readonly consumerTag?: string | undefined;
-    /** Prefetch count (overrides concurrency option) */
-    readonly prefetch?: number | undefined;
-    /** Exclusive consumer */
-    readonly exclusive?: boolean | undefined;
-}
-/**
- * Options for subscribing to a queue.
- */
-export interface SubscribeOptions {
-    /** Concurrency hint (number of concurrent handlers) */
-    readonly concurrency?: number | undefined;
-    /** Override default delivery semantics */
-    readonly deliveryMode?: 'at-least-once' | 'at-most-once' | undefined;
-    /** Transport-specific options */
-    readonly transport?: TransportSubscribeOptions | undefined;
-}
-/**
- * Receipt for a received message, used for acknowledgment.
- */
-export interface MessageReceipt {
-    /** Opaque handle for the transport to identify the message */
-    readonly handle: unknown;
-    /** True if this is a redelivery (transport-reported if capable) */
-    readonly redelivered: boolean;
-    /** 1-based attempt number (transport-reported if capable, else from envelope) */
-    readonly attemptNumber: number;
-    /**
-     * Native delivery count from the transport.
-     * Tracks how many times this specific message was delivered without acknowledgment.
-     * Used for poison message detection to prevent crash loops.
-     * For transports that don't track this, defaults to attemptNumber.
-     */
-    readonly deliveryCount: number;
-    /** Original queue/topic the message came from */
-    readonly sourceQueue: string;
-    /**
-     * The name of the transport that received this message (e.g., 'local', 'rabbitmq').
-     * For MultiTransport, this is the actual underlying transport, not the wrapper name.
-     */
-    readonly sourceTransport: string;
-}
-/**
- * Handler function for processing received messages.
- */
-export type MessageHandler = (envelope: Envelope, receipt: MessageReceipt) => Promise<void>;
-/**
- * Subscription handle for managing active subscriptions.
- */
-export interface Subscription {
-    /** Cancels the subscription */
-    unsubscribe(): Promise<void>;
-    /** Whether the subscription is currently active */
-    readonly isActive: boolean;
-}
-/**
- * Transport interface - the minimal abstraction for message delivery.
- * Transports handle only I/O; all business logic lives in Matador core.
- */
-export interface Transport {
-    /** Transport identifier */
-    readonly name: string;
-    /** Capabilities supported by this transport */
-    readonly capabilities: TransportCapabilities;
-    /**
-     * Establishes connection to the message broker.
-     * Should handle initial connection with retries.
-     */
-    connect(): Promise<void>;
-    /**
-     * Gracefully disconnects from the message broker.
-     * Should close all consumers before connection.
-     */
-    disconnect(): Promise<void>;
-    /**
-     * Returns whether the transport is currently connected.
-     */
-    isConnected(): boolean;
-    /**
-     * Translates and applies the generic topology to the transport.
-     * Creates necessary queues, exchanges, topics, etc.
-     */
-    applyTopology(topology: Topology): Promise<void>;
-    /**
-     * Sends a message to the specified queue.
-     * @returns The name of the transport that was used (useful for MultiTransport)
-     */
-    send(queue: string, envelope: Envelope, options?: SendOptions): Promise<Transport['name']>;
-    /**
-     * Subscribes to messages on the specified queue.
-     * The handler receives decoded envelopes and receipts.
-     */
-    subscribe(queue: string, handler: MessageHandler, options?: SubscribeOptions): Promise<Subscription>;
-    /**
-     * Acknowledges/completes a message.
-     * Called after processing is done (success, retry scheduled, or dead-lettered).
-     */
-    complete(receipt: MessageReceipt): Promise<void>;
-    /**
-     * Sends a message to the dead-letter queue.
-     * For transports with native DL routing, may use native mechanism.
-     * For others, sends to DLQ then completes original.
-     */
-    sendToDeadLetter?(receipt: MessageReceipt, dlqName: string, envelope: Envelope, reason: string): Promise<void>;
-}
-//# sourceMappingURL=transport.d.ts.map

package/dist/transport/transport.d.ts.map

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

package/dist/transport/transport.js

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

package/dist/types/common.d.ts

@@ -1,41 +0,0 @@
-/**
- * Delivery semantics for message processing.
- * - 'at-least-once': Acknowledge after processing (may redeliver on failure)
- * - 'at-most-once': Acknowledge before processing (no redelivery, may lose messages)
- */
-export type DeliveryMode = 'at-least-once' | 'at-most-once';
-/**
- * Importance level for subscribers, used for monitoring and alerting prioritization.
- */
-export type Importance = 'can-ignore' | 'should-investigate' | 'must-investigate';
-/**
- * Idempotency declaration for subscribers.
- * - 'yes': Safe to retry on failure (subscriber handles duplicates)
- * - 'no': Not safe to retry, may cause duplicate side effects
- * - 'unknown': Idempotency not determined (default)
- * - 'resumable': Uses checkpoint-based idempotency via io() calls
- */
-export type Idempotency = 'yes' | 'no' | 'unknown' | 'resumable';
-/**
- * Result of a validation operation.
- */
-export interface ValidationResult {
-    readonly valid: boolean;
-    readonly errors: readonly ValidationError[];
-}
-/**
- * Individual validation error.
- */
-export interface ValidationError {
-    readonly path: string;
-    readonly message: string;
-}
-/**
- * Creates a successful validation result.
- */
-export declare function validResult(): ValidationResult;
-/**
- * Creates a failed validation result.
- */
-export declare function invalidResult(errors: ValidationError[]): ValidationResult;
-//# sourceMappingURL=common.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,cAAc,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,oBAAoB,GACpB,kBAAkB,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,gBAAgB,CAE9C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,gBAAgB,CAEzE"}

package/dist/types/common.js

@@ -1,12 +0,0 @@
-/**
- * Creates a successful validation result.
- */
-export function validResult() {
-    return { valid: true, errors: [] };
-}
-/**
- * Creates a failed validation result.
- */
-export function invalidResult(errors) {
-    return { valid: false, errors };
-}

package/dist/types/dispatcher.d.ts

@@ -1,14 +0,0 @@
-import type { SendResult } from '../core/fanout.js';
-import type { Event, EventClass, EventOptions } from './event.js';
-/**
- * Interface for dispatching events.
- * Implemented by Matador to allow subscribers to send events.
- */
-export interface Dispatcher {
-    /**
-     * Sends an event to all registered subscribers.
-     */
-    send<T>(eventClass: EventClass<T>, data: T, options?: EventOptions): Promise<SendResult>;
-    send<T>(event: Event<T>, options?: EventOptions): Promise<SendResult>;
-}
-//# sourceMappingURL=dispatcher.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/types/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,CAAC,CAAC,EACJ,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACvE"}

package/dist/types/dispatcher.js

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

package/dist/types/envelope.d.ts

@@ -1,131 +0,0 @@
-import type { Importance } from './common.js';
-import type { Event } from './event.js';
-/**
- * Message envelope containing the event data and routing/observability metadata.
- * This is the transport-agnostic message format used throughout Matador.
- */
-export interface Envelope<T = unknown> {
-    /** Unique message ID (UUID v4) */
-    readonly id: string;
-    /** The event data */
-    readonly data: T;
-    /** Routing, processing state, and observability metadata */
-    readonly docket: Docket;
-}
-/**
- * Metadata associated with an envelope for routing, processing state, and observability.
- */
-export interface Docket {
-    /** Event key for routing */
-    readonly eventKey: string;
-    /** Human-readable description of the event (for observability/logging) */
-    readonly eventDescription?: string | undefined;
-    /** Target subscriber name for 1:1 routing */
-    readonly targetSubscriber: string;
-    /** Original queue before any dead-letter routing */
-    originalQueue?: string | undefined;
-    /** Scheduled processing time for delayed messages (ISO 8601 string) */
-    scheduledFor?: string | undefined;
-    /**
-     * Attempt counter managed by Matador (1-based).
-     * Incremented on each retry. Used when transport doesn't track attempts.
-     */
-    attempts: number;
-    /** When the envelope was first created (ISO 8601 string) */
-    readonly createdAt: string;
-    /** Error message from first failure (for debugging) */
-    firstError?: string | undefined;
-    /** Error message from most recent failure */
-    lastError?: string | undefined;
-    /** Importance level for monitoring */
-    readonly importance: Importance;
-    /** Correlation ID for request tracing */
-    readonly correlationId?: string | undefined;
-    /**
-     * Custom metadata provided by the application.
-     * This is the merged result of universal metadata (from loadUniversalMetadata hook)
-     * and event-specific metadata (from dispatch options). Event-specific metadata
-     * overrides universal metadata when keys conflict.
-     */
-    readonly metadata?: Record<string, unknown> | undefined;
-}
-/**
- * Fields from Docket that can be specified when creating an envelope.
- */
-type DocketCreateFields = Pick<Docket, 'eventKey' | 'eventDescription' | 'targetSubscriber' | 'importance' | 'correlationId'>;
-/**
- * Options for creating an envelope.
- */
-export interface CreateEnvelopeOptions<T> extends DocketCreateFields {
-    /** Optional custom ID (defaults to UUID v4) */
-    readonly id?: string | undefined;
-    /** The event data */
-    readonly data: T;
-    /**
-     * Event-specific metadata to include in the docket.
-     * Will be merged with universal metadata, with these values taking precedence.
-     */
-    readonly metadata?: Record<string, unknown> | undefined;
-    /**
-     * Universal metadata loaded from the loadUniversalMetadata hook.
-     * This is provided by the fanout engine, not by the caller.
-     * @internal
-     */
-    readonly universalMetadata?: Record<string, unknown> | undefined;
-    /** Delay processing by this many milliseconds */
-    readonly delayMs?: number | undefined;
-}
-/**
- * Creates a new envelope with the provided options.
- */
-export declare function createEnvelope<T>(options: CreateEnvelopeOptions<T>): Envelope<T>;
-/**
- * Options for creating a dummy envelope.
- * All fields are optional and will use sensible defaults if not provided.
- */
-export interface CreateDummyEnvelopeOptions {
-    readonly id?: string | undefined;
-    readonly eventKey?: string | undefined;
-    readonly eventDescription?: string | undefined;
-    readonly targetSubscriber?: string | undefined;
-    readonly importance?: Importance | undefined;
-    readonly correlationId?: string | undefined;
-    readonly metadata?: Record<string, unknown> | undefined;
-    readonly delayMs?: number | undefined;
-}
-/**
- * Type helper to extract the data type from an Event, or return T as-is.
- */
-type ExtractData<T> = T extends Event<infer D> ? D : T;
-/**
- * Helper to create a test envelope for a given event instance or raw data.
- * Useful for unit testing subscriber callbacks directly.
- *
- * When passing an Event instance, the eventKey and eventDescription will be
- * automatically extracted from the event class (unless overridden in options).
- *
- * @example With raw data
- * ```typescript
- * const envelope = createDummyEnvelope({ userId: '123', email: 'test@example.com' });
- * ```
- *
- * @example With an Event instance
- * ```typescript
- * const event = new UserCreatedEvent({ userId: '123', email: 'test@example.com' });
- * const envelope = createDummyEnvelope(event);
- * // eventKey is automatically set to UserCreatedEvent.key
- * await mySubscriber.callback(envelope, event.data);
- * ```
- *
- * @example With options
- * ```typescript
- * const event = new UserCreatedEvent({ userId: '123', email: 'test@example.com' });
- * const envelope = createDummyEnvelope(event, {
- *   metadata: { traceId: 'abc-123' },
- *   correlationId: 'request-456',
- * });
- * ```
- */
-export declare function createDummyEnvelope<T>(dataOrEvent: T, options?: CreateDummyEnvelopeOptions): Envelope<ExtractData<T>>;
-export {};
-//# sourceMappingURL=envelope.d.ts.map

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

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

package/dist/types/envelope.js

@@ -1,99 +0,0 @@
-/**
- * Creates a new envelope with the provided options.
- */
-export function createEnvelope(options) {
-    const now = new Date().toISOString();
-    // Merge universal metadata with event-specific metadata
-    // Event-specific metadata takes precedence
-    const mergedMetadata = options.universalMetadata || options.metadata
-        ? { ...options.universalMetadata, ...options.metadata }
-        : undefined;
-    return {
-        id: options.id ?? crypto.randomUUID(),
-        data: options.data,
-        docket: {
-            // Routing
-            eventKey: options.eventKey,
-            ...(options.eventDescription !== undefined && {
-                eventDescription: options.eventDescription,
-            }),
-            targetSubscriber: options.targetSubscriber,
-            ...(options.delayMs !== undefined &&
-                options.delayMs > 0 && {
-                scheduledFor: new Date(Date.now() + options.delayMs).toISOString(),
-            }),
-            // Processing state
-            attempts: 1,
-            createdAt: now,
-            // Observability
-            importance: options.importance,
-            ...(options.correlationId !== undefined && {
-                correlationId: options.correlationId,
-            }),
-            ...(mergedMetadata !== undefined && { metadata: mergedMetadata }),
-        },
-    };
-}
-/**
- * Checks if a value is a Matador Event (has data property and constructor with key).
- */
-function isEvent(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        'data' in value &&
-        typeof value.constructor.key === 'string');
-}
-/**
- * Helper to create a test envelope for a given event instance or raw data.
- * Useful for unit testing subscriber callbacks directly.
- *
- * When passing an Event instance, the eventKey and eventDescription will be
- * automatically extracted from the event class (unless overridden in options).
- *
- * @example With raw data
- * ```typescript
- * const envelope = createDummyEnvelope({ userId: '123', email: 'test@example.com' });
- * ```
- *
- * @example With an Event instance
- * ```typescript
- * const event = new UserCreatedEvent({ userId: '123', email: 'test@example.com' });
- * const envelope = createDummyEnvelope(event);
- * // eventKey is automatically set to UserCreatedEvent.key
- * await mySubscriber.callback(envelope, event.data);
- * ```
- *
- * @example With options
- * ```typescript
- * const event = new UserCreatedEvent({ userId: '123', email: 'test@example.com' });
- * const envelope = createDummyEnvelope(event, {
- *   metadata: { traceId: 'abc-123' },
- *   correlationId: 'request-456',
- * });
- * ```
- */
-export function createDummyEnvelope(dataOrEvent, options) {
-    let data;
-    let eventKey = options?.eventKey ?? 'dummy.event.key';
-    let eventDescription = options?.eventDescription;
-    if (isEvent(dataOrEvent)) {
-        data = dataOrEvent.data;
-        const eventStatic = dataOrEvent.constructor;
-        eventKey = options?.eventKey ?? eventStatic.key;
-        eventDescription = options?.eventDescription ?? eventStatic.description;
-    }
-    else {
-        data = dataOrEvent;
-    }
-    return createEnvelope({
-        data,
-        eventKey,
-        eventDescription,
-        targetSubscriber: options?.targetSubscriber ?? 'dummy-subscriber',
-        importance: options?.importance ?? 'can-ignore',
-        id: options?.id,
-        correlationId: options?.correlationId,
-        metadata: options?.metadata,
-        delayMs: options?.delayMs,
-    });
-}

package/dist/types/event.d.ts

@@ -1,92 +0,0 @@
-import type { Jsonifiable } from 'type-fest';
-/**
- * Unique event routing key type alias.
- */
-export type EventKey = string;
-/**
- * JSON-serializable record type for metadata.
- * Uses type-fest's Jsonifiable which accepts:
- * - Primitives (string, number, boolean, null)
- * - Arrays of Jsonifiable values
- * - Objects with Jsonifiable values
- * - Objects with a toJSON() method
- */
-export type JsonRecord = Record<string, Jsonifiable>;
-/**
- * Static properties required on Event classes for schema registration.
- */
-export interface EventStatic<T = unknown> {
-    /** Unique routing key for the event */
-    readonly key: string;
-    /** Human-readable description of the event */
-    readonly description?: string;
-    /** Alternative names/keys for backwards compatibility */
-    readonly aliases?: readonly string[];
-    /** Create an instance from data (for deserialization) */
-    new (data: T): Event<T>;
-}
-/**
- * Base interface for all events.
- * Events represent something that happened in the system.
- */
-export interface Event<T = unknown> {
-    /** The event data/payload */
-    readonly data: T;
-    /** Event-specific metadata (merged with EventOptions metadata on dispatch) */
-    readonly metadata?: JsonRecord | undefined;
-}
-/**
- * Options for dispatching an event.
- */
-export interface EventOptions {
-    /** Delay processing by this many milliseconds */
-    readonly delayMs?: number | undefined;
-    /** Correlation ID for request tracing */
-    readonly correlationId?: string | undefined;
-    /**
-     * Event-specific metadata to include in the docket.
-     * This metadata will be merged with:
-     * 1. Event instance metadata (if defined on the event)
-     * 2. Universal metadata from the loadUniversalMetadata hook
-     * With EventOptions metadata taking precedence over event metadata,
-     * and both taking precedence over universal metadata.
-     */
-    readonly metadata?: JsonRecord | undefined;
-}
-/**
- * Abstract base class for creating Matador events.
- * Extend this class to define custom events.
- *
- * @example
- * ```typescript
- * class UserCreatedEvent extends MatadorEvent {
- *   static readonly key = 'user.created'
- *   static readonly description = 'Fired when a new user is created'
- *
- *   constructor(
- *     public data: { userId: string; email: string },
- *     public metadata?: JsonRecord,
- *   ) {
- *     super()
- *   }
- * }
- * ```
- */
-export declare abstract class MatadorEvent<T = unknown> implements Event<T> {
-    static readonly key: string;
-    static readonly description?: string;
-    static readonly aliases?: readonly string[];
-    /** The event data/payload - must be defined by subclass */
-    abstract readonly data: T;
-    /** Event-specific metadata */
-    readonly metadata?: JsonRecord | undefined;
-}
-/**
- * Type helper to extract the data type from an event class.
- */
-export type EventData<E extends Event<unknown>> = E extends Event<infer T> ? T : never;
-/**
- * Type helper to get the event class type.
- */
-export type EventClass<T = unknown> = EventStatic<T> & (new (data: T) => Event<T>);
-//# sourceMappingURL=event.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/types/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAErC,yDAAyD;IACzD,KAAK,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,GAAG,OAAO;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAEjB,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEtC,yCAAyC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5C;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,8BAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IACjE,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE5C,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAE1B,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACtE,CAAC,GACD,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,GAClD,CAAC,KACC,IAAI,EAAE,CAAC,KACJ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/event.js

@@ -1,26 +0,0 @@
-/**
- * Abstract base class for creating Matador events.
- * Extend this class to define custom events.
- *
- * @example
- * ```typescript
- * class UserCreatedEvent extends MatadorEvent {
- *   static readonly key = 'user.created'
- *   static readonly description = 'Fired when a new user is created'
- *
- *   constructor(
- *     public data: { userId: string; email: string },
- *     public metadata?: JsonRecord,
- *   ) {
- *     super()
- *   }
- * }
- * ```
- */
-export class MatadorEvent {
-    static key;
-    static description;
-    static aliases;
-    /** Event-specific metadata */
-    metadata;
-}

package/dist/types/event.test.d.ts

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

package/dist/types/event.test.d.ts.map

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