stitchkit 0.103.9 → 0.103.11

package/dist/index-7kxw1awn.js

@@ -1,328 +0,0 @@
-import {
-  loadDarwinBinding
-} from "./index-d4pa2bgs.js";
-import {
-  isRecord
-} from "./index-9jfdm5tg.js";
-
-// src/internal/exclusive-lock.ts
-import { constants } from "node:fs";
-import { lstat, open, unlink } from "node:fs/promises";
-import { hostname } from "node:os";
-import { z as z2 } from "zod";
-
-// src/internal/process-identity.ts
-import { execFile } from "node:child_process";
-import { readFile } from "node:fs/promises";
-import { platform } from "node:os";
-import { promisify } from "node:util";
-var detectedIdentity;
-async function firstReadableLine(paths) {
-  for (const path of paths) {
-    try {
-      const text = (await readFile(path, "utf8")).trim();
-      if (text.length > 0)
-        return text;
-    } catch {}
-  }
-  return null;
-}
-var run = promisify(execFile);
-function parsePlatformUuid(dump) {
-  return /"IOPlatformUUID"\s*=\s*"([^"]+)"/.exec(dump)?.[1] ?? null;
-}
-async function readDarwinPlatformUuid(command = "ioreg") {
-  try {
-    const { stdout } = await run(command, ["-rd1", "-c", "IOPlatformExpertDevice"], {
-      timeout: 2000,
-      maxBuffer: 1 << 20,
-      encoding: "utf8"
-    });
-    return parsePlatformUuid(stdout);
-  } catch {
-    return null;
-  }
-}
-async function machineIdentity(declared) {
-  if (declared !== undefined)
-    return declared;
-  if (detectedIdentity !== undefined)
-    return detectedIdentity;
-  detectedIdentity = platform() === "darwin" ? await readDarwinPlatformUuid() : await firstReadableLine(["/etc/machine-id", "/var/lib/dbus/machine-id"]);
-  return detectedIdentity;
-}
-async function probeLiveness(pid, reach = (target) => process.kill(target, 0)) {
-  try {
-    reach(pid);
-  } catch (error) {
-    return isRecord(error) && error.code === "ESRCH" ? "gone" : "alive";
-  }
-  return await isZombieProcess(pid) ? "gone" : "alive";
-}
-async function isZombieProcess(pid, seam = {}) {
-  const { procRoot = "/proc", psCommand = "ps" } = seam;
-  try {
-    const stat = await readFile(`${procRoot}/${pid}/stat`, "utf8");
-    return stat.slice(stat.lastIndexOf(")") + 1).trimStart().startsWith("Z");
-  } catch {}
-  try {
-    const { stdout } = await run(psCommand, ["-o", "state=", "-p", String(pid)], {
-      timeout: 2000,
-      maxBuffer: 1 << 16,
-      encoding: "utf8"
-    });
-    return stdout.trim().startsWith("Z");
-  } catch {
-    return false;
-  }
-}
-
-// src/internal/process-instance.ts
-import { readFile as readFile2, readlink } from "node:fs/promises";
-import { platform as platform2 } from "node:os";
-import { z } from "zod";
-var ProcessInstanceSchema = z.object({
-  platform: z.enum(["linux", "darwin"]),
-  bootId: z.string().min(1),
-  namespace: z.string().min(1),
-  startId: z.string().regex(/^\d+$/)
-}).strict();
-function linuxProcessStart(stat, pid) {
-  if (!stat.startsWith(`${pid} (`))
-    return null;
-  const end = stat.lastIndexOf(")");
-  if (end < 0)
-    return null;
-  const start = stat.slice(end + 1).trim().split(/\s+/)[19];
-  return start !== undefined && /^\d+$/.test(start) ? start : null;
-}
-async function readProcessInstance(pid, procRoot = "/proc") {
-  try {
-    if (platform2() === "darwin") {
-      const result = ProcessInstanceSchema.safeParse(loadDarwinBinding().processIdentity(pid));
-      return result.success ? result.data : null;
-    }
-    if (platform2() !== "linux")
-      return null;
-    const [bootId, namespace, ownStatus, timeNamespace, ownStat, stat] = await Promise.all([
-      readFile2(`${procRoot}/sys/kernel/random/boot_id`, "utf8"),
-      readlink(`${procRoot}/self/ns/pid`),
-      readFile2(`${procRoot}/self/status`, "utf8"),
-      readlink(`${procRoot}/self/ns/time`).catch((error) => {
-        if (error instanceof Error && "code" in error && error.code === "ENOENT")
-          return "";
-        throw error;
-      }),
-      readFile2(`${procRoot}/self/stat`, "utf8"),
-      readFile2(`${procRoot}/${pid}/stat`, "utf8")
-    ]);
-    const namespacePids = ownStatus.match(/^NStgid:[ \t]*(.*)$/m)?.[1]?.trim().split(/\s+/);
-    if (namespacePids?.length !== 1 || namespacePids[0] !== String(process.pid) || linuxProcessStart(ownStat, process.pid) === null)
-      return null;
-    const startId = linuxProcessStart(stat, pid);
-    if (startId === null || !bootId.trim())
-      return null;
-    return {
-      platform: "linux",
-      bootId: bootId.trim(),
-      namespace: `${namespace};${timeNamespace}`,
-      startId
-    };
-  } catch {
-    return null;
-  }
-}
-async function probeProcessOwner(pid, recorded, probes = { read: readProcessInstance, liveness: probeLiveness }) {
-  if (recorded === undefined)
-    return { liveness: await probes.liveness(pid), identity: "legacy" };
-  const unavailable = {
-    liveness: "not-probed",
-    identity: "unavailable"
-  };
-  if (recorded === null)
-    return unavailable;
-  const current = await probes.read(process.pid);
-  if (!current || recorded.platform !== current.platform)
-    return unavailable;
-  if (recorded.bootId !== current.bootId)
-    return { liveness: "gone", identity: "different-boot" };
-  if (recorded.namespace !== current.namespace)
-    return unavailable;
-  const liveness = await probes.liveness(pid);
-  if (liveness === "gone")
-    return { liveness, identity: "pid-gone" };
-  const observed = await probes.read(pid);
-  if (!observed || observed.bootId !== current.bootId || observed.namespace !== current.namespace)
-    return unavailable;
-  if (recorded.startId !== observed.startId)
-    return { liveness: "gone", identity: "reused-pid" };
-  return { liveness: "alive", identity: "matched" };
-}
-
-// src/internal/exclusive-lock.ts
-var ExclusiveLockOwnerSchema = z2.object({
-  pid: z2.number().int().positive().max(Number.MAX_SAFE_INTEGER),
-  host: z2.string().min(1),
-  acquiredAt: z2.string(),
-  machine: z2.string().min(1).optional().catch(undefined),
-  process: ProcessInstanceSchema.nullable().optional().catch(null)
-});
-function isCode(error, code) {
-  return isRecord(error) && error.code === code;
-}
-function readOwner(text) {
-  let parsed;
-  try {
-    parsed = JSON.parse(text);
-  } catch {
-    return;
-  }
-  const owner = ExclusiveLockOwnerSchema.safeParse(parsed);
-  return owner.success ? owner.data : undefined;
-}
-function attribute(owner, identity) {
-  if (identity !== null && owner.machine !== undefined) {
-    return owner.machine === identity ? "this-machine" : "another-machine";
-  }
-  return owner.host === hostname() ? "this-machine" : "unattributable";
-}
-async function diagnose(owner, declaredIdentity) {
-  if (!owner)
-    return { attribution: "unattributable", liveness: "not-probed", owner: null };
-  const attribution = attribute(owner, await machineIdentity(declaredIdentity));
-  if (attribution !== "this-machine")
-    return { attribution, liveness: "not-probed", owner };
-  return { attribution, ...await probeProcessOwner(owner.pid, owner.process), owner };
-}
-async function readLockFile(path) {
-  let handle;
-  try {
-    handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
-    const info = await handle.stat();
-    return {
-      owner: readOwner(await handle.readFile("utf8")),
-      ino: info.ino,
-      mtimeMs: info.mtimeMs
-    };
-  } catch {
-    return;
-  } finally {
-    await handle?.close().catch(() => {
-      return;
-    });
-  }
-}
-async function unlinkIfSame(path, ino) {
-  try {
-    if ((await lstat(path)).ino !== ino)
-      return;
-    await unlink(path);
-  } catch (error) {
-    if (!isCode(error, "ENOENT"))
-      throw error;
-  }
-}
-async function createOwned(path, options, reclaimed) {
-  const identity = await machineIdentity(options.machineIdentity);
-  const instance = await readProcessInstance(process.pid);
-  const handle = await open(path, "wx", options.mode);
-  const owner = {
-    pid: process.pid,
-    process: instance,
-    host: hostname(),
-    acquiredAt: new Date().toISOString(),
-    ...identity !== null && { machine: identity }
-  };
-  let ino;
-  try {
-    await handle.writeFile(`${JSON.stringify(owner)}
-`, "utf8");
-    ino = (await handle.stat()).ino;
-  } catch (error) {
-    await handle.close().catch(() => {
-      return;
-    });
-    await unlink(path).catch(() => {
-      return;
-    });
-    throw error;
-  }
-  let released = false;
-  return {
-    path,
-    owner,
-    reclaimed,
-    async release() {
-      if (released)
-        return;
-      released = true;
-      try {
-        await handle.close();
-      } finally {
-        await unlinkIfSame(path, ino);
-      }
-    }
-  };
-}
-function reclaimable(state, diagnosis, graceMs) {
-  if (state.owner)
-    return diagnosis.liveness === "gone";
-  return graceMs !== undefined && Date.now() - state.mtimeMs >= graceMs;
-}
-async function reclaimUnderGuard(path, options) {
-  const guardPath = `${path}.reclaim`;
-  let guard;
-  try {
-    guard = await createOwned(guardPath, options, false);
-  } catch (error) {
-    if (!isCode(error, "EEXIST"))
-      throw error;
-    const stale = await readLockFile(guardPath);
-    if (stale) {
-      const verdict = await diagnose(stale.owner, options.machineIdentity);
-      if (reclaimable(stale, verdict, options.ownerlessGraceMs ?? 5000)) {
-        await unlinkIfSame(guardPath, stale.ino);
-      }
-    }
-    return;
-  }
-  try {
-    const state = await readLockFile(path);
-    if (state) {
-      const diagnosis = await diagnose(state.owner, options.machineIdentity);
-      if (!reclaimable(state, diagnosis, options.ownerlessGraceMs))
-        return "refused";
-      await unlinkIfSame(path, state.ino);
-    }
-    return await createOwned(path, options, state !== undefined).catch((error) => {
-      if (isCode(error, "EEXIST"))
-        return "refused";
-      throw error;
-    });
-  } finally {
-    await guard.release().catch(() => {
-      return;
-    });
-  }
-}
-async function attemptExclusiveLock(path, options) {
-  try {
-    return { held: await createOwned(path, options, false) };
-  } catch (error) {
-    if (!isCode(error, "EEXIST"))
-      throw error;
-    if (!options.reclaim)
-      return { error };
-    const state = await readLockFile(path);
-    const diagnosis = await diagnose(state?.owner, options.machineIdentity);
-    if (!state || !reclaimable(state, diagnosis, options.ownerlessGraceMs)) {
-      return { error, diagnosis };
-    }
-    const reclaimed = await reclaimUnderGuard(path, options);
-    if (reclaimed !== undefined && reclaimed !== "refused")
-      return { held: reclaimed };
-    return { error, diagnosis };
-  }
-}
-
-export { attemptExclusiveLock };

package/dist/index-eeqmg7qm.js

@@ -1,202 +0,0 @@
-import {
-  raceAbort
-} from "./index-mbnnw3f2.js";
-
-// src/process/contract.ts
-import { z } from "zod";
-var NativeCommandOptionsSchema = z.strictObject({
-  executable: z.string().min(1),
-  args: z.array(z.string()).default([]),
-  cwd: z.string().optional(),
-  env: z.record(z.string(), z.string()).optional(),
-  envPolicy: z.enum(["declared-only", "ambient"]).default("declared-only"),
-  signal: z.custom((v) => v instanceof AbortSignal).optional(),
-  timeoutMs: z.number().int().positive().max(2147483647).optional(),
-  maxOutputBytes: z.number().int().positive().optional(),
-  capture: z.boolean().default(false),
-  stdin: z.custom((v) => v instanceof Uint8Array).optional(),
-  maxStdinBytes: z.number().int().positive().default(1024 * 1024),
-  onOutput: z.custom((v) => typeof v === "function").optional(),
-  killGraceMs: z.number().int().nonnegative().max(1e4).default(100),
-  cleanupTimeoutMs: z.number().int().positive().max(30000).default(2000)
-}).superRefine((input, ctx) => {
-  if (!input.signal && input.timeoutMs === undefined)
-    ctx.addIssue({ code: "custom", message: "Declare a caller signal or a finite timeout" });
-  if (input.capture && input.maxOutputBytes === undefined)
-    ctx.addIssue({
-      code: "custom",
-      message: "Capture requires a finite combined output budget"
-    });
-  if (input.stdin && input.stdin.byteLength > input.maxStdinBytes)
-    ctx.addIssue({ code: "custom", message: "stdin exceeds maxStdinBytes" });
-});
-var NativeCommandResultSchema = z.object({
-  exitCode: z.number().int().nullable(),
-  signal: z.string().nullable(),
-  stdout: z.instanceof(Uint8Array),
-  stderr: z.instanceof(Uint8Array)
-});
-
-class NativeCommandError2 extends Error {
-  code;
-  constructor(code, message, options) {
-    super(message, options);
-    this.code = code;
-    this.name = "NativeCommandError";
-  }
-}
-
-// src/process/command-owner.ts
-import { spawn } from "node:child_process";
-
-// src/process/group.ts
-function signalGroup(pid, signal) {
-  if (pid === undefined)
-    return;
-  try {
-    process.kill(-pid, signal);
-  } catch (error) {
-    if (!(error instanceof Error && ("code" in error) && error.code === "ESRCH"))
-      throw error;
-  }
-}
-function exists(pid) {
-  if (pid === undefined)
-    return false;
-  try {
-    process.kill(-pid, 0);
-    return true;
-  } catch (error) {
-    if (error instanceof Error && "code" in error && error.code === "ESRCH")
-      return false;
-    throw error;
-  }
-}
-async function stopCommandGroup(pid, graceMs) {
-  signalGroup(pid, "SIGTERM");
-  const until = Date.now() + graceMs;
-  while (Date.now() < until && exists(pid))
-    await new Promise((resolve) => setTimeout(resolve, Math.min(10, until - Date.now())));
-  signalGroup(pid, "SIGKILL");
-}
-function commandCleanupError(cause) {
-  return new NativeCommandError2("COMMAND_CLEANUP", "Command cleanup did not complete", {
-    cause
-  });
-}
-function waitForCommandClose(closed, timeoutMs) {
-  return raceAbort(closed, AbortSignal.timeout(timeoutMs));
-}
-
-// src/process/command-owner.ts
-function startNativeCommand(input, onSpawn) {
-  const options = NativeCommandOptionsSchema.parse(input);
-  options.signal?.throwIfAborted();
-  if (process.platform === "win32")
-    throw new NativeCommandError2("COMMAND_UNAVAILABLE", "POSIX process groups are required");
-  const controller = new AbortController;
-  const abort = () => controller.abort(options.signal?.reason);
-  options.signal?.addEventListener("abort", abort, { once: true });
-  if (options.signal?.aborted)
-    abort();
-  const timer = options.timeoutMs === undefined ? undefined : setTimeout(() => controller.abort(new NativeCommandError2("COMMAND_LIMIT", "Command deadline exceeded")), options.timeoutMs);
-  let child;
-  try {
-    child = spawn(options.executable, options.args, {
-      cwd: options.cwd,
-      env: options.envPolicy === "ambient" ? { ...process.env, ...options.env } : options.env ?? {},
-      detached: true,
-      stdio: ["pipe", "pipe", "pipe"]
-    });
-  } catch (cause) {
-    if (timer !== undefined)
-      clearTimeout(timer);
-    options.signal?.removeEventListener("abort", abort);
-    throw new NativeCommandError2("COMMAND_UNAVAILABLE", "Command could not start", { cause });
-  }
-  const stdout = [];
-  const stderr = [];
-  let total = 0;
-  let finished = false;
-  let spawnFailure;
-  const closed = new Promise((resolve) => {
-    child.once("error", (error) => {
-      spawnFailure = new NativeCommandError2("COMMAND_UNAVAILABLE", "Command could not start", {
-        cause: error
-      });
-      controller.abort(spawnFailure);
-    });
-    child.once("close", (exitCode, signal) => resolve({ exitCode, signal }));
-  });
-  child.stdin.on("error", (error) => {
-    if (!(("code" in error) && error.code === "EPIPE"))
-      controller.abort(error);
-  });
-  const drain = async (stream, channel, captured) => {
-    for await (const chunk of stream) {
-      controller.signal.throwIfAborted();
-      if (!(chunk instanceof Uint8Array))
-        throw new TypeError("Expected binary command output");
-      total += chunk.byteLength;
-      if (options.maxOutputBytes !== undefined && total > options.maxOutputBytes)
-        throw new NativeCommandError2("COMMAND_LIMIT", "Command output budget exceeded");
-      if (options.capture)
-        captured.push(Uint8Array.from(chunk));
-      if (options.onOutput)
-        await raceAbort(Promise.resolve().then(() => {
-          controller.signal.throwIfAborted();
-          return options.onOutput?.(chunk, channel, controller.signal);
-        }), controller.signal);
-    }
-  };
-  const result = (async () => {
-    try {
-      onSpawn?.(child);
-      child.stdin.end(options.stdin);
-      const drains = Promise.all([
-        drain(child.stdout, "stdout", stdout),
-        drain(child.stderr, "stderr", stderr)
-      ]);
-      await raceAbort(drains, controller.signal);
-      const status = await raceAbort(closed, controller.signal);
-      if (spawnFailure !== undefined)
-        throw spawnFailure;
-      return { ...status, stdout: Buffer.concat(stdout), stderr: Buffer.concat(stderr) };
-    } catch (error) {
-      controller.abort(error);
-      child.stdin.destroy();
-      child.stdout.destroy();
-      child.stderr.destroy();
-      try {
-        await stopCommandGroup(child.pid, options.killGraceMs);
-        await waitForCommandClose(closed, options.cleanupTimeoutMs);
-      } catch (cleanup) {
-        throw commandCleanupError(new AggregateError([error, cleanup], "Command failed and cleanup failed"));
-      }
-      throw error;
-    } finally {
-      finished = true;
-      if (timer !== undefined)
-        clearTimeout(timer);
-      options.signal?.removeEventListener("abort", abort);
-      controller.abort(new Error("Command completed"));
-    }
-  })();
-  result.catch(() => {
-    return;
-  });
-  return {
-    result,
-    async stop() {
-      if (!finished)
-        controller.abort(new DOMException("Command stopped", "AbortError"));
-      await result.then(() => {
-        return;
-      }, () => {
-        return;
-      });
-    }
-  };
-}
-
-export { NativeCommandError2, startNativeCommand };