ihsm 0.0.21 → 0.0.22

package/lib/esm/testing.js

@@ -0,0 +1,370 @@
+/**
+ * `ihsm/testing` — deterministic-simulation testing utilities for ihsm.
+ *
+ * This entry point is **separate from the core runtime** (`ihsm`): the mock-port machinery,
+ * the manual virtual clock, and the full-access test actor live here so they are never bundled
+ * into production code that only imports `ihsm`. Import test helpers from `ihsm/testing`:
+ *
+ * ```ts
+ * import { makeHsm, TopState } from 'ihsm';            // production code
+ * import { makeTestActor, mock, TestPort } from 'ihsm/testing'; // tests only
+ * ```
+ *
+ * For convenience this module also re-exports the entire core API, so a test file may import
+ * everything it needs from `ihsm/testing` alone.
+ *
+ * @packageDocumentation
+ */
+import { BasePort, TraceLevel, defaultDispatchErrorCallback, defaultInitialize, defaultTraceWriter, makeHsm } from './index.js';
+export * from './index.js';
+export class TestPort extends BasePort {
+    _messages = [];
+    _preloads = new Map();
+    _now = 0;
+    _timerSeq = 0;
+    _timers = [];
+    _cancelled = new Set();
+    _randomQueue = [];
+    _cryptoRandomQueue = [];
+    _uuidQueue = [];
+    _byteQueue = [];
+    /**
+     * Append an entry to the recorded message log (for assertions / golden traces).
+     *
+     * Callable both from inside the mock (e.g. a port method logging its outbound call) and from a
+     * test (e.g. a `Disposable.dispose` closure recording its own teardown into the trace).
+     *
+     * @param event - Event name or free-form label (e.g. `'connect'`, `'attempt 1: ok'`)
+     * @param payload - Optional values associated with the entry
+     */
+    record(event, ...payload) {
+        this._messages.push({ event, payload: [...payload] });
+    }
+    _slot(name) {
+        let slot = this._preloads.get(name);
+        if (slot === undefined) {
+            slot = { queue: [], calls: [] };
+            this._preloads.set(name, slot);
+        }
+        return slot;
+    }
+    /** @internal Set the persistent implementation for a stubbed method (used by `method.default`). */
+    _stubDefault(name, impl) {
+        this._slot(name).fallback = impl;
+    }
+    /** @internal Queue a one-shot implementation for a stubbed method (used by `method.once`). */
+    _stubOnce(name, impl) {
+        this._slot(name).queue.push(impl);
+    }
+    /** @internal Clear a stubbed method's queued/persistent implementations and recorded calls (`method.reset`). */
+    _stubReset(name) {
+        const slot = this._slot(name);
+        slot.queue.length = 0;
+        slot.fallback = undefined;
+        slot.calls.length = 0;
+    }
+    /** @internal The live, typed list of argument tuples a stubbed method was called with (`method.calls`). */
+    _stubCalls(name) {
+        return this._slot(name).calls;
+    }
+    /**
+     * @internal Consume the next implementation for a stubbed method. Installed as the body of every
+     * `@`{@link mock}-stubbed method by {@link makeTestPort}; not called directly.
+     *
+     * The call is recorded first (globally in {@link trace} and in the method's {@link Stubbed.calls}),
+     * then one-shot stubs (queued via `method.once`) are consumed in order; otherwise the persistent
+     * `method.default` implementation runs. With neither set, a {@link PreloadError} naming the method
+     * is thrown.
+     *
+     * @param name - Port method name
+     * @param args - Arguments the machine passed to the method
+     * @throws {@link PreloadError} if nothing was stubbed for `name`
+     */
+    _consumePreload(name, args) {
+        const slot = this._slot(name);
+        slot.calls.push(args); // typed per-method record
+        this.record(name, ...args); // global golden-trace record, even if unstubbed
+        const impl = slot.queue.shift() ?? slot.fallback;
+        if (impl === undefined) {
+            throw new PreloadError(name);
+        }
+        return impl(...args);
+    }
+    /** Every recorded message, in order. */
+    get messages() {
+        return this._messages;
+    }
+    /** Just the recorded event names, in order. */
+    get events() {
+        return this._messages.map(m => m.event);
+    }
+    /** Rendered `event` / `event:arg,arg` strings — convenient for `deep.equal` / `include`. */
+    get trace() {
+        return this._messages.map(m => (m.payload.length > 0 ? `${m.event}:${m.payload.join(',')}` : m.event));
+    }
+    /** The most recently recorded message, or `undefined`. */
+    get last() {
+        return this._messages[this._messages.length - 1];
+    }
+    /** Number of recorded messages. */
+    get count() {
+        return this._messages.length;
+    }
+    /** Clear the recorded message log. */
+    clear() {
+        this._messages.length = 0;
+    }
+    _sortTimers() {
+        this._timers.sort((a, b) => a.at - b.at || a.id - b.id);
+    }
+    /** @inheritdoc Port.setTimeout — backed by the virtual clock; fire with {@link TestPort.advance | advance}. */
+    setTimeout(callback, millis) {
+        const id = ++this._timerSeq;
+        this._timers.push({ id, at: this._now + Math.max(0, millis ?? 0), callback });
+        this._sortTimers();
+        return id;
+    }
+    /** @inheritdoc Port.clearTimeout */
+    clearTimeout(id) {
+        if (id === undefined) {
+            return;
+        }
+        this._cancelled.add(id);
+        const index = this._timers.findIndex(timer => timer.id === id);
+        if (index >= 0) {
+            this._timers.splice(index, 1);
+        }
+    }
+    /** @inheritdoc Port.setInterval — backed by the virtual clock; fire with {@link TestPort.advance | advance}. */
+    setInterval(callback, millis) {
+        const id = ++this._timerSeq;
+        const repeat = Math.max(0, millis ?? 0);
+        this._timers.push({ id, at: this._now + repeat, callback, repeat });
+        this._sortTimers();
+        return id;
+    }
+    /** @inheritdoc Port.clearInterval */
+    clearInterval(id) {
+        this.clearTimeout(id);
+    }
+    /**
+     * Advance the virtual clock by `millis`, firing every timer whose deadline is reached, in
+     * deadline order. Timers scheduled by a fired callback within the same window are **not** run
+     * until a later `advance` — mirroring how a deferred re-schedule lands on the next run-to-completion turn.
+     *
+     * @param millis - Virtual milliseconds to advance (negative values are clamped to `0`)
+     */
+    advance(millis) {
+        const target = this._now + Math.max(0, millis);
+        const due = this._timers.filter(timer => timer.at <= target && !this._cancelled.has(timer.id));
+        this._timers.splice(0, due.length);
+        for (const timer of due) {
+            this._now = timer.at;
+            timer.callback();
+            if (timer.repeat !== undefined && !this._cancelled.has(timer.id)) {
+                this._timers.push({ id: timer.id, at: this._now + timer.repeat, callback: timer.callback, repeat: timer.repeat });
+            }
+        }
+        this._sortTimers();
+        this._now = target;
+    }
+    /** Current virtual time, in milliseconds since construction. */
+    get now() {
+        return this._now;
+    }
+    /** Number of timers still pending (not yet fired or disposed). */
+    get pending() {
+        return this._timers.length;
+    }
+    /** Queue values returned by successive {@link TestPort.random | random} calls (FIFO). */
+    feedRandom(...values) {
+        this._randomQueue.push(...values);
+    }
+    /** Queue values returned by successive {@link TestPort.cryptoRandom | cryptoRandom} calls (FIFO). */
+    feedCryptoRandom(...values) {
+        this._cryptoRandomQueue.push(...values);
+    }
+    /** Queue values returned by successive {@link TestPort.randomUUID | randomUUID} calls (FIFO). */
+    feedUUID(...values) {
+        this._uuidQueue.push(...values);
+    }
+    /** Queue bytes used to fill arrays in successive {@link TestPort.getRandomValues | getRandomValues} calls (FIFO). */
+    feedRandomBytes(...bytes) {
+        this._byteQueue.push(...bytes);
+    }
+    /** Clear all scripted random queues ({@link TestPort.feedRandom | feedRandom} / {@link TestPort.feedCryptoRandom | feedCryptoRandom} / …). */
+    resetRandom() {
+        this._randomQueue.length = 0;
+        this._cryptoRandomQueue.length = 0;
+        this._uuidQueue.length = 0;
+        this._byteQueue.length = 0;
+    }
+    /** @inheritdoc RandomService.random — queued values only; returns `0` when empty (never calls `Math.random`). */
+    random() {
+        const next = this._randomQueue.shift();
+        return next ?? 0;
+    }
+    /** @inheritdoc RandomService.cryptoRandom — queued values only; returns `0` when empty (never calls `crypto.random`). */
+    cryptoRandom() {
+        const next = this._cryptoRandomQueue.shift();
+        return next ?? 0;
+    }
+    /** @inheritdoc RandomService.randomUUID — queued values only; never calls `crypto.randomUUID`. */
+    randomUUID() {
+        return this._uuidQueue.shift() ?? '00000000-0000-0000-0000-000000000000';
+    }
+    /** @inheritdoc RandomService.getRandomValues — queued bytes only; never calls `crypto.getRandomValues`. */
+    getRandomValues(array) {
+        const view = new Uint8Array(array.buffer, array.byteOffset, array.byteLength);
+        for (let index = 0; index < view.length; index++) {
+            view[index] = this._byteQueue.shift() ?? 0;
+        }
+        return array;
+    }
+}
+/**
+ * Thrown when an abstract `@`{@link mock} port method is called but the test scripted no
+ * implementation for it. The message names the method so the fix is obvious.
+ *
+ * @category Testing
+ */
+export class PreloadError extends Error {
+    constructor(method) {
+        super(`ihsm: '${method}()' was called but not stubbed — script it first with port.${method}.default(...) or port.${method}.once(...)`);
+        this.name = 'PreloadError';
+    }
+}
+/** Property names the auto-stub must never synthesize — JS/test-framework probes and built-in port services. */
+const NON_STUB_PROPS = new Set(['then', 'catch', 'finally', 'toJSON', 'inspect', 'asymmetricMatch', '$$typeof', 'nodeType', 'setTimeout', 'setInterval', 'clearTimeout', 'clearInterval', 'random', 'cryptoRandom', 'randomUUID', 'getRandomValues', 'advance', 'now', 'pending', 'feedRandom', 'feedCryptoRandom', 'feedUUID', 'feedRandomBytes', 'resetRandom']);
+function buildMethodStub(target, name) {
+    const stub = (...args) => target._consumePreload(name, args);
+    stub.default = (impl) => {
+        target._stubDefault(name, impl);
+        return stub;
+    };
+    stub.once = (impl) => {
+        target._stubOnce(name, impl);
+        return stub;
+    };
+    stub.reset = () => {
+        target._stubReset(name);
+        return stub;
+    };
+    Object.defineProperty(stub, 'calls', { get: () => target._stubCalls(name), enumerable: false });
+    return stub;
+}
+/** Marker set by {@link mock} so {@link makeTestPort} can verify the class was decorated. */
+const MOCK_MARKER = Symbol('ihsm.mock');
+/**
+ * Class decorator that turns an **abstract** {@link TestPort} subclass into a preloadable mock.
+ *
+ * Declare each port method as an `abstract` member whose **signature matches the real port**, and
+ * decorate the class with `@`{@link mock}. Instances (built with {@link makeTestPort}) then expose
+ * every abstract method as a scriptable {@link Stubbed} method: it records each call and returns
+ * whatever the test scripted with `method.default(...)` / `method.once(...)`. You never write a
+ * method body — the behavior lives in the test, so one mock serves many scenarios.
+ *
+ * Concrete members (public fields holding device state, helper methods) are left untouched; only the
+ * abstract port methods are auto-stubbed.
+ *
+ * @example
+ * ```ts
+ * @ihsmTest.mock
+ * abstract class WatcherMock extends ihsmTest.TestPort<WatcherTop> {
+ *   abstract watch(path: string): ihsm.ResultWithSubscription<number>; // signature matches the port
+ * }
+ *
+ * const port = ihsmTest.makeTestPort(WatcherMock);
+ * port.watch.default(path => ({ value: 1, subscription: { dispose: () => port.record('dispose') } }));
+ * ```
+ *
+ * @category Testing
+ */
+export function mock(Ctor) {
+    const Decorated = class extends Ctor {
+        constructor(...args) {
+            super(...args);
+            const stubs = new Map();
+            const proxy = new Proxy(this, {
+                get(t, prop, receiver) {
+                    if (typeof prop === 'string' && !(prop in t) && !NON_STUB_PROPS.has(prop)) {
+                        let stub = stubs.get(prop);
+                        if (stub === undefined) {
+                            stub = buildMethodStub(t, prop);
+                            stubs.set(prop, stub);
+                        }
+                        return stub;
+                    }
+                    return Reflect.get(t, prop, receiver);
+                },
+            });
+            return proxy;
+        }
+    };
+    Decorated[MOCK_MARKER] = true;
+    return Decorated;
+}
+/**
+ * Instantiate an `@`{@link mock}-decorated mock class — the canonical way to build a test port.
+ *
+ * Pass the mock **class**; you get back a typed instance whose abstract port methods (inferred from
+ * the machine's {@link TopState}) are scriptable {@link Stubbed} methods, ready for
+ * `port.method.default(...)`. The port's `actor` is still bound lazily when you hand the instance to
+ * {@link makeActor} / {@link makeTestActor}.
+ *
+ * @typeParam P - The mock class instance type (a {@link TestPort} subclass)
+ * @param PortClass - The `@mock`-decorated mock class
+ * @returns A scriptable {@link Mock} instance
+ * @throws If `PortClass` was not decorated with `@`{@link mock}
+ *
+ * @example
+ * ```ts
+ * const port = ihsmTest.makeTestPort(WatcherMock);
+ * port.watch.default(() => ({ value: 1, subscription: { dispose: () => port.send('onClosed') } }));
+ * const sm = ihsmTest.makeTestActor(WatcherTop, new WatcherCtx(), port);
+ * ```
+ *
+ * @category Testing
+ */
+export function makeTestPort(PortClass) {
+    if (PortClass[MOCK_MARKER] !== true) {
+        throw new Error('ihsm: makeTestPort requires a class decorated with @ihsm.mock');
+    }
+    return new PortClass();
+}
+/**
+ * Creates a **full-access** actor for deterministic tests: merged protocol + typed `port`.
+ *
+ * Identical construction to {@link makeActor} (same three mandatory arguments + {@link ActorOptions}),
+ * but the returned {@link TestActor} exposes the merged {@link Dispatch} protocol — so tests can
+ * drive internal events directly (no live port required) — and grants typed access to `port` for
+ * asserting outbound interactions or pushing observations.
+ *
+ * Unlike {@link makeActor}, `traceLevel` defaults to {@link TraceLevel.VERBOSE_DEBUG} so a failing
+ * test is fully readable; opt down explicitly via `options.traceLevel` only when you need a quiet run.
+ *
+ * @typeParam Context - Domain context type
+ * @typeParam Public - Public protocol
+ * @typeParam Internal - Internal protocol
+ * @typeParam P - Port type
+ * @param topState - Root state class; `Context` / `Public` / `Internal` are inferred from it (see {@link TopStateArg})
+ * @param ctx - Mutable domain object shared by all states
+ * @param port - Outbound {@link Port} instance (its `actor` is bound by the factory)
+ * @param options - Optional tuning: `initialize` / `traceLevel` / `traceWriter` / … (see {@link ActorOptions})
+ * @returns A {@link TestActor} handle with full event + port access
+ *
+ * @example
+ * ```ts
+ * const sm = makeTestActor(ConnTop, new ConnCtx(), ihsmTest.makeTestPort(ConnMock));
+ * ```
+ *
+ * @category Factory
+ */
+export function makeTestActor(topState, ctx, port, options = {}, ..._disjointGuard) {
+    // Tests default to the most verbose trace (so a failing run is fully readable). Never silence to
+    // a production level here — the user opts down explicitly via `options.traceLevel`.
+    const { initialize = defaultInitialize, traceLevel = TraceLevel.VERBOSE_DEBUG, traceWriter = defaultTraceWriter, dispatchErrorCallback = defaultDispatchErrorCallback } = options;
+    const hsm = makeHsm(topState, ctx, initialize, traceLevel, traceWriter, dispatchErrorCallback, port);
+    return hsm;
+}
+//# sourceMappingURL=testing.js.map

package/lib/esm/testing.js.map

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

package/package.json

@@ -7,7 +7,7 @@
 	"contributors": [
 		"Roberto Boati"
 	],
-	"description": "Class-based hierarchical state machines and actor mailboxes for TypeScript — typed post/call, zero dependencies",
+	"description": "Class-based hierarchical state machines and run-to-completion actors for TypeScript, designed for Deterministic Simulation Testing (DST) — typed post/call, zero dependencies",
 	"files": [
 		"lib"
 	],
@@ -40,7 +40,12 @@
 		"fsm",
 		"state machine",
 		"hierarchical state machine",
-		"statechart"
+		"statechart",
+		"deterministic simulation testing",
+		"dst",
+		"deterministic",
+		"testing",
+		"actor model"
 	],
 	"license": "MIT",
 	"maintainers": [
@@ -76,12 +81,23 @@
 				"default": "./lib/cjs/index.js"
 			}
 		},
+		"./testing": {
+			"import": {
+				"types": "./lib/esm/testing.d.ts",
+				"default": "./lib/esm/testing.js"
+			},
+			"require": {
+				"types": "./lib/cjs/testing.d.ts",
+				"default": "./lib/cjs/testing.js"
+			}
+		},
 		"./package.json": "./package.json"
 	},
 	"name": "ihsm",
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/filasieno/ihsm.git"
+		"url": "https://github.com/filasieno/ihsm.git",
+		"directory": "packages/ihsm"
 	},
 	"scripts": {
 		"build-cjs": "tsc -b tsconfig.lib.json",
@@ -116,5 +132,5 @@
 		"pretypecheck": "npm run prepare:ide"
 	},
 	"types": "./lib/cjs/index.d.ts",
-	"version": "0.0.21"
+	"version": "0.0.22"
 }