actor-ts 0.9.1 → 0.11.0

package/dist/util/OptionsValidator.js

@@ -0,0 +1,204 @@
+/**
+ * Base class for per-options validators — the `XOptionsValidator` half of
+ * the `XOptions.ts` pattern (see `OptionsBuilder` for the builder half).
+ *
+ * Before this module existed, option values were checked ad hoc inside
+ * individual consumers (and sometimes only on the HOCON path), so a value
+ * supplied via the builder or a plain object could bypass a check entirely.
+ * A validator runs ONCE, at consume time, on the MERGED settings — after
+ * `{ ...defaults, ...options }` / `mergeOptions` — so every input path
+ * (builder, plain object, HOCON) hits the same rules, and cross-field
+ * rules see the final resolved values.
+ *
+ * Subclasses implement {@link rules} using the protected check helpers.
+ * The helpers take only the FIELD NAME (typo-checked against `T` via
+ * {@link KeysMatching}) and read the value from the settings under
+ * validation themselves — the name is what the error message needs, and
+ * the value cannot be recovered from at runtime if only the value were
+ * passed.  Every helper is a no-op when the field is `undefined`: an
+ * unset optional always passes (mirroring `stripUndefined` in
+ * `mergeOptions`); required-ness is enforced elsewhere (e.g.
+ * `BrokerActor.requiredOptions()`).
+ *
+ * Cross-field rules are plain imperative code at the end of `rules(s)` —
+ * guard the participants against `undefined`, then call {@link fail}.
+ *
+ * Validator instances are throwaway check helpers; the short-lived
+ * settings reference held during {@link validate} is harmless (JS is
+ * single-threaded and `rules` never re-enters `validate`).
+ */
+/**
+ * An option value that is well-typed but outside its domain — regardless
+ * of whether it arrived via the builder, a plain object, or HOCON.
+ * (Missing required broker options keep throwing `BrokerOptionsError`;
+ * malformed HOCON keeps throwing `ConfigError` — this error is only for
+ * domain validity of present values.)
+ */
+export class OptionsError extends Error {
+    options;
+    field;
+    value;
+    constructor(message, 
+    /** Options family the value belongs to, e.g. `'MqttOptions'`. */
+    options, 
+    /** Offending field (dotted path for nested fields). */
+    field, 
+    /** The rejected value. */
+    value) {
+        super(message);
+        this.options = options;
+        this.field = field;
+        this.value = value;
+        this.name = 'OptionsError';
+    }
+}
+export class OptionsValidator {
+    optionsName;
+    /** Options under validation — only set for the duration of {@link validate}. */
+    s;
+    constructor(
+    /** Options family, prefixed to every error message, e.g. `'MqttOptions'`. */
+    optionsName) {
+        this.optionsName = optionsName;
+    }
+    /**
+     * Check the (merged) settings; throws {@link OptionsError} on the first
+     * violation.  Unset (`undefined`) fields always pass.
+     */
+    validate(settings) {
+        this.s = settings;
+        try {
+            this.rules(settings);
+        }
+        finally {
+            this.s = undefined;
+        }
+    }
+    /* --------------------------- check helpers --------------------------- */
+    /* All helpers: no-op when the field is undefined, throw OptionsError    */
+    /* otherwise the value violates the rule.                                */
+    /** Finite and `> 0` — durations, intervals, factors. */
+    positiveNumber(field) {
+        const value = this.read(field);
+        if (value === undefined)
+            return;
+        if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+            this.fail(field, 'must be a positive finite number', value);
+        }
+    }
+    /** Integer `>= 1` — counts like quorum sizes, shard counts, retries. */
+    positiveInt(field) {
+        const value = this.read(field);
+        if (value === undefined)
+            return;
+        if (typeof value !== 'number' || !Number.isInteger(value) || value < 1) {
+            this.fail(field, 'must be an integer >= 1', value);
+        }
+    }
+    /** Finite and `>= 0`. */
+    nonNegativeNumber(field) {
+        const value = this.read(field);
+        if (value === undefined)
+            return;
+        if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+            this.fail(field, 'must be a non-negative finite number', value);
+        }
+    }
+    /** Integer `>= 0` — buffer limits, logical DB indexes. */
+    nonNegativeInt(field) {
+        const value = this.read(field);
+        if (value === undefined)
+            return;
+        if (typeof value !== 'number' || !Number.isInteger(value) || value < 0) {
+            this.fail(field, 'must be an integer >= 0', value);
+        }
+    }
+    /** Finite number in `[min, max]` (inclusive). */
+    numberInRange(field, min, max) {
+        const value = this.read(field);
+        if (value === undefined)
+            return;
+        if (typeof value !== 'number' || !Number.isFinite(value) || value < min || value > max) {
+            this.fail(field, `must be a number in [${min}, ${max}]`, value);
+        }
+    }
+    /** Integer TCP/UDP port, `1–65535`. */
+    port(field) {
+        const value = this.read(field);
+        if (value === undefined)
+            return;
+        if (typeof value !== 'number' || !Number.isInteger(value) || value < 1 || value > 65535) {
+            this.fail(field, 'must be an integer port in [1, 65535]', value);
+        }
+    }
+    /** Exactly one of the allowed literals — enum-like fields. */
+    oneOf(field, allowed) {
+        const value = this.read(field);
+        if (value === undefined)
+            return;
+        if (!allowed.includes(value)) {
+            this.fail(field, `must be one of ${allowed.map((a) => this.show(a)).join(', ')}`, value);
+        }
+    }
+    /** Non-empty string. */
+    nonEmptyString(field) {
+        const value = this.read(field);
+        if (value === undefined)
+            return;
+        if (typeof value !== 'string' || value.length === 0) {
+            this.fail(field, 'must be a non-empty string', value);
+        }
+    }
+    /** Array with at least one entry. */
+    nonEmptyArray(field) {
+        const value = this.read(field);
+        if (value === undefined)
+            return;
+        if (!Array.isArray(value) || value.length === 0) {
+            this.fail(field, 'must contain at least one entry', value);
+        }
+    }
+    /**
+     * Parseable URL (via `new URL()`), optionally restricted to the given
+     * protocols (without the trailing `:`, e.g. `['mqtt', 'mqtts']`).
+     */
+    url(field, protocols) {
+        const value = this.read(field);
+        if (value === undefined)
+            return;
+        let parsed;
+        try {
+            parsed = new URL(value);
+        }
+        catch {
+            this.fail(field, 'must be a valid URL', value);
+        }
+        if (protocols !== undefined) {
+            const proto = parsed.protocol.replace(/:$/, '');
+            if (!protocols.includes(proto)) {
+                this.fail(field, `must use protocol ${protocols.join(', ')}`, value);
+            }
+        }
+    }
+    /**
+     * Throw a formatted {@link OptionsError} — for cross-field and other
+     * bespoke rules.  `field` is free-form so nested paths like
+     * `'circuitBreaker.resetMs'` work.
+     */
+    fail(field, reason, value) {
+        const got = arguments.length >= 3 ? ` (got ${this.show(value)})` : '';
+        throw new OptionsError(`${this.optionsName}: ${field} ${reason}${got}`, this.optionsName, field, value);
+    }
+    /** Value of `field` in the settings under validation. */
+    read(field) {
+        if (this.s === undefined) {
+            throw new Error('OptionsValidator check helpers must be called from within rules()');
+        }
+        return this.s[field];
+    }
+    /** Render a value for an error message — strings quoted, rest via String(). */
+    show(value) {
+        return typeof value === 'string' ? JSON.stringify(value) : String(value);
+    }
+}
+//# sourceMappingURL=OptionsValidator.js.map

package/dist/util/OptionsValidator.js.map

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

package/dist/util/Try.js

@@ -166,10 +166,10 @@ 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);
+    for (const attempt of tries) {
+        if (attempt.isFailure())
+            return attempt;
+        out.push(attempt.value);
     }
     return new Success(out);
 }

package/dist/util/Try.js.map

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

package/dist/worker/WorkerCluster.d.ts

@@ -1,18 +1,9 @@
 import { NodeAddress } from '../cluster/NodeAddress.js';
 import type { BrokeredMessage } from '../cluster/transports/MessageChannelTransport.js';
 import { type WorkerLike } from '../runtime/worker/index.js';
+import type { WorkerClusterOptions } from './WorkerClusterOptions.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;
@@ -50,10 +41,10 @@ export interface WorkerTransportMessage {
 export declare class WorkerCluster {
     readonly broker: WorkerBroker;
     private readonly handles;
-    private readonly settings;
+    private readonly options;
     private closed;
     private constructor();
-    static spawn(settings: WorkerClusterSettings): Promise<WorkerCluster>;
+    static spawn(options: WorkerClusterOptions): Promise<WorkerCluster>;
     get addresses(): NodeAddress[];
     get size(): number;
     terminate(): Promise<void>;

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

@@ -1 +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"}
+{"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;AAE/E,OAAO,KAAK,EAAE,oBAAoB,EAA4B,MAAM,2BAA2B,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;AAE9D,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,OAAO,CAEqD;IAC7E,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO;WAkBM,KAAK,CAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC;IAUzB,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

@@ -1,5 +1,6 @@
 import { NodeAddress } from '../cluster/NodeAddress.js';
 import { getWorkerBackend } from '../runtime/worker/index.js';
+import { WorkerClusterOptionsValidator } from './WorkerClusterOptions.js';
 import { WorkerBroker } from './WorkerBroker.js';
 /**
  * Spawn a pool of workers and wire them into a shared broker via their
@@ -15,25 +16,27 @@ import { WorkerBroker } from './WorkerBroker.js';
 export class WorkerCluster {
     broker;
     handles = [];
-    settings;
+    options;
     closed = false;
-    constructor(broker, settings, resolvedWorkers) {
+    constructor(broker, options, resolvedWorkers) {
         this.broker = broker;
-        this.settings = {
-            bootstrap: settings.bootstrap,
+        this.options = {
+            bootstrap: options.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',
+            systemName: options.systemName ?? 'worker-cluster',
+            hostname: options.hostname ?? 'worker',
+            basePort: options.basePort ?? 1,
+            initData: options.initData ?? null,
+            readyTimeoutMs: options.readyTimeoutMs ?? 10_000,
+            restartPolicy: options.restartPolicy ?? 'on-failure',
         };
     }
-    static async spawn(settings) {
-        const workers = resolveWorkerCount(settings.workers);
+    static async spawn(options) {
+        const resolvedOptions = options;
+        new WorkerClusterOptionsValidator().validate(resolvedOptions);
+        const workers = resolveWorkerCount(resolvedOptions.workers);
         const broker = new WorkerBroker();
-        const cluster = new WorkerCluster(broker, settings, workers);
+        const cluster = new WorkerCluster(broker, resolvedOptions, workers);
         await cluster._start();
         return cluster;
     }
@@ -43,9 +46,9 @@ export class WorkerCluster {
         if (this.closed)
             return;
         this.closed = true;
-        for (const h of this.handles) {
+        for (const handle of this.handles) {
             try {
-                h.worker.terminate();
+                handle.worker.terminate();
             }
             catch { /* ignore */ }
         }
@@ -53,27 +56,27 @@ export class WorkerCluster {
         this.handles.length = 0;
     }
     async _start() {
-        const total = this.settings.workers === 'auto'
+        const total = this.options.workers === 'auto'
             ? resolveWorkerCount('auto')
-            : this.settings.workers;
+            : this.options.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 addr = new NodeAddress(this.options.systemName, this.options.hostname, this.options.basePort + index);
         const backend = await getWorkerBackend();
-        const url = this.settings.bootstrap instanceof URL
-            ? this.settings.bootstrap
-            : new URL(this.settings.bootstrap);
+        const url = this.options.bootstrap instanceof URL
+            ? this.options.bootstrap
+            : new URL(this.options.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,
+            systemName: this.options.systemName,
+            data: this.options.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.
@@ -108,8 +111,8 @@ export class WorkerCluster {
         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);
+                reject(new Error(`Worker ${addr} did not become ready within ${this.options.readyTimeoutMs}ms`));
+            }, this.options.readyTimeoutMs);
             const onMessage = (e) => {
                 const msg = (e.data ?? undefined);
                 if (!msg)
@@ -131,8 +134,8 @@ export class WorkerCluster {
             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);
+            const should = this.options.restartPolicy === 'always' ||
+                (this.options.restartPolicy === 'on-failure' && crashed);
             if (!should)
                 return;
             const i = this.handles.findIndex(h => h.address.equals(addr));
@@ -148,9 +151,9 @@ 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 workerCount = parseInt(process.env.ACTOR_TS_WORKERS, 10);
+        if (Number.isFinite(workerCount) && workerCount > 0)
+            return workerCount;
     }
     const nav = globalThis.navigator;
     if (nav && typeof nav.hardwareConcurrency === 'number' && nav.hardwareConcurrency > 0) {

package/dist/worker/WorkerCluster.js.map

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

package/dist/worker/WorkerClusterOptions.d.ts

@@ -0,0 +1,61 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
+import type { RestartPolicy } from './WorkerCluster.js';
+/** Plain options-object shape accepted by {@link WorkerCluster.spawn}. */
+export interface WorkerClusterOptionsType {
+    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;
+}
+/**
+ * Fluent builder for {@link WorkerClusterOptionsType}:
+ *
+ *     WorkerCluster.spawn(
+ *       WorkerClusterOptions.create()
+ *         .withBootstrap(new URL('./worker.js', import.meta.url))
+ *         .withWorkers(4),
+ *     )
+ *
+ * `withBootstrap` is mandatory — there is no worker entrypoint to spawn
+ * without it.  Every other field falls back to its built-in default
+ * inside the constructor.
+ */
+export declare class WorkerClusterOptionsBuilder extends OptionsBuilder<WorkerClusterOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new WorkerClusterOptionsBuilder()`. */
+    static create(): WorkerClusterOptionsBuilder;
+    /** Module URL (or string) of the worker entrypoint each worker runs. */
+    withBootstrap(bootstrap: URL | string): this;
+    /** Number of workers to spawn, or `'auto'` (hardware concurrency).  Default: `'auto'` heuristic. */
+    withWorkers(workers: number | 'auto'): this;
+    /** ActorSystem name each worker hosts.  Default: `'worker-cluster'`. */
+    withSystemName(systemName: string): this;
+    /** Hostname component of each worker's {@link NodeAddress}.  Default: `'worker'`. */
+    withHostname(hostname: string): this;
+    /** Port assigned to the first worker; subsequent workers increment.  Default: 1. */
+    withBasePort(basePort: number): this;
+    /** Arbitrary payload delivered to each worker in its init message.  Default: `null`. */
+    withInitData(initData: unknown): this;
+    /** Restart policy for crashed / exited workers.  Default: `'on-failure'`. */
+    withRestartPolicy(restartPolicy: RestartPolicy): this;
+    /** How long to wait for a worker's ready handshake before failing.  Default: 10000ms. */
+    withReadyTimeoutMs(readyTimeoutMs: number): this;
+}
+/** Validates resolved {@link WorkerClusterOptionsType} settings. */
+export declare class WorkerClusterOptionsValidator extends OptionsValidator<WorkerClusterOptionsType> {
+    constructor();
+    protected rules(s: Partial<WorkerClusterOptionsType>): void;
+}
+/**
+ * Accepted input for {@link WorkerCluster.spawn}: the fluent
+ * {@link WorkerClusterOptionsBuilder} OR a plain
+ * {@link WorkerClusterOptionsType} object.
+ */
+export type WorkerClusterOptions = WorkerClusterOptionsBuilder | Partial<WorkerClusterOptionsType>;
+/** Value alias so `WorkerClusterOptions.create()` / `new WorkerClusterOptions()` resolve to the builder. */
+export declare const WorkerClusterOptions: typeof WorkerClusterOptionsBuilder;
+//# sourceMappingURL=WorkerClusterOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerClusterOptions.d.ts","sourceRoot":"","sources":["../../src/worker/WorkerClusterOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,0EAA0E;AAC1E,MAAM,WAAW,wBAAwB;IACvC,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;;;;;;;;;;;;GAYG;AACH,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,wBAAwB,CAAC;IACvF,iFAAiF;IACjF,MAAM,CAAC,MAAM,IAAI,2BAA2B;IAI5C,wEAAwE;IACxE,aAAa,CAAC,SAAS,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI;IAI5C,oGAAoG;IACpG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI3C,wEAAwE;IACxE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIxC,qFAAqF;IACrF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC,oFAAoF;IACpF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC,wFAAwF;IACxF,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAIrC,6EAA6E;IAC7E,iBAAiB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAIrD,yFAAyF;IACzF,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;CAGjD;AAED,oEAAoE;AACpE,qBAAa,6BAA8B,SAAQ,gBAAgB,CAAC,wBAAwB,CAAC;;IAI3F,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,IAAI;CAQ5D;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;AACnG,4GAA4G;AAC5G,eAAO,MAAM,oBAAoB,oCAA8B,CAAC"}

package/dist/worker/WorkerClusterOptions.js

@@ -0,0 +1,70 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import { OptionsValidator } from '../util/OptionsValidator.js';
+/**
+ * Fluent builder for {@link WorkerClusterOptionsType}:
+ *
+ *     WorkerCluster.spawn(
+ *       WorkerClusterOptions.create()
+ *         .withBootstrap(new URL('./worker.js', import.meta.url))
+ *         .withWorkers(4),
+ *     )
+ *
+ * `withBootstrap` is mandatory — there is no worker entrypoint to spawn
+ * without it.  Every other field falls back to its built-in default
+ * inside the constructor.
+ */
+export class WorkerClusterOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new WorkerClusterOptionsBuilder()`. */
+    static create() {
+        return new WorkerClusterOptionsBuilder();
+    }
+    /** Module URL (or string) of the worker entrypoint each worker runs. */
+    withBootstrap(bootstrap) {
+        return this.set('bootstrap', bootstrap);
+    }
+    /** Number of workers to spawn, or `'auto'` (hardware concurrency).  Default: `'auto'` heuristic. */
+    withWorkers(workers) {
+        return this.set('workers', workers);
+    }
+    /** ActorSystem name each worker hosts.  Default: `'worker-cluster'`. */
+    withSystemName(systemName) {
+        return this.set('systemName', systemName);
+    }
+    /** Hostname component of each worker's {@link NodeAddress}.  Default: `'worker'`. */
+    withHostname(hostname) {
+        return this.set('hostname', hostname);
+    }
+    /** Port assigned to the first worker; subsequent workers increment.  Default: 1. */
+    withBasePort(basePort) {
+        return this.set('basePort', basePort);
+    }
+    /** Arbitrary payload delivered to each worker in its init message.  Default: `null`. */
+    withInitData(initData) {
+        return this.set('initData', initData);
+    }
+    /** Restart policy for crashed / exited workers.  Default: `'on-failure'`. */
+    withRestartPolicy(restartPolicy) {
+        return this.set('restartPolicy', restartPolicy);
+    }
+    /** How long to wait for a worker's ready handshake before failing.  Default: 10000ms. */
+    withReadyTimeoutMs(readyTimeoutMs) {
+        return this.set('readyTimeoutMs', readyTimeoutMs);
+    }
+}
+/** Validates resolved {@link WorkerClusterOptionsType} settings. */
+export class WorkerClusterOptionsValidator extends OptionsValidator {
+    constructor() {
+        super('WorkerClusterOptions');
+    }
+    rules(s) {
+        // workers is `number | 'auto'`, so the field-name helpers can't address it.
+        if (s.workers !== undefined && s.workers !== 'auto' && (!Number.isInteger(s.workers) || s.workers < 1)) {
+            this.fail('workers', "must be a positive integer or 'auto'", s.workers);
+        }
+        this.port('basePort');
+        this.positiveNumber('readyTimeoutMs');
+    }
+}
+/** Value alias so `WorkerClusterOptions.create()` / `new WorkerClusterOptions()` resolve to the builder. */
+export const WorkerClusterOptions = WorkerClusterOptionsBuilder;
+//# sourceMappingURL=WorkerClusterOptions.js.map

package/dist/worker/WorkerClusterOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerClusterOptions.js","sourceRoot":"","sources":["../../src/worker/WorkerClusterOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAe/D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,2BAA4B,SAAQ,cAAwC;IACvF,iFAAiF;IACjF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,2BAA2B,EAAE,CAAC;IAC3C,CAAC;IAED,wEAAwE;IACxE,aAAa,CAAC,SAAuB;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,oGAAoG;IACpG,WAAW,CAAC,OAAwB;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,wEAAwE;IACxE,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,qFAAqF;IACrF,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,oFAAoF;IACpF,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,wFAAwF;IACxF,YAAY,CAAC,QAAiB;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,6EAA6E;IAC7E,iBAAiB,CAAC,aAA4B;QAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,yFAAyF;IACzF,kBAAkB,CAAC,cAAsB;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,OAAO,6BAA8B,SAAQ,gBAA0C;IAC3F;QACE,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAChC,CAAC;IACS,KAAK,CAAC,CAAoC;QAClD,4EAA4E;QAC5E,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC;YACvG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sCAAsC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtB,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IACxC,CAAC;CACF;AAQD,4GAA4G;AAC5G,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC"}

package/dist/worker/WorkerNode.js

@@ -9,11 +9,11 @@ import { MessageChannelTransport, } from '../cluster/transports/MessageChannelTr
  */
 export const WorkerNode = {
     async join() {
-        const g = globalThis;
-        const selfScope = g.self ?? g;
+        const globalScope = globalThis;
+        const selfScope = globalScope.self ?? globalScope;
         if (!selfScope)
             throw new Error('WorkerNode.join() must run inside a Worker');
-        const post = selfScope.postMessage ?? g.postMessage;
+        const post = selfScope.postMessage ?? globalScope.postMessage;
         // ---- Phase 1: wait for the init frame from main. ----
         // We install the listener FIRST, then signal readiness via `hello`.
         const init = await new Promise((resolve, reject) => {
@@ -30,8 +30,8 @@ export const WorkerNode = {
             selfScope.onmessage = onMsg;
             const hello = { kind: 'worker-hello' };
             post?.call(selfScope, hello);
-            const t = setTimeout(() => reject(new Error('WorkerNode.join() timed out waiting for init')), 30_000);
-            t.unref?.();
+            const timer = setTimeout(() => reject(new Error('WorkerNode.join() timed out waiting for init')), 30_000);
+            timer.unref?.();
         });
         const self = NodeAddress.fromJSON(init.self);
         // ---- Phase 2: build a PortLike that multiplexes over the worker's