posipaki 0.41.0 → 0.42.0

package/dist/index.d.ts

@@ -20,7 +20,7 @@ declare function defineActor<Args, InternalState, InMsg extends Message, OutMsg
 //#endregion
 //#region src/version.d.ts
 /** posipaki's release version.  Must equal package.json's `version`. */
-declare const LIB_VERSION = "0.41.0";
+declare const LIB_VERSION = "0.42.0";
 //#endregion
 export { type ActorConfig, type ActorContext, type ActorDecorated, type ActorDefinition, type ActorPlugin, type ActorReflection, type AnyProcess, AsyncProcess, type AsyncProcessFn, type ExitMessage, type HandlerFn, type HandlerOptions, type HookResult, LIB_VERSION, type Message, type MethodOptions, type PluginTransform, Process, type ProcessCtx, type ProcessFn, type SenderInfo, type SenderOrigin, type SpawnedFrom, type StopMessage, type WithSender, type WithoutSender, asyncify, callHook, chainHook, defineActor, defineMessages, mergeConfigs, propagateError, runDispatch, runDispatchAsync, spawn, spawnAsync, stopPropagation };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -2,7 +2,7 @@ import { i as runDispatch } from "./util-Brtfgv68.js";
 import { a as spawnAsync, i as runDispatchAsync, o as asyncify, t as AsyncProcess } from "./process.async-C_-NpMFX.js";
 import { n as chainHook, o as propagateError, r as mergeConfigs, s as stopPropagation, t as callHook } from "./hooks-CgXhmY4r.js";
 import { n as defineMessages, t as defineActor } from "./define-actor-D7c9vn6S.js";
-import { t as LIB_VERSION } from "./version-CYQgj_GV.js";
+import { t as LIB_VERSION } from "./version-DnLiQ9Q-.js";
 //#region src/process.ts
 /** @deprecated Use {@link spawnAsync} instead. */
 function spawn(fn, pname, tp) {

package/dist/remote/index.d.ts

@@ -1,6 +1,5 @@
 import { i as Message, s as SenderInfo } from "../types-DYd-DDFB.js";
-import { l as ActorDefinition, v as ReflectionOptions } from "../hooks-D1QaP6Vv.js";
-import { S as isStop, _ as isPause, a as Channel, b as isResume, c as badFrame, d as errorReason, f as isBad, g as isMsg, h as isInit, i as BAD_PREFIX_LIMIT, l as badReason, m as isExit, n as ClientSpawner, o as StreamKind, p as isError, r as remoteClient, s as StringTransport, t as CHANNEL_LOST, u as errorFrame, v as isProto, x as isState, y as isRelease } from "../client-GrwWOUBV.js";
+import { A as isError, C as StreamKind, D as errorFrame, E as badReason, F as isProto, I as isRelease, L as isResume, M as isInit, N as isMsg, O as errorReason, P as isPause, R as isState, S as Channel, T as badFrame, _ as Init, a as ClientSpawner, b as Spawner, c as Connection, d as ReactorOptions, f as Session, g as serveRemoteActor, h as reactor, i as CHANNEL_LOST, j as isExit, k as isBad, l as Listener, m as oneConnection, n as WebSocketLike, o as remoteClient, p as SessionFactory, r as WebSocketTransport, s as AnyActorDefinition, t as WS_OPEN, u as Reactor, v as Served, w as StringTransport, x as BAD_PREFIX_LIMIT, y as ServedProcess, z as isStop } from "../websocket-BYNYSi7b.js";
 //#region src/remote/remote-process.d.ts
 interface RemoteExit {
   code: number;
@@ -229,10 +228,6 @@ type IdParity = "odd" | "even";
  *  build can hold two copies of the class. */
 declare function isRemoteProcess(value: unknown): value is RemoteProcess;
 //#endregion
-//#region src/remote/server.d.ts
-type Spawner = () => Promise<Channel>;
-declare function serveRemoteActor<Args, State, InMsg extends Message, OutMsg extends Message, R extends ReflectionOptions>(actor: ActorDefinition<Args, State, InMsg, OutMsg, R>, spawner: Spawner): Promise<void>;
-//#endregion
 //#region src/remote/sender.d.ts
 declare function makeSender(fromName: string, parentName: string | null, parentId: symbol | null): SenderInfo;
 //#endregion
@@ -247,38 +242,6 @@ declare function decode(str: string): Record<string, unknown>;
 declare function readFrame(str: string): Record<string, unknown>;
 declare function json1Channel(transport: StringTransport): Channel;
 //#endregion
-//#region src/remote/transports/websocket.d.ts
-/**
- * The subset of a WebSocket the transport needs.  The WHATWG client WebSocket
- * (Node, Bun, browsers) satisfies this directly; a Bun server socket is adapted
- * by the consumer (see spawners/ws-server.ts).
- */
-interface WebSocketLike {
-  send(data: string): void;
-  close(code?: number, reason?: string): void;
-  readonly readyState: number;
-  onmessage: ((event: {
-    data: unknown;
-  }) => void) | null;
-  onclose: (() => void) | null;
-}
-/** WHATWG WebSocket readyState: OPEN. */
-declare const WS_OPEN = 1;
-declare class WebSocketTransport implements StringTransport {
-  private ws;
-  private pvtOnMessage;
-  private pvtOnClose;
-  private closed;
-  constructor(ws: WebSocketLike);
-  get canSend(): boolean;
-  onMessage(handler: (frame: string) => void): void;
-  removeHandler(): ((frame: string) => void) | null;
-  onClose(handler: () => void): void;
-  get hasHandler(): boolean;
-  send(frame: string): Promise<void>;
-  close(): Promise<void>;
-}
-//#endregion
 //#region src/remote/transports/worker.d.ts
 /** The worker encoding: native structured clone (no JSON). */
 declare const WORKER_VERSION = "clone.v1";
@@ -311,7 +274,8 @@ declare class WorkerTransport implements Channel {
 }
 //#endregion
 //#region src/remote/spawners/ws-client.d.ts
-type WebSocketCtor = new (url: string) => {
+/** The socket the spawner needs: what the transport reads and writes, and the open/error slots. */
+type OpenedWebSocket = {
   readonly readyState: number;
   send(data: string): void;
   close(code?: number, reason?: string): void;
@@ -322,7 +286,19 @@ type WebSocketCtor = new (url: string) => {
   }) => void) | null;
   onclose: (() => void) | null;
 };
-declare function wsClientSpawner<Args = unknown>(url: string | ((args: Args) => string), WebSocketImpl?: WebSocketCtor): ClientSpawner<Args>;
+type WebSocketCtor = new (url: string) => OpenedWebSocket;
+/**
+ * How a socket is opened when a constructor is not enough: the URL to open, and the arguments this
+ * spawn was called with.  A per-tenant header, a bearer token, an authority the machine does not
+ * already know — each of them is a fact about the connection, and each of them is the caller's to
+ * express in its own runtime's shape rather than in one posipaki was taught.
+ */
+type WebSocketOpener<Args = unknown> = (url: string, args: Args) => OpenedWebSocket;
+interface WebSocketClientOptions<Args = unknown> {
+  /** Opens the socket.  Given, it replaces the constructor. */
+  open?: WebSocketOpener<Args>;
+}
+declare function wsClientSpawner<Args = unknown>(url: string | ((args: Args) => string), WebSocketImpl?: WebSocketCtor, opts?: WebSocketClientOptions<Args>): ClientSpawner<Args>;
 //#endregion
 //#region src/remote/spawners/ws-server.d.ts
 declare function wsServerSpawner(ws: WebSocketLike): Spawner;
@@ -366,5 +342,5 @@ declare function workerClientSpawner<Args = unknown>(url: string | ((args: Args)
 //#region src/remote/spawners/worker-self.d.ts
 declare function workerSelfSpawner(selfScope?: WorkerLike): Spawner;
 //#endregion
-export { BAD_PREFIX_LIMIT, type BunServerWebSocketLike, CHANNEL_LOST, type Channel, type ClientSpawner, type FrameSink, PROCESS_REF, type ProcessRef, type RemoteMessage, RemoteProcess, type Spawner, type StringTransport, VERSION, WORKER_VERSION, WS_OPEN, type WebSocketCtor, type WebSocketLike, WebSocketTransport, type WorkerCtor, type WorkerLike, WorkerTransport, badFrame, badReason, bunServerWebSocket, decode, encode, errorFrame, errorReason, isBad, isError, isExit, isInit, isMsg, isPause, isProto, isRelease, isRemoteProcess, isResume, isState, isStop, json1Channel, makeSender, readFrame, remoteClient, rootIdFor, serveRemoteActor, workerClientSpawner, workerSelfSpawner, wsClientSpawner, wsServerSpawner };
+export { type AnyActorDefinition, BAD_PREFIX_LIMIT, type BunServerWebSocketLike, CHANNEL_LOST, type Channel, type ClientSpawner, type Connection, type FrameSink, type Init, type Listener, type OpenedWebSocket, PROCESS_REF, type ProcessRef, type Reactor, type ReactorOptions, type RemoteMessage, RemoteProcess, type Served, type ServedProcess, type Session, type SessionFactory, type Spawner, type StringTransport, VERSION, WORKER_VERSION, WS_OPEN, type WebSocketClientOptions, type WebSocketCtor, type WebSocketLike, type WebSocketOpener, WebSocketTransport, type WorkerCtor, type WorkerLike, WorkerTransport, badFrame, badReason, bunServerWebSocket, decode, encode, errorFrame, errorReason, isBad, isError, isExit, isInit, isMsg, isPause, isProto, isRelease, isRemoteProcess, isResume, isState, isStop, json1Channel, makeSender, oneConnection, reactor, readFrame, remoteClient, rootIdFor, serveRemoteActor, workerClientSpawner, workerSelfSpawner, wsClientSpawner, wsServerSpawner };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/remote/remote-process.ts","../../src/remote/process-ref.ts","../../src/remote/server.ts","../../src/remote/sender.ts","../../src/remote/protocols/json1.ts","../../src/remote/transports/websocket.ts","../../src/remote/transports/worker.ts","../../src/remote/spawners/ws-client.ts","../../src/remote/spawners/ws-server.ts","../../src/remote/spawners/worker-client.ts","../../src/remote/spawners/worker-self.ts"],"mappings":";;;;UAyDiB;EACf;EACA;;;;;KAMU,aAAa,OAAO,yBAAyB,sBAAsB;;;KAInE,eAAe;;KAGf,cAAc,eAAe,UAAU,YAAY,KAAK,QAAQ;cAE/D,cAAc,cAAc,UAAU,SAAS,eAAe,UAAU;;WAE1E;;;WAGA,KAAK;;;WAGL;;EAET,OAAO;;WAEE,aAAa,mBAAmB,oBAAoB;UAErD;UACA;UACA;;;;UAIA;UACA;;UAEA;UACA;UACA;UACA;;UAEA;;;UAGA;;;UAGA;;;;UAIA;;;;;UAKA;EAER,YAAY,KAAK,YAAY,MAAM,WAAW,kBAAkB,QAAQ;;;;;;;;;;;EAmBxE;;;;;;EASA;;EAUA;;;;UAOQ;UAOA;;;;;;EAUR;;;;;;;EAWA;;;UAgBQ;;EAQR;;;;;;;EAkBA;;;;;;EAUA,cAAc;;UAUN;;;;;;UAUA;;;;UAYA;;;;;;;;;;EAiBR,SAAS;;UAQD;;;;;;;;;EAcR,QAAQ,QAAQ;;;;;;EAgBhB,QAAQ;;;;;;;EAgBR;;EAqBA;;EAMA;;;;;;;;;;;EAeA,KAAK,OAAO;;;;UASJ;;;;UAYA;;EAOR,KAAK,KAAK;;;;;EASV,UAAU,oBAAoB,IAAI,cAAc;EAChD,UAAU,kBAAkB;UAepB;;EAUR,aAAa,OAAO;;EASpB,eAAe,KAAK,QAAQ;;;;EAU5B,YAAY,MAAM;;;;EAYlB,eAAe,iBAAiB,OAAO,cAAc,oBAAoB;;;;;cCvc9D;;;;;;;iBAQG,UAAU,QAAQ;;UAWjB;EACf;EACA;;;;KAYU;;;;iBAoJI,gBAAgB,iBAAiB,SAAS;;;KCtK9C,gBAAgB,QAAQ;iBASd,iBACpB,MACA,OACA,cAAc,SACd,eAAe,SACf,UAAU,mBACV,OAAO,gBAAgB,MAAM,OAAO,OAAO,QAAQ,IAAI,SAAS,UAAU;;;iBChD5D,WACd,kBACA,2BACA,0BACC;;;cCMU;iBAEG,OAAO,OAAO;;;iBAMd,OAAO,cAAc;;;iBAMrB,UAAU,cAAc;iBAmBxB,aAAa,WAAW,kBAAkB;;;;;;;;UCvCzC;EACf,KAAK;EACL,MAAM,eAAe;WACZ;EACT,aAAa;IAAS;;EACtB;;;cAIW;cAEA,8BAA8B;UACjC;UACA;UACA;UACA;EAER,YAAY,IAAI;MAWZ;EAIJ,UAAU,UAAU;EAQpB,mBAAmB;EAMnB,QAAQ;MAIJ;EAIE,KAAK,gBAAgB;EAMrB,SAAS;;;;;cC/DJ;;;;;;UAOI;EACf,YAAY;EACZ,aAAa;IAAS;;EACtB,YAAY;EACZ;;cAGW,2BAA2B;UAC9B;UACA;UACA;UACA;EAER,YAAY,QAAQ;MAgBhB;EAIJ,UAAU,UAAU,OAAO;EAQ3B,mBAAmB,OAAO;EAM1B,QAAQ;MAIJ;EAIE,KAAK,OAAO,0BAA0B;EAKtC,SAAS;;;;KClEL,qBAAqB;WACtB;EACT,KAAK;EACL,MAAM,eAAe;EACrB;EACA,WAAW;EACX,aAAa;IAAS;;EACtB;;iBAac,gBAAgB,gBAC9B,gBAAgB,MAAM,kBACtB,gBAAe,gBACd,cAAc;;;iBCzBD,gBAAgB,IAAI,gBAAgB;;;;;;;UAcnC;EACf,KAAK;EACL,MAAM,eAAe;WACZ;EACT;;;;;;;;;;;;;;;;;;;;;iBAsBc,mBAAmB,IAAI,yBAAyB;;;KCxCpD,kBAAkB,gBAAgB;iBAI9B,oBAAoB,gBAClC,gBAAgB,MAAM,kBACtB,aAAY,aACX,cAAc;;;iBCRD,kBAAkB,YAAW,aAAmD"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/remote/remote-process.ts","../../src/remote/process-ref.ts","../../src/remote/sender.ts","../../src/remote/protocols/json1.ts","../../src/remote/transports/worker.ts","../../src/remote/spawners/ws-client.ts","../../src/remote/spawners/ws-server.ts","../../src/remote/spawners/worker-client.ts","../../src/remote/spawners/worker-self.ts"],"mappings":";;;UAyDiB;EACf;EACA;;;;;KAMU,aAAa,OAAO,yBAAyB,sBAAsB;;;KAInE,eAAe;;KAGf,cAAc,eAAe,UAAU,YAAY,KAAK,QAAQ;cAE/D,cAAc,cAAc,UAAU,SAAS,eAAe,UAAU;;WAE1E;;;WAGA,KAAK;;;WAGL;;EAET,OAAO;;WAEE,aAAa,mBAAmB,oBAAoB;UAErD;UACA;UACA;;;;UAIA;UACA;;UAEA;UACA;UACA;UACA;;UAEA;;;UAGA;;;UAGA;;;;UAIA;;;;;UAKA;EAER,YAAY,KAAK,YAAY,MAAM,WAAW,kBAAkB,QAAQ;;;;;;;;;;;EAmBxE;;;;;;EASA;;EAUA;;;;UAOQ;UAOA;;;;;;EAUR;;;;;;;EAWA;;;UAgBQ;;EAQR;;;;;;;EAkBA;;;;;;EAUA,cAAc;;UAUN;;;;;;UAUA;;;;UAYA;;;;;;;;;;EAiBR,SAAS;;UAQD;;;;;;;;;EAcR,QAAQ,QAAQ;;;;;;EAgBhB,QAAQ;;;;;;;EAgBR;;EAqBA;;EAMA;;;;;;;;;;;EAeA,KAAK,OAAO;;;;UASJ;;;;UAYA;;EAOR,KAAK,KAAK;;;;;EASV,UAAU,oBAAoB,IAAI,cAAc;EAChD,UAAU,kBAAkB;UAepB;;EAUR,aAAa,OAAO;;EASpB,eAAe,KAAK,QAAQ;;;;EAU5B,YAAY,MAAM;;;;EAYlB,eAAe,iBAAiB,OAAO,cAAc,oBAAoB;;;;;cCvc9D;;;;;;;iBAQG,UAAU,QAAQ;;UAWjB;EACf;EACA;;;;KAYU;;;;iBAoJI,gBAAgB,iBAAiB,SAAS;;;iBCvM1C,WACd,kBACA,2BACA,0BACC;;;cCMU;iBAEG,OAAO,OAAO;;;iBAMd,OAAO,cAAc;;;iBAMrB,UAAU,cAAc;iBAmBxB,aAAa,WAAW,kBAAkB;;;;cC1C7C;;;;;;UAOI;EACf,YAAY;EACZ,aAAa;IAAS;;EACtB,YAAY;EACZ;;cAGW,2BAA2B;UAC9B;UACA;UACA;UACA;EAER,YAAY,QAAQ;MAgBhB;EAIJ,UAAU,UAAU,OAAO;EAQ3B,mBAAmB,OAAO;EAM1B,QAAQ;MAIJ;EAIE,KAAK,OAAO,0BAA0B;EAKtC,SAAS;;;;;KC5DL;WACD;EACT,KAAK;EACL,MAAM,eAAe;EACrB;EACA,WAAW;EACX,aAAa;IAAS;;EACtB;;KAGU,qBAAqB,gBAAgB;;;;;;;KAQrC,gBAAgB,mBAAmB,aAAa,MAAM,SAAS;UAE1D,uBAAuB;;EAEtC,OAAO,gBAAgB;;iBA6BT,gBAAgB,gBAC9B,gBAAgB,MAAM,kBACtB,gBAAe,eACf,OAAM,uBAAuB,QAC5B,cAAc;;;iBC/DD,gBAAgB,IAAI,gBAAgB;;;;;;;UAcnC;EACf,KAAK;EACL,MAAM,eAAe;WACZ;EACT;;;;;;;;;;;;;;;;;;;;;iBAsBc,mBAAmB,IAAI,yBAAyB;;;KCxCpD,kBAAkB,gBAAgB;iBAI9B,oBAAoB,gBAClC,gBAAgB,MAAM,kBACtB,aAAY,aACX,cAAc;;;iBCRD,kBAAkB,YAAW,aAAmD"}

package/dist/remote/index.js

@@ -1,54 +1,4 @@
-import { C as isRelease, D as PROCESS_REF, E as isStop, O as isRemoteProcess, S as isProto, T as isState, _ as isError, a as readFrame, b as isMsg, c as serveRemoteActor, d as BAD_PREFIX_LIMIT, f as badFrame, g as isBad, h as errorReason, i as json1Channel, k as rootIdFor, l as makeSender, m as errorFrame, n as decode, o as CHANNEL_LOST, p as badReason, r as encode, s as remoteClient, t as VERSION, u as RemoteProcess, v as isExit, w as isResume, x as isPause, y as isInit } from "../json1-BWi4HzI4.js";
-//#region src/remote/transports/websocket.ts
-/** WHATWG WebSocket readyState: OPEN. */
-const WS_OPEN = 1;
-var WebSocketTransport = class {
-	constructor(ws) {
-		this.pvtOnMessage = null;
-		this.pvtOnClose = null;
-		this.closed = false;
-		this.ws = ws;
-		ws.onmessage = (event) => {
-			if (this.pvtOnMessage && !this.closed) this.pvtOnMessage(String(event.data));
-		};
-		ws.onclose = () => {
-			this.closed = true;
-			this.pvtOnClose?.();
-		};
-	}
-	get canSend() {
-		return !this.closed && this.ws.readyState === 1;
-	}
-	onMessage(handler) {
-		if (this.closed) throw new Error("WebSocketTransport: closed");
-		if (this.pvtOnMessage !== null) throw new Error("WebSocketTransport: handler already set — call removeHandler() first");
-		this.pvtOnMessage = handler;
-	}
-	removeHandler() {
-		const prev = this.pvtOnMessage;
-		this.pvtOnMessage = null;
-		return prev;
-	}
-	onClose(handler) {
-		this.pvtOnClose = handler;
-	}
-	get hasHandler() {
-		return this.pvtOnMessage !== null;
-	}
-	async send(frame) {
-		if (this.closed) throw new Error("WebSocketTransport: closed");
-		if (this.ws.readyState !== 1) throw new Error("WebSocketTransport: not open");
-		this.ws.send(frame);
-	}
-	async close() {
-		if (this.closed) return;
-		this.closed = true;
-		try {
-			this.ws.close();
-		} catch {}
-	}
-};
-//#endregion
+import { A as isStop, C as isInit, D as isRelease, E as isProto, M as isRemoteProcess, N as rootIdFor, O as isResume, S as isExit, T as isPause, _ as badReason, a as oneConnection, b as isBad, c as makeSender, d as decode, f as encode, g as badFrame, h as BAD_PREFIX_LIMIT, i as remoteClient, j as PROCESS_REF, k as isState, l as RemoteProcess, m as readFrame, n as WebSocketTransport, o as reactor, p as json1Channel, r as CHANNEL_LOST, s as serveRemoteActor, t as WS_OPEN, u as VERSION, v as errorFrame, w as isMsg, x as isError, y as errorReason } from "../websocket-DttBoCRL.js";
 //#region src/remote/transports/worker.ts
 /** The worker encoding: native structured clone (no JSON). */
 const WORKER_VERSION = "clone.v1";
@@ -98,16 +48,35 @@ var WorkerTransport = class {
 //#endregion
 //#region src/remote/spawners/ws-client.ts
 const defaultWebSocket = globalThis.WebSocket;
+/** What a socket failure says about itself.
+*
+* A WHATWG WebSocket reports an open failure as an ErrorEvent, and `String(event)` is
+* `[object ErrorEvent]`: its type, its message and the underlying error are all in its
+* own fields, so read those rather than stringify the event that carries them.
+*/
+function describeSocketError(err) {
+	if (typeof err !== "object" || err === null) return String(err);
+	const event = err;
+	const cause = event.error instanceof Error ? event.error.message : event.error;
+	const parts = [
+		event.type,
+		event.message,
+		cause
+	].filter((part) => typeof part === "string" && part.length > 0);
+	return parts.length > 0 ? parts.join(": ") : String(err);
+}
 function openWebSocket(ws) {
 	return new Promise((resolve, reject) => {
 		if (ws.readyState === 1) return resolve();
 		ws.onopen = () => resolve();
-		ws.onerror = (err) => reject(/* @__PURE__ */ new Error(`websocket failed to open: ${String(err)}`));
+		ws.onerror = (err) => reject(/* @__PURE__ */ new Error(`websocket failed to open: ${describeSocketError(err)}`));
 	});
 }
-function wsClientSpawner(url, WebSocketImpl = defaultWebSocket) {
+function wsClientSpawner(url, WebSocketImpl = defaultWebSocket, opts = {}) {
+	const open = opts.open ?? ((target) => new WebSocketImpl(target));
 	return async (args) => {
-		const ws = new WebSocketImpl(typeof url === "function" ? url(args) : url);
+		const target = typeof url === "function" ? url(args) : url;
+		const ws = open(target, args);
 		const transport = new WebSocketTransport(ws);
 		const channel = json1Channel(transport);
 		const protoPromise = new Promise((resolve) => {
@@ -181,6 +150,6 @@ function workerSelfSpawner(selfScope = globalThis) {
 	};
 }
 //#endregion
-export { BAD_PREFIX_LIMIT, CHANNEL_LOST, PROCESS_REF, RemoteProcess, VERSION, WORKER_VERSION, WS_OPEN, WebSocketTransport, WorkerTransport, badFrame, badReason, bunServerWebSocket, decode, encode, errorFrame, errorReason, isBad, isError, isExit, isInit, isMsg, isPause, isProto, isRelease, isRemoteProcess, isResume, isState, isStop, json1Channel, makeSender, readFrame, remoteClient, rootIdFor, serveRemoteActor, workerClientSpawner, workerSelfSpawner, wsClientSpawner, wsServerSpawner };
+export { BAD_PREFIX_LIMIT, CHANNEL_LOST, PROCESS_REF, RemoteProcess, VERSION, WORKER_VERSION, WS_OPEN, WebSocketTransport, WorkerTransport, badFrame, badReason, bunServerWebSocket, decode, encode, errorFrame, errorReason, isBad, isError, isExit, isInit, isMsg, isPause, isProto, isRelease, isRemoteProcess, isResume, isState, isStop, json1Channel, makeSender, oneConnection, reactor, readFrame, remoteClient, rootIdFor, serveRemoteActor, workerClientSpawner, workerSelfSpawner, wsClientSpawner, wsServerSpawner };
 
 //# sourceMappingURL=index.js.map

package/dist/remote/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/remote/transports/websocket.ts","../../src/remote/transports/worker.ts","../../src/remote/spawners/ws-client.ts","../../src/remote/spawners/ws-server.ts","../../src/remote/spawners/worker-client.ts","../../src/remote/spawners/worker-self.ts"],"sourcesContent":["/* eslint-disable unicorn/prefer-add-event-listener */\n// ── WebSocket transport ─────────────────────────────────────────────────────────\n//\n// Message-boundary transport over a WebSocket.  The socket's native framing means\n// one `send` is one frame — there is no delimiter to add or strip.  It moves\n// encoded frames (strings); json1Channel sits above it and handles JSON.\n\nimport type { StringTransport } from \"../channel.js\";\n\n/**\n * The subset of a WebSocket the transport needs.  The WHATWG client WebSocket\n * (Node, Bun, browsers) satisfies this directly; a Bun server socket is adapted\n * by the consumer (see spawners/ws-server.ts).\n */\nexport interface WebSocketLike {\n  send(data: string): void;\n  close(code?: number, reason?: string): void;\n  readonly readyState: number;\n  onmessage: ((event: { data: unknown }) => void) | null;\n  onclose: (() => void) | null;\n}\n\n/** WHATWG WebSocket readyState: OPEN. */\nexport const WS_OPEN = 1;\n\nexport class WebSocketTransport implements StringTransport {\n  private ws: WebSocketLike;\n  private pvtOnMessage: ((frame: string) => void) | null = null;\n  private pvtOnClose: (() => void) | null = null;\n  private closed = false;\n\n  constructor(ws: WebSocketLike) {\n    this.ws = ws;\n    ws.onmessage = (event) => {\n      if (this.pvtOnMessage && !this.closed) this.pvtOnMessage(String(event.data));\n    };\n    ws.onclose = () => {\n      this.closed = true;\n      this.pvtOnClose?.();\n    };\n  }\n\n  get canSend(): boolean {\n    return !this.closed && this.ws.readyState === WS_OPEN;\n  }\n\n  onMessage(handler: (frame: string) => void): void {\n    if (this.closed) throw new Error(\"WebSocketTransport: closed\");\n    if (this.pvtOnMessage !== null) {\n      throw new Error(\"WebSocketTransport: handler already set — call removeHandler() first\");\n    }\n    this.pvtOnMessage = handler;\n  }\n\n  removeHandler(): ((frame: string) => void) | null {\n    const prev = this.pvtOnMessage;\n    this.pvtOnMessage = null;\n    return prev;\n  }\n\n  onClose(handler: () => void): void {\n    this.pvtOnClose = handler;\n  }\n\n  get hasHandler(): boolean {\n    return this.pvtOnMessage !== null;\n  }\n\n  async send(frame: string): Promise<void> {\n    if (this.closed) throw new Error(\"WebSocketTransport: closed\");\n    if (this.ws.readyState !== WS_OPEN) throw new Error(\"WebSocketTransport: not open\");\n    this.ws.send(frame);\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) return;\n    this.closed = true;\n    try {\n      this.ws.close();\n    } catch {\n      // already closing / closed — ignore\n    }\n  }\n}\n","/* eslint-disable unicorn/prefer-add-event-listener, unicorn/require-post-message-target-origin */\n// ── Worker transport ────────────────────────────────────────────────────────────\n//\n// Moves frame objects directly over postMessage.  postMessage structured-clones\n// the frame object, so there is no JSON encode/decode — this transport implements\n// Channel directly (not StringTransport).  Structured clone is the worker's\n// native encoding, named by WORKER_VERSION.\n\nimport type { Channel } from \"../channel.js\";\n\n/** The worker encoding: native structured clone (no JSON). */\nexport const WORKER_VERSION = \"clone.v1\";\n\n/**\n * The subset of a worker the transport needs.  The main-thread `Worker` and the\n * worker-global `self` both satisfy it; `terminate` is present only on the\n * main-thread side.\n */\nexport interface WorkerLike {\n  postMessage(data: unknown): void;\n  onmessage: ((event: { data: unknown }) => void) | null;\n  onerror?: ((event: unknown) => void) | null;\n  terminate?(): void;\n}\n\nexport class WorkerTransport implements Channel {\n  private worker: WorkerLike;\n  private pvtOnMessage: ((frame: Record<string, unknown>) => void) | null = null;\n  private pvtOnClose: (() => void) | null = null;\n  private closed = false;\n\n  constructor(worker: WorkerLike) {\n    this.worker = worker;\n    worker.onmessage = (event) => {\n      if (this.pvtOnMessage && !this.closed) {\n        this.pvtOnMessage(event.data as Record<string, unknown>);\n      }\n    };\n    // An uncaught error in the worker is the closest thing to an abrupt drop.\n    if (\"onerror\" in worker) {\n      worker.onerror = () => {\n        this.closed = true;\n        this.pvtOnClose?.();\n      };\n    }\n  }\n\n  get canSend(): boolean {\n    return !this.closed;\n  }\n\n  onMessage(handler: (frame: Record<string, unknown>) => void): void {\n    if (this.closed) throw new Error(\"WorkerTransport: closed\");\n    if (this.pvtOnMessage !== null) {\n      throw new Error(\"WorkerTransport: handler already set — call removeHandler() first\");\n    }\n    this.pvtOnMessage = handler;\n  }\n\n  removeHandler(): ((frame: Record<string, unknown>) => void) | null {\n    const prev = this.pvtOnMessage;\n    this.pvtOnMessage = null;\n    return prev;\n  }\n\n  onClose(handler: () => void): void {\n    this.pvtOnClose = handler;\n  }\n\n  get hasHandler(): boolean {\n    return this.pvtOnMessage !== null;\n  }\n\n  async send(frame: Record<string, unknown>): Promise<void> {\n    if (this.closed) throw new Error(\"WorkerTransport: closed\");\n    this.worker.postMessage(frame);\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) return;\n    this.closed = true;\n    this.worker.terminate?.();\n  }\n}\n","/* eslint-disable unicorn/prefer-add-event-listener */\n// ── WebSocket client spawner ────────────────────────────────────────────────────\n//\n// Environment-specific: connects to a `ws://` URL with the WHATWG WebSocket,\n// wraps it in a WebSocketTransport, and returns a frame Channel with the $proto\n// handshake already validated.\n\nimport { WebSocketTransport } from \"../transports/websocket.js\";\nimport { json1Channel, VERSION } from \"../protocols/json1.js\";\nimport { isProto } from \"../channel.js\";\nimport type { ClientSpawner } from \"../client.js\";\n\nexport type WebSocketCtor = new (url: string) => {\n  readonly readyState: number;\n  send(data: string): void;\n  close(code?: number, reason?: string): void;\n  onopen: (() => void) | null;\n  onerror: ((err: unknown) => void) | null;\n  onmessage: ((event: { data: unknown }) => void) | null;\n  onclose: (() => void) | null;\n};\n\nconst defaultWebSocket = (globalThis as { WebSocket?: WebSocketCtor }).WebSocket;\n\nfunction openWebSocket(ws: { readonly readyState: number; onopen: (() => void) | null; onerror: ((err: unknown) => void) | null }): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (ws.readyState === 1 /* OPEN */) return resolve();\n    ws.onopen = () => resolve();\n    ws.onerror = (err) => reject(new Error(`websocket failed to open: ${String(err)}`));\n  });\n}\n\nexport function wsClientSpawner<Args = unknown>(\n  url: string | ((args: Args) => string),\n  WebSocketImpl: WebSocketCtor = defaultWebSocket as WebSocketCtor,\n): ClientSpawner<Args> {\n  return async (args) => {\n    const target = typeof url === \"function\" ? url(args) : url;\n    const ws = new WebSocketImpl(target);\n    const transport = new WebSocketTransport(ws);\n    const channel = json1Channel(transport);\n\n    // Set the $proto waiter before awaiting open so a fast server's handshake\n    // frame is not dropped.\n    const protoPromise = new Promise<Record<string, unknown>>((resolve) => {\n      channel.onMessage((frame) => resolve(frame));\n    });\n    await openWebSocket(ws);\n    const protoFrame = await protoPromise;\n    channel.removeHandler();\n\n    if (!isProto(protoFrame) || protoFrame.$proto !== VERSION) {\n      throw new Error(`unsupported protocol: ${JSON.stringify(protoFrame).slice(0, 50)}`);\n    }\n    return channel;\n  };\n}\n","// ── WebSocket server spawner ────────────────────────────────────────────────────\n//\n// Environment-specific: serves an already-upgraded WebSocket connection.  The\n// consumer's HTTP server does the upgrade and hands us the socket; we wrap it in\n// a WebSocketTransport, send $proto, and return the frame Channel.\n\nimport { WebSocketTransport, type WebSocketLike } from \"../transports/websocket.js\";\nimport { json1Channel, VERSION } from \"../protocols/json1.js\";\nimport type { Spawner } from \"../server.js\";\n\nexport function wsServerSpawner(ws: WebSocketLike): Spawner {\n  return async () => {\n    const channel = json1Channel(new WebSocketTransport(ws));\n    await channel.send({ $proto: VERSION });\n    return channel;\n  };\n}\n\n/**\n * A minimal Bun `ServerWebSocket` — `send`/`close`/`readyState` plus the data\n * slot the server uses to stash per-connection state.  Bun delivers message and\n * close events through the `Bun.serve` websocket config callbacks, not through\n * properties on the socket, so the consumer routes them onto the adapter.\n */\nexport interface BunServerWebSocketLike {\n  send(data: string): void;\n  close(code?: number, reason?: string): void;\n  readonly readyState: number;\n  data?: unknown;\n}\n\n/**\n * Adapt a Bun server socket to the `WebSocketLike` the transport consumes.  The\n * returned adapter owns settable `onmessage`/`onclose` slots; the consumer\n * routes Bun's `message`/`close` config callbacks into them, e.g.:\n *\n * ```ts\n * Bun.serve({\n *   websocket: {\n *     open(ws) {\n *       const adapter = bunServerWebSocket(ws);\n *       ws.data = adapter;\n *       serveRemoteActor(actor, wsServerSpawner(adapter));\n *     },\n *     message(ws, msg) { (ws.data as WebSocketLike).onmessage?.({ data: msg }); },\n *     close(ws) { (ws.data as WebSocketLike).onclose?.(); },\n *   },\n * });\n * ```\n */\nexport function bunServerWebSocket(ws: BunServerWebSocketLike): WebSocketLike {\n  return {\n    send: (data) => ws.send(data),\n    close: (code, reason) => ws.close(code, reason),\n    readyState: ws.readyState,\n    onmessage: null,\n    onclose: null,\n  };\n}\n","// ── Worker client spawner (command) ─────────────────────────────────────────────\n//\n// Environment-specific: spawns a Worker with the WHATWG `new Worker(url)` API,\n// wraps it in a WorkerTransport, and returns a frame Channel with the $proto\n// handshake already validated.\n\nimport { WorkerTransport, WORKER_VERSION, type WorkerLike } from \"../transports/worker.js\";\nimport { isProto } from \"../channel.js\";\nimport type { ClientSpawner } from \"../client.js\";\n\nexport type WorkerCtor = new (url: string) => WorkerLike;\n\nconst defaultWorker = (globalThis as { Worker?: WorkerCtor }).Worker;\n\nexport function workerClientSpawner<Args = unknown>(\n  url: string | ((args: Args) => string),\n  WorkerImpl: WorkerCtor = defaultWorker as WorkerCtor,\n): ClientSpawner<Args> {\n  return async (args) => {\n    const target = typeof url === \"function\" ? url(args) : url;\n    const channel = new WorkerTransport(new WorkerImpl(target));\n\n    const protoFrame = await new Promise<Record<string, unknown>>((resolve) => {\n      channel.onMessage((frame) => resolve(frame));\n    });\n    channel.removeHandler();\n\n    if (!isProto(protoFrame) || protoFrame.$proto !== WORKER_VERSION) {\n      throw new Error(`unsupported protocol: ${JSON.stringify(protoFrame).slice(0, 50)}`);\n    }\n    return channel;\n  };\n}\n","// ── Worker server spawner (self) ────────────────────────────────────────────────\n//\n// Environment-specific: serves the worker-global scope (`self`) as a frame\n// Channel with the $proto handshake already sent.  The worker entry script calls\n// `serveRemoteActor(actor, workerSelfSpawner())`.\n\nimport { WorkerTransport, WORKER_VERSION, type WorkerLike } from \"../transports/worker.js\";\nimport type { Spawner } from \"../server.js\";\n\nexport function workerSelfSpawner(selfScope: WorkerLike = globalThis as unknown as WorkerLike): Spawner {\n  return async () => {\n    const channel = new WorkerTransport(selfScope);\n    await channel.send({ $proto: WORKER_VERSION });\n    return channel;\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/remote/transports/worker.ts","../../src/remote/spawners/ws-client.ts","../../src/remote/spawners/ws-server.ts","../../src/remote/spawners/worker-client.ts","../../src/remote/spawners/worker-self.ts"],"sourcesContent":["/* eslint-disable unicorn/prefer-add-event-listener, unicorn/require-post-message-target-origin */\n// ── Worker transport ────────────────────────────────────────────────────────────\n//\n// Moves frame objects directly over postMessage.  postMessage structured-clones\n// the frame object, so there is no JSON encode/decode — this transport implements\n// Channel directly (not StringTransport).  Structured clone is the worker's\n// native encoding, named by WORKER_VERSION.\n\nimport type { Channel } from \"../channel.js\";\n\n/** The worker encoding: native structured clone (no JSON). */\nexport const WORKER_VERSION = \"clone.v1\";\n\n/**\n * The subset of a worker the transport needs.  The main-thread `Worker` and the\n * worker-global `self` both satisfy it; `terminate` is present only on the\n * main-thread side.\n */\nexport interface WorkerLike {\n  postMessage(data: unknown): void;\n  onmessage: ((event: { data: unknown }) => void) | null;\n  onerror?: ((event: unknown) => void) | null;\n  terminate?(): void;\n}\n\nexport class WorkerTransport implements Channel {\n  private worker: WorkerLike;\n  private pvtOnMessage: ((frame: Record<string, unknown>) => void) | null = null;\n  private pvtOnClose: (() => void) | null = null;\n  private closed = false;\n\n  constructor(worker: WorkerLike) {\n    this.worker = worker;\n    worker.onmessage = (event) => {\n      if (this.pvtOnMessage && !this.closed) {\n        this.pvtOnMessage(event.data as Record<string, unknown>);\n      }\n    };\n    // An uncaught error in the worker is the closest thing to an abrupt drop.\n    if (\"onerror\" in worker) {\n      worker.onerror = () => {\n        this.closed = true;\n        this.pvtOnClose?.();\n      };\n    }\n  }\n\n  get canSend(): boolean {\n    return !this.closed;\n  }\n\n  onMessage(handler: (frame: Record<string, unknown>) => void): void {\n    if (this.closed) throw new Error(\"WorkerTransport: closed\");\n    if (this.pvtOnMessage !== null) {\n      throw new Error(\"WorkerTransport: handler already set — call removeHandler() first\");\n    }\n    this.pvtOnMessage = handler;\n  }\n\n  removeHandler(): ((frame: Record<string, unknown>) => void) | null {\n    const prev = this.pvtOnMessage;\n    this.pvtOnMessage = null;\n    return prev;\n  }\n\n  onClose(handler: () => void): void {\n    this.pvtOnClose = handler;\n  }\n\n  get hasHandler(): boolean {\n    return this.pvtOnMessage !== null;\n  }\n\n  async send(frame: Record<string, unknown>): Promise<void> {\n    if (this.closed) throw new Error(\"WorkerTransport: closed\");\n    this.worker.postMessage(frame);\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) return;\n    this.closed = true;\n    this.worker.terminate?.();\n  }\n}\n","/* eslint-disable unicorn/prefer-add-event-listener */\n// ── WebSocket client spawner ────────────────────────────────────────────────────\n//\n// Environment-specific: connects to a `ws://` URL with the WHATWG WebSocket,\n// wraps it in a WebSocketTransport, and returns a frame Channel with the $proto\n// handshake already validated.\n//\n// How the socket is opened is the caller's.  The second parameter constructs one from a URL, which is\n// what a runtime's own client takes; an opener replaces it with a function of the connection, which is\n// where a header belongs — a token in a URL is a token in every log the URL passes through — and the\n// only place a value that varies per spawn can be attached at all.\n\nimport { WebSocketTransport } from \"../transports/websocket.js\";\nimport { json1Channel, VERSION } from \"../protocols/json1.js\";\nimport { isProto } from \"../channel.js\";\nimport type { ClientSpawner } from \"../client.js\";\n\n/** The socket the spawner needs: what the transport reads and writes, and the open/error slots. */\nexport type OpenedWebSocket = {\n  readonly readyState: number;\n  send(data: string): void;\n  close(code?: number, reason?: string): void;\n  onopen: (() => void) | null;\n  onerror: ((err: unknown) => void) | null;\n  onmessage: ((event: { data: unknown }) => void) | null;\n  onclose: (() => void) | null;\n};\n\nexport type WebSocketCtor = new (url: string) => OpenedWebSocket;\n\n/**\n * How a socket is opened when a constructor is not enough: the URL to open, and the arguments this\n * spawn was called with.  A per-tenant header, a bearer token, an authority the machine does not\n * already know — each of them is a fact about the connection, and each of them is the caller's to\n * express in its own runtime's shape rather than in one posipaki was taught.\n */\nexport type WebSocketOpener<Args = unknown> = (url: string, args: Args) => OpenedWebSocket;\n\nexport interface WebSocketClientOptions<Args = unknown> {\n  /** Opens the socket.  Given, it replaces the constructor. */\n  open?: WebSocketOpener<Args>;\n}\n\nconst defaultWebSocket = (globalThis as { WebSocket?: WebSocketCtor }).WebSocket;\n\n/** What a socket failure says about itself.\n *\n * A WHATWG WebSocket reports an open failure as an ErrorEvent, and `String(event)` is\n * `[object ErrorEvent]`: its type, its message and the underlying error are all in its\n * own fields, so read those rather than stringify the event that carries them.\n */\nfunction describeSocketError(err: unknown): string {\n  if (typeof err !== \"object\" || err === null) return String(err);\n  const event = err as { type?: unknown; message?: unknown; error?: unknown };\n  const cause = event.error instanceof Error ? event.error.message : event.error;\n  const parts = [event.type, event.message, cause].filter(\n    (part): part is string => typeof part === \"string\" && part.length > 0,\n  );\n  return parts.length > 0 ? parts.join(\": \") : String(err);\n}\n\nfunction openWebSocket(ws: { readonly readyState: number; onopen: (() => void) | null; onerror: ((err: unknown) => void) | null }): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (ws.readyState === 1 /* OPEN */) return resolve();\n    ws.onopen = () => resolve();\n    ws.onerror = (err) => reject(new Error(`websocket failed to open: ${describeSocketError(err)}`));\n  });\n}\n\nexport function wsClientSpawner<Args = unknown>(\n  url: string | ((args: Args) => string),\n  WebSocketImpl: WebSocketCtor = defaultWebSocket as WebSocketCtor,\n  opts: WebSocketClientOptions<Args> = {},\n): ClientSpawner<Args> {\n  // The constructor is the default opener, so the socket is opened one way either way.\n  const open: WebSocketOpener<Args> = opts.open ?? ((target) => new WebSocketImpl(target));\n  return async (args) => {\n    const target = typeof url === \"function\" ? url(args) : url;\n    const ws = open(target, args);\n    const transport = new WebSocketTransport(ws);\n    const channel = json1Channel(transport);\n\n    // Set the $proto waiter before awaiting open so a fast server's handshake\n    // frame is not dropped.\n    const protoPromise = new Promise<Record<string, unknown>>((resolve) => {\n      channel.onMessage((frame) => resolve(frame));\n    });\n    await openWebSocket(ws);\n    const protoFrame = await protoPromise;\n    channel.removeHandler();\n\n    if (!isProto(protoFrame) || protoFrame.$proto !== VERSION) {\n      throw new Error(`unsupported protocol: ${JSON.stringify(protoFrame).slice(0, 50)}`);\n    }\n    return channel;\n  };\n}\n","// ── WebSocket server spawner ────────────────────────────────────────────────────\n//\n// Environment-specific: serves an already-upgraded WebSocket connection.  The\n// consumer's HTTP server does the upgrade and hands us the socket; we wrap it in\n// a WebSocketTransport, send $proto, and return the frame Channel.\n\nimport { WebSocketTransport, type WebSocketLike } from \"../transports/websocket.js\";\nimport { json1Channel, VERSION } from \"../protocols/json1.js\";\nimport type { Spawner } from \"../server.js\";\n\nexport function wsServerSpawner(ws: WebSocketLike): Spawner {\n  return async () => {\n    const channel = json1Channel(new WebSocketTransport(ws));\n    await channel.send({ $proto: VERSION });\n    return channel;\n  };\n}\n\n/**\n * A minimal Bun `ServerWebSocket` — `send`/`close`/`readyState` plus the data\n * slot the server uses to stash per-connection state.  Bun delivers message and\n * close events through the `Bun.serve` websocket config callbacks, not through\n * properties on the socket, so the consumer routes them onto the adapter.\n */\nexport interface BunServerWebSocketLike {\n  send(data: string): void;\n  close(code?: number, reason?: string): void;\n  readonly readyState: number;\n  data?: unknown;\n}\n\n/**\n * Adapt a Bun server socket to the `WebSocketLike` the transport consumes.  The\n * returned adapter owns settable `onmessage`/`onclose` slots; the consumer\n * routes Bun's `message`/`close` config callbacks into them, e.g.:\n *\n * ```ts\n * Bun.serve({\n *   websocket: {\n *     open(ws) {\n *       const adapter = bunServerWebSocket(ws);\n *       ws.data = adapter;\n *       serveRemoteActor(actor, wsServerSpawner(adapter));\n *     },\n *     message(ws, msg) { (ws.data as WebSocketLike).onmessage?.({ data: msg }); },\n *     close(ws) { (ws.data as WebSocketLike).onclose?.(); },\n *   },\n * });\n * ```\n */\nexport function bunServerWebSocket(ws: BunServerWebSocketLike): WebSocketLike {\n  return {\n    send: (data) => ws.send(data),\n    close: (code, reason) => ws.close(code, reason),\n    readyState: ws.readyState,\n    onmessage: null,\n    onclose: null,\n  };\n}\n","// ── Worker client spawner (command) ─────────────────────────────────────────────\n//\n// Environment-specific: spawns a Worker with the WHATWG `new Worker(url)` API,\n// wraps it in a WorkerTransport, and returns a frame Channel with the $proto\n// handshake already validated.\n\nimport { WorkerTransport, WORKER_VERSION, type WorkerLike } from \"../transports/worker.js\";\nimport { isProto } from \"../channel.js\";\nimport type { ClientSpawner } from \"../client.js\";\n\nexport type WorkerCtor = new (url: string) => WorkerLike;\n\nconst defaultWorker = (globalThis as { Worker?: WorkerCtor }).Worker;\n\nexport function workerClientSpawner<Args = unknown>(\n  url: string | ((args: Args) => string),\n  WorkerImpl: WorkerCtor = defaultWorker as WorkerCtor,\n): ClientSpawner<Args> {\n  return async (args) => {\n    const target = typeof url === \"function\" ? url(args) : url;\n    const channel = new WorkerTransport(new WorkerImpl(target));\n\n    const protoFrame = await new Promise<Record<string, unknown>>((resolve) => {\n      channel.onMessage((frame) => resolve(frame));\n    });\n    channel.removeHandler();\n\n    if (!isProto(protoFrame) || protoFrame.$proto !== WORKER_VERSION) {\n      throw new Error(`unsupported protocol: ${JSON.stringify(protoFrame).slice(0, 50)}`);\n    }\n    return channel;\n  };\n}\n","// ── Worker server spawner (self) ────────────────────────────────────────────────\n//\n// Environment-specific: serves the worker-global scope (`self`) as a frame\n// Channel with the $proto handshake already sent.  The worker entry script calls\n// `serveRemoteActor(actor, workerSelfSpawner())`.\n\nimport { WorkerTransport, WORKER_VERSION, type WorkerLike } from \"../transports/worker.js\";\nimport type { Spawner } from \"../server.js\";\n\nexport function workerSelfSpawner(selfScope: WorkerLike = globalThis as unknown as WorkerLike): Spawner {\n  return async () => {\n    const channel = new WorkerTransport(selfScope);\n    await channel.send({ $proto: WORKER_VERSION });\n    return channel;\n  };\n}\n"],"mappings":"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"}

package/dist/remote/node.d.ts

@@ -1,9 +1,10 @@
 import { i as Message } from "../types-DYd-DDFB.js";
 import { h as MethodOptions, l as ActorDefinition, p as HandlerOptions, v as ReflectionOptions } from "../hooks-D1QaP6Vv.js";
-import { a as Channel, n as ClientSpawner, s as StringTransport } from "../client-GrwWOUBV.js";
+import { S as Channel, a as ClientSpawner, l as Listener, n as WebSocketLike, w as StringTransport } from "../websocket-BYNYSi7b.js";
 import { FileHandle } from "node:fs/promises";
 import { ChildProcess, StdioOptions } from "node:child_process";
-import { Readable, Writable } from "node:stream";
+import { Duplex, Readable, Writable } from "node:stream";
+import { IncomingMessage } from "node:http";
 //#region src/remote/transports/fifo.d.ts
 declare class FifoUtf8NlineTransport implements StringTransport {
   private readFd;
@@ -418,5 +419,135 @@ declare function hostRemote<Args>(spec: Omit<RemoteSpec<Args>, "name" | "entry">
   name?: string;
 }): ClientSpawner<Args>;
 //#endregion
-export { type BootstrapReport, type ClientChannelOptions, DEFAULT_KIT_PARENT, DEFAULT_RUNTIMES, FifoUtf8NlineTransport, GATEWAY_ARTIFACT, GATEWAY_ENTRY, GATEWAY_FAILED, type GatewayBoot, HANDSHAKE_TIMEOUT_MS, type HostProgram, type HostResult, type HostRun, type HostVersion, HostVersionError, type HostVersionVerdict, KIT_LAYOUT, type Kit, type KitApp, type KitFile, type LineStreams, LineTransport, type MakeKitOptions, type OutputFd, OutputFilter, type OutputFrame, type OutputSink, PAYLOAD_ARTIFACT, PAYLOAD_REFUSED, type RemoteSpec, RemoteSpecError, type RemoteWayIn, type SpawnChild, StdioWireError, type SubprocessActorBundle, type SubprocessActorOptions, bootstrapScript, clientChannel, commandSpawner, defineSubprocessActor, errorFrame, errorReason, fdStreams, fifoArgvSpawner, gatewayArgs, gatewayBoot, gatewayClient, hostRemote, hostVersion, hostVersionAccepts, kitVersion, makeKit, outputFrame, parseBootstrapReport, parseHostVersion, parseOutputFrame, runGateway, runHost, sameHostVersion, serverChannel, sha256Hex, spawnChild, stderrSink };
+//#region src/remote/socket.d.ts
+/** What a listener knows about an accepted connection before an actor exists for it. */
+interface UnixSocketPeer {
+  /** The path this side is bound to. */
+  readonly path: string;
+  /**
+   * The peer's credentials, where the runtime gives them (Linux `SO_PEERCRED`).  Node exposes none on a
+   * unix socket today, so this is undefined under node; the field is here for a runtime that can.
+   */
+  readonly peer?: {
+    readonly uid: number;
+    readonly gid: number;
+    readonly pid?: number;
+  };
+}
+interface UnixSocketListenerOptions<Meta = unknown> {
+  /** The socket file.  Made when the listener starts, and removed when it stops. */
+  path: string;
+  /** The mode of the socket file, set before the first connection is taken.  Default 0o600. */
+  mode?: number;
+  /**
+   * Whether a path that exists and refuses a connection may be replaced: a socket nobody listens on is a
+   * crash's leftover.  A path that is not a socket at all is refused rather than removed.
+   */
+  replaceStale?: boolean;
+  /** The listen backlog, passed through to the runtime. */
+  backlog?: number;
+  /**
+   * Admission and identity.  What it returns is the connection's meta; throwing refuses the connection
+   * before any actor exists.
+   */
+  identify?(peer: UnixSocketPeer): Meta | Promise<Meta>;
+}
+interface UnixSocketClientOptions {
+  /** How long to wait for the connection, in milliseconds.  Default 5000. */
+  timeoutMs?: number;
+}
+/**
+ * Bind a path and answer connections from it, as the reactor's Listener: the socket file is made before
+ * the first accept, its mode is set before the first connection is taken, and `close()` removes it if it
+ * is still the inode this listener bound.
+ */
+declare function unixSocketListener<Meta = unknown>(options: UnixSocketListenerOptions<Meta>): Promise<Listener<Meta>>;
+/** Connect to a listener: one call, and no open order, since a socket is connected or it is not. */
+declare function connectUnixSocket(path: string, options?: UnixSocketClientOptions): Promise<LineTransport>;
+//#endregion
+//#region src/remote/spawners/socket-client.d.ts
+declare function socketClientSpawner<Args = unknown>(path: string | ((args: Args) => string), options?: UnixSocketClientOptions): ClientSpawner<Args>;
+//#endregion
+//#region src/remote/fifo.d.ts
+/**
+ * The pair, named as the serving side sees it: `read` is where it reads, and `write` where it writes.  The
+ * client side passes the same pair and swaps them, which is what makes it a pair rather than two paths.
+ */
+interface FifoPair {
+  readonly read: string;
+  readonly write: string;
+}
+interface FifoListenerOptions<Meta = unknown> {
+  /** Make the pair when it is missing, and refuse a path that exists and is not a fifo.  Default true. */
+  make?: boolean;
+  /** Admission and identity: what this returns is the connection's meta. */
+  identify?(pair: FifoPair): Meta | Promise<Meta>;
+}
+/**
+ * Make the pair unless it is already there.  A fifo is a file and one pair serves every connection, so
+ * nothing is recreated; something that is not a fifo where the pair goes is refused rather than worked
+ * around, because a regular file read as input is a silence nobody can explain.
+ */
+declare function makeFifoPair(pair: FifoPair): Promise<void>;
+/**
+ * Listen on a pair, as the served side: it reads `pair.read` and writes `pair.write`, and it opens the
+ * write end first.  That order is the handshake: a stream opened for reading on a fifo nobody writes to is
+ * handed an immediate end-of-stream by some runtimes, which closes a connection that never carried a byte.
+ */
+declare function fifoListener<Meta = unknown>(pair: FifoPair, options?: FifoListenerOptions<Meta>): Promise<Listener<Meta>>;
+/**
+ * Connect to a pair, as the client side: it reads what the listener writes and writes what it reads,
+ * and it awaits the `$proto` frame, which is the side of the handshake a served actor speaks.
+ */
+declare function fifoClientSpawner<Args = unknown>(pair: FifoPair | ((args: Args) => FifoPair)): ClientSpawner<Args>;
+//#endregion
+//#region src/remote/websocket.d.ts
+/** A server that reports an upgrade before answering it: node's `http`/`https` server. */
+interface UpgradeSource {
+  on(event: "upgrade", listener: (request: IncomingMessage, socket: Duplex, head: Buffer) => void): unknown;
+  off(event: "upgrade", listener: (request: IncomingMessage, socket: Duplex, head: Buffer) => void): unknown;
+}
+/** What arrived: the request that asked to upgrade, and the URL it asked for. */
+interface WebSocketUpgrade {
+  readonly request: IncomingMessage;
+  readonly url: URL;
+}
+interface WebSocketListenerOptions<Meta = unknown> {
+  /** The server whose upgrades become connections. */
+  server: UpgradeSource;
+  /**
+   * Which path upgrades.  An upgrade on any other path is not this listener's and is left as it
+   * arrived, so one server can route its paths between listeners.  Every path upgrades when it is
+   * not given.
+   */
+  path?: string;
+  /**
+   * Admission and identity.  What it returns is the connection's meta; throwing refuses the upgrade
+   * before any actor exists — a refused connection costs no actor and no channel — and the far side
+   * is told by `refuse`.
+   */
+  identify?(upgrade: WebSocketUpgrade): Meta | Promise<Meta>;
+  /**
+   * Complete the handshake and answer with the socket: the WebSocket implementation's own step,
+   * which is the one thing the library does not carry.  With `ws`:
+   *
+   * ```ts
+   * upgrade: (request, socket, head) =>
+   *   new Promise((resolve) => wss.handleUpgrade(request, socket, head, (ws) => resolve(socketOf(ws))))
+   * ```
+   */
+  upgrade(request: IncomingMessage, socket: Duplex, head: Buffer): Promise<WebSocketLike>;
+  /** What a refused upgrade is told.  Default: `401`, and the socket is closed. */
+  refuse?(socket: Duplex, error: unknown, upgrade: WebSocketUpgrade): void;
+}
+/**
+ * Take connections from an HTTP server's upgrades, as the reactor's `Listener`.
+ *
+ * Admission happens when the upgrade arrives, so a refusal is the far side's before any handshake,
+ * and the handshake happens when a connection is accepted: what the reactor is handed is an open
+ * websocket and the meta it was admitted with.
+ */
+declare function webSocketListener<Meta = unknown>(options: WebSocketListenerOptions<Meta>): Listener<Meta>;
+//#endregion
+export { type BootstrapReport, type ClientChannelOptions, DEFAULT_KIT_PARENT, DEFAULT_RUNTIMES, type FifoListenerOptions, type FifoPair, FifoUtf8NlineTransport, GATEWAY_ARTIFACT, GATEWAY_ENTRY, GATEWAY_FAILED, type GatewayBoot, HANDSHAKE_TIMEOUT_MS, type HostProgram, type HostResult, type HostRun, type HostVersion, HostVersionError, type HostVersionVerdict, KIT_LAYOUT, type Kit, type KitApp, type KitFile, type LineStreams, LineTransport, type MakeKitOptions, type OutputFd, OutputFilter, type OutputFrame, type OutputSink, PAYLOAD_ARTIFACT, PAYLOAD_REFUSED, type RemoteSpec, RemoteSpecError, type RemoteWayIn, type SpawnChild, StdioWireError, type SubprocessActorBundle, type SubprocessActorOptions, type UnixSocketClientOptions, type UnixSocketListenerOptions, type UnixSocketPeer, type UpgradeSource, type WebSocketListenerOptions, type WebSocketUpgrade, bootstrapScript, clientChannel, commandSpawner, connectUnixSocket, defineSubprocessActor, errorFrame, errorReason, fdStreams, fifoArgvSpawner, fifoClientSpawner, fifoListener, gatewayArgs, gatewayBoot, gatewayClient, hostRemote, hostVersion, hostVersionAccepts, kitVersion, makeFifoPair, makeKit, outputFrame, parseBootstrapReport, parseHostVersion, parseOutputFrame, runGateway, runHost, sameHostVersion, serverChannel, sha256Hex, socketClientSpawner, spawnChild, stderrSink, unixSocketListener, webSocketListener };
 //# sourceMappingURL=node.d.ts.map

package/dist/remote/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","names":[],"sources":["../../src/remote/transports/fifo.ts","../../src/remote/spawners/fifo-command.ts","../../src/remote/spawners/fifo-argv.ts","../../src/remote/kit.ts","../../src/remote/define-subprocess.ts","../../src/remote/stdio.ts","../../src/remote/gateway.ts","../../src/remote/host.ts","../../src/remote/gateway-client.ts"],"mappings":"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"}
+{"version":3,"file":"node.d.ts","names":[],"sources":["../../src/remote/transports/fifo.ts","../../src/remote/spawners/fifo-command.ts","../../src/remote/spawners/fifo-argv.ts","../../src/remote/kit.ts","../../src/remote/define-subprocess.ts","../../src/remote/stdio.ts","../../src/remote/gateway.ts","../../src/remote/host.ts","../../src/remote/gateway-client.ts","../../src/remote/socket.ts","../../src/remote/spawners/socket-client.ts","../../src/remote/fifo.ts","../../src/remote/websocket.ts"],"mappings":"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"}