veryfront 0.1.215 → 0.1.217

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

@@ -1,166 +1,5 @@
-import * as dntShim from "../../../_dnt.shims.js";
-type RuntimeProcess = typeof import("node:process");
-/**
- * Detect a real Node/Bun process object.
- * Browser bundles may inject `window.process = { env: {} }`, which is not enough
- * to safely call process APIs like cwd(), exit(), or on().
- */
-export declare function testHasRuntimeProcess(processLike: unknown): processLike is RuntimeProcess;
-/** Get command-line arguments (cross-runtime: Deno.args or process.argv). */
-export declare function getArgs(): string[];
-/** Exit the process with an optional code (cross-runtime: Deno.exit or process.exit). */
-export declare function exit(code?: number): never;
-export declare function cwd(): string;
-export declare function chdir(directory: string): void;
-export declare function env(): Record<string, string>;
-/**
- * Read a host-level environment variable without consulting any project env overlay.
- * Use this for framework-owned runtime configuration that should not be shadowed by tenant env.
- */
-export declare function getHostEnv(key: string): string | undefined;
-export declare function getEnv(key: string): string | undefined;
-export interface EnvBooleanOptions {
-    trueValues?: readonly string[];
-    falseValues?: readonly string[];
-    trim?: boolean;
-    caseSensitive?: boolean;
-}
-export declare function getEnvString(key: string): string | undefined;
-export declare function getEnvString(key: string, fallback: string): string;
-export declare function getEnvNumber(key: string): number | undefined;
-export declare function getEnvNumber(key: string, fallback: number): number;
-export declare function getEnvBoolean(key: string, fallback?: boolean, options?: EnvBooleanOptions): boolean;
-export declare function setEnv(key: string, value: string): void;
-export declare function deleteEnv(key: string): void;
-type EnvOverlayStorage = {
-    getStore: () => unknown;
-    run?: <T>(store: unknown, fn: () => T) => T;
-    enterWith?: (store: unknown) => void;
-};
-/**
- * Get an AsyncLocalStorage-based env overlay storage if installed.
- * This enables per-async-context env isolation (e.g., in tests).
- */
-export declare function getEnvOverlayStorage(): EnvOverlayStorage | null;
-export declare function pid(): number;
-export declare function memoryUsage(): {
-    rss: number;
-    heapTotal: number;
-    heapUsed: number;
-    external: number;
-};
-/**
- * Check if stdin is a TTY (terminal)
- */
-export declare function isInteractive(): boolean;
-/**
- * Check if stdout is a TTY (terminal)
- */
-export declare function isStdoutTTY(): boolean;
-/**
- * Get terminal size (columns and rows)
- * Returns default fallback values if terminal size cannot be determined
- */
-export declare function getTerminalSize(): {
-    columns: number;
-    rows: number;
-};
-/**
- * Get runtime version string
- */
-export declare function getRuntimeVersion(): string;
-/**
- * Get the operating system type
- * Returns: "darwin" (macOS), "linux", "windows", or the raw platform string
- */
-export declare function getOsType(): string;
-/**
- * Register a signal handler (SIGINT, SIGTERM) for graceful shutdown
- */
-export declare function onSignal(signal: "SIGINT" | "SIGTERM", handler: () => void): void;
-/**
- * Register global error handlers for uncaught exceptions and unhandled promise rejections.
- * These handlers prevent the process from crashing due to application code errors.
- *
- * IMPORTANT: These handlers should be registered early in the application lifecycle
- * to catch errors that escape try/catch blocks.
- *
- * @param onError - Callback invoked with the error. Return true to prevent process exit.
- */
-export declare function onGlobalError(onError: (error: Error, type: "uncaughtException" | "unhandledRejection") => boolean | void): void;
-/**
- * Unreference a timer to prevent it from keeping the process alive
- */
-export declare function unrefTimer(timerId: ReturnType<typeof dntShim.setInterval>): void;
-/**
- * Get the executable path of the current runtime
- */
-export declare function execPath(): string;
-/**
- * Get process uptime in seconds
- * Returns OS uptime on Deno, process uptime on Node.js
- */
-export declare function uptime(): number;
-/**
- * Get stdout stream for writing
- * Returns null if not available (e.g., in browser/workers)
- */
-export declare function getStdout(): {
-    write: (data: string) => void;
-} | null;
-/**
- * Write text directly to stdout (sync)
- * No-op if stdout is not available
- */
-export declare function writeStdout(text: string): void;
-/**
- * Write data to stdout asynchronously
- * Returns a promise that resolves when the write is complete
- */
-export declare function writeStdoutAsync(data: Uint8Array): Promise<number>;
-/**
- * Synchronous prompt function that works across Deno and Bun.
- * Displays a message and reads user input from stdin.
- *
- * Note: This relies on globalThis.prompt which is available in Deno and Bun.
- * Returns null in environments where prompt is not available (e.g., Node.js ESM).
- */
-export declare function promptSync(message?: string): string | null;
-/**
- * Read a single byte from stdin synchronously.
- * Requires raw mode to be enabled for character-by-character reading.
- * Returns null on EOF or if stdin is not available.
- */
-export declare function readStdinByteSync(): number | null;
-export interface CommandResult {
-    success: boolean;
-    code: number;
-    stdout?: string;
-    stderr?: string;
-}
-export interface CommandOptions {
-    args?: string[];
-    cwd?: string;
-    env?: Record<string, string>;
-    /** Capture stdout/stderr to return in result */
-    capture?: boolean;
-    /** Inherit stdio from parent process (shows output in terminal) */
-    inherit?: boolean;
-    /** Use shell to run the command (needed for .cmd files on Windows) */
-    shell?: boolean;
-    /** Kill the command if it exceeds this duration (milliseconds) */
-    timeoutMs?: number;
-}
-/**
- * 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 declare function runCommand(cmd: string, options?: CommandOptions): Promise<CommandResult>;
-export {};
+export { deleteEnv, env, type EnvBooleanOptions, 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 { type CommandOptions, type CommandResult, runCommand } from "./process/command.js";
 //# sourceMappingURL=process.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/process.ts"],"names":[],"mappings":"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"}
+{"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"}