@earendil-works/chord 1.3.0 → 1.5.0

package/dist/next-node/plugins/watcher.js

@@ -0,0 +1,281 @@
+// The watcher and its marks (slice 7c §5): `fs.watch` on every directory of the plugin roots and the app's base code,
+// `node_modules` and `.git` never watched (a directory appearing later gets its watch), marks what changed and never
+// applies it. A changed file dirties every plugin whose facets used it (a copied contract every user) or whose directory
+// contains it; a changed `package.json` asks for an install (and for its metadata to be read again); a plugin directory
+// or facet file added or removed asks for discovery again; a file of base code asks the app to restart its hosts. The
+// marks are a JSON watchable; each mark records the generation of its latest change (generations only increase), so a
+// change during a build keeps its mark, however late an older build's rollout clears.
+import { lstatSync, readdirSync, realpathSync, watch } from "node:fs";
+import { basename, dirname, join, resolve, sep } from "node:path";
+import { BACKGROUND_CONTEXT } from "../../context/index.js";
+import { Source } from "../../next/state/internal.js";
+import { inside } from "./build.js";
+import { FACET_EXTENSIONS } from "./discover.js";
+/** Directories never watched, and changes under them never marked. */
+const IGNORED = new Set(["node_modules", ".git"]);
+/**
+ * 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 class PluginWatcher extends Source {
+    #options;
+    #roots;
+    #baseDirs;
+    /** The trees it watches: the roots, the base code, and plugin directories linked from outside the roots. */
+    #trees = new Set();
+    /** Its watches, one per directory of its trees. */
+    #watchers = new Map();
+    /** A failure to watch was reported (once). */
+    #reported = false;
+    /** The generation the next change gets: every mark records a newer one than any before it. */
+    #generation = 1;
+    /** Each dirty plugin's latest change, by generation. */
+    #dirty = new Map();
+    #install = new Set();
+    /** The latest change of the plugin set since the last discovery (0: none). */
+    #set = 0;
+    /** The latest change of a known plugin's `package.json` since the last discovery (0: none). */
+    #manifest = 0;
+    #baseChanged = false;
+    #discovery = { plugins: [], problems: [] };
+    /** The files each built facet read (its inputs and copies), by plugin and kind. */
+    #used = new Map();
+    #value;
+    #scheduled = false;
+    constructor(options, batch) {
+        super(batch);
+        this.#options = options;
+        // Events name paths under the directories as watched: by their real paths, as discovery names plugins.
+        this.#roots = options.roots.map(real);
+        this.#baseDirs = options.base.map(real);
+        for (const dir of [...this.#roots, ...this.#baseDirs])
+            this.#watchTree(dir);
+    }
+    get value() {
+        this.#value ??= {
+            dirty: [...this.#dirty.keys()].sort(),
+            install: [...this.#install].sort(),
+            set: this.#set > 0,
+            base: this.#baseChanged,
+        };
+        return this.#value;
+    }
+    deliver(context) {
+        const value = this.value;
+        this.publish(value, [["r", value]], false, context);
+    }
+    /** Whether the next build discovers again: the plugin set or a plugin's `package.json` changed. */
+    get needsDiscovery() {
+        return this.#set > 0 || this.#manifest > 0;
+    }
+    /** What a discovery that starts now has seen. */
+    discoverySnapshot() {
+        return { set: this.#set, manifest: this.#manifest };
+    }
+    /** The plugins discovery found: marks are for them (a removed one's install clears); the changes it had seen clear. */
+    know(discovery, seen) {
+        this.#discovery = discovery;
+        if (this.#set === seen.set)
+            this.#set = 0;
+        if (this.#manifest === seen.manifest)
+            this.#manifest = 0;
+        // A removed plugin has nothing to install (its directory went, its package.json with it).
+        for (const name of this.#install)
+            if (!discovery.plugins.some((plugin) => plugin.name === name))
+                this.#install.delete(name);
+        // A plugin directory linked from outside the roots: a tree of its own (a symlink is not followed).
+        const linked = discovery.plugins.filter(({ dir }) => !this.#roots.some((root) => inside(root, dir)));
+        for (const { dir } of linked)
+            this.#watchTree(dir);
+        for (const tree of this.#trees) {
+            const kept = this.#roots.includes(tree) || this.#baseDirs.includes(tree) || linked.some((each) => each.dir === tree);
+            if (!kept)
+                this.#unwatchTree(tree);
+        }
+        this.#changed();
+    }
+    /** What `built` facets read: a later change of one of these files dirties their plugins. */
+    used(built) {
+        for (const facet of built) {
+            if (facet.kind !== "script")
+                continue;
+            const files = new Set([...facet.inputs.map(({ file }) => file), ...facet.copied]);
+            this.#used.set(`${facet.plugin}\u0000${facet.facet}`, { plugin: facet.plugin, files });
+        }
+    }
+    /** The marks a build of `names` starts from: each one's latest change. */
+    snapshot(names) {
+        const plugins = new Map();
+        for (const name of names)
+            plugins.set(name, this.#dirty.get(name) ?? 0);
+        return { plugins };
+    }
+    /** `names` were applied everywhere: their marks clear unless a change came after `snapshot`. */
+    applied(names, snapshot) {
+        for (const name of names) {
+            const latest = this.#dirty.get(name);
+            if (latest !== undefined && latest <= (snapshot.plugins.get(name) ?? 0))
+                this.#dirty.delete(name);
+        }
+        this.#changed();
+    }
+    /** Plugin `name`'s dependencies were installed: its install mark clears and it is dirty (its packages changed). */
+    installed(name) {
+        this.#install.delete(name);
+        this.#dirty.set(name, this.#generation++);
+        this.#changed();
+    }
+    /** Marks what a change of the file or directory at `path` (absolute) asks for. */
+    mark(path) {
+        if (path.split(sep).some((part) => IGNORED.has(part)))
+            return;
+        if (this.#baseDirs.some((dir) => inside(dir, path))) {
+            this.#baseChanged = true;
+        }
+        else {
+            this.#markPlugin(path, this.#generation++);
+        }
+        this.#changed();
+    }
+    /** Stops watching. */
+    close() {
+        for (const watcher of this.#watchers.values())
+            watcher.close();
+        this.#watchers.clear();
+        this.#trees.clear();
+    }
+    /**
+     * A change under a root, at `generation`: in a plugin's directory, it dirties that plugin (and asks for an install
+     * and a new reading of its metadata for its `package.json`, for discovery for a facet file at its top); elsewhere
+     * under a root (a directory added or removed, a directory that is no plugin yet), discovery; every plugin whose
+     * facets read the file is dirty too.
+     */
+    #markPlugin(path, generation) {
+        const plugin = this.#discovery.plugins.find((each) => each.dir === path || inside(each.dir, path));
+        if (plugin === undefined) {
+            if (this.#roots.some((root) => inside(root, path)))
+                this.#set = generation;
+        }
+        else if (path === join(plugin.dir, "package.json")) {
+            this.#install.add(plugin.name);
+            this.#manifest = generation;
+        }
+        else {
+            if (path === plugin.dir || (dirname(path) === plugin.dir && this.#isFacetFile(basename(path)))) {
+                this.#set = generation;
+            }
+            this.#dirty.set(plugin.name, generation);
+        }
+        for (const { plugin: user, files } of this.#used.values())
+            if (files.has(path))
+                this.#dirty.set(user, generation);
+    }
+    /** Whether `file` (at a plugin's top) is named as a facet file of one of the app's kinds. */
+    #isFacetFile(file) {
+        return this.#options.kinds.some((kind) => FACET_EXTENSIONS.some((extension) => file === `${kind}${extension}`));
+    }
+    /** Watches the tree at `dir` (once): it and every directory under it but ignored ones; a missing one is skipped. */
+    #watchTree(dir) {
+        if (this.#trees.has(dir))
+            return;
+        this.#trees.add(dir);
+        this.#watchDirs(dir);
+    }
+    /** Stops watching the tree at `dir`. */
+    #unwatchTree(dir) {
+        this.#trees.delete(dir);
+        this.#unwatchDirs(dir);
+    }
+    /** Watches `dir` and, walking down, every directory under it but ignored ones (each not watched yet). */
+    #watchDirs(dir) {
+        if (this.#watchers.has(dir) || this.#reported)
+            return;
+        let watcher;
+        try {
+            watcher = watch(dir, (_event, file) => {
+                if (file !== null)
+                    this.#changedIn(join(dir, file));
+            });
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                this.#failed(error);
+            return;
+        }
+        watcher.on("error", (error) => this.#failed(error));
+        this.#watchers.set(dir, watcher);
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            // Removed meanwhile: its parent's event says so.
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory() && !IGNORED.has(entry.name))
+                this.#watchDirs(join(dir, entry.name));
+        }
+    }
+    /** An event for `path` in a watched directory: a new directory gets its watches, a removed one loses them; marked. */
+    #changedIn(path) {
+        const name = basename(path);
+        if (!IGNORED.has(name)) {
+            if (isDirectory(path))
+                this.#watchDirs(path);
+            else if (this.#watchers.has(path))
+                this.#unwatchDirs(path);
+        }
+        this.mark(path);
+    }
+    /** Stops watching `dir` and the directories under it (it was removed, or its tree is not watched any more). */
+    #unwatchDirs(dir) {
+        for (const [watched, watcher] of this.#watchers) {
+            if (watched !== dir && !inside(dir, watched))
+                continue;
+            watcher.close();
+            this.#watchers.delete(watched);
+        }
+    }
+    /** Watching failed: reported once; every watch stops (the app builds on demand). */
+    #failed(error) {
+        this.close();
+        if (this.#reported)
+            return;
+        this.#reported = true;
+        this.#options.failed(error);
+    }
+    /** The marks changed: one publication per microtask turn while someone watches or derives from them. */
+    #changed() {
+        this.#value = undefined;
+        if (this.#scheduled || (!this.watched && this.dependents.size === 0))
+            return;
+        this.#scheduled = true;
+        queueMicrotask(() => {
+            this.#scheduled = false;
+            this.batch.within(() => this.changed(), BACKGROUND_CONTEXT);
+        });
+    }
+}
+/**
+ * Whether `path` is a directory, never following a link (as the scan of a tree does not); one that cannot be read (gone,
+ * a link loop, no access) is none: a watch callback must not throw.
+ */
+function isDirectory(path) {
+    try {
+        return lstatSync(path, { throwIfNoEntry: false })?.isDirectory() === true;
+    }
+    catch {
+        return false;
+    }
+}
+/** `dir` absolute and by its real path; as given (absolute) when it does not exist. */
+function real(dir) {
+    try {
+        return realpathSync(dir);
+    }
+    catch {
+        return resolve(dir);
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/next-node/plugins/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../../src/next-node/plugins/watcher.ts"],"names":[],"mappings":"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","sourcesContent":["// The watcher and its marks (slice 7c §5): `fs.watch` on every directory of the plugin roots and the app's base code,\n// `node_modules` and `.git` never watched (a directory appearing later gets its watch), marks what changed and never\n// applies it. A changed file dirties every plugin whose facets used it (a copied contract every user) or whose directory\n// contains it; a changed `package.json` asks for an install (and for its metadata to be read again); a plugin directory\n// or facet file added or removed asks for discovery again; a file of base code asks the app to restart its hosts. The\n// marks are a JSON watchable; each mark records the generation of its latest change (generations only increase), so a\n// change during a build keeps its mark, however late an older build's rollout clears.\n\nimport { type Dirent, type FSWatcher, lstatSync, readdirSync, realpathSync, watch } from \"node:fs\";\nimport { basename, dirname, join, resolve, sep } from \"node:path\";\nimport { BACKGROUND_CONTEXT, type Context } from \"../../context/index.ts\";\nimport type { JsonValue } from \"../../json.ts\";\nimport { type Batch, Source } from \"../../next/state/internal.ts\";\nimport { type BuiltFacet, inside } from \"./build.ts\";\nimport { type Discovery, FACET_EXTENSIONS } from \"./discover.ts\";\n\n/** The marks: plugins to rebuild, plugins to install, whether to discover again, whether base code changed. */\nexport type PluginsState = {\n\treadonly dirty: readonly string[];\n\treadonly install: readonly string[];\n\treadonly set: boolean;\n\treadonly base: boolean;\n};\n\n/** The generation of each dirty plugin's latest change when a build started: what its rollout may clear. */\nexport type MarkSnapshot = { readonly plugins: ReadonlyMap<string, number> };\n\n/** The generations of the latest change of the plugin set and of a `package.json` when a discovery started. */\nexport type DiscoverySnapshot = { readonly set: number; readonly manifest: number };\n\n/** What the watcher watches and how it reports: the roots, the base code, the facet kinds, a failure to watch. */\nexport type WatcherOptions = {\n\treadonly roots: readonly string[];\n\treadonly base: readonly string[];\n\treadonly kinds: readonly string[];\n\t/** The watcher cannot watch (the system's limit): reported once, after which the app builds on demand. */\n\treadonly failed: (error: unknown) => void;\n};\n\n/** Directories never watched, and changes under them never marked. */\nconst IGNORED = new Set([\"node_modules\", \".git\"]);\n\n/**\n * The watcher and the marks (`state`), a JSON watchable published at most once per microtask turn with changes. It\n * marks for the plugins of the last discovery (`know`) and the files their last builds read (`used`).\n */\nexport class PluginWatcher extends Source {\n\treadonly #options: WatcherOptions;\n\treadonly #roots: readonly string[];\n\treadonly #baseDirs: readonly string[];\n\t/** The trees it watches: the roots, the base code, and plugin directories linked from outside the roots. */\n\treadonly #trees = new Set<string>();\n\t/** Its watches, one per directory of its trees. */\n\treadonly #watchers = new Map<string, FSWatcher>();\n\t/** A failure to watch was reported (once). */\n\t#reported = false;\n\t/** The generation the next change gets: every mark records a newer one than any before it. */\n\t#generation = 1;\n\t/** Each dirty plugin's latest change, by generation. */\n\treadonly #dirty = new Map<string, number>();\n\treadonly #install = new Set<string>();\n\t/** The latest change of the plugin set since the last discovery (0: none). */\n\t#set = 0;\n\t/** The latest change of a known plugin's `package.json` since the last discovery (0: none). */\n\t#manifest = 0;\n\t#baseChanged = false;\n\t#discovery: Discovery = { plugins: [], problems: [] };\n\t/** The files each built facet read (its inputs and copies), by plugin and kind. */\n\treadonly #used = new Map<string, { readonly plugin: string; readonly files: ReadonlySet<string> }>();\n\t#value: JsonValue | undefined;\n\t#scheduled = false;\n\n\tconstructor(options: WatcherOptions, batch: Batch) {\n\t\tsuper(batch);\n\t\tthis.#options = options;\n\t\t// Events name paths under the directories as watched: by their real paths, as discovery names plugins.\n\t\tthis.#roots = options.roots.map(real);\n\t\tthis.#baseDirs = options.base.map(real);\n\t\tfor (const dir of [...this.#roots, ...this.#baseDirs]) this.#watchTree(dir);\n\t}\n\n\tget value(): JsonValue {\n\t\tthis.#value ??= {\n\t\t\tdirty: [...this.#dirty.keys()].sort(),\n\t\t\tinstall: [...this.#install].sort(),\n\t\t\tset: this.#set > 0,\n\t\t\tbase: this.#baseChanged,\n\t\t};\n\t\treturn this.#value;\n\t}\n\n\tdeliver(context: Context): void {\n\t\tconst value = this.value;\n\t\tthis.publish(value, [[\"r\", value]], false, context);\n\t}\n\n\t/** Whether the next build discovers again: the plugin set or a plugin's `package.json` changed. */\n\tget needsDiscovery(): boolean {\n\t\treturn this.#set > 0 || this.#manifest > 0;\n\t}\n\n\t/** What a discovery that starts now has seen. */\n\tdiscoverySnapshot(): DiscoverySnapshot {\n\t\treturn { set: this.#set, manifest: this.#manifest };\n\t}\n\n\t/** The plugins discovery found: marks are for them (a removed one's install clears); the changes it had seen clear. */\n\tknow(discovery: Discovery, seen: DiscoverySnapshot): void {\n\t\tthis.#discovery = discovery;\n\t\tif (this.#set === seen.set) this.#set = 0;\n\t\tif (this.#manifest === seen.manifest) this.#manifest = 0;\n\t\t// A removed plugin has nothing to install (its directory went, its package.json with it).\n\t\tfor (const name of this.#install)\n\t\t\tif (!discovery.plugins.some((plugin) => plugin.name === name)) this.#install.delete(name);\n\t\t// A plugin directory linked from outside the roots: a tree of its own (a symlink is not followed).\n\t\tconst linked = discovery.plugins.filter(({ dir }) => !this.#roots.some((root) => inside(root, dir)));\n\t\tfor (const { dir } of linked) this.#watchTree(dir);\n\t\tfor (const tree of this.#trees) {\n\t\t\tconst kept =\n\t\t\t\tthis.#roots.includes(tree) || this.#baseDirs.includes(tree) || linked.some((each) => each.dir === tree);\n\t\t\tif (!kept) this.#unwatchTree(tree);\n\t\t}\n\t\tthis.#changed();\n\t}\n\n\t/** What `built` facets read: a later change of one of these files dirties their plugins. */\n\tused(built: readonly BuiltFacet[]): void {\n\t\tfor (const facet of built) {\n\t\t\tif (facet.kind !== \"script\") continue;\n\t\t\tconst files = new Set([...facet.inputs.map(({ file }) => file), ...facet.copied]);\n\t\t\tthis.#used.set(`${facet.plugin}\\u0000${facet.facet}`, { plugin: facet.plugin, files });\n\t\t}\n\t}\n\n\t/** The marks a build of `names` starts from: each one's latest change. */\n\tsnapshot(names: Iterable<string>): MarkSnapshot {\n\t\tconst plugins = new Map<string, number>();\n\t\tfor (const name of names) plugins.set(name, this.#dirty.get(name) ?? 0);\n\t\treturn { plugins };\n\t}\n\n\t/** `names` were applied everywhere: their marks clear unless a change came after `snapshot`. */\n\tapplied(names: Iterable<string>, snapshot: MarkSnapshot): void {\n\t\tfor (const name of names) {\n\t\t\tconst latest = this.#dirty.get(name);\n\t\t\tif (latest !== undefined && latest <= (snapshot.plugins.get(name) ?? 0)) this.#dirty.delete(name);\n\t\t}\n\t\tthis.#changed();\n\t}\n\n\t/** Plugin `name`'s dependencies were installed: its install mark clears and it is dirty (its packages changed). */\n\tinstalled(name: string): void {\n\t\tthis.#install.delete(name);\n\t\tthis.#dirty.set(name, this.#generation++);\n\t\tthis.#changed();\n\t}\n\n\t/** Marks what a change of the file or directory at `path` (absolute) asks for. */\n\tmark(path: string): void {\n\t\tif (path.split(sep).some((part) => IGNORED.has(part))) return;\n\t\tif (this.#baseDirs.some((dir) => inside(dir, path))) {\n\t\t\tthis.#baseChanged = true;\n\t\t} else {\n\t\t\tthis.#markPlugin(path, this.#generation++);\n\t\t}\n\t\tthis.#changed();\n\t}\n\n\t/** Stops watching. */\n\tclose(): void {\n\t\tfor (const watcher of this.#watchers.values()) watcher.close();\n\t\tthis.#watchers.clear();\n\t\tthis.#trees.clear();\n\t}\n\n\t/**\n\t * A change under a root, at `generation`: in a plugin's directory, it dirties that plugin (and asks for an install\n\t * and a new reading of its metadata for its `package.json`, for discovery for a facet file at its top); elsewhere\n\t * under a root (a directory added or removed, a directory that is no plugin yet), discovery; every plugin whose\n\t * facets read the file is dirty too.\n\t */\n\t#markPlugin(path: string, generation: number): void {\n\t\tconst plugin = this.#discovery.plugins.find((each) => each.dir === path || inside(each.dir, path));\n\t\tif (plugin === undefined) {\n\t\t\tif (this.#roots.some((root) => inside(root, path))) this.#set = generation;\n\t\t} else if (path === join(plugin.dir, \"package.json\")) {\n\t\t\tthis.#install.add(plugin.name);\n\t\t\tthis.#manifest = generation;\n\t\t} else {\n\t\t\tif (path === plugin.dir || (dirname(path) === plugin.dir && this.#isFacetFile(basename(path)))) {\n\t\t\t\tthis.#set = generation;\n\t\t\t}\n\t\t\tthis.#dirty.set(plugin.name, generation);\n\t\t}\n\t\tfor (const { plugin: user, files } of this.#used.values()) if (files.has(path)) this.#dirty.set(user, generation);\n\t}\n\n\t/** Whether `file` (at a plugin's top) is named as a facet file of one of the app's kinds. */\n\t#isFacetFile(file: string): boolean {\n\t\treturn this.#options.kinds.some((kind) => FACET_EXTENSIONS.some((extension) => file === `${kind}${extension}`));\n\t}\n\n\t/** Watches the tree at `dir` (once): it and every directory under it but ignored ones; a missing one is skipped. */\n\t#watchTree(dir: string): void {\n\t\tif (this.#trees.has(dir)) return;\n\t\tthis.#trees.add(dir);\n\t\tthis.#watchDirs(dir);\n\t}\n\n\t/** Stops watching the tree at `dir`. */\n\t#unwatchTree(dir: string): void {\n\t\tthis.#trees.delete(dir);\n\t\tthis.#unwatchDirs(dir);\n\t}\n\n\t/** Watches `dir` and, walking down, every directory under it but ignored ones (each not watched yet). */\n\t#watchDirs(dir: string): void {\n\t\tif (this.#watchers.has(dir) || this.#reported) return;\n\t\tlet watcher: FSWatcher;\n\t\ttry {\n\t\t\twatcher = watch(dir, (_event, file) => {\n\t\t\t\tif (file !== null) this.#changedIn(join(dir, file));\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tif ((error as NodeJS.ErrnoException).code !== \"ENOENT\") this.#failed(error);\n\t\t\treturn;\n\t\t}\n\t\twatcher.on(\"error\", (error) => this.#failed(error));\n\t\tthis.#watchers.set(dir, watcher);\n\t\tlet entries: Dirent[];\n\t\ttry {\n\t\t\tentries = readdirSync(dir, { withFileTypes: true });\n\t\t} catch {\n\t\t\t// Removed meanwhile: its parent's event says so.\n\t\t\treturn;\n\t\t}\n\t\tfor (const entry of entries) {\n\t\t\tif (entry.isDirectory() && !IGNORED.has(entry.name)) this.#watchDirs(join(dir, entry.name));\n\t\t}\n\t}\n\n\t/** An event for `path` in a watched directory: a new directory gets its watches, a removed one loses them; marked. */\n\t#changedIn(path: string): void {\n\t\tconst name = basename(path);\n\t\tif (!IGNORED.has(name)) {\n\t\t\tif (isDirectory(path)) this.#watchDirs(path);\n\t\t\telse if (this.#watchers.has(path)) this.#unwatchDirs(path);\n\t\t}\n\t\tthis.mark(path);\n\t}\n\n\t/** Stops watching `dir` and the directories under it (it was removed, or its tree is not watched any more). */\n\t#unwatchDirs(dir: string): void {\n\t\tfor (const [watched, watcher] of this.#watchers) {\n\t\t\tif (watched !== dir && !inside(dir, watched)) continue;\n\t\t\twatcher.close();\n\t\t\tthis.#watchers.delete(watched);\n\t\t}\n\t}\n\n\t/** Watching failed: reported once; every watch stops (the app builds on demand). */\n\t#failed(error: unknown): void {\n\t\tthis.close();\n\t\tif (this.#reported) return;\n\t\tthis.#reported = true;\n\t\tthis.#options.failed(error);\n\t}\n\n\t/** The marks changed: one publication per microtask turn while someone watches or derives from them. */\n\t#changed(): void {\n\t\tthis.#value = undefined;\n\t\tif (this.#scheduled || (!this.watched && this.dependents.size === 0)) return;\n\t\tthis.#scheduled = true;\n\t\tqueueMicrotask(() => {\n\t\t\tthis.#scheduled = false;\n\t\t\tthis.batch.within(() => this.changed(), BACKGROUND_CONTEXT);\n\t\t});\n\t}\n}\n\n/**\n * Whether `path` is a directory, never following a link (as the scan of a tree does not); one that cannot be read (gone,\n * a link loop, no access) is none: a watch callback must not throw.\n */\nfunction isDirectory(path: string): boolean {\n\ttry {\n\t\treturn lstatSync(path, { throwIfNoEntry: false })?.isDirectory() === true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/** `dir` absolute and by its real path; as given (absolute) when it does not exist. */\nfunction real(dir: string): string {\n\ttry {\n\t\treturn realpathSync(dir);\n\t} catch {\n\t\treturn resolve(dir);\n\t}\n}\n"]}

package/dist/next-node/workers/control.d.ts

@@ -0,0 +1,83 @@
+import type { JsonValue } from "../../json.ts";
+import type { Address } from "../../next/contracts/index.ts";
+import { type FailureCause } from "../../next/data/index.ts";
+import type { ReloadReport } from "../../next/host/index.ts";
+import type { PluginScript } from "../plugins/runtime.ts";
+/** An error as it crosses: its message, and a ChordError's code and reason. */
+export type CrossedError = {
+    readonly message: string;
+    readonly code?: string;
+    readonly reason?: string;
+};
+/** A reload report as it crosses: its errors crossed. */
+export type CrossedReport = {
+    readonly plugins: ReloadReport["plugins"];
+    readonly failed: readonly {
+        readonly plugin: string;
+        readonly error: CrossedError;
+    }[];
+    readonly objects: readonly {
+        readonly object: string;
+        readonly kind: string;
+        readonly cause?: CrossedCause;
+    }[];
+};
+/** A failure cause as it crosses. */
+type CrossedCause = {
+    readonly kind: FailureCause["kind"];
+    readonly error: CrossedError;
+};
+/** What the server sends a worker. */
+export type ToWorker = {
+    readonly kind: "start";
+    readonly address: Address;
+    readonly start: JsonValue;
+    readonly scripts: readonly PluginScript[];
+    readonly lock: string;
+} | {
+    readonly kind: "shutdown";
+} | {
+    readonly kind: "reload";
+    readonly scripts: readonly PluginScript[];
+};
+/** What a worker sends the server. */
+export type FromWorker = {
+    readonly kind: "started";
+} | {
+    readonly kind: "ready";
+    readonly idle: boolean;
+    readonly report: CrossedReport;
+} | {
+    readonly kind: "idle";
+    readonly idle: boolean;
+} | {
+    readonly kind: "fatal";
+    readonly error: CrossedError;
+} | {
+    readonly kind: "reloaded";
+    readonly report: CrossedReport;
+} | {
+    readonly kind: "reloaded";
+    readonly error: CrossedError;
+};
+/** `message` in its envelope, as it goes over the IPC channel. */
+export declare function envelope(message: ToWorker | FromWorker): {
+    readonly [ENVELOPE]: ToWorker | FromWorker;
+};
+/** The envelope's key: a control message is `{ "chord.workers": message }`. */
+declare const ENVELOPE = "chord.workers";
+/**
+ * The control message in an IPC message, or `undefined` for anything else (a link frame, the app's own). A trust
+ * boundary in name only: both ends are the app's processes, so only the envelope is checked.
+ */
+export declare function controlOf<M extends ToWorker | FromWorker>(message: unknown): M | undefined;
+/** `error` as it crosses. */
+export declare function crossed(error: unknown): CrossedError;
+/** A crossed error as an error again: a ChordError when its code is one, an `Error` otherwise. */
+export declare function uncrossed(error: CrossedError): Error;
+/** `report` as it crosses. */
+export declare function crossedReport(report: ReloadReport): CrossedReport;
+/** A crossed report as a report again. */
+export declare function uncrossedReport(report: CrossedReport): ReloadReport;
+export {};
+//# sourceMappingURL=control.d.ts.map

package/dist/next-node/workers/control.d.ts.map

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

package/dist/next-node/workers/control.js

@@ -0,0 +1,77 @@
+// The control channel between the server and a worker (slice 10 §3): JSON messages beside the link's `Uint8Array`
+// frames on one IPC channel (the IPC link skips them), and errors as they cross it (`{ message, code?, reason? }`,
+// never a stack or a cause).
+import { ChordError, isChordError } from "../../next/data/index.js";
+import { chordErrorFromJson } from "../../next/data/internal.js";
+/** `message` in its envelope, as it goes over the IPC channel. */
+export function envelope(message) {
+    return { [ENVELOPE]: message };
+}
+/** The envelope's key: a control message is `{ "chord.workers": message }`. */
+const ENVELOPE = "chord.workers";
+/**
+ * The control message in an IPC message, or `undefined` for anything else (a link frame, the app's own). A trust
+ * boundary in name only: both ends are the app's processes, so only the envelope is checked.
+ */
+export function controlOf(message) {
+    if (typeof message !== "object" || message === null || !(ENVELOPE in message))
+        return undefined;
+    // Sent by the other end of this channel through `envelope`.
+    return message[ENVELOPE];
+}
+/** `error` as it crosses. */
+export function crossed(error) {
+    if (isChordError(error)) {
+        return {
+            message: error.message,
+            code: error.code,
+            ...(error.reason === undefined ? {} : { reason: error.reason }),
+        };
+    }
+    return { message: error instanceof Error ? error.message : String(error) };
+}
+/** A crossed error as an error again: a ChordError when its code is one, an `Error` otherwise. */
+export function uncrossed(error) {
+    if (error.code === undefined)
+        return new Error(error.message);
+    try {
+        return chordErrorFromJson({
+            code: error.code,
+            message: error.message,
+            ...(error.reason === undefined ? {} : { reason: error.reason }),
+        });
+    }
+    catch {
+        return new Error(error.message);
+    }
+}
+/** `report` as it crosses. */
+export function crossedReport(report) {
+    return {
+        plugins: report.plugins,
+        failed: report.failed.map(({ plugin, error }) => ({ plugin, error: crossed(error) })),
+        objects: report.objects.map((each) => each.kind === "parked"
+            ? {
+                object: each.object,
+                kind: each.kind,
+                cause: { kind: each.cause.kind, error: crossed(each.cause.error) },
+            }
+            : each),
+    };
+}
+/** A crossed report as a report again. */
+export function uncrossedReport(report) {
+    return {
+        plugins: report.plugins,
+        failed: report.failed.map(({ plugin, error }) => ({ plugin, error: uncrossed(error) })),
+        objects: report.objects.map(({ object, kind, cause }) => {
+            if (cause === undefined)
+                return { object, kind: kind };
+            const error = uncrossed(cause.error);
+            // A parked object's cause is a ChordError on the worker; one that crossed without a code is wrapped as one.
+            const chord = isChordError(error) ? error : new ChordError({ code: "unavailable", message: error.message });
+            return { object, kind: "parked", cause: { kind: cause.kind, error: chord } };
+        }),
+    };
+}
+//# sourceMappingURL=control.js.map

package/dist/next-node/workers/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../../../src/next-node/workers/control.ts"],"names":[],"mappings":"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","sourcesContent":["// The control channel between the server and a worker (slice 10 §3): JSON messages beside the link's `Uint8Array`\n// frames on one IPC channel (the IPC link skips them), and errors as they cross it (`{ message, code?, reason? }`,\n// never a stack or a cause).\n\nimport type { JsonValue } from \"../../json.ts\";\nimport type { Address } from \"../../next/contracts/index.ts\";\nimport { ChordError, type FailureCause, isChordError } from \"../../next/data/index.ts\";\nimport { chordErrorFromJson } from \"../../next/data/internal.ts\";\nimport type { ReloadReport } from \"../../next/host/index.ts\";\nimport type { PluginScript } from \"../plugins/runtime.ts\";\n\n/** An error as it crosses: its message, and a ChordError's code and reason. */\nexport type CrossedError = { readonly message: string; readonly code?: string; readonly reason?: string };\n\n/** A reload report as it crosses: its errors crossed. */\nexport type CrossedReport = {\n\treadonly plugins: ReloadReport[\"plugins\"];\n\treadonly failed: readonly { readonly plugin: string; readonly error: CrossedError }[];\n\treadonly objects: readonly { readonly object: string; readonly kind: string; readonly cause?: CrossedCause }[];\n};\n\n/** A failure cause as it crosses. */\ntype CrossedCause = { readonly kind: FailureCause[\"kind\"]; readonly error: CrossedError };\n\n/** What the server sends a worker. */\nexport type ToWorker =\n\t| {\n\t\t\treadonly kind: \"start\";\n\t\t\treadonly address: Address;\n\t\t\treadonly start: JsonValue;\n\t\t\treadonly scripts: readonly PluginScript[];\n\t\t\treadonly lock: string;\n\t  }\n\t| { readonly kind: \"shutdown\" }\n\t| { readonly kind: \"reload\"; readonly scripts: readonly PluginScript[] };\n\n/** What a worker sends the server. */\nexport type FromWorker =\n\t| { readonly kind: \"started\" }\n\t| { readonly kind: \"ready\"; readonly idle: boolean; readonly report: CrossedReport }\n\t| { readonly kind: \"idle\"; readonly idle: boolean }\n\t| { readonly kind: \"fatal\"; readonly error: CrossedError }\n\t| { readonly kind: \"reloaded\"; readonly report: CrossedReport }\n\t| { readonly kind: \"reloaded\"; readonly error: CrossedError };\n\n/** `message` in its envelope, as it goes over the IPC channel. */\nexport function envelope(message: ToWorker | FromWorker): { readonly [ENVELOPE]: ToWorker | FromWorker } {\n\treturn { [ENVELOPE]: message };\n}\n\n/** The envelope's key: a control message is `{ \"chord.workers\": message }`. */\nconst ENVELOPE = \"chord.workers\";\n\n/**\n * The control message in an IPC message, or `undefined` for anything else (a link frame, the app's own). A trust\n * boundary in name only: both ends are the app's processes, so only the envelope is checked.\n */\nexport function controlOf<M extends ToWorker | FromWorker>(message: unknown): M | undefined {\n\tif (typeof message !== \"object\" || message === null || !(ENVELOPE in message)) return undefined;\n\t// Sent by the other end of this channel through `envelope`.\n\treturn (message as { readonly [ENVELOPE]: M })[ENVELOPE];\n}\n\n/** `error` as it crosses. */\nexport function crossed(error: unknown): CrossedError {\n\tif (isChordError(error)) {\n\t\treturn {\n\t\t\tmessage: error.message,\n\t\t\tcode: error.code,\n\t\t\t...(error.reason === undefined ? {} : { reason: error.reason }),\n\t\t};\n\t}\n\treturn { message: error instanceof Error ? error.message : String(error) };\n}\n\n/** A crossed error as an error again: a ChordError when its code is one, an `Error` otherwise. */\nexport function uncrossed(error: CrossedError): Error {\n\tif (error.code === undefined) return new Error(error.message);\n\ttry {\n\t\treturn chordErrorFromJson({\n\t\t\tcode: error.code,\n\t\t\tmessage: error.message,\n\t\t\t...(error.reason === undefined ? {} : { reason: error.reason }),\n\t\t});\n\t} catch {\n\t\treturn new Error(error.message);\n\t}\n}\n\n/** `report` as it crosses. */\nexport function crossedReport(report: ReloadReport): CrossedReport {\n\treturn {\n\t\tplugins: report.plugins,\n\t\tfailed: report.failed.map(({ plugin, error }) => ({ plugin, error: crossed(error) })),\n\t\tobjects: report.objects.map((each) =>\n\t\t\teach.kind === \"parked\"\n\t\t\t\t? {\n\t\t\t\t\t\tobject: each.object,\n\t\t\t\t\t\tkind: each.kind,\n\t\t\t\t\t\tcause: { kind: each.cause.kind, error: crossed(each.cause.error) },\n\t\t\t\t\t}\n\t\t\t\t: each,\n\t\t),\n\t};\n}\n\n/** A crossed report as a report again. */\nexport function uncrossedReport(report: CrossedReport): ReloadReport {\n\treturn {\n\t\tplugins: report.plugins,\n\t\tfailed: report.failed.map(({ plugin, error }) => ({ plugin, error: uncrossed(error) })),\n\t\tobjects: report.objects.map(({ object, kind, cause }) => {\n\t\t\tif (cause === undefined)\n\t\t\t\treturn { object, kind: kind as Exclude<ReloadReport[\"objects\"][number][\"kind\"], \"parked\"> };\n\t\t\tconst error = uncrossed(cause.error);\n\t\t\t// A parked object's cause is a ChordError on the worker; one that crossed without a code is wrapped as one.\n\t\t\tconst chord = isChordError(error) ? error : new ChordError({ code: \"unavailable\", message: error.message });\n\t\t\treturn { object, kind: \"parked\", cause: { kind: cause.kind, error: chord } as FailureCause };\n\t\t}),\n\t};\n}\n"]}

package/dist/next-node/workers/index.d.ts

@@ -0,0 +1,5 @@
+export type { CrossedError } from "./control.ts";
+export { type ProcessLock, processLock } from "./lock.ts";
+export { type WorkerMainOptions, type WorkerPlugins, type WorkerResult, type WorkerStart, workerMain, } from "./main.ts";
+export { createWorkers, type WorkerState, type Workers, type WorkersError, type WorkersOptions, } from "./workers.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/next-node/workers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/next-node/workers/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,KAAK,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,UAAU,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,cAAc,GACnB,MAAM,cAAc,CAAC"}

package/dist/next-node/workers/index.js

@@ -0,0 +1,7 @@
+// Chord v2's workers component (`@earendil-works/chord/next/workers`, slice 10 §3, §4): a forked worker process per
+// address of a host kind, started on demand, stopped when idle, never restarted by itself, its plugins shipped from the
+// server; `workerMain` is the worker's side. Node-only.
+export { processLock } from "./lock.js";
+export { workerMain, } from "./main.js";
+export { createWorkers, } from "./workers.js";
+//# sourceMappingURL=index.js.map

package/dist/next-node/workers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/next-node/workers/index.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,wHAAwH;AACxH,wDAAwD;AAGxD,OAAO,EAAoB,WAAW,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAKN,UAAU,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,aAAa,GAKb,MAAM,cAAc,CAAC","sourcesContent":["// Chord v2's workers component (`@earendil-works/chord/next/workers`, slice 10 §3, §4): a forked worker process per\n// address of a host kind, started on demand, stopped when idle, never restarted by itself, its plugins shipped from the\n// server; `workerMain` is the worker's side. Node-only.\n\nexport type { CrossedError } from \"./control.ts\";\nexport { type ProcessLock, processLock } from \"./lock.ts\";\nexport {\n\ttype WorkerMainOptions,\n\ttype WorkerPlugins,\n\ttype WorkerResult,\n\ttype WorkerStart,\n\tworkerMain,\n} from \"./main.ts\";\nexport {\n\tcreateWorkers,\n\ttype WorkerState,\n\ttype Workers,\n\ttype WorkersError,\n\ttype WorkersOptions,\n} from \"./workers.ts\";\n"]}

package/dist/next-node/workers/lock.d.ts

@@ -0,0 +1,21 @@
+import type { Context } from "../../context/index.ts";
+/** A held lock: `release` frees it (the process's exit does too). */
+export type ProcessLock = {
+    release(): Promise<void>;
+};
+/** Where a lock lives: an abstract socket (Linux, Android), a named pipe (Windows) or a socket file (elsewhere). */
+export type LockAddress = {
+    readonly kind: "abstract" | "pipe" | "file";
+    readonly address: string;
+};
+/**
+ * Takes the lock `name`, waiting while another process holds it (until `context` aborts: rejects with its reason).
+ * Throws what listening throws besides "in use", and for a stale socket file (macOS, the BSDs) an error naming it.
+ */
+export declare function processLock(name: string, context: Context): Promise<ProcessLock>;
+/**
+ * Takes the lock at `lock`, waiting while it is held. A socket file nobody accepts on (a crashed holder's) fails closed:
+ * taking it over races another taker (two could both unlink and listen), so the error names the file to remove.
+ */
+export declare function lockAt(lock: LockAddress, context: Context): Promise<ProcessLock>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/next-node/workers/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../src/next-node/workers/lock.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,qEAAqE;AACrE,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAEvD,oHAAoH;AACpH,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAQtF;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAmCtF"}