@graphrefly/graphrefly 0.45.0 → 0.47.0

package/dist/base/sources/node/index.cjs

@@ -0,0 +1,320 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/base/sources/node/index.ts
+var node_exports = {};
+__export(node_exports, {
+  fromFSWatch: () => fromFSWatch,
+  fromGitHook: () => fromGitHook,
+  fromSpawn: () => fromSpawn,
+  runProcess: () => runProcess
+});
+module.exports = __toCommonJS(node_exports);
+
+// src/base/sources/node/fs-root.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+var import_core = require("@graphrefly/pure-ts/core");
+var import_extra = require("@graphrefly/pure-ts/extra");
+function sourceOpts(opts) {
+  return { describeKind: "producer", ...opts };
+}
+function fromFSWatch(paths, opts) {
+  const list = Array.isArray(paths) ? paths : [paths];
+  if (list.length === 0) {
+    throw new RangeError("fromFSWatch expects at least one path");
+  }
+  const { recursive = true, debounce = 100, include, exclude, ...rest } = opts ?? {};
+  const includePatterns = include?.map(import_extra.globToRegExp) ?? [];
+  const excludePatterns = (exclude ?? ["**/node_modules/**", "**/.git/**", "**/dist/**"]).map(
+    import_extra.globToRegExp
+  );
+  return (0, import_core.node)((_data, a) => {
+    const pending = /* @__PURE__ */ new Map();
+    const watchers = [];
+    let stopped = false;
+    let terminalEmitted = false;
+    let generation = 0;
+    const closeWatchers = () => {
+      for (const watcher of watchers.splice(0)) watcher.close();
+    };
+    const emitError = (err) => {
+      if (terminalEmitted) return;
+      terminalEmitted = true;
+      stopped = true;
+      if (timer !== void 0) clearTimeout(timer);
+      timer = void 0;
+      pending.clear();
+      closeWatchers();
+      a.down([[import_core.ERROR, err]]);
+    };
+    let timer;
+    const flush = (token) => {
+      timer = void 0;
+      if (stopped || terminalEmitted) return;
+      if (pending.size === 0) return;
+      const batchMessages = [];
+      for (const evt of pending.values()) batchMessages.push([import_core.DATA, evt]);
+      pending.clear();
+      if (stopped || terminalEmitted || token !== generation) return;
+      a.down(batchMessages);
+    };
+    try {
+      for (const basePath of list) {
+        const watcher = (0, import_node_fs.watch)(
+          basePath,
+          { recursive },
+          (eventType, fileName) => {
+            if (stopped || terminalEmitted) return;
+            if (fileName == null) return;
+            const rel = String(fileName).replaceAll("\\", "/");
+            const abs = (0, import_node_path.resolve)(basePath, String(fileName));
+            const normalized = abs.replaceAll("\\", "/");
+            const root = (0, import_node_path.resolve)(basePath).replaceAll("\\", "/");
+            const relForMatch = rel.startsWith("./") ? rel.slice(2) : rel;
+            const included = includePatterns.length === 0 || (0, import_extra.matchesAnyPattern)(normalized, includePatterns) || (0, import_extra.matchesAnyPattern)(relForMatch, includePatterns);
+            if (!included) return;
+            const excluded = (0, import_extra.matchesAnyPattern)(normalized, excludePatterns) || (0, import_extra.matchesAnyPattern)(relForMatch, excludePatterns);
+            if (excluded) return;
+            let kind = "change";
+            if (eventType === "rename") {
+              try {
+                kind = (0, import_node_fs.existsSync)(normalized) ? "create" : "delete";
+              } catch {
+                kind = "rename";
+              }
+            }
+            pending.set(normalized, {
+              type: kind,
+              path: normalized,
+              root,
+              relative_path: relForMatch,
+              timestamp_ns: (0, import_core.wallClockNs)()
+            });
+            if (timer !== void 0) clearTimeout(timer);
+            const token = generation;
+            timer = setTimeout(() => flush(token), debounce);
+          }
+        );
+        watcher.on("error", (err) => emitError(err));
+        watchers.push(watcher);
+      }
+    } catch (err) {
+      emitError(err);
+    }
+    return () => {
+      stopped = true;
+      generation += 1;
+      if (timer !== void 0) clearTimeout(timer);
+      timer = void 0;
+      closeWatchers();
+      pending.clear();
+    };
+  }, sourceOpts(rest));
+}
+
+// src/base/sources/node/git-hook.ts
+var import_core2 = require("@graphrefly/pure-ts/core");
+var import_extra2 = require("@graphrefly/pure-ts/extra");
+function fromGitHook(repoPath, opts) {
+  const { pollMs = 5e3, include, exclude, maxConsecutiveErrors = 1 } = opts ?? {};
+  const includePatterns = include?.map(import_extra2.globToRegExp) ?? [];
+  const excludePatterns = exclude?.map(import_extra2.globToRegExp) ?? [];
+  const { execFileSync } = require("child_process");
+  const gitQuery = (args) => execFileSync("git", args, { cwd: repoPath, encoding: "utf-8" }).trim();
+  let lastSeen;
+  let consecutiveErrors = 0;
+  return (0, import_extra2.switchMap)(
+    (0, import_extra2.fromTimer)(0, { period: pollMs }),
+    () => (0, import_core2.node)((_data, a) => {
+      try {
+        const head = gitQuery(["rev-parse", "HEAD"]);
+        if (!head) {
+          consecutiveErrors = 0;
+          return () => {
+          };
+        }
+        if (lastSeen === void 0) {
+          lastSeen = head;
+          consecutiveErrors = 0;
+          return () => {
+          };
+        }
+        if (head === lastSeen) {
+          consecutiveErrors = 0;
+          return () => {
+          };
+        }
+        let files = gitQuery(["diff", "--name-only", `${lastSeen}..${head}`]).split("\n").filter(Boolean);
+        if (includePatterns.length > 0) {
+          files = files.filter((f) => (0, import_extra2.matchesAnyPattern)(f, includePatterns));
+        }
+        if (excludePatterns.length > 0) {
+          files = files.filter((f) => !(0, import_extra2.matchesAnyPattern)(f, excludePatterns));
+        }
+        const message = gitQuery(["log", "-1", "--format=%s", head]);
+        const author = gitQuery(["log", "-1", "--format=%an", head]);
+        a.emit({
+          hook: "post-commit",
+          commit: head,
+          files,
+          message,
+          author,
+          timestamp_ns: (0, import_core2.wallClockNs)()
+        });
+        lastSeen = head;
+        consecutiveErrors = 0;
+      } catch (err) {
+        consecutiveErrors += 1;
+        if (consecutiveErrors >= maxConsecutiveErrors) {
+          a.down([[import_core2.ERROR, err]]);
+        }
+      }
+      return () => {
+      };
+    })
+  );
+}
+
+// src/base/sources/node/process.ts
+var import_node_child_process = require("child_process");
+var import_core3 = require("@graphrefly/pure-ts/core");
+function fromSpawn(cmd, args, opts) {
+  return (0, import_core3.node)(
+    (_data, actions) => {
+      const child = (0, import_node_child_process.spawn)(cmd, args, {
+        cwd: opts?.cwd,
+        env: opts?.env,
+        shell: opts?.shell,
+        signal: opts?.signal,
+        stdio: opts?.stdio ?? "pipe"
+      });
+      let alive = true;
+      let exitInfo = null;
+      child.stdout?.on("data", (chunk) => {
+        if (!alive) return;
+        actions.down([[import_core3.DATA, { kind: "stdout", chunk }]]);
+      });
+      child.stderr?.on("data", (chunk) => {
+        if (!alive) return;
+        actions.down([[import_core3.DATA, { kind: "stderr", chunk }]]);
+      });
+      child.on("error", (err) => {
+        if (!alive) return;
+        alive = false;
+        actions.down([[import_core3.ERROR, err]]);
+      });
+      child.on("exit", (code, signal) => {
+        if (exitInfo == null) exitInfo = { code, signal };
+      });
+      child.on("close", () => {
+        if (!alive) return;
+        alive = false;
+        const info = exitInfo ?? { code: null, signal: null };
+        actions.down([
+          [import_core3.DATA, { kind: "exit", code: info.code, signal: info.signal }],
+          [import_core3.COMPLETE]
+        ]);
+      });
+      return () => {
+        if (alive) {
+          alive = false;
+          child.stdout?.removeAllListeners();
+          child.stderr?.removeAllListeners();
+          child.removeAllListeners("error");
+          child.removeAllListeners("exit");
+          child.removeAllListeners("close");
+          try {
+            child.kill("SIGTERM");
+          } catch {
+          }
+        }
+      };
+    },
+    { name: "from_spawn" }
+  );
+}
+function runProcess(cmd, args, opts) {
+  return (0, import_core3.node)(
+    (_data, actions) => {
+      const child = (0, import_node_child_process.spawn)(cmd, args, {
+        cwd: opts?.cwd,
+        env: opts?.env,
+        shell: opts?.shell,
+        signal: opts?.signal,
+        stdio: opts?.stdio ?? "pipe"
+      });
+      let alive = true;
+      const stdoutChunks = [];
+      const stderrChunks = [];
+      let exitInfo = null;
+      child.stdout?.on("data", (chunk) => {
+        if (!alive) return;
+        stdoutChunks.push(chunk);
+      });
+      child.stderr?.on("data", (chunk) => {
+        if (!alive) return;
+        stderrChunks.push(chunk);
+      });
+      child.on("error", (err) => {
+        if (!alive) return;
+        alive = false;
+        actions.down([[import_core3.ERROR, err]]);
+      });
+      child.on("exit", (code, signal) => {
+        if (exitInfo == null) exitInfo = { code, signal };
+      });
+      child.on("close", () => {
+        if (!alive) return;
+        alive = false;
+        const info = exitInfo ?? { code: null, signal: null };
+        const stdout = Buffer.concat(stdoutChunks).toString("utf8");
+        const stderr = Buffer.concat(stderrChunks).toString("utf8");
+        actions.down([
+          [
+            import_core3.DATA,
+            {
+              stdout,
+              stderr,
+              exitCode: info.code,
+              signal: info.signal
+            }
+          ],
+          [import_core3.COMPLETE]
+        ]);
+      });
+      return () => {
+        if (alive) {
+          alive = false;
+          child.stdout?.removeAllListeners();
+          child.stderr?.removeAllListeners();
+          child.removeAllListeners("error");
+          child.removeAllListeners("exit");
+          child.removeAllListeners("close");
+          try {
+            child.kill("SIGTERM");
+          } catch {
+          }
+        }
+      };
+    },
+    { name: "run_process" }
+  );
+}
+//# sourceMappingURL=index.cjs.map

package/dist/base/sources/node/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/base/sources/node/index.ts","../../../../src/base/sources/node/fs-root.ts","../../../../src/base/sources/node/git-hook.ts","../../../../src/base/sources/node/process.ts"],"sourcesContent":["/**\n * Node-only sources — fs, git, git-hook, process.\n *\n * All entries in this subpath may import node:* builtins.\n * Import via @graphrefly/graphrefly/base/sources/node.\n *\n * @module\n */\n\nexport * from \"./fs.js\";\nexport * from \"./git.js\";\nexport * from \"./git-hook.js\";\nexport * from \"./process.js\";\n","/**\n * Filesystem-watching source. Isolated from `./sources.ts` so bundlers\n * targeting the browser can import browser-safe sources (`fromTimer`,\n * `fromRaf`, etc.) without pulling in `node:fs`/`node:path`.\n */\n\nimport { existsSync, watch } from \"node:fs\";\nimport { resolve as resolvePath } from \"node:path\";\nimport {\n\tDATA,\n\tERROR,\n\ttype Message,\n\ttype Node,\n\ttype NodeOptions,\n\tnode,\n\twallClockNs,\n} from \"@graphrefly/pure-ts/core\";\nimport { globToRegExp, matchesAnyPattern } from \"@graphrefly/pure-ts/extra\";\n\ntype ExtraOpts = Omit<NodeOptions<unknown>, \"describeKind\">;\n\nfunction sourceOpts<T = unknown>(opts?: ExtraOpts): NodeOptions<T> {\n\treturn { describeKind: \"producer\", ...opts } as NodeOptions<T>;\n}\n\nexport type FSEventType = \"change\" | \"rename\" | \"create\" | \"delete\";\nexport type FSEvent = {\n\ttype: FSEventType;\n\tpath: string;\n\troot: string;\n\trelative_path: string;\n\tsrc_path?: string;\n\tdest_path?: string;\n\ttimestamp_ns: number;\n};\n\nexport type FromFSWatchOptions = ExtraOpts & {\n\trecursive?: boolean;\n\tdebounce?: number;\n\tinclude?: string[];\n\texclude?: string[];\n};\n\n/**\n * Watches filesystem paths and emits debounced change events.\n *\n * Uses `fs.watch` only (no polling fallback). Teardown closes all watchers.\n *\n * @category extra\n */\nexport function fromFSWatch(paths: string | string[], opts?: FromFSWatchOptions): Node<FSEvent> {\n\tconst list = Array.isArray(paths) ? paths : [paths];\n\tif (list.length === 0) {\n\t\tthrow new RangeError(\"fromFSWatch expects at least one path\");\n\t}\n\tconst { recursive = true, debounce = 100, include, exclude, ...rest } = opts ?? {};\n\tconst includePatterns = include?.map(globToRegExp) ?? [];\n\tconst excludePatterns = (exclude ?? [\"**/node_modules/**\", \"**/.git/**\", \"**/dist/**\"]).map(\n\t\tglobToRegExp,\n\t);\n\treturn node<FSEvent>((_data, a) => {\n\t\tconst pending = new Map<string, FSEvent>();\n\t\tconst watchers: ReturnType<typeof watch>[] = [];\n\t\tlet stopped = false;\n\t\tlet terminalEmitted = false;\n\t\tlet generation = 0;\n\t\tconst closeWatchers = () => {\n\t\t\tfor (const watcher of watchers.splice(0)) watcher.close();\n\t\t};\n\t\tconst emitError = (err: unknown) => {\n\t\t\tif (terminalEmitted) return;\n\t\t\tterminalEmitted = true;\n\t\t\tstopped = true;\n\t\t\tif (timer !== undefined) clearTimeout(timer);\n\t\t\ttimer = undefined;\n\t\t\tpending.clear();\n\t\t\tcloseWatchers();\n\t\t\ta.down([[ERROR, err]]);\n\t\t};\n\t\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\t\tconst flush = (token: number) => {\n\t\t\ttimer = undefined;\n\t\t\tif (stopped || terminalEmitted) return;\n\t\t\tif (pending.size === 0) return;\n\t\t\tconst batchMessages: Message[] = [];\n\t\t\tfor (const evt of pending.values()) batchMessages.push([DATA, evt]);\n\t\t\tpending.clear();\n\t\t\tif (stopped || terminalEmitted || token !== generation) return;\n\t\t\ta.down(batchMessages);\n\t\t};\n\t\ttry {\n\t\t\tfor (const basePath of list) {\n\t\t\t\tconst watcher = watch(\n\t\t\t\t\tbasePath,\n\t\t\t\t\t{ recursive },\n\t\t\t\t\t(eventType: \"rename\" | \"change\", fileName: string | Buffer | null) => {\n\t\t\t\t\t\tif (stopped || terminalEmitted) return;\n\t\t\t\t\t\tif (fileName == null) return;\n\t\t\t\t\t\tconst rel = String(fileName).replaceAll(\"\\\\\", \"/\");\n\t\t\t\t\t\tconst abs = resolvePath(basePath, String(fileName));\n\t\t\t\t\t\tconst normalized = abs.replaceAll(\"\\\\\", \"/\");\n\t\t\t\t\t\tconst root = resolvePath(basePath).replaceAll(\"\\\\\", \"/\");\n\t\t\t\t\t\tconst relForMatch = rel.startsWith(\"./\") ? rel.slice(2) : rel;\n\t\t\t\t\t\tconst included =\n\t\t\t\t\t\t\tincludePatterns.length === 0 ||\n\t\t\t\t\t\t\tmatchesAnyPattern(normalized, includePatterns) ||\n\t\t\t\t\t\t\tmatchesAnyPattern(relForMatch, includePatterns);\n\t\t\t\t\t\tif (!included) return;\n\t\t\t\t\t\tconst excluded =\n\t\t\t\t\t\t\tmatchesAnyPattern(normalized, excludePatterns) ||\n\t\t\t\t\t\t\tmatchesAnyPattern(relForMatch, excludePatterns);\n\t\t\t\t\t\tif (excluded) return;\n\t\t\t\t\t\tlet kind: FSEventType = \"change\";\n\t\t\t\t\t\tif (eventType === \"rename\") {\n\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\tkind = existsSync(normalized) ? \"create\" : \"delete\";\n\t\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\t\tkind = \"rename\";\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\tpending.set(normalized, {\n\t\t\t\t\t\t\ttype: kind,\n\t\t\t\t\t\t\tpath: normalized,\n\t\t\t\t\t\t\troot,\n\t\t\t\t\t\t\trelative_path: relForMatch,\n\t\t\t\t\t\t\ttimestamp_ns: wallClockNs(),\n\t\t\t\t\t\t});\n\t\t\t\t\t\tif (timer !== undefined) clearTimeout(timer);\n\t\t\t\t\t\tconst token = generation;\n\t\t\t\t\t\ttimer = setTimeout(() => flush(token), debounce);\n\t\t\t\t\t},\n\t\t\t\t);\n\t\t\t\twatcher.on(\"error\", (err) => emitError(err));\n\t\t\t\twatchers.push(watcher);\n\t\t\t}\n\t\t} catch (err) {\n\t\t\temitError(err);\n\t\t}\n\t\treturn () => {\n\t\t\tstopped = true;\n\t\t\tgeneration += 1;\n\t\t\tif (timer !== undefined) clearTimeout(timer);\n\t\t\ttimer = undefined;\n\t\t\tcloseWatchers();\n\t\t\tpending.clear();\n\t\t};\n\t}, sourceOpts(rest));\n}\n","/**\n * Git hook source — Node-only reactive source that polls a repository's HEAD\n * and emits structured `GitEvent`s on every new commit.\n *\n * Isolated from `./adapters.ts` so that the universal `extra/index` barrel\n * stays browser-safe. Access via `@graphrefly/graphrefly/extra/node`, which\n * re-exports this module.\n *\n * @module\n */\n\nimport { ERROR, type Node, type NodeOptions, node, wallClockNs } from \"@graphrefly/pure-ts/core\";\nimport { fromTimer, globToRegExp, matchesAnyPattern, switchMap } from \"@graphrefly/pure-ts/extra\";\n\ntype ExtraOpts = Omit<NodeOptions, \"describeKind\">;\n\n/** Git hook type for {@link fromGitHook}. */\nexport type GitHookType = \"post-commit\" | \"post-merge\" | \"post-checkout\" | \"post-rewrite\";\n\n/** Structured git event emitted by {@link fromGitHook}. */\nexport type GitEvent = {\n\thook: GitHookType;\n\tcommit: string;\n\tfiles: string[];\n\tmessage: string;\n\tauthor: string;\n\ttimestamp_ns: number;\n};\n\n/** Options for {@link fromGitHook}. */\nexport type FromGitHookOptions = ExtraOpts & {\n\tpollMs?: number;\n\tinclude?: string[];\n\texclude?: string[];\n\t/**\n\t * Maximum consecutive poll errors before terminating the source. Prevents\n\t * error storms when the repository is unavailable (e.g. deleted, corrupt,\n\t * permissions lost). Default: `1` (terminate on first error — preserves\n\t * pre-switchMap back-compat). Raise it (or set `Infinity`) to keep\n\t * retrying indefinitely (legacy behavior).\n\t */\n\tmaxConsecutiveErrors?: number;\n};\n\n/**\n * Git change detection as a reactive source.\n *\n * @category extra\n */\nexport function fromGitHook(repoPath: string, opts?: FromGitHookOptions): Node<GitEvent> {\n\tconst { pollMs = 5000, include, exclude, maxConsecutiveErrors = 1 } = opts ?? {};\n\tconst includePatterns = include?.map(globToRegExp) ?? [];\n\tconst excludePatterns = exclude?.map(globToRegExp) ?? [];\n\tconst { execFileSync } = require(\"node:child_process\") as typeof import(\"node:child_process\");\n\n\tconst gitQuery = (args: string[]): string =>\n\t\texecFileSync(\"git\", args, { cwd: repoPath, encoding: \"utf-8\" }).trim();\n\n\t// Shared across ticks: the previous HEAD we committed to. Undefined on the\n\t// very first poll (we record the initial HEAD without emitting).\n\tlet lastSeen: string | undefined;\n\t// Circuit breaker: consecutive error count. Resets on any successful poll.\n\tlet consecutiveErrors = 0;\n\n\t// `fromTimer | switchMap(sync-git-diff)` — ticks drive the poll, switchMap\n\t// cancels any in-flight inner on next tick. First tick at t=0 records the\n\t// baseline HEAD silently; subsequent ticks emit `GitEvent` on HEAD change.\n\treturn switchMap(fromTimer(0, { period: pollMs }), () =>\n\t\tnode<GitEvent>((_data, a) => {\n\t\t\ttry {\n\t\t\t\tconst head = gitQuery([\"rev-parse\", \"HEAD\"]);\n\t\t\t\tif (!head) {\n\t\t\t\t\tconsecutiveErrors = 0;\n\t\t\t\t\treturn () => {};\n\t\t\t\t}\n\t\t\t\tif (lastSeen === undefined) {\n\t\t\t\t\t// First poll: record baseline; stay idle until next tick\n\t\t\t\t\t// disposes this inner.\n\t\t\t\t\tlastSeen = head;\n\t\t\t\t\tconsecutiveErrors = 0;\n\t\t\t\t\treturn () => {};\n\t\t\t\t}\n\t\t\t\tif (head === lastSeen) {\n\t\t\t\t\tconsecutiveErrors = 0;\n\t\t\t\t\treturn () => {};\n\t\t\t\t}\n\t\t\t\tlet files = gitQuery([\"diff\", \"--name-only\", `${lastSeen}..${head}`])\n\t\t\t\t\t.split(\"\\n\")\n\t\t\t\t\t.filter(Boolean);\n\t\t\t\tif (includePatterns.length > 0) {\n\t\t\t\t\tfiles = files.filter((f) => matchesAnyPattern(f, includePatterns));\n\t\t\t\t}\n\t\t\t\tif (excludePatterns.length > 0) {\n\t\t\t\t\tfiles = files.filter((f) => !matchesAnyPattern(f, excludePatterns));\n\t\t\t\t}\n\t\t\t\tconst message = gitQuery([\"log\", \"-1\", \"--format=%s\", head]);\n\t\t\t\tconst author = gitQuery([\"log\", \"-1\", \"--format=%an\", head]);\n\t\t\t\ta.emit({\n\t\t\t\t\thook: \"post-commit\" as GitHookType,\n\t\t\t\t\tcommit: head,\n\t\t\t\t\tfiles,\n\t\t\t\t\tmessage,\n\t\t\t\t\tauthor,\n\t\t\t\t\ttimestamp_ns: wallClockNs(),\n\t\t\t\t});\n\t\t\t\tlastSeen = head;\n\t\t\t\tconsecutiveErrors = 0;\n\t\t\t} catch (err) {\n\t\t\t\tconsecutiveErrors += 1;\n\t\t\t\tif (consecutiveErrors >= maxConsecutiveErrors) {\n\t\t\t\t\ta.down([[ERROR, err]]);\n\t\t\t\t}\n\t\t\t\t// else: transient error — next tick will retry; don't spam ERROR.\n\t\t\t}\n\t\t\treturn () => {};\n\t\t}),\n\t);\n}\n","/**\n * Child-process reactive sources — Node-only.\n *\n * Isolated from `./sources.ts` so bundlers targeting the browser can import\n * browser-safe sources without pulling in `node:child_process`.\n *\n * Access via `@graphrefly/graphrefly/extra/node`, which re-exports this module.\n *\n * @module\n */\n\nimport { type SpawnOptions, spawn } from \"node:child_process\";\nimport { COMPLETE, DATA, ERROR, type Messages, type Node, node } from \"@graphrefly/pure-ts/core\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * SpawnEvent — discriminated stream emitted by {@link fromSpawn}.\n *\n * @category extra\n */\nexport type SpawnEvent =\n\t| { kind: \"stdout\"; chunk: Buffer }\n\t| { kind: \"stderr\"; chunk: Buffer }\n\t| { kind: \"exit\"; code: number | null; signal: NodeJS.Signals | null };\n\n/** Options for {@link fromSpawn}. Mirrors `child_process.SpawnOptions`. */\nexport interface FromSpawnOptions {\n\tcwd?: string;\n\tenv?: NodeJS.ProcessEnv;\n\tshell?: boolean | string;\n\t/**\n\t * Optional caller-owned AbortSignal. When fired, the subprocess is sent\n\t * SIGTERM (per `child_process.spawn` signal semantics). The producer's own\n\t * teardown also sends SIGTERM regardless of caller signal — so `switchMap`\n\t * supersede in `actuatorExecutor` cancels in-flight subprocesses without\n\t * the caller wiring extra signals.\n\t */\n\tsignal?: AbortSignal;\n\t/** Extra args forwarded to spawn — e.g. stdio configuration. */\n\tstdio?: \"pipe\" | readonly (\"pipe\" | \"ignore\" | \"inherit\")[];\n}\n\n// ---------------------------------------------------------------------------\n// fromSpawn\n// ---------------------------------------------------------------------------\n\n/**\n * Spawn `cmd args` as a child process and stream stdout/stderr/exit as a\n * single discriminated `SpawnEvent` stream.\n *\n * Lifecycle:\n * - Stdout/stderr chunks emit as `DATA { kind: \"stdout\"|\"stderr\", chunk }`.\n * - Process exit emits one final `DATA { kind: \"exit\", code, signal }` then\n *   `COMPLETE`.\n * - Spawn-error (ENOENT, EPERM, …) emits `ERROR`.\n * - Producer teardown sends `SIGTERM` to the subprocess if it is still alive.\n *\n * **Multicast semantics:** `fromSpawn` returns a node backed by a single\n * `producer` activation — the subprocess is spawned once when the first\n * subscriber connects, and all subsequent subscribers share the same event\n * stream. Unsubscribing the last subscriber tears down the subprocess.\n *\n * @example\n * ```ts\n * import { fromSpawn } from \"@graphrefly/graphrefly/extra/node\";\n *\n * const stream = fromSpawn(\"git\", [\"log\", \"--oneline\"]);\n * stream.subscribe((msgs) => {\n *   for (const [type, value] of msgs) {\n *     if (type === DATA) console.log(value);\n *   }\n * });\n * ```\n *\n * @category extra\n */\nexport function fromSpawn(\n\tcmd: string,\n\targs: readonly string[],\n\topts?: FromSpawnOptions,\n): Node<SpawnEvent> {\n\treturn node<SpawnEvent>(\n\t\t(_data, actions) => {\n\t\t\tconst child = spawn(cmd, args as string[], {\n\t\t\t\tcwd: opts?.cwd,\n\t\t\t\tenv: opts?.env,\n\t\t\t\tshell: opts?.shell,\n\t\t\t\tsignal: opts?.signal,\n\t\t\t\tstdio: (opts?.stdio as SpawnOptions[\"stdio\"]) ?? \"pipe\",\n\t\t\t});\n\n\t\t\tlet alive = true;\n\t\t\tlet exitInfo: { code: number | null; signal: NodeJS.Signals | null } | null = null;\n\n\t\t\tchild.stdout?.on(\"data\", (chunk: Buffer) => {\n\t\t\t\tif (!alive) return;\n\t\t\t\tactions.down([[DATA, { kind: \"stdout\", chunk }]] satisfies Messages);\n\t\t\t});\n\n\t\t\tchild.stderr?.on(\"data\", (chunk: Buffer) => {\n\t\t\t\tif (!alive) return;\n\t\t\t\tactions.down([[DATA, { kind: \"stderr\", chunk }]] satisfies Messages);\n\t\t\t});\n\n\t\t\tchild.on(\"error\", (err) => {\n\t\t\t\tif (!alive) return;\n\t\t\t\talive = false;\n\t\t\t\tactions.down([[ERROR, err]] satisfies Messages);\n\t\t\t});\n\n\t\t\tchild.on(\"exit\", (code, signal) => {\n\t\t\t\t// Capture exit info, but defer terminal emission to \"close\" — by which\n\t\t\t\t// time all stdout/stderr \"data\" events have been delivered.\n\t\t\t\tif (exitInfo == null) exitInfo = { code, signal: signal as NodeJS.Signals | null };\n\t\t\t});\n\n\t\t\tchild.on(\"close\", () => {\n\t\t\t\tif (!alive) return;\n\t\t\t\talive = false;\n\t\t\t\tconst info = exitInfo ?? { code: null, signal: null };\n\t\t\t\tactions.down([\n\t\t\t\t\t[DATA, { kind: \"exit\", code: info.code, signal: info.signal }],\n\t\t\t\t\t[COMPLETE],\n\t\t\t\t] satisfies Messages);\n\t\t\t});\n\n\t\t\treturn () => {\n\t\t\t\tif (alive) {\n\t\t\t\t\talive = false;\n\t\t\t\t\tchild.stdout?.removeAllListeners();\n\t\t\t\t\tchild.stderr?.removeAllListeners();\n\t\t\t\t\tchild.removeAllListeners(\"error\");\n\t\t\t\t\tchild.removeAllListeners(\"exit\");\n\t\t\t\t\tchild.removeAllListeners(\"close\");\n\t\t\t\t\ttry {\n\t\t\t\t\t\tchild.kill(\"SIGTERM\");\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// already dead — ignore\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t};\n\t\t},\n\t\t{ name: \"from_spawn\" },\n\t);\n}\n\n// ---------------------------------------------------------------------------\n// runProcess\n// ---------------------------------------------------------------------------\n\n/**\n * Run `cmd args` to completion and emit one DATA with aggregated output.\n *\n * Convenience over {@link fromSpawn} for the \"wait for the process to finish,\n * capture stdout/stderr as strings, get exit code\" case.\n *\n * Aggregation policy: stdout and stderr are concatenated as `Buffer`s and\n * decoded as utf-8 once at exit, so multi-byte sequences split across chunks\n * are handled correctly. Actuators that need byte-exact stdout should use\n * `fromSpawn` directly.\n *\n * @example\n * ```ts\n * import { runProcess } from \"@graphrefly/graphrefly/extra/node\";\n *\n * const result = runProcess(\"git\", [\"rev-parse\", \"HEAD\"]);\n * result.subscribe((msgs) => {\n *   for (const [type, value] of msgs) {\n *     if (type === DATA) console.log(value.stdout.trim());\n *   }\n * });\n * ```\n *\n * @category extra\n */\nexport function runProcess(\n\tcmd: string,\n\targs: readonly string[],\n\topts?: FromSpawnOptions,\n): Node<{\n\tstdout: string;\n\tstderr: string;\n\texitCode: number | null;\n\tsignal: NodeJS.Signals | null;\n}> {\n\ttype Result = {\n\t\tstdout: string;\n\t\tstderr: string;\n\t\texitCode: number | null;\n\t\tsignal: NodeJS.Signals | null;\n\t};\n\treturn node<Result>(\n\t\t(_data, actions) => {\n\t\t\tconst child = spawn(cmd, args as string[], {\n\t\t\t\tcwd: opts?.cwd,\n\t\t\t\tenv: opts?.env,\n\t\t\t\tshell: opts?.shell,\n\t\t\t\tsignal: opts?.signal,\n\t\t\t\tstdio: (opts?.stdio as SpawnOptions[\"stdio\"]) ?? \"pipe\",\n\t\t\t});\n\n\t\t\tlet alive = true;\n\t\t\tconst stdoutChunks: Buffer[] = [];\n\t\t\tconst stderrChunks: Buffer[] = [];\n\t\t\tlet exitInfo: { code: number | null; signal: NodeJS.Signals | null } | null = null;\n\n\t\t\tchild.stdout?.on(\"data\", (chunk: Buffer) => {\n\t\t\t\tif (!alive) return;\n\t\t\t\tstdoutChunks.push(chunk);\n\t\t\t});\n\n\t\t\tchild.stderr?.on(\"data\", (chunk: Buffer) => {\n\t\t\t\tif (!alive) return;\n\t\t\t\tstderrChunks.push(chunk);\n\t\t\t});\n\n\t\t\tchild.on(\"error\", (err) => {\n\t\t\t\tif (!alive) return;\n\t\t\t\talive = false;\n\t\t\t\tactions.down([[ERROR, err]] satisfies Messages);\n\t\t\t});\n\n\t\t\tchild.on(\"exit\", (code, signal) => {\n\t\t\t\t// Capture exit info, but defer terminal emission to \"close\" — by which\n\t\t\t\t// time all stdout/stderr \"data\" events have been delivered.\n\t\t\t\tif (exitInfo == null) exitInfo = { code, signal: signal as NodeJS.Signals | null };\n\t\t\t});\n\n\t\t\tchild.on(\"close\", () => {\n\t\t\t\tif (!alive) return;\n\t\t\t\talive = false;\n\t\t\t\tconst info = exitInfo ?? { code: null, signal: null };\n\t\t\t\tconst stdout = Buffer.concat(stdoutChunks).toString(\"utf8\");\n\t\t\t\tconst stderr = Buffer.concat(stderrChunks).toString(\"utf8\");\n\t\t\t\tactions.down([\n\t\t\t\t\t[\n\t\t\t\t\t\tDATA,\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tstdout,\n\t\t\t\t\t\t\tstderr,\n\t\t\t\t\t\t\texitCode: info.code,\n\t\t\t\t\t\t\tsignal: info.signal,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\t[COMPLETE],\n\t\t\t\t] satisfies Messages);\n\t\t\t});\n\n\t\t\treturn () => {\n\t\t\t\tif (alive) {\n\t\t\t\t\talive = false;\n\t\t\t\t\tchild.stdout?.removeAllListeners();\n\t\t\t\t\tchild.stderr?.removeAllListeners();\n\t\t\t\t\tchild.removeAllListeners(\"error\");\n\t\t\t\t\tchild.removeAllListeners(\"exit\");\n\t\t\t\t\tchild.removeAllListeners(\"close\");\n\t\t\t\t\ttry {\n\t\t\t\t\t\tchild.kill(\"SIGTERM\");\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// already dead — ignore\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t};\n\t\t},\n\t\t{ name: \"run_process\" },\n\t);\n}\n"],"mappings":"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","names":["resolvePath","import_core","import_extra","import_core"]}

package/dist/base/sources/node/index.d.cts

@@ -0,0 +1,185 @@
+import { NodeOptions, Node } from '@graphrefly/pure-ts/core';
+
+/**
+ * Filesystem-watching source. Isolated from `./sources.ts` so bundlers
+ * targeting the browser can import browser-safe sources (`fromTimer`,
+ * `fromRaf`, etc.) without pulling in `node:fs`/`node:path`.
+ */
+
+type ExtraOpts$1 = Omit<NodeOptions<unknown>, "describeKind">;
+type FSEventType = "change" | "rename" | "create" | "delete";
+type FSEvent = {
+    type: FSEventType;
+    path: string;
+    root: string;
+    relative_path: string;
+    src_path?: string;
+    dest_path?: string;
+    timestamp_ns: number;
+};
+type FromFSWatchOptions = ExtraOpts$1 & {
+    recursive?: boolean;
+    debounce?: number;
+    include?: string[];
+    exclude?: string[];
+};
+/**
+ * Watches filesystem paths and emits debounced change events.
+ *
+ * Uses `fs.watch` only (no polling fallback). Teardown closes all watchers.
+ *
+ * @category extra
+ */
+declare function fromFSWatch(paths: string | string[], opts?: FromFSWatchOptions): Node<FSEvent>;
+
+/**
+ * Git hook source — Node-only reactive source that polls a repository's HEAD
+ * and emits structured `GitEvent`s on every new commit.
+ *
+ * Isolated from `./adapters.ts` so that the universal `extra/index` barrel
+ * stays browser-safe. Access via `@graphrefly/graphrefly/extra/node`, which
+ * re-exports this module.
+ *
+ * @module
+ */
+
+type ExtraOpts = Omit<NodeOptions, "describeKind">;
+/** Git hook type for {@link fromGitHook}. */
+type GitHookType = "post-commit" | "post-merge" | "post-checkout" | "post-rewrite";
+/** Structured git event emitted by {@link fromGitHook}. */
+type GitEvent = {
+    hook: GitHookType;
+    commit: string;
+    files: string[];
+    message: string;
+    author: string;
+    timestamp_ns: number;
+};
+/** Options for {@link fromGitHook}. */
+type FromGitHookOptions = ExtraOpts & {
+    pollMs?: number;
+    include?: string[];
+    exclude?: string[];
+    /**
+     * Maximum consecutive poll errors before terminating the source. Prevents
+     * error storms when the repository is unavailable (e.g. deleted, corrupt,
+     * permissions lost). Default: `1` (terminate on first error — preserves
+     * pre-switchMap back-compat). Raise it (or set `Infinity`) to keep
+     * retrying indefinitely (legacy behavior).
+     */
+    maxConsecutiveErrors?: number;
+};
+/**
+ * Git change detection as a reactive source.
+ *
+ * @category extra
+ */
+declare function fromGitHook(repoPath: string, opts?: FromGitHookOptions): Node<GitEvent>;
+
+/**
+ * Child-process reactive sources — Node-only.
+ *
+ * Isolated from `./sources.ts` so bundlers targeting the browser can import
+ * browser-safe sources without pulling in `node:child_process`.
+ *
+ * Access via `@graphrefly/graphrefly/extra/node`, which re-exports this module.
+ *
+ * @module
+ */
+
+/**
+ * SpawnEvent — discriminated stream emitted by {@link fromSpawn}.
+ *
+ * @category extra
+ */
+type SpawnEvent = {
+    kind: "stdout";
+    chunk: Buffer;
+} | {
+    kind: "stderr";
+    chunk: Buffer;
+} | {
+    kind: "exit";
+    code: number | null;
+    signal: NodeJS.Signals | null;
+};
+/** Options for {@link fromSpawn}. Mirrors `child_process.SpawnOptions`. */
+interface FromSpawnOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    shell?: boolean | string;
+    /**
+     * Optional caller-owned AbortSignal. When fired, the subprocess is sent
+     * SIGTERM (per `child_process.spawn` signal semantics). The producer's own
+     * teardown also sends SIGTERM regardless of caller signal — so `switchMap`
+     * supersede in `actuatorExecutor` cancels in-flight subprocesses without
+     * the caller wiring extra signals.
+     */
+    signal?: AbortSignal;
+    /** Extra args forwarded to spawn — e.g. stdio configuration. */
+    stdio?: "pipe" | readonly ("pipe" | "ignore" | "inherit")[];
+}
+/**
+ * Spawn `cmd args` as a child process and stream stdout/stderr/exit as a
+ * single discriminated `SpawnEvent` stream.
+ *
+ * Lifecycle:
+ * - Stdout/stderr chunks emit as `DATA { kind: "stdout"|"stderr", chunk }`.
+ * - Process exit emits one final `DATA { kind: "exit", code, signal }` then
+ *   `COMPLETE`.
+ * - Spawn-error (ENOENT, EPERM, …) emits `ERROR`.
+ * - Producer teardown sends `SIGTERM` to the subprocess if it is still alive.
+ *
+ * **Multicast semantics:** `fromSpawn` returns a node backed by a single
+ * `producer` activation — the subprocess is spawned once when the first
+ * subscriber connects, and all subsequent subscribers share the same event
+ * stream. Unsubscribing the last subscriber tears down the subprocess.
+ *
+ * @example
+ * ```ts
+ * import { fromSpawn } from "@graphrefly/graphrefly/extra/node";
+ *
+ * const stream = fromSpawn("git", ["log", "--oneline"]);
+ * stream.subscribe((msgs) => {
+ *   for (const [type, value] of msgs) {
+ *     if (type === DATA) console.log(value);
+ *   }
+ * });
+ * ```
+ *
+ * @category extra
+ */
+declare function fromSpawn(cmd: string, args: readonly string[], opts?: FromSpawnOptions): Node<SpawnEvent>;
+/**
+ * Run `cmd args` to completion and emit one DATA with aggregated output.
+ *
+ * Convenience over {@link fromSpawn} for the "wait for the process to finish,
+ * capture stdout/stderr as strings, get exit code" case.
+ *
+ * Aggregation policy: stdout and stderr are concatenated as `Buffer`s and
+ * decoded as utf-8 once at exit, so multi-byte sequences split across chunks
+ * are handled correctly. Actuators that need byte-exact stdout should use
+ * `fromSpawn` directly.
+ *
+ * @example
+ * ```ts
+ * import { runProcess } from "@graphrefly/graphrefly/extra/node";
+ *
+ * const result = runProcess("git", ["rev-parse", "HEAD"]);
+ * result.subscribe((msgs) => {
+ *   for (const [type, value] of msgs) {
+ *     if (type === DATA) console.log(value.stdout.trim());
+ *   }
+ * });
+ * ```
+ *
+ * @category extra
+ */
+declare function runProcess(cmd: string, args: readonly string[], opts?: FromSpawnOptions): Node<{
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+}>;
+
+export { type FSEvent, type FSEventType, type FromFSWatchOptions, type FromGitHookOptions, type FromSpawnOptions, type GitEvent, type GitHookType, type SpawnEvent, fromFSWatch, fromGitHook, fromSpawn, runProcess };