@esauflores/plugin-sdk 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cesar Flores
+
+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

@@ -1,3 +1,214 @@
-# Temporary Holding Version
+# plugin-sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A plugin system for **Bun and Node (24+)**. Its one dependency is `@standard-schema/spec` (types only). Plugins are npm packages (or local objects),
+trusted and run in-process. To use it, copy `src/` into your project (e.g. as `plugin-sdk/`).
+
+```
+src/
+  index.ts    PluginHost, definePlugin, ordering + timeouts; re-exports types and hooks
+  hooks.ts    HookBus: call / parallel / waterfall / bail
+  loader.ts   finds, checks and imports plugin packages (the only file using node:fs)
+  types.ts    the public contract: Plugin, PluginContext, options, errors, schema checks
+```
+
+`index.ts` imports `loader.ts` lazily inside `host.load()`. If you only use `host.register()`, the core never touches
+Node APIs, so it can run in a browser, a Worker or an edge runtime (after a TypeScript build; only Bun and Node are tested).
+
+The code only uses TypeScript syntax that can be erased (no enums, no parameter properties), and imports use `.ts`
+extensions. Bun runs it as is, and so does Node 23.6+ (type stripping). For a project with a build step, keep
+`allowImportingTsExtensions` or rewrite the imports to `.js`.
+
+## Lifecycle
+
+```
+register / load ─► setup (all) ─► start (all) ─► stop (all, reversed) ─► dispose
+                        │              │               │
+                        └── failed / disabled ◄────────┘   (torn down, dependents disabled)
+```
+
+- **Order**: plugins are flat (no nesting) and sorted by `dependsOn`; ties keep registration order.
+- **setup**: register hooks and `provide` services. Nothing with side effects goes here.
+- **start**: open sockets, start timers. Every plugin has finished setup by this point.
+- **stop**: `ctx.signal` aborts first, then `stop()` runs, then the `onDispose` callbacks run in reverse order. Hooks and services are removed automatically.
+- **Failure** (`failure: "isolate"`, the default): the plugin is torn down and its dependents are disabled; everything else keeps running.
+  With `"strict"`, the first failure tears everything down and `start()` rejects.
+- **Hook errors at runtime** follow `hookErrors` (see below), so one bad handler doesn't break a hook for everyone.
+- Each phase has a timeout (`timeoutMs`, 10s by default). A timeout aborts the plugin's signal.
+- **A host is single-use.** ES modules can't be unloaded, so to reload plugins, create a new host or restart the process.
+
+## The app (host)
+
+```ts
+import { PluginHost, definePluginFor } from "./plugin-sdk/index.ts";
+
+export interface AppHooks {
+  request: (req: Request) => Response | void;
+}
+export interface AppServices {
+  db: Database;
+}
+export const definePlugin = definePluginFor<AppHooks, AppServices>();
+
+const host = new PluginHost<AppHooks, AppServices>({
+  app: { name: "my-app", version: "2.1.0" }, // name = manifest key in plugin package.json
+  apiVersion: 1, // bump on breaking plugin-API changes
+});
+
+host.register(localPlugin);
+await host.load(["my-app-plugin-auth", ["@acme/my-app-metrics", { interval: 10 }]]); // from node_modules
+await host.start();
+
+const res = await host.hooks.bail("request", req);
+
+process.once("SIGTERM", () => host.stop());
+```
+
+`host.list()` / `host.get(name)` / `host.onStateChange()` report each plugin's state and, when one failed or was disabled, why.
+
+## Writing a plugin
+
+```ts
+export default definePlugin<{ prefix: string }>({
+  name: "auth",
+  dependsOn: ["db"], // ordering + permission to use("db")
+  setup(ctx) {
+    const db = ctx.use("db");
+    ctx.provide("auth", createAuth(db));
+    ctx.hooks.on("request", (req) => (req.url.startsWith(ctx.options.prefix) ? check(req) : undefined));
+  },
+  async start(ctx) {
+    const timer = setInterval(sweepSessions, 60_000);
+    ctx.onDispose(() => clearInterval(timer));
+  },
+});
+```
+
+| Hook style  | Behaviour                                                                                                     |
+| ----------- | ------------------------------------------------------------------------------------------------------------- |
+| `call`      | handlers run one after another; results ignored                                                               |
+| `parallel`  | handlers run concurrently                                                                                     |
+| `waterfall` | each handler gets the previous handler's result as its first argument (returning `undefined` keeps the value) |
+| `bail`      | first result that isn't `undefined` wins; the remaining handlers are skipped                                  |
+
+### Hook order
+
+Handlers run in three buckets: `"pre"`, then `"normal"` (the default), then `"post"`, in registration order within
+each. Use it when two plugins that don't depend on each other must agree on an order in a `waterfall` hook:
+
+```ts
+ctx.hooks.on("render", addBanner, { order: "post" }); // after minify, wherever minify registers
+```
+
+Order only places handlers; it doesn't create a dependency. Use `dependsOn` when you need the other plugin's services.
+
+### Interceptors (host only)
+
+`host.hooks.intercept()` observes every hook call, for tracing, metrics or finding slow plugins. Plugins can't
+use it: their `ctx.hooks` has no `intercept`.
+
+```ts
+const remove = host.hooks.intercept({
+  call: ({ hook, style, args }) => {}, // before any handler runs
+  handler: ({ hook, plugin, ms, error }) => {
+    // after each handler
+    if (ms > 50) log.warn(`${plugin} took ${ms.toFixed(0)}ms in ${hook}`);
+  },
+});
+```
+
+- `plugin` is `undefined` for your app's own handlers, and `error` is set when the handler threw or returned an
+  invalid value (even when `hookErrors` then skipped it).
+- `ms` covers the handler and its result check, not what `hookErrors` does afterwards.
+- Interceptors are your code: if one throws, the hook call rejects.
+
+## Checking data at runtime (Standard Schema)
+
+TypeScript types disappear at runtime, and plugin code from npm is JavaScript you don't control. The SDK accepts
+any [Standard Schema](https://standardschema.dev) (zod, valibot, ArkType…) at the two places where data crosses
+from a plugin into your app:
+
+```ts
+import { z } from "zod";
+
+// 1. Plugin options: checked before setup(); ctx.options is the parsed value, typed from the schema.
+const server = definePlugin({
+  name: "server",
+  optionsSchema: z.object({ port: z.number().int(), host: z.string().default("localhost") }),
+  setup(ctx) {
+    ctx.options.port; // number
+  },
+});
+host.register(server, { port: 8080 }); // typed as the schema's input: `host` is optional
+
+// 2. Hook results: every value a plugin returns from waterfall/bail is checked.
+const host = new PluginHost<AppHooks>({
+  app,
+  hookSchemas: { render: z.string().max(10_000) },
+});
+```
+
+- **Invalid options** mark the plugin `failed` with a reason like `invalid options: port: Invalid input…`, and
+  its dependents are disabled. Options passed to `host.load()` are checked the same way.
+- **An invalid hook result** counts as a hook error from the plugin that returned it, handled by `hookErrors`.
+  If the schema transforms the value, the next handler (and your app) gets the transformed value.
+- Hooks without a schema, and `call`/`parallel` (whose results are ignored), aren't checked.
+- To give third-party plugin authors your types, publish the schemas in a small package (e.g. `my-app-plugin-api`):
+  authors get types through `z.infer`, and the same schemas run at runtime.
+
+## Hook errors at runtime
+
+After startup, a plugin's hook handler can still throw, or return a value its hook schema rejects. The
+`hookErrors` host option decides what happens:
+
+| `hookErrors`      | The failing handler | The plugin                                                    | The hook call                                  |
+| ----------------- | ------------------- | ------------------------------------------------------------- | ---------------------------------------------- |
+| `"log"` (default) | logged and skipped  | keeps running                                                 | continues with the other handlers              |
+| `"disable"`       | logged and skipped  | stopped as `failed`, and its started dependents as `disabled` | continues                                      |
+| `"throw"`         | —                   | keeps running                                                 | rejects with a `PluginError` naming the plugin |
+
+- When a handler is skipped, `waterfall` keeps the value from before it, and `bail` moves on to the next handler.
+- `"disable"` stops plugins the same way `host.stop()` does: signal aborted, `stop()`, disposers, hooks and
+  services removed. Dependents through `optionalDependsOn` keep running.
+- In a nested hook call, the plugin whose handler actually failed is the one blamed.
+- Errors from your app's own handlers (`host.hooks.on(...)`) always propagate: that's your code, not a plugin's.
+
+## Publishing a plugin package
+
+```json
+{
+  "name": "my-app-plugin-auth",
+  "type": "module",
+  "keywords": ["my-app-plugin"],
+  "peerDependencies": { "my-app": "^2.0.0" },
+  "my-app": { "apiVersion": 1, "entry": "./dist/index.js" }
+}
+```
+
+- **Ship JavaScript.** Node won't strip types inside `node_modules`.
+- **`apiVersion` is the compatibility check.** It must equal the host's `apiVersion`; bump it in the host when the plugin API breaks. `peerDependencies` ranges aren't checked.
+- **Put the host in `peerDependencies`, not `dependencies`,** so the plugin doesn't install its own copy. The SDK checks plugins by shape rather than with `instanceof`, so a second copy isn't fatal, but it's wasteful.
+- **`entry` is required.** It's the file the loader imports, relative to the package root.
+- The loader looks for packages in `node_modules` in `cwd` and then in each parent directory. Relative paths (`"./plugins/foo"`) also work.
+- Install scripts: npm runs `postinstall`; Bun doesn't unless the package is listed in `trustedDependencies`. Users install plugins at their own risk.
+
+## Development
+
+Tooling follows the `node-bun-base` template: Vite+ (`vp`) for format, lint and tests, TypeScript 7, and mise for
+tool versions. The tests import `@/…`, which maps to `src/`; the SDK itself only uses relative imports, so `src/`
+stays copyable.
+
+```sh
+mise install          # Node 24 + Bun
+bun run check         # vp fmt --check, vp lint (type-aware), tsc
+bun run check:fix     # same, applying fixes
+bun run test          # vp test (Vitest on Node)
+bun run test:bun      # the same tests on Bun
+bun run example       # examples/basic on Bun and Node
+```
+
+CI (`.github/workflows/ci.yml`) runs the same steps on every push to `main` and on pull requests, with the
+Node and Bun versions from `mise.toml`.
+
+## License
+
+MIT © 2026 Cesar Flores

package/dist/hooks.d.ts

@@ -0,0 +1,76 @@
+import { PluginError, type StandardSchemaV1 } from "./types.ts";
+export type HookFn = (...args: any[]) => unknown;
+export type HookName<H> = keyof H & string;
+type Fn<H, K extends keyof H> = H[K] extends HookFn ? H[K] : never;
+type Args<H, K extends keyof H> = H[K] extends (...args: infer A) => any ? A : never[];
+type Result<H, K extends keyof H> = H[K] extends (...args: any[]) => infer R ? Awaited<R> : never;
+/** Per hook, a schema for the values handlers return (checked by `waterfall` and `bail`). */
+export type HookSchemas<H> = {
+    [K in HookName<H>]?: StandardSchemaV1<unknown, Exclude<Result<H, K>, undefined | void>>;
+};
+/** "pre" handlers run first, then "normal" (the default), then "post"; registration order within each. */
+export type HookOrder = "pre" | "normal" | "post";
+export interface HookOptions {
+    order?: HookOrder;
+}
+export type HookStyle = "call" | "parallel" | "waterfall" | "bail";
+/** Observes every hook call on the host's bus: for tracing, metrics, finding slow plugins. */
+export interface HookInterceptor {
+    /** A hook was called, before any handler runs. */
+    call?(event: {
+        hook: string;
+        style: HookStyle;
+        args: readonly unknown[];
+    }): void;
+    /**
+     * One handler finished. `plugin` is undefined for the app's own handlers; `ms` excludes
+     * error handling; `error` is the PluginError if it threw or returned an invalid value.
+     */
+    handler?(event: {
+        hook: string;
+        plugin: string | undefined;
+        ms: number;
+        error?: unknown;
+    }): void;
+}
+export interface Hooks<H extends object> {
+    /** Returns a function that removes the handler. */
+    on<K extends HookName<H>>(name: K, fn: Fn<H, K>, options?: HookOptions): () => void;
+    /** Runs handlers one after another, in order. */
+    call<K extends HookName<H>>(name: K, ...args: Args<H, K>): Promise<void>;
+    /** Runs all handlers concurrently. */
+    parallel<K extends HookName<H>>(name: K, ...args: Args<H, K>): Promise<void>;
+    /**
+     * Each handler receives the previous one's result as its first argument; returning undefined keeps the value.
+     * Results are checked against the hook's schema, if it has one.
+     */
+    waterfall<K extends HookName<H>>(name: K, ...args: Args<H, K>): Promise<Args<H, K>[0]>;
+    /** Returns the first result that is not undefined, skipping the remaining handlers. Checked like `waterfall`. */
+    bail<K extends HookName<H>>(name: K, ...args: Args<H, K>): Promise<Exclude<Result<H, K>, undefined | void> | undefined>;
+    count(name: HookName<H>): number;
+}
+/**
+ * Called when a plugin's handler throws or returns an invalid value. Rethrow to make the hook
+ * call reject; return to skip that handler and continue. App handlers (no owner) always rethrow.
+ */
+export type HookErrorHandler = (error: PluginError) => void | Promise<void>;
+export declare class HookBus<H extends object = any> implements Hooks<H> {
+    #private;
+    constructor(schemas?: HookSchemas<H>, onError?: HookErrorHandler);
+    on<K extends HookName<H>>(name: K, fn: Fn<H, K>, options?: HookOptions): () => void;
+    /**
+     * Adds an observer of every hook call; returns a function that removes it. Host-only: the
+     * scoped view plugins get has no `intercept`. Errors thrown by an interceptor propagate.
+     */
+    intercept(interceptor: HookInterceptor): () => void;
+    /** A view whose `on` tags handlers with `owner`, so `removeOwner` can drop them all. */
+    scope(owner: string): Hooks<H>;
+    removeOwner(owner: string): void;
+    count(name: HookName<H>): number;
+    call<K extends HookName<H>>(name: K, ...args: Args<H, K>): Promise<void>;
+    parallel<K extends HookName<H>>(name: K, ...args: Args<H, K>): Promise<void>;
+    waterfall<K extends HookName<H>>(name: K, ...args: Args<H, K>): Promise<Args<H, K>[0]>;
+    bail<K extends HookName<H>>(name: K, ...args: Args<H, K>): Promise<Exclude<Result<H, K>, undefined | void> | undefined>;
+}
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;AACjD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC;AAC3C,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AACnE,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC;AACvF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAElG,6FAA6F;AAC7F,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;CACxF,CAAC;AAEF,0GAA0G;AAC1G,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAEnE,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,IAAI,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACjF;;;OAGG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAClG;AAED,MAAM,WAAW,KAAK,CAAC,CAAC,SAAS,MAAM;IACrC,mDAAmD;IACnD,EAAE,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,IAAI,CAAC;IACpF,iDAAiD;IACjD,IAAI,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,sCAAsC;IACtC,QAAQ,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E;;;OAGG;IACH,SAAS,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,iHAAiH;IACjH,IAAI,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EACxB,IAAI,EAAE,CAAC,EACP,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAClB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;CAClC;AAUD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5E,qBAAa,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;;IAM9D,YAAY,OAAO,GAAE,WAAW,CAAC,CAAC,CAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,EAGnE;IAED,EAAE,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,IAAI,CAElF;IAED;;;OAGG;IACH,SAAS,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,IAAI,CAMlD;IAED,wFAAwF;IACxF,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAS7B;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAO/B;IAED,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAE/B;IAEK,IAAI,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7E;IAEK,QAAQ,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjF;IAEK,SAAS,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAW3F;IAEK,IAAI,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAC9B,IAAI,EAAE,CAAC,EACP,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAClB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC,CAS9D;CAgGF"}

package/dist/hooks.js

@@ -0,0 +1,155 @@
+import { parseWith, PluginError } from "./types.js";
+const RANKS = { pre: 0, normal: 1, post: 2 };
+export class HookBus {
+    #handlers = new Map();
+    #schemas;
+    #onError;
+    #interceptors = [];
+    constructor(schemas = {}, onError) {
+        this.#schemas = schemas;
+        this.#onError = onError;
+    }
+    on(name, fn, options) {
+        return this.#on(name, fn, undefined, options);
+    }
+    /**
+     * Adds an observer of every hook call; returns a function that removes it. Host-only: the
+     * scoped view plugins get has no `intercept`. Errors thrown by an interceptor propagate.
+     */
+    intercept(interceptor) {
+        this.#interceptors = [...this.#interceptors, interceptor];
+        return () => {
+            this.#interceptors = this.#interceptors.filter((i) => i !== interceptor);
+        };
+    }
+    /** A view whose `on` tags handlers with `owner`, so `removeOwner` can drop them all. */
+    scope(owner) {
+        return {
+            on: (name, fn, options) => this.#on(name, fn, owner, options),
+            call: (name, ...args) => this.call(name, ...args),
+            parallel: (name, ...args) => this.parallel(name, ...args),
+            waterfall: (name, ...args) => this.waterfall(name, ...args),
+            bail: (name, ...args) => this.bail(name, ...args),
+            count: (name) => this.count(name),
+        };
+    }
+    removeOwner(owner) {
+        for (const [name, list] of this.#handlers) {
+            this.#handlers.set(name, list.filter((h) => h.owner !== owner));
+        }
+    }
+    count(name) {
+        return this.#handlers.get(name)?.length ?? 0;
+    }
+    async call(name, ...args) {
+        this.#notifyCall(name, "call", args);
+        for (const h of this.#snapshot(name))
+            await this.#handle(h, name, args, false);
+    }
+    async parallel(name, ...args) {
+        this.#notifyCall(name, "parallel", args);
+        await Promise.all(this.#snapshot(name).map((h) => this.#handle(h, name, args, false)));
+    }
+    async waterfall(name, ...args) {
+        this.#notifyCall(name, "waterfall", args);
+        let [value, ...rest] = args;
+        for (const h of this.#snapshot(name)) {
+            const next = await this.#handle(h, name, [value, ...rest], true);
+            if (next?.value !== undefined)
+                value = next.value;
+        }
+        return value;
+    }
+    async bail(name, ...args) {
+        this.#notifyCall(name, "bail", args);
+        for (const h of this.#snapshot(name)) {
+            const result = await this.#handle(h, name, args, true);
+            if (result?.value !== undefined)
+                return result.value;
+        }
+        return undefined;
+    }
+    #on(name, fn, owner, options = {}) {
+        if (typeof fn !== "function")
+            throw new TypeError(`Hook handler for "${name}" must be a function`);
+        const rank = RANKS[options.order ?? "normal"];
+        if (rank === undefined)
+            throw new TypeError(`Hook order must be "pre", "normal" or "post", got "${options.order}"`);
+        // Insert after the last handler of the same or an earlier bucket.
+        const handler = { fn, owner, rank };
+        const list = this.#handlers.get(name) ?? [];
+        const at = list.findIndex((h) => h.rank > rank);
+        this.#handlers.set(name, at === -1 ? [...list, handler] : [...list.slice(0, at), handler, ...list.slice(at)]);
+        return () => {
+            const list = this.#handlers.get(name);
+            if (list)
+                this.#handlers.set(name, list.filter((h) => h !== handler));
+        };
+    }
+    // Lists are replaced, never mutated, so handlers added mid-emit don't run in that emit.
+    // Handlers removed mid-emit (e.g. their plugin was disabled) are skipped by #handle.
+    #snapshot(name) {
+        return this.#handlers.get(name) ?? [];
+    }
+    /** Runs one handler (and checks its result); `undefined` means it was skipped or its error was handled. */
+    async #handle(h, name, args, checked) {
+        if (!this.#handlers.get(name)?.includes(h))
+            return undefined;
+        const startedAt = performance.now();
+        let result;
+        try {
+            const value = await this.#invoke(h, name, args);
+            result = { value: checked && value !== undefined ? await this.#check(h, name, value) : value };
+        }
+        catch (error) {
+            this.#notifyHandler(name, h, startedAt, error);
+            if (!this.#onError || h.owner === undefined || !(error instanceof PluginError))
+                throw error;
+            await this.#onError(error);
+            return undefined;
+        }
+        this.#notifyHandler(name, h, startedAt);
+        return result;
+    }
+    #notifyCall(hook, style, args) {
+        for (const interceptor of this.#interceptors)
+            interceptor.call?.({ hook, style, args });
+    }
+    #notifyHandler(hook, h, startedAt, error) {
+        if (this.#interceptors.length === 0)
+            return;
+        const event = {
+            hook,
+            plugin: h.owner,
+            ms: performance.now() - startedAt,
+            ...(error === undefined ? {} : { error }),
+        };
+        for (const interceptor of this.#interceptors)
+            interceptor.handler?.(event);
+    }
+    async #invoke(h, name, args) {
+        try {
+            return await h.fn(...args);
+        }
+        catch (cause) {
+            if (cause instanceof PluginError && cause.phase === "hook")
+                throw cause;
+            throw new PluginError(h.owner ?? "<host>", "hook", `handler for "${name}" threw`, { cause });
+        }
+    }
+    async #check(h, name, value) {
+        const schema = this.#schemas[name];
+        if (!schema)
+            return value;
+        try {
+            return await parseWith(schema, value);
+        }
+        catch (cause) {
+            const detail = cause instanceof Error ? cause.message : String(cause);
+            throw new PluginError(h.owner ?? "<host>", "hook", `handler for "${name}" returned an invalid value: ${detail}`, {
+                cause,
+            });
+        }
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+import { HookBus } from "./hooks.ts";
+import { type AppInfo, type HostOptions, type HostPhase, type Plugin, type PluginInfo, type PluginSpec, type StateListener } from "./types.ts";
+export * from "./types.ts";
+export { HookBus, type HookErrorHandler, type HookFn, type HookInterceptor, type HookName, type HookOptions, type HookOrder, type Hooks, type HookSchemas, type HookStyle, } from "./hooks.ts";
+/** Identity helper for type inference. Untyped hooks/services; see `definePluginFor` for app-typed plugins. */
+export declare function definePlugin<Options = void, Input = Options>(plugin: Plugin<Options, any, any, Input>): Plugin<Options, any, any, Input>;
+/**
+ * Returns a `definePlugin` bound to your app's hook and service maps:
+ *   export const definePlugin = definePluginFor<MyHooks, MyServices>();
+ */
+export declare function definePluginFor<H extends object, S extends object = {}>(): <Options = void, Input = Options>(plugin: Plugin<Options, H, S, Input>) => Plugin<Options, H, S, Input>;
+/**
+ * The host is single-use: once stopped it can't be started again. To reload plugins,
+ * create a new host (or restart the process; ES modules can't be unloaded).
+ */
+export declare class PluginHost<H extends object = any, S extends object = any> {
+    #private;
+    readonly app: AppInfo;
+    /** Host-owned view of the hook bus: emit hooks from your app through this. */
+    readonly hooks: HookBus<H>;
+    constructor(options: HostOptions<H>);
+    get phase(): HostPhase;
+    /** Adds a plugin object directly (local plugins, or ones you imported yourself). */
+    register<O, I = O>(plugin: Plugin<O, H, S, I>, options?: I): this;
+    /**
+     * Loads installed plugin packages, resolving from `cwd`'s node_modules upwards.
+     * Imports run in parallel; plugins are registered in the order given.
+     * Under "isolate", a package that fails to load is listed as failed and skipped.
+     */
+    load(specs: readonly PluginSpec[], { cwd }?: {
+        cwd?: string;
+    }): Promise<this>;
+    /** Sets up every plugin, then starts every plugin, both in dependency order. */
+    start(): Promise<void>;
+    /** Stops started plugins in reverse order and tears everything down. Safe to call repeatedly or mid-start. */
+    stop(): Promise<void>;
+    /** Services provided by the host are usable by every plugin without declaring a dependency. */
+    provide<K extends keyof S & string>(key: K, value: S[K]): void;
+    service<K extends keyof S & string>(key: K): S[K] | undefined;
+    list(): PluginInfo[];
+    get(name: string): PluginInfo | undefined;
+    onStateChange(listener: StateListener): () => void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EACL,KAAK,OAAO,EAGZ,KAAK,WAAW,EAEhB,KAAK,SAAS,EAId,KAAK,MAAM,EAGX,KAAK,UAAU,EACf,KAAK,UAAU,EAEf,KAAK,aAAa,EAEnB,MAAM,YAAY,CAAC;AAEpB,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,OAAO,EACP,KAAK,gBAAgB,EACrB,KAAK,MAAM,EACX,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AAEpB,+GAA+G;AAC/G,wBAAgB,YAAY,CAAC,OAAO,GAAG,IAAI,EAAE,KAAK,GAAG,OAAO,EAC1D,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GACvC,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAElC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,EAAE,MAC7D,OAAO,GAAG,IAAI,EAAE,KAAK,GAAG,OAAO,UAAU,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAG,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAE7G;AAiBD;;;GAGG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,MAAM,GAAG,GAAG;;IACpE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAkB3B,YAAY,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EASlC;IAED,IAAI,KAAK,IAAI,SAAS,CAErB;IAED,oFAAoF;IACpF,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,CAIhE;IAED;;;;OAIG;IACG,IAAI,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,EAAE,GAAmB,EAAE,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCtG;IAED,gFAAgF;IAChF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAOrB;IAED,8GAA8G;IAC9G,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAOpB;IAED,+FAA+F;IAC/F,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAE7D;IAED,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAE5D;IAED,IAAI,IAAI,UAAU,EAAE,CAEnB;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAIxC;IAED,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI,CAIjD;CAmSF"}