@triggery/testing 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @triggery/testing
+
+## 0.1.0
+
+First public preview release.
+
+Testing utilities for Triggery — isolated runtime, mock conditions/actions, fake scheduler
+
+See the [repository-level CHANGELOG](../../CHANGELOG.md#010--2026-05-16) for the full set of packages and the umbrella feature list. Future entries on this file are appended automatically by changesets.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aleksey Skhomenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# @triggery/testing
+
+Testing utilities for [Triggery](https://github.com/triggeryjs/triggery).
+
+Provides:
+
+- `createTestRuntime({ triggers })` — isolated runtime for tests.
+- `mockCondition(name, value)` / `mockAction(name, fn)` — replace ports without rendering React.
+- `fakeScheduler` — control time (advance, flush).
+- Vitest and Jest adapters.
+
+## Install
+
+```bash
+pnpm add -D @triggery/testing
+```
+
+## License
+
+MIT © Aleksey Skhomenko

package/dist/index.d.ts

@@ -0,0 +1,110 @@
+import { Runtime, TriggerSchema, ConditionKey, Trigger, ConditionMap, RegistrationToken, ActionKey, ActionFn, ActionMap, RuntimeOptions } from '@triggery/core';
+
+/**
+ * Deterministic time controller for tests. Replaces global `setTimeout` /
+ * `clearTimeout` with a virtual clock — pending timers don't fire until you
+ * call `advance(ms)` or `flushAll()`. Useful for testing the
+ * `actions.debounce / throttle / defer` wrappers without `await new
+ * Promise(setTimeout, …)` flakes.
+ *
+ * Test-runner agnostic — no dependency on Vitest's `vi.useFakeTimers()` so it
+ * also works in plain `node:test`, Jest, etc.
+ *
+ * @example
+ * ```ts
+ * const ft = createFakeScheduler();
+ * ft.install();
+ * try {
+ *   rt.fire('tick');
+ *   await ft.advance(500);   // run all timers due within 500ms
+ *   expect(action).toHaveBeenCalledTimes(1);
+ * } finally {
+ *   ft.uninstall();
+ * }
+ * ```
+ */
+interface FakeScheduler {
+    /** Replace globalThis.setTimeout / clearTimeout with the fake controller. */
+    install(): void;
+    /** Restore the real timer functions. Safe to call multiple times. */
+    uninstall(): void;
+    /** Current virtual clock value, in ms since install. */
+    now(): number;
+    /**
+     * Advance the virtual clock by `ms` and run every timer that becomes due in
+     * that window. Returns a promise that resolves after pending microtasks are
+     * drained, so callers can `await ft.advance(N)` and then assert.
+     */
+    advance(ms: number): Promise<void>;
+    /**
+     * Run every pending timer (regardless of its scheduled time). Useful for
+     * "give up on the clock, just see what eventually happens".
+     */
+    flushAll(): Promise<void>;
+    /** Number of timers still pending. */
+    pending(): number;
+}
+declare function createFakeScheduler(): FakeScheduler;
+
+/**
+ * @triggery/testing — testing utilities for Triggery.
+ *
+ * The kit lets you write trigger tests without React, mocking conditions and
+ * actions against an isolated runtime instead of relying on `getDefaultRuntime`.
+ *
+ * @example
+ * ```ts
+ * import { createTrigger } from '@triggery/core';
+ * import { createTestRuntime } from '@triggery/testing';
+ *
+ * const rt = createTestRuntime();
+ * const t = createTrigger<{
+ *   events: { tick: number };
+ *   conditions: { enabled: boolean };
+ *   actions: { log: number };
+ * }>(
+ *   {
+ *     id: 'demo',
+ *     events: ['tick'],
+ *     required: ['enabled'],
+ *     handler: ({ event, conditions, actions }) => {
+ *       if (!conditions.enabled) return;
+ *       actions.log?.(event.payload);
+ *     },
+ *   },
+ *   rt,
+ * );
+ *
+ * rt.mockCondition(t, 'enabled', true);
+ * const log = vi.fn();
+ * rt.mockAction(t, 'log', log);
+ *
+ * rt.fireSync('tick', 42);
+ * expect(log).toHaveBeenCalledWith(42);
+ * ```
+ */
+
+type TestRuntimeOptions = RuntimeOptions;
+type TestRuntime = Runtime & {
+    /**
+     * Register a condition for a trigger.
+     *
+     * Accepts either a static value or a zero-argument getter. When the
+     * condition's value type is itself a zero-argument function, pass an
+     * explicit getter so the runtime knows which one you mean — otherwise the
+     * heuristic below would call your value as if it were the getter.
+     */
+    mockCondition<S extends TriggerSchema, K extends ConditionKey<S>>(trigger: Trigger<S>, name: K, valueOrGetter: ConditionMap<S>[K] | (() => ConditionMap<S>[K])): RegistrationToken;
+    /** Register an action handler — typically a `vi.fn()`. */
+    mockAction<S extends TriggerSchema, K extends ActionKey<S>>(trigger: Trigger<S>, name: K, handler: ActionFn<ActionMap<S>[K]>): RegistrationToken;
+    /**
+     * Flush pending microtasks. The default scheduler uses `queueMicrotask` —
+     * after `rt.fire(...)` you await `flushMicrotasks()` before asserting.
+     *
+     * `fireSync` does not need this: it runs handlers immediately.
+     */
+    flushMicrotasks(): Promise<void>;
+};
+declare function createTestRuntime(options?: TestRuntimeOptions): TestRuntime;
+
+export { type FakeScheduler, type TestRuntime, type TestRuntimeOptions, createFakeScheduler, createTestRuntime };

package/dist/index.js

@@ -0,0 +1,113 @@
+import { createRuntime } from '@triggery/core';
+
+// src/index.ts
+
+// src/fakeScheduler.ts
+function createFakeScheduler() {
+  const timers = /* @__PURE__ */ new Map();
+  let now = 0;
+  let counter = 0;
+  let installed = false;
+  let originalSetTimeout = null;
+  let originalClearTimeout = null;
+  function install() {
+    if (installed) return;
+    installed = true;
+    originalSetTimeout = globalThis.setTimeout;
+    originalClearTimeout = globalThis.clearTimeout;
+    globalThis.setTimeout = ((fn, ms = 0) => {
+      const id = ++counter;
+      timers.set(id, { id, fn, runAt: now + Math.max(0, ms) });
+      return id;
+    });
+    globalThis.clearTimeout = ((handle) => {
+      if (handle == null) return;
+      timers.delete(handle);
+    });
+  }
+  function uninstall() {
+    if (!installed) return;
+    installed = false;
+    if (originalSetTimeout) globalThis.setTimeout = originalSetTimeout;
+    if (originalClearTimeout) globalThis.clearTimeout = originalClearTimeout;
+    originalSetTimeout = null;
+    originalClearTimeout = null;
+    timers.clear();
+    now = 0;
+    counter = 0;
+  }
+  async function advance(ms) {
+    if (ms < 0) throw new Error("[triggery/testing] advance(): ms must be >= 0");
+    const target = now + ms;
+    while (true) {
+      const due = [...timers.values()].filter((t) => t.runAt <= target);
+      if (due.length === 0) break;
+      due.sort((a, b) => a.runAt - b.runAt || a.id - b.id);
+      const next = due[0];
+      timers.delete(next.id);
+      now = next.runAt;
+      try {
+        next.fn();
+      } catch (err) {
+        console.error("[triggery/testing] fakeScheduler timer threw:", err);
+      }
+    }
+    now = target;
+    await Promise.resolve();
+    await Promise.resolve();
+  }
+  async function flushAll() {
+    while (timers.size > 0) {
+      const sorted = [...timers.values()].sort((a, b) => a.runAt - b.runAt || a.id - b.id);
+      const next = sorted[0];
+      timers.delete(next.id);
+      now = Math.max(now, next.runAt);
+      try {
+        next.fn();
+      } catch (err) {
+        console.error("[triggery/testing] fakeScheduler timer threw:", err);
+      }
+    }
+    await Promise.resolve();
+    await Promise.resolve();
+  }
+  return {
+    install,
+    uninstall,
+    now: () => now,
+    advance,
+    flushAll,
+    pending: () => timers.size
+  };
+}
+
+// src/index.ts
+var isLikelyGetter = (fn) => fn.length === 0;
+function createTestRuntime(options = {}) {
+  const runtime = createRuntime(options);
+  const mockCondition = (trigger, name, valueOrGetter) => {
+    const getter = typeof valueOrGetter === "function" && isLikelyGetter(valueOrGetter) ? valueOrGetter : () => valueOrGetter;
+    return runtime.registerCondition(trigger.id, name, getter);
+  };
+  const mockAction = (trigger, name, handler) => {
+    return runtime.registerAction(
+      trigger.id,
+      name,
+      handler
+    );
+  };
+  const flushMicrotasks = async () => {
+    await Promise.resolve();
+    await Promise.resolve();
+  };
+  return {
+    ...runtime,
+    mockCondition,
+    mockAction,
+    flushMicrotasks
+  };
+}
+
+export { createFakeScheduler, createTestRuntime };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fakeScheduler.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Deterministic time controller for tests. Replaces global `setTimeout` /\n * `clearTimeout` with a virtual clock — pending timers don't fire until you\n * call `advance(ms)` or `flushAll()`. Useful for testing the\n * `actions.debounce / throttle / defer` wrappers without `await new\n * Promise(setTimeout, …)` flakes.\n *\n * Test-runner agnostic — no dependency on Vitest's `vi.useFakeTimers()` so it\n * also works in plain `node:test`, Jest, etc.\n *\n * @example\n * ```ts\n * const ft = createFakeScheduler();\n * ft.install();\n * try {\n *   rt.fire('tick');\n *   await ft.advance(500);   // run all timers due within 500ms\n *   expect(action).toHaveBeenCalledTimes(1);\n * } finally {\n *   ft.uninstall();\n * }\n * ```\n */\nexport interface FakeScheduler {\n  /** Replace globalThis.setTimeout / clearTimeout with the fake controller. */\n  install(): void;\n  /** Restore the real timer functions. Safe to call multiple times. */\n  uninstall(): void;\n  /** Current virtual clock value, in ms since install. */\n  now(): number;\n  /**\n   * Advance the virtual clock by `ms` and run every timer that becomes due in\n   * that window. Returns a promise that resolves after pending microtasks are\n   * drained, so callers can `await ft.advance(N)` and then assert.\n   */\n  advance(ms: number): Promise<void>;\n  /**\n   * Run every pending timer (regardless of its scheduled time). Useful for\n   * \"give up on the clock, just see what eventually happens\".\n   */\n  flushAll(): Promise<void>;\n  /** Number of timers still pending. */\n  pending(): number;\n}\n\ninterface PendingTimer {\n  id: number;\n  fn: () => void;\n  runAt: number;\n}\n\ntype TimerHandle = ReturnType<typeof globalThis.setTimeout>;\n\nexport function createFakeScheduler(): FakeScheduler {\n  const timers = new Map<number, PendingTimer>();\n  let now = 0;\n  let counter = 0;\n  let installed = false;\n  let originalSetTimeout: typeof globalThis.setTimeout | null = null;\n  let originalClearTimeout: typeof globalThis.clearTimeout | null = null;\n\n  function install(): void {\n    if (installed) return;\n    installed = true;\n    originalSetTimeout = globalThis.setTimeout;\n    originalClearTimeout = globalThis.clearTimeout;\n    globalThis.setTimeout = ((fn: () => void, ms: number = 0): TimerHandle => {\n      const id = ++counter;\n      timers.set(id, { id, fn, runAt: now + Math.max(0, ms) });\n      return id as unknown as TimerHandle;\n    }) as typeof globalThis.setTimeout;\n    globalThis.clearTimeout = ((handle: TimerHandle | undefined): void => {\n      if (handle == null) return;\n      timers.delete(handle as unknown as number);\n    }) as typeof globalThis.clearTimeout;\n  }\n\n  function uninstall(): void {\n    if (!installed) return;\n    installed = false;\n    if (originalSetTimeout) globalThis.setTimeout = originalSetTimeout;\n    if (originalClearTimeout) globalThis.clearTimeout = originalClearTimeout;\n    originalSetTimeout = null;\n    originalClearTimeout = null;\n    timers.clear();\n    now = 0;\n    counter = 0;\n  }\n\n  async function advance(ms: number): Promise<void> {\n    if (ms < 0) throw new Error('[triggery/testing] advance(): ms must be >= 0');\n    const target = now + ms;\n    // Drain in-order across the advance; new timers scheduled during a callback\n    // count if their runAt falls within `target`.\n    while (true) {\n      const due = [...timers.values()].filter((t) => t.runAt <= target);\n      if (due.length === 0) break;\n      due.sort((a, b) => a.runAt - b.runAt || a.id - b.id);\n      const next = due[0] as PendingTimer;\n      timers.delete(next.id);\n      now = next.runAt;\n      try {\n        next.fn();\n      } catch (err) {\n        // eslint-disable-next-line no-console -- surface to test output\n        console.error('[triggery/testing] fakeScheduler timer threw:', err);\n      }\n    }\n    now = target;\n    // Drain microtasks twice — handlers may queue follow-ups.\n    await Promise.resolve();\n    await Promise.resolve();\n  }\n\n  async function flushAll(): Promise<void> {\n    while (timers.size > 0) {\n      const sorted = [...timers.values()].sort((a, b) => a.runAt - b.runAt || a.id - b.id);\n      const next = sorted[0] as PendingTimer;\n      timers.delete(next.id);\n      now = Math.max(now, next.runAt);\n      try {\n        next.fn();\n      } catch (err) {\n        // eslint-disable-next-line no-console -- surface to test output\n        console.error('[triggery/testing] fakeScheduler timer threw:', err);\n      }\n    }\n    await Promise.resolve();\n    await Promise.resolve();\n  }\n\n  return {\n    install,\n    uninstall,\n    now: () => now,\n    advance,\n    flushAll,\n    pending: () => timers.size,\n  };\n}\n","/**\n * @triggery/testing — testing utilities for Triggery.\n *\n * The kit lets you write trigger tests without React, mocking conditions and\n * actions against an isolated runtime instead of relying on `getDefaultRuntime`.\n *\n * @example\n * ```ts\n * import { createTrigger } from '@triggery/core';\n * import { createTestRuntime } from '@triggery/testing';\n *\n * const rt = createTestRuntime();\n * const t = createTrigger<{\n *   events: { tick: number };\n *   conditions: { enabled: boolean };\n *   actions: { log: number };\n * }>(\n *   {\n *     id: 'demo',\n *     events: ['tick'],\n *     required: ['enabled'],\n *     handler: ({ event, conditions, actions }) => {\n *       if (!conditions.enabled) return;\n *       actions.log?.(event.payload);\n *     },\n *   },\n *   rt,\n * );\n *\n * rt.mockCondition(t, 'enabled', true);\n * const log = vi.fn();\n * rt.mockAction(t, 'log', log);\n *\n * rt.fireSync('tick', 42);\n * expect(log).toHaveBeenCalledWith(42);\n * ```\n */\n\nimport type {\n  ActionFn,\n  ActionKey,\n  ActionMap,\n  ConditionGetter,\n  ConditionKey,\n  ConditionMap,\n  RegistrationToken,\n  Runtime,\n  RuntimeOptions,\n  Trigger,\n  TriggerSchema,\n  UntypedActionFn,\n} from '@triggery/core';\nimport { createRuntime } from '@triggery/core';\n\nexport { createFakeScheduler, type FakeScheduler } from './fakeScheduler.ts';\n\nexport type TestRuntimeOptions = RuntimeOptions;\n\nexport type TestRuntime = Runtime & {\n  /**\n   * Register a condition for a trigger.\n   *\n   * Accepts either a static value or a zero-argument getter. When the\n   * condition's value type is itself a zero-argument function, pass an\n   * explicit getter so the runtime knows which one you mean — otherwise the\n   * heuristic below would call your value as if it were the getter.\n   */\n  mockCondition<S extends TriggerSchema, K extends ConditionKey<S>>(\n    trigger: Trigger<S>,\n    name: K,\n    valueOrGetter: ConditionMap<S>[K] | (() => ConditionMap<S>[K]),\n  ): RegistrationToken;\n\n  /** Register an action handler — typically a `vi.fn()`. */\n  mockAction<S extends TriggerSchema, K extends ActionKey<S>>(\n    trigger: Trigger<S>,\n    name: K,\n    handler: ActionFn<ActionMap<S>[K]>,\n  ): RegistrationToken;\n\n  /**\n   * Flush pending microtasks. The default scheduler uses `queueMicrotask` —\n   * after `rt.fire(...)` you await `flushMicrotasks()` before asserting.\n   *\n   * `fireSync` does not need this: it runs handlers immediately.\n   */\n  flushMicrotasks(): Promise<void>;\n};\n\ntype AnyFn = (...args: never[]) => unknown;\nconst isLikelyGetter = (fn: AnyFn): boolean => fn.length === 0;\n\nexport function createTestRuntime(options: TestRuntimeOptions = {}): TestRuntime {\n  const runtime = createRuntime(options);\n\n  const mockCondition = <S extends TriggerSchema, K extends ConditionKey<S>>(\n    trigger: Trigger<S>,\n    name: K,\n    valueOrGetter: ConditionMap<S>[K] | (() => ConditionMap<S>[K]),\n  ): RegistrationToken => {\n    const getter: ConditionGetter =\n      typeof valueOrGetter === 'function' && isLikelyGetter(valueOrGetter as AnyFn)\n        ? (valueOrGetter as ConditionGetter)\n        : () => valueOrGetter;\n    return runtime.registerCondition(trigger.id, name as string, getter);\n  };\n\n  const mockAction = <S extends TriggerSchema, K extends ActionKey<S>>(\n    trigger: Trigger<S>,\n    name: K,\n    handler: ActionFn<ActionMap<S>[K]>,\n  ): RegistrationToken => {\n    return runtime.registerAction(\n      trigger.id,\n      name as string,\n      handler as unknown as UntypedActionFn,\n    );\n  };\n\n  const flushMicrotasks = async (): Promise<void> => {\n    // Two rounds: the first drains the queue we know about, the second picks\n    // up follow-up microtasks queued by handlers that already ran.\n    await Promise.resolve();\n    await Promise.resolve();\n  };\n\n  return {\n    ...runtime,\n    mockCondition,\n    mockAction,\n    flushMicrotasks,\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@triggery/testing",
+  "version": "0.1.0",
+  "description": "Testing utilities for Triggery — isolated runtime, mock conditions/actions, fake scheduler",
+  "license": "MIT",
+  "author": "Aleksey Skhomenko",
+  "homepage": "https://triggeryjs.github.io/triggery",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/triggeryjs/triggery.git",
+    "directory": "packages/testing"
+  },
+  "bugs": "https://github.com/triggeryjs/triggery/issues",
+  "funding": [
+    {
+      "type": "patreon",
+      "url": "https://www.patreon.com/triggery"
+    },
+    {
+      "type": "boosty",
+      "url": "https://boosty.to/triggery"
+    }
+  ],
+  "keywords": [
+    "triggery",
+    "testing",
+    "vitest",
+    "jest",
+    "mocking"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@triggery/core": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6",
+    "@triggery/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest --passWithNoTests",
+    "test:coverage": "vitest run --coverage --passWithNoTests",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}