actor-ts 0.9.0

package/dist/typed/Behaviors.js

@@ -0,0 +1,77 @@
+/*
+ * Singleton sentinels — identity-compared at runtime so users can use
+ * `Behaviors.same` directly without wrapping.  Type-cast to Behavior<T> on
+ * access so each usage site can pin T.
+ */
+const SAME = { kind: 'same' };
+const STOPPED = { kind: 'stopped' };
+const UNHANDLED = { kind: 'unhandled' };
+const EMPTY = { kind: 'empty' };
+const IGNORE = { kind: 'ignore' };
+/**
+ * Factory for building Behaviors — the functional facade over the OO
+ * Actor API.  Use these combinators to compose an actor's logic as a tree
+ * of values rather than as an imperative class.
+ */
+export const Behaviors = {
+    /**
+     * Run `factory` once with the actor's context; the returned Behavior is
+     * the first one the actor adopts.  Use this to capture `ctx.self` or spawn
+     * children in the "constructor".
+     */
+    setup(factory) {
+        return { kind: 'setup', factory };
+    },
+    /** Standard receive — gets both context and message. */
+    receive(handler) {
+        return { kind: 'receive', handler };
+    },
+    /** Receive with an additional signal handler. */
+    receiveWithSignal(handler, onSignal) {
+        return { kind: 'receive', handler, onSignal };
+    },
+    /** Receive when you don't need the context — message-only shortcut. */
+    receiveMessage(handler) {
+        return { kind: 'receive', handler: (_ctx, msg) => handler(msg) };
+    },
+    /** Expose the per-actor TimerScheduler to the behavior. */
+    withTimers(factory) {
+        return { kind: 'with-timers', factory };
+    },
+    /**
+     * Expose a capacity-bounded stash buffer.  The inner behavior can stash
+     * user messages (e.g. during init) and call `stash.unstashAll()` later.
+     */
+    withStash(capacity, factory) {
+        return { kind: 'with-stash', capacity, factory };
+    },
+    /**
+     * Wrap a behavior with a supervisor strategy.  Any error thrown from the
+     * wrapped handler is routed through `strategy` — the behavior is restarted
+     * (reset to its initial form), stopped, resumed, or escalated.
+     */
+    supervise(child) {
+        return {
+            onFailure(strategy) {
+                return { kind: 'supervise', child, strategy };
+            },
+        };
+    },
+    /** Sentinel: keep the current behavior. */
+    get same() { return SAME; },
+    /** Sentinel: stop the actor. */
+    get stopped() { return STOPPED; },
+    /** Sentinel: mark the message as unhandled (goes to dead letters). */
+    get unhandled() { return UNHANDLED; },
+    /** Sentinel: accept messages but do nothing — useful as a placeholder. */
+    get empty() { return EMPTY; },
+    /** Sentinel: drop every incoming message silently. */
+    get ignore() { return IGNORE; },
+};
+/** Re-exports for callers that prefer named imports. */
+export const same = () => Behaviors.same;
+export const stopped = () => Behaviors.stopped;
+export const unhandled = () => Behaviors.unhandled;
+export const empty = () => Behaviors.empty;
+export const ignore = () => Behaviors.ignore;
+//# sourceMappingURL=Behaviors.js.map

package/dist/typed/Behaviors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Behaviors.js","sourceRoot":"","sources":["../../src/typed/Behaviors.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,MAAM,IAAI,GAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC5C,MAAM,OAAO,GAAoB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACrD,MAAM,SAAS,GAAsB,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC3D,MAAM,KAAK,GAAkB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/C,MAAM,MAAM,GAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAUlD;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;;;;OAIG;IACH,KAAK,CAAI,OAAmD;QAC1D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACpC,CAAC;IAED,wDAAwD;IACxD,OAAO,CACL,OAA2D;QAE3D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IACtC,CAAC;IAED,iDAAiD;IACjD,iBAAiB,CACf,OAA2D,EAC3D,QAAoE;QAEpE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAChD,CAAC;IAED,uEAAuE;IACvE,cAAc,CAAI,OAAgC;QAChD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;IACnE,CAAC;IAED,2DAA2D;IAC3D,UAAU,CAAI,OAAmD;QAC/D,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,SAAS,CAAI,QAAgB,EAAE,OAA+C;QAC5E,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAI,KAAkB;QAC7B,OAAO;YACL,SAAS,CAAC,QAA4B;gBACpC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YAChD,CAAC;SACF,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,IAAI,IAAI,KAAsB,OAAO,IAAuB,CAAC,CAAC,CAAC;IAE/D,gCAAgC;IAChC,IAAI,OAAO,KAAsB,OAAO,OAA0B,CAAC,CAAC,CAAC;IAErE,sEAAsE;IACtE,IAAI,SAAS,KAAsB,OAAO,SAA4B,CAAC,CAAC,CAAC;IAEzE,0EAA0E;IAC1E,IAAI,KAAK,KAAsB,OAAO,KAAwB,CAAC,CAAC,CAAC;IAEjE,sDAAsD;IACtD,IAAI,MAAM,KAAsB,OAAO,MAAyB,CAAC,CAAC,CAAC;CACpE,CAAC;AAEF,wDAAwD;AACxD,MAAM,CAAC,MAAM,IAAI,GAAG,GAAmB,EAAE,CAAC,SAAS,CAAC,IAAmB,CAAC;AACxE,MAAM,CAAC,MAAM,OAAO,GAAG,GAAmB,EAAE,CAAC,SAAS,CAAC,OAAsB,CAAC;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAG,GAAmB,EAAE,CAAC,SAAS,CAAC,SAAwB,CAAC;AAClF,MAAM,CAAC,MAAM,KAAK,GAAG,GAAmB,EAAE,CAAC,SAAS,CAAC,KAAoB,CAAC;AAC1E,MAAM,CAAC,MAAM,MAAM,GAAG,GAAmB,EAAE,CAAC,SAAS,CAAC,MAAqB,CAAC"}

package/dist/typed/TypedActor.d.ts

@@ -0,0 +1,28 @@
+import { Actor } from '../Actor.js';
+import type { Behavior } from './Behavior.js';
+/**
+ * Runtime host for a Behavior<T>.  Bridges the typed DSL to the OO Actor —
+ * the actor's `onReceive` delegates into whichever Behavior is currently
+ * active, and transitions follow whatever the handler returns.
+ *
+ * The class is internal; users create actors via `spawn(behavior)` on the
+ * typed context or `typedProps(behavior)` at the system level.
+ */
+export declare class TypedActor<T> extends Actor<T> {
+    private readonly initial;
+    private current;
+    private activeSupervise;
+    private readonly stashBuffers;
+    private typedCtx;
+    private signalHandler;
+    constructor(initial: Behavior<T>);
+    preStart(): void;
+    onReceive(message: T): void;
+    postStop(): void;
+    preRestart(reason: Error, _msg?: T): void;
+    private handleSupervise;
+    private resolve;
+    private maybeHandleTerminalSentinel;
+    private forwardToDeadLetters;
+}
+//# sourceMappingURL=TypedActor.d.ts.map

package/dist/typed/TypedActor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypedActor.d.ts","sourceRoot":"","sources":["../../src/typed/TypedActor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAQpC,OAAO,KAAK,EACV,QAAQ,EAUT,MAAM,eAAe,CAAC;AAkBvB;;;;;;;GAOG;AACH,qBAAa,UAAU,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,CAAC,CAAC;IAO7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,aAAa,CAA6E;gBAErE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAExC,QAAQ,IAAI,IAAI;IAShB,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI;IAiC3B,QAAQ,IAAI,IAAI;IAShB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI;IASlD,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,OAAO;IA4Cf,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,oBAAoB;CAG7B"}

package/dist/typed/TypedActor.js

@@ -0,0 +1,194 @@
+import { match } from 'ts-pattern';
+import { Actor } from '../Actor.js';
+import { Props } from '../Props.js';
+import { Directive } from '../Supervision.js';
+import { StashOverflowError, } from '../ActorContext.js';
+/**
+ * Runtime host for a Behavior<T>.  Bridges the typed DSL to the OO Actor —
+ * the actor's `onReceive` delegates into whichever Behavior is currently
+ * active, and transitions follow whatever the handler returns.
+ *
+ * The class is internal; users create actors via `spawn(behavior)` on the
+ * typed context or `typedProps(behavior)` at the system level.
+ */
+export class TypedActor extends Actor {
+    initial;
+    current;
+    activeSupervise = null;
+    stashBuffers = [];
+    typedCtx;
+    signalHandler = null;
+    constructor(initial) {
+        super();
+        this.initial = initial;
+    }
+    preStart() {
+        this.typedCtx = new TypedActorContextImpl(this.context);
+        const resolved = this.resolve(this.initial);
+        // `same` on the initial behavior makes no sense — treat as empty so the
+        // actor exists but drops messages (surfaces the user error as silence).
+        this.current = resolved.kind === 'same' ? { kind: 'empty' } : resolved;
+        this.maybeHandleTerminalSentinel();
+    }
+    onReceive(message) {
+        // Sentinels that short-circuit without running a handler:
+        const shortCircuit = match(this.current)
+            .with({ kind: 'ignore' }, () => true)
+            .with({ kind: 'empty' }, () => true)
+            .with({ kind: 'unhandled' }, () => { this.forwardToDeadLetters(message); return true; })
+            .with({ kind: 'stopped' }, () => { this.forwardToDeadLetters(message); return true; })
+            .with({ kind: 'receive' }, () => false)
+            .exhaustive();
+        if (shortCircuit)
+            return;
+        // `current` is narrowed to ReceiveBehavior by the match above, but TS
+        // can't carry that across the branch — re-narrow locally.
+        const receiveBehavior = this.current;
+        if (receiveBehavior.kind !== 'receive')
+            return;
+        let next;
+        try {
+            next = receiveBehavior.handler(this.typedCtx, message);
+        }
+        catch (err) {
+            if (this.handleSupervise(err))
+                return;
+            throw err;
+        }
+        if (next.kind === 'same')
+            return;
+        if (next.kind === 'unhandled') {
+            this.forwardToDeadLetters(message);
+            return;
+        }
+        const resolved = this.resolve(next);
+        if (resolved.kind === 'same')
+            return; // defensive — resolve shouldn't produce 'same'
+        this.current = resolved;
+        this.maybeHandleTerminalSentinel();
+    }
+    postStop() {
+        if (this.signalHandler) {
+            try {
+                const next = this.signalHandler(this.typedCtx, { kind: 'post-stop' });
+                void next; // we are stopping anyway — nothing to transition into.
+            }
+            catch { /* swallow */ }
+        }
+    }
+    preRestart(reason, _msg) {
+        if (this.signalHandler) {
+            try {
+                this.signalHandler(this.typedCtx, { kind: 'pre-restart', reason });
+            }
+            catch { /* swallow */ }
+        }
+    }
+    /* ---------------- internal ---------------- */
+    handleSupervise(err) {
+        if (!this.activeSupervise)
+            return false;
+        const supervise = this.activeSupervise;
+        const directive = supervise.strategy.decider(err);
+        return match(directive)
+            .with(Directive.Resume, () => true)
+            .with(Directive.Restart, () => {
+            const resolved = this.resolve(supervise.child);
+            this.current = resolved.kind === 'same' ? { kind: 'empty' } : resolved;
+            this.maybeHandleTerminalSentinel();
+            return true;
+        })
+            .with(Directive.Stop, () => {
+            this.context.stopSelf();
+            return true;
+        })
+            .with(Directive.Escalate, () => false)
+            .exhaustive();
+    }
+    resolve(b) {
+        let cur = b;
+        for (let hops = 0; hops < 64; hops++) {
+            const step = match(cur)
+                .with({ kind: 'setup' }, (n) => ({
+                step: 'continue', next: n.factory(this.typedCtx),
+            }))
+                .with({ kind: 'with-timers' }, (n) => ({
+                step: 'continue', next: n.factory(this.context.timers),
+            }))
+                .with({ kind: 'with-stash' }, (n) => {
+                const buf = new StashBufferImpl(n.capacity, this.self);
+                this.stashBuffers.push(buf);
+                return { step: 'continue', next: n.factory(buf) };
+            })
+                .with({ kind: 'supervise' }, (n) => {
+                this.activeSupervise = n;
+                return { step: 'continue', next: n.child };
+            })
+                .with({ kind: 'receive' }, (n) => {
+                if (n.onSignal)
+                    this.signalHandler = n.onSignal;
+                return { step: 'done', final: n };
+            })
+                .with({ kind: 'same' }, (n) => ({ step: 'done', final: n }))
+                .with({ kind: 'stopped' }, (n) => ({ step: 'done', final: n }))
+                .with({ kind: 'unhandled' }, (n) => ({ step: 'done', final: n }))
+                .with({ kind: 'empty' }, (n) => ({ step: 'done', final: n }))
+                .with({ kind: 'ignore' }, (n) => ({ step: 'done', final: n }))
+                .exhaustive();
+            if (step.step === 'done')
+                return step.final;
+            cur = step.next;
+        }
+        throw new Error('Behavior resolution exceeded 64 hops — likely a cycle between deferred factories');
+    }
+    maybeHandleTerminalSentinel() {
+        if (this.current.kind === 'stopped')
+            this.context.stopSelf();
+    }
+    forwardToDeadLetters(message) {
+        this.system.deadLetters.tell(message);
+    }
+}
+/* ---------------- Context ---------------- */
+class TypedActorContextImpl {
+    oo;
+    constructor(oo) {
+        this.oo = oo;
+    }
+    get self() { return this.oo.self; }
+    get path() { return this.oo.path; }
+    get system() { return this.oo.system; }
+    get log() { return this.oo.log; }
+    spawn(behavior, name) {
+        const props = Props.create(() => new TypedActor(behavior));
+        return name !== undefined ? this.oo.spawn(props, name) : this.oo.spawnAnonymous(props);
+    }
+    stop(ref) { this.oo.stop(ref); }
+    watch(ref) { this.oo.watch(ref); }
+    unwatch(ref) { this.oo.unwatch(ref); }
+    get timers() { return this.oo.timers; }
+}
+/* ---------------- StashBuffer ---------------- */
+class StashBufferImpl {
+    capacity;
+    self;
+    buffer = [];
+    constructor(capacity, self) {
+        this.capacity = capacity;
+        this.self = self;
+    }
+    stash(message) {
+        if (this.buffer.length >= this.capacity)
+            throw new StashOverflowError(this.capacity);
+        this.buffer.push(message);
+    }
+    unstashAll() {
+        const drained = this.buffer.splice(0, this.buffer.length);
+        for (const m of drained)
+            this.self.tell(m);
+    }
+    get isEmpty() { return this.buffer.length === 0; }
+    get isFull() { return this.buffer.length >= this.capacity; }
+    get size() { return this.buffer.length; }
+}
+//# sourceMappingURL=TypedActor.js.map

package/dist/typed/TypedActor.js.map

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

package/dist/typed/TypedActorContext.d.ts

@@ -0,0 +1,29 @@
+import type { ActorRef } from '../ActorRef.js';
+import type { ActorPath } from '../ActorPath.js';
+import type { ActorSystem } from '../ActorSystem.js';
+import type { Logger } from '../Logger.js';
+import type { TimerScheduler } from '../ActorContext.js';
+import type { Behavior } from './Behavior.js';
+/**
+ * Typed variant of ActorContext — the runtime API exposed to Behaviors.
+ * Differs from the untyped ActorContext in two ways:
+ *   - `spawn` takes a Behavior instead of Props
+ *   - there is no `become`/`unbecome` — behavior changes happen by returning
+ *     a new Behavior from the message handler.
+ */
+export interface TypedActorContext<T> {
+    readonly self: ActorRef<T>;
+    readonly path: ActorPath;
+    readonly system: ActorSystem;
+    readonly log: Logger;
+    /** Spawn a typed child actor with the given Behavior. */
+    spawn<U>(behavior: Behavior<U>, name?: string): ActorRef<U>;
+    /** Stop a watched child or self. */
+    stop(ref: ActorRef): void;
+    /** Death-watch another actor — you'll receive a Signal when it terminates. */
+    watch(ref: ActorRef): void;
+    unwatch(ref: ActorRef): void;
+    /** Per-actor timers. */
+    readonly timers: TimerScheduler<T>;
+}
+//# sourceMappingURL=TypedActorContext.d.ts.map

package/dist/typed/TypedActorContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypedActorContext.d.ts","sourceRoot":"","sources":["../../src/typed/TypedActorContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,yDAAyD;IACzD,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5D,oCAAoC;IACpC,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE1B,8EAA8E;IAC9E,KAAK,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE7B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;CACpC"}

package/dist/typed/TypedActorContext.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TypedActorContext.js.map

package/dist/typed/TypedActorContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypedActorContext.js","sourceRoot":"","sources":["../../src/typed/TypedActorContext.ts"],"names":[],"mappings":""}

package/dist/typed/index.d.ts

@@ -0,0 +1,7 @@
+export { Behaviors, same, stopped, unhandled, empty, ignore } from './Behaviors.js';
+export type { SuperviseBuilder } from './Behaviors.js';
+export type { Behavior, Signal, StashBuffer, ReceiveBehavior, SetupBehavior, WithTimersBehavior, WithStashBehavior, SuperviseBehavior, SameBehavior, StoppedBehavior, UnhandledBehavior, EmptyBehavior, IgnoreBehavior, } from './Behavior.js';
+export type { TypedActorContext } from './TypedActorContext.js';
+export { TypedActor } from './TypedActor.js';
+export { typedProps } from './spawn.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/typed/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACpF,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EACV,QAAQ,EACR,MAAM,EACN,WAAW,EACX,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/typed/index.js

@@ -0,0 +1,4 @@
+export { Behaviors, same, stopped, unhandled, empty, ignore } from './Behaviors.js';
+export { TypedActor } from './TypedActor.js';
+export { typedProps } from './spawn.js';
+//# sourceMappingURL=index.js.map

package/dist/typed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/typed/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAkBpF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/typed/spawn.d.ts

@@ -0,0 +1,14 @@
+import { Props } from '../Props.js';
+import type { Behavior } from './Behavior.js';
+/**
+ * Wrap a `Behavior<T>` in `Props<T>` so it can be passed to any
+ * OO spawn API (e.g. `ClusterSharding.start`, `ClusterSingleton.start`,
+ * `Props.create` consumers).
+ *
+ * For the common case of spawning a top-level or child typed actor,
+ * prefer `system.spawnTyped(behavior, name)` /
+ * `system.spawnTypedAnonymous(behavior)` (or the same pair on
+ * `ActorContext`) — they call this helper internally.
+ */
+export declare function typedProps<T>(behavior: Behavior<T>): Props<T>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/typed/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/typed/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAE7D"}

package/dist/typed/spawn.js

@@ -0,0 +1,16 @@
+import { Props } from '../Props.js';
+import { TypedActor } from './TypedActor.js';
+/**
+ * Wrap a `Behavior<T>` in `Props<T>` so it can be passed to any
+ * OO spawn API (e.g. `ClusterSharding.start`, `ClusterSingleton.start`,
+ * `Props.create` consumers).
+ *
+ * For the common case of spawning a top-level or child typed actor,
+ * prefer `system.spawnTyped(behavior, name)` /
+ * `system.spawnTypedAnonymous(behavior)` (or the same pair on
+ * `ActorContext`) — they call this helper internally.
+ */
+export function typedProps(behavior) {
+    return Props.create(() => new TypedActor(behavior));
+}
+//# sourceMappingURL=spawn.js.map

package/dist/typed/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../src/typed/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAI,QAAqB;IACjD,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,UAAU,CAAI,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/util/Constants.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Cross-subsystem default values that were previously duplicated as
+ * inline literals across multiple sites.
+ *
+ * Centralising serves two purposes:
+ *   1. **One source of truth** — when the gossip interval needs to
+ *      change, every consumer picks up the new default automatically
+ *      (per-call settings still override at the site).
+ *   2. **Self-documenting magic numbers** — the named export
+ *      `DEFAULT_GOSSIP_INTERVAL_MS` is clearer at the call site than
+ *      a bare `1_000` literal with a comment.
+ *
+ * Naming convention: `DEFAULT_<DOMAIN>_<UNIT>` (always with the unit
+ * suffix, since milliseconds are by far the most common unit and
+ * mixing up `5` (seconds) with `5_000` (milliseconds) is the kind of
+ * bug centralisation should head off).
+ *
+ * **Scope rule**: a value lives here only if it is **shared across
+ * multiple subsystems** (cluster + persistence + ...).  File-local
+ * security-tuned constants (e.g. the `MAX_VERSION_SKEW_MS` in
+ * `Cluster.ts`, whose 24h value is justified by the security-exploit
+ * comment at the call site) stay where they are — moving them here
+ * would obscure the per-site rationale.
+ */
+/**
+ * Default cluster gossip-tick interval.  Used by `Cluster`,
+ * `DistributedPubSubMediator`, and `Receptionist`.
+ */
+export declare const DEFAULT_GOSSIP_INTERVAL_MS = 1000;
+/**
+ * Default ask-reply timeout.  Used by `ClusterClient`,
+ * `ClusterClientReceptionist`, and `DistributedData` quorum
+ * read/write.  Per-call `timeoutMs` overrides at every site.
+ */
+export declare const DEFAULT_ASK_TIMEOUT_MS = 5000;
+/**
+ * Default seed-retry interval — how long a node waits before
+ * re-attempting a failed `Cluster.join`.  3 s balances "give the
+ * seed node time to start" with "fail fast on a missing peer".
+ */
+export declare const DEFAULT_SEED_RETRY_INTERVAL_MS = 3000;
+/**
+ * Default tombstone retention (`Cluster.tombstoneTtlMs`).  24 h
+ * gives slow / partitioned peers a generous window to converge
+ * after a member is removed; once expired, peers can re-mint the
+ * address without resurrecting the tombstone.  See `Cluster.ts`
+ * + #75 for the full lifecycle.
+ *
+ * Note: distinct from `MAX_VERSION_SKEW_MS` in `Cluster.ts` —
+ * those happen to share the same value but have separate
+ * justifications (security-cap vs retention).
+ */
+export declare const DEFAULT_TOMBSTONE_TTL_MS: number;
+/**
+ * Default cadence for the tombstone-pruning sweep.  5 min gives
+ * a useful safety margin around the 24 h TTL without busy-looping.
+ */
+export declare const DEFAULT_TOMBSTONE_PRUNE_INTERVAL_MS: number;
+/**
+ * Default TTL for cache-fronted snapshot stores
+ * (`CachedSnapshotStore`).  5 min suits the typical "actor
+ * restarts a few times during deploy" pattern without holding
+ * stale data forever.
+ */
+export declare const DEFAULT_SNAPSHOT_CACHE_TTL_MS: number;
+//# sourceMappingURL=Constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Constants.d.ts","sourceRoot":"","sources":["../../src/util/Constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,OAAQ,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,QAAuB,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,mCAAmC,QAAiB,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,QAAiB,CAAC"}

package/dist/util/Constants.js

@@ -0,0 +1,66 @@
+/**
+ * Cross-subsystem default values that were previously duplicated as
+ * inline literals across multiple sites.
+ *
+ * Centralising serves two purposes:
+ *   1. **One source of truth** — when the gossip interval needs to
+ *      change, every consumer picks up the new default automatically
+ *      (per-call settings still override at the site).
+ *   2. **Self-documenting magic numbers** — the named export
+ *      `DEFAULT_GOSSIP_INTERVAL_MS` is clearer at the call site than
+ *      a bare `1_000` literal with a comment.
+ *
+ * Naming convention: `DEFAULT_<DOMAIN>_<UNIT>` (always with the unit
+ * suffix, since milliseconds are by far the most common unit and
+ * mixing up `5` (seconds) with `5_000` (milliseconds) is the kind of
+ * bug centralisation should head off).
+ *
+ * **Scope rule**: a value lives here only if it is **shared across
+ * multiple subsystems** (cluster + persistence + ...).  File-local
+ * security-tuned constants (e.g. the `MAX_VERSION_SKEW_MS` in
+ * `Cluster.ts`, whose 24h value is justified by the security-exploit
+ * comment at the call site) stay where they are — moving them here
+ * would obscure the per-site rationale.
+ */
+/**
+ * Default cluster gossip-tick interval.  Used by `Cluster`,
+ * `DistributedPubSubMediator`, and `Receptionist`.
+ */
+export const DEFAULT_GOSSIP_INTERVAL_MS = 1_000;
+/**
+ * Default ask-reply timeout.  Used by `ClusterClient`,
+ * `ClusterClientReceptionist`, and `DistributedData` quorum
+ * read/write.  Per-call `timeoutMs` overrides at every site.
+ */
+export const DEFAULT_ASK_TIMEOUT_MS = 5_000;
+/**
+ * Default seed-retry interval — how long a node waits before
+ * re-attempting a failed `Cluster.join`.  3 s balances "give the
+ * seed node time to start" with "fail fast on a missing peer".
+ */
+export const DEFAULT_SEED_RETRY_INTERVAL_MS = 3_000;
+/**
+ * Default tombstone retention (`Cluster.tombstoneTtlMs`).  24 h
+ * gives slow / partitioned peers a generous window to converge
+ * after a member is removed; once expired, peers can re-mint the
+ * address without resurrecting the tombstone.  See `Cluster.ts`
+ * + #75 for the full lifecycle.
+ *
+ * Note: distinct from `MAX_VERSION_SKEW_MS` in `Cluster.ts` —
+ * those happen to share the same value but have separate
+ * justifications (security-cap vs retention).
+ */
+export const DEFAULT_TOMBSTONE_TTL_MS = 24 * 60 * 60 * 1_000;
+/**
+ * Default cadence for the tombstone-pruning sweep.  5 min gives
+ * a useful safety margin around the 24 h TTL without busy-looping.
+ */
+export const DEFAULT_TOMBSTONE_PRUNE_INTERVAL_MS = 5 * 60 * 1_000;
+/**
+ * Default TTL for cache-fronted snapshot stores
+ * (`CachedSnapshotStore`).  5 min suits the typical "actor
+ * restarts a few times during deploy" pattern without holding
+ * stale data forever.
+ */
+export const DEFAULT_SNAPSHOT_CACHE_TTL_MS = 5 * 60 * 1_000;
+//# sourceMappingURL=Constants.js.map

package/dist/util/Constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constants.js","sourceRoot":"","sources":["../../src/util/Constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,KAAK,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;AAElE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC"}