effect-machine 0.12.0 → 0.14.0

package/v3/dist/testing.js

@@ -1,13 +1,22 @@
 import { stubSystem } from "./internal/utils.js";
 import { AssertionError } from "./errors.js";
-import { BuiltMachine } from "./machine.js";
 import { executeTransition, shouldPostpone } from "./internal/transition.js";
+import { materializeMachine } from "./machine.js";
 import { Effect, SubscriptionRef } from "effect";
 //#region src/testing.ts
+const makeDummySelf = (label) => {
+	const dummySend = Effect.fn(label)((_event) => Effect.void);
+	return {
+		send: dummySend,
+		cast: dummySend,
+		spawn: () => Effect.die(`spawn not supported in ${label}`),
+		reply: () => Effect.succeed(false)
+	};
+};
 /**
 * Simulate a sequence of events through a machine without running an actor.
 * Useful for testing state transitions in isolation.
-* Does not run onEnter/spawn/background effects, but does run guard/effect slots
+* Does not run onEnter/spawn/background effects, but does run slots
 * within transition handlers.
 *
 * @example
@@ -24,14 +33,9 @@ import { Effect, SubscriptionRef } from "effect";
 * expect(result.states).toHaveLength(3) // Idle -> Loading -> Success
 * ```
 */
-const simulate = Effect.fn("effect-machine.simulate")(function* (input, events) {
-	const machine = input instanceof BuiltMachine ? input._inner : input;
-	const dummySend = Effect.fn("effect-machine.testing.simulate.send")((_event) => Effect.void);
-	const dummySelf = {
-		send: dummySend,
-		cast: dummySend,
-		spawn: () => Effect.die("spawn not supported in simulation")
-	};
+const simulate = Effect.fn("effect-machine.simulate")(function* (input, events, options) {
+	const machine = materializeMachine(input, options?.slots);
+	const dummySelf = makeDummySelf("effect-machine.testing.simulate");
 	let currentState = machine.initial;
 	const states = [currentState];
 	const hasPostponeRules = machine.postponeRules.length > 0;
@@ -73,8 +77,8 @@ const simulate = Effect.fn("effect-machine.simulate")(function* (input, events)
 /**
 * Assert that a machine can reach a specific state given a sequence of events
 */
-const assertReaches = Effect.fn("effect-machine.assertReaches")(function* (input, events, expectedTag) {
-	const result = yield* simulate(input, events);
+const assertReaches = Effect.fn("effect-machine.assertReaches")(function* (input, events, expectedTag, options) {
+	const result = yield* simulate(input, events, options);
 	if (result.finalState._tag !== expectedTag) return yield* new AssertionError({ message: `Expected final state "${expectedTag}" but got "${result.finalState._tag}". States visited: ${result.states.map((s) => s._tag).join(" -> ")}` });
 	return result.finalState;
 });
@@ -90,8 +94,8 @@ const assertReaches = Effect.fn("effect-machine.assertReaches")(function* (input
 * )
 * ```
 */
-const assertPath = Effect.fn("effect-machine.assertPath")(function* (input, events, expectedPath) {
-	const result = yield* simulate(input, events);
+const assertPath = Effect.fn("effect-machine.assertPath")(function* (input, events, expectedPath, options) {
+	const result = yield* simulate(input, events, options);
 	const actualPath = result.states.map((s) => s._tag);
 	if (actualPath.length !== expectedPath.length) return yield* new AssertionError({ message: `Path length mismatch. Expected ${expectedPath.length} states but got ${actualPath.length}.\nExpected: ${expectedPath.join(" -> ")}\nActual:   ${actualPath.join(" -> ")}` });
 	for (let i = 0; i < expectedPath.length; i++) if (actualPath[i] !== expectedPath[i]) return yield* new AssertionError({ message: `Path mismatch at position ${i}. Expected "${expectedPath[i]}" but got "${actualPath[i]}".\nExpected: ${expectedPath.join(" -> ")}\nActual:   ${actualPath.join(" -> ")}` });
@@ -110,15 +114,15 @@ const assertPath = Effect.fn("effect-machine.assertPath")(function* (input, even
 * )
 * ```
 */
-const assertNeverReaches = Effect.fn("effect-machine.assertNeverReaches")(function* (input, events, forbiddenTag) {
-	const result = yield* simulate(input, events);
+const assertNeverReaches = Effect.fn("effect-machine.assertNeverReaches")(function* (input, events, forbiddenTag, options) {
+	const result = yield* simulate(input, events, options);
 	const visitedIndex = result.states.findIndex((s) => s._tag === forbiddenTag);
 	if (visitedIndex !== -1) return yield* new AssertionError({ message: `Machine reached forbidden state "${forbiddenTag}" at position ${visitedIndex}.\nStates visited: ${result.states.map((s) => s._tag).join(" -> ")}` });
 	return result;
 });
 /**
 * Create a test harness for step-by-step testing.
-* Does not run onEnter/spawn/background effects, but does run guard/effect slots
+* Does not run onEnter/spawn/background effects, but does run slots
 * within transition handlers.
 *
 * @example Basic usage
@@ -138,13 +142,8 @@ const assertNeverReaches = Effect.fn("effect-machine.assertNeverReaches")(functi
 * ```
 */
 const createTestHarness = Effect.fn("effect-machine.createTestHarness")(function* (input, options) {
-	const machine = input instanceof BuiltMachine ? input._inner : input;
-	const dummySend = Effect.fn("effect-machine.testing.harness.send")((_event) => Effect.void);
-	const dummySelf = {
-		send: dummySend,
-		cast: dummySend,
-		spawn: () => Effect.die("spawn not supported in test harness")
-	};
+	const machine = materializeMachine(input, options?.slots);
+	const dummySelf = makeDummySelf("effect-machine.testing.harness");
 	const stateRef = yield* SubscriptionRef.make(machine.initial);
 	const hasPostponeRules = machine.postponeRules.length > 0;
 	const postponed = [];