actor-ts 0.9.0

package/dist/LogContext.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shape of a context.  Values are intentionally constrained to JSON-safe
+ * primitives so the context can ride along with cluster-wire envelopes
+ * without bespoke codecs.  Use `JSON.stringify` to serialise more
+ * complex values yourself.
+ */
+export type LogContextData = Readonly<Record<string, string | number | boolean>>;
+/**
+ * The `LogContext` namespace exposes the MDC operations.  The class-
+ * style `LogContext.run(...)` shape follows the MDC pattern — a
+ * scoped, thread-local-like map of diagnostic context that
+ * propagates through every log line inside `fn` — and keeps the
+ * public API tight without exporting the underlying
+ * `AsyncLocalStorage` instance.
+ */
+export declare const LogContext: {
+    /**
+     * Run `fn` with `ctx` as the current context.  The previous context
+     * (if any) is shadowed for the duration of the call and restored
+     * automatically.  Sync and async `fn` both work — `AsyncLocalStorage`
+     * preserves the binding across awaits.
+     */
+    run<T>(ctx: LogContextData, fn: () => T): T;
+    /**
+     * Read the current context.  Returns the frozen empty object when
+     * called outside any `run` — never `undefined`, never `null`, so
+     * callers can `.entries()` over it without guarding.
+     */
+    get(): LogContextData;
+    /**
+     * Run `fn` with `extra` fields merged into the current context.
+     * Equivalent to `run({ ...get(), ...extra }, fn)` but a touch
+     * shorter at call sites that just want to add a field.
+     */
+    with<T>(extra: LogContextData, fn: () => T): T;
+    /**
+     * Capture the current context as a plain (mutable-by-the-caller)
+     * object — useful when you need to pass the context through a
+     * boundary that strips `Readonly` (e.g. a JSON serialiser).
+     * Returns a fresh copy every call.
+     */
+    snapshot(): Record<string, string | number | boolean>;
+};
+//# sourceMappingURL=LogContext.d.ts.map

package/dist/LogContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogContext.d.ts","sourceRoot":"","sources":["../src/LogContext.ts"],"names":[],"mappings":"AAsCA;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;AAQjF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;IACrB;;;;;OAKG;QACC,CAAC,OAAO,cAAc,MAAM,MAAM,CAAC,GAAG,CAAC;IAI3C;;;;OAIG;WACI,cAAc;IAIrB;;;;OAIG;SACE,CAAC,SAAS,cAAc,MAAM,MAAM,CAAC,GAAG,CAAC;IAK9C;;;;;OAKG;gBACS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAGtD,CAAC"}

package/dist/LogContext.js

@@ -0,0 +1,87 @@
+/**
+ * Mapped Diagnostic Context (MDC) — a per-async-call-stack key-value
+ * store that the {@link Logger} reads automatically and that
+ * propagates through actor `tell` / `ask` hops, including across
+ * cluster nodes.  The classic use case: stamp a `correlationId` (or
+ * `userId`, `requestId`, …) at the entry point of a request and have
+ * every log line emitted further down the call stack — by any actor,
+ * on any node — carry the same id, so a multi-hop trail stitches
+ * together in your log aggregator.
+ *
+ *   import { LogContext } from 'actor-ts';
+ *
+ *   LogContext.run({ correlationId: 'abc-123' }, () => {
+ *     this.log.info('processing payment');     // includes correlationId
+ *     paymentRouter.tell({ kind: 'charge' });   // ctx travels with the tell
+ *   });
+ *
+ * **Mechanism.**  Backed by Node's `AsyncLocalStorage` (also
+ * available in Bun and Deno).  Every `tell` snapshots the current
+ * context and stores it on the envelope; the receiving actor's
+ * `onReceive` runs under a fresh `run(envelope.context, ...)`
+ * scope, so the next tell from inside that handler picks up the
+ * same context.  Across cluster nodes, the snapshot rides along
+ * with the wire envelope.
+ *
+ * **Defensive default.**  Outside any `run` call, `get()` returns
+ * an empty object — the logger receives no spurious fields.  Every
+ * `run` opens a NEW scope; nesting merges the parent ctx with the
+ * child via `with()`.
+ *
+ * **Out of scope (vs #10 OpenTelemetry).**  This is the lower-level
+ * primitive — string/number/boolean kv pairs, no spans, no
+ * sampling, no exporter.  OTel sits on top: it can use the same
+ * AsyncLocalStorage to attach span IDs that downstream actors then
+ * see in their `LogContext.get()`.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+/** Single shared storage so every reader sees the same context. */
+const storage = new AsyncLocalStorage();
+/** Empty context returned when no `run` is active.  Frozen for safety. */
+const EMPTY = Object.freeze({});
+/**
+ * The `LogContext` namespace exposes the MDC operations.  The class-
+ * style `LogContext.run(...)` shape follows the MDC pattern — a
+ * scoped, thread-local-like map of diagnostic context that
+ * propagates through every log line inside `fn` — and keeps the
+ * public API tight without exporting the underlying
+ * `AsyncLocalStorage` instance.
+ */
+export const LogContext = {
+    /**
+     * Run `fn` with `ctx` as the current context.  The previous context
+     * (if any) is shadowed for the duration of the call and restored
+     * automatically.  Sync and async `fn` both work — `AsyncLocalStorage`
+     * preserves the binding across awaits.
+     */
+    run(ctx, fn) {
+        return storage.run(ctx, fn);
+    },
+    /**
+     * Read the current context.  Returns the frozen empty object when
+     * called outside any `run` — never `undefined`, never `null`, so
+     * callers can `.entries()` over it without guarding.
+     */
+    get() {
+        return storage.getStore() ?? EMPTY;
+    },
+    /**
+     * Run `fn` with `extra` fields merged into the current context.
+     * Equivalent to `run({ ...get(), ...extra }, fn)` but a touch
+     * shorter at call sites that just want to add a field.
+     */
+    with(extra, fn) {
+        const merged = { ...this.get(), ...extra };
+        return storage.run(merged, fn);
+    },
+    /**
+     * Capture the current context as a plain (mutable-by-the-caller)
+     * object — useful when you need to pass the context through a
+     * boundary that strips `Readonly` (e.g. a JSON serialiser).
+     * Returns a fresh copy every call.
+     */
+    snapshot() {
+        return { ...this.get() };
+    },
+};
+//# sourceMappingURL=LogContext.js.map

package/dist/LogContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogContext.js","sourceRoot":"","sources":["../src/LogContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAUrD,mEAAmE;AACnE,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAkB,CAAC;AAExD,0EAA0E;AAC1E,MAAM,KAAK,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;;;;;OAKG;IACH,GAAG,CAAI,GAAmB,EAAE,EAAW;QACrC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,GAAG;QACD,OAAO,OAAO,CAAC,QAAQ,EAAE,IAAI,KAAK,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAI,KAAqB,EAAE,EAAW;QACxC,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC"}

package/dist/Logger.d.ts

@@ -0,0 +1,57 @@
+import { type LogContextData } from './LogContext.js';
+export declare enum LogLevel {
+    Debug = 0,
+    Info = 1,
+    Warn = 2,
+    Error = 3,
+    Off = 100
+}
+export interface Logger {
+    readonly level: LogLevel;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    /** Create a logger bound to a source (e.g. an actor path). */
+    withSource(source: string): Logger;
+    /**
+     * Create a logger with extra **static** fields baked in.  Unlike
+     * `LogContext` (which is dynamic / per-async-stack), `withFields`
+     * stamps the same fields on every record this logger emits — handy
+     * for component-level tagging like `{ component: 'shard-coordinator' }`
+     * or `{ shardId: 12 }` on a per-entity logger.
+     */
+    withFields(fields: LogContextData): Logger;
+}
+export declare class ConsoleLogger implements Logger {
+    level: LogLevel;
+    private readonly source;
+    private readonly staticFields;
+    constructor(level?: LogLevel, source?: string, staticFields?: LogContextData);
+    private enabled;
+    /**
+     * Build the log line.  Static fields (from `withFields`) and dynamic
+     * MDC (from `LogContext.run`) are merged at emit time — dynamic wins
+     * on key collision because that matches the "innermost scope wins"
+     * intuition.  The fields appear as a `{k=v, k2=v2}` suffix when
+     * non-empty so they don't clutter records that don't use MDC.
+     */
+    private render;
+    debug(msg: string, ...args: unknown[]): void;
+    info(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    error(msg: string, ...args: unknown[]): void;
+    withSource(source: string): Logger;
+    withFields(fields: LogContextData): Logger;
+}
+/** A logger that discards every call. Handy for tests and benchmarks. */
+export declare class NoopLogger implements Logger {
+    readonly level = LogLevel.Off;
+    debug(): void;
+    info(): void;
+    warn(): void;
+    error(): void;
+    withSource(): Logger;
+    withFields(): Logger;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../src/Logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAElE,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,GAAG,MAAM;CACV;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,8DAA8D;IAC9D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC;CAC5C;AAED,qBAAa,aAAc,YAAW,MAAM;IAEjC,KAAK,EAAE,QAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFtB,KAAK,GAAE,QAAwB,EACrB,MAAM,GAAE,MAAW,EACnB,YAAY,GAAE,cAAmB;IAGpD,OAAO,CAAC,OAAO;IAIf;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;IAYd,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAG5C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAG3C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAG3C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI5C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIlC,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;CAG3C;AAED,yEAAyE;AACzE,qBAAa,UAAW,YAAW,MAAM;IACvC,QAAQ,CAAC,KAAK,gBAAgB;IAC9B,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IACZ,IAAI,IAAI,IAAI;IACZ,KAAK,IAAI,IAAI;IACb,UAAU,IAAI,MAAM;IACpB,UAAU,IAAI,MAAM;CACrB"}

package/dist/Logger.js

@@ -0,0 +1,81 @@
+import { LogContext } from './LogContext.js';
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["Debug"] = 0] = "Debug";
+    LogLevel[LogLevel["Info"] = 1] = "Info";
+    LogLevel[LogLevel["Warn"] = 2] = "Warn";
+    LogLevel[LogLevel["Error"] = 3] = "Error";
+    LogLevel[LogLevel["Off"] = 100] = "Off";
+})(LogLevel || (LogLevel = {}));
+export class ConsoleLogger {
+    level;
+    source;
+    staticFields;
+    constructor(level = LogLevel.Info, source = '', staticFields = {}) {
+        this.level = level;
+        this.source = source;
+        this.staticFields = staticFields;
+    }
+    enabled(target) {
+        return target >= this.level;
+    }
+    /**
+     * Build the log line.  Static fields (from `withFields`) and dynamic
+     * MDC (from `LogContext.run`) are merged at emit time — dynamic wins
+     * on key collision because that matches the "innermost scope wins"
+     * intuition.  The fields appear as a `{k=v, k2=v2}` suffix when
+     * non-empty so they don't clutter records that don't use MDC.
+     */
+    render(tag, msg) {
+        const ts = new Date().toISOString();
+        const head = this.source
+            ? `[${ts}] ${tag} ${this.source} - ${msg}`
+            : `[${ts}] ${tag} ${msg}`;
+        const merged = { ...this.staticFields, ...LogContext.get() };
+        const keys = Object.keys(merged);
+        if (keys.length === 0)
+            return head;
+        const tail = keys.map((k) => `${k}=${formatValue(merged[k])}`).join(', ');
+        return `${head} {${tail}}`;
+    }
+    debug(msg, ...args) {
+        if (this.enabled(LogLevel.Debug))
+            console.debug(this.render('DEBUG', msg), ...args);
+    }
+    info(msg, ...args) {
+        if (this.enabled(LogLevel.Info))
+            console.log(this.render('INFO ', msg), ...args);
+    }
+    warn(msg, ...args) {
+        if (this.enabled(LogLevel.Warn))
+            console.warn(this.render('WARN ', msg), ...args);
+    }
+    error(msg, ...args) {
+        if (this.enabled(LogLevel.Error))
+            console.error(this.render('ERROR', msg), ...args);
+    }
+    withSource(source) {
+        return new ConsoleLogger(this.level, source, this.staticFields);
+    }
+    withFields(fields) {
+        return new ConsoleLogger(this.level, this.source, { ...this.staticFields, ...fields });
+    }
+}
+/** A logger that discards every call. Handy for tests and benchmarks. */
+export class NoopLogger {
+    level = LogLevel.Off;
+    debug() { }
+    info() { }
+    warn() { }
+    error() { }
+    withSource() { return this; }
+    withFields() { return this; }
+}
+function formatValue(v) {
+    if (typeof v === 'string')
+        return v;
+    if (typeof v === 'number' || typeof v === 'boolean')
+        return String(v);
+    return JSON.stringify(v);
+}
+//# sourceMappingURL=Logger.js.map

package/dist/Logger.js.map

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

package/dist/Props.d.ts

@@ -0,0 +1,32 @@
+import type { Actor } from './Actor.js';
+import type { Dispatcher } from './Dispatcher.js';
+import type { Mailbox } from './internal/Mailbox.js';
+import type { SupervisorStrategy } from './Supervision.js';
+export type ActorFactory<TMsg> = () => Actor<TMsg>;
+export type MailboxFactory<TMsg> = () => Mailbox<TMsg>;
+export interface PropsConfig<TMsg> {
+    readonly factory: ActorFactory<TMsg>;
+    readonly supervisorStrategy?: SupervisorStrategy;
+    readonly dispatcher?: Dispatcher;
+    readonly mailboxCapacity?: number;
+    /**
+     * Custom mailbox factory — use `BoundedMailbox` or `PriorityMailbox` for
+     * non-default queueing.  When omitted the default `Mailbox` is used.
+     */
+    readonly mailbox?: MailboxFactory<TMsg>;
+}
+/**
+ * Immutable configuration describing how to create an actor.
+ * Use `Props.create(() => new MyActor(...))` and chain `with…` for
+ * additional configuration.
+ */
+export declare class Props<TMsg = unknown> {
+    readonly config: PropsConfig<TMsg>;
+    constructor(config: PropsConfig<TMsg>);
+    static create<TMsg>(factory: ActorFactory<TMsg>): Props<TMsg>;
+    withSupervisorStrategy(strategy: SupervisorStrategy): Props<TMsg>;
+    withDispatcher(dispatcher: Dispatcher): Props<TMsg>;
+    withMailboxCapacity(capacity: number): Props<TMsg>;
+    withMailbox(factory: MailboxFactory<TMsg>): Props<TMsg>;
+}
+//# sourceMappingURL=Props.d.ts.map

package/dist/Props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Props.d.ts","sourceRoot":"","sources":["../src/Props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,MAAM,YAAY,CAAC,IAAI,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;AACnD,MAAM,MAAM,cAAc,CAAC,IAAI,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvD,MAAM,WAAW,WAAW,CAAC,IAAI;IAC/B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;;GAIG;AACH,qBAAa,KAAK,CAAC,IAAI,GAAG,OAAO;aACH,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC;gBAAzB,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC;IAErD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;IAI7D,sBAAsB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,KAAK,CAAC,IAAI,CAAC;IAIjE,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC;IAInD,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC;IAIlD,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;CAGxD"}

package/dist/Props.js

@@ -0,0 +1,27 @@
+/**
+ * Immutable configuration describing how to create an actor.
+ * Use `Props.create(() => new MyActor(...))` and chain `with…` for
+ * additional configuration.
+ */
+export class Props {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    static create(factory) {
+        return new Props({ factory });
+    }
+    withSupervisorStrategy(strategy) {
+        return new Props({ ...this.config, supervisorStrategy: strategy });
+    }
+    withDispatcher(dispatcher) {
+        return new Props({ ...this.config, dispatcher });
+    }
+    withMailboxCapacity(capacity) {
+        return new Props({ ...this.config, mailboxCapacity: capacity });
+    }
+    withMailbox(factory) {
+        return new Props({ ...this.config, mailbox: factory });
+    }
+}
+//# sourceMappingURL=Props.js.map

package/dist/Props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Props.js","sourceRoot":"","sources":["../src/Props.ts"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,MAAM,OAAO,KAAK;IACY;IAA5B,YAA4B,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAEzD,MAAM,CAAC,MAAM,CAAO,OAA2B;QAC7C,OAAO,IAAI,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,sBAAsB,CAAC,QAA4B;QACjD,OAAO,IAAI,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,cAAc,CAAC,UAAsB;QACnC,OAAO,IAAI,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,mBAAmB,CAAC,QAAgB;QAClC,OAAO,IAAI,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,WAAW,CAAC,OAA6B;QACvC,OAAO,IAAI,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/Router.d.ts

@@ -0,0 +1,32 @@
+import type { ActorRef } from './ActorRef.js';
+import { Props } from './Props.js';
+/** Message that tells a router to send the payload to every routee. */
+export declare class Broadcast<T = unknown> {
+    readonly message: T;
+    constructor(message: T);
+}
+/** Strategy that picks the next routee(s) for a message. */
+export type RoutingStrategy = (routees: ReadonlyArray<ActorRef>, state: RouterState) => Iterable<ActorRef>;
+export interface RouterState {
+    readonly messageIndex: number;
+}
+/** Round-robin: one routee per message, cycling through the pool. */
+export declare function roundRobinStrategy(): RoutingStrategy;
+/** Random: one routee picked uniformly for each message. */
+export declare function randomStrategy(): RoutingStrategy;
+/** Broadcast: every routee gets every message. */
+export declare function broadcastStrategy(): RoutingStrategy;
+/**
+ * Helpers that return ready-to-spawn Props for pool-style routers.
+ * Example:
+ *   const pool = system.spawnAnonymous(Router.roundRobin(5, Props.create(() => new Worker())));
+ *   pool.tell('work');
+ *   pool.tell(new Broadcast('announce'));
+ */
+export declare const Router: {
+    roundRobin<TMsg>(size: number, routeeProps: Props<TMsg>): Props<TMsg | Broadcast<TMsg>>;
+    random<TMsg>(size: number, routeeProps: Props<TMsg>): Props<TMsg | Broadcast<TMsg>>;
+    broadcast<TMsg>(size: number, routeeProps: Props<TMsg>): Props<TMsg | Broadcast<TMsg>>;
+    custom<TMsg>(size: number, routeeProps: Props<TMsg>, strategy: RoutingStrategy): Props<TMsg | Broadcast<TMsg>>;
+};
+//# sourceMappingURL=Router.d.ts.map

package/dist/Router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Router.d.ts","sourceRoot":"","sources":["../src/Router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,uEAAuE;AACvE,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO;aACJ,OAAO,EAAE,CAAC;gBAAV,OAAO,EAAE,CAAC;CACvC;AAED,4DAA4D;AAC5D,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,EAChC,KAAK,EAAE,WAAW,KACf,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAExB,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,IAAI,eAAe,CAKhD;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,IAAI,eAAe,CAEnD;AAiCD;;;;;;GAMG;AACH,eAAO,MAAM,MAAM;eACN,IAAI,QAAQ,MAAM,eAAe,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;WAIhF,IAAI,QAAQ,MAAM,eAAe,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;cAIzE,IAAI,QAAQ,MAAM,eAAe,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;WAI/E,IAAI,QAAQ,MAAM,eAAe,KAAK,CAAC,IAAI,CAAC,YAAY,eAAe,GAAG,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;CAG/G,CAAC"}

package/dist/Router.js

@@ -0,0 +1,78 @@
+import { Actor } from './Actor.js';
+import { Props } from './Props.js';
+/** Message that tells a router to send the payload to every routee. */
+export class Broadcast {
+    message;
+    constructor(message) {
+        this.message = message;
+    }
+}
+/** Round-robin: one routee per message, cycling through the pool. */
+export function roundRobinStrategy() {
+    return (routees, state) => {
+        if (routees.length === 0)
+            return [];
+        return [routees[state.messageIndex % routees.length]];
+    };
+}
+/** Random: one routee picked uniformly for each message. */
+export function randomStrategy() {
+    return (routees) => {
+        if (routees.length === 0)
+            return [];
+        return [routees[Math.floor(Math.random() * routees.length)]];
+    };
+}
+/** Broadcast: every routee gets every message. */
+export function broadcastStrategy() {
+    return (routees) => routees;
+}
+class RouterActor extends Actor {
+    cfg;
+    routees = [];
+    counter = 0;
+    constructor(cfg) {
+        super();
+        this.cfg = cfg;
+    }
+    async preStart() {
+        for (let i = 0; i < this.cfg.size; i++) {
+            const routee = this.context.spawn(this.cfg.routeeProps, `routee-${i + 1}`);
+            this.routees.push(routee);
+            this.context.watch(routee);
+        }
+    }
+    onReceive(message) {
+        const senderRef = this.sender.toNullable();
+        if (message instanceof Broadcast) {
+            for (const r of this.routees)
+                r.tell(message.message, senderRef);
+            return;
+        }
+        const targets = this.cfg.strategy(this.routees, { messageIndex: this.counter++ });
+        for (const t of targets)
+            t.tell(message, senderRef);
+    }
+}
+/**
+ * Helpers that return ready-to-spawn Props for pool-style routers.
+ * Example:
+ *   const pool = system.spawnAnonymous(Router.roundRobin(5, Props.create(() => new Worker())));
+ *   pool.tell('work');
+ *   pool.tell(new Broadcast('announce'));
+ */
+export const Router = {
+    roundRobin(size, routeeProps) {
+        return Props.create(() => new RouterActor({ size, routeeProps, strategy: roundRobinStrategy() }));
+    },
+    random(size, routeeProps) {
+        return Props.create(() => new RouterActor({ size, routeeProps, strategy: randomStrategy() }));
+    },
+    broadcast(size, routeeProps) {
+        return Props.create(() => new RouterActor({ size, routeeProps, strategy: broadcastStrategy() }));
+    },
+    custom(size, routeeProps, strategy) {
+        return Props.create(() => new RouterActor({ size, routeeProps, strategy }));
+    },
+};
+//# sourceMappingURL=Router.js.map

package/dist/Router.js.map

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

package/dist/Scheduler.d.ts

@@ -0,0 +1,25 @@
+import type { ActorRef } from './ActorRef.js';
+/** A handle that lets callers cancel a scheduled task. */
+export interface Cancellable {
+    cancel(): boolean;
+    readonly isCancelled: boolean;
+}
+/**
+ * Time-based scheduler — a thin wrapper over `setTimeout` / `setInterval`,
+ * accurate enough for typical use and good enough for tests.  Inject a
+ * `ManualScheduler` from the TestKit when you want fully deterministic
+ * time advancement.
+ */
+export declare class Scheduler {
+    private _cancelled;
+    /** Deliver a message once after a delay. */
+    scheduleOnce<T>(delayMs: number, target: ActorRef<T>, message: T, sender?: ActorRef | null): Cancellable;
+    /** Run a user-supplied function once after a delay. */
+    scheduleOnceFn(delayMs: number, fn: () => void): Cancellable;
+    /** Deliver a message repeatedly at a fixed interval, after an initial delay. */
+    scheduleAtFixedRate<T>(initialDelayMs: number, intervalMs: number, target: ActorRef<T>, message: T, sender?: ActorRef | null): Cancellable;
+    scheduleAtFixedRateFn(initialDelayMs: number, intervalMs: number, fn: () => void): Cancellable;
+    /** @internal Called by the system when terminating. */
+    shutdown(): void;
+}
+//# sourceMappingURL=Scheduler.d.ts.map

package/dist/Scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scheduler.d.ts","sourceRoot":"","sources":["../src/Scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,MAAM,IAAI,OAAO,CAAC;IAClB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAcD;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAS;IAE3B,4CAA4C;IAC5C,YAAY,CAAC,CAAC,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,CAAC,EACV,MAAM,GAAE,QAAQ,GAAG,IAAW,GAC7B,WAAW;IAUd,uDAAuD;IACvD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,WAAW;IAY5D,gFAAgF;IAChF,mBAAmB,CAAC,CAAC,EACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,CAAC,EACV,MAAM,GAAE,QAAQ,GAAG,IAAW,GAC7B,WAAW;IAsBd,qBAAqB,CACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,IAAI,GACb,WAAW;IAoBd,uDAAuD;IACvD,QAAQ,IAAI,IAAI;CACjB"}

package/dist/Scheduler.js

@@ -0,0 +1,112 @@
+class SimpleCancellable {
+    onCancel;
+    _cancelled = false;
+    constructor(onCancel) {
+        this.onCancel = onCancel;
+    }
+    cancel() {
+        if (this._cancelled)
+            return false;
+        this._cancelled = true;
+        this.onCancel();
+        return true;
+    }
+    get isCancelled() { return this._cancelled; }
+}
+/**
+ * Time-based scheduler — a thin wrapper over `setTimeout` / `setInterval`,
+ * accurate enough for typical use and good enough for tests.  Inject a
+ * `ManualScheduler` from the TestKit when you want fully deterministic
+ * time advancement.
+ */
+export class Scheduler {
+    _cancelled = false;
+    /** Deliver a message once after a delay. */
+    scheduleOnce(delayMs, target, message, sender = null) {
+        let handle = setTimeout(() => {
+            handle = null;
+            if (!this._cancelled)
+                target.tell(message, sender);
+        }, delayMs);
+        return new SimpleCancellable(() => {
+            if (handle) {
+                clearTimeout(handle);
+                handle = null;
+            }
+        });
+    }
+    /** Run a user-supplied function once after a delay. */
+    scheduleOnceFn(delayMs, fn) {
+        let handle = setTimeout(() => {
+            handle = null;
+            if (!this._cancelled) {
+                try {
+                    fn();
+                }
+                catch (e) {
+                    console.error('[actor-ts] scheduler error:', e);
+                }
+            }
+        }, delayMs);
+        return new SimpleCancellable(() => {
+            if (handle) {
+                clearTimeout(handle);
+                handle = null;
+            }
+        });
+    }
+    /** Deliver a message repeatedly at a fixed interval, after an initial delay. */
+    scheduleAtFixedRate(initialDelayMs, intervalMs, target, message, sender = null) {
+        let stopped = false;
+        let timeoutHandle = null;
+        let intervalHandle = null;
+        timeoutHandle = setTimeout(() => {
+            timeoutHandle = null;
+            if (stopped || this._cancelled)
+                return;
+            target.tell(message, sender);
+            intervalHandle = setInterval(() => {
+                if (stopped || this._cancelled)
+                    return;
+                target.tell(message, sender);
+            }, intervalMs);
+        }, initialDelayMs);
+        return new SimpleCancellable(() => {
+            stopped = true;
+            if (timeoutHandle)
+                clearTimeout(timeoutHandle);
+            if (intervalHandle)
+                clearInterval(intervalHandle);
+        });
+    }
+    scheduleAtFixedRateFn(initialDelayMs, intervalMs, fn) {
+        let stopped = false;
+        let timeoutHandle = null;
+        let intervalHandle = null;
+        const run = () => {
+            if (stopped || this._cancelled)
+                return;
+            try {
+                fn();
+            }
+            catch (e) {
+                console.error('[actor-ts] scheduler error:', e);
+            }
+        };
+        timeoutHandle = setTimeout(() => {
+            timeoutHandle = null;
+            run();
+            intervalHandle = setInterval(run, intervalMs);
+        }, initialDelayMs);
+        return new SimpleCancellable(() => {
+            stopped = true;
+            if (timeoutHandle)
+                clearTimeout(timeoutHandle);
+            if (intervalHandle)
+                clearInterval(intervalHandle);
+        });
+    }
+    /** @internal Called by the system when terminating. */
+    shutdown() { this._cancelled = true; }
+}
+//# sourceMappingURL=Scheduler.js.map

package/dist/Scheduler.js.map

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