ihsm 0.0.14 → 0.0.19

package/lib/cjs/internal/hsm.js.map

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

package/lib/cjs/internal/utils.d.ts

@@ -0,0 +1,18 @@
+/** @internal */
+import { StateClass } from '../';
+/** @internal */
+export declare function asError(err: unknown): Error;
+/** @internal */
+export declare function quoteUnknown(err: unknown): string;
+/** @internal */
+export declare function quoteError(err: Error): string;
+/** @internal */
+export declare function getInitialState<Context, Protocol extends {} | undefined>(State: StateClass<Context, Protocol>): StateClass<Context, Protocol>;
+/** @internal */
+export declare function hasInitialState<Context, Protocol extends {} | undefined>(State: StateClass<Context, Protocol>): boolean;
+/** @internal */
+export declare function getTransitionKey<Context, Protocol extends {} | undefined>(FromState: StateClass<Context, Protocol>, ToState: StateClass<Context, Protocol>): string;
+/** @internal */
+export declare function defineStateName<Context, Protocol extends {} | undefined>(state: StateClass<Context, Protocol>, displayName: string): void;
+/** @internal — prefers an own explicit name registered for minified browser bundles. */
+export declare function getStateName<Context, Protocol extends {} | undefined>(state: StateClass<Context, Protocol>): string;

package/lib/cjs/internal/utils.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asError = asError;
+exports.quoteUnknown = quoteUnknown;
+exports.quoteError = quoteError;
+exports.getInitialState = getInitialState;
+exports.hasInitialState = hasInitialState;
+exports.getTransitionKey = getTransitionKey;
+exports.defineStateName = defineStateName;
+exports.getStateName = getStateName;
+/** @internal */
+function asError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+/** @internal */
+function quoteUnknown(err) {
+    return quoteError(asError(err));
+}
+/** @internal */
+function quoteError(err) {
+    return `${err.name}${err.message ? `: ${err.message}` : ' with no error message'}`;
+}
+/** @internal */
+function getInitialState(State) {
+    return State._initialState;
+}
+/** @internal */
+function hasInitialState(State) {
+    return Object.prototype.hasOwnProperty.call(State, '_initialState');
+}
+/** @internal */
+function getTransitionKey(FromState, ToState) {
+    return `${getStateName(FromState)}=>${getStateName(ToState)}`;
+}
+/** @internal */
+function defineStateName(state, displayName) {
+    Object.defineProperty(state, '_stateName', {
+        value: displayName,
+        writable: false,
+        configurable: false,
+        enumerable: false,
+    });
+}
+/** @internal — prefers an own explicit name registered for minified browser bundles. */
+function getStateName(state) {
+    if (Object.prototype.hasOwnProperty.call(state, '_stateName')) {
+        return state._stateName;
+    }
+    return state.name;
+}
+//# sourceMappingURL=utils.js.map

package/lib/cjs/internal/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/internal/utils.ts"],"names":[],"mappings":";;AAIA,0BAEC;AAGD,oCAEC;AAGD,gCAEC;AAGD,0CAEC;AAGD,0CAEC;AAGD,4CAEC;AAGD,0CAOC;AAGD,oCAKC;AA9CD,gBAAgB;AAChB,SAAgB,OAAO,CAAC,GAAY;IACnC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,gBAAgB;AAChB,SAAgB,YAAY,CAAC,GAAY;IACxC,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,gBAAgB;AAChB,SAAgB,UAAU,CAAC,GAAU;IACpC,OAAO,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,wBAAwB,EAAE,CAAC;AACpF,CAAC;AAED,gBAAgB;AAChB,SAAgB,eAAe,CAA2C,KAAoC;IAC7G,OAAQ,KAAgC,CAAC,aAA8C,CAAC;AACzF,CAAC;AAED,gBAAgB;AAChB,SAAgB,eAAe,CAA2C,KAAoC;IAC7G,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;AACrE,CAAC;AAED,gBAAgB;AAChB,SAAgB,gBAAgB,CAA2C,SAAwC,EAAE,OAAsC;IAC1J,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,KAAK,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,gBAAgB;AAChB,SAAgB,eAAe,CAA2C,KAAoC,EAAE,WAAmB;IAClI,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE;QAC1C,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;KACjB,CAAC,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,SAAgB,YAAY,CAA2C,KAAoC;IAC1G,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,CAAC;QAC/D,OAAQ,KAA2C,CAAC,UAAU,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC;AACnB,CAAC"}

package/lib/cjs/package.json

@@ -0,0 +1,3 @@
+{
+	"type": "commonjs"
+}

package/lib/esm/index.d.ts

@@ -0,0 +1,282 @@
+/**
+ * Default context and protocol map when a machine is created without explicit typing.
+ * @category Factory
+ */
+export type Any = Record<string, any>;
+/**
+ * Rejects an async {@link Hsm.call} service with an error.
+ * @category Event handler
+ */
+export type RejectCallback = (error: Error) => void;
+/**
+ * Resolves an async {@link Hsm.call} service with a typed reply.
+ * @category Event handler
+ */
+export type ResolveCallback<Reply> = (result: Reply) => void;
+/**
+ * Called when event dispatch fails and the runtime does not recover via `onError`.
+ * @category Factory
+ */
+export interface DispatchErrorCallback<Context, Protocol extends {} | undefined> {
+    (hsm: Base<Context, Protocol>, err: Error): void;
+}
+/**
+ * Trace verbosity for dispatch logging.
+ * @category Factory
+ */
+export declare enum TraceLevel {
+    PRODUCTION = 0,
+    DEBUG = 1,
+    VERBOSE_DEBUG = 2
+}
+/**
+ * Receives trace lines from the runtime and from handlers via `this.traceWriter.write`.
+ * @category Factory
+ */
+export interface TraceWriter {
+    write<Context, Protocol extends {} | undefined>(hsm: Properties<Context, Protocol>, msg: any): void;
+}
+/**
+ * @category State machine
+ */
+export interface Properties<Context, Protocol extends {} | undefined> {
+    readonly currentState: StateClass<Context, Protocol>;
+    readonly currentStateName: string;
+    readonly topState: StateClass<Context, Protocol>;
+    readonly topStateName: string;
+    readonly ctxTypeName: string;
+    readonly traceHeader: string;
+    readonly eventName: string;
+    readonly eventPayload: any[];
+    traceLevel: TraceLevel;
+    traceWriter: TraceWriter;
+    dispatchErrorCallback: DispatchErrorCallback<Context, Protocol>;
+}
+/**
+ * @category State machine
+ */
+export interface Base<Context, Protocol extends {} | undefined> extends Properties<Context, Protocol> {
+    post<EventName extends keyof Protocol>(eventName: PostedEvent<Protocol, EventName>, ...eventPayload: EventPayload<Protocol, EventName>): void;
+    deferredPost<EventName extends keyof Protocol>(millis: number, eventName: PostedEvent<Protocol, EventName>, ...eventPayload: EventPayload<Protocol, EventName>): void;
+}
+/**
+ * @category State machine
+ */
+export interface State<Context, Protocol extends {} | undefined> extends Base<Context, Protocol> {
+    readonly ctx: Context;
+    transition(nextState: StateClass<Context, Protocol>): void;
+    unhandled(): never;
+    sleep(millis: number): Promise<void>;
+    /** Handler-only: queue an event on the internal high-priority mailbox (before normal `post`). */
+    postNow<EventName extends keyof Protocol>(eventName: PostedEvent<Protocol, EventName>, ...eventPayload: EventPayload<Protocol, EventName>): void;
+}
+/**
+ * Actor handle returned by {@link makeHsm} — client API (`post`, `call`, `sync`, `restore`).
+ * @category State machine
+ */
+export interface Hsm<Context = Any, Protocol extends {} | undefined = undefined> extends Base<Context, Protocol> {
+    readonly ctx: Context;
+    sync(): Promise<void>;
+    restore(state: StateClass<Context, Protocol>, ctx: Context): void;
+    call<EventName extends keyof Protocol>(eventName: ServiceName<Protocol, EventName>, ...eventPayload: ServiceRequest<Protocol, EventName>): Promise<ServiceResponse<Protocol, EventName>>;
+}
+/**
+ * @category Event handler
+ */
+export type PostedEvent<Protocol extends {} | undefined, EventName extends keyof Protocol> = Protocol extends undefined ? string : EventName extends keyof State<any, any> ? never : EventName;
+/**
+ * @category Event handler
+ */
+export type EventPayload<Protocol extends {} | undefined, EventName extends keyof Protocol> = Protocol extends undefined ? any[] : Protocol[EventName] extends (...payload: infer Payload) => Promise<void> | void ? (Payload extends any[] ? Payload : never) : never;
+/**
+ * Constructor type for a state class in the machine hierarchy.
+ * @category State machine
+ */
+export type StateClass<Context = Any, Protocol extends {} | undefined = undefined> = Function & {
+    prototype: TopState<Context, Protocol>;
+};
+/**
+ *
+ */
+export type ServiceRequest<Protocol, EventName extends keyof Protocol> = Protocol extends undefined ? any[] : Protocol[EventName] extends (resolve: (result: infer Reply) => void, reject: (error: infer Error) => void, ...payload: infer Payload) => Promise<void> | void ? (Payload extends any[] ? Payload : never) : never;
+/**
+ *
+ */
+export type ServiceResponse<Protocol, EventName extends keyof Protocol> = Protocol extends undefined ? any : Protocol[EventName] extends (resolve: infer Reply, reject: infer Error, ...payload: infer Payload) => Promise<void> | void ? Reply : never;
+/**
+ *
+ */
+export type ServiceName<Protocol, EventName> = Protocol extends undefined ? string : EventName extends keyof State<any, any> ? never : EventName;
+/**
+ * Optional lifecycle hooks implemented by state classes (`onEntry`, `onExit`, …).
+ * @category State machine
+ */
+export interface StateEvents<Context, Protocol extends {} | undefined> {
+    onExit(): Promise<void> | void;
+    onEntry(): Promise<void> | void;
+    onError<EventName extends keyof Protocol>(error: RuntimeError<Context, Protocol, EventName>): Promise<void> | void;
+    onUnhandled<EventName extends keyof Protocol>(error: UnhandledEventError<Context, Protocol, EventName>): Promise<void> | void;
+}
+/**
+ * Root of the state class hierarchy; hosts mailbox machinery. Subclass or pass to {@link makeHsm}.
+ * @category State machine
+ */
+export declare abstract class TopState<Context = Any, Protocol extends {} | undefined = undefined> implements State<Context, Protocol>, StateEvents<Context, Protocol> {
+    readonly ctx: Context;
+    readonly hsm: State<Context, Protocol>;
+    constructor();
+    get eventName(): string;
+    get eventPayload(): any[];
+    get traceHeader(): string;
+    get topState(): StateClass<Context, Protocol>;
+    get currentStateName(): string;
+    get currentState(): StateClass<Context, Protocol>;
+    get ctxTypeName(): string;
+    set traceLevel(value: TraceLevel);
+    get traceLevel(): TraceLevel;
+    get topStateName(): string;
+    get traceWriter(): TraceWriter;
+    set traceWriter(value: TraceWriter);
+    get dispatchErrorCallback(): DispatchErrorCallback<Context, Protocol>;
+    set dispatchErrorCallback(value: DispatchErrorCallback<Context, Protocol>);
+    transition(nextState: StateClass<Context, Protocol>): void;
+    unhandled(): never;
+    sleep(millis: number): Promise<void>;
+    post<EventName extends keyof Protocol>(eventName: PostedEvent<Protocol, EventName>, ...eventPayload: EventPayload<Protocol, EventName>): void;
+    deferredPost<EventName extends keyof Protocol>(millis: number, eventName: PostedEvent<Protocol, EventName>, ...eventPayload: EventPayload<Protocol, EventName>): void;
+    postNow<EventName extends keyof Protocol>(eventName: PostedEvent<Protocol, EventName>, ...eventPayload: EventPayload<Protocol, EventName>): void;
+    onExit(): Promise<void> | void;
+    onEntry(): Promise<void> | void;
+    onError<EventName extends keyof Protocol>(error: RuntimeError<Context, Protocol, EventName>): Promise<void> | void;
+    onUnhandled<EventName extends keyof Protocol>(error: UnhandledEventError<Context, Protocol, EventName>): Promise<void> | void;
+}
+/**
+ * @category Error
+ */
+export declare abstract class HsmError<Context, Protocol extends {} | undefined> extends Error {
+    name: string;
+    topStateName: string;
+    stateName: string;
+    context: Context;
+    cause?: Error;
+    protected constructor(name: string, hsm: State<Context, Protocol>, message: string, cause?: Error);
+}
+/**
+ * @category Error
+ */
+export declare abstract class RuntimeError<Context, Protocol extends {} | undefined, EventName extends keyof Protocol> extends HsmError<Context, Protocol> {
+    eventName: PostedEvent<Protocol, EventName>;
+    eventPayload: EventPayload<Protocol, EventName>;
+    protected constructor(errorName: string, hsm: State<Context, Protocol>, message: string, cause?: Error);
+}
+/**
+ * @category Error
+ */
+export declare class TransitionError<Context, Protocol extends {} | undefined, EventName extends keyof Protocol> extends RuntimeError<Context, Protocol, EventName> {
+    failedStateName: string;
+    failedCallback: 'onExit' | 'onEntry';
+    fromStateName: string;
+    toStateName: string;
+    constructor(hsm: State<Context, Protocol>, cause: Error, failedStateName: string, failedCallback: 'onExit' | 'onEntry', fromStateName: string, toStateName: string);
+}
+/**
+ * @category Error
+ */
+export declare class EventHandlerError<Context, Protocol extends {} | undefined, EventName extends keyof Protocol> extends RuntimeError<Context, Protocol, EventName> {
+    constructor(hsm: State<Context, Protocol>, cause: Error);
+}
+/**
+ * @category Error
+ */
+export declare class UnhandledEventError<Context, Protocol extends {} | undefined, EventName extends keyof Protocol> extends RuntimeError<Context, Protocol, EventName> {
+    constructor(hsm: State<Context, Protocol>);
+}
+/**
+ * @category Error
+ */
+export declare class InitialStateError<Context, Protocol extends {} | undefined> extends Error {
+    targetStateName: string;
+    constructor(targetState: StateClass<Context, Protocol>);
+}
+/**
+ * @category Error
+ */
+export declare class FatalError<Context, Protocol extends {} | undefined, EventName extends keyof Protocol> extends RuntimeError<Context, Protocol, EventName> {
+    constructor(hsm: State<Context, Protocol>, cause: Error);
+}
+/**
+ * @category Error
+ */
+export declare class InitializationError<Context, Protocol extends {} | undefined> extends HsmError<Context, Protocol> {
+    failedState: StateClass<Context, Protocol>;
+    constructor(hsm: State<Context, Protocol>, failedState: StateClass<Context, Protocol>, cause: Error);
+}
+/**
+ * Terminal error state class used when the machine cannot recover.
+ * @category State machine
+ */
+export declare class FatalErrorState<Context, Protocol extends {} | undefined> extends TopState<Context, Protocol> {
+}
+/**
+ * Marks `TargetState` as the initial substate of its parent composite state.
+ * @category Factory
+ */
+export declare function InitialState<Context, Protocol extends {} | undefined>(TargetState: StateClass<Context, Protocol>): void;
+/**
+ * Assigns a stable display name to a state class.
+ *
+ * Minifiers (and browser production bundles) rewrite class names, so the
+ * built-in `Class.name` is unreliable in optimized builds. Registering an
+ * explicit name keeps {@link Properties.currentStateName},
+ * {@link Properties.topStateName}, trace output, and error messages stable in
+ * every environment (Node and minified browsers alike).
+ *
+ * The name is stored as a non-enumerable, non-inherited own property, so it is
+ * never accidentally shared with subclasses through the prototype chain.
+ *
+ * @example
+ * ```ts
+ * class Door extends TopState {}
+ * defineStateName(Door, 'Door');
+ * ```
+ * @category State machine
+ */
+export declare function defineStateName<Context, Protocol extends {} | undefined>(state: StateClass<Context, Protocol>, name: string): void;
+/**
+ * Registers stable display names for every state class found in an exports map,
+ * using the export key as the display name.
+ *
+ * This is the convenient way to make a whole machine module minification-safe:
+ * pass the module namespace (or an object literal of the state classes) and
+ * each state class gets its export key as its display name. Non state-class
+ * values (factory functions, interfaces compiled away, constants) are ignored.
+ *
+ * @example
+ * ```ts
+ * // machine.ts
+ * export class DoorTop extends TopState {}
+ * export class Open extends DoorTop {}
+ * export class Closed extends DoorTop {}
+ * registerStateNames({ DoorTop, Open, Closed });
+ * ```
+ * @example
+ * ```ts
+ * // from another module
+ * import * as machine from './machine';
+ * registerStateNames(machine);
+ * ```
+ * @category State machine
+ */
+export declare function registerStateNames(exports: Record<string, unknown>): void;
+/**
+ * Creates a state machine instance bound to the given context object.
+ *
+ * @param topState - Root state class
+ * @param ctx - Mutable domain context
+ * @param initialize - When `true`, walk `@InitialState` chain and run `onEntry` on the path to the initial leaf (default `true`)
+ * @param traceLevel - Trace verbosity (default {@link TraceLevel.DEBUG})
+ * @param traceWriter - Trace sink (default console logger)
+ * @param dispatchErrorCallback - Hook when dispatch throws and is not recovered (default: log and rethrow)
+ * @category Factory
+ */
+export declare function makeHsm<Context, Protocol extends undefined | {}>(topState: StateClass<Context, Protocol>, ctx: Context, initialize?: boolean, traceLevel?: TraceLevel, traceWriter?: TraceWriter, dispatchErrorCallback?: DispatchErrorCallback<Context, Protocol>): Hsm<Context, Protocol>;