hooks-lib/tests/test-helpers.mjs

// tests/test-helpers.mjs — v0.3.0
//
// Foundry hook stub for the no-Foundry smoke test. Installs globalThis.Hooks
// with the same semantics as Foundry v14:
//   - Hooks.on(name, fn) — register
//   - Hooks.once(name, fn) — register (fires once on next callAll)
//   - Hooks.off(name, fn) — remove
//   - Hooks.callAll(name, ...args) — synchronous fan-out
//
// Also stubs globalThis.game and globalThis.ui so the library's init
// and ready hooks can run in pure Node.

import { performance } from "node:perf_hooks";

const _listeners = new Map(); // hookName -> [fn, ...]
const _once = new WeakMap();   // fn -> { hookName } for once-tracking
const _callLog = [];           // every Hooks.callAll(name, ...args) recorded

export function installStubs() {
  resetStubs();
  globalThis.Hooks = {
    on(name, fn) {
      _listeners.set(name, [...(_listeners.get(name) ?? []), fn]);
    },
    once(name, fn) {
      _listeners.set(name, [...(_listeners.get(name) ?? []), fn]);
      _once.set(fn, { hookName: name });
    },
    off(name, fn) {
      const list = _listeners.get(name);
      if (!list) return;
      const next = list.filter((f) => f !== fn);
      if (next.length === 0) _listeners.delete(name);
      else _listeners.set(name, next);
      _once.delete(fn);
    },
    callAll(name, ...args) {
      _callLog.push({ name, args, ts: performance.now() });
      const list = _listeners.get(name);
      if (!list) return;
      // Snapshot the list because handlers may add/remove listeners.
      const snapshot = [...list];
      for (const fn of snapshot) {
        if (_once.has(fn)) {
          // Once handler — remove before firing so re-entrant callAll doesn't re-fire.
          this.off(name, fn);
        }
        try {
          fn(...args);
        } catch (e) {
          // Mirror Foundry: errors in handlers are caught (the library
          // adds its own error containment on top).
          console.error(`[stubs] Hooks.callAll(${name}) handler threw:`, e);
        }
      }
    },
  };
  globalThis.game = {
    version: "13.351.0",
    system: { id: "test-system", version: "0.0.0" },
    modules: new Map(),
    user: null,
    ready: true,
  };
  globalThis.ui = { notifications: { info: () => {}, warn: () => {}, error: () => {} } };
}

export function resetStubs() {
  _listeners.clear();
  _callLog.length = 0;
}

export function getListeners(hookName) {
  return _listeners.get(hookName) ?? [];
}

export function getAllCallLog() {
  return [..._callLog];
}

export function clearCallLog() {
  _callLog.length = 0;
}

export function setGameVersion(version) {
  if (typeof globalThis.game === "undefined") globalThis.game = {};
  globalThis.game.version = version;
}

export function setGameSystem(system) {
  if (typeof globalThis.game === "undefined") globalThis.game = {};
  globalThis.game.system = system;
}