@earendil-works/chord 1.5.0 → 1.5.1

package/dist/node/plugins/testing.js

@@ -0,0 +1,210 @@
+// Testing a plugin alone (slice 12 §6, decision "Testing a plugin alone"): the plugin built as production builds it,
+// evaluated with the app's real API modules, loaded on an in-memory host (a `:memory:` SQLite store) beside stub facets
+// serving the contracts it uses. The registries it contributes to that nobody serves are served by the helper, which
+// collects their entries for the test; the contracts its requests wait for unserved are listed, so a test knows what
+// to stub. No test-only modes: the host, the build and the evaluation are the ones apps run.
+import { readdir, realpath, stat } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { createHost, defineFacet, } from "../../host/index.js";
+import { defineRegistry, } from "../../registries/index.js";
+import { openNodeSqliteDatabase } from "../../sqlite/node.js";
+import { openStore, sqliteBackend } from "../../store/index.js";
+import { buildFacet } from "./build.js";
+import { discoverPlugins } from "./discover.js";
+import { evaluateFacet } from "./evaluate.js";
+/**
+ * Builds the plugin in `dir` as production does (`buildFacet` with the kind's options), evaluates its facet of
+ * `options.kind` with `options.modules` and loads it on a new host with an in-memory store, the stubs beside it. Then
+ * the registries it contributes to that nobody serves are served by a collecting facet. Rejects when the build, the
+ * evaluation or a setup fails (naming it).
+ */
+export async function testPlugin(dir, options, context) {
+    const { kind, modules } = options;
+    const versioned = Object.keys(modules).find((specifier) => VERSIONED.test(specifier));
+    if (versioned !== undefined && options.api === undefined) {
+        throw new Error(`testPlugin: modules hold the app's versioned API ("${versioned}"): pass api, as production does`);
+    }
+    const real = await realpath(dir);
+    const root = await rootOf(real);
+    const kinds = options.kinds ?? [kind, ...(await kindsNamedIn(root))];
+    const plugin = await pluginIn(real, root, kinds, context);
+    const built = await buildFacet(plugin.found, kind, {
+        hostPackages: Object.keys(modules),
+        platform: options.platform ?? "node",
+        kinds,
+        plugins: plugin.plugins,
+        ...(options.api === undefined ? {} : { api: options.api }),
+    }, context);
+    if (built.kind === "failed") {
+        throw new Error(`testPlugin: "${plugin.found.name}" failed to build:\n${built.errors.join("\n")}`);
+    }
+    const facet = evaluateFacet(built, { hostPackages: modules, plugin: plugin.found });
+    const store = await openStore(sqliteBackend(await openNodeSqliteDatabase(":memory:")), context);
+    const errors = [];
+    const host = createHost({
+        store,
+        onError: (error) => errors.push(error),
+        ...(options.principal === undefined ? {} : { principal: options.principal }),
+        ...(options.address === undefined ? {} : { address: options.address }),
+    });
+    try {
+        const facets = [...(options.stubs ?? []), { name: plugin.found.name, facet }];
+        throwFailed(await host.load(facets, context));
+        const collected = await collect(host, facets, context);
+        return new Tested(host, store, plugin.found, errors, collected);
+    }
+    catch (error) {
+        await host.close(context);
+        await store.close(context);
+        throw error;
+    }
+}
+/** A host package named with a version of an API (`@acme/app/v3`, `@acme/app/v3/worker`). */
+const VERSIONED = /\/v\d+(?:\/|$)/;
+/**
+ * The root the plugin at `real` (a directory, or a single-file plugin's file) is in, as production lists it: its
+ * directory's parent, or, for a plugin in a checkout of several (a parent with its own `package.json` or `.git`), that
+ * checkout's parent.
+ */
+async function rootOf(real) {
+    const parent = dirname(real);
+    if ((await stat(real)).isFile())
+        return parent;
+    const checkout = (await exists(join(parent, "package.json"))) || (await exists(join(parent, ".git")));
+    return checkout ? dirname(parent) : parent;
+}
+/**
+ * The kinds files under `root` name (`contract.web.tsx`: `web`; not `*.test.*`, `*.spec.*` or `*.d.ts`), `node_modules`
+ * and hidden directories skipped; one walk per `testPlugin` call.
+ */
+async function kindsNamedIn(root) {
+    const kinds = new Set();
+    const walk = async (dir) => {
+        for (const entry of await readdir(dir, { withFileTypes: true })) {
+            if (entry.name.startsWith(".") || entry.name === "node_modules")
+                continue;
+            if (entry.isDirectory())
+                await walk(join(dir, entry.name));
+            const parts = entry.name.split(".");
+            const segment = parts[parts.length - 2];
+            // Tests and declaration files name no kind (`stats.test.ts`, `env.d.ts`).
+            const named = parts.length >= 3 && segment !== "test" && segment !== "spec" && segment !== "d";
+            if (entry.isFile() && named)
+                kinds.add(segment);
+        }
+    };
+    await walk(root);
+    return [...kinds];
+}
+/** Whether `path` exists. */
+async function exists(path) {
+    return stat(path).then(() => true, () => false);
+}
+/** The plugin at `real` (its directory, or a single-file plugin's file), discovered with the others of `root`. */
+async function pluginIn(real, root, kinds, context) {
+    const { plugins, problems } = await discoverPlugins([root], { kinds }, context);
+    const found = plugins.find((each) => each.layout === "directory" ? each.dir === real : Object.values(each.facets).includes(real));
+    if (found !== undefined)
+        return { found, plugins };
+    const problem = problems.find(({ path }) => path === real);
+    throw new Error(`testPlugin: ${real} is no plugin${problem === undefined ? "" : `: ${problem.error}`}`);
+}
+/** Throws the failures of a load: a test of a plugin whose setup (or a stub's) failed has nothing to test. */
+function throwFailed(report) {
+    const [first] = report.failed;
+    if (first === undefined)
+        return;
+    // The host's errors name their plugin.
+    const message = report.failed
+        .map(({ error }) => (error instanceof Error ? error.message : String(error)))
+        .join("; ");
+    throw new Error(`testPlugin: setup failed: ${message}`, { cause: first.error });
+}
+/** The plugin name of the collecting facet, beside the plugin and its stubs. */
+const COLLECTOR = "chord.test-plugin-collector";
+/**
+ * Serves every registry with contributions on `host` and no provider with a collecting provider (its `compose` is the
+ * table; every older version accepted as it is), through a reload adding it beside `facets`; returns each one's value.
+ */
+async function collect(host, facets, context) {
+    const tokens = new Map();
+    // A fixed point: an object that goes live once a collected registry is served may contribute to another.
+    for (;;) {
+        await settle(host);
+        // The helper's own host: its internal view of the registries.
+        const fresh = host.undeclaredRegistries().filter(({ name }) => !tokens.has(name));
+        if (fresh.length === 0)
+            break;
+        for (const { name, version } of fresh)
+            tokens.set(name, defineRegistry(name, { version }));
+        const served = [...tokens.values()];
+        const collector = defineFacet((facetHost) => {
+            for (const token of served)
+                facetHost.serve(token, { compose: (table) => table, accepts: olderAs(token) });
+        });
+        throwFailed(await host.reload([...facets, { name: COLLECTOR, facet: collector }], context));
+    }
+    const values = new Map();
+    for (const token of tokens.values())
+        values.set(token.name, await host.registry(token, context));
+    return values;
+}
+/**
+ * Waits until no activation on `host` is under way (as `load`'s barrier waits for first outcomes), bounded by the host's
+ * `readyTimeout`: the objects a reload's publication woke reach their outcome, slow openers included.
+ */
+async function settle(host) {
+    // The helper's own host: its internal view of its objects and timeouts.
+    const chord = host;
+    const deadline = Date.now() + chord.timeouts.ready;
+    // The woken requests check again in promise jobs and I/O callbacks: let those run before counting.
+    do {
+        for (let turn = 0; turn < 3; turn++)
+            await new Promise((resolve) => setImmediate(resolve));
+        if (chord.activationsUnderWay() === 0)
+            return;
+        await new Promise((resolve) => setTimeout(resolve, 5));
+    } while (Date.now() < deadline);
+}
+/** Every older version's contributions and readers as they are: made per version looked up, not per version below. */
+function olderAs(token) {
+    const asItIs = { contribution: (old) => old, value: (table) => table };
+    // The kernel only looks adapters up by version (`accepts[version]`).
+    return new Proxy({}, {
+        get: (_target, key) => typeof key === "string" && /^\d+$/.test(key) && Number(key) < token.version ? asItIs : undefined,
+    });
+}
+class Tested {
+    host;
+    plugin;
+    errors;
+    #store;
+    #collected;
+    constructor(host, store, plugin, errors, collected) {
+        this.host = host;
+        this.#store = store;
+        this.plugin = plugin;
+        this.errors = errors;
+        this.#collected = collected;
+    }
+    contributions(R) {
+        const value = this.#collected.get(R.name);
+        if (value === undefined) {
+            throw new Error(`testPlugin: registry ${R.name} is not collected (nothing contributed to it unserved at load)`);
+        }
+        // The collecting provider composes to its table.
+        return value.value;
+    }
+    unserved() {
+        // The helper's own host: its internal view of the unbound index.
+        return this.host.unservedNames();
+    }
+    root(fn, context, options) {
+        return this.host.root(fn, context, options);
+    }
+    async close(context) {
+        await this.host.close(context);
+        await this.#store.close(context);
+    }
+}
+//# sourceMappingURL=testing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../../src/node/plugins/testing.ts"],"names":[],"mappings":"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","sourcesContent":["// Testing a plugin alone (slice 12 §6, decision \"Testing a plugin alone\"): the plugin built as production builds it,\n// evaluated with the app's real API modules, loaded on an in-memory host (a `:memory:` SQLite store) beside stub facets\n// serving the contracts it uses. The registries it contributes to that nobody serves are served by the helper, which\n// collects their entries for the test; the contracts its requests wait for unserved are listed, so a test knows what\n// to stub. No test-only modes: the host, the build and the evaluation are the ones apps run.\n\nimport { readdir, realpath, stat } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport type { Context } from \"../../context/index.ts\";\nimport type { Address } from \"../../contracts/index.ts\";\nimport type { Principal } from \"../../data/index.ts\";\nimport {\n\ttype Ctx,\n\tcreateHost,\n\tdefineFacet,\n\ttype Host,\n\ttype HostError,\n\ttype PluginFacet,\n\ttype RootOptions,\n} from \"../../host/index.ts\";\nimport type { ChordHost } from \"../../host/internal.ts\";\nimport {\n\tdefineRegistry,\n\ttype Registry,\n\ttype RegistryAccepts,\n\ttype RegistryTable,\n\ttype RegistryValue,\n} from \"../../registries/index.ts\";\nimport { openNodeSqliteDatabase } from \"../../sqlite/node.ts\";\nimport { openStore, type Store, sqliteBackend } from \"../../store/index.ts\";\nimport { type AppApi, buildFacet } from \"./build.ts\";\nimport { discoverPlugins, type Plugin } from \"./discover.ts\";\nimport { evaluateFacet, type HostPackages } from \"./evaluate.ts\";\n\n/** What `testPlugin` takes besides the plugin's directory. */\nexport type TestPluginOptions<P extends Principal = Principal> = {\n\t/** The facet kind to test (`\"worker\"`): the plugin's facet of it is built and loaded. */\n\treadonly kind: string;\n\t/** The real host packages by specifier (the app's API modules: definitions only), as the kind's production host has. */\n\treadonly modules: HostPackages;\n\t/** The app's API, checked as production checks it; required when `modules` hold versioned API modules. */\n\treadonly api?: AppApi;\n\t/**\n\t * The app's facet kinds, for the per-kind file check: by default `kind` and every kind the files of the plugin's root\n\t * name (`contract.web.tsx`: `web`), so the check is active as in production.\n\t */\n\treadonly kinds?: readonly string[];\n\t/** Where the kind's builds run (`node` by default). */\n\treadonly platform?: \"node\" | \"browser\";\n\t/** Facets serving what the plugin uses (other plugins' contracts, core objects, registries it reads), loaded beside it. */\n\treadonly stubs?: readonly PluginFacet<P>[];\n\t/** The host's principal, as the kind's production host has one. */\n\treadonly principal?: P;\n\t/** The host's address, as the kind's production host has one. */\n\treadonly address?: Address;\n};\n\n/** A plugin loaded alone: its live host, the registries collected for it, and what it waits for. */\nexport interface TestedPlugin<P extends Principal = Principal> {\n\t/** The host the plugin and the stubs are loaded on: get its objects, call them, watch their state. */\n\treadonly host: Host<P>;\n\t/** The plugin as discovered. */\n\treadonly plugin: Plugin;\n\t/** What the host reported (`onError`), in order. */\n\treadonly errors: readonly HostError[];\n\t/**\n\t * The current entries of registry `R`, one the plugin contributes to that neither it nor a stub serves (the helper\n\t * serves it, collecting). Throws for a registry it does not collect.\n\t */\n\tcontributions<C>(R: Registry<C, unknown>): RegistryTable<C>;\n\t/** The names of the contracts (and registries) requests on the host wait for unbound because nobody serves them. */\n\tunserved(): readonly string[];\n\t/** `host.root`: runs `fn` as the host's principal or `options.principal`. */\n\troot<T>(fn: (ctx: Ctx<P>) => Promise<T>, context: Context, options?: RootOptions<P>): Promise<T>;\n\t/** Closes the host, then its store. */\n\tclose(context: Context): Promise<void>;\n}\n\n/**\n * Builds the plugin in `dir` as production does (`buildFacet` with the kind's options), evaluates its facet of\n * `options.kind` with `options.modules` and loads it on a new host with an in-memory store, the stubs beside it. Then\n * the registries it contributes to that nobody serves are served by a collecting facet. Rejects when the build, the\n * evaluation or a setup fails (naming it).\n */\nexport async function testPlugin<P extends Principal = Principal>(\n\tdir: string,\n\toptions: TestPluginOptions<P>,\n\tcontext: Context,\n): Promise<TestedPlugin<P>> {\n\tconst { kind, modules } = options;\n\tconst versioned = Object.keys(modules).find((specifier) => VERSIONED.test(specifier));\n\tif (versioned !== undefined && options.api === undefined) {\n\t\tthrow new Error(\n\t\t\t`testPlugin: modules hold the app's versioned API (\"${versioned}\"): pass api, as production does`,\n\t\t);\n\t}\n\tconst real = await realpath(dir);\n\tconst root = await rootOf(real);\n\tconst kinds = options.kinds ?? [kind, ...(await kindsNamedIn(root))];\n\tconst plugin = await pluginIn(real, root, kinds, context);\n\tconst built = await buildFacet(\n\t\tplugin.found,\n\t\tkind,\n\t\t{\n\t\t\thostPackages: Object.keys(modules),\n\t\t\tplatform: options.platform ?? \"node\",\n\t\t\tkinds,\n\t\t\tplugins: plugin.plugins,\n\t\t\t...(options.api === undefined ? {} : { api: options.api }),\n\t\t},\n\t\tcontext,\n\t);\n\tif (built.kind === \"failed\") {\n\t\tthrow new Error(`testPlugin: \"${plugin.found.name}\" failed to build:\\n${built.errors.join(\"\\n\")}`);\n\t}\n\tconst facet = evaluateFacet<P>(built, { hostPackages: modules, plugin: plugin.found });\n\tconst store = await openStore(sqliteBackend(await openNodeSqliteDatabase(\":memory:\")), context);\n\tconst errors: HostError[] = [];\n\tconst host = createHost<P>({\n\t\tstore,\n\t\tonError: (error) => errors.push(error),\n\t\t...(options.principal === undefined ? {} : { principal: options.principal }),\n\t\t...(options.address === undefined ? {} : { address: options.address }),\n\t});\n\ttry {\n\t\tconst facets = [...(options.stubs ?? []), { name: plugin.found.name, facet }];\n\t\tthrowFailed(await host.load(facets, context));\n\t\tconst collected = await collect(host, facets, context);\n\t\treturn new Tested(host, store, plugin.found, errors, collected);\n\t} catch (error) {\n\t\tawait host.close(context);\n\t\tawait store.close(context);\n\t\tthrow error;\n\t}\n}\n\n/** A host package named with a version of an API (`@acme/app/v3`, `@acme/app/v3/worker`). */\nconst VERSIONED = /\\/v\\d+(?:\\/|$)/;\n\n/**\n * The root the plugin at `real` (a directory, or a single-file plugin's file) is in, as production lists it: its\n * directory's parent, or, for a plugin in a checkout of several (a parent with its own `package.json` or `.git`), that\n * checkout's parent.\n */\nasync function rootOf(real: string): Promise<string> {\n\tconst parent = dirname(real);\n\tif ((await stat(real)).isFile()) return parent;\n\tconst checkout = (await exists(join(parent, \"package.json\"))) || (await exists(join(parent, \".git\")));\n\treturn checkout ? dirname(parent) : parent;\n}\n\n/**\n * The kinds files under `root` name (`contract.web.tsx`: `web`; not `*.test.*`, `*.spec.*` or `*.d.ts`), `node_modules`\n * and hidden directories skipped; one walk per `testPlugin` call.\n */\nasync function kindsNamedIn(root: string): Promise<string[]> {\n\tconst kinds = new Set<string>();\n\tconst walk = async (dir: string): Promise<void> => {\n\t\tfor (const entry of await readdir(dir, { withFileTypes: true })) {\n\t\t\tif (entry.name.startsWith(\".\") || entry.name === \"node_modules\") continue;\n\t\t\tif (entry.isDirectory()) await walk(join(dir, entry.name));\n\t\t\tconst parts = entry.name.split(\".\");\n\t\t\tconst segment = parts[parts.length - 2];\n\t\t\t// Tests and declaration files name no kind (`stats.test.ts`, `env.d.ts`).\n\t\t\tconst named = parts.length >= 3 && segment !== \"test\" && segment !== \"spec\" && segment !== \"d\";\n\t\t\tif (entry.isFile() && named) kinds.add(segment!);\n\t\t}\n\t};\n\tawait walk(root);\n\treturn [...kinds];\n}\n\n/** Whether `path` exists. */\nasync function exists(path: string): Promise<boolean> {\n\treturn stat(path).then(\n\t\t() => true,\n\t\t() => false,\n\t);\n}\n\n/** The plugin at `real` (its directory, or a single-file plugin's file), discovered with the others of `root`. */\nasync function pluginIn(\n\treal: string,\n\troot: string,\n\tkinds: readonly string[],\n\tcontext: Context,\n): Promise<{ readonly found: Plugin; readonly plugins: readonly Plugin[] }> {\n\tconst { plugins, problems } = await discoverPlugins([root], { kinds }, context);\n\tconst found = plugins.find((each) =>\n\t\teach.layout === \"directory\" ? each.dir === real : Object.values(each.facets).includes(real),\n\t);\n\tif (found !== undefined) return { found, plugins };\n\tconst problem = problems.find(({ path }) => path === real);\n\tthrow new Error(`testPlugin: ${real} is no plugin${problem === undefined ? \"\" : `: ${problem.error}`}`);\n}\n\n/** Throws the failures of a load: a test of a plugin whose setup (or a stub's) failed has nothing to test. */\nfunction throwFailed(report: {\n\treadonly failed: readonly { readonly plugin: string; readonly error: unknown }[];\n}): void {\n\tconst [first] = report.failed;\n\tif (first === undefined) return;\n\t// The host's errors name their plugin.\n\tconst message = report.failed\n\t\t.map(({ error }) => (error instanceof Error ? error.message : String(error)))\n\t\t.join(\"; \");\n\tthrow new Error(`testPlugin: setup failed: ${message}`, { cause: first.error });\n}\n\n/** The plugin name of the collecting facet, beside the plugin and its stubs. */\nconst COLLECTOR = \"chord.test-plugin-collector\";\n\n/**\n * Serves every registry with contributions on `host` and no provider with a collecting provider (its `compose` is the\n * table; every older version accepted as it is), through a reload adding it beside `facets`; returns each one's value.\n */\nasync function collect<P extends Principal>(\n\thost: Host<P>,\n\tfacets: readonly PluginFacet<P>[],\n\tcontext: Context,\n): Promise<ReadonlyMap<string, RegistryValue<unknown>>> {\n\tconst tokens = new Map<string, Registry<unknown, RegistryTable<unknown>>>();\n\t// A fixed point: an object that goes live once a collected registry is served may contribute to another.\n\tfor (;;) {\n\t\tawait settle(host);\n\t\t// The helper's own host: its internal view of the registries.\n\t\tconst fresh = (host as unknown as ChordHost).undeclaredRegistries().filter(({ name }) => !tokens.has(name));\n\t\tif (fresh.length === 0) break;\n\t\tfor (const { name, version } of fresh) tokens.set(name, defineRegistry(name, { version }));\n\t\tconst served = [...tokens.values()];\n\t\tconst collector = defineFacet<P>((facetHost) => {\n\t\t\tfor (const token of served) facetHost.serve(token, { compose: (table) => table, accepts: olderAs(token) });\n\t\t});\n\t\tthrowFailed(await host.reload([...facets, { name: COLLECTOR, facet: collector }], context));\n\t}\n\tconst values = new Map<string, RegistryValue<unknown>>();\n\tfor (const token of tokens.values()) values.set(token.name, await host.registry(token, context));\n\treturn values;\n}\n\n/**\n * Waits until no activation on `host` is under way (as `load`'s barrier waits for first outcomes), bounded by the host's\n * `readyTimeout`: the objects a reload's publication woke reach their outcome, slow openers included.\n */\nasync function settle<P extends Principal>(host: Host<P>): Promise<void> {\n\t// The helper's own host: its internal view of its objects and timeouts.\n\tconst chord = host as unknown as ChordHost;\n\tconst deadline = Date.now() + chord.timeouts.ready;\n\t// The woken requests check again in promise jobs and I/O callbacks: let those run before counting.\n\tdo {\n\t\tfor (let turn = 0; turn < 3; turn++) await new Promise((resolve) => setImmediate(resolve));\n\t\tif (chord.activationsUnderWay() === 0) return;\n\t\tawait new Promise((resolve) => setTimeout(resolve, 5));\n\t} while (Date.now() < deadline);\n}\n\n/** Every older version's contributions and readers as they are: made per version looked up, not per version below. */\nfunction olderAs(token: Registry<unknown, RegistryTable<unknown>>): RegistryAccepts<unknown, RegistryTable<unknown>> {\n\tconst asItIs = { contribution: (old: never) => old, value: (table: unknown) => table };\n\t// The kernel only looks adapters up by version (`accepts[version]`).\n\treturn new Proxy(\n\t\t{},\n\t\t{\n\t\t\tget: (_target, key) =>\n\t\t\t\ttypeof key === \"string\" && /^\\d+$/.test(key) && Number(key) < token.version ? asItIs : undefined,\n\t\t},\n\t) as RegistryAccepts<unknown, RegistryTable<unknown>>;\n}\n\nclass Tested<P extends Principal> implements TestedPlugin<P> {\n\treadonly host: Host<P>;\n\treadonly plugin: Plugin;\n\treadonly errors: readonly HostError[];\n\treadonly #store: Store;\n\treadonly #collected: ReadonlyMap<string, RegistryValue<unknown>>;\n\n\tconstructor(\n\t\thost: Host<P>,\n\t\tstore: Store,\n\t\tplugin: Plugin,\n\t\terrors: readonly HostError[],\n\t\tcollected: ReadonlyMap<string, RegistryValue<unknown>>,\n\t) {\n\t\tthis.host = host;\n\t\tthis.#store = store;\n\t\tthis.plugin = plugin;\n\t\tthis.errors = errors;\n\t\tthis.#collected = collected;\n\t}\n\n\tcontributions<C>(R: Registry<C, unknown>): RegistryTable<C> {\n\t\tconst value = this.#collected.get(R.name);\n\t\tif (value === undefined) {\n\t\t\tthrow new Error(\n\t\t\t\t`testPlugin: registry ${R.name} is not collected (nothing contributed to it unserved at load)`,\n\t\t\t);\n\t\t}\n\t\t// The collecting provider composes to its table.\n\t\treturn value.value as RegistryTable<C>;\n\t}\n\n\tunserved(): readonly string[] {\n\t\t// The helper's own host: its internal view of the unbound index.\n\t\treturn (this.host as unknown as ChordHost).unservedNames();\n\t}\n\n\troot<T>(fn: (ctx: Ctx<P>) => Promise<T>, context: Context, options?: RootOptions<P>): Promise<T> {\n\t\treturn this.host.root(fn, context, options);\n\t}\n\n\tasync close(context: Context): Promise<void> {\n\t\tawait this.host.close(context);\n\t\tawait this.#store.close(context);\n\t}\n}\n"]}

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

@@ -0,0 +1,69 @@
+import { type Context } from "../../context/index.ts";
+import type { JsonValue } from "../../json.ts";
+import { type Batch, Source } from "../../state/internal.ts";
+import { type BaseInputs } from "./base-inputs.ts";
+import { type BuiltFacet } from "./build.ts";
+import { type Discovery } from "./discover.ts";
+/** The marks: plugins to rebuild, plugins to install, whether to discover again, whether base code changed. */
+export type PluginsState = {
+    readonly dirty: readonly string[];
+    readonly install: readonly string[];
+    readonly set: boolean;
+    readonly base: boolean;
+};
+/** The generation of each dirty plugin's latest change when a build started: what its rollout may clear. */
+export type MarkSnapshot = {
+    readonly plugins: ReadonlyMap<string, number>;
+};
+/** The generations of the latest change of the plugin set and of a `package.json` when a discovery started. */
+export type DiscoverySnapshot = {
+    readonly set: number;
+    readonly manifest: number;
+};
+/** What the watcher watches and how it reports: the roots, the base code, the facet kinds, a failure to watch. */
+export type WatcherOptions = {
+    readonly roots: readonly string[];
+    /** The server's own base code, files and directories: hashed when the watcher starts, the first base record. */
+    readonly base: readonly string[];
+    readonly kinds: readonly string[];
+    /** The watcher cannot watch (the system's limit): reported once, after which the app builds on demand. */
+    readonly failed: (error: unknown) => void;
+};
+/**
+ * The watcher and the marks (`state`), a JSON watchable published at most once per microtask turn with changes. It
+ * marks for the plugins of the last discovery (`know`) and the files their last builds read (`used`).
+ */
+export declare class PluginWatcher extends Source {
+    #private;
+    constructor(options: WatcherOptions, batch: Batch);
+    get value(): JsonValue;
+    deliver(context: Context): void;
+    /** Whether the next build discovers again: the plugin set or a plugin's `package.json` changed. */
+    get needsDiscovery(): boolean;
+    /** What a discovery that starts now has seen. */
+    discoverySnapshot(): DiscoverySnapshot;
+    /** The plugins discovery found: marks are for them (a removed one's install clears); the changes it had seen clear. */
+    know(discovery: Discovery, seen: DiscoverySnapshot): void;
+    /** What `built` facets read: a later change of one of these files dirties their plugins. */
+    used(built: readonly BuiltFacet[]): void;
+    /** The marks a build of `names` starts from: each one's latest change. */
+    snapshot(names: Iterable<string>): MarkSnapshot;
+    /** `names` were applied everywhere: their marks clear unless a change came after `snapshot`. */
+    applied(names: Iterable<string>, snapshot: MarkSnapshot): void;
+    /** Plugin `name`'s dependencies were installed: its install mark clears and it is dirty (its packages changed). */
+    installed(name: string): void;
+    /** Plugins were installed into a root: discovery runs at the next build (without waiting for the watch's events). */
+    added(): void;
+    /**
+     * Adds the record of a running base artifact (a base bundle's `inputs`): `base` is set while one of its files differs
+     * from it. Each file's directory is watched alone (not its tree), then every file is compared once (an edit since the
+     * build has no later event); files under ignored directories are skipped. Settles once those first comparisons did:
+     * `base` then knows the record.
+     */
+    recordBase(inputs: BaseInputs): Promise<void>;
+    /** Marks what a change of the file or directory at `path` (absolute) asks for. */
+    mark(path: string): void;
+    /** Stops watching. */
+    close(): void;
+}
+//# sourceMappingURL=watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../../src/node/plugins/watcher.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAsB,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,KAAK,UAAU,EAAU,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,KAAK,SAAS,EAA4C,MAAM,eAAe,CAAC;AAEzF,+GAA+G;AAC/G,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,4GAA4G;AAC5G,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAE7E,+GAA+G;AAC/G,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,kHAAkH;AAClH,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,gHAAgH;IAChH,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,0GAA0G;IAC1G,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C,CAAC;AAQF;;;GAGG;AACH,qBAAa,aAAc,SAAQ,MAAM;;IAoDxC,YAAY,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAShD;IAED,IAAI,KAAK,IAAI,SAAS,CAQrB;IAED,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAG9B;IAED,mGAAmG;IACnG,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,iDAAiD;IACjD,iBAAiB,IAAI,iBAAiB,CAErC;IAED,uHAAuH;IACvH,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CA4BxD;IAED,4FAA4F;IAC5F,IAAI,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAMvC;IAED,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,YAAY,CAI9C;IAED,gGAAgG;IAChG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAM7D;IAED,mHAAmH;IACnH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI5B;IAED,qHAAqH;IACrH,KAAK,IAAI,IAAI,CAGZ;IAED;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5C;IAED,kFAAkF;IAClF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQvB;IAED,sBAAsB;IACtB,KAAK,IAAI,IAAI,CAOZ;CA4RD"}