@hurum/core 0.0.1

package/dist/testing.cjs

@@ -0,0 +1,237 @@
+'use strict';
+
+// src/computed.ts
+function structuralEqual(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return false;
+  if (typeof a !== typeof b) return false;
+  if (typeof a !== "object") return false;
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i++) {
+      if (!structuralEqual(a[i], b[i])) return false;
+    }
+    return true;
+  }
+  if (Array.isArray(a) !== Array.isArray(b)) return false;
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length) return false;
+  for (const key of keysA) {
+    if (!structuralEqual(a[key], b[key])) return false;
+  }
+  return true;
+}
+
+// testing/test-store.ts
+function TestStore(storeDef, options) {
+  const instance = storeDef.create(options);
+  const instanceSend = instance.send;
+  const testSendBase = async (...args) => {
+    instanceSend(...args);
+    await flushMicrotasks();
+  };
+  const testSend = new Proxy(testSendBase, {
+    get(_target, prop) {
+      if (typeof prop !== "string") return void 0;
+      if (prop === "then") return void 0;
+      if (prop === "bind" || prop === "call" || prop === "apply" || prop === "length" || prop === "name" || prop === "prototype")
+        return testSendBase[prop];
+      const shortcut = instanceSend[prop];
+      if (typeof shortcut === "function") {
+        return async (payload) => {
+          shortcut(payload);
+          await flushMicrotasks();
+        };
+      }
+      return void 0;
+    }
+  });
+  return {
+    send: testSend,
+    getState() {
+      return instance.getState();
+    },
+    get scope() {
+      return instance.scope;
+    },
+    assertState(expected) {
+      const state = instance.getState();
+      for (const [key, value] of Object.entries(expected)) {
+        if (!structuralEqual(state[key], value)) {
+          throw new Error(
+            `State mismatch for key "${key}":
+  Expected: ${JSON.stringify(value)}
+  Received: ${JSON.stringify(state[key])}`
+          );
+        }
+      }
+    },
+    assertEvents(expected) {
+      const actual = instance.__eventLog;
+      if (actual.length !== expected.length) {
+        throw new Error(
+          `Event count mismatch:
+  Expected ${expected.length} events: [${expected.map((e) => e.type).join(", ")}]
+  Received ${actual.length} events: [${actual.map((e) => e.type).join(", ")}]`
+        );
+      }
+      for (let i = 0; i < expected.length; i++) {
+        const exp = expected[i];
+        const act = actual[i];
+        if (!structuralEqual(exp, act)) {
+          throw new Error(
+            `Event mismatch at index ${i}:
+  Expected: ${JSON.stringify(exp)}
+  Received: ${JSON.stringify(act)}`
+          );
+        }
+      }
+    },
+    assertEventSequence(expected) {
+      const snapshots = instance.__stateSnapshots;
+      for (const { event: expectedEvent, state: expectedState } of expected) {
+        const snapshot = snapshots.find((s) => structuralEqual(s.event, expectedEvent));
+        if (!snapshot) {
+          throw new Error(
+            `Expected event not found in sequence:
+  ${JSON.stringify(expectedEvent)}`
+          );
+        }
+        for (const [key, value] of Object.entries(expectedState)) {
+          if (!structuralEqual(snapshot.state[key], value)) {
+            throw new Error(
+              `State mismatch after event "${expectedEvent.type}" for key "${key}":
+  Expected: ${JSON.stringify(value)}
+  Received: ${JSON.stringify(snapshot.state[key])}`
+            );
+          }
+        }
+      }
+    },
+    assertNoRunningExecutors() {
+      const count = instance.__runningCount();
+      if (count > 0) {
+        throw new Error(
+          `Expected no running executors, but ${count} are still running`
+        );
+      }
+    }
+  };
+}
+async function flushMicrotasks() {
+  for (let i = 0; i < 10; i++) {
+    await new Promise((resolve) => setTimeout(resolve, 0));
+  }
+}
+function getExecutorFn(executor) {
+  return executor.__fn;
+}
+
+// testing/test-executor.ts
+function TestExecutor(executor, options) {
+  const fn = getExecutorFn(executor);
+  const emittedEvents = [];
+  const abortController = new AbortController();
+  const state = options?.state ?? {};
+  function emit(event) {
+    emittedEvents.push(event);
+  }
+  return {
+    async run(input) {
+      const context = {
+        deps: options?.deps ?? {},
+        emit,
+        getState: () => state,
+        signal: abortController.signal,
+        scope: {}
+      };
+      const result = fn(input, context);
+      if (result instanceof Promise) {
+        await result;
+      }
+    },
+    abort() {
+      abortController.abort();
+    },
+    assertEmitted(expected) {
+      if (emittedEvents.length !== expected.length) {
+        throw new Error(
+          `Emitted event count mismatch:
+  Expected ${expected.length} events: [${expected.map((e) => e.type).join(", ")}]
+  Received ${emittedEvents.length} events: [${emittedEvents.map((e) => e.type).join(", ")}]`
+        );
+      }
+      for (let i = 0; i < expected.length; i++) {
+        const exp = expected[i];
+        const act = emittedEvents[i];
+        if (!structuralEqual(exp, act)) {
+          throw new Error(
+            `Emitted event mismatch at index ${i}:
+  Expected: ${JSON.stringify(exp)}
+  Received: ${JSON.stringify(act)}`
+          );
+        }
+      }
+    },
+    get emittedEvents() {
+      return emittedEvents;
+    }
+  };
+}
+
+// testing/test-reducer.ts
+function TestReducer(storeDef) {
+  const config = storeDef.__config;
+  return {
+    apply(state, event) {
+      const handler = config.on?.[event.type];
+      if (!handler) {
+        return state;
+      }
+      const { type: _type, ...payload } = event;
+      return handler(
+        state,
+        payload
+      );
+    }
+  };
+}
+
+// testing/test-computed.ts
+function TestComputed(storeDef, fieldName) {
+  const config = storeDef.__config;
+  const computedDef = config.computed;
+  if (!computedDef) {
+    throw new Error(
+      `[hurum] Store has no computed definition. Cannot test computed field "${fieldName}".`
+    );
+  }
+  return {
+    evaluate(rawState) {
+      const fn = computedDef[fieldName];
+      if (!fn || typeof fn !== "function") {
+        throw new Error(
+          `[hurum] Computed field "${fieldName}" not found in store.`
+        );
+      }
+      return fn(rawState);
+    }
+  };
+}
+
+// testing/test-intent.ts
+function TestIntent(intent) {
+  return {
+    commands: intent.commands,
+    mode: intent.mode
+  };
+}
+
+exports.TestComputed = TestComputed;
+exports.TestExecutor = TestExecutor;
+exports.TestIntent = TestIntent;
+exports.TestReducer = TestReducer;
+exports.TestStore = TestStore;
+//# sourceMappingURL=testing.cjs.map
+//# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/computed.ts","../testing/test-store.ts","../src/command-executor.ts","../testing/test-executor.ts","../testing/test-reducer.ts","../testing/test-computed.ts","../testing/test-intent.ts"],"names":[],"mappings":"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","file":"testing.cjs","sourcesContent":["// @hurum/core — Computed\n\n/** Internal representation of a resolved computed field */\nexport interface ComputedNode<T = unknown> {\n  readonly name: string\n  fn: (state: Record<string, unknown>) => T\n  deps: Set<string>\n  value: T\n  prevValue: T\n}\n\n/**\n * Create a dependency-tracking proxy for the raw state.\n * Records which properties are accessed during computed evaluation.\n */\nexport function createTrackingProxy<T extends Record<string, unknown>>(\n  state: T,\n  accessed: Set<string>,\n): T {\n  return new Proxy(state, {\n    get(target, prop, receiver) {\n      if (typeof prop === 'string') {\n        accessed.add(prop)\n      }\n      return Reflect.get(target, prop, receiver)\n    },\n  })\n}\n\n/**\n * Initialize computed nodes from a computed definition map.\n * Returns nodes in topological order for evaluation.\n */\nexport function initializeComputedNodes(\n  rawState: Record<string, unknown>,\n  computedDef: Record<string, (state: Record<string, unknown>) => unknown> | undefined,\n): ComputedNode[] {\n  if (!computedDef) return []\n\n  const nodes: ComputedNode[] = []\n  const nodesByName = new Map<string, ComputedNode>()\n\n  // Evaluate each computed and track dependencies\n  for (const [name, fn] of Object.entries(computedDef)) {\n    const accessed = new Set<string>()\n    const trackingProxy = createTrackingProxy(rawState, accessed)\n    const value = fn(trackingProxy)\n\n    const node: ComputedNode = {\n      name,\n      fn,\n      deps: accessed,\n      value,\n      prevValue: value,\n    }\n    nodes.push(node)\n    nodesByName.set(name, node)\n  }\n\n  // Check for cycles via topological sort\n  const sorted = topologicalSort(nodes, nodesByName)\n\n  return sorted\n}\n\n/**\n * Topological sort of computed nodes. Throws on cycle detection.\n */\nfunction topologicalSort(\n  nodes: ComputedNode[],\n  nodesByName: Map<string, ComputedNode>,\n): ComputedNode[] {\n  const visited = new Set<string>()\n  const visiting = new Set<string>()\n  const sorted: ComputedNode[] = []\n\n  function visit(node: ComputedNode): void {\n    if (visited.has(node.name)) return\n    if (visiting.has(node.name)) {\n      throw new Error(\n        `Circular dependency detected in computed fields: ${node.name}`,\n      )\n    }\n\n    visiting.add(node.name)\n\n    // Visit dependencies that are also computed nodes\n    for (const dep of node.deps) {\n      const depNode = nodesByName.get(dep)\n      if (depNode) {\n        visit(depNode)\n      }\n    }\n\n    visiting.delete(node.name)\n    visited.add(node.name)\n    sorted.push(node)\n  }\n\n  for (const node of nodes) {\n    visit(node)\n  }\n\n  return sorted\n}\n\n/**\n * Re-evaluate computed nodes based on state changes.\n * Returns the new computed values and whether any changed.\n */\nexport function evaluateComputedNodes(\n  nodes: ComputedNode[],\n  rawState: Record<string, unknown>,\n  changedKeys: Set<string>,\n): { values: Record<string, unknown>; changed: boolean } {\n  const values: Record<string, unknown> = {}\n  let anyChanged = false\n\n  for (const node of nodes) {\n    // Check if any dependency changed\n    let needsReeval = false\n    for (const dep of node.deps) {\n      if (changedKeys.has(dep)) {\n        needsReeval = true\n        break\n      }\n    }\n\n    if (needsReeval) {\n      // Re-evaluate with fresh tracking\n      const accessed = new Set<string>()\n      const trackingProxy = createTrackingProxy(rawState, accessed)\n      const newValue = node.fn(trackingProxy)\n\n      // Update deps\n      node.deps = accessed\n\n      // Structural equality check\n      if (!structuralEqual(node.value, newValue)) {\n        node.prevValue = node.value\n        node.value = newValue\n        anyChanged = true\n        changedKeys.add(node.name) // Propagate to dependent computed nodes\n      }\n    }\n\n    values[node.name] = node.value\n  }\n\n  return { values, changed: anyChanged }\n}\n\n/**\n * Simple structural equality check.\n * Handles primitives, arrays, and plain objects.\n */\nexport function structuralEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true\n  if (a === null || b === null) return false\n  if (typeof a !== typeof b) return false\n  if (typeof a !== 'object') return false\n\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false\n    for (let i = 0; i < a.length; i++) {\n      if (!structuralEqual(a[i], b[i])) return false\n    }\n    return true\n  }\n\n  if (Array.isArray(a) !== Array.isArray(b)) return false\n\n  const keysA = Object.keys(a as object)\n  const keysB = Object.keys(b as object)\n  if (keysA.length !== keysB.length) return false\n\n  for (const key of keysA) {\n    if (!structuralEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key])) return false\n  }\n\n  return true\n}\n","// @hurum/core/testing — TestStore\n\nimport type { StoreDefinition, StoreCreateOptions, StoreInternalFields, StoreInstance, ResolvedState, SendFn } from '../src/store'\nimport type { IntentDescriptor, PreparedIntent } from '../src/intent'\nimport type { EventInstance } from '../src/events'\nimport { structuralEqual } from '../src/computed'\n\n/** Async version of SendFn for test store — each call flushes microtasks before resolving. */\nexport type TestSendFn<TIntents extends Record<string, unknown> = Record<string, never>> = {\n  <TInput>(prepared: PreparedIntent<TInput>): Promise<void>\n  <TInput>(intent: IntentDescriptor<TInput>, payload: TInput): Promise<void>\n} & {\n  readonly [K in keyof TIntents]: (payload: TIntents[K]) => Promise<void>\n}\n\nexport interface TestStoreInstance<TRawState = unknown, TComputed = unknown, TIntents extends Record<string, unknown> = Record<string, never>> {\n  send: TestSendFn<TIntents>\n  getState(): ResolvedState<TRawState> & TComputed\n  /** Access nested child store instances via scope. */\n  readonly scope: StoreInstance<unknown, TRawState, TComputed>['scope']\n  assertState(expected: Partial<ResolvedState<TRawState> & TComputed>): void\n  assertEvents(expected: EventInstance[]): void\n  assertEventSequence(\n    expected: Array<{ event: EventInstance; state: Partial<ResolvedState<TRawState> & TComputed> }>,\n  ): void\n  assertNoRunningExecutors(): void\n}\n\n/**\n * Create a test store for integration testing.\n * Wraps `Store.create()` with testing utilities.\n */\nexport function TestStore<TDeps, TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(\n  storeDef: StoreDefinition<TDeps, TRawState, TComputed, TIntents>,\n  options?: StoreCreateOptions<TRawState, TDeps>,\n): TestStoreInstance<TRawState, TComputed, TIntents> {\n  const instance = storeDef.create(options) as StoreInstance<TDeps, TRawState, TComputed, TIntents> & StoreInternalFields\n\n  // Create async test send that wraps the real send proxy\n  const instanceSend = instance.send as SendFn<TIntents>\n\n  const testSendBase = async (...args: unknown[]): Promise<void> => {\n    ;(instanceSend as Function)(...args)\n    await flushMicrotasks()\n  }\n\n  const testSend = new Proxy(testSendBase as TestSendFn<TIntents>, {\n    get(_target, prop) {\n      if (typeof prop !== 'string') return undefined\n      // Prevent thenable detection (would break await)\n      if (prop === 'then') return undefined\n      // Standard function properties\n      if (prop === 'bind' || prop === 'call' || prop === 'apply' || prop === 'length' || prop === 'name' || prop === 'prototype')\n        return (testSendBase as unknown as Record<string, unknown>)[prop]\n      // Delegate to instance.send's proxy for intent lookup\n      const shortcut = (instanceSend as unknown as Record<string, unknown>)[prop]\n      if (typeof shortcut === 'function') {\n        return async (payload: unknown) => {\n          ;(shortcut as Function)(payload)\n          await flushMicrotasks()\n        }\n      }\n      return undefined\n    },\n  })\n\n  return {\n    send: testSend,\n\n    getState(): ResolvedState<TRawState> & TComputed {\n      return instance.getState()\n    },\n\n    get scope() {\n      return instance.scope\n    },\n\n    assertState(expected: Partial<ResolvedState<TRawState> & TComputed>): void {\n      const state = instance.getState() as Record<string, unknown>\n      for (const [key, value] of Object.entries(expected as Record<string, unknown>)) {\n        if (!structuralEqual(state[key], value)) {\n          throw new Error(\n            `State mismatch for key \"${key}\":\\n` +\n            `  Expected: ${JSON.stringify(value)}\\n` +\n            `  Received: ${JSON.stringify(state[key])}`,\n          )\n        }\n      }\n    },\n\n    assertEvents(expected: EventInstance[]): void {\n      const actual = instance.__eventLog\n      if (actual.length !== expected.length) {\n        throw new Error(\n          `Event count mismatch:\\n` +\n          `  Expected ${expected.length} events: [${expected.map((e) => e.type).join(', ')}]\\n` +\n          `  Received ${actual.length} events: [${actual.map((e) => e.type).join(', ')}]`,\n        )\n      }\n      for (let i = 0; i < expected.length; i++) {\n        const exp = expected[i]!\n        const act = actual[i]!\n        if (!structuralEqual(exp, act)) {\n          throw new Error(\n            `Event mismatch at index ${i}:\\n` +\n            `  Expected: ${JSON.stringify(exp)}\\n` +\n            `  Received: ${JSON.stringify(act)}`,\n          )\n        }\n      }\n    },\n\n    assertEventSequence(\n      expected: Array<{ event: EventInstance; state: Partial<ResolvedState<TRawState> & TComputed> }>,\n    ): void {\n      const snapshots = instance.__stateSnapshots\n\n      for (const { event: expectedEvent, state: expectedState } of expected) {\n        // Find the snapshot matching this event\n        const snapshot = snapshots.find((s) => structuralEqual(s.event, expectedEvent))\n        if (!snapshot) {\n          throw new Error(\n            `Expected event not found in sequence:\\n` +\n            `  ${JSON.stringify(expectedEvent)}`,\n          )\n        }\n\n        for (const [key, value] of Object.entries(expectedState as Record<string, unknown>)) {\n          if (!structuralEqual(snapshot.state[key], value)) {\n            throw new Error(\n              `State mismatch after event \"${expectedEvent.type}\" for key \"${key}\":\\n` +\n              `  Expected: ${JSON.stringify(value)}\\n` +\n              `  Received: ${JSON.stringify(snapshot.state[key])}`,\n            )\n          }\n        }\n      }\n    },\n\n    assertNoRunningExecutors(): void {\n      const count = instance.__runningCount()\n      if (count > 0) {\n        throw new Error(\n          `Expected no running executors, but ${count} are still running`,\n        )\n      }\n    },\n  }\n}\n\nasync function flushMicrotasks(): Promise<void> {\n  // Flush several rounds of microtasks to ensure all async work completes\n  for (let i = 0; i < 10; i++) {\n    await new Promise<void>((resolve) => setTimeout(resolve, 0))\n  }\n}\n","// @hurum/core — CommandExecutor\n\nimport type { EventCreator, EventInstance } from './events'\n\n// Branding symbols\nconst COMMAND_BRAND = Symbol('hurum/command')\nconst EXECUTOR_BRAND = Symbol('hurum/executor')\n\n/** A branded command type. Commands are identified by their unique symbol. */\nexport interface Command<TInput = unknown> {\n  readonly [COMMAND_BRAND]: symbol\n  readonly name?: string\n  readonly __inputType?: TInput\n}\n\n/** Context provided to executor functions */\nexport interface ExecutorContext<TDeps = unknown, TState = unknown> {\n  readonly deps: TDeps\n  readonly emit: (event: EventInstance) => void\n  readonly getState: () => TState\n  readonly signal: AbortSignal\n  /** Access nested child store instances. Available when the store has Nested fields. */\n  readonly scope: Record<string, unknown>\n}\n\n/** The executor function type */\nexport type ExecutorFn<TInput, TDeps, TState> = (\n  command: TInput,\n  context: ExecutorContext<TDeps, TState>,\n) => void | Promise<void>\n\n/** An executor registered with a Store.\n *  __fn is type-erased (never params) to keep Executor covariant in TInput/TDeps/TState. */\nexport interface Executor<TInput = unknown, TDeps = unknown, TState = unknown> {\n  readonly [EXECUTOR_BRAND]: true\n  readonly __command: Command<TInput>\n  readonly __fn: (command: never, context: never) => void | Promise<void>\n  readonly __inputType?: TInput\n  readonly __depsType?: TDeps\n  readonly __stateType?: TState\n}\n\n/**\n * Create a CommandExecutor pair: [Command, Executor].\n *\n * Optionally provide a name as the first argument for devtools visibility.\n *\n * @example\n * ```ts\n * // With explicit name\n * const [SaveCmd, SaveExec] = CommandExecutor<\n *   { purchase: Purchase },\n *   { repo: PurchaseRepo },\n * >('SavePurchase', async (command, { deps, emit }) => {\n *   const result = await deps.repo.save(command.purchase)\n *   result.match(\n *     (saved) => emit(PurchaseEvent.saved({ purchase: saved })),\n *     (error) => emit(PurchaseEvent.saveFailed({ error })),\n *   )\n * })\n *\n * // Without name (fn.name used as fallback for named functions)\n * const [SaveCmd, SaveExec] = CommandExecutor<{ purchase: Purchase }>(\n *   async function SavePurchase(command, { emit }) => { ... }\n * )\n * ```\n */\nexport function CommandExecutor<\n  TInput,\n  TDeps = Record<string, never>,\n  TState = unknown,\n>(\n  nameOrFn: string | ExecutorFn<TInput, TDeps, TState>,\n  maybeFn?: ExecutorFn<TInput, TDeps, TState>,\n): [Command<TInput>, Executor<TInput, TDeps, TState>] {\n  const name = typeof nameOrFn === 'string' ? nameOrFn : (nameOrFn.name || undefined)\n  const fn = typeof nameOrFn === 'string' ? maybeFn! : nameOrFn\n\n  const commandId = Symbol('hurum/command-id')\n  const command: Command<TInput> = {\n    [COMMAND_BRAND]: commandId,\n    ...(name ? { name } : {}),\n  }\n  const executor: Executor<TInput, TDeps, TState> = {\n    [EXECUTOR_BRAND]: true,\n    __command: command,\n    __fn: fn as Executor['__fn'],\n  }\n  return [command, executor]\n}\n\n/**\n * Create a passthrough CommandExecutor that simply emits an event with\n * the command payload (optionally transformed).\n *\n * Optionally provide a name as the first argument for devtools visibility.\n *\n * @example\n * ```ts\n * // With name\n * const [IncrCmd, IncrExec] = CommandExecutor.passthrough('Increment', CounterEvent.incremented)\n *\n * // Without name\n * const [IncrCmd, IncrExec] = CommandExecutor.passthrough(CounterEvent.incremented)\n *\n * // With name + transform\n * const [SetCmd, SetExec] = CommandExecutor.passthrough(\n *   'SetUserName',\n *   UserEvent.nameChanged,\n *   (cmd: { name: string }) => ({ name: cmd.name.trim(), changedAt: Date.now() })\n * )\n * ```\n */\nCommandExecutor.passthrough = function passthrough<\n  TType extends string,\n  TPayload,\n  TInput = TPayload,\n>(\n  nameOrEventCreator: string | EventCreator<TType, TPayload>,\n  eventCreatorOrTransform?: EventCreator<TType, TPayload> | ((input: TInput) => TPayload),\n  maybeTransform?: (input: TInput) => TPayload,\n): [Command<TInput>, Executor<TInput, Record<string, never>, unknown>] {\n  let name: string | undefined\n  let eventCreator: EventCreator<TType, TPayload>\n  let transform: ((input: TInput) => TPayload) | undefined\n\n  if (typeof nameOrEventCreator === 'string') {\n    name = nameOrEventCreator\n    eventCreator = eventCreatorOrTransform as EventCreator<TType, TPayload>\n    transform = maybeTransform\n  } else {\n    eventCreator = nameOrEventCreator\n    transform = eventCreatorOrTransform as ((input: TInput) => TPayload) | undefined\n  }\n\n  const commandId = Symbol('hurum/command-id')\n  const command: Command<TInput> = {\n    [COMMAND_BRAND]: commandId,\n    ...(name ? { name } : {}),\n  }\n  const executorFn: ExecutorFn<TInput, Record<string, never>, unknown> = (input, { emit }) => {\n    const payload = transform ? transform(input) : input as unknown as TPayload\n    emit(eventCreator(payload))\n  }\n  const executor: Executor<TInput, Record<string, never>, unknown> = {\n    [EXECUTOR_BRAND]: true,\n    __command: command,\n    __fn: executorFn as Executor['__fn'],\n  }\n  return [command, executor]\n} as {\n  <TType extends string, TPayload>(\n    eventCreator: EventCreator<TType, TPayload>,\n  ): [Command<TPayload>, Executor<TPayload, Record<string, never>, unknown>]\n\n  <TType extends string, TPayload, TInput>(\n    eventCreator: EventCreator<TType, TPayload>,\n    transform: (input: TInput) => TPayload,\n  ): [Command<TInput>, Executor<TInput, Record<string, never>, unknown>]\n\n  <TType extends string, TPayload>(\n    name: string,\n    eventCreator: EventCreator<TType, TPayload>,\n  ): [Command<TPayload>, Executor<TPayload, Record<string, never>, unknown>]\n\n  <TType extends string, TPayload, TInput>(\n    name: string,\n    eventCreator: EventCreator<TType, TPayload>,\n    transform: (input: TInput) => TPayload,\n  ): [Command<TInput>, Executor<TInput, Record<string, never>, unknown>]\n}\n\n/** Check if a value is a Command */\nexport function isCommand(value: unknown): value is Command {\n  return typeof value === 'object' && value !== null && COMMAND_BRAND in value\n}\n\n/** Check if a value is an Executor */\nexport function isExecutor(value: unknown): value is Executor {\n  return typeof value === 'object' && value !== null && EXECUTOR_BRAND in value\n}\n\n/** Get the internal command symbol from a Command (for Store matching) */\nexport function getCommandId(command: Command): symbol {\n  return command[COMMAND_BRAND]\n}\n\n/** Get the command from an executor */\nexport function getExecutorCommand(executor: Executor): Command {\n  return executor.__command\n}\n\n/** Get the executor function (type-erased; callers cast as needed) */\nexport function getExecutorFn(executor: Executor): Executor['__fn'] {\n  return executor.__fn\n}\n","// @hurum/core/testing — TestExecutor\n\nimport type { Executor } from '../src/command-executor'\nimport { getExecutorFn } from '../src/command-executor'\nimport type { EventInstance } from '../src/events'\nimport { structuralEqual } from '../src/computed'\n\nexport interface TestExecutorInstance<TInput = unknown> {\n  run(input: TInput): Promise<void>\n  abort(): void\n  assertEmitted(expected: EventInstance[]): void\n  readonly emittedEvents: EventInstance[]\n}\n\nexport interface TestExecutorOptions {\n  deps?: Record<string, unknown>\n  state?: Record<string, unknown>\n}\n\n/**\n * Create a test executor for unit testing.\n * Runs the executor function in isolation with mock context.\n */\nexport function TestExecutor<TInput>(\n  executor: Executor<TInput>,\n  options?: TestExecutorOptions,\n): TestExecutorInstance<TInput> {\n  const fn = getExecutorFn(executor)\n  const emittedEvents: EventInstance[] = []\n  const abortController = new AbortController()\n\n  const state = options?.state ?? {}\n\n  function emit(event: EventInstance): void {\n    emittedEvents.push(event)\n  }\n\n  return {\n    async run(input: TInput): Promise<void> {\n      const context = {\n        deps: options?.deps ?? {},\n        emit,\n        getState: () => state,\n        signal: abortController.signal,\n        scope: {},\n      }\n\n      const result = (fn as (input: TInput, ctx: typeof context) => void | Promise<void>)(input, context)\n      if (result instanceof Promise) {\n        await result\n      }\n    },\n\n    abort(): void {\n      abortController.abort()\n    },\n\n    assertEmitted(expected: EventInstance[]): void {\n      if (emittedEvents.length !== expected.length) {\n        throw new Error(\n          `Emitted event count mismatch:\\n` +\n          `  Expected ${expected.length} events: [${expected.map((e) => e.type).join(', ')}]\\n` +\n          `  Received ${emittedEvents.length} events: [${emittedEvents.map((e) => e.type).join(', ')}]`,\n        )\n      }\n      for (let i = 0; i < expected.length; i++) {\n        const exp = expected[i]!\n        const act = emittedEvents[i]!\n        if (!structuralEqual(exp, act)) {\n          throw new Error(\n            `Emitted event mismatch at index ${i}:\\n` +\n            `  Expected: ${JSON.stringify(exp)}\\n` +\n            `  Received: ${JSON.stringify(act)}`,\n          )\n        }\n      }\n    },\n\n    get emittedEvents() {\n      return emittedEvents\n    },\n  }\n}\n","// @hurum/core/testing — TestReducer\n\nimport type { StoreDefinition, ResolvedState } from '../src/store'\nimport type { EventInstance } from '../src/events'\n\nexport interface TestReducerInstance<TRawState = unknown> {\n  apply(state: ResolvedState<TRawState>, event: EventInstance): ResolvedState<TRawState>\n}\n\n/**\n * Create a test reducer for unit testing on handlers.\n * Applies an event to a given state and returns the new state.\n */\nexport function TestReducer<TDeps, TRawState, TComputed>(\n  storeDef: StoreDefinition<TDeps, TRawState, TComputed>,\n): TestReducerInstance<TRawState> {\n  const config = storeDef.__config\n\n  return {\n    apply(state: ResolvedState<TRawState>, event: EventInstance): ResolvedState<TRawState> {\n      const handler = config.on?.[event.type]\n      if (!handler) {\n        return state\n      }\n\n      const { type: _type, ...payload } = event\n      return handler(\n        state as Record<string, unknown>,\n        payload as Record<string, unknown>,\n      ) as ResolvedState<TRawState>\n    },\n  }\n}\n","// @hurum/core/testing — TestComputed\n\nimport type { StoreDefinition } from '../src/store'\n\nexport interface TestComputedInstance<TResult = unknown> {\n  evaluate(rawState: Record<string, unknown>): TResult\n}\n\n/**\n * Create a test computed for unit testing computed fields.\n * Evaluates a single computed field against a given raw state.\n */\nexport function TestComputed<TDeps, TRawState, TComputed>(\n  storeDef: StoreDefinition<TDeps, TRawState, TComputed>,\n  fieldName: string & keyof TComputed,\n): TestComputedInstance<TComputed[typeof fieldName]> {\n  const config = storeDef.__config\n  const computedDef = config.computed\n\n  if (!computedDef) {\n    throw new Error(\n      `[hurum] Store has no computed definition. Cannot test computed field \"${fieldName}\".`,\n    )\n  }\n\n  return {\n    evaluate(rawState: Record<string, unknown>): TComputed[typeof fieldName] {\n      const fn = computedDef[fieldName]\n      if (!fn || typeof fn !== 'function') {\n        throw new Error(\n          `[hurum] Computed field \"${fieldName}\" not found in store.`,\n        )\n      }\n      return fn(rawState) as TComputed[typeof fieldName]\n    },\n  }\n}\n","// @hurum/core/testing — TestIntent\n\nimport type { IntentDescriptor, IntentMode } from '../src/intent'\nimport type { Command } from '../src/command-executor'\n\nexport interface TestIntentInstance {\n  readonly commands: ReadonlyArray<Command>\n  readonly mode: IntentMode\n}\n\n/**\n * Create a test intent for inspecting intent configuration.\n * Returns the commands and execution mode of an intent descriptor.\n */\nexport function TestIntent(intent: IntentDescriptor): TestIntentInstance {\n  return {\n    commands: intent.commands,\n    mode: intent.mode,\n  }\n}\n"]}

package/dist/testing.d.cts

@@ -0,0 +1,73 @@
+import { P as PreparedIntent, l as IntentDescriptor, S as StoreDefinition, A as StoreCreateOptions, R as ResolvedState, a as StoreInstance, E as EventInstance, i as Executor, b as Command, n as IntentMode } from './store-BrPM22fc.cjs';
+
+/** Async version of SendFn for test store — each call flushes microtasks before resolving. */
+type TestSendFn<TIntents extends Record<string, unknown> = Record<string, never>> = {
+    <TInput>(prepared: PreparedIntent<TInput>): Promise<void>;
+    <TInput>(intent: IntentDescriptor<TInput>, payload: TInput): Promise<void>;
+} & {
+    readonly [K in keyof TIntents]: (payload: TIntents[K]) => Promise<void>;
+};
+interface TestStoreInstance<TRawState = unknown, TComputed = unknown, TIntents extends Record<string, unknown> = Record<string, never>> {
+    send: TestSendFn<TIntents>;
+    getState(): ResolvedState<TRawState> & TComputed;
+    /** Access nested child store instances via scope. */
+    readonly scope: StoreInstance<unknown, TRawState, TComputed>['scope'];
+    assertState(expected: Partial<ResolvedState<TRawState> & TComputed>): void;
+    assertEvents(expected: EventInstance[]): void;
+    assertEventSequence(expected: Array<{
+        event: EventInstance;
+        state: Partial<ResolvedState<TRawState> & TComputed>;
+    }>): void;
+    assertNoRunningExecutors(): void;
+}
+/**
+ * Create a test store for integration testing.
+ * Wraps `Store.create()` with testing utilities.
+ */
+declare function TestStore<TDeps, TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(storeDef: StoreDefinition<TDeps, TRawState, TComputed, TIntents>, options?: StoreCreateOptions<TRawState, TDeps>): TestStoreInstance<TRawState, TComputed, TIntents>;
+
+interface TestExecutorInstance<TInput = unknown> {
+    run(input: TInput): Promise<void>;
+    abort(): void;
+    assertEmitted(expected: EventInstance[]): void;
+    readonly emittedEvents: EventInstance[];
+}
+interface TestExecutorOptions {
+    deps?: Record<string, unknown>;
+    state?: Record<string, unknown>;
+}
+/**
+ * Create a test executor for unit testing.
+ * Runs the executor function in isolation with mock context.
+ */
+declare function TestExecutor<TInput>(executor: Executor<TInput>, options?: TestExecutorOptions): TestExecutorInstance<TInput>;
+
+interface TestReducerInstance<TRawState = unknown> {
+    apply(state: ResolvedState<TRawState>, event: EventInstance): ResolvedState<TRawState>;
+}
+/**
+ * Create a test reducer for unit testing on handlers.
+ * Applies an event to a given state and returns the new state.
+ */
+declare function TestReducer<TDeps, TRawState, TComputed>(storeDef: StoreDefinition<TDeps, TRawState, TComputed>): TestReducerInstance<TRawState>;
+
+interface TestComputedInstance<TResult = unknown> {
+    evaluate(rawState: Record<string, unknown>): TResult;
+}
+/**
+ * Create a test computed for unit testing computed fields.
+ * Evaluates a single computed field against a given raw state.
+ */
+declare function TestComputed<TDeps, TRawState, TComputed>(storeDef: StoreDefinition<TDeps, TRawState, TComputed>, fieldName: string & keyof TComputed): TestComputedInstance<TComputed[typeof fieldName]>;
+
+interface TestIntentInstance {
+    readonly commands: ReadonlyArray<Command>;
+    readonly mode: IntentMode;
+}
+/**
+ * Create a test intent for inspecting intent configuration.
+ * Returns the commands and execution mode of an intent descriptor.
+ */
+declare function TestIntent(intent: IntentDescriptor): TestIntentInstance;
+
+export { TestComputed, TestExecutor, TestIntent, TestReducer, type TestSendFn, TestStore, type TestStoreInstance };

package/dist/testing.d.ts

@@ -0,0 +1,73 @@
+import { P as PreparedIntent, l as IntentDescriptor, S as StoreDefinition, A as StoreCreateOptions, R as ResolvedState, a as StoreInstance, E as EventInstance, i as Executor, b as Command, n as IntentMode } from './store-BrPM22fc.js';
+
+/** Async version of SendFn for test store — each call flushes microtasks before resolving. */
+type TestSendFn<TIntents extends Record<string, unknown> = Record<string, never>> = {
+    <TInput>(prepared: PreparedIntent<TInput>): Promise<void>;
+    <TInput>(intent: IntentDescriptor<TInput>, payload: TInput): Promise<void>;
+} & {
+    readonly [K in keyof TIntents]: (payload: TIntents[K]) => Promise<void>;
+};
+interface TestStoreInstance<TRawState = unknown, TComputed = unknown, TIntents extends Record<string, unknown> = Record<string, never>> {
+    send: TestSendFn<TIntents>;
+    getState(): ResolvedState<TRawState> & TComputed;
+    /** Access nested child store instances via scope. */
+    readonly scope: StoreInstance<unknown, TRawState, TComputed>['scope'];
+    assertState(expected: Partial<ResolvedState<TRawState> & TComputed>): void;
+    assertEvents(expected: EventInstance[]): void;
+    assertEventSequence(expected: Array<{
+        event: EventInstance;
+        state: Partial<ResolvedState<TRawState> & TComputed>;
+    }>): void;
+    assertNoRunningExecutors(): void;
+}
+/**
+ * Create a test store for integration testing.
+ * Wraps `Store.create()` with testing utilities.
+ */
+declare function TestStore<TDeps, TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(storeDef: StoreDefinition<TDeps, TRawState, TComputed, TIntents>, options?: StoreCreateOptions<TRawState, TDeps>): TestStoreInstance<TRawState, TComputed, TIntents>;
+
+interface TestExecutorInstance<TInput = unknown> {
+    run(input: TInput): Promise<void>;
+    abort(): void;
+    assertEmitted(expected: EventInstance[]): void;
+    readonly emittedEvents: EventInstance[];
+}
+interface TestExecutorOptions {
+    deps?: Record<string, unknown>;
+    state?: Record<string, unknown>;
+}
+/**
+ * Create a test executor for unit testing.
+ * Runs the executor function in isolation with mock context.
+ */
+declare function TestExecutor<TInput>(executor: Executor<TInput>, options?: TestExecutorOptions): TestExecutorInstance<TInput>;
+
+interface TestReducerInstance<TRawState = unknown> {
+    apply(state: ResolvedState<TRawState>, event: EventInstance): ResolvedState<TRawState>;
+}
+/**
+ * Create a test reducer for unit testing on handlers.
+ * Applies an event to a given state and returns the new state.
+ */
+declare function TestReducer<TDeps, TRawState, TComputed>(storeDef: StoreDefinition<TDeps, TRawState, TComputed>): TestReducerInstance<TRawState>;
+
+interface TestComputedInstance<TResult = unknown> {
+    evaluate(rawState: Record<string, unknown>): TResult;
+}
+/**
+ * Create a test computed for unit testing computed fields.
+ * Evaluates a single computed field against a given raw state.
+ */
+declare function TestComputed<TDeps, TRawState, TComputed>(storeDef: StoreDefinition<TDeps, TRawState, TComputed>, fieldName: string & keyof TComputed): TestComputedInstance<TComputed[typeof fieldName]>;
+
+interface TestIntentInstance {
+    readonly commands: ReadonlyArray<Command>;
+    readonly mode: IntentMode;
+}
+/**
+ * Create a test intent for inspecting intent configuration.
+ * Returns the commands and execution mode of an intent descriptor.
+ */
+declare function TestIntent(intent: IntentDescriptor): TestIntentInstance;
+
+export { TestComputed, TestExecutor, TestIntent, TestReducer, type TestSendFn, TestStore, type TestStoreInstance };

package/dist/testing.js

@@ -0,0 +1,231 @@
+// src/computed.ts
+function structuralEqual(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return false;
+  if (typeof a !== typeof b) return false;
+  if (typeof a !== "object") return false;
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i++) {
+      if (!structuralEqual(a[i], b[i])) return false;
+    }
+    return true;
+  }
+  if (Array.isArray(a) !== Array.isArray(b)) return false;
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length) return false;
+  for (const key of keysA) {
+    if (!structuralEqual(a[key], b[key])) return false;
+  }
+  return true;
+}
+
+// testing/test-store.ts
+function TestStore(storeDef, options) {
+  const instance = storeDef.create(options);
+  const instanceSend = instance.send;
+  const testSendBase = async (...args) => {
+    instanceSend(...args);
+    await flushMicrotasks();
+  };
+  const testSend = new Proxy(testSendBase, {
+    get(_target, prop) {
+      if (typeof prop !== "string") return void 0;
+      if (prop === "then") return void 0;
+      if (prop === "bind" || prop === "call" || prop === "apply" || prop === "length" || prop === "name" || prop === "prototype")
+        return testSendBase[prop];
+      const shortcut = instanceSend[prop];
+      if (typeof shortcut === "function") {
+        return async (payload) => {
+          shortcut(payload);
+          await flushMicrotasks();
+        };
+      }
+      return void 0;
+    }
+  });
+  return {
+    send: testSend,
+    getState() {
+      return instance.getState();
+    },
+    get scope() {
+      return instance.scope;
+    },
+    assertState(expected) {
+      const state = instance.getState();
+      for (const [key, value] of Object.entries(expected)) {
+        if (!structuralEqual(state[key], value)) {
+          throw new Error(
+            `State mismatch for key "${key}":
+  Expected: ${JSON.stringify(value)}
+  Received: ${JSON.stringify(state[key])}`
+          );
+        }
+      }
+    },
+    assertEvents(expected) {
+      const actual = instance.__eventLog;
+      if (actual.length !== expected.length) {
+        throw new Error(
+          `Event count mismatch:
+  Expected ${expected.length} events: [${expected.map((e) => e.type).join(", ")}]
+  Received ${actual.length} events: [${actual.map((e) => e.type).join(", ")}]`
+        );
+      }
+      for (let i = 0; i < expected.length; i++) {
+        const exp = expected[i];
+        const act = actual[i];
+        if (!structuralEqual(exp, act)) {
+          throw new Error(
+            `Event mismatch at index ${i}:
+  Expected: ${JSON.stringify(exp)}
+  Received: ${JSON.stringify(act)}`
+          );
+        }
+      }
+    },
+    assertEventSequence(expected) {
+      const snapshots = instance.__stateSnapshots;
+      for (const { event: expectedEvent, state: expectedState } of expected) {
+        const snapshot = snapshots.find((s) => structuralEqual(s.event, expectedEvent));
+        if (!snapshot) {
+          throw new Error(
+            `Expected event not found in sequence:
+  ${JSON.stringify(expectedEvent)}`
+          );
+        }
+        for (const [key, value] of Object.entries(expectedState)) {
+          if (!structuralEqual(snapshot.state[key], value)) {
+            throw new Error(
+              `State mismatch after event "${expectedEvent.type}" for key "${key}":
+  Expected: ${JSON.stringify(value)}
+  Received: ${JSON.stringify(snapshot.state[key])}`
+            );
+          }
+        }
+      }
+    },
+    assertNoRunningExecutors() {
+      const count = instance.__runningCount();
+      if (count > 0) {
+        throw new Error(
+          `Expected no running executors, but ${count} are still running`
+        );
+      }
+    }
+  };
+}
+async function flushMicrotasks() {
+  for (let i = 0; i < 10; i++) {
+    await new Promise((resolve) => setTimeout(resolve, 0));
+  }
+}
+function getExecutorFn(executor) {
+  return executor.__fn;
+}
+
+// testing/test-executor.ts
+function TestExecutor(executor, options) {
+  const fn = getExecutorFn(executor);
+  const emittedEvents = [];
+  const abortController = new AbortController();
+  const state = options?.state ?? {};
+  function emit(event) {
+    emittedEvents.push(event);
+  }
+  return {
+    async run(input) {
+      const context = {
+        deps: options?.deps ?? {},
+        emit,
+        getState: () => state,
+        signal: abortController.signal,
+        scope: {}
+      };
+      const result = fn(input, context);
+      if (result instanceof Promise) {
+        await result;
+      }
+    },
+    abort() {
+      abortController.abort();
+    },
+    assertEmitted(expected) {
+      if (emittedEvents.length !== expected.length) {
+        throw new Error(
+          `Emitted event count mismatch:
+  Expected ${expected.length} events: [${expected.map((e) => e.type).join(", ")}]
+  Received ${emittedEvents.length} events: [${emittedEvents.map((e) => e.type).join(", ")}]`
+        );
+      }
+      for (let i = 0; i < expected.length; i++) {
+        const exp = expected[i];
+        const act = emittedEvents[i];
+        if (!structuralEqual(exp, act)) {
+          throw new Error(
+            `Emitted event mismatch at index ${i}:
+  Expected: ${JSON.stringify(exp)}
+  Received: ${JSON.stringify(act)}`
+          );
+        }
+      }
+    },
+    get emittedEvents() {
+      return emittedEvents;
+    }
+  };
+}
+
+// testing/test-reducer.ts
+function TestReducer(storeDef) {
+  const config = storeDef.__config;
+  return {
+    apply(state, event) {
+      const handler = config.on?.[event.type];
+      if (!handler) {
+        return state;
+      }
+      const { type: _type, ...payload } = event;
+      return handler(
+        state,
+        payload
+      );
+    }
+  };
+}
+
+// testing/test-computed.ts
+function TestComputed(storeDef, fieldName) {
+  const config = storeDef.__config;
+  const computedDef = config.computed;
+  if (!computedDef) {
+    throw new Error(
+      `[hurum] Store has no computed definition. Cannot test computed field "${fieldName}".`
+    );
+  }
+  return {
+    evaluate(rawState) {
+      const fn = computedDef[fieldName];
+      if (!fn || typeof fn !== "function") {
+        throw new Error(
+          `[hurum] Computed field "${fieldName}" not found in store.`
+        );
+      }
+      return fn(rawState);
+    }
+  };
+}
+
+// testing/test-intent.ts
+function TestIntent(intent) {
+  return {
+    commands: intent.commands,
+    mode: intent.mode
+  };
+}
+
+export { TestComputed, TestExecutor, TestIntent, TestReducer, TestStore };
+//# sourceMappingURL=testing.js.map
+//# sourceMappingURL=testing.js.map