@earendil-works/chord 1.4.0 → 1.5.1

package/dist/node/plugins/discover.js

@@ -0,0 +1,369 @@
+// Discovery (slice 7c §1, slice 12 §2, §4): the plugins under the app's roots, found by listing each root and reading
+// only `package.json` files. Each directory at a root's top is a package: the plugins its `chord.plugins` manifest
+// lists (decision "`chord.plugins` is a package's manifest of plugins"), else by convention itself when its top has
+// facet files, else its subfolders with a `package.json` (a checkout of several), else itself (contracts only). Files
+// named `<name>.<kind>.<ext>` at a root's top are single-file plugins grouped by name. Facet files are the ones named
+// after the app's facet kinds. Nothing parses or runs plugin code.
+import { readdir, readFile, realpath, stat } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { isPluginName } from "../../host/staging.js";
+/**
+ * Lists every root: its packages' plugins (by their manifests or by convention) and its single-file plugins. Reported,
+ * not plugins: a directory without any `package.json`, an invalid one, name or manifest, two files of one facet kind,
+ * a name an earlier root (or an earlier entry of the same root) has already; a single-file plugin named like a
+ * directory plugin of its root loses to it; a required root that does not exist. A missing root that is not required
+ * is empty. Plugins sorted by name.
+ */
+export async function discoverPlugins(roots, options, context) {
+    const plugins = new Map();
+    const problems = [];
+    for (const each of roots) {
+        const { path, required } = typeof each === "string" ? { path: each, required: false } : each;
+        const listed = await listRoot(path, required === true, options.kinds, context);
+        problems.push(...listed.problems);
+        for (const plugin of listed.plugins) {
+            const other = plugins.get(plugin.name);
+            if (other !== undefined) {
+                const error = `plugin "${plugin.name}" is in ${other.dir} already`;
+                problems.push({ path: pathOf(plugin), error, root: plugin.root, required: plugin.required });
+                continue;
+            }
+            plugins.set(plugin.name, plugin);
+        }
+    }
+    const sorted = [...plugins.values()].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    return { plugins: sorted, problems };
+}
+/**
+ * The plugins of the package in `dir` (its manifest's folders, or by convention) and its problems, recorded as of
+ * `at.root`: what `installPlugin` checks a package with before it moves it into a root.
+ */
+export async function discoverPackage(dir, at, context) {
+    context.abortSignal?.throwIfAborted();
+    const plugins = [];
+    const problems = [];
+    for (const each of await packageAt(await realpath(dir), at)) {
+        if (each.kind === "plugin")
+            plugins.push(each.plugin);
+        else
+            problems.push({ path: each.path, error: each.error, root: at.root, required: at.required });
+    }
+    return { plugins, problems };
+}
+/** Whether two records of one plugin name the same directory, layout and facet files (else its code moved). */
+export function sameFiles(before, after) {
+    const files = (plugin) => JSON.stringify(Object.entries(plugin.facets).sort());
+    return before.dir === after.dir && before.layout === after.layout && files(before) === files(after);
+}
+/** The facet files' extensions, in no order of preference: two files of one kind are reported. */
+export const FACET_EXTENSIONS = [".ts", ".tsx", ".js", ".mjs"];
+/** The plugins of one root, directory plugins first, and its problems. */
+async function listRoot(path, required, kinds, context) {
+    const entries = await entriesOf(path);
+    if (entries === undefined) {
+        if (!required)
+            return { plugins: [], problems: [] };
+        return { plugins: [], problems: [{ path, error: "the required root does not exist", root: path, required }] };
+    }
+    const root = await realpath(path);
+    const at = { root, required, kinds };
+    const plugins = [];
+    const problems = [];
+    for (const dir of entries.dirs) {
+        const found = await discoverPackage(dir, at, context);
+        plugins.push(...found.plugins);
+        problems.push(...found.problems);
+    }
+    const files = singleFilePlugins(entries.files, at);
+    problems.push(...files.problems);
+    for (const plugin of files.plugins) {
+        const directory = plugins.find((each) => each.name === plugin.name);
+        if (directory === undefined)
+            plugins.push(plugin);
+        else {
+            const error = `plugin "${plugin.name}" is in ${directory.dir} already`;
+            problems.push({ path: pathOf(plugin), error, root, required });
+        }
+    }
+    return { plugins, problems };
+}
+/** The plugin's path to report: its directory, or a single-file plugin's first facet file. */
+function pathOf(plugin) {
+    return plugin.layout === "directory" ? plugin.dir : Object.values(plugin.facets)[0];
+}
+/**
+ * The directories (by real path) and plain files directly under `path`, in name order; `undefined` when it does not
+ * exist. Hidden entries and `node_modules` are not plugins.
+ */
+async function entriesOf(path) {
+    let names;
+    try {
+        names = (await readdir(path)).sort();
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+    const dirs = [];
+    const files = [];
+    for (const name of names) {
+        if (name.startsWith(".") || name === "node_modules")
+            continue;
+        const entry = join(path, name);
+        // `stat` follows a symlink: a linked plugin directory is listed by its real path.
+        const info = await stat(entry).catch(() => undefined);
+        if (info?.isDirectory() === true)
+            dirs.push(await realpath(entry));
+        else if (info?.isFile() === true)
+            files.push(name);
+    }
+    return { dirs, files };
+}
+/** The `package.json` of `dir`. */
+async function manifestOf(dir) {
+    try {
+        return { kind: "read", value: JSON.parse(await readFile(join(dir, "package.json"), "utf8")) };
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return { kind: "missing" };
+        return { kind: "invalid", error: `package.json: ${error.message}` };
+    }
+}
+/**
+ * The plugins of the package in `dir` (a real path): its manifest's folders; without a manifest itself when its top
+ * has facet files, else its subfolders with a `package.json`, else itself; without a `package.json` its subfolders
+ * with one (a checkout of several), else a problem.
+ */
+async function packageAt(dir, at) {
+    const manifest = await manifestOf(dir);
+    if (manifest.kind === "invalid")
+        return [{ kind: "problem", path: dir, error: manifest.error }];
+    const value = manifest.kind === "read" ? manifest.value : null;
+    const listed = value?.chord?.plugins;
+    if (listed !== undefined)
+        return manifestPlugins(dir, listed, at);
+    if (manifest.kind === "read" && (await hasFacetFile(dir, at.kinds)))
+        return [await pluginAt(dir, manifest, at)];
+    const inner = [];
+    for (const sub of (await entriesOf(dir))?.dirs ?? []) {
+        const found = await manifestOf(sub);
+        if (found.kind !== "missing")
+            inner.push(await pluginAt(sub, found, at));
+    }
+    if (inner.length > 0)
+        return inner;
+    if (manifest.kind === "read")
+        return [await pluginAt(dir, manifest, at)];
+    return [{ kind: "problem", path: dir, error: "no package.json" }];
+}
+/** Whether `dir`'s top has a facet file of one of `kinds`. */
+async function hasFacetFile(dir, kinds) {
+    const files = new Set(await readdir(dir));
+    return kinds.some((kind) => FACET_EXTENSIONS.some((extension) => files.has(`${kind}${extension}`)));
+}
+/**
+ * The plugins `chord.plugins` (`listed`: folders of the package, as paths, globs and `!` exclusions, as pi's
+ * `pi.extensions`) of the package in `dir` names: each a folder with a `package.json` (the package itself when listed
+ * as `.`). A manifest that is no list of strings, an entry or a link leaving the package, a listed path that is no
+ * directory, and a listing of nothing are problems.
+ */
+async function manifestPlugins(dir, listed, at) {
+    const problem = (error) => [
+        { kind: "problem", path: dir, error: `package.json: chord.plugins ${error}` },
+    ];
+    if (!Array.isArray(listed) || !listed.every((each) => typeof each === "string")) {
+        return problem("is not a list of plugin folders");
+    }
+    const entries = listed;
+    const excludes = entries.filter((each) => each.startsWith("!")).map((each) => posix(each.slice(1)));
+    const folders = new Set();
+    for (const entry of entries.filter((each) => !each.startsWith("!"))) {
+        const matched = /[*?]/.test(entry) ? await globFolders(dir, posix(entry)) : [resolve(dir, entry)];
+        for (const folder of matched) {
+            const rest = relative(dir, folder);
+            if (rest.startsWith("..") || isAbsolute(rest))
+                return problem(`"${entry}" leaves the package`);
+            if (!excludes.some((exclude) => matchesGlob(posix(rest) || ".", exclude)))
+                folders.add(folder);
+        }
+    }
+    // One plugin inside another's directory would make the outer one's imports of it its own files, not copies.
+    const sorted = [...folders].sort();
+    for (const inner of sorted) {
+        const outer = sorted.find((folder) => insideDir(folder, inner));
+        if (outer !== undefined) {
+            const listed = (folder) => posix(relative(dir, folder)) || ".";
+            return problem(`lists "${listed(inner)}" inside the listed "${listed(outer)}"`);
+        }
+    }
+    if (folders.size === 0)
+        return problem("lists no plugin folder");
+    const found = [];
+    for (const folder of sorted) {
+        const info = await stat(folder).catch(() => undefined);
+        if (info?.isDirectory() !== true) {
+            found.push({ kind: "problem", path: folder, error: "listed in chord.plugins, not a directory" });
+            continue;
+        }
+        const real = await realpath(folder);
+        const rest = relative(dir, real);
+        if (rest.startsWith("..") || isAbsolute(rest)) {
+            found.push({ kind: "problem", path: folder, error: "listed in chord.plugins, links out of the package" });
+            continue;
+        }
+        found.push(await pluginAt(real, await manifestOf(real), at));
+    }
+    return found;
+}
+/** `path` with `/` separators and no leading `./` (as manifests and globs write paths). */
+function posix(path) {
+    return path.split(sep).join("/").replace(/^\.\//, "");
+}
+/** Whether `path` lies inside directory `dir` (both absolute). */
+function insideDir(dir, path) {
+    const rest = relative(dir, path);
+    return rest !== "" && !rest.startsWith("..") && !isAbsolute(rest);
+}
+/**
+ * Whether the `/`-separated `path` matches the glob `pattern`: `*` and `?` within one segment, `**` across segments
+ * (`node:path`'s `matchesGlob` is experimental in Node 22, Chord's floor); anything else literal.
+ */
+function matchesGlob(path, pattern) {
+    let source = "";
+    for (let at = 0; at < pattern.length; at++) {
+        const char = pattern[at];
+        if (pattern.startsWith("**/", at)) {
+            source += "(?:.*/)?";
+            at += 2;
+        }
+        else if (pattern.startsWith("**", at)) {
+            source += ".*";
+            at += 1;
+        }
+        else if (char === "*")
+            source += "[^/]*";
+        else if (char === "?")
+            source += "[^/]";
+        else
+            source += char.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+    }
+    return new RegExp(`^${source}$`).test(path);
+}
+/** How deep a glob of `chord.plugins` looks for folders. */
+const GLOB_DEPTH = 6;
+/** The folders under `dir` (hidden ones and `node_modules` skipped, `GLOB_DEPTH` deep) whose path matches `pattern`. */
+async function globFolders(dir, pattern) {
+    const found = [];
+    const walk = async (at, depth) => {
+        if (depth > GLOB_DEPTH)
+            return;
+        let entries;
+        try {
+            entries = await readdir(at, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory() || entry.name.startsWith(".") || entry.name === "node_modules")
+                continue;
+            const path = join(at, entry.name);
+            if (matchesGlob(posix(relative(dir, path)), pattern))
+                found.push(path);
+            await walk(path, depth + 1);
+        }
+    };
+    await walk(dir, 1);
+    return found;
+}
+/** The plugin in `dir` (its real path) with its `package.json` read as `manifest`, or why it is none. */
+async function pluginAt(dir, manifest, at) {
+    const problem = (error) => ({ kind: "problem", path: dir, error });
+    if (manifest.kind === "missing")
+        return problem("no package.json");
+    if (manifest.kind === "invalid")
+        return problem(manifest.error);
+    // A trust boundary: a plugin's own `package.json`.
+    const { name, dependencies, chord } = (manifest.value ?? {});
+    if (typeof name !== "string" || !isPluginName(name)) {
+        return problem(`package.json: ${JSON.stringify(name)} is not a valid plugin name`);
+    }
+    const external = chord?.external ?? [];
+    if (!Array.isArray(external) || !external.every((each) => typeof each === "string")) {
+        return problem("package.json: chord.external is not a list of package names");
+    }
+    const files = new Set(await readdir(dir));
+    const facets = {};
+    for (const kind of at.kinds) {
+        const named = FACET_EXTENSIONS.map((extension) => `${kind}${extension}`).filter((file) => files.has(file));
+        if (named.length > 1)
+            return problem(`two ${kind} facets: ${named.join(", ")}`);
+        if (named.length === 1)
+            facets[kind] = join(dir, named[0]);
+    }
+    const packages = typeof dependencies === "object" && dependencies !== null ? Object.keys(dependencies) : [];
+    const plugin = {
+        name,
+        dir,
+        root: at.root,
+        required: at.required,
+        layout: "directory",
+        facets,
+        dependencies: packages,
+        external,
+    };
+    return { kind: "plugin", plugin };
+}
+/**
+ * The single-file plugins among a root's top files: `<name>.<kind>.<ext>` with `<kind>` one of the app's kinds and
+ * `<ext>` a facet extension, grouped by `<name>` (an unscoped plugin name, else reported; two files of one kind
+ * reported). Other files are not plugins.
+ */
+function singleFilePlugins(files, at) {
+    const groups = new Map();
+    for (const file of files) {
+        const parsed = singleFileName(file, at.kinds);
+        if (parsed === undefined)
+            continue;
+        const kinds = groups.get(parsed.name) ?? new Map();
+        groups.set(parsed.name, kinds);
+        kinds.set(parsed.kind, [...(kinds.get(parsed.kind) ?? []), file]);
+    }
+    const plugins = [];
+    const problems = [];
+    for (const [name, kinds] of groups) {
+        const first = join(at.root, [...kinds.values()][0][0]);
+        if (!isPluginName(name) || name.startsWith("@")) {
+            problems.push({ path: first, error: `"${name}" is not a valid unscoped plugin name`, ...rootOf(at) });
+            continue;
+        }
+        const twice = [...kinds].find(([, named]) => named.length > 1);
+        if (twice !== undefined) {
+            problems.push({ path: first, error: `two ${twice[0]} facets: ${twice[1].join(", ")}`, ...rootOf(at) });
+            continue;
+        }
+        const facets = Object.fromEntries([...kinds].map(([kind, [file]]) => [kind, join(at.root, file)]));
+        const record = { root: at.root, required: at.required, dependencies: [], external: [] };
+        plugins.push({ name, dir: at.root, layout: "file", facets, ...record });
+    }
+    return { plugins, problems };
+}
+/** The plugin name and kind of a single-file plugin's file name (`hello.server.ts`), or `undefined` for another file. */
+function singleFileName(file, kinds) {
+    const extension = FACET_EXTENSIONS.find((each) => file.endsWith(each));
+    if (extension === undefined)
+        return undefined;
+    const stem = file.slice(0, -extension.length);
+    const dot = stem.lastIndexOf(".");
+    if (dot <= 0)
+        return undefined;
+    const kind = stem.slice(dot + 1);
+    return kinds.includes(kind) ? { name: stem.slice(0, dot), kind } : undefined;
+}
+/** A problem's root fields for a root's context. */
+function rootOf(at) {
+    return { root: at.root, required: at.required };
+}
+//# sourceMappingURL=discover.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../../src/node/plugins/discover.ts"],"names":[],"mappings":"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","sourcesContent":["// Discovery (slice 7c §1, slice 12 §2, §4): the plugins under the app's roots, found by listing each root and reading\n// only `package.json` files. Each directory at a root's top is a package: the plugins its `chord.plugins` manifest\n// lists (decision \"`chord.plugins` is a package's manifest of plugins\"), else by convention itself when its top has\n// facet files, else its subfolders with a `package.json` (a checkout of several), else itself (contracts only). Files\n// named `<name>.<kind>.<ext>` at a root's top are single-file plugins grouped by name. Facet files are the ones named\n// after the app's facet kinds. Nothing parses or runs plugin code.\n\nimport type { Dirent } from \"node:fs\";\nimport { readdir, readFile, realpath, stat } from \"node:fs/promises\";\nimport { isAbsolute, join, relative, resolve, sep } from \"node:path\";\nimport type { Context } from \"../../context/index.ts\";\nimport { isPluginName } from \"../../host/staging.ts\";\n\n/** A root plugins are listed in: a path, or a path marked `required` (a plugin of it failing at `load` is fatal). */\nexport type PluginRoot = string | { readonly path: string; readonly required?: boolean };\n\n/** A plugin on disk: its name, its real directory, its root, its facet files and npm packages. Plain data. */\nexport type Plugin = {\n\treadonly name: string;\n\t/** Its directory's real path (symlinks followed); a single-file plugin's is its root's. */\n\treadonly dir: string;\n\t/** The real path of the root it was found in: relative imports between plugins stay within it. */\n\treadonly root: string;\n\t/** Whether its root is required: its build, evaluation or setup failing at `load` rejects the load. */\n\treadonly required: boolean;\n\t/** A directory with a `package.json`, or files at a root's top (`hello.server.ts`): host packages only, no files. */\n\treadonly layout: \"directory\" | \"file\";\n\t/** Its facet files by kind, absolute paths; none for a contracts-only plugin. */\n\treadonly facets: Readonly<Record<string, string>>;\n\t/** The packages in its `dependencies`: bundled into the facets that import them. */\n\treadonly dependencies: readonly string[];\n\t/** The packages in its `chord.external`: kept external in Node builds, loaded from its `node_modules`. */\n\treadonly external: readonly string[];\n};\n\n/**\n * A root, directory or file that is not a plugin, a plugin left out, or a required root missing, and why; with the\n * root it is in (a required root's problems make `plugins.load` reject).\n */\nexport type DiscoveryProblem = {\n\treadonly path: string;\n\treadonly error: string;\n\treadonly root: string;\n\treadonly required: boolean;\n};\n\n/** What discovery found: the plugins by name, and the paths it reported. */\nexport type Discovery = { readonly plugins: readonly Plugin[]; readonly problems: readonly DiscoveryProblem[] };\n\n/** What discovery takes besides the roots: the app's facet kinds (`[\"server\", \"worker\", \"web\", \"tui\"]`). */\nexport type DiscoveryOptions = { readonly kinds: readonly string[] };\n\n/**\n * Lists every root: its packages' plugins (by their manifests or by convention) and its single-file plugins. Reported,\n * not plugins: a directory without any `package.json`, an invalid one, name or manifest, two files of one facet kind,\n * a name an earlier root (or an earlier entry of the same root) has already; a single-file plugin named like a\n * directory plugin of its root loses to it; a required root that does not exist. A missing root that is not required\n * is empty. Plugins sorted by name.\n */\nexport async function discoverPlugins(\n\troots: readonly PluginRoot[],\n\toptions: DiscoveryOptions,\n\tcontext: Context,\n): Promise<Discovery> {\n\tconst plugins = new Map<string, Plugin>();\n\tconst problems: DiscoveryProblem[] = [];\n\tfor (const each of roots) {\n\t\tconst { path, required } = typeof each === \"string\" ? { path: each, required: false } : each;\n\t\tconst listed = await listRoot(path, required === true, options.kinds, context);\n\t\tproblems.push(...listed.problems);\n\t\tfor (const plugin of listed.plugins) {\n\t\t\tconst other = plugins.get(plugin.name);\n\t\t\tif (other !== undefined) {\n\t\t\t\tconst error = `plugin \"${plugin.name}\" is in ${other.dir} already`;\n\t\t\t\tproblems.push({ path: pathOf(plugin), error, root: plugin.root, required: plugin.required });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tplugins.set(plugin.name, plugin);\n\t\t}\n\t}\n\tconst sorted = [...plugins.values()].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));\n\treturn { plugins: sorted, problems };\n}\n\n/**\n * The plugins of the package in `dir` (its manifest's folders, or by convention) and its problems, recorded as of\n * `at.root`: what `installPlugin` checks a package with before it moves it into a root.\n */\nexport async function discoverPackage(dir: string, at: RootContext, context: Context): Promise<Discovery> {\n\tcontext.abortSignal?.throwIfAborted();\n\tconst plugins: Plugin[] = [];\n\tconst problems: DiscoveryProblem[] = [];\n\tfor (const each of await packageAt(await realpath(dir), at)) {\n\t\tif (each.kind === \"plugin\") plugins.push(each.plugin);\n\t\telse problems.push({ path: each.path, error: each.error, root: at.root, required: at.required });\n\t}\n\treturn { plugins, problems };\n}\n\n/** Where a root's plugins are listed from, and what each records: its root's real path, requiredness, the kinds. */\nexport type RootContext = { readonly root: string; readonly required: boolean; readonly kinds: readonly string[] };\n\n/** Whether two records of one plugin name the same directory, layout and facet files (else its code moved). */\nexport function sameFiles(before: Plugin, after: Plugin): boolean {\n\tconst files = (plugin: Plugin) => JSON.stringify(Object.entries(plugin.facets).sort());\n\treturn before.dir === after.dir && before.layout === after.layout && files(before) === files(after);\n}\n\n/** The facet files' extensions, in no order of preference: two files of one kind are reported. */\nexport const FACET_EXTENSIONS: readonly string[] = [\".ts\", \".tsx\", \".js\", \".mjs\"];\n\n/** The plugins of one root, directory plugins first, and its problems. */\nasync function listRoot(\n\tpath: string,\n\trequired: boolean,\n\tkinds: readonly string[],\n\tcontext: Context,\n): Promise<Discovery> {\n\tconst entries = await entriesOf(path);\n\tif (entries === undefined) {\n\t\tif (!required) return { plugins: [], problems: [] };\n\t\treturn { plugins: [], problems: [{ path, error: \"the required root does not exist\", root: path, required }] };\n\t}\n\tconst root = await realpath(path);\n\tconst at = { root, required, kinds };\n\tconst plugins: Plugin[] = [];\n\tconst problems: DiscoveryProblem[] = [];\n\tfor (const dir of entries.dirs) {\n\t\tconst found = await discoverPackage(dir, at, context);\n\t\tplugins.push(...found.plugins);\n\t\tproblems.push(...found.problems);\n\t}\n\tconst files = singleFilePlugins(entries.files, at);\n\tproblems.push(...files.problems);\n\tfor (const plugin of files.plugins) {\n\t\tconst directory = plugins.find((each) => each.name === plugin.name);\n\t\tif (directory === undefined) plugins.push(plugin);\n\t\telse {\n\t\t\tconst error = `plugin \"${plugin.name}\" is in ${directory.dir} already`;\n\t\t\tproblems.push({ path: pathOf(plugin), error, root, required });\n\t\t}\n\t}\n\treturn { plugins, problems };\n}\n\n/** A plugin found, or why a directory is none. */\ntype Found =\n\t| { readonly kind: \"plugin\"; readonly plugin: Plugin }\n\t| { readonly kind: \"problem\"; readonly path: string; readonly error: string };\n\n/** The plugin's path to report: its directory, or a single-file plugin's first facet file. */\nfunction pathOf(plugin: Plugin): string {\n\treturn plugin.layout === \"directory\" ? plugin.dir : Object.values(plugin.facets)[0]!;\n}\n\n/**\n * The directories (by real path) and plain files directly under `path`, in name order; `undefined` when it does not\n * exist. Hidden entries and `node_modules` are not plugins.\n */\nasync function entriesOf(path: string): Promise<{ dirs: string[]; files: string[] } | undefined> {\n\tlet names: string[];\n\ttry {\n\t\tnames = (await readdir(path)).sort();\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n\t\tthrow error;\n\t}\n\tconst dirs: string[] = [];\n\tconst files: string[] = [];\n\tfor (const name of names) {\n\t\tif (name.startsWith(\".\") || name === \"node_modules\") continue;\n\t\tconst entry = join(path, name);\n\t\t// `stat` follows a symlink: a linked plugin directory is listed by its real path.\n\t\tconst info = await stat(entry).catch(() => undefined);\n\t\tif (info?.isDirectory() === true) dirs.push(await realpath(entry));\n\t\telse if (info?.isFile() === true) files.push(name);\n\t}\n\treturn { dirs, files };\n}\n\n/** A package's `package.json`: missing, unreadable (why), or its value (a trust boundary, checked where it is read). */\ntype Manifest =\n\t| { readonly kind: \"missing\" }\n\t| { readonly kind: \"invalid\"; readonly error: string }\n\t| { readonly kind: \"read\"; readonly value: unknown };\n\n/** The `package.json` of `dir`. */\nasync function manifestOf(dir: string): Promise<Manifest> {\n\ttry {\n\t\treturn { kind: \"read\", value: JSON.parse(await readFile(join(dir, \"package.json\"), \"utf8\")) };\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return { kind: \"missing\" };\n\t\treturn { kind: \"invalid\", error: `package.json: ${(error as Error).message}` };\n\t}\n}\n\n/**\n * The plugins of the package in `dir` (a real path): its manifest's folders; without a manifest itself when its top\n * has facet files, else its subfolders with a `package.json`, else itself; without a `package.json` its subfolders\n * with one (a checkout of several), else a problem.\n */\nasync function packageAt(dir: string, at: RootContext): Promise<Found[]> {\n\tconst manifest = await manifestOf(dir);\n\tif (manifest.kind === \"invalid\") return [{ kind: \"problem\", path: dir, error: manifest.error }];\n\tconst value = manifest.kind === \"read\" ? (manifest.value as { chord?: { plugins?: unknown } } | null) : null;\n\tconst listed = value?.chord?.plugins;\n\tif (listed !== undefined) return manifestPlugins(dir, listed, at);\n\tif (manifest.kind === \"read\" && (await hasFacetFile(dir, at.kinds))) return [await pluginAt(dir, manifest, at)];\n\tconst inner: Found[] = [];\n\tfor (const sub of (await entriesOf(dir))?.dirs ?? []) {\n\t\tconst found = await manifestOf(sub);\n\t\tif (found.kind !== \"missing\") inner.push(await pluginAt(sub, found, at));\n\t}\n\tif (inner.length > 0) return inner;\n\tif (manifest.kind === \"read\") return [await pluginAt(dir, manifest, at)];\n\treturn [{ kind: \"problem\", path: dir, error: \"no package.json\" }];\n}\n\n/** Whether `dir`'s top has a facet file of one of `kinds`. */\nasync function hasFacetFile(dir: string, kinds: readonly string[]): Promise<boolean> {\n\tconst files = new Set(await readdir(dir));\n\treturn kinds.some((kind) => FACET_EXTENSIONS.some((extension) => files.has(`${kind}${extension}`)));\n}\n\n/**\n * The plugins `chord.plugins` (`listed`: folders of the package, as paths, globs and `!` exclusions, as pi's\n * `pi.extensions`) of the package in `dir` names: each a folder with a `package.json` (the package itself when listed\n * as `.`). A manifest that is no list of strings, an entry or a link leaving the package, a listed path that is no\n * directory, and a listing of nothing are problems.\n */\nasync function manifestPlugins(dir: string, listed: unknown, at: RootContext): Promise<Found[]> {\n\tconst problem = (error: string): Found[] => [\n\t\t{ kind: \"problem\", path: dir, error: `package.json: chord.plugins ${error}` },\n\t];\n\tif (!Array.isArray(listed) || !listed.every((each) => typeof each === \"string\")) {\n\t\treturn problem(\"is not a list of plugin folders\");\n\t}\n\tconst entries = listed as readonly string[];\n\tconst excludes = entries.filter((each) => each.startsWith(\"!\")).map((each) => posix(each.slice(1)));\n\tconst folders = new Set<string>();\n\tfor (const entry of entries.filter((each) => !each.startsWith(\"!\"))) {\n\t\tconst matched = /[*?]/.test(entry) ? await globFolders(dir, posix(entry)) : [resolve(dir, entry)];\n\t\tfor (const folder of matched) {\n\t\t\tconst rest = relative(dir, folder);\n\t\t\tif (rest.startsWith(\"..\") || isAbsolute(rest)) return problem(`\"${entry}\" leaves the package`);\n\t\t\tif (!excludes.some((exclude) => matchesGlob(posix(rest) || \".\", exclude))) folders.add(folder);\n\t\t}\n\t}\n\t// One plugin inside another's directory would make the outer one's imports of it its own files, not copies.\n\tconst sorted = [...folders].sort();\n\tfor (const inner of sorted) {\n\t\tconst outer = sorted.find((folder) => insideDir(folder, inner));\n\t\tif (outer !== undefined) {\n\t\t\tconst listed = (folder: string) => posix(relative(dir, folder)) || \".\";\n\t\t\treturn problem(`lists \"${listed(inner)}\" inside the listed \"${listed(outer)}\"`);\n\t\t}\n\t}\n\tif (folders.size === 0) return problem(\"lists no plugin folder\");\n\tconst found: Found[] = [];\n\tfor (const folder of sorted) {\n\t\tconst info = await stat(folder).catch(() => undefined);\n\t\tif (info?.isDirectory() !== true) {\n\t\t\tfound.push({ kind: \"problem\", path: folder, error: \"listed in chord.plugins, not a directory\" });\n\t\t\tcontinue;\n\t\t}\n\t\tconst real = await realpath(folder);\n\t\tconst rest = relative(dir, real);\n\t\tif (rest.startsWith(\"..\") || isAbsolute(rest)) {\n\t\t\tfound.push({ kind: \"problem\", path: folder, error: \"listed in chord.plugins, links out of the package\" });\n\t\t\tcontinue;\n\t\t}\n\t\tfound.push(await pluginAt(real, await manifestOf(real), at));\n\t}\n\treturn found;\n}\n\n/** `path` with `/` separators and no leading `./` (as manifests and globs write paths). */\nfunction posix(path: string): string {\n\treturn path.split(sep).join(\"/\").replace(/^\\.\\//, \"\");\n}\n\n/** Whether `path` lies inside directory `dir` (both absolute). */\nfunction insideDir(dir: string, path: string): boolean {\n\tconst rest = relative(dir, path);\n\treturn rest !== \"\" && !rest.startsWith(\"..\") && !isAbsolute(rest);\n}\n\n/**\n * Whether the `/`-separated `path` matches the glob `pattern`: `*` and `?` within one segment, `**` across segments\n * (`node:path`'s `matchesGlob` is experimental in Node 22, Chord's floor); anything else literal.\n */\nfunction matchesGlob(path: string, pattern: string): boolean {\n\tlet source = \"\";\n\tfor (let at = 0; at < pattern.length; at++) {\n\t\tconst char = pattern[at]!;\n\t\tif (pattern.startsWith(\"**/\", at)) {\n\t\t\tsource += \"(?:.*/)?\";\n\t\t\tat += 2;\n\t\t} else if (pattern.startsWith(\"**\", at)) {\n\t\t\tsource += \".*\";\n\t\t\tat += 1;\n\t\t} else if (char === \"*\") source += \"[^/]*\";\n\t\telse if (char === \"?\") source += \"[^/]\";\n\t\telse source += char.replace(/[.+^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\t}\n\treturn new RegExp(`^${source}$`).test(path);\n}\n\n/** How deep a glob of `chord.plugins` looks for folders. */\nconst GLOB_DEPTH = 6;\n\n/** The folders under `dir` (hidden ones and `node_modules` skipped, `GLOB_DEPTH` deep) whose path matches `pattern`. */\nasync function globFolders(dir: string, pattern: string): Promise<string[]> {\n\tconst found: string[] = [];\n\tconst walk = async (at: string, depth: number): Promise<void> => {\n\t\tif (depth > GLOB_DEPTH) return;\n\t\tlet entries: Dirent[];\n\t\ttry {\n\t\t\tentries = await readdir(at, { withFileTypes: true });\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\t\tfor (const entry of entries) {\n\t\t\tif (!entry.isDirectory() || entry.name.startsWith(\".\") || entry.name === \"node_modules\") continue;\n\t\t\tconst path = join(at, entry.name);\n\t\t\tif (matchesGlob(posix(relative(dir, path)), pattern)) found.push(path);\n\t\t\tawait walk(path, depth + 1);\n\t\t}\n\t};\n\tawait walk(dir, 1);\n\treturn found;\n}\n\n/** The plugin in `dir` (its real path) with its `package.json` read as `manifest`, or why it is none. */\nasync function pluginAt(dir: string, manifest: Manifest, at: RootContext): Promise<Found> {\n\tconst problem = (error: string): Found => ({ kind: \"problem\", path: dir, error });\n\tif (manifest.kind === \"missing\") return problem(\"no package.json\");\n\tif (manifest.kind === \"invalid\") return problem(manifest.error);\n\t// A trust boundary: a plugin's own `package.json`.\n\tconst { name, dependencies, chord } = (manifest.value ?? {}) as {\n\t\treadonly name?: unknown;\n\t\treadonly dependencies?: unknown;\n\t\treadonly chord?: { readonly external?: unknown };\n\t};\n\tif (typeof name !== \"string\" || !isPluginName(name)) {\n\t\treturn problem(`package.json: ${JSON.stringify(name)} is not a valid plugin name`);\n\t}\n\tconst external = chord?.external ?? [];\n\tif (!Array.isArray(external) || !external.every((each) => typeof each === \"string\")) {\n\t\treturn problem(\"package.json: chord.external is not a list of package names\");\n\t}\n\tconst files = new Set(await readdir(dir));\n\tconst facets: Record<string, string> = {};\n\tfor (const kind of at.kinds) {\n\t\tconst named = FACET_EXTENSIONS.map((extension) => `${kind}${extension}`).filter((file) => files.has(file));\n\t\tif (named.length > 1) return problem(`two ${kind} facets: ${named.join(\", \")}`);\n\t\tif (named.length === 1) facets[kind] = join(dir, named[0]!);\n\t}\n\tconst packages = typeof dependencies === \"object\" && dependencies !== null ? Object.keys(dependencies) : [];\n\tconst plugin: Plugin = {\n\t\tname,\n\t\tdir,\n\t\troot: at.root,\n\t\trequired: at.required,\n\t\tlayout: \"directory\",\n\t\tfacets,\n\t\tdependencies: packages,\n\t\texternal,\n\t};\n\treturn { kind: \"plugin\", plugin };\n}\n\n/**\n * The single-file plugins among a root's top files: `<name>.<kind>.<ext>` with `<kind>` one of the app's kinds and\n * `<ext>` a facet extension, grouped by `<name>` (an unscoped plugin name, else reported; two files of one kind\n * reported). Other files are not plugins.\n */\nfunction singleFilePlugins(\n\tfiles: readonly string[],\n\tat: RootContext,\n): { readonly plugins: readonly Plugin[]; readonly problems: readonly DiscoveryProblem[] } {\n\tconst groups = new Map<string, Map<string, string[]>>();\n\tfor (const file of files) {\n\t\tconst parsed = singleFileName(file, at.kinds);\n\t\tif (parsed === undefined) continue;\n\t\tconst kinds = groups.get(parsed.name) ?? new Map<string, string[]>();\n\t\tgroups.set(parsed.name, kinds);\n\t\tkinds.set(parsed.kind, [...(kinds.get(parsed.kind) ?? []), file]);\n\t}\n\tconst plugins: Plugin[] = [];\n\tconst problems: DiscoveryProblem[] = [];\n\tfor (const [name, kinds] of groups) {\n\t\tconst first = join(at.root, [...kinds.values()][0]![0]!);\n\t\tif (!isPluginName(name) || name.startsWith(\"@\")) {\n\t\t\tproblems.push({ path: first, error: `\"${name}\" is not a valid unscoped plugin name`, ...rootOf(at) });\n\t\t\tcontinue;\n\t\t}\n\t\tconst twice = [...kinds].find(([, named]) => named.length > 1);\n\t\tif (twice !== undefined) {\n\t\t\tproblems.push({ path: first, error: `two ${twice[0]} facets: ${twice[1].join(\", \")}`, ...rootOf(at) });\n\t\t\tcontinue;\n\t\t}\n\t\tconst facets = Object.fromEntries([...kinds].map(([kind, [file]]) => [kind, join(at.root, file!)]));\n\t\tconst record = { root: at.root, required: at.required, dependencies: [], external: [] };\n\t\tplugins.push({ name, dir: at.root, layout: \"file\", facets, ...record });\n\t}\n\treturn { plugins, problems };\n}\n\n/** The plugin name and kind of a single-file plugin's file name (`hello.server.ts`), or `undefined` for another file. */\nfunction singleFileName(\n\tfile: string,\n\tkinds: readonly string[],\n): { readonly name: string; readonly kind: string } | undefined {\n\tconst extension = FACET_EXTENSIONS.find((each) => file.endsWith(each));\n\tif (extension === undefined) return undefined;\n\tconst stem = file.slice(0, -extension.length);\n\tconst dot = stem.lastIndexOf(\".\");\n\tif (dot <= 0) return undefined;\n\tconst kind = stem.slice(dot + 1);\n\treturn kinds.includes(kind) ? { name: stem.slice(0, dot), kind } : undefined;\n}\n\n/** A problem's root fields for a root's context. */\nfunction rootOf(at: RootContext): { readonly root: string; readonly required: boolean } {\n\treturn { root: at.root, required: at.required };\n}\n"]}

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

@@ -0,0 +1,33 @@
+import type { Principal } from "../../data/index.ts";
+import type { Facet } from "../../host/index.ts";
+import type { BuiltFacet } from "./build.ts";
+import type { Plugin } from "./discover.ts";
+/**
+ * The host packages by specifier, each what Node's `require` would give: a CommonJS package's exports, an ESM
+ * package's namespace (`import * as`), wrapped once so default and named imports both work.
+ */
+export type HostPackages = Readonly<Record<string, unknown>>;
+/** What `evaluateFacet` takes besides the script: the host packages and the plugin it was built from. */
+export type EvaluateOptions = {
+    readonly hostPackages: HostPackages;
+    readonly plugin: Plugin;
+};
+/** A built script, as evaluation takes it. */
+export type BuiltScript = Extract<BuiltFacet, {
+    readonly kind: "script";
+}>;
+/**
+ * Evaluates `built` and returns its facet (its default export). Throws what the script throws while it is evaluated,
+ * an import its `require` does not answer, or a declaration error when its default export is not a facet.
+ */
+export declare function evaluateFacet<P extends Principal = Principal>(built: BuiltScript, options: EvaluateOptions): Facet<P>;
+/**
+ * Inside a facet script, the absolute path of `path`, a file of the facet's own plugin (`..` out of its directory
+ * refused); evaluation gives each facet its own. Imported anywhere else, it throws.
+ */
+export declare function pluginFile(path: string): string;
+/** The one specifier of this component a script imports (`pluginFile`): external always, answered per facet. */
+export declare const PLUGINS_SPECIFIER = "@earendil-works/chord/plugins";
+/** The package a bare specifier names: `@scope/name` or `name`, without a subpath. */
+export declare function packageName(specifier: string): string;
+//# sourceMappingURL=evaluate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../src/node/plugins/evaluate.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7D,yGAAyG;AACzG,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/F,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CA2BrH;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,gHAAgH;AAChH,eAAO,MAAM,iBAAiB,kCAAkC,CAAC;AA4DjE,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/node/plugins/evaluate.js

@@ -0,0 +1,121 @@
+// Evaluating (slice 7c §3): a built script run with `vm.Script` in this context under a stable filename per (plugin,
+// kind, digest), given the `require` that answers its external imports: the host packages (one instance per process),
+// this component's `pluginFile` bound to the plugin's directory, and `chord.external` packages and Node builtins from
+// the plugin's own `node_modules`. No module map and no cache: an old facet's closures are collected once nothing holds
+// them.
+import { createRequire, isBuiltin } from "node:module";
+import { basename, isAbsolute, join, relative, resolve } from "node:path";
+import { Script } from "node:vm";
+import { interop } from "../../surfaces/registered.js";
+import { registerScript } from "./stack.js";
+/**
+ * Evaluates `built` and returns its facet (its default export). Throws what the script throws while it is evaluated,
+ * an import its `require` does not answer, or a declaration error when its default export is not a facet.
+ */
+export function evaluateFacet(built, options) {
+    const { plugin, hostPackages } = options;
+    const where = `plugin "${plugin.name}" (${built.facet})`;
+    const file = plugin.facets[built.facet] ?? `${built.facet}.js`;
+    const filename = `/chord-plugins/${plugin.name}/${basename(file)}?${built.digest}`;
+    // The script is one function expression: its value when run.
+    const wrapper = new Script(built.source, { filename }).runInThisContext();
+    const module = { exports: {} };
+    let facet;
+    try {
+        wrapper(requireFor(plugin, built, hostPackages, where), module, module.exports);
+        // A trust boundary: plugin code; its default export is checked to be a facet (a getter of it may throw too).
+        facet = module.exports?.default;
+        if (typeof facet !== "object" || facet === null || typeof facet.setup !== "function") {
+            throw new Error(`${where}: its default export is not a facet (defineFacet)`);
+        }
+    }
+    catch (error) {
+        // Its stack maps while the error lives (an import-time throw names the plugin's line).
+        if (typeof error === "object" && error !== null)
+            registerScript(filename, built.source, plugin.dir, error);
+        throw error;
+    }
+    registerScript(filename, built.source, plugin.dir, facet);
+    return facet;
+}
+/**
+ * Inside a facet script, the absolute path of `path`, a file of the facet's own plugin (`..` out of its directory
+ * refused); evaluation gives each facet its own. Imported anywhere else, it throws.
+ */
+export function pluginFile(path) {
+    throw new Error(`pluginFile("${path}"): only a plugin's facet script, evaluated by the plugins component, has one`);
+}
+/** The one specifier of this component a script imports (`pluginFile`): external always, answered per facet. */
+export const PLUGINS_SPECIFIER = "@earendil-works/chord/plugins";
+/**
+ * The `require` a facet script of `plugin` takes (`where` names the facet in its errors). A computed `require(x)`
+ * cannot be seen at build, so it refuses here what the build refuses to imports: another version of the app's API than
+ * the script imports (or, when it imports none, than the first one it requires), Chord itself under an app's API, and
+ * for a single-file plugin anything but host packages.
+ */
+function requireFor(plugin, built, hostPackages, where) {
+    let fromPlugin;
+    let plugins;
+    // The facet's API version: the one its build saw, else the first one required (one facet, one version).
+    let version = built.api?.version;
+    return (specifier) => {
+        const refused = refusedAtRun(built, version, specifier);
+        if (refused !== undefined)
+            throw new Error(`${where}: "${specifier}": ${refused}`);
+        version ??= versionOf(built, specifier);
+        if (Object.hasOwn(hostPackages, specifier))
+            return interop(hostPackages[specifier]);
+        if (specifier === PLUGINS_SPECIFIER) {
+            plugins ??= { pluginFile: (path) => fileOf(plugin, path) };
+            return plugins;
+        }
+        if (plugin.layout === "file") {
+            throw new Error(`${where}: "${specifier}": a single-file plugin requires only host packages`);
+        }
+        if (isBuiltin(specifier) || plugin.external.includes(packageName(specifier))) {
+            fromPlugin ??= createRequire(join(plugin.dir, "package.json"));
+            return fromPlugin(specifier);
+        }
+        throw new Error(`${where}: "${specifier}" is not a host package, a Node builtin or one of its chord.external packages`);
+    };
+}
+/**
+ * Why a script built against the app's API, using API `version` so far, may not require `specifier` (the build's API
+ * rules), or `undefined`.
+ */
+function refusedAtRun(built, version, specifier) {
+    const { api } = built;
+    if (api === undefined || specifier === PLUGINS_SPECIFIER)
+        return undefined;
+    if (packageName(specifier) === "@earendil-works/chord")
+        return "plugins import Chord through the app's API";
+    const required = versionOf(built, specifier);
+    if (required === undefined || version === undefined || required === version)
+        return undefined;
+    return `this script uses ${api.name}/${version}: one facet uses one version of the API`;
+}
+/** The API version `specifier` names (`v3` of `@acme/app/v3/web`), when the script was built against an API. */
+function versionOf(built, specifier) {
+    const { api } = built;
+    if (api === undefined || (specifier !== api.name && !specifier.startsWith(`${api.name}/`)))
+        return undefined;
+    return specifier.slice(api.name.length + 1).split("/")[0];
+}
+/** The package a bare specifier names: `@scope/name` or `name`, without a subpath. */
+export function packageName(specifier) {
+    const parts = specifier.split("/");
+    return specifier.startsWith("@") ? parts.slice(0, 2).join("/") : parts[0];
+}
+/** The absolute path of `path` inside `plugin`'s directory; one out of it is refused, and so is every one of a single-file plugin. */
+function fileOf(plugin, path) {
+    if (plugin.layout === "file") {
+        throw new Error(`pluginFile("${path}"): single-file plugin "${plugin.name}" has no directory of its own`);
+    }
+    const file = resolve(plugin.dir, path);
+    const rest = relative(plugin.dir, file);
+    if (rest.startsWith("..") || isAbsolute(rest)) {
+        throw new Error(`pluginFile("${path}"): outside the directory of plugin "${plugin.name}"`);
+    }
+    return file;
+}
+//# sourceMappingURL=evaluate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../../src/node/plugins/evaluate.ts"],"names":[],"mappings":"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","sourcesContent":["// Evaluating (slice 7c §3): a built script run with `vm.Script` in this context under a stable filename per (plugin,\n// kind, digest), given the `require` that answers its external imports: the host packages (one instance per process),\n// this component's `pluginFile` bound to the plugin's directory, and `chord.external` packages and Node builtins from\n// the plugin's own `node_modules`. No module map and no cache: an old facet's closures are collected once nothing holds\n// them.\n\nimport { createRequire, isBuiltin } from \"node:module\";\nimport { basename, isAbsolute, join, relative, resolve } from \"node:path\";\nimport { Script } from \"node:vm\";\nimport type { Principal } from \"../../data/index.ts\";\nimport type { Facet } from \"../../host/index.ts\";\nimport { interop } from \"../../surfaces/registered.ts\";\nimport type { BuiltFacet } from \"./build.ts\";\nimport type { Plugin } from \"./discover.ts\";\nimport { registerScript } from \"./stack.ts\";\n\n/**\n * The host packages by specifier, each what Node's `require` would give: a CommonJS package's exports, an ESM\n * package's namespace (`import * as`), wrapped once so default and named imports both work.\n */\nexport type HostPackages = Readonly<Record<string, unknown>>;\n\n/** What `evaluateFacet` takes besides the script: the host packages and the plugin it was built from. */\nexport type EvaluateOptions = { readonly hostPackages: HostPackages; readonly plugin: Plugin };\n\n/** A built script, as evaluation takes it. */\nexport type BuiltScript = Extract<BuiltFacet, { readonly kind: \"script\" }>;\n\n/**\n * Evaluates `built` and returns its facet (its default export). Throws what the script throws while it is evaluated,\n * an import its `require` does not answer, or a declaration error when its default export is not a facet.\n */\nexport function evaluateFacet<P extends Principal = Principal>(built: BuiltScript, options: EvaluateOptions): Facet<P> {\n\tconst { plugin, hostPackages } = options;\n\tconst where = `plugin \"${plugin.name}\" (${built.facet})`;\n\tconst file = plugin.facets[built.facet] ?? `${built.facet}.js`;\n\tconst filename = `/chord-plugins/${plugin.name}/${basename(file)}?${built.digest}`;\n\t// The script is one function expression: its value when run.\n\tconst wrapper = new Script(built.source, { filename }).runInThisContext() as (\n\t\trequire: (specifier: string) => unknown,\n\t\tmodule: { exports: unknown },\n\t\texports: unknown,\n\t) => void;\n\tconst module = { exports: {} as unknown };\n\tlet facet: unknown;\n\ttry {\n\t\twrapper(requireFor(plugin, built, hostPackages, where), module, module.exports);\n\t\t// A trust boundary: plugin code; its default export is checked to be a facet (a getter of it may throw too).\n\t\tfacet = (module.exports as { readonly default?: unknown } | null)?.default;\n\t\tif (typeof facet !== \"object\" || facet === null || typeof (facet as { setup?: unknown }).setup !== \"function\") {\n\t\t\tthrow new Error(`${where}: its default export is not a facet (defineFacet)`);\n\t\t}\n\t} catch (error) {\n\t\t// Its stack maps while the error lives (an import-time throw names the plugin's line).\n\t\tif (typeof error === \"object\" && error !== null) registerScript(filename, built.source, plugin.dir, error);\n\t\tthrow error;\n\t}\n\tregisterScript(filename, built.source, plugin.dir, facet);\n\treturn facet as Facet<P>;\n}\n\n/**\n * Inside a facet script, the absolute path of `path`, a file of the facet's own plugin (`..` out of its directory\n * refused); evaluation gives each facet its own. Imported anywhere else, it throws.\n */\nexport function pluginFile(path: string): string {\n\tthrow new Error(`pluginFile(\"${path}\"): only a plugin's facet script, evaluated by the plugins component, has one`);\n}\n\n/** The one specifier of this component a script imports (`pluginFile`): external always, answered per facet. */\nexport const PLUGINS_SPECIFIER = \"@earendil-works/chord/plugins\";\n\n/**\n * The `require` a facet script of `plugin` takes (`where` names the facet in its errors). A computed `require(x)`\n * cannot be seen at build, so it refuses here what the build refuses to imports: another version of the app's API than\n * the script imports (or, when it imports none, than the first one it requires), Chord itself under an app's API, and\n * for a single-file plugin anything but host packages.\n */\nfunction requireFor(\n\tplugin: Plugin,\n\tbuilt: BuiltScript,\n\thostPackages: HostPackages,\n\twhere: string,\n): (specifier: string) => unknown {\n\tlet fromPlugin: NodeJS.Require | undefined;\n\tlet plugins: { readonly pluginFile: (path: string) => string } | undefined;\n\t// The facet's API version: the one its build saw, else the first one required (one facet, one version).\n\tlet version = built.api?.version;\n\treturn (specifier) => {\n\t\tconst refused = refusedAtRun(built, version, specifier);\n\t\tif (refused !== undefined) throw new Error(`${where}: \"${specifier}\": ${refused}`);\n\t\tversion ??= versionOf(built, specifier);\n\t\tif (Object.hasOwn(hostPackages, specifier)) return interop(hostPackages[specifier]);\n\t\tif (specifier === PLUGINS_SPECIFIER) {\n\t\t\tplugins ??= { pluginFile: (path) => fileOf(plugin, path) };\n\t\t\treturn plugins;\n\t\t}\n\t\tif (plugin.layout === \"file\") {\n\t\t\tthrow new Error(`${where}: \"${specifier}\": a single-file plugin requires only host packages`);\n\t\t}\n\t\tif (isBuiltin(specifier) || plugin.external.includes(packageName(specifier))) {\n\t\t\tfromPlugin ??= createRequire(join(plugin.dir, \"package.json\"));\n\t\t\treturn fromPlugin(specifier);\n\t\t}\n\t\tthrow new Error(\n\t\t\t`${where}: \"${specifier}\" is not a host package, a Node builtin or one of its chord.external packages`,\n\t\t);\n\t};\n}\n\n/**\n * Why a script built against the app's API, using API `version` so far, may not require `specifier` (the build's API\n * rules), or `undefined`.\n */\nfunction refusedAtRun(built: BuiltScript, version: string | undefined, specifier: string): string | undefined {\n\tconst { api } = built;\n\tif (api === undefined || specifier === PLUGINS_SPECIFIER) return undefined;\n\tif (packageName(specifier) === \"@earendil-works/chord\") return \"plugins import Chord through the app's API\";\n\tconst required = versionOf(built, specifier);\n\tif (required === undefined || version === undefined || required === version) return undefined;\n\treturn `this script uses ${api.name}/${version}: one facet uses one version of the API`;\n}\n\n/** The API version `specifier` names (`v3` of `@acme/app/v3/web`), when the script was built against an API. */\nfunction versionOf(built: BuiltScript, specifier: string): string | undefined {\n\tconst { api } = built;\n\tif (api === undefined || (specifier !== api.name && !specifier.startsWith(`${api.name}/`))) return undefined;\n\treturn specifier.slice(api.name.length + 1).split(\"/\")[0];\n}\n\n/** The package a bare specifier names: `@scope/name` or `name`, without a subpath. */\nexport function packageName(specifier: string): string {\n\tconst parts = specifier.split(\"/\");\n\treturn specifier.startsWith(\"@\") ? parts.slice(0, 2).join(\"/\") : parts[0]!;\n}\n\n/** The absolute path of `path` inside `plugin`'s directory; one out of it is refused, and so is every one of a single-file plugin. */\nfunction fileOf(plugin: Plugin, path: string): string {\n\tif (plugin.layout === \"file\") {\n\t\tthrow new Error(`pluginFile(\"${path}\"): single-file plugin \"${plugin.name}\" has no directory of its own`);\n\t}\n\tconst file = resolve(plugin.dir, path);\n\tconst rest = relative(plugin.dir, file);\n\tif (rest.startsWith(\"..\") || isAbsolute(rest)) {\n\t\tthrow new Error(`pluginFile(\"${path}\"): outside the directory of plugin \"${plugin.name}\"`);\n\t}\n\treturn file;\n}\n"]}