elit 3.6.6 → 3.6.8

package/dist/pm.d.ts

@@ -0,0 +1,331 @@
+import { P as PmRuntimeName, a as PmProxyStrategy, W as WapkRunConfig, b as PmProxyConfig, c as PmRestartPolicy, d as PmMemoryAction, e as WapkGoogleDriveConfig, f as PmConfig, g as PmAppConfig, E as ElitConfig } from './types-BayMVo_k.js';
+import './types-fiLday0L.js';
+import './types-DPOgoGs-.js';
+import 'node:events';
+import './websocket-BLBEAnhp.js';
+import 'events';
+import 'http';
+import 'ws';
+import './types-BR4wMiVx.js';
+import './types-C4gKykuG.js';
+import 'net';
+import 'smtp-server';
+import './contracts-D7KIS-TK.js';
+import './contracts-_0p1-15U.js';
+
+declare const DEFAULT_PM_DATA_DIR: string;
+declare const DEFAULT_PM_DUMP_FILE = "dump.json";
+declare const DEFAULT_RESTART_DELAY = 1000;
+declare const DEFAULT_MAX_RESTARTS = 10;
+declare const DEFAULT_WATCH_DEBOUNCE = 250;
+declare const DEFAULT_MIN_UPTIME = 0;
+declare const DEFAULT_PM_LISTEN_TIMEOUT = 3000;
+declare const DEFAULT_HEALTHCHECK_GRACE_PERIOD = 5000;
+declare const DEFAULT_HEALTHCHECK_INTERVAL = 10000;
+declare const DEFAULT_HEALTHCHECK_TIMEOUT = 3000;
+declare const DEFAULT_HEALTHCHECK_MAX_FAILURES = 3;
+declare const DEFAULT_LOG_LINES = 40;
+declare const DEFAULT_PM_STOP_POLL_MS = 100;
+declare const DEFAULT_PM_STOP_GRACE_PERIOD_MS = 5000;
+declare const DEFAULT_PM_KILL_TIMEOUT = 5000;
+declare const DEFAULT_PM_EXP_BACKOFF_MAX_DELAY = 15000;
+declare const DEFAULT_PM_MEMORY_CHECK_INTERVAL = 500;
+declare const DEFAULT_PM_RESTART_WINDOW = 0;
+declare const DEFAULT_PM_PROXY_STRATEGY: PmProxyStrategy;
+declare const PM_WAPK_ONLINE_STDIN_SHUTDOWN_ENV = "ELIT_PM_WAPK_ONLINE_STDIN_SHUTDOWN";
+declare const PM_WAPK_ONLINE_SHUTDOWN_COMMAND = "__ELIT_PM_WAPK_ONLINE_SHUTDOWN__";
+declare const PM_WAPK_ONLINE_SHUTDOWN_TIMEOUT_MS = 8000;
+declare const PM_RECORD_EXTENSION = ".json";
+declare const SUPPORTED_FILE_EXTENSIONS: Set<string>;
+declare const DEFAULT_WATCH_IGNORE: string[];
+declare const SIMPLE_PREVIEW_SEGMENT: RegExp;
+type PmTargetType = 'script' | 'file' | 'wapk';
+type PmStatus = 'starting' | 'online' | 'restarting' | 'stopping' | 'stopped' | 'exited' | 'errored';
+interface PmResolvedHealthCheck {
+    url: string;
+    gracePeriod: number;
+    interval: number;
+    timeout: number;
+    maxFailures: number;
+}
+interface PmDumpFile {
+    version: 1;
+    savedAt: string;
+    apps: PmSavedAppDefinition[];
+}
+interface PmSavedAppDefinition {
+    name: string;
+    baseName: string;
+    instanceIndex: number;
+    instances: number;
+    type: PmTargetType;
+    cwd: string;
+    runtime?: PmRuntimeName;
+    env: Record<string, string>;
+    script?: string;
+    file?: string;
+    wapk?: string;
+    password?: string;
+    wapkRun?: WapkRunConfig;
+    restartPolicy: PmRestartPolicy;
+    maxMemoryBytes?: number;
+    memoryAction?: PmMemoryAction;
+    cronRestart?: string;
+    expBackoffRestartDelay?: number;
+    expBackoffRestartMaxDelay?: number;
+    restartWindow?: number;
+    waitReady: boolean;
+    listenTimeout: number;
+    autorestart: boolean;
+    restartDelay: number;
+    proxy?: PmProxyConfig;
+    killTimeout: number;
+    maxRestarts: number;
+    minUptime: number;
+    watch: boolean;
+    watchPaths: string[];
+    watchIgnore: string[];
+    watchDebounce: number;
+    healthCheck?: PmResolvedHealthCheck;
+}
+interface ParsedPmStartArgs {
+    targetToken?: string;
+    name?: string;
+    script?: string;
+    file?: string;
+    wapk?: string;
+    wapkRun?: WapkRunConfig;
+    runtime?: PmRuntimeName;
+    cwd?: string;
+    env: Record<string, string>;
+    instances?: number;
+    proxy?: Partial<PmProxyConfig>;
+    autorestart?: boolean;
+    restartDelay?: number;
+    killTimeout?: number;
+    maxRestarts?: number;
+    password?: string;
+    restartPolicy?: PmRestartPolicy;
+    maxMemoryBytes?: number;
+    memoryAction?: PmMemoryAction;
+    cronRestart?: string;
+    expBackoffRestartDelay?: number;
+    expBackoffRestartMaxDelay?: number;
+    restartWindow?: number;
+    waitReady?: boolean;
+    listenTimeout?: number;
+    minUptime?: number;
+    watch?: boolean;
+    watchPaths: string[];
+    watchIgnore: string[];
+    watchDebounce?: number;
+    healthCheckUrl?: string;
+    healthCheckGracePeriod?: number;
+    healthCheckInterval?: number;
+    healthCheckTimeout?: number;
+    healthCheckMaxFailures?: number;
+}
+interface ResolvedPmAppDefinition {
+    name: string;
+    baseName: string;
+    instanceIndex: number;
+    instances: number;
+    type: PmTargetType;
+    source: 'cli' | 'config';
+    cwd: string;
+    runtime?: PmRuntimeName;
+    env: Record<string, string>;
+    script?: string;
+    file?: string;
+    wapk?: string;
+    wapkRun?: WapkRunConfig;
+    autorestart: boolean;
+    restartDelay: number;
+    proxy?: PmProxyConfig;
+    killTimeout: number;
+    maxRestarts: number;
+    password?: string;
+    restartPolicy: PmRestartPolicy;
+    maxMemoryBytes?: number;
+    memoryAction?: PmMemoryAction;
+    cronRestart?: string;
+    expBackoffRestartDelay?: number;
+    expBackoffRestartMaxDelay?: number;
+    restartWindow?: number;
+    waitReady: boolean;
+    listenTimeout: number;
+    minUptime: number;
+    watch: boolean;
+    watchPaths: string[];
+    watchIgnore: string[];
+    watchDebounce: number;
+    healthCheck?: PmResolvedHealthCheck;
+}
+interface PmRecord {
+    id: string;
+    name: string;
+    baseName: string;
+    instanceIndex: number;
+    instances: number;
+    type: PmTargetType;
+    source: 'cli' | 'config';
+    cwd: string;
+    runtime?: PmRuntimeName;
+    env: Record<string, string>;
+    script?: string;
+    file?: string;
+    wapk?: string;
+    wapkRun?: WapkRunConfig;
+    autorestart: boolean;
+    restartDelay: number;
+    proxy?: PmProxyConfig;
+    proxyTargetPort?: number;
+    killTimeout: number;
+    maxRestarts: number;
+    password?: string;
+    restartPolicy: PmRestartPolicy;
+    maxMemoryBytes?: number;
+    memoryAction?: PmMemoryAction;
+    cronRestart?: string;
+    expBackoffRestartDelay?: number;
+    expBackoffRestartMaxDelay?: number;
+    restartWindow?: number;
+    waitReady: boolean;
+    listenTimeout: number;
+    minUptime: number;
+    watch: boolean;
+    watchPaths: string[];
+    watchIgnore: string[];
+    watchDebounce: number;
+    healthCheck?: PmResolvedHealthCheck;
+    desiredState: 'running' | 'stopped';
+    status: PmStatus;
+    commandPreview: string;
+    createdAt: string;
+    updatedAt: string;
+    startedAt?: string;
+    stoppedAt?: string;
+    runnerPid?: number;
+    childPid?: number;
+    restartCount: number;
+    reloadRequestedAt?: string;
+    lastRestartAt?: string;
+    lastExitCode?: number;
+    error?: string;
+    proxyReadyAt?: string;
+    logFiles: {
+        out: string;
+        err: string;
+    };
+}
+interface PmPaths {
+    dataDir: string;
+    appsDir: string;
+    logsDir: string;
+    dumpFile: string;
+}
+interface BuiltPmCommand {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    shell?: boolean;
+    ipc?: boolean;
+    runtime?: PmRuntimeName;
+    preview: string;
+}
+interface PmRecordMatch {
+    filePath: string;
+    record: PmRecord;
+}
+interface ParsedPmRunnerArgs {
+    dataDir: string;
+    id: string;
+}
+interface PmRestartRequest {
+    kind: 'watch' | 'health' | 'startup' | 'memory' | 'memory-stop' | 'cron';
+    detail: string;
+}
+
+declare function normalizePmRuntime(value: unknown, optionName?: string): PmRuntimeName | undefined;
+declare function normalizePmRestartPolicy(value: unknown, optionName?: string): PmRestartPolicy | undefined;
+declare function normalizePmMemoryAction(value: unknown, optionName?: string): PmMemoryAction | undefined;
+declare function normalizePmProxyStrategy(value: unknown, optionName?: string): PmProxyStrategy | undefined;
+declare function normalizeIntegerOption(value: string, optionName: string, min?: number): number;
+declare function normalizePmMemoryLimit(value: unknown, optionName?: string): number | undefined;
+declare function normalizeNonEmptyString(value: unknown): string | undefined;
+declare function hasPmGoogleDriveConfig(config: WapkGoogleDriveConfig | undefined): boolean;
+declare function isPmWapkOnlineRunConfig(config: WapkRunConfig | undefined): boolean;
+declare function hasPmWapkRunConfig(config: WapkRunConfig | undefined): boolean;
+declare function mergePmWapkRunConfig(base: WapkRunConfig | undefined, override: WapkRunConfig | undefined): WapkRunConfig | undefined;
+declare function stripPmWapkSourceFromRunConfig(config: WapkRunConfig | undefined): WapkRunConfig | undefined;
+declare function isRemoteWapkArchiveSpecifier(value: string): boolean;
+declare function isWapkArchiveSpecifier(value: string): boolean;
+declare function buildGoogleDriveWapkSpecifier(fileId: string): string;
+declare function resolvePmWapkSource(value: string | undefined, cwd: string): string | undefined;
+declare function resolvePmWapkSourceToken(wapk: string | undefined, wapkRun: WapkRunConfig | undefined): string | undefined;
+declare function countDefinedPmWapkSources(wapk: string | undefined, wapkRun: WapkRunConfig | undefined): number;
+declare function appendPmWapkRunArgs(args: string[], previewParts: string[], wapkRun: WapkRunConfig | undefined): void;
+declare function quoteCommandSegment(value: string): string;
+declare function buildPmWapkPreview(wapk: string, runtime?: PmRuntimeName, password?: string, wapkRun?: WapkRunConfig): string;
+declare function sanitizePmProcessName(name: string): string;
+declare function isTypescriptFile(filePath: string): boolean;
+declare function normalizeStringArray(value: unknown): string[];
+declare function toWatchGlob(candidatePath: string): string;
+declare function normalizeWatchPatterns(paths: string[], cwd: string): string[];
+declare function normalizeWatchIgnorePatterns(paths: string[], cwd: string): string[];
+declare function matchesGlobPattern(filePath: string, pattern: string): boolean;
+declare function isIgnoredWatchPath(filePath: string, patterns: string[]): boolean;
+declare function normalizeHealthCheckConfig(value: unknown): PmResolvedHealthCheck | undefined;
+declare function looksLikeManagedFile(value: string, cwd: string): boolean;
+declare function normalizeEnvMap(value: unknown): Record<string, string>;
+declare function parsePmEnvEntry(input: string): [string, string];
+declare function readRequiredValue(args: string[], index: number, optionName: string): string;
+declare function normalizePmProxyConfig(value: unknown, optionName?: string): PmProxyConfig | undefined;
+
+declare function resolvePmPaths(config: PmConfig | undefined, workspaceRoot: string): PmPaths;
+declare function ensurePmDirectories(paths: PmPaths): void;
+declare function getPmRecordPath(paths: PmPaths, id: string): string;
+declare function readPmRecord(filePath: string): PmRecord;
+declare function writePmRecord(filePath: string, record: PmRecord): void;
+declare function toSavedAppDefinition(record: PmRecord): PmSavedAppDefinition;
+declare function writePmDumpFile(filePath: string, apps: PmSavedAppDefinition[]): void;
+declare function readPmDumpFile(filePath: string): PmDumpFile;
+declare function deriveDefaultWatchPaths(type: PmTargetType, cwd: string, file?: string, wapk?: string): string[];
+declare function normalizeResolvedWatchPaths(paths: string[], cwd: string, type: PmTargetType, file?: string, wapk?: string): string[];
+declare function normalizeResolvedWatchIgnorePaths(paths: string[], cwd: string): string[];
+declare function listPmRecordMatches(paths: PmPaths): PmRecordMatch[];
+declare function findPmRecordMatch(paths: PmPaths, nameOrId: string): PmRecordMatch | undefined;
+declare function findPmGroupMatches(paths: PmPaths, baseName: string): PmRecordMatch[];
+declare function isProcessAlive(pid: number | undefined): boolean;
+declare function syncPmRecordLiveness(match: PmRecordMatch): PmRecordMatch;
+declare function readLatestPmRecord(filePath: string, fallback: PmRecord): PmRecord;
+declare function toPmAppConfig(record: PmRecord): PmAppConfig;
+declare function toSavedPmAppConfig(app: PmSavedAppDefinition): PmAppConfig;
+
+declare function formatPmInstanceName(baseName: string, instanceIndex: number): string;
+declare function expandPmInstanceDefinitions(definition: ResolvedPmAppDefinition, targetInstances?: number): ResolvedPmAppDefinition[];
+declare function resolvePmAppDefinition(base: PmAppConfig | undefined, parsed: ParsedPmStartArgs, workspaceRoot: string, source: 'cli' | 'config'): ResolvedPmAppDefinition;
+declare function resolvePmStartDefinitions(parsed: ParsedPmStartArgs, config: ElitConfig | null, workspaceRoot: string): ResolvedPmAppDefinition[];
+declare function parsePmStartArgs(args: string[]): ParsedPmStartArgs;
+declare function printPmHelp(): void;
+
+declare function samplePmProcessMetrics(pid: number): {
+    cpuPercent?: number;
+    memoryRssBytes?: number;
+};
+declare function isPmOnlineWapkRecord(record: Pick<PmRecord, 'type' | 'wapkRun'>): boolean;
+declare function buildPmCommand(record: PmRecord): BuiltPmCommand;
+declare function terminateProcessTree(pid: number, options?: {
+    force?: boolean;
+}): void;
+declare function sendPmSignal(pid: number, signal: NodeJS.Signals): void;
+declare function startManagedProcess(definition: ResolvedPmAppDefinition, paths: PmPaths): Promise<PmRecord>;
+
+declare function waitForProcessTermination(pid: number | undefined, timeoutMs: number): Promise<boolean>;
+declare function runManagedProcessLoop(filePath: string, initialRecord: PmRecord): Promise<void>;
+declare function runPmRunner(args: string[]): Promise<void>;
+declare function stopPmMatches(matches: PmRecordMatch[]): Promise<number>;
+
+declare function runPmCommand(args: string[]): Promise<void>;
+
+export { type BuiltPmCommand, DEFAULT_HEALTHCHECK_GRACE_PERIOD, DEFAULT_HEALTHCHECK_INTERVAL, DEFAULT_HEALTHCHECK_MAX_FAILURES, DEFAULT_HEALTHCHECK_TIMEOUT, DEFAULT_LOG_LINES, DEFAULT_MAX_RESTARTS, DEFAULT_MIN_UPTIME, DEFAULT_PM_DATA_DIR, DEFAULT_PM_DUMP_FILE, DEFAULT_PM_EXP_BACKOFF_MAX_DELAY, DEFAULT_PM_KILL_TIMEOUT, DEFAULT_PM_LISTEN_TIMEOUT, DEFAULT_PM_MEMORY_CHECK_INTERVAL, DEFAULT_PM_PROXY_STRATEGY, DEFAULT_PM_RESTART_WINDOW, DEFAULT_PM_STOP_GRACE_PERIOD_MS, DEFAULT_PM_STOP_POLL_MS, DEFAULT_RESTART_DELAY, DEFAULT_WATCH_DEBOUNCE, DEFAULT_WATCH_IGNORE, PM_RECORD_EXTENSION, PM_WAPK_ONLINE_SHUTDOWN_COMMAND, PM_WAPK_ONLINE_SHUTDOWN_TIMEOUT_MS, PM_WAPK_ONLINE_STDIN_SHUTDOWN_ENV, type ParsedPmRunnerArgs, type ParsedPmStartArgs, type PmDumpFile, type PmPaths, type PmRecord, type PmRecordMatch, type PmResolvedHealthCheck, type PmRestartRequest, type PmSavedAppDefinition, type PmStatus, type PmTargetType, type ResolvedPmAppDefinition, SIMPLE_PREVIEW_SEGMENT, SUPPORTED_FILE_EXTENSIONS, appendPmWapkRunArgs, buildGoogleDriveWapkSpecifier, buildPmCommand, buildPmWapkPreview, countDefinedPmWapkSources, deriveDefaultWatchPaths, ensurePmDirectories, expandPmInstanceDefinitions, findPmGroupMatches, findPmRecordMatch, formatPmInstanceName, getPmRecordPath, hasPmGoogleDriveConfig, hasPmWapkRunConfig, isIgnoredWatchPath, isPmOnlineWapkRecord, isPmWapkOnlineRunConfig, isProcessAlive, isRemoteWapkArchiveSpecifier, isTypescriptFile, isWapkArchiveSpecifier, listPmRecordMatches, looksLikeManagedFile, matchesGlobPattern, mergePmWapkRunConfig, normalizeEnvMap, normalizeHealthCheckConfig, normalizeIntegerOption, normalizeNonEmptyString, normalizePmMemoryAction, normalizePmMemoryLimit, normalizePmProxyConfig, normalizePmProxyStrategy, normalizePmRestartPolicy, normalizePmRuntime, normalizeResolvedWatchIgnorePaths, normalizeResolvedWatchPaths, normalizeStringArray, normalizeWatchIgnorePatterns, normalizeWatchPatterns, parsePmEnvEntry, parsePmStartArgs, printPmHelp, quoteCommandSegment, readLatestPmRecord, readPmDumpFile, readPmRecord, readRequiredValue, resolvePmAppDefinition, resolvePmPaths, resolvePmStartDefinitions, resolvePmWapkSource, resolvePmWapkSourceToken, runManagedProcessLoop, runPmCommand, runPmRunner, samplePmProcessMetrics, sanitizePmProcessName, sendPmSignal, startManagedProcess, stopPmMatches, stripPmWapkSourceFromRunConfig, syncPmRecordLiveness, terminateProcessTree, toPmAppConfig, toSavedAppDefinition, toSavedPmAppConfig, toWatchGlob, waitForProcessTermination, writePmDumpFile, writePmRecord };