actor-ts 0.9.0

package/dist/util/Try.js

@@ -0,0 +1,176 @@
+/**
+ * Try<T> — a synchronous computation that either yielded a value
+ * (`Success<T>`) or threw (`Failure`).  Mirrors Scala's `scala.util.Try`.
+ *
+ * Why use it over try/catch directly?
+ *   - **Composition:** `parse().map(...).flatMap(...).getOrElse(default)`
+ *     reads top-to-bottom; try/catch blocks don't.
+ *   - **Typed error context:** `Failure` holds the error as data, so you
+ *     can log / rethrow / recover without touching control flow.
+ *   - **Pattern matching:** plays with `ts-pattern` via
+ *     `P.instanceOf(Success)` / `P.instanceOf(Failure)`.
+ *
+ * Usage:
+ *   const parsed: Try<Config> = Try.of(() => JSON.parse(raw) as Config);
+ *   const port = parsed.map(c => c.port).getOrElse(8080);
+ *
+ *   Try.of(() => riskyOp())
+ *      .map(x => x * 2)
+ *      .recover(err => err instanceof TimeoutError ? 0 : null)
+ *      .fold(
+ *        err => log.warn('failed', err),
+ *        val => use(val),
+ *      );
+ *
+ * `Try` is intentionally sync-only.  For the async case, use plain
+ * `Promise` (which already models success/failure) or a library like
+ * `fp-ts`'s `TaskEither`.
+ */
+/** The computation returned a value. */
+export class Success {
+    value;
+    _tag = 'Success';
+    constructor(value) {
+        this.value = value;
+    }
+    isSuccess() { return true; }
+    isFailure() { return false; }
+    /** Always Success; fallback ignored. */
+    getOrElse(_fallback) { return this.value; }
+    /** Always Success; alternative ignored. */
+    orElse(_alt) { return this; }
+    /** Map the inner value.  A thrown mapper turns this into a Failure. */
+    map(f) {
+        try {
+            return new Success(f(this.value));
+        }
+        catch (e) {
+            return new Failure(e);
+        }
+    }
+    /** Chain to another Try.  A thrown mapper becomes Failure. */
+    flatMap(f) {
+        try {
+            return f(this.value);
+        }
+        catch (e) {
+            return new Failure(e);
+        }
+    }
+    /** Always Success — no recovery runs. */
+    recover(_f) { return this; }
+    /** Always Success — no recovery runs. */
+    recoverWith(_f) { return this; }
+    /** Keep if predicate holds; else Failure with a `FilterError`. */
+    filter(pred, makeError) {
+        try {
+            if (pred(this.value))
+                return this;
+            const err = makeError?.(this.value) ?? new Error(`Try.filter predicate returned false for ${String(this.value)}`);
+            return new Failure(err);
+        }
+        catch (e) {
+            return new Failure(e);
+        }
+    }
+    /** Collapse both cases into one value. */
+    fold(_onFailure, onSuccess) {
+        return onSuccess(this.value);
+    }
+    /** Run a side-effect on the value. */
+    forEach(f) { f(this.value); }
+    /** Convert to a "classic" value — the inner value. */
+    get() { return this.value; }
+    /** Convert to an Option-like shape (null on Failure). */
+    toNullable() { return this.value; }
+    /** Fresh copy of the error, or null. */
+    toError() { return null; }
+}
+/** The computation threw. */
+export class Failure {
+    error;
+    _tag = 'Failure';
+    /** The raw thrown value.  Usually an `Error` but could be anything JS allowed `throw`ing. */
+    constructor(error) {
+        this.error = error;
+    }
+    /**
+     * The error coerced to an `Error`.  Kept as an alias for back-compat
+     * with code that used the previous pipeTo-style `Failure` (which named
+     * the field `cause` and typed it as `Error`).  Prefer `.error` in new
+     * code — `.cause` lies in the sense that we don't control the thrown
+     * value's type, only its coercion.
+     */
+    get cause() {
+        return this.error instanceof Error ? this.error : new Error(String(this.error));
+    }
+    isSuccess() { return false; }
+    isFailure() { return true; }
+    getOrElse(fallback) {
+        return typeof fallback === 'function'
+            ? fallback(this.error)
+            : fallback;
+    }
+    orElse(alt) {
+        return typeof alt === 'function' ? alt() : alt;
+    }
+    map(_f) { return this; }
+    flatMap(_f) { return this; }
+    /** Apply the recovery fn; returned value is wrapped in Success.  `null` keeps the Failure. */
+    recover(f) {
+        try {
+            const recovered = f(this.error);
+            return recovered === null ? this : new Success(recovered);
+        }
+        catch (e) {
+            return new Failure(e);
+        }
+    }
+    /** Apply the recovery fn; its Try return value wholesale replaces this Failure. */
+    recoverWith(f) {
+        try {
+            return f(this.error);
+        }
+        catch (e) {
+            return new Failure(e);
+        }
+    }
+    /** Failure passes through `filter` unchanged. */
+    filter(_pred, _makeError) { return this; }
+    fold(onFailure, _onSuccess) {
+        return onFailure(this.error);
+    }
+    forEach(_f) { }
+    /** Throws the stored error (Scala parity). */
+    get() {
+        if (this.error instanceof Error)
+            throw this.error;
+        throw new Error(String(this.error));
+    }
+    toNullable() { return null; }
+    toError() { return this.error instanceof Error ? this.error : new Error(String(this.error)); }
+}
+/** Run `compute` and wrap the outcome.  Any thrown value becomes `Failure`. */
+export function tryOf(compute) {
+    try {
+        return new Success(compute());
+    }
+    catch (e) {
+        return new Failure(e);
+    }
+}
+/** Factory shortcut for `Success`. */
+export function success(value) { return new Success(value); }
+/** Factory shortcut for `Failure`. */
+export function failure(error) { return new Failure(error); }
+/** Collect successes; short-circuit to the first Failure seen. */
+export function trySequence(tries) {
+    const out = [];
+    for (const t of tries) {
+        if (t.isFailure())
+            return t;
+        out.push(t.value);
+    }
+    return new Success(out);
+}
+//# sourceMappingURL=Try.js.map

package/dist/util/Try.js.map

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

package/dist/util/WrapError.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Uniform helper for wrapping caught exceptions in a typed framework
+ * error class with a contextual message.
+ *
+ * Before:
+ *
+ *   try {
+ *     await client.foo(key);
+ *   } catch (e) {
+ *     throw new CacheError(
+ *       `RedisCache.foo failed for key '${key}': ${(e as Error).message}`,
+ *       e,
+ *     );
+ *   }
+ *
+ * After:
+ *
+ *   try {
+ *     await client.foo(key);
+ *   } catch (e) {
+ *     throw wrapError(e, CacheError, `RedisCache.foo failed for key '${key}'`);
+ *   }
+ *
+ * Two behavioural improvements over the raw `new XxxError(msg, cause)`
+ * pattern:
+ *
+ *   1. **Cause preserved** without inlining the cause's message into
+ *      the wrapped message string.  Consumers read the chain via
+ *      `.cause` (modern Error standard); double-encoding adds noise
+ *      to stack traces.
+ *
+ *   2. **No double-wrapping**: if `e` is already the same `ErrorClass`,
+ *      return it unchanged.  Catches the case where lower layers
+ *      already wrapped (e.g., a Journal calls a backend; the backend
+ *      wraps in `JournalError`; the journal would otherwise wrap
+ *      again in another `JournalError`).
+ *
+ * Type-parameter `E` is inferred from the `ErrorClass` constructor
+ * argument so the return type is the right subclass.
+ */
+export declare function wrapError<E extends Error>(e: unknown, ErrorClass: new (message: string, cause?: unknown) => E, message: string): E;
+//# sourceMappingURL=WrapError.d.ts.map

package/dist/util/WrapError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WrapError.d.ts","sourceRoot":"","sources":["../../src/util/WrapError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,wBAAgB,SAAS,CAAC,CAAC,SAAS,KAAK,EACvC,CAAC,EAAE,OAAO,EACV,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC,EACvD,OAAO,EAAE,MAAM,GACd,CAAC,CAGH"}

package/dist/util/WrapError.js

@@ -0,0 +1,46 @@
+/**
+ * Uniform helper for wrapping caught exceptions in a typed framework
+ * error class with a contextual message.
+ *
+ * Before:
+ *
+ *   try {
+ *     await client.foo(key);
+ *   } catch (e) {
+ *     throw new CacheError(
+ *       `RedisCache.foo failed for key '${key}': ${(e as Error).message}`,
+ *       e,
+ *     );
+ *   }
+ *
+ * After:
+ *
+ *   try {
+ *     await client.foo(key);
+ *   } catch (e) {
+ *     throw wrapError(e, CacheError, `RedisCache.foo failed for key '${key}'`);
+ *   }
+ *
+ * Two behavioural improvements over the raw `new XxxError(msg, cause)`
+ * pattern:
+ *
+ *   1. **Cause preserved** without inlining the cause's message into
+ *      the wrapped message string.  Consumers read the chain via
+ *      `.cause` (modern Error standard); double-encoding adds noise
+ *      to stack traces.
+ *
+ *   2. **No double-wrapping**: if `e` is already the same `ErrorClass`,
+ *      return it unchanged.  Catches the case where lower layers
+ *      already wrapped (e.g., a Journal calls a backend; the backend
+ *      wraps in `JournalError`; the journal would otherwise wrap
+ *      again in another `JournalError`).
+ *
+ * Type-parameter `E` is inferred from the `ErrorClass` constructor
+ * argument so the return type is the right subclass.
+ */
+export function wrapError(e, ErrorClass, message) {
+    if (e instanceof ErrorClass)
+        return e;
+    return new ErrorClass(message, e);
+}
+//# sourceMappingURL=WrapError.js.map

package/dist/util/WrapError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WrapError.js","sourceRoot":"","sources":["../../src/util/WrapError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,MAAM,UAAU,SAAS,CACvB,CAAU,EACV,UAAuD,EACvD,OAAe;IAEf,IAAI,CAAC,YAAY,UAAU;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/dist/worker/WorkerBroker.d.ts

@@ -0,0 +1,29 @@
+import { NodeAddress } from '../cluster/NodeAddress.js';
+import type { PortLike } from '../cluster/transports/MessageChannelTransport.js';
+/**
+ * Main-thread piece of the multi-core cluster.  Collects one `MessagePort`
+ * per worker and forwards `BrokeredMessage`s based on their `to` address.
+ * Unknown destinations are dropped silently — the rest of the cluster
+ * deals with them through the normal dead-letters / failure-detection
+ * paths.
+ *
+ * The broker itself does not speak the cluster gossip protocol; it is
+ * purely a routing layer between worker transports.
+ */
+export declare class WorkerBroker {
+    private readonly ports;
+    private stopped;
+    /**
+     * Register a worker's port — the broker will forward to its peers from
+     * now on and accept inbound traffic from it.
+     */
+    register(address: NodeAddress, port: PortLike): void;
+    /** Drop a worker's port (typically on worker shutdown). */
+    unregister(address: NodeAddress): void;
+    /** Close every port; further messages are dropped. */
+    close(): void;
+    /** Snapshot of currently-registered addresses — diagnostic only. */
+    registered(): NodeAddress[];
+    private onMessage;
+}
+//# sourceMappingURL=WorkerBroker.d.ts.map

package/dist/worker/WorkerBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerBroker.d.ts","sourceRoot":"","sources":["../../src/worker/WorkerBroker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAEV,QAAQ,EACT,MAAM,kDAAkD,CAAC;AAE1D;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAQpD,2DAA2D;IAC3D,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAStC,sDAAsD;IACtD,KAAK,IAAI,IAAI;IASb,oEAAoE;IACpE,UAAU,IAAI,WAAW,EAAE;IAM3B,OAAO,CAAC,SAAS;CAQlB"}

package/dist/worker/WorkerBroker.js

@@ -0,0 +1,74 @@
+import { NodeAddress } from '../cluster/NodeAddress.js';
+/**
+ * Main-thread piece of the multi-core cluster.  Collects one `MessagePort`
+ * per worker and forwards `BrokeredMessage`s based on their `to` address.
+ * Unknown destinations are dropped silently — the rest of the cluster
+ * deals with them through the normal dead-letters / failure-detection
+ * paths.
+ *
+ * The broker itself does not speak the cluster gossip protocol; it is
+ * purely a routing layer between worker transports.
+ */
+export class WorkerBroker {
+    ports = new Map();
+    stopped = false;
+    /**
+     * Register a worker's port — the broker will forward to its peers from
+     * now on and accept inbound traffic from it.
+     */
+    register(address, port) {
+        const key = address.toString();
+        if (this.ports.has(key))
+            throw new Error(`WorkerBroker: address ${key} already registered`);
+        this.ports.set(key, port);
+        port.onmessage = (evt) => this.onMessage(key, evt.data);
+        port.start?.();
+    }
+    /** Drop a worker's port (typically on worker shutdown). */
+    unregister(address) {
+        const key = address.toString();
+        const port = this.ports.get(key);
+        if (!port)
+            return;
+        try {
+            port.onmessage = null;
+        }
+        catch { /* ignore */ }
+        try {
+            port.close?.();
+        }
+        catch { /* ignore */ }
+        this.ports.delete(key);
+    }
+    /** Close every port; further messages are dropped. */
+    close() {
+        this.stopped = true;
+        for (const [, port] of this.ports) {
+            try {
+                port.onmessage = null;
+            }
+            catch { /* ignore */ }
+            try {
+                port.close?.();
+            }
+            catch { /* ignore */ }
+        }
+        this.ports.clear();
+    }
+    /** Snapshot of currently-registered addresses — diagnostic only. */
+    registered() {
+        return Array.from(this.ports.keys()).map(k => NodeAddress.parse(k));
+    }
+    /* -------------------------------- Internal ------------------------------- */
+    onMessage(_sourceKey, env) {
+        if (this.stopped)
+            return;
+        const targetAddr = NodeAddress.fromJSON(env.to);
+        const target = this.ports.get(targetAddr.toString());
+        if (!target)
+            return; // unknown address → drop
+        // Re-post verbatim; receiver's transport trusts the envelope's `from`.
+        target.postMessage(env);
+    }
+}
+//# sourceMappingURL=WorkerBroker.js.map

package/dist/worker/WorkerBroker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerBroker.js","sourceRoot":"","sources":["../../src/worker/WorkerBroker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAMxD;;;;;;;;;GASG;AACH,MAAM,OAAO,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,OAAO,GAAG,KAAK,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,OAAoB,EAAE,IAAc;QAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,qBAAqB,CAAC,CAAC;QAC5F,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,IAAuB,CAAC,CAAC;QAC3E,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;IACjB,CAAC;IAED,2DAA2D;IAC3D,UAAU,CAAC,OAAoB;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC;YAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC;YAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,sDAAsD;IACtD,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,CAAC;gBAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACrD,IAAI,CAAC;gBAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,oEAAoE;IACpE,UAAU;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,+EAA+E;IAEvE,SAAS,CAAC,UAAkB,EAAE,GAAoB;QACxD,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM;YAAE,OAAO,CAAuB,yBAAyB;QACpE,uEAAuE;QACvE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/worker/WorkerCluster.d.ts

@@ -0,0 +1,68 @@
+import { NodeAddress } from '../cluster/NodeAddress.js';
+import type { BrokeredMessage } from '../cluster/transports/MessageChannelTransport.js';
+import { type WorkerLike } from '../runtime/worker/index.js';
+import { WorkerBroker } from './WorkerBroker.js';
+export type RestartPolicy = 'always' | 'on-failure' | 'never';
+export interface WorkerClusterSettings {
+    readonly bootstrap: URL | string;
+    readonly workers?: number | 'auto';
+    readonly systemName?: string;
+    readonly hostname?: string;
+    readonly basePort?: number;
+    readonly initData?: unknown;
+    readonly restartPolicy?: RestartPolicy;
+    readonly readyTimeoutMs?: number;
+}
+export interface WorkerHandle {
+    readonly id: number;
+    readonly address: NodeAddress;
+    readonly worker: WorkerLike;
+}
+export interface WorkerHelloMessage {
+    readonly kind: 'worker-hello';
+}
+export interface WorkerInitMessage {
+    readonly kind: 'worker-init';
+    readonly self: ReturnType<NodeAddress['toJSON']>;
+    readonly systemName: string;
+    readonly data: unknown;
+}
+export interface WorkerReadyMessage {
+    readonly kind: 'worker-ready';
+    readonly self: ReturnType<NodeAddress['toJSON']>;
+}
+/** Wire frame flowing in both directions on every worker↔main channel. */
+export interface WorkerTransportMessage {
+    readonly kind: 'worker-transport';
+    readonly envelope: BrokeredMessage;
+}
+/**
+ * Spawn a pool of workers and wire them into a shared broker via their
+ * native postMessage channel.  Each worker hosts its own ActorSystem +
+ * Cluster; the broker routes `BrokeredMessage`s between workers based on
+ * the envelope's `to` address.
+ *
+ * The underlying Worker implementation is picked per runtime — Bun and
+ * Deno use the Web Worker API, Node.js uses `node:worker_threads` — via
+ * `getWorkerBackend()`.  The cluster code itself never branches on
+ * runtime; it only ever sees a runtime-neutral `WorkerLike`.
+ */
+export declare class WorkerCluster {
+    readonly broker: WorkerBroker;
+    private readonly handles;
+    private readonly settings;
+    private closed;
+    private constructor();
+    static spawn(settings: WorkerClusterSettings): Promise<WorkerCluster>;
+    get addresses(): NodeAddress[];
+    get size(): number;
+    terminate(): Promise<void>;
+    private _start;
+    private spawnOne;
+    /** Create a PortLike wrapper that speaks the BrokeredMessage protocol
+     *  over the worker's native postMessage channel. */
+    private brokerFacade;
+    private handshake;
+    private attachRestartHandler;
+}
+//# sourceMappingURL=WorkerCluster.d.ts.map

package/dist/worker/WorkerCluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerCluster.d.ts","sourceRoot":"","sources":["../../src/worker/WorkerCluster.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,GAAG,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;CAClD;AAED,0EAA0E;AAC1E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAEoD;IAC7E,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO;WAkBM,KAAK,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ3E,IAAI,SAAS,IAAI,WAAW,EAAE,CAA6C;IAC3E,IAAI,IAAI,IAAI,MAAM,CAAgC;IAE5C,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;YAQlB,MAAM;YASN,QAAQ;IA+BtB;wDACoD;IACpD,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,oBAAoB;CAgB7B"}

package/dist/worker/WorkerCluster.js

@@ -0,0 +1,161 @@
+import { NodeAddress } from '../cluster/NodeAddress.js';
+import { getWorkerBackend } from '../runtime/worker/index.js';
+import { WorkerBroker } from './WorkerBroker.js';
+/**
+ * Spawn a pool of workers and wire them into a shared broker via their
+ * native postMessage channel.  Each worker hosts its own ActorSystem +
+ * Cluster; the broker routes `BrokeredMessage`s between workers based on
+ * the envelope's `to` address.
+ *
+ * The underlying Worker implementation is picked per runtime — Bun and
+ * Deno use the Web Worker API, Node.js uses `node:worker_threads` — via
+ * `getWorkerBackend()`.  The cluster code itself never branches on
+ * runtime; it only ever sees a runtime-neutral `WorkerLike`.
+ */
+export class WorkerCluster {
+    broker;
+    handles = [];
+    settings;
+    closed = false;
+    constructor(broker, settings, resolvedWorkers) {
+        this.broker = broker;
+        this.settings = {
+            bootstrap: settings.bootstrap,
+            workers: resolvedWorkers,
+            systemName: settings.systemName ?? 'worker-cluster',
+            hostname: settings.hostname ?? 'worker',
+            basePort: settings.basePort ?? 1,
+            initData: settings.initData ?? null,
+            readyTimeoutMs: settings.readyTimeoutMs ?? 10_000,
+            restartPolicy: settings.restartPolicy ?? 'on-failure',
+        };
+    }
+    static async spawn(settings) {
+        const workers = resolveWorkerCount(settings.workers);
+        const broker = new WorkerBroker();
+        const cluster = new WorkerCluster(broker, settings, workers);
+        await cluster._start();
+        return cluster;
+    }
+    get addresses() { return this.handles.map(h => h.address); }
+    get size() { return this.handles.length; }
+    async terminate() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const h of this.handles) {
+            try {
+                h.worker.terminate();
+            }
+            catch { /* ignore */ }
+        }
+        this.broker.close();
+        this.handles.length = 0;
+    }
+    async _start() {
+        const total = this.settings.workers === 'auto'
+            ? resolveWorkerCount('auto')
+            : this.settings.workers;
+        const ready = [];
+        for (let i = 0; i < total; i++)
+            ready.push(this.spawnOne(i));
+        await Promise.all(ready);
+    }
+    async spawnOne(index) {
+        const addr = new NodeAddress(this.settings.systemName, this.settings.hostname, this.settings.basePort + index);
+        const backend = await getWorkerBackend();
+        const url = this.settings.bootstrap instanceof URL
+            ? this.settings.bootstrap
+            : new URL(this.settings.bootstrap);
+        const worker = backend.spawn(url, { name: `worker-${index}` });
+        const handle = { id: index, address: addr, worker };
+        const init = {
+            kind: 'worker-init',
+            self: addr.toJSON(),
+            systemName: this.settings.systemName,
+            data: this.settings.initData,
+        };
+        // Handshake first (so only one 'message' listener is live during hello/ready),
+        // then wire up the broker — otherwise Bun's multiple-listener path is finicky.
+        await this.handshake(worker, init, addr);
+        const brokerPort = this.brokerFacade(worker);
+        this.broker.register(addr, brokerPort);
+        this.handles.push(handle);
+        this.attachRestartHandler(index, worker, addr);
+    }
+    /** Create a PortLike wrapper that speaks the BrokeredMessage protocol
+     *  over the worker's native postMessage channel. */
+    brokerFacade(worker) {
+        let handler = null;
+        worker.addEventListener('message', (e) => {
+            const msg = (e.data ?? undefined);
+            if (msg && msg.kind === 'worker-transport' && handler) {
+                handler({ data: msg.envelope });
+            }
+        });
+        return {
+            postMessage(v) {
+                const envelope = v;
+                const msg = { kind: 'worker-transport', envelope };
+                worker.postMessage(msg);
+            },
+            get onmessage() { return handler; },
+            set onmessage(h) { handler = h; },
+            close() { handler = null; },
+        };
+    }
+    handshake(worker, init, addr) {
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                worker.removeEventListener('message', onMessage);
+                reject(new Error(`Worker ${addr} did not become ready within ${this.settings.readyTimeoutMs}ms`));
+            }, this.settings.readyTimeoutMs);
+            const onMessage = (e) => {
+                const msg = (e.data ?? undefined);
+                if (!msg)
+                    return;
+                if (msg.kind === 'worker-hello') {
+                    worker.postMessage(init);
+                }
+                else if (msg.kind === 'worker-ready') {
+                    clearTimeout(timeout);
+                    worker.removeEventListener('message', onMessage);
+                    resolve();
+                }
+            };
+            worker.addEventListener('message', onMessage);
+        });
+    }
+    attachRestartHandler(index, worker, addr) {
+        worker.addEventListener('close', (e) => {
+            if (this.closed)
+                return;
+            const crashed = typeof e?.code === 'number' ? e.code !== 0 : true;
+            const should = this.settings.restartPolicy === 'always' ||
+                (this.settings.restartPolicy === 'on-failure' && crashed);
+            if (!should)
+                return;
+            const i = this.handles.findIndex(h => h.address.equals(addr));
+            if (i >= 0) {
+                this.broker.unregister(addr);
+                this.handles.splice(i, 1);
+                void this.spawnOne(index);
+            }
+        });
+    }
+}
+function resolveWorkerCount(value) {
+    if (typeof value === 'number' && value > 0)
+        return value;
+    if (typeof process !== 'undefined' && process.env?.ACTOR_TS_WORKERS) {
+        const n = parseInt(process.env.ACTOR_TS_WORKERS, 10);
+        if (Number.isFinite(n) && n > 0)
+            return n;
+    }
+    const nav = globalThis.navigator;
+    if (nav && typeof nav.hardwareConcurrency === 'number' && nav.hardwareConcurrency > 0) {
+        return nav.hardwareConcurrency;
+    }
+    return 2;
+}
+//# sourceMappingURL=WorkerCluster.js.map

package/dist/worker/WorkerCluster.js.map

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

package/dist/worker/WorkerNode.d.ts

@@ -0,0 +1,20 @@
+import { NodeAddress } from '../cluster/NodeAddress.js';
+import type { Transport } from '../cluster/Transport.js';
+export interface WorkerNodeContext<TInit = unknown> {
+    readonly self: NodeAddress;
+    readonly systemName: string;
+    readonly transport: Transport;
+    readonly initData: TInit;
+    ready(): void;
+}
+/**
+ * Worker-side helper.  Call `await WorkerNode.join()` from **inside an
+ * async function** (`async function main() { … } main();`), NOT as a
+ * top-level `await`.  In Bun, top-level await inside a worker suspends
+ * the module loader in a way that prevents incoming messages from
+ * dispatching to `self.onmessage`, and the handshake hangs forever.
+ */
+export declare const WorkerNode: {
+    join<TInit = unknown>(): Promise<WorkerNodeContext<TInit>>;
+};
+//# sourceMappingURL=WorkerNode.d.ts.map