hooks-lib/scripts/main.js

// foundry-hooks-lib — module entry point (v0.2.0).
//
// Generic Foundry hook facade per HOOK_CONTRACT.md. No domain
// interpretation. Subscribes to every Foundry hook in the registered
// set (§6), emits a uniform {ts, hook, args} envelope, dispatches
// to consumers via the subscribe primitives (§3). System-specific
// knowledge lives in separate adapter repos (§5).
//
// Public API (mod.api):
//   VERSION
//   REGISTERED_HOOKS
//   subscribe(hookName, fn)
//   subscribeMany(map)
//   subscribeAll(fn)
//   unsubscribeAll()
//   registerSystemAdapter(manifest)
//   listActiveAdapters()
//   listInstalledRawHooks()
//   isReady()

import {
  install,
  uninstall,
  evaluateAdaptersAtReady,
  listInstalledRawHooks,
} from "./internal/lifecycle.js";
import {
  subscribe,
  subscribeMany,
  subscribeAll,
  unsubscribeAll,
  listSubscribedHooks,
} from "./internal/subscribers.js";
import {
  registerSystemAdapter,
  listActiveAdapters,
} from "./internal/adapter-registry.js";
import { REGISTERED_HOOKS } from "./internal/registered-hooks.js";

const MODULE_ID = "foundry-hooks-lib";
const MODULE_VERSION = "0.2.0";

function isClient() {
  return typeof ui !== "undefined" && !!ui;
}

// Public API — re-exported on mod.api so consumers can use either
// direct imports or the mod.api façade.
export const VERSION = MODULE_VERSION;
export { REGISTERED_HOOKS };
export {
  subscribe,
  subscribeMany,
  subscribeAll,
  unsubscribeAll,
  registerSystemAdapter,
  listActiveAdapters,
};

function isReady() {
  return isClient() && !!game.ready;
}

Hooks.once("init", () => {
  const mod = game.modules.get(MODULE_ID);
  mod.api = {
    MODULE_ID,
    version: MODULE_VERSION,
    REGISTERED_HOOKS: [...REGISTERED_HOOKS],
    isReady,
    subscribe,
    subscribeMany,
    subscribeAll,
    unsubscribeAll,
    registerSystemAdapter,
    listActiveAdapters,
    listInstalledRawHooks,
  };
  // Install Foundry hook listeners — every raw hook name in the registry.
  install();
  console.log(
    `[${MODULE_ID} v${MODULE_VERSION}] init: ${listInstalledRawHooks().length} ` +
    `Foundry hook listeners registered`
  );
});

Hooks.once("ready", () => {
  if (!isClient()) return;
  // Evaluate system adapters against the current world.
  evaluateAdaptersAtReady();
  console.log(
    `[${MODULE_ID} v${MODULE_VERSION}] ready (client=${isClient()})`
  );
});

// Cleanup on module disable.
Hooks.on("unregisterModule", (moduleId) => {
  if (moduleId === MODULE_ID) {
    uninstall();
    console.log(`[${MODULE_ID}] unregisterModule: cleaned up`);
  }
});