@oyinlola141/lattice-messaging 0.1.0

package/dist/message/messageType.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageType.type.js","sourceRoot":"","sources":["../../src/message/messageType.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/messageBus/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @oyinlola141/lattice-messaging/messageBus
+ *
+ * MessageBus interface and in-memory implementation.
+ */
+export type { MessageBusOptions, MessageBus, } from "./messageBusType.type.js";
+export { InMemoryMessageBus, createMessageBus } from "./messageBusCore.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messageBus/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,iBAAiB,EACjB,UAAU,GACX,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/messageBus/index.js

@@ -0,0 +1,7 @@
+/**
+ * @latticejs/messaging/messageBus
+ *
+ * MessageBus interface and in-memory implementation.
+ */
+export { InMemoryMessageBus, createMessageBus } from "./messageBusCore.js";
+//# sourceMappingURL=index.js.map

package/dist/messageBus/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messageBus/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/messageBus/messageBusCore.d.ts

@@ -0,0 +1,36 @@
+/**
+ * In-memory message bus implementation.
+ *
+ * @module messageBus/messageBusCore
+ */
+import type { Message, MessageInput } from "../message/messageType.type.js";
+import type { MessageHandler, NamedMessageHandler } from "../messageHandler/messageHandlerType.type.js";
+import type { MessageMiddlewareLike } from "../messageMiddleware/messageMiddlewareType.type.js";
+import type { MessageBus, MessageBusOptions } from "./messageBusType.type.js";
+import type { DispatchResult, DispatchOptions } from "../dispatcher/dispatcherType.type.js";
+/** Default in-memory message bus. */
+export declare class InMemoryMessageBus implements MessageBus {
+    private readonly dispatcher;
+    private readonly registry;
+    private readonly defaultTimeout;
+    private _disposed;
+    constructor(options?: MessageBusOptions);
+    private registerGlobalMiddleware;
+    dispatch<TPayload, TResult>(message: Message<TPayload>, options?: DispatchOptions<TResult>): Promise<DispatchResult<TResult>>;
+    private validateNotDisposed;
+    private dispatchWithTimeout;
+    send<TPayload, TResult>(input: MessageInput<TPayload>, options?: DispatchOptions<TResult>): Promise<DispatchResult<TResult>>;
+    on<TPayload, TResult>(messageType: string, handler: MessageHandler<Message<TPayload>, TResult>, options?: {
+        id?: string;
+        priority?: number;
+    }): void;
+    addHandler<TMessage extends Message, TResult>(handler: NamedMessageHandler<TMessage, TResult>): void;
+    off(handlerId: string): boolean;
+    use<TMessage extends Message = Message, TResult = unknown>(middleware: MessageMiddlewareLike<TMessage, TResult>): void;
+    hasHandlers(messageType: string): boolean;
+    get handlerCount(): number;
+    dispose(): void;
+    get disposed(): boolean;
+}
+export declare function createMessageBus(options?: MessageBusOptions): MessageBus;
+//# sourceMappingURL=messageBusCore.d.ts.map

package/dist/messageBus/messageBusCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageBusCore.d.ts","sourceRoot":"","sources":["../../src/messageBus/messageBusCore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACb,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACpB,MAAM,8CAA8C,CAAC;AAEtD,OAAO,KAAK,EACV,qBAAqB,EACtB,MAAM,oDAAoD,CAAC;AAE5D,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAChB,MAAM,sCAAsC,CAAC;AAO9C,qCAAqC;AACrC,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,SAAS,CAAS;IAE1B,YAAY,OAAO,GAAE,iBAAsB,EAQ1C;IAED,OAAO,CAAC,wBAAwB;IAM1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAC9B,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,OAAO,GAAE,eAAe,CAAC,OAAO,CAAM,GACrC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAUlC;IAED,OAAO,CAAC,mBAAmB;YAMb,mBAAmB;IAc3B,IAAI,CAAC,QAAQ,EAAE,OAAO,EAC1B,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC7B,OAAO,GAAE,eAAe,CAAC,OAAO,CAAM,GACrC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAElC;IAED,EAAE,CAAC,QAAQ,EAAE,OAAO,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EACnD,OAAO,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/C,IAAI,CAON;IAED,UAAU,CAAC,QAAQ,SAAS,OAAO,EAAE,OAAO,EAC1C,OAAO,EAAE,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,GAC9C,IAAI,CAEN;IAED,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE9B;IAED,GAAG,CAAC,QAAQ,SAAS,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACvD,UAAU,EAAE,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,GACnD,IAAI,CAEN;IAED,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAExC;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,OAAO,IAAI,IAAI,CAId;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF;AACD,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAExE"}

package/dist/messageBus/messageBusCore.js

@@ -0,0 +1,94 @@
+/**
+ * In-memory message bus implementation.
+ *
+ * @module messageBus/messageBusCore
+ */
+import { createMessage } from "../message/messageFactory.js";
+import { HandlerRegistryStore } from "../handlerRegistry/handlerRegistryStore.js";
+import { DefaultDispatcher } from "../dispatcher/dispatcherCore.js";
+import { MessageDispatchError } from "@latticejs/errors";
+/** Default in-memory message bus. */
+export class InMemoryMessageBus {
+    dispatcher;
+    registry;
+    defaultTimeout;
+    _disposed = false;
+    constructor(options = {}) {
+        this.registry = new HandlerRegistryStore({
+            allowDuplicateHandlerIds: options.allowDuplicateHandlers ?? false,
+            allowMultipleHandlers: options.allowMultipleHandlers ?? true,
+        });
+        this.dispatcher = new DefaultDispatcher(this.registry);
+        this.defaultTimeout = options.defaultTimeout ?? 0;
+        this.registerGlobalMiddleware(options.middleware);
+    }
+    registerGlobalMiddleware(middleware) {
+        if (middleware !== undefined) {
+            for (const mw of middleware)
+                this.dispatcher.use(mw);
+        }
+    }
+    async dispatch(message, options = {}) {
+        this.validateNotDisposed(message);
+        const timeout = options.timeout ?? this.defaultTimeout;
+        const dispatchOptions = { ...options, timeout };
+        if (timeout > 0) {
+            return this.dispatchWithTimeout(message, dispatchOptions);
+        }
+        return this.dispatcher.dispatch(message, dispatchOptions);
+    }
+    validateNotDisposed(message) {
+        if (this._disposed) {
+            throw new MessageDispatchError(message.type, "Message bus has been disposed.");
+        }
+    }
+    async dispatchWithTimeout(message, options) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), options.timeout ?? 0);
+        try {
+            const result = await this.dispatcher.dispatch(message, { ...options, signal: controller.signal });
+            return result;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async send(input, options = {}) {
+        return this.dispatch(createMessage(input), options);
+    }
+    on(messageType, handler, options = {}) {
+        const id = options.id ?? `handler:${messageType}:${Date.now()}`;
+        const namedHandler = {
+            id, name: id, handler, messageTypes: [messageType],
+            priority: options.priority ?? 100, enabled: true,
+        };
+        this.registry.register(namedHandler);
+    }
+    addHandler(handler) {
+        this.registry.register(handler);
+    }
+    off(handlerId) {
+        return this.registry.unregister(handlerId);
+    }
+    use(middleware) {
+        this.dispatcher.use(middleware);
+    }
+    hasHandlers(messageType) {
+        return this.registry.resolve(messageType).length > 0;
+    }
+    get handlerCount() {
+        return this.registry.size;
+    }
+    dispose() {
+        this._disposed = true;
+        this.registry.clear();
+        this.dispatcher.dispose();
+    }
+    get disposed() {
+        return this._disposed;
+    }
+}
+export function createMessageBus(options) {
+    return new InMemoryMessageBus(options);
+}
+//# sourceMappingURL=messageBusCore.js.map

package/dist/messageBus/messageBusCore.js.map

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

package/dist/messageBus/messageBusType.type.d.ts

@@ -0,0 +1,83 @@
+/**
+ * MessageBus type definitions for Lattice.
+ *
+ * The bus is the primary API surface for sending messages.
+ * It wraps the dispatcher with publish semantics.
+ *
+ * @module messageBus/messageBusType
+ */
+import type { Message, MessageInput } from "../message/messageType.type.js";
+import type { MessageHandler, NamedMessageHandler } from "../messageHandler/messageHandlerType.type.js";
+import type { MessageMiddlewareLike } from "../messageMiddleware/messageMiddlewareType.type.js";
+import type { DispatchResult, DispatchOptions } from "../dispatcher/dispatcherType.type.js";
+/**
+ * Options for creating a message bus.
+ */
+export interface MessageBusOptions {
+    /** Allow duplicate handler IDs. Default: false. */
+    readonly allowDuplicateHandlers?: boolean;
+    /** Allow multiple handlers per message type. Default: true. */
+    readonly allowMultipleHandlers?: boolean;
+    /** Global middleware. */
+    readonly middleware?: readonly MessageMiddlewareLike[];
+    /** Default timeout in ms. Default: 0 (no timeout). */
+    readonly defaultTimeout?: number;
+}
+/**
+ * Message bus interface.
+ *
+ * Provides a high-level API for dispatching messages and
+ * registering handlers.
+ */
+export interface MessageBus {
+    /**
+     * Dispatches a message to registered handlers.
+     *
+     * This is the primary method for sending messages.
+     * The message is validated, contextualized, and run through
+     * the middleware pipeline before being delivered to handlers.
+     */
+    dispatch<TPayload, TResult>(message: Message<TPayload>, options?: DispatchOptions<TResult>): Promise<DispatchResult<TResult>>;
+    /**
+     * Convenience method: creates and dispatches a message from input.
+     */
+    send<TPayload, TResult>(input: MessageInput<TPayload>, options?: DispatchOptions<TResult>): Promise<DispatchResult<TResult>>;
+    /**
+     * Registers a handler for a message type.
+     */
+    on<TPayload, TResult>(messageType: string, handler: MessageHandler<Message<TPayload>, TResult>, options?: {
+        id?: string;
+        priority?: number;
+    }): void;
+    /**
+     * Registers a named handler.
+     */
+    addHandler<TMessage extends Message, TResult>(handler: NamedMessageHandler<TMessage, TResult>): void;
+    /**
+     * Removes a handler by ID.
+     */
+    off(handlerId: string): boolean;
+    /**
+     * Adds middleware to the bus.
+     */
+    use<TMessage extends Message = Message, TResult = unknown>(middleware: MessageMiddlewareLike<TMessage, TResult>, options?: {
+        priority?: number;
+    }): void;
+    /**
+     * Checks if handlers are registered for a message type.
+     */
+    hasHandlers(messageType: string): boolean;
+    /**
+     * Returns the number of registered handlers.
+     */
+    readonly handlerCount: number;
+    /**
+     * Disposes the bus and releases resources.
+     */
+    dispose(): void;
+    /**
+     * Whether the bus has been disposed.
+     */
+    readonly disposed: boolean;
+}
+//# sourceMappingURL=messageBusType.type.d.ts.map

package/dist/messageBus/messageBusType.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageBusType.type.d.ts","sourceRoot":"","sources":["../../src/messageBus/messageBusType.type.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EAEb,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACpB,MAAM,8CAA8C,CAAC;AAEtD,OAAO,KAAK,EACV,qBAAqB,EACtB,MAAM,oDAAoD,CAAC;AAE5D,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAChB,MAAM,sCAAsC,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAE1C,+DAA+D;IAC/D,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEzC,yBAAyB;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAEvD,sDAAsD;IACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,EACxB,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,OAAO,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GACjC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAEpC;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,OAAO,EACpB,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC7B,OAAO,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GACjC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAEpC;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,OAAO,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EACnD,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI,CAAC;IAER;;OAEG;IACH,UAAU,CAAC,QAAQ,SAAS,OAAO,EAAE,OAAO,EAC1C,OAAO,EAAE,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,GAC9C,IAAI,CAAC;IAER;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAEhC;;OAEG;IACH,GAAG,CAAC,QAAQ,SAAS,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACvD,UAAU,EAAE,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,EACpD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9B,IAAI,CAAC;IAER;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B"}

package/dist/messageBus/messageBusType.type.js

@@ -0,0 +1,10 @@
+/**
+ * MessageBus type definitions for Lattice.
+ *
+ * The bus is the primary API surface for sending messages.
+ * It wraps the dispatcher with publish semantics.
+ *
+ * @module messageBus/messageBusType
+ */
+export {};
+//# sourceMappingURL=messageBusType.type.js.map

package/dist/messageBus/messageBusType.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageBusType.type.js","sourceRoot":"","sources":["../../src/messageBus/messageBusType.type.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/messageContext/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @oyinlola141/lattice-messaging/messageContext
+ *
+ * MessageContext type definitions and factory.
+ */
+export type { MessageContext, MessageContextOptions, } from "./messageContextType.type.js";
+export { createMessageContext } from "./messageContextType.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messageContext/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,cAAc,EACd,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/messageContext/index.js

@@ -0,0 +1,7 @@
+/**
+ * @latticejs/messaging/messageContext
+ *
+ * MessageContext type definitions and factory.
+ */
+export { createMessageContext } from "./messageContextType.type.js";
+//# sourceMappingURL=index.js.map

package/dist/messageContext/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messageContext/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/messageContext/messageContextType.type.d.ts

@@ -0,0 +1,52 @@
+/**
+ * MessageContext type definitions for Lattice.
+ *
+ * The context carries correlation and causation identifiers
+ * through the dispatch chain, enabling distributed tracing
+ * and message lineage.
+ *
+ * @module messageContext/messageContextType
+ */
+import type { Message, MessageCorrelationId, MessageCausationId } from "../message/messageType.type.js";
+/**
+ * Execution context attached to a message during dispatch.
+ *
+ * Carries correlation, causation, and arbitrary headers
+ * through the dispatch chain.
+ */
+export interface MessageContext {
+    /** The original message being dispatched. */
+    readonly message: Message;
+    /** Correlation identifier for the dispatch chain. */
+    readonly correlationId: MessageCorrelationId;
+    /** Causation identifier linking to the parent message. */
+    readonly causationId: MessageCausationId;
+    /** Optional headers carried through the pipeline. */
+    readonly headers: Readonly<Record<string, unknown>>;
+    /** AbortSignal for cancellation. */
+    readonly signal: AbortSignal;
+    /** Mutable state for middleware. */
+    readonly state: Map<string, unknown>;
+    /** When the dispatch started. */
+    readonly startedAt: Date;
+}
+/**
+ * Options for creating a message context.
+ */
+export interface MessageContextOptions {
+    /** Correlation identifier. Falls back to message ID. */
+    readonly correlationId?: MessageCorrelationId;
+    /** Causation identifier. Falls back to message ID. */
+    readonly causationId?: MessageCausationId;
+    /** Optional headers. */
+    readonly headers?: Readonly<Record<string, unknown>>;
+    /** Optional AbortSignal. */
+    readonly signal?: AbortSignal;
+    /** Optional mutable state. */
+    readonly state?: Map<string, unknown>;
+}
+/**
+ * Creates a message context from a message and options.
+ */
+export declare function createMessageContext(message: Message, options?: MessageContextOptions): MessageContext;
+//# sourceMappingURL=messageContextType.type.d.ts.map

package/dist/messageContext/messageContextType.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageContextType.type.d.ts","sourceRoot":"","sources":["../../src/messageContext/messageContextType.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,qDAAqD;IACrD,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAE7C,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IAEzC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEpD,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAE9C,sDAAsD;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAE1C,wBAAwB;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAErD,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAE9B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,qBAA0B,GAClC,cAAc,CAUhB"}

package/dist/messageContext/messageContextType.type.js

@@ -0,0 +1,24 @@
+/**
+ * MessageContext type definitions for Lattice.
+ *
+ * The context carries correlation and causation identifiers
+ * through the dispatch chain, enabling distributed tracing
+ * and message lineage.
+ *
+ * @module messageContext/messageContextType
+ */
+/**
+ * Creates a message context from a message and options.
+ */
+export function createMessageContext(message, options = {}) {
+    return Object.freeze({
+        message,
+        correlationId: options.correlationId ?? message.correlationId ?? message.id,
+        causationId: options.causationId ?? message.causationId ?? message.id,
+        headers: Object.freeze({ ...options.headers }),
+        signal: options.signal ?? new AbortController().signal,
+        state: options.state ?? new Map(),
+        startedAt: new Date(),
+    });
+}
+//# sourceMappingURL=messageContextType.type.js.map

package/dist/messageContext/messageContextType.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageContextType.type.js","sourceRoot":"","sources":["../../src/messageContext/messageContextType.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyDH;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,OAAO,GAA0B,EAAE;IAEnC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO;QACP,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,IAAK,OAAO,CAAC,EAAsC;QAChH,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,IAAK,OAAO,CAAC,EAAoC;QACxG,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAC9C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM;QACtD,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,GAAG,EAAmB;QAClD,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/messageHandler/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @oyinlola141/lattice-messaging/messageHandler
+ *
+ * MessageHandler type definitions and utilities.
+ */
+export type { HandlerResult, MessageHandler, NamedMessageHandler, MessageHandlerLike, MessageHandlerFactory, } from "./messageHandlerType.type.js";
+export { resolveMessageHandler } from "./messageHandlerType.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messageHandler/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/messageHandler/index.js

@@ -0,0 +1,7 @@
+/**
+ * @latticejs/messaging/messageHandler
+ *
+ * MessageHandler type definitions and utilities.
+ */
+export { resolveMessageHandler } from "./messageHandlerType.type.js";
+//# sourceMappingURL=index.js.map

package/dist/messageHandler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messageHandler/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/messageHandler/messageHandlerType.type.d.ts

@@ -0,0 +1,62 @@
+/**
+ * MessageHandler type definitions for Lattice.
+ *
+ * Handlers are the consumer side of the messaging system.
+ * They receive messages and produce results.
+ *
+ * @module messageHandler/messageHandlerType
+ */
+import type { Message } from "../message/messageType.type.js";
+import type { MessageContext } from "../messageContext/messageContextType.type.js";
+/**
+ * Result of handling a message.
+ *
+ * Handlers can return either a value directly or a structured
+ * result with metadata.
+ */
+export interface HandlerResult<TResult = unknown> {
+    /** The result value. */
+    readonly value: TResult;
+    /** Optional result metadata. */
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * A function that handles a message and returns a result.
+ *
+ * @typeParam TMessage - The message type to handle
+ * @typeParam TResult - The result type returned by the handler
+ */
+export type MessageHandler<TMessage extends Message = Message, TResult = unknown> = (message: TMessage, context: MessageContext) => Promise<TResult> | TResult;
+/**
+ * Message handler with metadata.
+ */
+export interface NamedMessageHandler<TMessage extends Message = Message, TResult = unknown> {
+    /** Unique handler identifier. */
+    readonly id: string;
+    /** Human-readable name for debugging. */
+    readonly name: string;
+    /** The handler function. */
+    readonly handler: MessageHandler<TMessage, TResult>;
+    /** Message types this handler processes. */
+    readonly messageTypes: readonly string[];
+    /** Execution priority (lower = earlier). Default: 100. */
+    readonly priority?: number;
+    /** Whether this handler is enabled. */
+    readonly enabled?: boolean;
+}
+/**
+ * A handler-like value: either a function or an object with a
+ * handle method.
+ */
+export type MessageHandlerLike<TMessage extends Message = Message, TResult = unknown> = MessageHandler<TMessage, TResult> | {
+    handle: MessageHandler<TMessage, TResult>;
+};
+/**
+ * Handler factory function.
+ */
+export type MessageHandlerFactory<TMessage extends Message = Message, TResult = unknown> = (options?: Record<string, unknown>) => NamedMessageHandler<TMessage, TResult>;
+/**
+ * Resolves a MessageHandlerLike to a plain MessageHandler function.
+ */
+export declare function resolveMessageHandler<TMessage extends Message = Message, TResult = unknown>(handler: MessageHandlerLike<TMessage, TResult>): MessageHandler<TMessage, TResult>;
+//# sourceMappingURL=messageHandlerType.type.d.ts.map

package/dist/messageHandler/messageHandlerType.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageHandlerType.type.d.ts","sourceRoot":"","sources":["../../src/messageHandler/messageHandlerType.type.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,OAAO,EAER,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EACV,cAAc,EACf,MAAM,8CAA8C,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,OAAO;IAC9C,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,CACxB,QAAQ,SAAS,OAAO,GAAG,OAAO,EAClC,OAAO,GAAG,OAAO,IACf,CACF,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAClC,QAAQ,SAAS,OAAO,GAAG,OAAO,EAClC,OAAO,GAAG,OAAO;IAEjB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEpD,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAEzC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAC5B,QAAQ,SAAS,OAAO,GAAG,OAAO,EAClC,OAAO,GAAG,OAAO,IAEf,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,GACjC;IAAE,MAAM,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAC/B,QAAQ,SAAS,OAAO,GAAG,OAAO,EAClC,OAAO,GAAG,OAAO,IACf,CACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAE5C;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,SAAS,OAAO,GAAG,OAAO,EAClC,OAAO,GAAG,OAAO,EAEjB,OAAO,EAAE,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,GAC7C,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAKnC"}

package/dist/messageHandler/messageHandlerType.type.js

@@ -0,0 +1,18 @@
+/**
+ * MessageHandler type definitions for Lattice.
+ *
+ * Handlers are the consumer side of the messaging system.
+ * They receive messages and produce results.
+ *
+ * @module messageHandler/messageHandlerType
+ */
+/**
+ * Resolves a MessageHandlerLike to a plain MessageHandler function.
+ */
+export function resolveMessageHandler(handler) {
+    if (typeof handler === "function") {
+        return handler;
+    }
+    return handler.handle;
+}
+//# sourceMappingURL=messageHandlerType.type.js.map

package/dist/messageHandler/messageHandlerType.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageHandlerType.type.js","sourceRoot":"","sources":["../../src/messageHandler/messageHandlerType.type.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsFH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAInC,OAA8C;IAE9C,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC"}

package/dist/messageMiddleware/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @oyinlola141/lattice-messaging/messageMiddleware
+ *
+ * Message middleware type definitions and pipeline execution.
+ */
+export type { MessageMiddlewareContext, MessageMiddlewareNext, MessageMiddleware, MessageMiddlewareObject, MessageMiddlewareLike, MessageMiddlewareOptions, RegisteredMessageMiddleware, MessageMiddlewareExecution, MessageMiddlewarePipelineResult, MessageMiddlewarePipelineOptions, } from "./messageMiddlewareType.type.js";
+export { runMessagePipeline } from "./messageMiddlewarePipeline.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messageMiddleware/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,+BAA+B,EAC/B,gCAAgC,GACjC,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/messageMiddleware/index.js

@@ -0,0 +1,7 @@
+/**
+ * @latticejs/messaging/messageMiddleware
+ *
+ * Message middleware type definitions and pipeline execution.
+ */
+export { runMessagePipeline } from "./messageMiddlewarePipeline.js";
+//# sourceMappingURL=index.js.map

package/dist/messageMiddleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messageMiddleware/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/messageMiddleware/messageMiddlewarePipeline.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Message middleware composition and pipeline execution.
+ *
+ * @module messageMiddleware/messageMiddlewarePipeline
+ */
+import type { MessageMiddlewareLike, MessageMiddlewareContext, MessageMiddlewarePipelineResult, MessageMiddlewarePipelineOptions } from "./messageMiddlewareType.type.js";
+import type { Message } from "../message/messageType.type.js";
+/**
+ * Runs a handler through a middleware pipeline and returns the
+ * result with execution metadata.
+ */
+export declare function runMessagePipeline<TResult>(middlewareList: readonly MessageMiddlewareLike<Message, TResult>[], handler: (message: Message, context: MessageMiddlewareContext<Message>) => Promise<TResult>, message: Message, options?: MessageMiddlewarePipelineOptions): Promise<MessageMiddlewarePipelineResult<TResult>>;
+//# sourceMappingURL=messageMiddlewarePipeline.d.ts.map

package/dist/messageMiddleware/messageMiddlewarePipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageMiddlewarePipeline.d.ts","sourceRoot":"","sources":["../../src/messageMiddleware/messageMiddlewarePipeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAEV,qBAAqB,EAErB,wBAAwB,EACxB,+BAA+B,EAC/B,gCAAgC,EAEjC,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EACV,OAAO,EAGR,MAAM,gCAAgC,CAAC;AAgDxC;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAC9C,cAAc,EAAE,SAAS,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAClE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,EAC3F,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,+BAA+B,CAAC,OAAO,CAAC,CAAC,CA6DnD"}