@veryfront/ext-content-mdx 0.1.1239 → 0.1.1241

package/esm/src/platform/compat/process/command.js

@@ -1,525 +0,0 @@
-import * as dntShim from "../../../../_dnt.shims.js";
-import { dynamicImport } from "../dynamic-import.js";
-import { addAbortSignalListenerOnce, isAbortSignalAborted, isAbortSignalWithoutHooks, removeAbortSignalListener, } from "../abort-signal.js";
-import { getDenoRuntime, isBun as IS_BUN, isDeno as IS_DENO } from "../runtime.js";
-import { isWindowsPlatform, runtimeProcess } from "./runtime-process.js";
-const COMMAND_TIMEOUT_EXIT_CODE = 124;
-const COMMAND_OUTPUT_LIMIT_EXIT_CODE = 125;
-const COMMAND_ABORT_EXIT_CODE = 130;
-const FORCE_KILL_GRACE_MS = 250;
-const DEFAULT_MAX_OUTPUT_BYTES = 16 * 1024 * 1024;
-const MAX_COMMAND_TIMEOUT_MS = 2_147_483_647;
-const apply = Reflect.apply;
-const uint8ArraySlice = Uint8Array.prototype.slice;
-function createTerminationResult(reason, detail, stdout, stderr, outputTruncated = reason === "output-limit") {
-    const message = reason === "timeout"
-        ? `Command timed out after ${detail}ms`
-        : reason === "output-limit"
-            ? `Command output exceeded ${detail} bytes`
-            : "Command aborted";
-    return {
-        success: false,
-        code: reason === "timeout"
-            ? COMMAND_TIMEOUT_EXIT_CODE
-            : reason === "output-limit"
-                ? COMMAND_OUTPUT_LIMIT_EXIT_CODE
-                : COMMAND_ABORT_EXIT_CODE,
-        stdout,
-        stderr: `${stderr ?? ""}\n${message}`.trim(),
-        outputTruncated: outputTruncated || undefined,
-    };
-}
-function validateAbortSignal(signal) {
-    if (signal === undefined)
-        return;
-    if (!isAbortSignalWithoutHooks(signal)) {
-        throw new TypeError("signal must be an AbortSignal");
-    }
-}
-function resolveCommandTimeoutMs(timeoutMs) {
-    if (typeof timeoutMs !== "number" || !(timeoutMs > 0))
-        return undefined;
-    return Math.min(Math.floor(timeoutMs), MAX_COMMAND_TIMEOUT_MS);
-}
-/** @internal Exported so Windows tree-termination arguments can be tested on every host. */
-export function buildWindowsTaskkillArgs(pid, force) {
-    if (!Number.isSafeInteger(pid) || pid <= 0) {
-        throw new RangeError("Windows taskkill pid must be a positive safe integer");
-    }
-    return ["/PID", String(pid), "/T", ...(force ? ["/F"] : [])];
-}
-function tryDirectSignal(signalDirect, signal) {
-    try {
-        signalDirect(signal);
-    }
-    catch {
-        // The target may have exited before taskkill failure became observable.
-    }
-}
-function tryForceSettledProcessTree(signalTree) {
-    try {
-        signalTree("SIGKILL");
-    }
-    catch {
-        // A settled command with no remaining descendants has no process group or
-        // live direct handle. Cleanup is intentionally idempotent in that case.
-    }
-}
-function signalWindowsTreeWithDeno(deno, pid, force, signalDirect) {
-    const signal = force ? "SIGKILL" : "SIGTERM";
-    if (!Number.isSafeInteger(pid) || (pid ?? 0) <= 0) {
-        tryDirectSignal(signalDirect, signal);
-        return;
-    }
-    try {
-        const taskkill = new deno.Command("taskkill", {
-            args: buildWindowsTaskkillArgs(pid, force),
-            stdin: "null",
-            stdout: "null",
-            stderr: "null",
-        }).spawn();
-        void taskkill.status.then((status) => {
-            if (!status.success)
-                tryDirectSignal(signalDirect, signal);
-        }).catch(() => tryDirectSignal(signalDirect, signal));
-    }
-    catch {
-        tryDirectSignal(signalDirect, signal);
-    }
-}
-function signalWindowsTreeWithBun(bun, pid, force, signalDirect) {
-    const signal = force ? "SIGKILL" : "SIGTERM";
-    if (!Number.isSafeInteger(pid) || (pid ?? 0) <= 0) {
-        tryDirectSignal(signalDirect, signal);
-        return;
-    }
-    try {
-        const taskkill = bun.spawn({
-            cmd: ["taskkill", ...buildWindowsTaskkillArgs(pid, force)],
-            stdout: "ignore",
-            stderr: "ignore",
-        });
-        taskkill.unref?.();
-        void taskkill.exited.then((code) => {
-            if (code !== 0)
-                tryDirectSignal(signalDirect, signal);
-        }).catch(() => tryDirectSignal(signalDirect, signal));
-    }
-    catch {
-        tryDirectSignal(signalDirect, signal);
-    }
-}
-function signalWindowsTreeWithNode(spawn, pid, force, signalDirect) {
-    const signal = force ? "SIGKILL" : "SIGTERM";
-    if (!Number.isSafeInteger(pid) || (pid ?? 0) <= 0) {
-        tryDirectSignal(signalDirect, signal);
-        return;
-    }
-    try {
-        const taskkill = spawn("taskkill", buildWindowsTaskkillArgs(pid, force), {
-            stdio: "ignore",
-            windowsHide: true,
-        });
-        taskkill.once("error", () => tryDirectSignal(signalDirect, signal));
-        taskkill.once("close", (code) => {
-            if (code !== 0)
-                tryDirectSignal(signalDirect, signal);
-        });
-    }
-    catch {
-        tryDirectSignal(signalDirect, signal);
-    }
-}
-function signalProcessTree(pid, signal, detachedProcessGroup, signalGroup, signalDirect) {
-    if (detachedProcessGroup && Number.isSafeInteger(pid) && (pid ?? 0) > 0) {
-        try {
-            signalGroup(-pid, signal);
-            return;
-        }
-        catch (_) {
-            // The child may have exited before its process group became observable.
-            // Fall through to the direct handle so cancellation remains best effort.
-        }
-    }
-    signalDirect(signal);
-}
-function createProcessGuard(timeoutMs, signal, terminate, forceTerminate, releaseAfterForce) {
-    let terminationReason = null;
-    let timeoutId;
-    let forceKillId;
-    let forceTerminationCompleted = false;
-    const abortListener = () => stop("abort");
-    if (timeoutMs && timeoutMs > 0) {
-        timeoutId = dntShim.setTimeout(() => {
-            stop("timeout");
-        }, timeoutMs);
-    }
-    if (signal) {
-        addAbortSignalListenerOnce(signal, abortListener);
-        if (isAbortSignalAborted(signal))
-            stop("abort");
-    }
-    return {
-        stop,
-        reason: () => terminationReason,
-        clear: () => {
-            if (timeoutId)
-                clearTimeout(timeoutId);
-            if (signal)
-                removeAbortSignalListener(signal, abortListener);
-            if (terminationReason === null) {
-                if (forceKillId)
-                    clearTimeout(forceKillId);
-                return;
-            }
-            // The directly managed process may settle after SIGTERM while a child in
-            // its process group remains alive. Do not cancel escalation on that
-            // abnormal settlement; force it immediately before releasing lifecycle
-            // ownership.
-            forceTerminateOnce();
-        },
-    };
-    function stop(reason) {
-        if (terminationReason !== null)
-            return;
-        terminationReason = reason;
-        try {
-            terminate();
-        }
-        catch (_) {
-            /* expected: best-effort terminate may fail if process already exited */
-        }
-        forceKillId = dntShim.setTimeout(forceTerminateOnce, FORCE_KILL_GRACE_MS);
-    }
-    function forceTerminateOnce() {
-        if (forceTerminationCompleted)
-            return;
-        forceTerminationCompleted = true;
-        if (forceKillId) {
-            clearTimeout(forceKillId);
-            forceKillId = undefined;
-        }
-        try {
-            forceTerminate();
-        }
-        catch (_) {
-            /* expected: best-effort force terminate may fail if process already exited */
-        }
-        finally {
-            releaseAfterForce();
-        }
-    }
-}
-function createCaptureBudget(maxOutputBytes, onExceeded) {
-    return {
-        remaining: maxOutputBytes,
-        exceeded: false,
-        onExceeded,
-    };
-}
-function captureChunk(chunks, chunk, budget) {
-    const available = budget.remaining;
-    if (available > 0) {
-        // Invoke the typed-array intrinsic directly: Buffer#slice() returns a view
-        // and can retain a much larger pooled backing allocation.
-        const retained = apply(uint8ArraySlice, chunk, [
-            0,
-            Math.min(chunk.byteLength, available),
-        ]);
-        chunks.push(retained);
-        budget.remaining -= retained.byteLength;
-    }
-    if (chunk.byteLength > available && !budget.exceeded) {
-        budget.exceeded = true;
-        budget.onExceeded();
-    }
-}
-function decodeChunks(chunks) {
-    const total = chunks.reduce((acc, chunk) => acc + chunk.byteLength, 0);
-    const merged = new Uint8Array(total);
-    let offset = 0;
-    for (const chunk of chunks) {
-        merged.set(chunk, offset);
-        offset += chunk.byteLength;
-    }
-    return new TextDecoder().decode(merged);
-}
-function captureStreamToString(stream, budget) {
-    const reader = stream.getReader();
-    const chunks = [];
-    let cancelled = false;
-    return {
-        result: (async () => {
-            try {
-                while (true) {
-                    const { done, value } = await reader.read();
-                    if (done)
-                        break;
-                    if (value)
-                        captureChunk(chunks, value, budget);
-                }
-            }
-            catch (error) {
-                if (!cancelled)
-                    throw error;
-            }
-            finally {
-                reader.releaseLock();
-            }
-            return decodeChunks(chunks);
-        })(),
-        cancel: (reason) => {
-            if (cancelled)
-                return;
-            cancelled = true;
-            try {
-                const cancellation = reader.cancel(reason);
-                void cancellation.catch(() => { });
-            }
-            catch {
-                // The stream may already have closed between termination and release.
-            }
-        },
-    };
-}
-function resolveShellCommand(cmd, args) {
-    if (isWindowsPlatform()) {
-        return { cmd: "cmd.exe", args: ["/d", "/s", "/c", cmd, ...args] };
-    }
-    if (args.length === 0) {
-        return { cmd: "sh", args: ["-c", cmd] };
-    }
-    return {
-        cmd: "sh",
-        args: ["-c", 'exec "$@"', "sh", cmd, ...args],
-    };
-}
-/**
- * Run a command and return the result.
- * Works across Deno, Node.js, and Bun.
- *
- * @param cmd - Command to run
- * @param options - Command options
- * @param options.capture - Capture stdout/stderr to return in result
- * @param options.inherit - Inherit stdio from parent (shows output in terminal)
- * @param options.shell - Use shell to run command (needed for .cmd on Windows)
- */
-export async function runCommand(cmd, options = {}) {
-    const { args = [], cwd: cmdCwd, env: cmdEnv, clearEnv = false, capture = false, inherit = false, shell = false, timeoutMs, signal, terminateProcessTreeOnExit = false, maxOutputBytes = DEFAULT_MAX_OUTPUT_BYTES, } = options;
-    validateAbortSignal(signal);
-    if (typeof terminateProcessTreeOnExit !== "boolean") {
-        throw new TypeError("terminateProcessTreeOnExit must be a boolean");
-    }
-    const effectiveTimeoutMs = resolveCommandTimeoutMs(timeoutMs);
-    if (!Number.isSafeInteger(maxOutputBytes) || maxOutputBytes <= 0) {
-        throw new RangeError("maxOutputBytes must be a positive safe integer");
-    }
-    if (signal && isAbortSignalAborted(signal)) {
-        return createTerminationResult("abort", 0);
-    }
-    // Determine stdio mode: inherit > capture > null
-    const shouldCapture = capture && !inherit;
-    const stdioMode = inherit ? "inherit" : shouldCapture ? "piped" : "null";
-    const detachedProcessGroup = !isWindowsPlatform() &&
-        (effectiveTimeoutMs !== undefined ||
-            signal !== undefined ||
-            shouldCapture ||
-            terminateProcessTreeOnExit);
-    const deno = IS_DENO ? getDenoRuntime() : undefined;
-    if (deno) {
-        const denoCommand = shell ? resolveShellCommand(cmd, args) : { cmd, args };
-        const command = new deno.Command(denoCommand.cmd, {
-            args: [...denoCommand.args],
-            cwd: cmdCwd,
-            env: cmdEnv,
-            clearEnv,
-            stdin: inherit ? "inherit" : "null",
-            stdout: stdioMode,
-            stderr: stdioMode,
-            detached: detachedProcessGroup,
-        });
-        const child = command.spawn();
-        const windowsPlatform = isWindowsPlatform();
-        const directSignal = (terminationSignal) => child.kill(terminationSignal);
-        const signalChild = (terminationSignal) => windowsPlatform
-            ? signalWindowsTreeWithDeno(deno, child.pid, terminationSignal === "SIGKILL", directSignal)
-            : signalProcessTree(child.pid, terminationSignal, detachedProcessGroup, (processGroupId, groupSignal) => deno.kill(processGroupId, groupSignal), directSignal);
-        const captures = {};
-        const guard = createProcessGuard(effectiveTimeoutMs, signal, () => signalChild("SIGTERM"), () => signalChild("SIGKILL"), () => {
-            const reason = new Error("Command capture closed after forced termination");
-            captures.stdout?.cancel(reason);
-            captures.stderr?.cancel(reason);
-        });
-        const captureBudget = createCaptureBudget(maxOutputBytes, () => guard.stop("output-limit"));
-        captures.stdout = shouldCapture && child.stdout
-            ? captureStreamToString(child.stdout, captureBudget)
-            : undefined;
-        captures.stderr = shouldCapture && child.stderr
-            ? captureStreamToString(child.stderr, captureBudget)
-            : undefined;
-        try {
-            const [status, stdout, stderr] = await Promise.all([
-                child.status,
-                captures.stdout?.result ?? Promise.resolve(undefined),
-                captures.stderr?.result ?? Promise.resolve(undefined),
-            ]);
-            const reason = guard.reason();
-            if (reason) {
-                return createTerminationResult(reason, reason === "timeout" ? effectiveTimeoutMs ?? 0 : maxOutputBytes, stdout, stderr, captureBudget.exceeded);
-            }
-            return {
-                success: status.success,
-                code: status.code,
-                stdout,
-                stderr,
-            };
-        }
-        finally {
-            if (terminateProcessTreeOnExit && guard.reason() === null) {
-                tryForceSettledProcessTree(signalChild);
-            }
-            guard.clear();
-        }
-    }
-    if (IS_BUN) {
-        const bunGlobal = dntShim.dntGlobalThis;
-        const bunStdio = inherit ? "inherit" : shouldCapture ? "pipe" : "ignore";
-        const shellCommand = shell ? resolveShellCommand(cmd, args) : null;
-        const bunCmd = shellCommand ? [shellCommand.cmd, ...shellCommand.args] : [cmd, ...args];
-        const proc = bunGlobal.Bun.spawn({
-            cmd: bunCmd,
-            cwd: cmdCwd,
-            detached: detachedProcessGroup,
-            env: clearEnv ? cmdEnv ?? {} : cmdEnv,
-            stdout: bunStdio,
-            stderr: bunStdio,
-        });
-        const windowsPlatform = isWindowsPlatform();
-        const directSignal = (terminationSignal) => proc.kill?.(terminationSignal);
-        const signalChild = (terminationSignal) => windowsPlatform
-            ? signalWindowsTreeWithBun(bunGlobal.Bun, proc.pid, terminationSignal === "SIGKILL", directSignal)
-            : signalProcessTree(proc.pid, terminationSignal, detachedProcessGroup, (processGroupId, groupSignal) => {
-                if (!runtimeProcess)
-                    throw new Error("Runtime process unavailable");
-                runtimeProcess.kill(processGroupId, groupSignal);
-            }, directSignal);
-        const captures = {};
-        const guard = createProcessGuard(effectiveTimeoutMs, signal, () => signalChild("SIGTERM"), () => signalChild("SIGKILL"), () => {
-            const reason = new Error("Command capture closed after forced termination");
-            captures.stdout?.cancel(reason);
-            captures.stderr?.cancel(reason);
-        });
-        const captureBudget = createCaptureBudget(maxOutputBytes, () => guard.stop("output-limit"));
-        captures.stdout = shouldCapture && proc.stdout
-            ? captureStreamToString(proc.stdout, captureBudget)
-            : undefined;
-        captures.stderr = shouldCapture && proc.stderr
-            ? captureStreamToString(proc.stderr, captureBudget)
-            : undefined;
-        try {
-            const [code, stdout, stderr] = await Promise.all([
-                proc.exited,
-                captures.stdout?.result ?? Promise.resolve(undefined),
-                captures.stderr?.result ?? Promise.resolve(undefined),
-            ]);
-            const reason = guard.reason();
-            if (reason) {
-                return createTerminationResult(reason, reason === "timeout" ? effectiveTimeoutMs ?? 0 : maxOutputBytes, stdout, stderr, captureBudget.exceeded);
-            }
-            return { success: code === 0, code, stdout, stderr };
-        }
-        finally {
-            if (terminateProcessTreeOnExit && guard.reason() === null) {
-                tryForceSettledProcessTree(signalChild);
-            }
-            guard.clear();
-        }
-    }
-    if (!runtimeProcess)
-        return { success: false, code: 1 };
-    const process = runtimeProcess;
-    const { spawn } = await dynamicImport("node:child_process");
-    if (signal && isAbortSignalAborted(signal)) {
-        return createTerminationResult("abort", 0);
-    }
-    const nodeStdio = inherit
-        ? ["inherit", "inherit", "inherit"]
-        : capture
-            ? ["ignore", "pipe", "pipe"]
-            : ["ignore", "ignore", "ignore"];
-    return await new Promise((resolve) => {
-        const child = spawn(cmd, args, {
-            cwd: cmdCwd,
-            env: clearEnv ? cmdEnv ?? {} : cmdEnv ? { ...process.env, ...cmdEnv } : undefined,
-            stdio: nodeStdio,
-            shell,
-            detached: detachedProcessGroup,
-        });
-        const stdoutChunks = [];
-        const stderrChunks = [];
-        const windowsPlatform = isWindowsPlatform();
-        const directSignal = (terminationSignal) => child.kill(terminationSignal);
-        const signalChild = (terminationSignal) => windowsPlatform
-            ? signalWindowsTreeWithNode(spawn, child.pid, terminationSignal === "SIGKILL", directSignal)
-            : signalProcessTree(child.pid, terminationSignal, detachedProcessGroup, (processGroupId, groupSignal) => process.kill(processGroupId, groupSignal), directSignal);
-        const guard = createProcessGuard(effectiveTimeoutMs, signal, () => signalChild("SIGTERM"), () => signalChild("SIGKILL"), () => {
-            child.stdout?.destroy();
-            child.stderr?.destroy();
-        });
-        const captureBudget = createCaptureBudget(maxOutputBytes, () => guard.stop("output-limit"));
-        let resultSettled = false;
-        const settleProcessOwnership = () => {
-            if (resultSettled)
-                return false;
-            resultSettled = true;
-            if (terminateProcessTreeOnExit && guard.reason() === null) {
-                tryForceSettledProcessTree(signalChild);
-            }
-            guard.clear();
-            return true;
-        };
-        if (shouldCapture) {
-            child.stdout?.on("data", (data) => {
-                captureChunk(stdoutChunks, data, captureBudget);
-            });
-            child.stderr?.on("data", (data) => {
-                captureChunk(stderrChunks, data, captureBudget);
-            });
-        }
-        child.on("close", (code) => {
-            if (!settleProcessOwnership())
-                return;
-            const stdout = shouldCapture ? decodeChunks(stdoutChunks) : undefined;
-            const stderr = shouldCapture ? decodeChunks(stderrChunks) : undefined;
-            const reason = guard.reason();
-            if (reason) {
-                resolve(createTerminationResult(reason, reason === "timeout" ? effectiveTimeoutMs ?? 0 : maxOutputBytes, stdout, stderr, captureBudget.exceeded));
-                return;
-            }
-            resolve({
-                success: code === 0,
-                code: code ?? 1,
-                stdout,
-                stderr,
-            });
-        });
-        child.on("error", (spawnError) => {
-            if (!settleProcessOwnership())
-                return;
-            const stdout = shouldCapture ? decodeChunks(stdoutChunks) : undefined;
-            const stderr = shouldCapture ? decodeChunks(stderrChunks) : undefined;
-            // Include the spawn error message so callers can distinguish ENOENT
-            // ("command not found"), EACCES ("permission denied"), etc.
-            resolve({
-                success: false,
-                code: 1,
-                stdout,
-                stderr: shouldCapture
-                    ? (stderr
-                        ? `${stderr}\nSpawn error: ${spawnError.message}`
-                        : `Spawn error: ${spawnError.message}`)
-                    : undefined,
-            });
-        });
-    });
-}

package/esm/src/platform/compat/process.d.ts

@@ -1,5 +0,0 @@
-export { deleteEnv, env, type EnvBooleanOptions, getEnv, getEnvBoolean, getEnvNumber, getEnvOverlayStorage, getEnvString, getHostEnv, setEnv, } from "veryfront/platform/env";
-export { chdir, cwd, execPath, exit, getArgs, getOsType, getRuntimeVersion, getStdout, getTerminalSize, isInteractive, isStdoutTTY, memoryUsage, onGlobalError, onSignal, pid, promptSync, readStdinByteSync, unrefTimer, uptime, writeStdout, writeStdoutAsync, } from "./process/lifecycle.js";
-export { testHasRuntimeProcess } from "./process/runtime-process.js";
-export { type CommandOptions, type CommandResult, runCommand } from "./process/command.js";
-//# sourceMappingURL=process.d.ts.map

package/esm/src/platform/compat/process.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/process.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,GAAG,EACH,KAAK,iBAAiB,EACtB,MAAM,EACN,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,MAAM,GACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,EACL,GAAG,EACH,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,QAAQ,EACR,GAAG,EACH,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,WAAW,EACX,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/esm/src/platform/compat/process.js

@@ -1,4 +0,0 @@
-export { deleteEnv, env, getEnv, getEnvBoolean, getEnvNumber, getEnvOverlayStorage, getEnvString, getHostEnv, setEnv, } from "./process/env.js";
-export { chdir, cwd, execPath, exit, getArgs, getOsType, getRuntimeVersion, getStdout, getTerminalSize, isInteractive, isStdoutTTY, memoryUsage, onGlobalError, onSignal, pid, promptSync, readStdinByteSync, unrefTimer, uptime, writeStdout, writeStdoutAsync, } from "./process/lifecycle.js";
-export { testHasRuntimeProcess } from "./process/runtime-process.js";
-export { runCommand } from "./process/command.js";