@zudojs/messaging 1.0.1 → 1.1.0

package/README.md

@@ -2,6 +2,12 @@
 
 In-process message bus infrastructure with handlers, middleware, and publish/subscribe patterns.
 
+<!-- zudo-docs:start -->
+
+**Documentation:** [zudojs.oyinlola.site/docs/packages-messaging](https://zudojs.oyinlola.site/docs/packages-messaging) · **For AI agents:** [Markdown version](https://zudojs.oyinlola.site/docs/packages-messaging.md), [llms.txt](https://zudojs.oyinlola.site/llms.txt)
+
+<!-- zudo-docs:end -->
+
 ## Installation
 
 ```bash

package/dist/dispatcher/dispatcherCore.js

@@ -4,6 +4,7 @@
  * @module dispatcher/dispatcherCore
  */
 import { createMessageContext } from "../messageContext/messageContextType.type.js";
+import { resolveMessageHandler } from "../messageHandler/messageHandlerType.type.js";
 import { HandlerRegistryStore } from "../handlerRegistry/handlerRegistryStore.js";
 import { runMessagePipeline } from "../messageMiddleware/messageMiddlewarePipeline.js";
 import { MessageDispatchAbortedError, MessageHandlerError, MessageMiddlewareError, MessageTimeoutError, MessageBusDisposedError, } from "@zudojs/errors";
@@ -80,7 +81,11 @@ export class DefaultDispatcher {
                 value: pipelineResult.result,
                 message,
                 context,
-                handlerResults,
+                // A copy, not the live array: on a timeout the dispatch settles
+                // while a handler is still running, and that handler later pushed
+                // a `success: true` record into the result the caller was already
+                // holding for a dispatch that had failed.
+                handlerResults: [...handlerResults],
                 middlewareResult: pipelineResult,
                 duration: performance.now() - dispatchStart,
             };
@@ -91,7 +96,7 @@ export class DefaultDispatcher {
                 error: error instanceof Error ? error : new Error(String(error)),
                 message,
                 context,
-                handlerResults,
+                handlerResults: [...handlerResults],
                 duration: performance.now() - dispatchStart,
             };
         }
@@ -190,7 +195,11 @@ export class DefaultDispatcher {
     }
     async executeHandler(handler, message, context) {
         try {
-            return await handler.handler(message, context);
+            // Handlers may be a plain function or an object with a `handle`
+            // method. Calling `handler.handler(...)` directly made the object
+            // form crash on every dispatch, so it goes through the same
+            // normaliser the public type advertises.
+            return await resolveMessageHandler(handler.handler)(message, context);
         }
         catch (error) {
             throw new MessageHandlerError(`Handler "${handler.id}" failed: ${error instanceof Error ? error.message : String(error)}`, {

package/dist/dispatcher/dispatcherType.type.d.ts

@@ -9,6 +9,7 @@
 import type { Message } from "../message/messageType.type.js";
 import type { MessageContext, MessageContextOptions } from "../messageContext/messageContextType.type.js";
 import type { MessageMiddlewareLike, MessageMiddlewareOptions, MessageMiddlewarePipelineResult } from "../messageMiddleware/messageMiddlewareType.type.js";
+import type { HandlerRegistryStore } from "../handlerRegistry/handlerRegistryStore.js";
 /**
  * Result of dispatching a message.
  */
@@ -90,5 +91,18 @@ export interface Dispatcher {
      * @returns Whether a registration was removed.
      */
     removeMiddleware(middlewareId: string): boolean;
+    /**
+     * The ids of every registered global middleware, in the order they run.
+     */
+    listMiddleware(): readonly string[];
+    /**
+     * The handler registry this dispatcher resolves handlers from.
+     */
+    getRegistry(): HandlerRegistryStore;
+    /**
+     * Releases the dispatcher: drops all middleware and rejects any further
+     * dispatch with `MessageBusDisposedError`.
+     */
+    dispose(): void;
 }
 //# sourceMappingURL=dispatcherType.type.d.ts.map

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

@@ -35,8 +35,13 @@ export interface NamedMessageHandler<TMessage extends Message = Message, TResult
     readonly id: string;
     /** Human-readable name for debugging. */
     readonly name: string;
-    /** The handler function. */
-    readonly handler: MessageHandler<TMessage, TResult>;
+    /**
+     * The handler itself: a function, or an object with a `handle` method.
+     *
+     * The dispatcher normalises both forms through
+     * {@link resolveMessageHandler} before invoking them.
+     */
+    readonly handler: MessageHandlerLike<TMessage, TResult>;
     /** Message types this handler processes. */
     readonly messageTypes: readonly string[];
     /** Execution priority (lower = earlier). Default: 100. */

package/dist/messageHandler/messageHandlerType.type.js

@@ -13,6 +13,6 @@ export function resolveMessageHandler(handler) {
     if (typeof handler === "function") {
         return handler;
     }
-    return handler.handle;
+    return handler.handle.bind(handler);
 }
 //# sourceMappingURL=messageHandlerType.type.js.map

package/dist/messageMiddleware/messageMiddlewarePipeline.js

@@ -3,32 +3,7 @@
  *
  * @module messageMiddleware/messageMiddlewarePipeline
  */
-/**
- * Compose an array of middleware into a single function.
- *
- * The returned function executes middleware in order.
- * If no middleware is provided, the handler is called directly.
- */
-function compose(middlewareList, handler) {
-    if (middlewareList.length === 0) {
-        return handler;
-    }
-    return async (context) => {
-        let index = -1;
-        async function dispatch(i) {
-            if (i <= index) {
-                throw new Error("next() called multiple times");
-            }
-            index = i;
-            if (i < middlewareList.length) {
-                const mw = middlewareList[i];
-                return mw(context, () => dispatch(i + 1));
-            }
-            return handler(context);
-        }
-        return dispatch(0);
-    };
-}
+import { compose } from "@zudojs/middleware";
 /**
  * Resolves a MessageMiddlewareLike to a plain MessageMiddleware function.
  */
@@ -36,7 +11,7 @@ function resolveMiddlewareLike(mw) {
     if (typeof mw === "function") {
         return mw;
     }
-    return mw.handle;
+    return mw.handle.bind(mw);
 }
 /**
  * Runs a handler through a middleware pipeline and returns the
@@ -78,7 +53,8 @@ export async function runMessagePipeline(middlewareList, handler, message, optio
         };
     });
     const pipelineStart = performance.now();
-    const composed = compose(resolvedMiddleware, async (ctx) => handler(message, ctx));
+    // Unbounded depth: the list length is fixed by the registered middleware.
+    const composed = compose(resolvedMiddleware, async (ctx) => handler(message, ctx), { maxDepth: Number.POSITIVE_INFINITY });
     const context = {
         message,
         context: options.context ?? {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudojs/messaging",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "In-process message bus infrastructure with handlers, middleware, and publish/subscribe patterns.",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,8 +19,9 @@
     "!dist/.tsbuildinfo"
   ],
   "dependencies": {
-    "@zudojs/errors": "1.0.1",
-    "@zudojs/constants": "1.0.1"
+    "@zudojs/constants": "1.1.1",
+    "@zudojs/errors": "1.2.0",
+    "@zudojs/middleware": "1.0.3"
   },
   "engines": {
     "node": ">=24.0.0"