actor-ts 0.9.0 → 0.10.0

package/dist/runtime/http/DenoHonoRunner.js

@@ -3,7 +3,8 @@
  * Returns a `HttpServer` with `.shutdown()` for graceful stop and
  * `.unref()` + `AbortController` for hard stop.
  *
- * Requires `--allow-net` to bind the listener.
+ * Requires `--allow-net` to bind the listener.  WebSocket support uses
+ * `upgradeWebSocket` from `hono/deno` (which wraps `Deno.upgradeWebSocket`).
  */
 export class DenoHonoRunner {
     async serve(opts) {
@@ -12,7 +13,7 @@ export class DenoHonoRunner {
             throw new Error('DenoHonoRunner requires Deno runtime (globalThis.Deno.serve).');
         }
         const ac = new AbortController();
-        const server = deno.serve({ hostname: opts.host, port: opts.port, signal: ac.signal }, opts.fetch);
+        const server = deno.serve({ hostname: opts.host, port: opts.port, signal: ac.signal, ...(opts.serveOptions ?? {}) }, opts.fetch);
         return {
             host: opts.host,
             port: opts.port,
@@ -29,5 +30,21 @@ export class DenoHonoRunner {
             },
         };
     }
+    async webSocket(_app) {
+        let mod;
+        try {
+            const name = 'hono/deno';
+            mod = (await import(name));
+        }
+        catch (e) {
+            throw new Error('websocket() routes on the Hono backend (Deno) require "hono".  '
+                + 'Install it with: deno add npm:hono\nOriginal error: '
+                + (e instanceof Error ? e.message : String(e)));
+        }
+        return {
+            upgradeWebSocket: mod.upgradeWebSocket,
+            serveOptions: {},
+        };
+    }
 }
 //# sourceMappingURL=DenoHonoRunner.js.map

package/dist/runtime/http/DenoHonoRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"DenoHonoRunner.js","sourceRoot":"","sources":["../../../src/runtime/http/DenoHonoRunner.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,KAAK,CAAC,IAAyD;QACnE,MAAM,IAAI,GAAI,UAAoC,CAAC,IAAI,CAAC;QACxD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACnG,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,CAAC,IAAI,CAAC,QAAiB;gBAC1B,IAAI,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;oBACtD,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACxB,OAAO;gBACT,CAAC;gBACD,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,IAAI,CAAC;oBAAC,MAAM,MAAM,CAAC,QAAQ,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACvD,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"DenoHonoRunner.js","sourceRoot":"","sources":["../../../src/runtime/http/DenoHonoRunner.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,KAAK,CAAC,IAAgF;QAC1F,MAAM,IAAI,GAAI,UAAoC,CAAC,IAAI,CAAC;QACxD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjI,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,CAAC,IAAI,CAAC,QAAiB;gBAC1B,IAAI,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;oBACtD,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACxB,OAAO;gBACT,CAAC;gBACD,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,IAAI,CAAC;oBAAC,MAAM,MAAM,CAAC,QAAQ,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACvD,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAa;QAC3B,IAAI,GAAkC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,WAAW,CAAC;YACzB,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAe,CAAC;QAC3C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,iEAAiE;kBAC7D,sDAAsD;kBACtD,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACjD,CAAC;QACJ,CAAC;QACD,OAAO;YACL,gBAAgB,EAAE,GAAG,CAAC,gBAA2D;YACjF,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;CACF"}

package/dist/runtime/http/HonoServerRunner.d.ts

@@ -16,13 +16,52 @@ export type FetchHandler = (request: Request) => Promise<Response> | Response;
 export interface HonoServerHandle {
     readonly host: string;
     readonly port: number;
+    /** Underlying native server (e.g. the node:http Server on Node) — used by
+     *  `@hono/node-ws`'s `injectWebSocket`.  Absent on Bun/Deno. */
+    readonly raw?: unknown;
     stop(graceful: boolean): Promise<void>;
 }
+/** Hono's per-runtime WSContext (the socket handed to the event callbacks). */
+export interface WSContextLike {
+    send(data: string | ArrayBuffer | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+    readonly readyState: number;
+    readonly protocol?: string;
+    readonly raw?: unknown;
+}
+/** The events object a Hono `upgradeWebSocket` factory returns. */
+export interface WSEventsLike {
+    onOpen?(evt: unknown, ws: WSContextLike): void;
+    onMessage?(evt: {
+        data: unknown;
+    }, ws: WSContextLike): void;
+    onClose?(evt: {
+        code?: number;
+        reason?: string;
+    }, ws: WSContextLike): void;
+    onError?(evt: unknown, ws: WSContextLike): void;
+}
+/** Hono `upgradeWebSocket` middleware factory. */
+export type UpgradeWebSocketFn = (createEvents: (c: unknown) => WSEventsLike) => unknown;
+/**
+ * Per-runtime WebSocket bridge.  `upgradeWebSocket` is Hono's middleware
+ * factory; `serveOptions` are extra options folded into `serve()` (Bun
+ * needs `{ websocket }`); `attach` runs post-listen wiring (Node needs
+ * `injectWebSocket(server)`).
+ */
+export interface HonoWebSocketBridge {
+    readonly upgradeWebSocket: UpgradeWebSocketFn;
+    readonly serveOptions: object;
+    readonly attach?: (handle: HonoServerHandle) => void;
+}
 export interface HonoServerRunner {
     serve(opts: {
         host: string;
         port: number;
         fetch: FetchHandler;
+        serveOptions?: object;
     }): Promise<HonoServerHandle>;
+    /** Optional capability — all three built-in runners implement it. */
+    webSocket?(app: unknown): Promise<HonoWebSocketBridge>;
 }
 //# sourceMappingURL=HonoServerRunner.d.ts.map

package/dist/runtime/http/HonoServerRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HonoServerRunner.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/HonoServerRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC7F"}
+{"version":3,"file":"HonoServerRunner.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/HonoServerRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;oEACgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/C,SAAS,CAAC,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5D,OAAO,CAAC,CAAC,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3E,OAAO,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAAC;CACjD;AAED,kDAAkD;AAClD,MAAM,MAAM,kBAAkB,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,YAAY,KAAK,OAAO,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnH,qEAAqE;IACrE,SAAS,CAAC,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACxD"}

package/dist/runtime/http/NodeHonoRunner.d.ts

@@ -1,4 +1,4 @@
-import type { FetchHandler, HonoServerHandle, HonoServerRunner } from './HonoServerRunner.js';
+import type { FetchHandler, HonoServerHandle, HonoServerRunner, HonoWebSocketBridge } from './HonoServerRunner.js';
 /**
  * Node.js implementation — `@hono/node-server`'s `serve()`, which wraps a
  * `node:http` server around a standard fetch handler.  Graceful stop calls
@@ -14,6 +14,8 @@ export declare class NodeHonoRunner implements HonoServerRunner {
         host: string;
         port: number;
         fetch: FetchHandler;
+        serveOptions?: object;
     }): Promise<HonoServerHandle>;
+    webSocket(app: unknown): Promise<HonoWebSocketBridge>;
 }
 //# sourceMappingURL=NodeHonoRunner.d.ts.map

package/dist/runtime/http/NodeHonoRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeHonoRunner.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/NodeHonoRunner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9F;;;;;;;;;GASG;AACH,qBAAa,cAAe,YAAW,gBAAgB;IAC/C,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA0ClG"}
+{"version":3,"file":"NodeHonoRunner.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/NodeHonoRunner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;GASG;AACH,qBAAa,cAAe,YAAW,gBAAgB;IAC/C,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4ClH,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA0B5D"}

package/dist/runtime/http/NodeHonoRunner.js

@@ -33,6 +33,7 @@ export class NodeHonoRunner {
         return {
             host: opts.host,
             port: actualPort,
+            raw: server,
             stop(graceful) {
                 return new Promise((resolve) => {
                     const timer = !graceful
@@ -50,6 +51,27 @@ export class NodeHonoRunner {
             },
         };
     }
+    async webSocket(app) {
+        let mod;
+        try {
+            const name = '@hono/node-ws';
+            mod = (await import(name));
+        }
+        catch (e) {
+            throw new Error('websocket() routes on the Hono backend (Node) require "@hono/node-ws".  '
+                + 'Install it with: npm install @hono/node-ws\nOriginal error: '
+                + (e instanceof Error ? e.message : String(e)));
+        }
+        const { upgradeWebSocket, injectWebSocket } = mod.createNodeWebSocket({ app });
+        return {
+            upgradeWebSocket: upgradeWebSocket,
+            serveOptions: {},
+            attach: (handle) => {
+                if (handle.raw)
+                    injectWebSocket(handle.raw);
+            },
+        };
+    }
 }
 // The Lazy caches the Promise itself — concurrent callers share the
 // in-flight import.  A failure is cached too, so the "install the peer

package/dist/runtime/http/NodeHonoRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeHonoRunner.js","sourceRoot":"","sources":["../../../src/runtime/http/NodeHonoRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAG1C;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,KAAK,CAAC,IAAyD;QACnE,MAAM,GAAG,GAAG,MAAM,kBAAkB,EAAE,CAAC;QAEvC,oEAAoE;QACpE,4DAA4D;QAC5D,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnE,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;oBAClB,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,IAAI,CAAC,KAAK;iBAClB,EAAE,CAAC,IAAI,EAAE,EAAE;oBACV,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAA8B,CAAC,CAAC;gBAC1E,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,CAAU,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAChC,MAAM,UAAU,GACd,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAEpE,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,UAAU;YAChB,IAAI,CAAC,QAAiB;gBACpB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBACnC,MAAM,KAAK,GAAG,CAAC,QAAQ;wBACrB,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;4BACd,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC;4BAC/B,OAAO,EAAE,CAAC;wBACZ,CAAC,EAAE,CAAC,CAAC;wBACP,CAAC,CAAC,IAAI,CAAC;oBACT,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;wBAChB,IAAI,KAAK;4BAAE,YAAY,CAAC,KAAK,CAAC,CAAC;wBAC/B,OAAO,EAAE,CAAC;oBACZ,CAAC,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAiBD,oEAAoE;AACpE,uEAAuE;AACvE,mEAAmE;AACnE,wBAAwB;AACxB,MAAM,cAAc,GAAwC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;IAC7E,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,mBAAmB,CAAC;QACjC,OAAO,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAoC,CAAC;IACjE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,6EAA6E;cAC3E,iDAAiD;cACjD,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAC/C,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,SAAS,kBAAkB,KAAoC,OAAO,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"NodeHonoRunner.js","sourceRoot":"","sources":["../../../src/runtime/http/NodeHonoRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAQ1C;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,KAAK,CAAC,IAAgF;QAC1F,MAAM,GAAG,GAAG,MAAM,kBAAkB,EAAE,CAAC;QAEvC,oEAAoE;QACpE,4DAA4D;QAC5D,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnE,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;oBAClB,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,IAAI,CAAC,KAAK;iBAClB,EAAE,CAAC,IAAI,EAAE,EAAE;oBACV,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAA8B,CAAC,CAAC;gBAC1E,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,CAAU,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAChC,MAAM,UAAU,GACd,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAEpE,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,UAAU;YAChB,GAAG,EAAE,MAAM;YACX,IAAI,CAAC,QAAiB;gBACpB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBACnC,MAAM,KAAK,GAAG,CAAC,QAAQ;wBACrB,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;4BACd,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC;4BAC/B,OAAO,EAAE,CAAC;wBACZ,CAAC,EAAE,CAAC,CAAC;wBACP,CAAC,CAAC,IAAI,CAAC;oBACT,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;wBAChB,IAAI,KAAK;4BAAE,YAAY,CAAC,KAAK,CAAC,CAAC;wBAC/B,OAAO,EAAE,CAAC;oBACZ,CAAC,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAY;QAC1B,IAAI,GAKH,CAAC;QACF,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,eAAe,CAAC;YAC7B,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAe,CAAC;QAC3C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,0EAA0E;kBACtE,8DAA8D;kBAC9D,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACjD,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,GAAG,GAAG,CAAC,mBAAmB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/E,OAAO;YACL,gBAAgB,EAAE,gBAA2D;YAC7E,YAAY,EAAE,EAAE;YAChB,MAAM,EAAE,CAAC,MAAwB,EAAE,EAAE;gBACnC,IAAI,MAAM,CAAC,GAAG;oBAAE,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAiBD,oEAAoE;AACpE,uEAAuE;AACvE,mEAAmE;AACnE,wBAAwB;AACxB,MAAM,cAAc,GAAwC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;IAC7E,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,mBAAmB,CAAC;QACjC,OAAO,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAoC,CAAC;IACjE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,6EAA6E;cAC3E,iDAAiD;cACjD,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAC/C,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,SAAS,kBAAkB,KAAoC,OAAO,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC"}

package/dist/runtime/http/index.d.ts

@@ -1,5 +1,5 @@
 import type { HonoServerRunner } from './HonoServerRunner.js';
-export type { FetchHandler, HonoServerHandle, HonoServerRunner } from './HonoServerRunner.js';
+export type { FetchHandler, HonoServerHandle, HonoServerRunner, HonoWebSocketBridge, UpgradeWebSocketFn, WSContextLike, WSEventsLike, } from './HonoServerRunner.js';
 export { BunHonoRunner } from './BunHonoRunner.js';
 export { NodeHonoRunner } from './NodeHonoRunner.js';
 export { DenoHonoRunner } from './DenoHonoRunner.js';

package/dist/runtime/http/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAsB/D;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,YAAY,GACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAsB/D;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C"}

package/dist/runtime/http/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,MAAM,cAAc,CAAC;AAI/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,IAAI,MAAM,GAA4B,IAAI,CAAC;AAC3C,IAAI,SAAS,GAAuB,IAAI,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,IAAI,MAAM,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC;IACnD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC7D,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAC7B,MAAM;QACR,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YAC/D,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YAC9B,MAAM;QACR,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YAC/D,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YAC9B,MAAM;QACR,CAAC;IACH,CAAC;IACD,SAAS,GAAG,OAAO,CAAC;IACpB,OAAO,MAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,IAAI,CAAC;IACd,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,MAAM,cAAc,CAAC;AAY/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,IAAI,MAAM,GAA4B,IAAI,CAAC;AAC3C,IAAI,SAAS,GAAuB,IAAI,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,IAAI,MAAM,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC;IACnD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC7D,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAC7B,MAAM;QACR,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YAC/D,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YAC9B,MAAM;QACR,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YAC/D,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YAC9B,MAAM;QACR,CAAC;IACH,CAAC;IACD,SAAS,GAAG,OAAO,CAAC;IACpB,OAAO,MAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,IAAI,CAAC;IACd,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC"}

package/dist/testkit/ManualScheduler.d.ts

@@ -2,7 +2,8 @@ import type { ActorRef } from '../ActorRef.js';
 import { Scheduler, type Cancellable } from '../Scheduler.js';
 /**
  * Scheduler implementation driven entirely by `advance(ms)` — the wall
- * clock is ignored.  Swap this into `ActorSystem.create(name, { scheduler })`
+ * clock is ignored.  Swap this into
+ * `ActorSystem.create(name, ActorSystemOptions.create().withScheduler(scheduler))`
  * in tests to get deterministic timer behaviour.
  */
 export declare class ManualScheduler extends Scheduler {

package/dist/testkit/ManualScheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ManualScheduler.d.ts","sourceRoot":"","sources":["../../src/testkit/ManualScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAW9D;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAS;IAIf,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,WAAW;IAI5D,YAAY,CAAC,CAAC,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,CAAC,EACV,MAAM,GAAE,QAAQ,GAAG,IAAW,GAC7B,WAAW;IAOL,qBAAqB,CAC5B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,IAAI,GACb,WAAW;IAQL,mBAAmB,CAAC,CAAC,EAC5B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,CAAC,EACV,MAAM,GAAE,QAAQ,GAAG,IAAW,GAC7B,WAAW;IAQL,QAAQ,IAAI,IAAI;IAOzB,2EAA2E;IAC3E,GAAG,IAAI,MAAM;IAEb,+CAA+C;IAC/C,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAsBzB,6EAA6E;IAC7E,aAAa,IAAI,IAAI;IAOrB,OAAO,CAAC,GAAG;IAgBX,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,cAAc;CAGvB"}
+{"version":3,"file":"ManualScheduler.d.ts","sourceRoot":"","sources":["../../src/testkit/ManualScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAW9D;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAS;IAIf,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,WAAW;IAI5D,YAAY,CAAC,CAAC,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,CAAC,EACV,MAAM,GAAE,QAAQ,GAAG,IAAW,GAC7B,WAAW;IAOL,qBAAqB,CAC5B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,IAAI,GACb,WAAW;IAQL,mBAAmB,CAAC,CAAC,EAC5B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,CAAC,EACV,MAAM,GAAE,QAAQ,GAAG,IAAW,GAC7B,WAAW;IAQL,QAAQ,IAAI,IAAI;IAOzB,2EAA2E;IAC3E,GAAG,IAAI,MAAM;IAEb,+CAA+C;IAC/C,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAsBzB,6EAA6E;IAC7E,aAAa,IAAI,IAAI;IAOrB,OAAO,CAAC,GAAG;IAgBX,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,cAAc;CAGvB"}

package/dist/testkit/ManualScheduler.js

@@ -1,7 +1,8 @@
 import { Scheduler } from '../Scheduler.js';
 /**
  * Scheduler implementation driven entirely by `advance(ms)` — the wall
- * clock is ignored.  Swap this into `ActorSystem.create(name, { scheduler })`
+ * clock is ignored.  Swap this into
+ * `ActorSystem.create(name, ActorSystemOptions.create().withScheduler(scheduler))`
  * in tests to get deterministic timer behaviour.
  */
 export class ManualScheduler extends Scheduler {

package/dist/testkit/ManualScheduler.js.map

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

package/dist/testkit/MockCluster.d.ts

@@ -0,0 +1,74 @@
+import type { ActorRef } from '../ActorRef.js';
+import { Member } from '../cluster/Member.js';
+import { NodeAddress } from '../cluster/NodeAddress.js';
+import type { MemberStatus } from '../cluster/Protocol.js';
+import { type ClusterEvent } from '../cluster/ClusterEvents.js';
+import { type Option } from '../util/Option.js';
+/**
+ * Tiny in-memory mock of the {@link Cluster} read surface — for unit
+ * tests that only care about membership events and don't want to
+ * spin up a real ActorSystem + Transport.
+ *
+ * What it provides:
+ *   - `subscribe(listener)` — same shape as `Cluster.subscribe`; the
+ *     mock replays the current view as `MemberUp` events on first
+ *     subscribe, then emits events imperatively via the test helper
+ *     methods.
+ *   - `getMembers()` / `upMembers()` / `getMembersByStatus()` —
+ *     same accessor shape as the real Cluster.
+ *   - `selfAddress` — fixed at construction time.
+ *
+ * What it deliberately does NOT do:
+ *   - No Transport — `tell` / `send` paths aren't simulated.  Use
+ *     the in-memory MultiNodeSpec if you need real message flow.
+ *   - No gossip — events fire when the test driver calls them.
+ *   - No failure detection — `markUnreachable()` flips status
+ *     synchronously.
+ *
+ * Use for: testing code that subscribes to cluster events
+ * (Receptionist, Sharding, DowningProvider impls) without paying
+ * the spin-up cost of a real Cluster instance.
+ */
+export interface MockClusterSettings {
+    /** Self address — what `selfAddress` returns. */
+    readonly selfAddress: NodeAddress;
+    /** Initial members.  Self is added automatically if not present. */
+    readonly initialMembers?: ReadonlyArray<Member>;
+    /** Initial leader.  Defaults to the lowest address. */
+    readonly initialLeader?: Option<Member>;
+}
+export declare class MockCluster {
+    readonly selfAddress: NodeAddress;
+    private readonly members;
+    private leader;
+    private readonly listeners;
+    constructor(settings: MockClusterSettings);
+    /** Match the Cluster API: replays current state on subscribe. */
+    subscribe(listener: (event: ClusterEvent) => void): () => void;
+    getMembers(): ReadonlyArray<Member>;
+    upMembers(): Member[];
+    getMembersByStatus(status: MemberStatus): Member[];
+    getLeader(): Option<Member>;
+    /** Add a fresh peer in `joining` state and fire `MemberJoined`. */
+    addMember(address: NodeAddress, roles?: ReadonlyArray<string>): Member;
+    /** Transition a member to `up` and fire `MemberUp` (+ LeaderChanged if it changes). */
+    upMember(address: NodeAddress): Member;
+    /** Mark a member as unreachable; fires `MemberUnreachable`. */
+    markUnreachable(address: NodeAddress): Member;
+    markReachable(address: NodeAddress): Member;
+    /** Force a member down (DowningProvider triggered).  Fires `MemberDown`. */
+    downMember(address: NodeAddress): Member;
+    /** Graceful leave path — fires `MemberLeft` then `MemberRemoved`. */
+    leaveMember(address: NodeAddress): Member;
+    /** Move the leader to a specific member.  Fires `LeaderChanged`. */
+    setLeader(addr: NodeAddress | null): void;
+    /** Snapshot of registered listeners — for test introspection. */
+    get listenerCount(): number;
+    private emit;
+    private requireMember;
+    private computeLeader;
+    private maybeLeaderChange;
+    /** Compatibility with code that calls `cluster.actorRefForMember(m)` — not implemented. */
+    actorRefForMember(_member: Member): ActorRef<unknown> | null;
+}
+//# sourceMappingURL=MockCluster.d.ts.map

package/dist/testkit/MockCluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockCluster.d.ts","sourceRoot":"","sources":["../../src/testkit/MockCluster.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,oEAAoE;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,uDAAuD;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;CACzC;AAED,qBAAa,WAAW;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;gBAEtD,QAAQ,EAAE,mBAAmB;IAWzC,iEAAiE;IACjE,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI;IAmB9D,UAAU,IAAI,aAAa,CAAC,MAAM,CAAC;IAInC,SAAS,IAAI,MAAM,EAAE;IAMrB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE;IAIlD,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC;IAI3B,mEAAmE;IACnE,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,GAAE,aAAa,CAAC,MAAM,CAAM,GAAG,MAAM;IAO1E,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM;IAStC,+DAA+D;IAC/D,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM;IAU7C,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM;IAM3C,4EAA4E;IAC5E,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM;IAQxC,qEAAqE;IACrE,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM;IAezC,oEAAoE;IACpE,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAUzC,iEAAiE;IACjE,IAAI,aAAa,IAAI,MAAM,CAAkC;IAI7D,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,iBAAiB;IAazB,2FAA2F;IAC3F,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI;CAG7D"}

package/dist/testkit/MockCluster.js

@@ -0,0 +1,163 @@
+import { Member } from '../cluster/Member.js';
+import { LeaderChanged, MemberDown, MemberJoined, MemberLeft, MemberReachable, MemberRemoved, MemberUnreachable, MemberUp, SelfRemoved, SelfUp, } from '../cluster/ClusterEvents.js';
+import { none, some } from '../util/Option.js';
+export class MockCluster {
+    selfAddress;
+    members = new Map();
+    leader;
+    listeners = [];
+    constructor(settings) {
+        this.selfAddress = settings.selfAddress;
+        // Self always present.
+        const selfMember = new Member(settings.selfAddress, 'up', 1, []);
+        this.members.set(settings.selfAddress.toString(), selfMember);
+        for (const m of settings.initialMembers ?? []) {
+            this.members.set(m.address.toString(), m);
+        }
+        this.leader = settings.initialLeader ?? this.computeLeader();
+    }
+    /** Match the Cluster API: replays current state on subscribe. */
+    subscribe(listener) {
+        for (const m of this.members.values()) {
+            if (m.status === 'up') {
+                try {
+                    listener(new MemberUp(m));
+                }
+                catch { /* ignore */ }
+            }
+        }
+        if (this.members.get(this.selfAddress.toString())?.status === 'up') {
+            try {
+                listener(new SelfUp(this.members.get(this.selfAddress.toString())));
+            }
+            catch { /* ignore */ }
+        }
+        this.leader.forEach((l) => {
+            try {
+                listener(new LeaderChanged(some(l)));
+            }
+            catch { /* ignore */ }
+        });
+        this.listeners.push(listener);
+        return () => {
+            const i = this.listeners.indexOf(listener);
+            if (i >= 0)
+                this.listeners.splice(i, 1);
+        };
+    }
+    getMembers() {
+        return Array.from(this.members.values()).filter((m) => m.status !== 'removed');
+    }
+    upMembers() {
+        return Array.from(this.members.values())
+            .filter((m) => m.status === 'up')
+            .sort((a, b) => a.address.compareTo(b.address));
+    }
+    getMembersByStatus(status) {
+        return Array.from(this.members.values()).filter((m) => m.status === status);
+    }
+    getLeader() { return this.leader; }
+    /* ------------------------------ Test driver ------------------------------ */
+    /** Add a fresh peer in `joining` state and fire `MemberJoined`. */
+    addMember(address, roles = []) {
+        const m = new Member(address, 'joining', 1, roles);
+        this.members.set(address.toString(), m);
+        this.emit(new MemberJoined(m));
+        return m;
+    }
+    /** Transition a member to `up` and fire `MemberUp` (+ LeaderChanged if it changes). */
+    upMember(address) {
+        const prev = this.requireMember(address);
+        const m = new Member(address, 'up', prev.version + 1, prev.roles);
+        this.members.set(address.toString(), m);
+        this.emit(new MemberUp(m));
+        this.maybeLeaderChange();
+        return m;
+    }
+    /** Mark a member as unreachable; fires `MemberUnreachable`. */
+    markUnreachable(address) {
+        const prev = this.requireMember(address);
+        // The Member type doesn't carry an `unreachable` status — only
+        // the FailureDetector view does.  We re-emit the event with the
+        // current member; consumers that care about reachability listen
+        // for the EVENT, not a status mutation.
+        this.emit(new MemberUnreachable(prev));
+        return prev;
+    }
+    markReachable(address) {
+        const prev = this.requireMember(address);
+        this.emit(new MemberReachable(prev));
+        return prev;
+    }
+    /** Force a member down (DowningProvider triggered).  Fires `MemberDown`. */
+    downMember(address) {
+        const prev = this.requireMember(address);
+        const m = new Member(address, 'down', prev.version + 1, prev.roles);
+        this.members.set(address.toString(), m);
+        this.emit(new MemberDown(m));
+        return m;
+    }
+    /** Graceful leave path — fires `MemberLeft` then `MemberRemoved`. */
+    leaveMember(address) {
+        const prev = this.requireMember(address);
+        const leaving = new Member(address, 'leaving', prev.version + 1, prev.roles);
+        this.members.set(address.toString(), leaving);
+        this.emit(new MemberLeft(leaving));
+        const removed = new Member(address, 'removed', prev.version + 2, prev.roles, Date.now());
+        this.members.set(address.toString(), removed);
+        this.emit(new MemberRemoved(removed));
+        if (address.equals(this.selfAddress)) {
+            this.emit(new SelfRemoved(removed));
+        }
+        this.maybeLeaderChange();
+        return removed;
+    }
+    /** Move the leader to a specific member.  Fires `LeaderChanged`. */
+    setLeader(addr) {
+        if (addr === null) {
+            this.leader = none;
+        }
+        else {
+            const m = this.requireMember(addr);
+            this.leader = some(m);
+        }
+        this.emit(new LeaderChanged(this.leader));
+    }
+    /** Snapshot of registered listeners — for test introspection. */
+    get listenerCount() { return this.listeners.length; }
+    /* ------------------------------ internals ------------------------------ */
+    emit(event) {
+        for (const listener of this.listeners.slice()) {
+            try {
+                listener(event);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    requireMember(address) {
+        const m = this.members.get(address.toString());
+        if (!m)
+            throw new Error(`MockCluster: no member with address ${address}`);
+        return m;
+    }
+    computeLeader() {
+        const ups = this.upMembers();
+        return ups.length > 0 ? some(ups[0]) : none;
+    }
+    maybeLeaderChange() {
+        const newLeader = this.computeLeader();
+        const prevLeader = this.leader;
+        const sameLeader = (prevLeader.isNone() && newLeader.isNone()) ||
+            (prevLeader.isSome() && newLeader.isSome() &&
+                prevLeader.value.address.equals(newLeader.value.address));
+        if (!sameLeader) {
+            this.leader = newLeader;
+            this.emit(new LeaderChanged(newLeader));
+        }
+    }
+    /** Compatibility with code that calls `cluster.actorRefForMember(m)` — not implemented. */
+    actorRefForMember(_member) {
+        return null;
+    }
+}
+//# sourceMappingURL=MockCluster.js.map

package/dist/testkit/MockCluster.js.map

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

package/dist/testkit/MultiNodeClusterFixture.d.ts

@@ -0,0 +1,62 @@
+import { MultiNodeSpec, type MultiNodeSpecSettings } from './MultiNodeSpec.js';
+/**
+ * Test fixture that boots a {@link MultiNodeSpec} ONCE per describe-
+ * block and tears it down after the last `test()` in the block runs.
+ * Wraps the runner's `beforeAll` / `afterAll` hooks so a multi-node
+ * test file doesn't have to re-spin a 3-node cluster per-test —
+ * the bootstrap cost is paid once and amortised across the block.
+ *
+ * **Test-runner agnostic**: the framework's build output mustn't
+ * import `bun:test` directly (that breaks Node / Deno consumers
+ * who installed actor-ts and then run their own Vitest/Jest suite).
+ * Instead the caller passes the runner's `beforeAll` / `afterAll`
+ * in.  For Bun:
+ *
+ *   import { beforeAll, afterAll, describe, test } from 'bun:test';
+ *   import { MultiNodeClusterFixture } from 'actor-ts/testkit';
+ *
+ *   describe('sharding', () => {
+ *     const fixture = MultiNodeClusterFixture.create(
+ *       { roles: ['a', 'b', 'c'] },
+ *       { beforeAll, afterAll },
+ *     );
+ *
+ *     test('shard rebalances on join', async () => {
+ *       const a = fixture.spec().clusterFor('a');
+ *       // …
+ *     });
+ *   });
+ *
+ * Vitest and Jest export `beforeAll` / `afterAll` with compatible
+ * signatures, so the same shape works there.
+ */
+export interface TestRunnerHooks {
+    beforeAll(fn: () => void | Promise<void>): void;
+    afterAll(fn: () => void | Promise<void>): void;
+}
+export interface MultiNodeClusterFixture {
+    /** The underlying MultiNodeSpec — available inside any `test()` in the describe block. */
+    spec(): MultiNodeSpec;
+    /**
+     * `true` after `beforeAll` has run.  Used by tests that need to
+     * detect "is the fixture set up yet" (rare — usually you just
+     * call `spec()` and it throws helpfully if not started).
+     */
+    isStarted(): boolean;
+}
+export declare const MultiNodeClusterFixture: {
+    /**
+     * Register a multi-node cluster fixture in the current describe
+     * block.  Returns a handle whose `.spec()` is callable inside any
+     * `test()` in the same block.
+     *
+     * The implementation captures `settings` lazily — start happens
+     * inside the registered `beforeAll`, not at `create()` time.
+     * Bun's TestKit also hadn't started any actor systems yet at
+     * describe-registration time, so any side effects of MultiNodeSpec
+     * construction would be wasted if a sibling `test.skip`/filter
+     * skipped this block.
+     */
+    create(settings: MultiNodeSpecSettings, hooks: TestRunnerHooks): MultiNodeClusterFixture;
+};
+//# sourceMappingURL=MultiNodeClusterFixture.d.ts.map

package/dist/testkit/MultiNodeClusterFixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiNodeClusterFixture.d.ts","sourceRoot":"","sources":["../../src/testkit/MultiNodeClusterFixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,uBAAuB;IACtC,0FAA0F;IAC1F,IAAI,IAAI,aAAa,CAAC;IACtB;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,uBAAuB;IAClC;;;;;;;;;;;OAWG;qBAES,qBAAqB,SACxB,eAAe,GACrB,uBAAuB;CAgC3B,CAAC"}

package/dist/testkit/MultiNodeClusterFixture.js

@@ -0,0 +1,43 @@
+import { MultiNodeSpec } from './MultiNodeSpec.js';
+export const MultiNodeClusterFixture = {
+    /**
+     * Register a multi-node cluster fixture in the current describe
+     * block.  Returns a handle whose `.spec()` is callable inside any
+     * `test()` in the same block.
+     *
+     * The implementation captures `settings` lazily — start happens
+     * inside the registered `beforeAll`, not at `create()` time.
+     * Bun's TestKit also hadn't started any actor systems yet at
+     * describe-registration time, so any side effects of MultiNodeSpec
+     * construction would be wasted if a sibling `test.skip`/filter
+     * skipped this block.
+     */
+    create(settings, hooks) {
+        let spec = null;
+        let started = false;
+        hooks.beforeAll(async () => {
+            spec = new MultiNodeSpec(settings);
+            await spec.start();
+            started = true;
+        });
+        hooks.afterAll(async () => {
+            if (spec && started) {
+                await spec.stop();
+                spec = null;
+                started = false;
+            }
+        });
+        return {
+            spec() {
+                if (!spec) {
+                    throw new Error('MultiNodeClusterFixture.spec(): the fixture has not started yet.  ' +
+                        'Call this from inside a `test()` body — the beforeAll hook only runs ' +
+                        'after all tests in the describe block are registered.');
+                }
+                return spec;
+            },
+            isStarted() { return started; },
+        };
+    },
+};
+//# sourceMappingURL=MultiNodeClusterFixture.js.map

package/dist/testkit/MultiNodeClusterFixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiNodeClusterFixture.js","sourceRoot":"","sources":["../../src/testkit/MultiNodeClusterFixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA8B,MAAM,oBAAoB,CAAC;AAiD/E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,QAA+B,EAC/B,KAAsB;QAEtB,IAAI,IAAI,GAAyB,IAAI,CAAC;QACtC,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,KAAK,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;YACzB,IAAI,GAAG,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YACxB,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,IAAI,GAAG,IAAI,CAAC;gBACZ,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,IAAI;gBACF,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,MAAM,IAAI,KAAK,CACb,oEAAoE;wBACpE,uEAAuE;wBACvE,uDAAuD,CACxD,CAAC;gBACJ,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,SAAS,KAAc,OAAO,OAAO,CAAC,CAAC,CAAC;SACzC,CAAC;IACJ,CAAC;CACF,CAAC"}