@earendil-works/chord 1.4.0 → 1.5.1

package/dist/node/plugins/plugins.js

@@ -0,0 +1,244 @@
+// The plugins component (slice 7c §4, §5; decision "Slice 7c's points"; slice 10 D11, D12; slice 12 §1, §5): discovery,
+// builds checked against the app's API, installs and the watcher, and per kind the complete current set of scripts
+// (built on first use, updated by every rollout that ships the kind), which its plugin runtime loads and reloads hosts
+// with: unchanged plugins as the same facet objects, removed ones left out, a failed build or evaluation keeping the
+// plugin's loaded facet. `rollout` runs the app's steps in order (one result per host) and clears the marks of plugins
+// applied on every host of every step.
+import { Batch } from "../../state/internal.js";
+import { buildFacet } from "./build.js";
+import { discoverPlugins, sameFiles } from "./discover.js";
+import { installDependencies, installPlugin } from "./install.js";
+import { createPluginRuntime, PluginError } from "./runtime.js";
+import { PluginWatcher } from "./watcher.js";
+/** Creates the plugins component (and its plugin runtime) and starts the watcher. Discovery runs at first use. */
+export function createPlugins(options, _context) {
+    return new PluginsComponent(options);
+}
+class PluginsComponent {
+    #options;
+    #watcher;
+    #runtime;
+    #discovery = { plugins: [], problems: [] };
+    #discovered = false;
+    /** The latest build of every (plugin, kind) built so far, by `plugin\u0000kind`. */
+    #built = new Map();
+    /** The current set of each kind used so far, by plugin name. */
+    #current = new Map();
+    /** The kind each loaded host was loaded with, held as long as the host is. */
+    #kinds = new WeakMap();
+    /** The marks each build started from, held as long as its result is (a rollout given a copy clears none). */
+    #snapshots = new WeakMap();
+    constructor(options) {
+        this.#options = options;
+        this.#runtime = createPluginRuntime();
+        const batch = new Batch((error) => options.onError(error), undefined);
+        this.#watcher = new PluginWatcher({
+            roots: options.roots.map((root) => (typeof root === "string" ? root : root.path)),
+            base: options.base ?? [],
+            kinds: Object.keys(options.kinds),
+            failed: (error) => options.onError({ kind: "watch_failed", error }),
+        }, batch);
+    }
+    get state() {
+        // Its value is a `PluginsState`.
+        return this.#watcher;
+    }
+    get discovery() {
+        return this.#discovery;
+    }
+    async build(names, context) {
+        const before = new Map(this.#discovery.plugins.map((plugin) => [plugin.name, plugin]));
+        if (!this.#discovered || this.#watcher.needsDiscovery)
+            await this.#discover(context);
+        const now = this.#discovery.plugins;
+        const removed = [...before.keys()].filter((name) => !now.some((plugin) => plugin.name === name));
+        // A plugin whose files moved (a single file became a directory, a facet file came or went) is built again too.
+        const wanted = now.filter((plugin) => {
+            const previous = before.get(plugin.name);
+            return names.includes(plugin.name) || previous === undefined || !sameFiles(previous, plugin);
+        });
+        const snapshot = this.#watcher.snapshot([...wanted.map(({ name }) => name), ...removed]);
+        const facets = await Promise.all(wanted.flatMap((plugin) => Object.keys(plugin.facets).map((kind) => this.#buildOne(plugin, kind, context))));
+        const plugins = Object.fromEntries(wanted.map((plugin) => [plugin.name, plugin]));
+        const built = { facets, plugins, removed };
+        this.#snapshots.set(built, snapshot);
+        return built;
+    }
+    async scripts(kind, context) {
+        return [...(await this.#set(kind, context)).values()];
+    }
+    current(kind) {
+        const set = this.#current.get(kind);
+        return set === undefined ? undefined : [...set.values()];
+    }
+    async load(host, options, context) {
+        const { kind, core, modules } = options;
+        const scripts = await this.scripts(kind, context);
+        this.#kinds.set(host, kind);
+        // A required root guarantees its plugins: what discovery reported in one is as fatal as a plugin that failed.
+        const problems = this.#discovery.problems.filter(({ required }) => required);
+        let report;
+        try {
+            report = await this.#runtime.load(host, { kind, core, scripts, modules }, context);
+        }
+        catch (error) {
+            if (!(error instanceof PluginError) || problems.length === 0)
+                throw error;
+            throw new PluginError(error.required, error.failed, problems);
+        }
+        if (problems.length > 0)
+            throw new PluginError([], report.failed, problems);
+        return report;
+    }
+    async reload(host, built, context) {
+        const kind = this.#kinds.get(host);
+        if (kind === undefined)
+            throw new Error("plugins.reload: the host was not loaded by this component");
+        const set = await this.#set(kind, context);
+        // Applied and read in one step: two reloads started together each pass the set their own build made.
+        ship(set, kind, built);
+        return this.#runtime.reload(host, [...set.values()], context);
+    }
+    step(name, host) {
+        const kind = this.#kinds.get(host);
+        if (kind === undefined)
+            throw new Error("plugins.step: the host was not loaded by this component");
+        return {
+            name,
+            kinds: [kind],
+            reload: async (built, context) => ({
+                hosts: [{ host: name, report: await this.reload(host, built, context) }],
+            }),
+        };
+    }
+    async rollout(steps, built, context) {
+        const done = [];
+        const failed = new Set();
+        const shipped = new Set();
+        for (const step of steps) {
+            let hosts;
+            try {
+                for (const kind of step.kinds)
+                    ship(await this.#set(kind, context), kind, built);
+                hosts = (await step.reload(built, context)).hosts;
+            }
+            catch (error) {
+                return { steps: done, stopped: { step: step.name, error } };
+            }
+            for (const kind of step.kinds)
+                shipped.add(kind);
+            for (const entry of hosts) {
+                if ("report" in entry)
+                    for (const { plugin } of entry.report.failed)
+                        failed.add(plugin);
+                else if ("error" in entry)
+                    for (const plugin of builtOf(built, step.kinds))
+                        failed.add(plugin);
+            }
+            done.push({ name: step.name, hosts });
+        }
+        // A plugin with a built kind no step shipped is not applied everywhere it runs: it stays dirty.
+        for (const { plugin, facet } of built.facets)
+            if (!shipped.has(facet))
+                failed.add(plugin);
+        const snapshot = this.#snapshots.get(built);
+        if (snapshot !== undefined) {
+            this.#watcher.applied([...snapshot.plugins.keys()].filter((name) => !failed.has(name)), snapshot);
+        }
+        return { steps: done, stopped: undefined };
+    }
+    watchBase(inputs) {
+        return this.#watcher.recordBase(inputs);
+    }
+    async installDependencies(name, context) {
+        if (!this.#discovered)
+            await this.#discover(context);
+        const plugin = this.#discovery.plugins.find((each) => each.name === name);
+        if (plugin === undefined)
+            throw new Error(`plugins.installDependencies: no plugin "${name}"`);
+        await installDependencies(plugin, context, this.#options.install);
+        this.#watcher.installed(name);
+    }
+    async installPlugin(source, root, context) {
+        const roots = this.#options.roots.map((each) => (typeof each === "string" ? each : each.path));
+        if (!roots.includes(root))
+            throw new Error(`plugins.installPlugin: ${root} is not one of the roots`);
+        const options = { ...this.#options.install, kinds: Object.keys(this.#options.kinds), roots: this.#options.roots };
+        const names = await installPlugin(source, root, context, options);
+        this.#watcher.added();
+        return names;
+    }
+    close() {
+        this.#watcher.close();
+    }
+    /** Discovers the plugins again; the changes of the plugin set and of `package.json`s seen until now clear. */
+    async #discover(context) {
+        const seen = this.#watcher.discoverySnapshot();
+        this.#discovery = await discoverPlugins(this.#options.roots, { kinds: Object.keys(this.#options.kinds) }, context);
+        this.#discovered = true;
+        // A plugin no longer discovered loses its builds: a name added again is built anew, never served an old build.
+        for (const key of this.#built.keys()) {
+            const name = key.slice(0, key.indexOf("\u0000"));
+            if (!this.#discovery.plugins.some((plugin) => plugin.name === name))
+                this.#built.delete(key);
+        }
+        this.#watcher.know(this.#discovery, seen);
+    }
+    /** `kind`'s current set, made at its first use from every discovered plugin's facet of it (built if needed). */
+    async #set(kind, context) {
+        let set = this.#current.get(kind);
+        if (set !== undefined)
+            return set;
+        if (!this.#discovered)
+            await this.#discover(context);
+        const plugins = this.#discovery.plugins.filter((plugin) => plugin.facets[kind] !== undefined);
+        const scripts = await Promise.all(plugins.map(async (plugin) => {
+            const built = this.#built.get(`${plugin.name}\u0000${kind}`) ?? (await this.#buildOne(plugin, kind, context));
+            return { plugin, built };
+        }));
+        // Built concurrently: a set made meanwhile (by a concurrent first use) wins.
+        set = this.#current.get(kind) ?? new Map(scripts.map((script) => [script.plugin.name, script]));
+        this.#current.set(kind, set);
+        return set;
+    }
+    /** Builds `plugin`'s facet of `kind` and keeps it as the latest; the watcher learns what it read. */
+    async #buildOne(plugin, kind, context) {
+        const { kinds, publicPath, api } = this.#options;
+        // Discovery finds facet files of the app's kinds only.
+        const { platform, hostPackages } = kinds[kind];
+        const options = {
+            hostPackages,
+            platform,
+            kinds: Object.keys(kinds),
+            plugins: this.#discovery.plugins,
+            ...(api === undefined ? {} : { api }),
+            ...(publicPath === undefined ? {} : { publicPath }),
+        };
+        const built = await buildFacet(plugin, kind, options, context);
+        this.#built.set(`${plugin.name}\u0000${kind}`, built);
+        this.#watcher.used([built]);
+        return built;
+    }
+}
+/**
+ * Applies `built` to `set`, `kind`'s current set: its removed plugins and those rebuilt without a facet of `kind` leave
+ * it, its facets of `kind` replace theirs.
+ */
+function ship(set, kind, built) {
+    for (const name of built.removed)
+        set.delete(name);
+    for (const [name, plugin] of Object.entries(built.plugins))
+        if (plugin.facets[kind] === undefined)
+            set.delete(name);
+    for (const facet of built.facets) {
+        // Own properties only: a plugin may be named like one of `Object.prototype`'s (`constructor`).
+        if (facet.facet === kind && Object.hasOwn(built.plugins, facet.plugin)) {
+            set.set(facet.plugin, { plugin: built.plugins[facet.plugin], built: facet });
+        }
+    }
+}
+/** The plugins of `built` with a facet of one of `kinds`. */
+function builtOf(built, kinds) {
+    return built.facets.filter(({ facet }) => kinds.includes(facet)).map(({ plugin }) => plugin);
+}
+//# sourceMappingURL=plugins.js.map

package/dist/node/plugins/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../../src/node/plugins/plugins.ts"],"names":[],"mappings":"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","sourcesContent":["// The plugins component (slice 7c §4, §5; decision \"Slice 7c's points\"; slice 10 D11, D12; slice 12 §1, §5): discovery,\n// builds checked against the app's API, installs and the watcher, and per kind the complete current set of scripts\n// (built on first use, updated by every rollout that ships the kind), which its plugin runtime loads and reloads hosts\n// with: unchanged plugins as the same facet objects, removed ones left out, a failed build or evaluation keeping the\n// plugin's loaded facet. `rollout` runs the app's steps in order (one result per host) and clears the marks of plugins\n// applied on every host of every step.\n\nimport type { Context } from \"../../context/index.ts\";\nimport type { Principal } from \"../../data/index.ts\";\nimport type { Host, LoadReport, PluginFacet, ReloadReport } from \"../../host/index.ts\";\nimport { Batch, type BatchError } from \"../../state/internal.ts\";\nimport type { Watchable } from \"../../watch.ts\";\nimport type { BaseInputs } from \"./base-inputs.ts\";\nimport { type AppApi, type BuiltFacet, buildFacet } from \"./build.ts\";\nimport { type Discovery, discoverPlugins, type Plugin, type PluginRoot, sameFiles } from \"./discover.ts\";\nimport type { HostPackages } from \"./evaluate.ts\";\nimport { type InstallOptions, installDependencies, installPlugin, type PluginSource } from \"./install.ts\";\nimport { createPluginRuntime, PluginError, type PluginRuntime, type PluginScript } from \"./runtime.ts\";\nimport { type MarkSnapshot, type PluginsState, PluginWatcher } from \"./watcher.ts\";\n\n/** What `createPlugins` takes. */\nexport type PluginsOptions = {\n\t/**\n\t * The directories plugins are listed in, in order: the first root's plugin wins a duplicate name. A root marked\n\t * `required` (`{ path, required: true }`, the app's own) makes `load` reject when one of its plugins fails.\n\t */\n\treadonly roots: readonly PluginRoot[];\n\t/**\n\t * The app's API (`{ name: \"@acme/app\", versions: [\"v3\", \"v2\"] }`, newest first): plugins import it at a listed\n\t * version, its per-kind modules from their kind only, one version per facet, and never Chord directly. Without one,\n\t * plugins import the host packages as listed.\n\t */\n\treadonly api?: AppApi;\n\t/**\n\t * The app's facet kinds (one file per kind in a plugin), each with where its builds run and the host packages they\n\t * keep external: `{ server: { platform: \"node\", hostPackages: [\"@earendil-works/chord\", \"@app/core\"] }, … }`.\n\t */\n\treadonly kinds: Readonly<Record<string, KindDefinition>>;\n\t/**\n\t * The server's own base code, files and directories, hashed when the component is created: `base` is set while one\n\t * differs from it or a source file is new in one of the directories (the app restarts its hosts; Chord restarts\n\t * nothing).\n\t */\n\treadonly base?: readonly string[];\n\t/** Where the app serves browser builds' assets: the URL prefix their imports evaluate to. */\n\treadonly publicPath?: string;\n\t/** How `installDependencies` runs npm. */\n\treadonly install?: InstallOptions;\n\t/** The watcher cannot watch (reported once), and the marks' watch listeners that threw. */\n\treadonly onError: (error: PluginsError) => void;\n};\n\n/** One facet kind: Node or browser builds, and the host packages (by specifier) its builds keep external. */\nexport type KindDefinition = { readonly platform: \"node\" | \"browser\"; readonly hostPackages: readonly string[] };\n\n/** What the component reports. */\nexport type PluginsError = BatchError | { readonly kind: \"watch_failed\"; readonly error: unknown };\n\n/**\n * A build of some plugins, plain data (a clone of it reloads the same): every facet of each, the plugins as its\n * discovery saw them by name (what a reload evaluates with), and the plugins no longer discovered.\n */\nexport type Built = {\n\treadonly facets: readonly BuiltFacet[];\n\treadonly plugins: Readonly<Record<string, Plugin>>;\n\treadonly removed: readonly string[];\n};\n\n/**\n * What a rollout step did on one of its hosts (`host` named by the step): its reload's report; `stopped` when the host\n * stopped cleanly during the step (it gets the current set at its next start); `error` when it crashed or its reload\n * failed (every plugin of the step's kinds in the build counts as failed there).\n */\nexport type RolloutHost =\n\t| { readonly host: string; readonly report: ReloadReport }\n\t| { readonly host: string; readonly stopped: true }\n\t| { readonly host: string; readonly error: unknown };\n\n/** What a rollout step does: reloads its hosts with the facets of its kinds, one result per host (D12). */\nexport type RolloutStep = {\n\treadonly name: string;\n\treadonly kinds: readonly string[];\n\treload(built: Built, context: Context): Promise<{ readonly hosts: readonly RolloutHost[] }>;\n};\n\n/** What a rollout did: each step's hosts in order, and the step it stopped at (rejected), if it stopped. */\nexport type RolloutResult = {\n\treadonly steps: readonly { readonly name: string; readonly hosts: readonly RolloutHost[] }[];\n\treadonly stopped: { readonly step: string; readonly error: unknown } | undefined;\n};\n\n/** The plugins component. */\nexport interface Plugins {\n\t/** The marks: `{ dirty, install, set, base }`, a JSON watchable. */\n\treadonly state: Watchable<PluginsState>;\n\t/** The plugins of the last discovery. */\n\treadonly discovery: Discovery;\n\t/**\n\t * Builds every facet of `names` (and of plugins discovered since the last build; discovery runs again first when\n\t * the plugin set changed): plain data. It changes no current set: a rollout ships it.\n\t */\n\tbuild(names: readonly string[], context: Context): Promise<Built>;\n\t/**\n\t * The complete current set of `kind`: every discovered plugin's facet of it (built on first use), as the last\n\t * rollout or reload shipping `kind` left it; what a worker starts with.\n\t */\n\tscripts(kind: string, context: Context): Promise<readonly PluginScript[]>;\n\t/**\n\t * `kind`'s current set now, synchronously (`undefined` before its first use): a rollout step reads it as the rollout\n\t * applied its build, before another rollout can change it.\n\t */\n\tcurrent(kind: string): readonly PluginScript[] | undefined;\n\t/**\n\t * Loads `host` with `kind`'s current set, evaluated with `modules` (the host packages, this process's instances, by\n\t * specifier; kept for the host's reloads), and `core` (the app's own facets): a plugin whose build or evaluation\n\t * fails is left out and reported with the host's report. A required root's plugin failing, and a problem discovery\n\t * reported in a required root (missing, an invalid package, a name another root has), reject the load with a\n\t * `PluginError` once the host's load settled.\n\t */\n\tload<P extends Principal>(\n\t\thost: Host<P>,\n\t\toptions: { readonly kind: string; readonly core: readonly PluginFacet<P>[]; readonly modules: HostPackages },\n\t\tcontext: Context,\n\t): Promise<LoadReport>;\n\t/**\n\t * Applies `built` to the current set of `host`'s kind (loaded by `load`) and reloads `host` with that complete set,\n\t * after its earlier reloads (`PluginRuntime.reload`). The host's report.\n\t */\n\treload<P extends Principal>(host: Host<P>, built: Built, context: Context): Promise<ReloadReport>;\n\t/** An in-process rollout step named `name`: `reload(host, built)`, one host named `name`. */\n\tstep<P extends Principal>(name: string, host: Host<P>): RolloutStep;\n\t/**\n\t * Runs `steps` in order with `built`, applying it to the current set of each step's kinds right before that step,\n\t * and stops at one that rejects; failed plugins and hosts do not stop it. Clears the dirty marks of the built\n\t * plugins applied on every host of every step (not failed on any, every built kind of theirs shipped by a step)\n\t * that did not change since the build.\n\t */\n\trollout(steps: readonly RolloutStep[], built: Built, context: Context): Promise<RolloutResult>;\n\t/** Installs plugin `name`'s dependencies (`installDependencies`): its install mark clears, and it is dirty. */\n\tinstallDependencies(name: string, context: Context): Promise<void>;\n\t/**\n\t * Adds a running base artifact's record (a base bundle's `inputs`, beside `base`): `base` is set while one of its\n\t * files differs from the bytes it read or is gone; each is compared once now (settles once those comparisons did).\n\t * Files under `node_modules` are never watched.\n\t */\n\twatchBase(inputs: BaseInputs): Promise<void>;\n\t/**\n\t * Installs new plugins from git or npm into `root`, one of the roots (`installPlugin`), and marks `set`: the next\n\t * build discovers and builds them. Returns their names.\n\t */\n\tinstallPlugin(source: PluginSource, root: string, context: Context): Promise<readonly string[]>;\n\t/** Stops the watcher. */\n\tclose(): void;\n}\n\n/** Creates the plugins component (and its plugin runtime) and starts the watcher. Discovery runs at first use. */\nexport function createPlugins(options: PluginsOptions, _context: Context): Plugins {\n\treturn new PluginsComponent(options);\n}\n\nclass PluginsComponent implements Plugins {\n\treadonly #options: PluginsOptions;\n\treadonly #watcher: PluginWatcher;\n\treadonly #runtime: PluginRuntime;\n\t#discovery: Discovery = { plugins: [], problems: [] };\n\t#discovered = false;\n\t/** The latest build of every (plugin, kind) built so far, by `plugin\\u0000kind`. */\n\treadonly #built = new Map<string, BuiltFacet>();\n\t/** The current set of each kind used so far, by plugin name. */\n\treadonly #current = new Map<string, Map<string, PluginScript>>();\n\t/** The kind each loaded host was loaded with, held as long as the host is. */\n\treadonly #kinds = new WeakMap<object, string>();\n\t/** The marks each build started from, held as long as its result is (a rollout given a copy clears none). */\n\treadonly #snapshots = new WeakMap<Built, MarkSnapshot>();\n\n\tconstructor(options: PluginsOptions) {\n\t\tthis.#options = options;\n\t\tthis.#runtime = createPluginRuntime();\n\t\tconst batch = new Batch((error) => options.onError(error), undefined);\n\t\tthis.#watcher = new PluginWatcher(\n\t\t\t{\n\t\t\t\troots: options.roots.map((root) => (typeof root === \"string\" ? root : root.path)),\n\t\t\t\tbase: options.base ?? [],\n\t\t\t\tkinds: Object.keys(options.kinds),\n\t\t\t\tfailed: (error) => options.onError({ kind: \"watch_failed\", error }),\n\t\t\t},\n\t\t\tbatch,\n\t\t);\n\t}\n\n\tget state(): Watchable<PluginsState> {\n\t\t// Its value is a `PluginsState`.\n\t\treturn this.#watcher as unknown as Watchable<PluginsState>;\n\t}\n\n\tget discovery(): Discovery {\n\t\treturn this.#discovery;\n\t}\n\n\tasync build(names: readonly string[], context: Context): Promise<Built> {\n\t\tconst before = new Map(this.#discovery.plugins.map((plugin) => [plugin.name, plugin]));\n\t\tif (!this.#discovered || this.#watcher.needsDiscovery) await this.#discover(context);\n\t\tconst now = this.#discovery.plugins;\n\t\tconst removed = [...before.keys()].filter((name) => !now.some((plugin) => plugin.name === name));\n\t\t// A plugin whose files moved (a single file became a directory, a facet file came or went) is built again too.\n\t\tconst wanted = now.filter((plugin) => {\n\t\t\tconst previous = before.get(plugin.name);\n\t\t\treturn names.includes(plugin.name) || previous === undefined || !sameFiles(previous, plugin);\n\t\t});\n\t\tconst snapshot = this.#watcher.snapshot([...wanted.map(({ name }) => name), ...removed]);\n\t\tconst facets = await Promise.all(\n\t\t\twanted.flatMap((plugin) => Object.keys(plugin.facets).map((kind) => this.#buildOne(plugin, kind, context))),\n\t\t);\n\t\tconst plugins = Object.fromEntries(wanted.map((plugin) => [plugin.name, plugin]));\n\t\tconst built: Built = { facets, plugins, removed };\n\t\tthis.#snapshots.set(built, snapshot);\n\t\treturn built;\n\t}\n\n\tasync scripts(kind: string, context: Context): Promise<readonly PluginScript[]> {\n\t\treturn [...(await this.#set(kind, context)).values()];\n\t}\n\n\tcurrent(kind: string): readonly PluginScript[] | undefined {\n\t\tconst set = this.#current.get(kind);\n\t\treturn set === undefined ? undefined : [...set.values()];\n\t}\n\n\tasync load<P extends Principal>(\n\t\thost: Host<P>,\n\t\toptions: { readonly kind: string; readonly core: readonly PluginFacet<P>[]; readonly modules: HostPackages },\n\t\tcontext: Context,\n\t): Promise<LoadReport> {\n\t\tconst { kind, core, modules } = options;\n\t\tconst scripts = await this.scripts(kind, context);\n\t\tthis.#kinds.set(host, kind);\n\t\t// A required root guarantees its plugins: what discovery reported in one is as fatal as a plugin that failed.\n\t\tconst problems = this.#discovery.problems.filter(({ required }) => required);\n\t\tlet report: LoadReport;\n\t\ttry {\n\t\t\treport = await this.#runtime.load(host, { kind, core, scripts, modules }, context);\n\t\t} catch (error) {\n\t\t\tif (!(error instanceof PluginError) || problems.length === 0) throw error;\n\t\t\tthrow new PluginError(error.required, error.failed, problems);\n\t\t}\n\t\tif (problems.length > 0) throw new PluginError([], report.failed, problems);\n\t\treturn report;\n\t}\n\n\tasync reload<P extends Principal>(host: Host<P>, built: Built, context: Context): Promise<ReloadReport> {\n\t\tconst kind = this.#kinds.get(host);\n\t\tif (kind === undefined) throw new Error(\"plugins.reload: the host was not loaded by this component\");\n\t\tconst set = await this.#set(kind, context);\n\t\t// Applied and read in one step: two reloads started together each pass the set their own build made.\n\t\tship(set, kind, built);\n\t\treturn this.#runtime.reload(host, [...set.values()], context);\n\t}\n\n\tstep<P extends Principal>(name: string, host: Host<P>): RolloutStep {\n\t\tconst kind = this.#kinds.get(host);\n\t\tif (kind === undefined) throw new Error(\"plugins.step: the host was not loaded by this component\");\n\t\treturn {\n\t\t\tname,\n\t\t\tkinds: [kind],\n\t\t\treload: async (built, context) => ({\n\t\t\t\thosts: [{ host: name, report: await this.reload(host, built, context) }],\n\t\t\t}),\n\t\t};\n\t}\n\n\tasync rollout(steps: readonly RolloutStep[], built: Built, context: Context): Promise<RolloutResult> {\n\t\tconst done: { readonly name: string; readonly hosts: readonly RolloutHost[] }[] = [];\n\t\tconst failed = new Set<string>();\n\t\tconst shipped = new Set<string>();\n\t\tfor (const step of steps) {\n\t\t\tlet hosts: readonly RolloutHost[];\n\t\t\ttry {\n\t\t\t\tfor (const kind of step.kinds) ship(await this.#set(kind, context), kind, built);\n\t\t\t\thosts = (await step.reload(built, context)).hosts;\n\t\t\t} catch (error) {\n\t\t\t\treturn { steps: done, stopped: { step: step.name, error } };\n\t\t\t}\n\t\t\tfor (const kind of step.kinds) shipped.add(kind);\n\t\t\tfor (const entry of hosts) {\n\t\t\t\tif (\"report\" in entry) for (const { plugin } of entry.report.failed) failed.add(plugin);\n\t\t\t\telse if (\"error\" in entry) for (const plugin of builtOf(built, step.kinds)) failed.add(plugin);\n\t\t\t}\n\t\t\tdone.push({ name: step.name, hosts });\n\t\t}\n\t\t// A plugin with a built kind no step shipped is not applied everywhere it runs: it stays dirty.\n\t\tfor (const { plugin, facet } of built.facets) if (!shipped.has(facet)) failed.add(plugin);\n\t\tconst snapshot = this.#snapshots.get(built);\n\t\tif (snapshot !== undefined) {\n\t\t\tthis.#watcher.applied(\n\t\t\t\t[...snapshot.plugins.keys()].filter((name) => !failed.has(name)),\n\t\t\t\tsnapshot,\n\t\t\t);\n\t\t}\n\t\treturn { steps: done, stopped: undefined };\n\t}\n\n\twatchBase(inputs: BaseInputs): Promise<void> {\n\t\treturn this.#watcher.recordBase(inputs);\n\t}\n\n\tasync installDependencies(name: string, context: Context): Promise<void> {\n\t\tif (!this.#discovered) await this.#discover(context);\n\t\tconst plugin = this.#discovery.plugins.find((each) => each.name === name);\n\t\tif (plugin === undefined) throw new Error(`plugins.installDependencies: no plugin \"${name}\"`);\n\t\tawait installDependencies(plugin, context, this.#options.install);\n\t\tthis.#watcher.installed(name);\n\t}\n\n\tasync installPlugin(source: PluginSource, root: string, context: Context): Promise<readonly string[]> {\n\t\tconst roots = this.#options.roots.map((each) => (typeof each === \"string\" ? each : each.path));\n\t\tif (!roots.includes(root)) throw new Error(`plugins.installPlugin: ${root} is not one of the roots`);\n\t\tconst options = { ...this.#options.install, kinds: Object.keys(this.#options.kinds), roots: this.#options.roots };\n\t\tconst names = await installPlugin(source, root, context, options);\n\t\tthis.#watcher.added();\n\t\treturn names;\n\t}\n\n\tclose(): void {\n\t\tthis.#watcher.close();\n\t}\n\n\t/** Discovers the plugins again; the changes of the plugin set and of `package.json`s seen until now clear. */\n\tasync #discover(context: Context): Promise<void> {\n\t\tconst seen = this.#watcher.discoverySnapshot();\n\t\tthis.#discovery = await discoverPlugins(\n\t\t\tthis.#options.roots,\n\t\t\t{ kinds: Object.keys(this.#options.kinds) },\n\t\t\tcontext,\n\t\t);\n\t\tthis.#discovered = true;\n\t\t// A plugin no longer discovered loses its builds: a name added again is built anew, never served an old build.\n\t\tfor (const key of this.#built.keys()) {\n\t\t\tconst name = key.slice(0, key.indexOf(\"\\u0000\"));\n\t\t\tif (!this.#discovery.plugins.some((plugin) => plugin.name === name)) this.#built.delete(key);\n\t\t}\n\t\tthis.#watcher.know(this.#discovery, seen);\n\t}\n\n\t/** `kind`'s current set, made at its first use from every discovered plugin's facet of it (built if needed). */\n\tasync #set(kind: string, context: Context): Promise<Map<string, PluginScript>> {\n\t\tlet set = this.#current.get(kind);\n\t\tif (set !== undefined) return set;\n\t\tif (!this.#discovered) await this.#discover(context);\n\t\tconst plugins = this.#discovery.plugins.filter((plugin) => plugin.facets[kind] !== undefined);\n\t\tconst scripts = await Promise.all(\n\t\t\tplugins.map(async (plugin): Promise<PluginScript> => {\n\t\t\t\tconst built =\n\t\t\t\t\tthis.#built.get(`${plugin.name}\\u0000${kind}`) ?? (await this.#buildOne(plugin, kind, context));\n\t\t\t\treturn { plugin, built };\n\t\t\t}),\n\t\t);\n\t\t// Built concurrently: a set made meanwhile (by a concurrent first use) wins.\n\t\tset = this.#current.get(kind) ?? new Map(scripts.map((script) => [script.plugin.name, script]));\n\t\tthis.#current.set(kind, set);\n\t\treturn set;\n\t}\n\n\t/** Builds `plugin`'s facet of `kind` and keeps it as the latest; the watcher learns what it read. */\n\tasync #buildOne(plugin: Plugin, kind: string, context: Context): Promise<BuiltFacet> {\n\t\tconst { kinds, publicPath, api } = this.#options;\n\t\t// Discovery finds facet files of the app's kinds only.\n\t\tconst { platform, hostPackages } = kinds[kind]!;\n\t\tconst options = {\n\t\t\thostPackages,\n\t\t\tplatform,\n\t\t\tkinds: Object.keys(kinds),\n\t\t\tplugins: this.#discovery.plugins,\n\t\t\t...(api === undefined ? {} : { api }),\n\t\t\t...(publicPath === undefined ? {} : { publicPath }),\n\t\t} as const;\n\t\tconst built = await buildFacet(plugin, kind, options, context);\n\t\tthis.#built.set(`${plugin.name}\\u0000${kind}`, built);\n\t\tthis.#watcher.used([built]);\n\t\treturn built;\n\t}\n}\n\n/**\n * Applies `built` to `set`, `kind`'s current set: its removed plugins and those rebuilt without a facet of `kind` leave\n * it, its facets of `kind` replace theirs.\n */\nfunction ship(set: Map<string, PluginScript>, kind: string, built: Built): void {\n\tfor (const name of built.removed) set.delete(name);\n\tfor (const [name, plugin] of Object.entries(built.plugins)) if (plugin.facets[kind] === undefined) set.delete(name);\n\tfor (const facet of built.facets) {\n\t\t// Own properties only: a plugin may be named like one of `Object.prototype`'s (`constructor`).\n\t\tif (facet.facet === kind && Object.hasOwn(built.plugins, facet.plugin)) {\n\t\t\tset.set(facet.plugin, { plugin: built.plugins[facet.plugin]!, built: facet });\n\t\t}\n\t}\n}\n\n/** The plugins of `built` with a facet of one of `kinds`. */\nfunction builtOf(built: Built, kinds: readonly string[]): string[] {\n\treturn built.facets.filter(({ facet }) => kinds.includes(facet)).map(({ plugin }) => plugin);\n}\n"]}

package/dist/node/plugins/runtime.d.ts

@@ -0,0 +1,57 @@
+import type { Context } from "../../context/index.ts";
+import type { Principal } from "../../data/index.ts";
+import type { Host, LoadReport, PluginFacet, PluginFailure, ReloadReport } from "../../host/index.ts";
+import type { BuiltFacet } from "./build.ts";
+import type { DiscoveryProblem, Plugin } from "./discover.ts";
+import { type HostPackages } from "./evaluate.ts";
+/** One plugin's facet of a kind as shipped to a host (plain data): its build and its plugin record. */
+export type PluginScript = {
+    readonly plugin: Plugin;
+    readonly built: BuiltFacet;
+};
+/**
+ * `load`'s rejection when a required root did not deliver its plugins: some failed (their build, evaluation or setup),
+ * or discovery reported problems in it (a missing root, an invalid `package.json`, a name another root has). The host's
+ * load settled (the others are loaded); the app decides what follows (stopping, mostly). `failed` is the whole
+ * report's list.
+ */
+export declare class PluginError extends Error {
+    /** The required plugins that failed, and why. */
+    readonly required: readonly PluginFailure[];
+    /** Every plugin the load left out, required or not. */
+    readonly failed: readonly PluginFailure[];
+    /** What discovery reported in required roots. */
+    readonly problems: readonly DiscoveryProblem[];
+    constructor(required: readonly PluginFailure[], failed: readonly PluginFailure[], problems?: readonly DiscoveryProblem[]);
+}
+/** What `PluginRuntime.load` takes besides the host. */
+export type RuntimeLoad<P extends Principal> = {
+    readonly kind: string;
+    readonly core: readonly PluginFacet<P>[];
+    readonly scripts: readonly PluginScript[];
+    readonly modules: HostPackages;
+};
+/** The plugin runtime: loads and reloads hosts with complete sets of shipped scripts. */
+export interface PluginRuntime {
+    /**
+     * Evaluates `scripts` (the complete set of `kind`) with `modules` (the host packages their `require` answers: this
+     * process's instances, kept for the host's reloads) and loads them on `host` with `core` (the app's own facets): a
+     * plugin whose build or evaluation failed is left out and reported with the host's report. When plugins of a
+     * required root are among the failed, it rejects with a `PluginError` naming them after the host's load settled.
+     */
+    load<P extends Principal>(host: Host<P>, options: RuntimeLoad<P>, context: Context): Promise<LoadReport>;
+    /**
+     * Reloads `host` (loaded by `load`) with `scripts`, the complete set now, after its earlier reloads: its core facets
+     * and unchanged plugins (the same digest) as the same objects, new scripts evaluated, a plugin whose build or
+     * evaluation failed passed as its loaded facet (an added one left out; both given to the host's closure rule),
+     * loaded plugins not in `scripts` left out. What the host committed is the loaded set, also when the reload rejects
+     * `aborted` after its commit.
+     */
+    reload<P extends Principal>(host: Host<P>, scripts: readonly PluginScript[], context: Context): Promise<ReloadReport>;
+}
+/**
+ * Creates a plugin runtime: turns V8's compilation cache off (once per process: each distinct evaluated script would
+ * stay cached).
+ */
+export declare function createPluginRuntime(): PluginRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/node/plugins/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/node/plugins/runtime.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEtG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEjE,uGAAuG;AACvG,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAEnF;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACrC,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE/C,YACC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,QAAQ,GAAE,SAAS,gBAAgB,EAAO,EAa1C;CACD;AAED,wDAAwD;AACxD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,IAAI;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAC/B,CAAC;AAEF,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzG;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,SAAS,SAAS,EACzB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,CAAC,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAMnD"}

package/dist/node/plugins/runtime.js

@@ -0,0 +1,92 @@
+// The plugin runtime (slice 10 §3, D11): loading and reloading hosts with shipped scripts, without building (no
+// esbuild, no watcher), so a worker evaluates what the server built. Per host it keeps the facet loaded for every plugin
+// and passes the host its complete set at each reload: unchanged plugins (the same digest) as the same facet objects,
+// removed ones (loaded, not shipped) left out; a plugin whose build or evaluation failed keeps its loaded facet (left
+// out at startup) and is reported with the host's report; at startup one of a required root (the app's own) rejects the
+// load once the host's load settled. The plugins component (`createPlugins`) uses one.
+import { setFlagsFromString } from "node:v8";
+import { LoadedFacets } from "../../surfaces/loaded.js";
+import { evaluateFacet } from "./evaluate.js";
+/**
+ * `load`'s rejection when a required root did not deliver its plugins: some failed (their build, evaluation or setup),
+ * or discovery reported problems in it (a missing root, an invalid `package.json`, a name another root has). The host's
+ * load settled (the others are loaded); the app decides what follows (stopping, mostly). `failed` is the whole
+ * report's list.
+ */
+export class PluginError extends Error {
+    /** The required plugins that failed, and why. */
+    required;
+    /** Every plugin the load left out, required or not. */
+    failed;
+    /** What discovery reported in required roots. */
+    problems;
+    constructor(required, failed, problems = []) {
+        const named = [
+            ...required.map(({ plugin, error }) => `"${plugin}": ${error instanceof Error ? error.message : String(error)}`),
+            ...problems.map(({ path, error }) => `${path}: ${error}`),
+        ];
+        super(`required plugin failed at load: ${named.join("; ")}`);
+        this.name = "PluginError";
+        this.required = required;
+        this.failed = failed;
+        this.problems = problems;
+    }
+}
+/**
+ * Creates a plugin runtime: turns V8's compilation cache off (once per process: each distinct evaluated script would
+ * stay cached).
+ */
+export function createPluginRuntime() {
+    if (!cacheOff) {
+        setFlagsFromString("--no-compilation-cache");
+        cacheOff = true;
+    }
+    return new Runtime();
+}
+/** Whether this process turned V8's compilation cache off already. */
+let cacheOff = false;
+class Runtime {
+    /** Each loaded host's plugins and modules, held as long as the host is. */
+    #hosts = new WeakMap();
+    async load(host, options, context) {
+        const { modules, scripts } = options;
+        const entries = scripts.map((script) => entryOf(script, modules));
+        const { loaded, report } = await LoadedFacets.load(host, options.core, entries, context);
+        this.#hosts.set(host, { loaded, modules });
+        const required = new Set(scripts.filter(({ plugin }) => plugin.required).map(({ plugin }) => plugin.name));
+        const fatal = report.failed.filter(({ plugin }) => required.has(plugin));
+        if (fatal.length > 0)
+            throw new PluginError(fatal, report.failed);
+        return report;
+    }
+    reload(host, scripts, context) {
+        const state = this.#hosts.get(host);
+        if (state === undefined)
+            throw new Error("plugins.reload: the host was not loaded by this runtime");
+        const entries = scripts.map((script) => entryOf(script, state.modules));
+        return state.loaded.reload(host, entries, context);
+    }
+}
+/** `script` as one plugin of a complete set: its digest, and its evaluation with `modules` when it is new. */
+function entryOf({ plugin, built }, modules) {
+    return {
+        name: plugin.name,
+        digest: built.kind === "script" ? built.digest : undefined,
+        prepare: () => prepare(plugin, built, modules),
+    };
+}
+/** `built` evaluated for `plugin` with `modules`, or why not: its build failed, or its evaluation threw. */
+function prepare(plugin, built, modules) {
+    if (built.kind === "failed") {
+        const message = `plugin "${plugin.name}": its ${built.facet} facet failed to build:\n${built.errors.join("\n")}`;
+        return { kind: "failed", error: new Error(message) };
+    }
+    try {
+        const facet = evaluateFacet(built, { hostPackages: modules, plugin });
+        return { kind: "facet", facet, digest: built.digest };
+    }
+    catch (error) {
+        return { kind: "failed", error };
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/node/plugins/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/node/plugins/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["// The plugin runtime (slice 10 §3, D11): loading and reloading hosts with shipped scripts, without building (no\n// esbuild, no watcher), so a worker evaluates what the server built. Per host it keeps the facet loaded for every plugin\n// and passes the host its complete set at each reload: unchanged plugins (the same digest) as the same facet objects,\n// removed ones (loaded, not shipped) left out; a plugin whose build or evaluation failed keeps its loaded facet (left\n// out at startup) and is reported with the host's report; at startup one of a required root (the app's own) rejects the\n// load once the host's load settled. The plugins component (`createPlugins`) uses one.\n\nimport { setFlagsFromString } from \"node:v8\";\nimport type { Context } from \"../../context/index.ts\";\nimport type { Principal } from \"../../data/index.ts\";\nimport type { Host, LoadReport, PluginFacet, PluginFailure, ReloadReport } from \"../../host/index.ts\";\nimport { LoadedFacets, type Prepared, type SetEntry } from \"../../surfaces/loaded.ts\";\nimport type { BuiltFacet } from \"./build.ts\";\nimport type { DiscoveryProblem, Plugin } from \"./discover.ts\";\nimport { evaluateFacet, type HostPackages } from \"./evaluate.ts\";\n\n/** One plugin's facet of a kind as shipped to a host (plain data): its build and its plugin record. */\nexport type PluginScript = { readonly plugin: Plugin; readonly built: BuiltFacet };\n\n/**\n * `load`'s rejection when a required root did not deliver its plugins: some failed (their build, evaluation or setup),\n * or discovery reported problems in it (a missing root, an invalid `package.json`, a name another root has). The host's\n * load settled (the others are loaded); the app decides what follows (stopping, mostly). `failed` is the whole\n * report's list.\n */\nexport class PluginError extends Error {\n\t/** The required plugins that failed, and why. */\n\treadonly required: readonly PluginFailure[];\n\t/** Every plugin the load left out, required or not. */\n\treadonly failed: readonly PluginFailure[];\n\t/** What discovery reported in required roots. */\n\treadonly problems: readonly DiscoveryProblem[];\n\n\tconstructor(\n\t\trequired: readonly PluginFailure[],\n\t\tfailed: readonly PluginFailure[],\n\t\tproblems: readonly DiscoveryProblem[] = [],\n\t) {\n\t\tconst named = [\n\t\t\t...required.map(\n\t\t\t\t({ plugin, error }) => `\"${plugin}\": ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t),\n\t\t\t...problems.map(({ path, error }) => `${path}: ${error}`),\n\t\t];\n\t\tsuper(`required plugin failed at load: ${named.join(\"; \")}`);\n\t\tthis.name = \"PluginError\";\n\t\tthis.required = required;\n\t\tthis.failed = failed;\n\t\tthis.problems = problems;\n\t}\n}\n\n/** What `PluginRuntime.load` takes besides the host. */\nexport type RuntimeLoad<P extends Principal> = {\n\treadonly kind: string;\n\treadonly core: readonly PluginFacet<P>[];\n\treadonly scripts: readonly PluginScript[];\n\treadonly modules: HostPackages;\n};\n\n/** The plugin runtime: loads and reloads hosts with complete sets of shipped scripts. */\nexport interface PluginRuntime {\n\t/**\n\t * Evaluates `scripts` (the complete set of `kind`) with `modules` (the host packages their `require` answers: this\n\t * process's instances, kept for the host's reloads) and loads them on `host` with `core` (the app's own facets): a\n\t * plugin whose build or evaluation failed is left out and reported with the host's report. When plugins of a\n\t * required root are among the failed, it rejects with a `PluginError` naming them after the host's load settled.\n\t */\n\tload<P extends Principal>(host: Host<P>, options: RuntimeLoad<P>, context: Context): Promise<LoadReport>;\n\t/**\n\t * Reloads `host` (loaded by `load`) with `scripts`, the complete set now, after its earlier reloads: its core facets\n\t * and unchanged plugins (the same digest) as the same objects, new scripts evaluated, a plugin whose build or\n\t * evaluation failed passed as its loaded facet (an added one left out; both given to the host's closure rule),\n\t * loaded plugins not in `scripts` left out. What the host committed is the loaded set, also when the reload rejects\n\t * `aborted` after its commit.\n\t */\n\treload<P extends Principal>(\n\t\thost: Host<P>,\n\t\tscripts: readonly PluginScript[],\n\t\tcontext: Context,\n\t): Promise<ReloadReport>;\n}\n\n/**\n * Creates a plugin runtime: turns V8's compilation cache off (once per process: each distinct evaluated script would\n * stay cached).\n */\nexport function createPluginRuntime(): PluginRuntime {\n\tif (!cacheOff) {\n\t\tsetFlagsFromString(\"--no-compilation-cache\");\n\t\tcacheOff = true;\n\t}\n\treturn new Runtime();\n}\n\n/** Whether this process turned V8's compilation cache off already. */\nlet cacheOff = false;\n\nclass Runtime implements PluginRuntime {\n\t/** Each loaded host's plugins and modules, held as long as the host is. */\n\treadonly #hosts = new WeakMap<object, { readonly loaded: LoadedFacets; readonly modules: HostPackages }>();\n\n\tasync load<P extends Principal>(host: Host<P>, options: RuntimeLoad<P>, context: Context): Promise<LoadReport> {\n\t\tconst { modules, scripts } = options;\n\t\tconst entries = scripts.map((script) => entryOf(script, modules));\n\t\tconst { loaded, report } = await LoadedFacets.load(host, options.core, entries, context);\n\t\tthis.#hosts.set(host, { loaded, modules });\n\t\tconst required = new Set(scripts.filter(({ plugin }) => plugin.required).map(({ plugin }) => plugin.name));\n\t\tconst fatal = report.failed.filter(({ plugin }) => required.has(plugin));\n\t\tif (fatal.length > 0) throw new PluginError(fatal, report.failed);\n\t\treturn report;\n\t}\n\n\treload<P extends Principal>(\n\t\thost: Host<P>,\n\t\tscripts: readonly PluginScript[],\n\t\tcontext: Context,\n\t): Promise<ReloadReport> {\n\t\tconst state = this.#hosts.get(host);\n\t\tif (state === undefined) throw new Error(\"plugins.reload: the host was not loaded by this runtime\");\n\t\tconst entries = scripts.map((script) => entryOf(script, state.modules));\n\t\treturn state.loaded.reload(host, entries, context);\n\t}\n}\n\n/** `script` as one plugin of a complete set: its digest, and its evaluation with `modules` when it is new. */\nfunction entryOf({ plugin, built }: PluginScript, modules: HostPackages): SetEntry {\n\treturn {\n\t\tname: plugin.name,\n\t\tdigest: built.kind === \"script\" ? built.digest : undefined,\n\t\tprepare: () => prepare(plugin, built, modules),\n\t};\n}\n\n/** `built` evaluated for `plugin` with `modules`, or why not: its build failed, or its evaluation threw. */\nfunction prepare(plugin: Plugin, built: BuiltFacet, modules: HostPackages): Prepared {\n\tif (built.kind === \"failed\") {\n\t\tconst message = `plugin \"${plugin.name}\": its ${built.facet} facet failed to build:\\n${built.errors.join(\"\\n\")}`;\n\t\treturn { kind: \"failed\", error: new Error(message) };\n\t}\n\ttry {\n\t\tconst facet = evaluateFacet(built, { hostPackages: modules, plugin });\n\t\treturn { kind: \"facet\", facet, digest: built.digest };\n\t} catch (error) {\n\t\treturn { kind: \"failed\", error };\n\t}\n}\n"]}

package/dist/node/plugins/stack.d.ts

@@ -0,0 +1,16 @@
+import { SourceMap } from "node:module";
+/**
+ * Registers the script `source` evaluated under `filename` for plugin directory `dir` while `owner` (its facet, or the
+ * error its evaluation threw) lives: its inline source map, whose sources are relative to the plugin's directory. Two
+ * evaluations of one script (two hosts) share the entry.
+ */
+export declare function registerScript(filename: string, source: string, dir: string, owner: object): void;
+/** The inline source map esbuild appended to a built script, if it has one. */
+export declare function inlineSourceMap(source: string): SourceMap | undefined;
+/**
+ * `error`'s stack with every position in a registered plugin script mapped through its source map to the plugin's file
+ * and line (`notes/worker.ts:12:3`: the plugin's directory name and the file's path inside it); other lines as they
+ * are. A value that is no error with a stack gives its string.
+ */
+export declare function mapStack(error: unknown): string;
+//# sourceMappingURL=stack.d.ts.map

package/dist/node/plugins/stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../../src/node/plugins/stack.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAexC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAUjG;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAGrE;AAKD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU/C"}

package/dist/node/plugins/stack.js

@@ -0,0 +1,61 @@
+// Stack traces of plugin scripts (slice 7c §3, decision Q1 (b)): `vm.Script` maps no positions through a source map, so
+// every evaluated script registers its map under its filename while something of its evaluation lives (its facet, or
+// the error it threw while evaluated), and `mapStack` rewrites an error's stack through them, for the app's reporters.
+// Nothing global: no `Error.prepareStackTrace`, no process-wide source-map switch. The registry is a module-level `Map`
+// keyed by filename, not a `WeakMap` keyed by an owner: `mapStack` starts from a stack's text, which names only the
+// filename. Its entries go with the last evaluation of their script (a `FinalizationRegistry` counts them down).
+import { SourceMap } from "node:module";
+import { basename, join } from "node:path";
+/** The evaluated scripts by filename, while an evaluation of each lives. */
+const scripts = new Map();
+/** Counts down an evaluation that was collected; its script's entry goes with the last one. */
+const collected = new FinalizationRegistry((filename) => {
+    const script = scripts.get(filename);
+    if (script !== undefined && --script.live === 0)
+        scripts.delete(filename);
+});
+/**
+ * Registers the script `source` evaluated under `filename` for plugin directory `dir` while `owner` (its facet, or the
+ * error its evaluation threw) lives: its inline source map, whose sources are relative to the plugin's directory. Two
+ * evaluations of one script (two hosts) share the entry.
+ */
+export function registerScript(filename, source, dir, owner) {
+    let script = scripts.get(filename);
+    if (script === undefined) {
+        const map = inlineSourceMap(source);
+        if (map === undefined)
+            return;
+        script = { map, dir, live: 0 };
+        scripts.set(filename, script);
+    }
+    script.live++;
+    collected.register(owner, filename);
+}
+/** The inline source map esbuild appended to a built script, if it has one. */
+export function inlineSourceMap(source) {
+    const inline = SOURCE_MAP.exec(source);
+    return inline === null ? undefined : new SourceMap(JSON.parse(Buffer.from(inline[1], "base64").toString("utf8")));
+}
+/** The inline source map esbuild appends to a script. */
+const SOURCE_MAP = /\/\/# sourceMappingURL=data:application\/json;base64,([A-Za-z0-9+/=]+)\s*$/;
+/**
+ * `error`'s stack with every position in a registered plugin script mapped through its source map to the plugin's file
+ * and line (`notes/worker.ts:12:3`: the plugin's directory name and the file's path inside it); other lines as they
+ * are. A value that is no error with a stack gives its string.
+ */
+export function mapStack(error) {
+    const stack = error instanceof Error ? error.stack : undefined;
+    if (stack === undefined)
+        return String(error);
+    return stack.replace(POSITION, (whole, filename, line, column) => {
+        const script = scripts.get(filename);
+        const entry = script?.map.findEntry(Number(line) - 1, Number(column) - 1);
+        if (script === undefined || entry === undefined || !("originalSource" in entry))
+            return whole;
+        const file = join(basename(script.dir), entry.originalSource).split("\\").join("/");
+        return `${file}:${entry.originalLine + 1}:${entry.originalColumn + 1}`;
+    });
+}
+/** A position in a stack line: `filename:line:column`, the filename being anything up to it (spaces included). */
+const POSITION = /([^\s()]+):(\d+):(\d+)/g;
+//# sourceMappingURL=stack.js.map

package/dist/node/plugins/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../../src/node/plugins/stack.ts"],"names":[],"mappings":"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","sourcesContent":["// Stack traces of plugin scripts (slice 7c §3, decision Q1 (b)): `vm.Script` maps no positions through a source map, so\n// every evaluated script registers its map under its filename while something of its evaluation lives (its facet, or\n// the error it threw while evaluated), and `mapStack` rewrites an error's stack through them, for the app's reporters.\n// Nothing global: no `Error.prepareStackTrace`, no process-wide source-map switch. The registry is a module-level `Map`\n// keyed by filename, not a `WeakMap` keyed by an owner: `mapStack` starts from a stack's text, which names only the\n// filename. Its entries go with the last evaluation of their script (a `FinalizationRegistry` counts them down).\n\nimport { SourceMap } from \"node:module\";\nimport { basename, join } from \"node:path\";\n\n/** A registered script: how its positions map, its plugin's directory, and how many of its evaluations live. */\ntype Registered = { readonly map: SourceMap; readonly dir: string; live: number };\n\n/** The evaluated scripts by filename, while an evaluation of each lives. */\nconst scripts = new Map<string, Registered>();\n\n/** Counts down an evaluation that was collected; its script's entry goes with the last one. */\nconst collected = new FinalizationRegistry<string>((filename) => {\n\tconst script = scripts.get(filename);\n\tif (script !== undefined && --script.live === 0) scripts.delete(filename);\n});\n\n/**\n * Registers the script `source` evaluated under `filename` for plugin directory `dir` while `owner` (its facet, or the\n * error its evaluation threw) lives: its inline source map, whose sources are relative to the plugin's directory. Two\n * evaluations of one script (two hosts) share the entry.\n */\nexport function registerScript(filename: string, source: string, dir: string, owner: object): void {\n\tlet script = scripts.get(filename);\n\tif (script === undefined) {\n\t\tconst map = inlineSourceMap(source);\n\t\tif (map === undefined) return;\n\t\tscript = { map, dir, live: 0 };\n\t\tscripts.set(filename, script);\n\t}\n\tscript.live++;\n\tcollected.register(owner, filename);\n}\n\n/** The inline source map esbuild appended to a built script, if it has one. */\nexport function inlineSourceMap(source: string): SourceMap | undefined {\n\tconst inline = SOURCE_MAP.exec(source);\n\treturn inline === null ? undefined : new SourceMap(JSON.parse(Buffer.from(inline[1]!, \"base64\").toString(\"utf8\")));\n}\n\n/** The inline source map esbuild appends to a script. */\nconst SOURCE_MAP = /\\/\\/# sourceMappingURL=data:application\\/json;base64,([A-Za-z0-9+/=]+)\\s*$/;\n\n/**\n * `error`'s stack with every position in a registered plugin script mapped through its source map to the plugin's file\n * and line (`notes/worker.ts:12:3`: the plugin's directory name and the file's path inside it); other lines as they\n * are. A value that is no error with a stack gives its string.\n */\nexport function mapStack(error: unknown): string {\n\tconst stack = error instanceof Error ? error.stack : undefined;\n\tif (stack === undefined) return String(error);\n\treturn stack.replace(POSITION, (whole, filename: string, line: string, column: string) => {\n\t\tconst script = scripts.get(filename);\n\t\tconst entry = script?.map.findEntry(Number(line) - 1, Number(column) - 1);\n\t\tif (script === undefined || entry === undefined || !(\"originalSource\" in entry)) return whole;\n\t\tconst file = join(basename(script.dir), entry.originalSource).split(\"\\\\\").join(\"/\");\n\t\treturn `${file}:${entry.originalLine + 1}:${entry.originalColumn + 1}`;\n\t});\n}\n\n/** A position in a stack line: `filename:line:column`, the filename being anything up to it (spaces included). */\nconst POSITION = /([^\\s()]+):(\\d+):(\\d+)/g;\n"]}