ihsm 0.0.13 → 0.0.19

package/lib/cjs/index.js

@@ -0,0 +1,331 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FatalErrorState = exports.InitializationError = exports.FatalError = exports.InitialStateError = exports.UnhandledEventError = exports.EventHandlerError = exports.TransitionError = exports.RuntimeError = exports.HsmError = exports.TopState = exports.TraceLevel = void 0;
+exports.InitialState = InitialState;
+exports.defineStateName = defineStateName;
+exports.registerStateNames = registerStateNames;
+exports.makeHsm = makeHsm;
+const hsm_1 = require("./internal/hsm");
+const utils_1 = require("./internal/utils");
+// export type DispatchErrorCallback<Context, Protocol extends {} | undefined> = (hsm: Hsm<Context, Protocol>, traceWriter: TraceWriter, err: Error) => void;
+/**
+ * Trace verbosity for dispatch logging.
+ * @category Factory
+ */
+var TraceLevel;
+(function (TraceLevel) {
+    TraceLevel[TraceLevel["PRODUCTION"] = 0] = "PRODUCTION";
+    TraceLevel[TraceLevel["DEBUG"] = 1] = "DEBUG";
+    TraceLevel[TraceLevel["VERBOSE_DEBUG"] = 2] = "VERBOSE_DEBUG";
+})(TraceLevel || (exports.TraceLevel = TraceLevel = {}));
+/**
+ * Root of the state class hierarchy; hosts mailbox machinery. Subclass or pass to {@link makeHsm}.
+ * @category State machine
+ */
+class TopState {
+    ctx;
+    hsm;
+    constructor() {
+        throw new Error('Fatal error: States cannot be instantiated');
+    }
+    get eventName() {
+        return this.hsm.eventName;
+    }
+    get eventPayload() {
+        return this.hsm.eventPayload;
+    }
+    get traceHeader() {
+        return this.hsm.traceHeader;
+    }
+    get topState() {
+        return this.hsm.topState;
+    }
+    get currentStateName() {
+        return this.hsm.currentStateName;
+    }
+    get currentState() {
+        return this.hsm.currentState;
+    }
+    get ctxTypeName() {
+        return this.hsm.ctxTypeName;
+    }
+    set traceLevel(value) {
+        this.hsm.traceLevel = value;
+    }
+    get traceLevel() {
+        return this.hsm.traceLevel;
+    }
+    get topStateName() {
+        return this.hsm.topStateName;
+    }
+    get traceWriter() {
+        return this.hsm.traceWriter;
+    }
+    set traceWriter(value) {
+        this.hsm.traceWriter = value;
+    }
+    get dispatchErrorCallback() {
+        return this.hsm.dispatchErrorCallback;
+    }
+    set dispatchErrorCallback(value) {
+        this.hsm.dispatchErrorCallback = value;
+    }
+    transition(nextState) {
+        this.hsm.transition(nextState);
+    }
+    unhandled() {
+        this.hsm.unhandled();
+    }
+    sleep(millis) {
+        return this.hsm.sleep(millis);
+    }
+    post(eventName, ...eventPayload) {
+        this.hsm.post(eventName, ...eventPayload);
+    }
+    deferredPost(millis, eventName, ...eventPayload) {
+        this.hsm.deferredPost(millis, eventName, ...eventPayload);
+    }
+    postNow(eventName, ...eventPayload) {
+        this.hsm.postNow(eventName, ...eventPayload);
+    }
+    onExit() { }
+    onEntry() { }
+    onError(error) {
+        throw error;
+    }
+    onUnhandled(error) {
+        throw error;
+    }
+}
+exports.TopState = TopState;
+/**
+ * @category Error
+ */
+class HsmError extends Error {
+    name;
+    topStateName;
+    stateName;
+    context;
+    cause;
+    constructor(name, hsm, message, cause) {
+        super(message);
+        this.name = name;
+        this.topStateName = hsm.topStateName;
+        this.stateName = hsm.currentStateName;
+        this.context = hsm.ctx;
+        this.cause = cause;
+    }
+}
+exports.HsmError = HsmError;
+/**
+ * @category Error
+ */
+class RuntimeError extends HsmError {
+    eventName;
+    eventPayload;
+    constructor(errorName, hsm, message, cause) {
+        super(errorName, hsm, message, cause);
+        this.eventName = hsm.eventName;
+        this.eventPayload = hsm.eventPayload;
+    }
+}
+exports.RuntimeError = RuntimeError;
+/**
+ * @category Error
+ */
+class TransitionError extends RuntimeError {
+    failedStateName;
+    failedCallback;
+    fromStateName;
+    toStateName;
+    constructor(hsm, cause, failedStateName, failedCallback, fromStateName, toStateName) {
+        super('TransitionError', hsm, `${failedStateName}.${failedCallback}() has failed while executing a transition from ${fromStateName} to ${toStateName}`, cause);
+        this.failedStateName = failedStateName;
+        this.failedCallback = failedCallback;
+        this.fromStateName = fromStateName;
+        this.toStateName = toStateName;
+    }
+}
+exports.TransitionError = TransitionError;
+/**
+ * @category Error
+ */
+class EventHandlerError extends RuntimeError {
+    constructor(hsm, cause) {
+        super('EventHandlerError', hsm, `an error was thrown while executing event handler #${hsm.eventName} in state ${hsm.currentStateName}`, cause);
+    }
+}
+exports.EventHandlerError = EventHandlerError;
+/**
+ * @category Error
+ */
+class UnhandledEventError extends RuntimeError {
+    constructor(hsm) {
+        super('UnhandledEventError', hsm, `event #${hsm.eventName} was unhandled in state ${hsm.currentStateName}`);
+    }
+}
+exports.UnhandledEventError = UnhandledEventError;
+/**
+ * @category Error
+ */
+class InitialStateError extends Error {
+    targetStateName;
+    constructor(targetState) {
+        super(`State '${(0, utils_1.getStateName)(Object.getPrototypeOf(targetState.prototype).constructor)}' must not have more than one initial state`);
+        this.name = 'InitialStateError';
+        this.targetStateName = (0, utils_1.getStateName)(targetState);
+    }
+}
+exports.InitialStateError = InitialStateError;
+/**
+ * @category Error
+ */
+class FatalError extends RuntimeError {
+    constructor(hsm, cause) {
+        super('FatalError', hsm, `onError() has thrown ${(0, utils_1.quoteError)(cause)}`, cause);
+    }
+}
+exports.FatalError = FatalError;
+/**
+ * @category Error
+ */
+class InitializationError extends HsmError {
+    failedState;
+    constructor(hsm, failedState, cause) {
+        super('InitializationError', hsm, `state ${(0, utils_1.getStateName)(failedState)} has thrown ${(0, utils_1.quoteError)(cause)} during initialization`, cause);
+        this.failedState = failedState;
+    }
+}
+exports.InitializationError = InitializationError;
+/**
+ * Terminal error state class used when the machine cannot recover.
+ * @category State machine
+ */
+class FatalErrorState extends TopState {
+}
+exports.FatalErrorState = FatalErrorState;
+(0, utils_1.defineStateName)(TopState, 'TopState');
+(0, utils_1.defineStateName)(FatalErrorState, 'FatalErrorState');
+/**
+ * Marks `TargetState` as the initial substate of its parent composite state.
+ * @category Factory
+ */
+function InitialState(TargetState) {
+    const ParentOfTargetState = Object.getPrototypeOf(TargetState.prototype).constructor;
+    if ((0, utils_1.hasInitialState)(ParentOfTargetState))
+        throw new InitialStateError(TargetState);
+    Object.defineProperty(TargetState, '_isInitialState', {
+        value: true,
+        writable: false,
+        configurable: false,
+        enumerable: false,
+    });
+    Object.defineProperty(ParentOfTargetState, '_initialState', {
+        value: TargetState,
+        writable: false,
+        configurable: false,
+        enumerable: false,
+    });
+}
+/**
+ * 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
+ */
+function defineStateName(state, name) {
+    (0, utils_1.defineStateName)(state, name);
+}
+/**
+ * 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
+ */
+function registerStateNames(exports) {
+    for (const [exportName, value] of Object.entries(exports)) {
+        if (isStateClass(value)) {
+            (0, utils_1.defineStateName)(value, exportName);
+        }
+    }
+}
+/** @internal — structural guard: a constructor whose prototype derives from {@link TopState}. */
+function isStateClass(value) {
+    if (typeof value !== 'function')
+        return false;
+    const prototype = value.prototype;
+    return typeof prototype === 'object' && prototype !== null && TopState.prototype.isPrototypeOf(prototype);
+}
+/** @internal */
+class ConsoleTraceWriter {
+    write(hsm, Message) {
+        if (typeof Message == 'string') {
+            console.log(`${hsm.traceHeader}${hsm.currentStateName}: ${Message}`);
+        }
+        else {
+            console.log(Message);
+        }
+    }
+}
+function defaultDispatchErrorCallback(hsm, err) {
+    const writer = hsm.traceWriter;
+    writer.write(hsm, `An event dispatch has failed; error ${err.name}: ${err.message} has not been managed`);
+    writer.write(hsm, err);
+    throw err;
+}
+const defaultTraceWriter = new ConsoleTraceWriter();
+const defaultTraceLevel = TraceLevel.DEBUG;
+const defaultInitialize = true;
+/**
+ * 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
+ */
+function makeHsm(topState, ctx, initialize = defaultInitialize, traceLevel = defaultTraceLevel, traceWriter = defaultTraceWriter, dispatchErrorCallback = defaultDispatchErrorCallback) {
+    const instance = {
+        hsm: undefined,
+        ctx: ctx,
+    };
+    Object.setPrototypeOf(instance, topState.prototype);
+    instance.hsm = new hsm_1.HsmObject(topState, instance, traceWriter, traceLevel, dispatchErrorCallback, initialize);
+    return instance.hsm;
+}
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

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

package/lib/cjs/internal/defs.private.d.ts

@@ -0,0 +1,31 @@
+import { PostedEvent, EventPayload, Hsm, StateClass, State } from '../';
+/** @internal */
+export interface Instance<Context, Protocol extends {} | undefined> {
+    ctx: Context;
+    hsm: HsmWithTracing<Context, Protocol>;
+}
+/** @internal */
+export interface Transition<Context, Protocol extends {} | undefined> {
+    execute(hsm: HsmWithTracing<Context, Protocol>, srcState: StateClass<Context, Protocol>, dstState: StateClass<Context, Protocol>): Promise<void>;
+}
+/** @internal */
+export type DoneCallback = () => void;
+/** @internal */
+export type Task = (done: DoneCallback) => void;
+/** @internal */
+export interface HsmWithTracing<Context, Protocol extends {} | undefined> extends Hsm<Context, Protocol>, State<Context, Protocol> {
+    _transitionCache: Map<string, Transition<Context, Protocol>>;
+    _createInitTask: <DispatchContext, DispatchProtocol extends {} | undefined>(hsm: HsmWithTracing<DispatchContext, DispatchProtocol>) => Task;
+    _createEventDispatchTask: <DispatchContext, DispatchProtocol extends {} | undefined, EventName extends keyof DispatchProtocol>(hsm: HsmWithTracing<DispatchContext, DispatchProtocol>, eventName: PostedEvent<DispatchProtocol, EventName>, ...eventPayload: EventPayload<DispatchProtocol, EventName>) => Task;
+    _instance: Instance<Context, Protocol>;
+    _transitionState?: StateClass<Context, Protocol>;
+    _currentEventName?: string;
+    _currentEventPayload?: any[];
+    currentState: StateClass<Context, Protocol>;
+    _tracePush(domain: string, msg: string): void;
+    _tracePopDone(msg: string): void;
+    _tracePopError(msg: string): void;
+    _traceWrite(msg: any): void;
+    unshiftHiPriorityTask(t: Task): void;
+    pushHiPriorityTask(t: Task): void;
+}

package/lib/cjs/internal/defs.private.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=defs.private.js.map

package/lib/cjs/internal/defs.private.js.map

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

package/lib/cjs/internal/dispatch.debug.d.ts

@@ -0,0 +1,4 @@
+import { PostedEvent, EventPayload } from '../';
+import { HsmWithTracing, Task } from './defs.private';
+export declare function createInitTask<DispatchContext, DispatchProtocol extends {} | undefined>(hsm: HsmWithTracing<DispatchContext, DispatchProtocol>): Task;
+export declare function createEventDispatchTask<DispatchContext, DispatchProtocol extends {} | undefined, EventName extends keyof DispatchProtocol>(hsm: HsmWithTracing<DispatchContext, DispatchProtocol>, eventName: PostedEvent<DispatchProtocol, EventName>, ...eventPayload: EventPayload<DispatchProtocol, EventName>): Task;