actor-ts 0.9.0

package/dist/discovery/ReceptionistMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReceptionistMessages.js","sourceRoot":"","sources":["../../src/discovery/ReceptionistMessages.ts"],"names":[],"mappings":"AAGA,+CAA+C;AAC/C,MAAM,OAAO,QAAQ;IAED;IACA;IAEA;IAJlB,YACkB,GAAkB,EAClB,GAAgB;IAChC,qDAAqD;IACrC,UAA2B,IAAI;QAH/B,QAAG,GAAH,GAAG,CAAe;QAClB,QAAG,GAAH,GAAG,CAAa;QAEhB,YAAO,GAAP,OAAO,CAAwB;IAC9C,CAAC;CACL;AAED,4DAA4D;AAC5D,MAAM,OAAO,UAAU;IAEH;IACA;IAFlB,YACkB,GAAkB,EAClB,GAAgB;QADhB,QAAG,GAAH,GAAG,CAAe;QAClB,QAAG,GAAH,GAAG,CAAa;IAC/B,CAAC;CACL;AAED,+BAA+B;AAC/B,MAAM,OAAO,UAAU;IAEH;IACA;IAFlB,YACkB,GAAkB,EAClB,GAAgB;QADhB,QAAG,GAAH,GAAG,CAAe;QAClB,QAAG,GAAH,GAAG,CAAa;IAC/B,CAAC;CACL;AAED,6DAA6D;AAC7D,MAAM,OAAO,IAAI;IAEG;IACA;IAFlB,YACkB,GAAkB,EAClB,OAA6B;QAD7B,QAAG,GAAH,GAAG,CAAe;QAClB,YAAO,GAAP,OAAO,CAAsB;IAC5C,CAAC;CACL;AAED;;;;GAIG;AACH,MAAM,OAAO,SAAS;IAEF;IACA;IAFlB,YACkB,GAAkB,EAClB,OAA6B;QAD7B,QAAG,GAAH,GAAG,CAAe;QAClB,YAAO,GAAP,OAAO,CAAsB;IAC5C,CAAC;CACL;AAED,gCAAgC;AAChC,MAAM,OAAO,WAAW;IAEJ;IACA;IAFlB,YACkB,GAAkB,EAClB,OAA6B;QAD7B,QAAG,GAAH,GAAG,CAAe;QAClB,YAAO,GAAP,OAAO,CAAsB;IAC5C,CAAC;CACL;AAED;;;;GAIG;AACH,MAAM,OAAO,OAAO;IAEA;IACA;IAFlB,YACkB,GAAkB,EAClB,IAAgC;QADhC,QAAG,GAAH,GAAG,CAAe;QAClB,SAAI,GAAJ,IAAI,CAA4B;IAC/C,CAAC;CACL"}

package/dist/discovery/SeedProvider.d.ts

@@ -0,0 +1,17 @@
+import { NodeAddress } from '../cluster/NodeAddress.js';
+/**
+ * Discovery hook used by the cluster bootstrap layer to find seed nodes
+ * without hard-coding them.  `lookup` is called once at startup (and may
+ * be called periodically by higher-level retry logic).
+ *
+ * Implementations include:
+ *   - `DnsSeedProvider` — SRV/A-record lookup.
+ *   - `ConfigSeedProvider` — ENV vars / static config.
+ *   - `AggregateSeedProvider` — chain multiple providers with fallback.
+ *   - `KubernetesApiSeedProvider` — live Pod IPs from the K8s API.
+ */
+export interface SeedProvider {
+    /** Return candidate seed addresses. */
+    lookup(): Promise<NodeAddress[]>;
+}
+//# sourceMappingURL=SeedProvider.d.ts.map

package/dist/discovery/SeedProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedProvider.d.ts","sourceRoot":"","sources":["../../src/discovery/SeedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAClC"}

package/dist/discovery/SeedProvider.js

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

package/dist/discovery/SeedProvider.js.map

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

package/dist/discovery/ServiceKey.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Named, type-tagged lookup handle for the Receptionist.  Two ServiceKeys
+ * compare equal iff their `id` strings match — the type parameter is a
+ * compile-time marker used to tighten inferred ActorRef types on lookup.
+ */
+export declare class ServiceKey<TMsg = unknown> {
+    readonly id: string;
+    /** Phantom field — retains T so inference can round-trip through the key. */
+    readonly _msg: TMsg;
+    constructor(id: string);
+    static of<T>(id: string): ServiceKey<T>;
+    equals(other: ServiceKey): boolean;
+    toString(): string;
+}
+//# sourceMappingURL=ServiceKey.d.ts.map

package/dist/discovery/ServiceKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceKey.d.ts","sourceRoot":"","sources":["../../src/discovery/ServiceKey.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,UAAU,CAAC,IAAI,GAAG,OAAO;aAIR,EAAE,EAAE,MAAM;IAHtC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAG,IAAI,CAAC;gBAEO,EAAE,EAAE,MAAM;IAEtC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAEvC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAClC,QAAQ,IAAI,MAAM;CACnB"}

package/dist/discovery/ServiceKey.js

@@ -0,0 +1,17 @@
+/**
+ * Named, type-tagged lookup handle for the Receptionist.  Two ServiceKeys
+ * compare equal iff their `id` strings match — the type parameter is a
+ * compile-time marker used to tighten inferred ActorRef types on lookup.
+ */
+export class ServiceKey {
+    id;
+    /** Phantom field — retains T so inference can round-trip through the key. */
+    _msg;
+    constructor(id) {
+        this.id = id;
+    }
+    static of(id) { return new ServiceKey(id); }
+    equals(other) { return this.id === other.id; }
+    toString() { return `ServiceKey(${this.id})`; }
+}
+//# sourceMappingURL=ServiceKey.js.map

package/dist/discovery/ServiceKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceKey.js","sourceRoot":"","sources":["../../src/discovery/ServiceKey.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,UAAU;IAIO;IAH5B,6EAA6E;IACpE,IAAI,CAAQ;IAErB,YAA4B,EAAU;QAAV,OAAE,GAAF,EAAE,CAAQ;IAAG,CAAC;IAE1C,MAAM,CAAC,EAAE,CAAI,EAAU,IAAmB,OAAO,IAAI,UAAU,CAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzE,MAAM,CAAC,KAAiB,IAAa,OAAO,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACnE,QAAQ,KAAa,OAAO,cAAc,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;CACxD"}

package/dist/discovery/autoDiscovery.d.ts

@@ -0,0 +1,63 @@
+import { AggregateSeedProvider } from './AggregateSeedProvider.js';
+import type { SeedProvider } from './SeedProvider.js';
+/**
+ * Env-driven defaults for the standard production deployment shapes.
+ * Recognised environment variables (none required — every layer is
+ * optional, the helper returns whatever providers the env supports):
+ *
+ *   - `CLUSTER_SEEDS`         — comma-separated `[system@]host:port` list.
+ *                               Strongest signal; if present, the
+ *                               `ConfigSeedProvider` is preferred over the
+ *                               service-discovery layers.
+ *   - `CLUSTER_SERVICE_NAME`  — name of the service whose members are
+ *                               this cluster's peers.  Drives both the
+ *                               `KubernetesApiSeedProvider` (when running
+ *                               in-pod) and the `DnsSeedProvider`.
+ *   - `CLUSTER_NAMESPACE`     — K8s namespace.  Default: `default`.
+ *   - `KUBERNETES_SERVICE_HOST` — set automatically inside every K8s pod;
+ *                                used as the detection signal for adding
+ *                                the K8s-API provider to the chain.
+ *
+ * Chain order (first non-empty wins):
+ *
+ *   1. `CLUSTER_SEEDS` (ConfigSeedProvider)        — most explicit
+ *   2. K8s API endpoints                            — service mesh
+ *   3. DNS resolve of `CLUSTER_SERVICE_NAME`        — fallback
+ *
+ * If none of the env vars are set, the returned provider's `lookup()`
+ * resolves to `[]` — the cluster boots as the first node in a
+ * single-node topology, which is exactly what local dev wants.
+ */
+export interface AutoDiscoverySettings {
+    /** ActorSystem name to stamp on discovered NodeAddresses. */
+    readonly systemName: string;
+    /** Cluster remoting port to pair each discovered IP with. */
+    readonly port: number;
+    /**
+     * Optional pre-mapped env lookup — useful for tests that want to
+     * exercise the provider chain without mutating `process.env`.
+     * Defaults to `process.env` at call time.
+     */
+    readonly env?: Record<string, string | undefined>;
+    /** Logger for individual provider failures.  Default: no-op. */
+    readonly log?: (msg: string, err?: unknown) => void;
+}
+/**
+ * Build an {@link AggregateSeedProvider} from environment variables —
+ * the default discovery wiring used by `Cluster.bootstrap()` when the
+ * caller doesn't pass `seeds` or `discovery:` explicitly.
+ *
+ * Returns an aggregate even when the env is empty, so the call site
+ * always has a `SeedProvider` to invoke — the resulting `lookup()`
+ * just resolves to `[]` for single-node dev.
+ */
+export declare function autoDiscovery(settings: AutoDiscoverySettings): AggregateSeedProvider;
+/**
+ * Named-provider shorthand used by `Cluster.bootstrap({ discovery: '...' })`.
+ * Pins the chain to a single provider type (configured from env vars)
+ * instead of running the full fallback ladder.  Useful when you know
+ * you're running on K8s and want the bootstrap to fail loudly if the
+ * K8s API isn't reachable, instead of silently falling through to DNS.
+ */
+export declare function singleProviderDiscovery(kind: 'config' | 'dns' | 'kubernetes', settings: AutoDiscoverySettings): SeedProvider;
+//# sourceMappingURL=autoDiscovery.d.ts.map

package/dist/discovery/autoDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoDiscovery.d.ts","sourceRoot":"","sources":["../../src/discovery/autoDiscovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAInE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,qBAAqB,GAAG,qBAAqB,CAmCpF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,YAAY,EACrC,QAAQ,EAAE,qBAAqB,GAC9B,YAAY,CAsCd"}

package/dist/discovery/autoDiscovery.js

@@ -0,0 +1,91 @@
+import { AggregateSeedProvider } from './AggregateSeedProvider.js';
+import { ConfigSeedProvider } from './ConfigSeedProvider.js';
+import { DnsSeedProvider } from './DnsSeedProvider.js';
+import { KubernetesApiSeedProvider } from './KubernetesApiSeedProvider.js';
+function parseSeedList(raw) {
+    return raw.split(',').map(s => s.trim()).filter(Boolean);
+}
+/**
+ * Build an {@link AggregateSeedProvider} from environment variables —
+ * the default discovery wiring used by `Cluster.bootstrap()` when the
+ * caller doesn't pass `seeds` or `discovery:` explicitly.
+ *
+ * Returns an aggregate even when the env is empty, so the call site
+ * always has a `SeedProvider` to invoke — the resulting `lookup()`
+ * just resolves to `[]` for single-node dev.
+ */
+export function autoDiscovery(settings) {
+    const env = settings.env ?? process.env;
+    const log = settings.log ?? (() => { });
+    const providers = [];
+    // 1. CLUSTER_SEEDS — explicit static list.
+    const rawSeeds = (env.CLUSTER_SEEDS ?? '').trim();
+    if (rawSeeds.length > 0) {
+        providers.push(new ConfigSeedProvider({
+            systemName: settings.systemName,
+            seeds: parseSeedList(rawSeeds),
+        }));
+    }
+    // 2. Kubernetes API — only inside a pod with a matching service name.
+    const serviceName = (env.CLUSTER_SERVICE_NAME ?? '').trim();
+    if (env.KUBERNETES_SERVICE_HOST && serviceName.length > 0) {
+        providers.push(new KubernetesApiSeedProvider({
+            systemName: settings.systemName,
+            namespace: env.CLUSTER_NAMESPACE ?? 'default',
+            serviceName,
+            port: settings.port,
+        }));
+    }
+    // 3. DNS — resolve the service hostname directly.
+    if (serviceName.length > 0) {
+        providers.push(new DnsSeedProvider({
+            systemName: settings.systemName,
+            hostname: serviceName,
+            port: settings.port,
+        }));
+    }
+    return new AggregateSeedProvider(providers, log);
+}
+/**
+ * Named-provider shorthand used by `Cluster.bootstrap({ discovery: '...' })`.
+ * Pins the chain to a single provider type (configured from env vars)
+ * instead of running the full fallback ladder.  Useful when you know
+ * you're running on K8s and want the bootstrap to fail loudly if the
+ * K8s API isn't reachable, instead of silently falling through to DNS.
+ */
+export function singleProviderDiscovery(kind, settings) {
+    const env = settings.env ?? process.env;
+    switch (kind) {
+        case 'config': {
+            const rawSeeds = (env.CLUSTER_SEEDS ?? '').trim();
+            return new ConfigSeedProvider({
+                systemName: settings.systemName,
+                seeds: parseSeedList(rawSeeds),
+            });
+        }
+        case 'dns': {
+            const hostname = (env.CLUSTER_SERVICE_NAME ?? '').trim();
+            if (!hostname) {
+                throw new Error("Cluster.bootstrap({ discovery: 'dns' }): CLUSTER_SERVICE_NAME must be set");
+            }
+            return new DnsSeedProvider({
+                systemName: settings.systemName,
+                hostname,
+                port: settings.port,
+            });
+        }
+        case 'kubernetes': {
+            const serviceName = (env.CLUSTER_SERVICE_NAME ?? '').trim();
+            if (!serviceName) {
+                throw new Error("Cluster.bootstrap({ discovery: 'kubernetes' }): CLUSTER_SERVICE_NAME must be set");
+            }
+            return new KubernetesApiSeedProvider({
+                systemName: settings.systemName,
+                namespace: env.CLUSTER_NAMESPACE ?? 'default',
+                serviceName,
+                port: settings.port,
+            });
+        }
+    }
+}
+//# sourceMappingURL=autoDiscovery.js.map

package/dist/discovery/autoDiscovery.js.map

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

package/dist/discovery/index.d.ts

@@ -0,0 +1,16 @@
+export type { SeedProvider } from './SeedProvider.js';
+export { ConfigSeedProvider, seedsFromEnv } from './ConfigSeedProvider.js';
+export type { ConfigSeedProviderSettings } from './ConfigSeedProvider.js';
+export { DnsSeedProvider } from './DnsSeedProvider.js';
+export type { DnsSeedProviderSettings } from './DnsSeedProvider.js';
+export { AggregateSeedProvider } from './AggregateSeedProvider.js';
+export { KubernetesApiSeedProvider } from './KubernetesApiSeedProvider.js';
+export type { KubernetesApiSeedProviderSettings } from './KubernetesApiSeedProvider.js';
+export { autoDiscovery, singleProviderDiscovery } from './autoDiscovery.js';
+export type { AutoDiscoverySettings } from './autoDiscovery.js';
+export { ServiceKey } from './ServiceKey.js';
+export { Receptionist, ReceptionistExtension, ReceptionistId, } from './Receptionist.js';
+export type { ReceptionistSettings } from './Receptionist.js';
+export { Register, Registered, Deregister, Find, Subscribe, Unsubscribe, Listing, } from './ReceptionistMessages.js';
+export type { ReceptionistGossipMsg } from './ReceptionistMessages.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,YAAY,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,IAAI,EACJ,SAAS,EACT,WAAW,EACX,OAAO,GACR,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/discovery/index.js

@@ -0,0 +1,9 @@
+export { ConfigSeedProvider, seedsFromEnv } from './ConfigSeedProvider.js';
+export { DnsSeedProvider } from './DnsSeedProvider.js';
+export { AggregateSeedProvider } from './AggregateSeedProvider.js';
+export { KubernetesApiSeedProvider } from './KubernetesApiSeedProvider.js';
+export { autoDiscovery, singleProviderDiscovery } from './autoDiscovery.js';
+export { ServiceKey } from './ServiceKey.js';
+export { Receptionist, ReceptionistExtension, ReceptionistId, } from './Receptionist.js';
+export { Register, Registered, Deregister, Find, Subscribe, Unsubscribe, Listing, } from './ReceptionistMessages.js';
+//# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,IAAI,EACJ,SAAS,EACT,WAAW,EACX,OAAO,GACR,MAAM,2BAA2B,CAAC"}

package/dist/fsm/FSM.d.ts

@@ -0,0 +1,60 @@
+import { Actor } from '../Actor.js';
+/**
+ * Tuple returned from an FSM state handler: the next state name and the
+ * updated state-data value.  `stay()` / `goto()` helpers construct these.
+ */
+export interface Transition<SName extends string, SData> {
+    readonly kind: 'transition';
+    readonly next: SName;
+    readonly data: SData;
+}
+export interface StayTransition<SData> {
+    readonly kind: 'stay';
+    readonly data: SData;
+}
+export type FsmResult<SName extends string, SData> = Transition<SName, SData> | StayTransition<SData>;
+export type StateHandler<SName extends string, SData, Msg> = (data: SData, msg: Msg) => FsmResult<SName, SData> | Promise<FsmResult<SName, SData>>;
+export type TransitionCallback<SName extends string, SData> = (from: SName, to: SName, data: SData) => void | Promise<void>;
+/**
+ * Finite-State-Machine DSL built on top of the OO `Actor` class.  Each
+ * state has a name, an onReceive handler that returns the next transition,
+ * and optional enter/exit callbacks.  Internally the FSM stores the
+ * current state name, so it's friendlier than raw `become()` for
+ * protocols with a small, named state set.
+ *
+ * Usage:
+ *   class Door extends FSM<'closed'|'open', { openedAt?: number }, DoorCmd> {
+ *     constructor() {
+ *       super('closed', { });
+ *       this.when('closed', (d, m) => m === 'open'
+ *         ? this.goto('open', { openedAt: Date.now() })
+ *         : this.stay(d));
+ *       this.when('open', (d, m) => m === 'close' ? this.goto('closed', { }) : this.stay(d));
+ *     }
+ *   }
+ */
+export declare abstract class FSM<SName extends string, SData, Msg> extends Actor<Msg> {
+    private currentState;
+    private currentData;
+    private readonly handlers;
+    private readonly onEntry;
+    private readonly onExit;
+    private readonly transitionListeners;
+    constructor(initialState: SName, initialData: SData);
+    /** Register the handler for a state. */
+    protected when(state: SName, handler: StateHandler<SName, SData, Msg>): void;
+    /** Register an enter-hook for a state. */
+    protected onEnter(state: SName, hook: (data: SData) => void | Promise<void>): void;
+    /** Register an exit-hook for a state. */
+    protected onExitState(state: SName, hook: (data: SData) => void | Promise<void>): void;
+    /** Subscribe to every transition — useful for logging/metrics. */
+    protected onTransition(cb: TransitionCallback<SName, SData>): void;
+    protected goto(next: SName, data: SData): Transition<SName, SData>;
+    protected stay(data: SData): StayTransition<SData>;
+    /** Current state name — read-only. */
+    protected get state(): SName;
+    protected get data(): SData;
+    onReceive(msg: Msg): Promise<void>;
+    private transitionTo;
+}
+//# sourceMappingURL=FSM.d.ts.map

package/dist/fsm/FSM.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FSM.d.ts","sourceRoot":"","sources":["../../src/fsm/FSM.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK;IACrD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,cAAc,CAAC,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,IAC7C,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,GACxB,cAAc,CAAC,KAAK,CAAC,CAAC;AAE1B,MAAM,MAAM,YAAY,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,EAAE,GAAG,IACvD,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAExF,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,IACxD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;;;;GAiBG;AACH,8BAAsB,GAAG,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,EAAE,GAAG,CAAE,SAAQ,KAAK,CAAC,GAAG,CAAC;IAC5E,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqD;IAC9E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2D;IACnF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2D;IAClF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA0C;gBAElE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK;IAMnD,wCAAwC;IACxC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,IAAI;IAI5E,0CAA0C;IAC1C,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIlF,yCAAyC;IACzC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAItF,kEAAkE;IAClE,SAAS,CAAC,YAAY,CAAC,EAAE,EAAE,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI;IAIlE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC;IAIlE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;IAIlD,sCAAsC;IACtC,SAAS,KAAK,KAAK,IAAI,KAAK,CAA8B;IAC1D,SAAS,KAAK,IAAI,IAAI,KAAK,CAA6B;IAEzC,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;YAanC,YAAY;CAiB3B"}

package/dist/fsm/FSM.js

@@ -0,0 +1,102 @@
+import { match } from 'ts-pattern';
+import { Actor } from '../Actor.js';
+/**
+ * Finite-State-Machine DSL built on top of the OO `Actor` class.  Each
+ * state has a name, an onReceive handler that returns the next transition,
+ * and optional enter/exit callbacks.  Internally the FSM stores the
+ * current state name, so it's friendlier than raw `become()` for
+ * protocols with a small, named state set.
+ *
+ * Usage:
+ *   class Door extends FSM<'closed'|'open', { openedAt?: number }, DoorCmd> {
+ *     constructor() {
+ *       super('closed', { });
+ *       this.when('closed', (d, m) => m === 'open'
+ *         ? this.goto('open', { openedAt: Date.now() })
+ *         : this.stay(d));
+ *       this.when('open', (d, m) => m === 'close' ? this.goto('closed', { }) : this.stay(d));
+ *     }
+ *   }
+ */
+export class FSM extends Actor {
+    currentState;
+    currentData;
+    handlers = new Map();
+    onEntry = new Map();
+    onExit = new Map();
+    transitionListeners = [];
+    constructor(initialState, initialData) {
+        super();
+        this.currentState = initialState;
+        this.currentData = initialData;
+    }
+    /** Register the handler for a state. */
+    when(state, handler) {
+        this.handlers.set(state, handler);
+    }
+    /** Register an enter-hook for a state. */
+    onEnter(state, hook) {
+        this.onEntry.set(state, hook);
+    }
+    /** Register an exit-hook for a state. */
+    onExitState(state, hook) {
+        this.onExit.set(state, hook);
+    }
+    /** Subscribe to every transition — useful for logging/metrics. */
+    onTransition(cb) {
+        this.transitionListeners.push(cb);
+    }
+    goto(next, data) {
+        return { kind: 'transition', next, data };
+    }
+    stay(data) {
+        return { kind: 'stay', data };
+    }
+    /** Current state name — read-only. */
+    get state() { return this.currentState; }
+    get data() { return this.currentData; }
+    async onReceive(msg) {
+        const handler = this.handlers.get(this.currentState);
+        if (!handler) {
+            this.log.warn(`FSM: no handler for state '${String(this.currentState)}' — dropping message`);
+            return;
+        }
+        const result = await handler(this.currentData, msg);
+        await match(result)
+            .with({ kind: 'stay' }, (r) => { this.currentData = r.data; })
+            .with({ kind: 'transition' }, (r) => this.transitionTo(r.next, r.data))
+            .exhaustive();
+    }
+    async transitionTo(next, data) {
+        const from = this.currentState;
+        // Exit hook for the old state
+        const exitHook = this.onExit.get(from);
+        if (exitHook) {
+            try {
+                await exitHook(this.currentData);
+            }
+            catch (e) {
+                this.log.warn('onExit threw', e);
+            }
+        }
+        this.currentState = next;
+        this.currentData = data;
+        // Entry hook for the new state.
+        const entryHook = this.onEntry.get(next);
+        if (entryHook) {
+            try {
+                await entryHook(data);
+            }
+            catch (e) {
+                this.log.warn('onEnter threw', e);
+            }
+        }
+        for (const cb of this.transitionListeners) {
+            try {
+                await cb(from, next, data);
+            }
+            catch { /* swallow */ }
+        }
+    }
+}
+//# sourceMappingURL=FSM.js.map

package/dist/fsm/FSM.js.map

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