@idlebox/node 1.4.9 → 1.4.11

package/src/autoindex.ts

@@ -3,151 +3,151 @@
 /* eslint-disable */
 
 /* asyncLoad.ts */
-	// Identifiers
-	export type { AsyncMainFunction } from "./asyncLoad.js";
-	export { executeMainFunction } from "./asyncLoad.js";
+// Identifiers
+export type { AsyncMainFunction } from './asyncLoad.js';
+export { executeMainFunction } from './asyncLoad.js';
 /* preload.ts */
-	// Identifiers
+// Identifiers
 /* child_process/error.ts */
-	// Identifiers
-	export { checkChildProcessResult } from "./child_process/error.js";
+// Identifiers
+export { checkChildProcessResult } from './child_process/error.js';
 /* child_process/execa.ts */
-	// Identifiers
-	export type { ICommand } from "./child_process/execa.js";
-	export { spawnWithoutOutputSync } from "./child_process/execa.js";
-	export { spawnWithoutOutput } from "./child_process/execa.js";
-	export { spawnGetOutputSync } from "./child_process/execa.js";
-	export { spawnGetOutput } from "./child_process/execa.js";
-	export { spawnGetEverything } from "./child_process/execa.js";
+// Identifiers
+export type { ICommand } from './child_process/execa.js';
+export { spawnWithoutOutputSync } from './child_process/execa.js';
+export { spawnWithoutOutput } from './child_process/execa.js';
+export { spawnGetOutputSync } from './child_process/execa.js';
+export { spawnGetOutput } from './child_process/execa.js';
+export { spawnGetEverything } from './child_process/execa.js';
 /* cli-io/output.ts */
-	// Identifiers
-	export { printLine } from "./cli-io/output.js";
+// Identifiers
+export { printLine } from './cli-io/output.js';
 /* child_process/lateError.ts */
-	// Identifiers
-	export type { ISpawnOptions } from "./child_process/lateError.js";
-	export type { ExecaReturnValue } from "./child_process/lateError.js";
-	export { execLazyError } from "./child_process/lateError.js";
+// Identifiers
+export type { ISpawnOptions } from './child_process/lateError.js';
+export type { ExecaReturnValue } from './child_process/lateError.js';
+export { execLazyError } from './child_process/lateError.js';
 /* error/linux.ts */
-	// Identifiers
-	export { LinuxError } from "./error/linux.js";
+// Identifiers
+export { LinuxError } from './error/linux.js';
 /* error/types.ts */
-	// Identifiers
-	export type { OpenSSLException } from "./error/types.js";
-	export { isModuleResolutionError } from "./error/types.js";
-	export { isNotExistsError } from "./error/types.js";
-	export { isExistsError } from "./error/types.js";
-	export { isTypeError } from "./error/types.js";
-	export { isFileTypeError } from "./error/types.js";
-	export { isNodeError } from "./error/types.js";
-	// References
-	export * from "@idlebox/node-error-codes";
+// Identifiers
+export type { OpenSSLException } from './error/types.js';
+export { isModuleResolutionError } from './error/types.js';
+export { isNotExistsError } from './error/types.js';
+export { isExistsError } from './error/types.js';
+export { isTypeError } from './error/types.js';
+export { isFileTypeError } from './error/types.js';
+export { isNodeError } from './error/types.js';
+// References
+export * from '@idlebox/node-error-codes';
 /* fs/exists.ts */
-	// Identifiers
-	export { existsSync } from "./fs/exists.js";
-	export { exists } from "./fs/exists.js";
-	export { readFileIfExists } from "./fs/exists.js";
+// Identifiers
+export { existsSync } from './fs/exists.js';
+export { exists } from './fs/exists.js';
+export { readFileIfExists } from './fs/exists.js';
 /* environment/getEnvironment.ts */
-	// Identifiers
-	export type { IEnvironmentResult } from "./environment/getEnvironment.js";
-	export { getEnvironment } from "./environment/getEnvironment.js";
-	export { deleteEnvironment } from "./environment/getEnvironment.js";
-	export { cleanupEnvironment } from "./environment/getEnvironment.js";
+// Identifiers
+export type { IEnvironmentResult } from './environment/getEnvironment.js';
+export { getEnvironment } from './environment/getEnvironment.js';
+export { deleteEnvironment } from './environment/getEnvironment.js';
+export { cleanupEnvironment } from './environment/getEnvironment.js';
 /* environment/pathEnvironment.ts */
-	// Identifiers
-	export { PATH_SEPARATOR } from "./environment/pathEnvironment.js";
-	export { PathEnvironment } from "./environment/pathEnvironment.js";
+// Identifiers
+export { PATH_SEPARATOR } from './environment/pathEnvironment.js';
+export { PathEnvironment } from './environment/pathEnvironment.js';
 /* environment/findBinary.ts */
-	// Identifiers
-	export { findBinary } from "./environment/findBinary.js";
+// Identifiers
+export { findBinary } from './environment/findBinary.js';
 /* child_process/respawn.ts */
-	// Identifiers
-	export { spawnRecreateEventHandlers } from "./child_process/respawn.js";
-	export { trySpawnInScope } from "./child_process/respawn.js";
-	export { respawnInScope } from "./child_process/respawn.js";
+// Identifiers
+export { spawnRecreateEventHandlers } from './child_process/respawn.js';
+export { trySpawnInScope } from './child_process/respawn.js';
+export { respawnInScope } from './child_process/respawn.js';
 /* crypto/md5.ts */
-	// Identifiers
-	export { md5 } from "./crypto/md5.js";
+// Identifiers
+export { md5 } from './crypto/md5.js';
 /* crypto/sha256.ts */
-	// Identifiers
-	export { sha256 } from "./crypto/sha256.js";
+// Identifiers
+export { sha256 } from './crypto/sha256.js';
 /* environment/npmConfig.ts */
-	// Identifiers
-	export { getNpmConfigValue } from "./environment/npmConfig.js";
+// Identifiers
+export { getNpmConfigValue } from './environment/npmConfig.js';
 /* events/dumpEventEmitter.ts */
-	// Identifiers
-	export { dumpEventEmitterEmit } from "./events/dumpEventEmitter.js";
+// Identifiers
+export { dumpEventEmitterEmit } from './events/dumpEventEmitter.js';
 /* fs/commandExists.ts */
-	// Identifiers
-	export { commandInPath } from "./fs/commandExists.js";
-	export { commandInPathSync } from "./fs/commandExists.js";
+// Identifiers
+export { commandInPath } from './fs/commandExists.js';
+export { commandInPathSync } from './fs/commandExists.js';
 /* fs/emptyDir.ts */
-	// Identifiers
-	export { emptyDir } from "./fs/emptyDir.js";
+// Identifiers
+export { emptyDir } from './fs/emptyDir.js';
 /* fs/ensureDir.ts */
-	// Identifiers
-	export { ensureDirExists } from "./fs/ensureDir.js";
-	export { ensureParentExists } from "./fs/ensureDir.js";
+// Identifiers
+export { ensureDirExists } from './fs/ensureDir.js';
+export { ensureParentExists } from './fs/ensureDir.js';
 /* fs/tempFolder.ts */
-	// Identifiers
-	export { createTempFolder } from "./fs/tempFolder.js";
+// Identifiers
+export { createTempFolder } from './fs/tempFolder.js';
 /* fs/weiteChanged.ts */
-	// Identifiers
-	export { writeFileIfChangeSync } from "./fs/weiteChanged.js";
-	export { writeFileIfChange } from "./fs/weiteChanged.js";
+// Identifiers
+export { writeFileIfChangeSync } from './fs/weiteChanged.js';
+export { writeFileIfChange } from './fs/weiteChanged.js';
 /* lifecycle/register.ts */
-	// Identifiers
-	export { shutdown } from "./lifecycle/register.js";
-	export { registerNodejsExitHandler } from "./lifecycle/register.js";
-	export { die } from "./lifecycle/register.js";
+// Identifiers
+export { shutdown } from './lifecycle/register.js';
+export { registerNodejsExitHandler } from './lifecycle/register.js';
+export { die } from './lifecycle/register.js';
 /* log/terminal.ts */
-	// Identifiers
-	export { WrappedTerminalConsole } from "./log/terminal.js";
+// Identifiers
+export { WrappedTerminalConsole } from './log/terminal.js';
 /* path-resolve/findUp.ts */
-	// Identifiers
-	export type { IFindOptions } from "./path-resolve/findUp.js";
-	export { findUpUntil } from "./path-resolve/findUp.js";
-	export { findUpUntilSync } from "./path-resolve/findUp.js";
+// Identifiers
+export type { IFindOptions } from './path-resolve/findUp.js';
+export { findUpUntil } from './path-resolve/findUp.js';
+export { findUpUntilSync } from './path-resolve/findUp.js';
 /* path-resolve/findPackageRoot.ts */
-	// Identifiers
-	export { findPackageRoot } from "./path-resolve/findPackageRoot.js";
+// Identifiers
+export { findPackageRoot } from './path-resolve/findPackageRoot.js';
 /* path-resolve/getAllUp.ts */
-	// Identifiers
-	export { getAllPathUpToRoot } from "./path-resolve/getAllUp.js";
+// Identifiers
+export { getAllPathUpToRoot } from './path-resolve/getAllUp.js';
 /* path-resolve/lrelative.ts */
-	// Identifiers
-	export { lrelative } from "./path-resolve/lrelative.js";
+// Identifiers
+export { lrelative } from './path-resolve/lrelative.js';
 /* path-resolve/nodeResolvePathArray.ts */
-	// Identifiers
-	export { nodeResolvePathArray } from "./path-resolve/nodeResolvePathArray.js";
+// Identifiers
+export { nodeResolvePathArray } from './path-resolve/nodeResolvePathArray.js';
 /* path-resolve/resolvePath.ts */
-	// Identifiers
-	export type { ResolvePathFunction } from "./path-resolve/resolvePath.js";
-	export type { JoinPathFunction } from "./path-resolve/resolvePath.js";
-	export { resolvePath } from "./path-resolve/resolvePath.js";
-	export type { NormalizePathFunction } from "./path-resolve/resolvePath.js";
-	export { normalizePath } from "./path-resolve/resolvePath.js";
-	export { osTempDir } from "./path-resolve/resolvePath.js";
-	export { relativePath } from "./path-resolve/resolvePath.js";
+// Identifiers
+export type { ResolvePathFunction } from './path-resolve/resolvePath.js';
+export type { JoinPathFunction } from './path-resolve/resolvePath.js';
+export { resolvePath } from './path-resolve/resolvePath.js';
+export type { NormalizePathFunction } from './path-resolve/resolvePath.js';
+export { normalizePath } from './path-resolve/resolvePath.js';
+export { osTempDir } from './path-resolve/resolvePath.js';
+export { relativePath } from './path-resolve/resolvePath.js';
 /* stream/blackHoleStream.ts */
-	// Identifiers
-	export { BlackHoleStream } from "./stream/blackHoleStream.js";
+// Identifiers
+export { BlackHoleStream } from './stream/blackHoleStream.js';
 /* stream/streamPromise.ts */
-	// Identifiers
-	export { streamPromise } from "./stream/streamPromise.js";
-	export { streamHasEnd } from "./stream/streamPromise.js";
+// Identifiers
+export { streamPromise } from './stream/streamPromise.js';
+export { streamHasEnd } from './stream/streamPromise.js';
 /* stream/collectingStream.ts */
-	// Identifiers
-	export { streamToBuffer } from "./stream/collectingStream.js";
-	export { RawCollectingStream } from "./stream/collectingStream.js";
-	export { CollectingStream } from "./stream/collectingStream.js";
+// Identifiers
+export { streamToBuffer } from './stream/collectingStream.js';
+export { RawCollectingStream } from './stream/collectingStream.js';
+export { CollectingStream } from './stream/collectingStream.js';
 /* stream/disposableStream.ts */
-	// Identifiers
-	export { disposableStream } from "./stream/disposableStream.js";
+// Identifiers
+export { disposableStream } from './stream/disposableStream.js';
 /* stream/drainStream.ts */
-	// Identifiers
-	export { drainStream } from "./stream/drainStream.js";
+// Identifiers
+export { drainStream } from './stream/drainStream.js';
 /* stream/loggerStream.ts */
-	// Identifiers
-	export type { LogFunction } from "./stream/loggerStream.js";
-	export { LoggerStream } from "./stream/loggerStream.js";
-	export { HexDumpLoggerStream } from "./stream/loggerStream.js";
+// Identifiers
+export type { LogFunction } from './stream/loggerStream.js';
+export { LoggerStream } from './stream/loggerStream.js';
+export { HexDumpLoggerStream } from './stream/loggerStream.js';

package/src/child_process/lateError.ts

@@ -2,10 +2,7 @@ import { execa, type Options as ExecaOptions, type Result } from 'execa';
 import { printLine } from '../cli-io/output.js';
 import { checkChildProcessResult } from './error.js';
 
-export type ISpawnOptions = Omit<
-	ExecaOptions,
-	'lines' | 'reject' | 'stdio' | 'encoding' | 'all' | 'stderr' | 'verbose'
-> & {
+export type ISpawnOptions = Omit<ExecaOptions, 'lines' | 'reject' | 'stdio' | 'encoding' | 'all' | 'stderr' | 'verbose'> & {
 	verbose?: boolean;
 };
 type ISpawnConst = {
@@ -17,9 +14,7 @@ type ISpawnConst = {
 
 type ConvStdout<T extends ISpawnOptions> = T['stdout'] extends 'inherit' ? Omit<T, 'stdout'> & { stdout: 'pipe' } : T;
 
-export type ExecaReturnValue<options extends ISpawnOptions> = Result<
-	ConvStdout<Omit<options, 'verbose'>> & ISpawnConst
->;
+export type ExecaReturnValue<options extends ISpawnOptions> = Result<ConvStdout<Omit<options, 'verbose'>> & ISpawnConst>;
 
 type NoStdio = Omit<ISpawnOptions, 'stdio'> & { stdio?: never };
 
@@ -27,11 +22,7 @@ type NoStdio = Omit<ISpawnOptions, 'stdio'> & { stdio?: never };
  * 运行命令，如果出错，则输出缓冲的stderr（如果stdout是inherit，也同时输出stdout）
  * 如果程序正常结束，则程序向stderr输出的内容直接丢弃（如果stdout是inherit，也同时丢弃）
  */
-export function execLazyError<T extends NoStdio = NoStdio>(
-	cmd: string,
-	args: string[],
-	spawnOptions: T
-): Promise<ExecaReturnValue<T>> {
+export function execLazyError<T extends NoStdio = NoStdio>(cmd: string, args: string[], spawnOptions: T): Promise<ExecaReturnValue<T>> {
 	let all = false;
 	let { stdout, verbose, ...others } = spawnOptions;
 

package/src/child_process/respawn.ts

@@ -113,11 +113,7 @@ function execLinux(cmds: string[]): never {
 		process.execve!(unshare, args);
 		console.error('[Linux] execve failed.');
 	} catch (err: any) {
-		if (
-			err.code === 'MODULE_NOT_FOUND' ||
-			err.code === 'ERR_MODULE_NOT_FOUND' ||
-			err.code === 'UNDECLARED_DEPENDENCY'
-		) {
+		if (err.code === 'MODULE_NOT_FOUND' || err.code === 'ERR_MODULE_NOT_FOUND' || err.code === 'UNDECLARED_DEPENDENCY') {
 			spawnSimulate(unshare, args);
 		} else {
 			console.error('[Linux] <%s> execve failed:', err.code, err);

package/src/error/types.ts

@@ -15,9 +15,7 @@ export interface OpenSSLException extends Error {
  * MODULE_NOT_FOUND: require() not found
  * ERR_MODULE_NOT_FOUND: import() not found
  */
-export function isModuleResolutionError(
-	ex: unknown,
-): ex is NodeException<NodeError.MODULE_NOT_FOUND | NodeError.ERR_MODULE_NOT_FOUND> {
+export function isModuleResolutionError(ex: unknown): ex is NodeException<NodeError.MODULE_NOT_FOUND | NodeError.ERR_MODULE_NOT_FOUND> {
 	return isNodeError(ex) && (ex.code === NodeError.MODULE_NOT_FOUND || ex.code === NodeError.ERR_MODULE_NOT_FOUND);
 }
 

package/src/lifecycle/register.ts

@@ -1,8 +1,20 @@
-import { AppExit, ensureDisposeGlobal, globalSingletonStrong, prettyPrintError } from '@idlebox/common';
+/** biome-ignore-all lint/suspicious/noDebugger: debug file */
+
+import { AppExit, ensureDisposeGlobal, ensureGlobalObject, prettyPrintError } from '@idlebox/common';
 import { createRequire, syncBuiltinESMExports } from 'node:module';
+import { basename } from 'node:path';
 import process from 'node:process';
 
 const originalExit = process.exit;
+const prefix = process.stderr.isTTY ? '' : `<${title()} ${process.pid}> `;
+const hasInspect = process.argv.some((arg) => arg.startsWith('--inspect=') || arg.startsWith('--inspect-brk=') || arg === '--inspect' || arg === '--inspect-brk');
+
+function title() {
+	if (process.title && process.title !== 'node') {
+		return process.title;
+	}
+	return basename(process.argv[1] || '') || 'node';
+}
 
 class Exit extends AppExit {
 	constructor(code: number) {
@@ -10,8 +22,10 @@ class Exit extends AppExit {
 	}
 }
 
-let shuttingDown = false;
+const shuttingDown = false;
 export function shutdown(exitCode: number): never {
+	if (hasInspect) debugger;
+
 	if (exitCode) {
 		process.exitCode = exitCode;
 	}
@@ -28,20 +42,18 @@ export function shutdown(exitCode: number): never {
 	throw new Exit(code);
 }
 
-const exitHandler = Symbol('exithandler/registed');
-
 /**
  * 注册nodejs退出处理器
  */
 export function registerNodejsExitHandler() {
-	globalSingletonStrong(exitHandler, _real_register);
+	ensureGlobalObject('exithandler/register', _real_register);
 }
 function _real_register() {
 	process.on('SIGINT', () => {
-		console.log('\nReceived SIGINT. Exiting gracefully...');
+		console.error(`\n${prefix}Received SIGINT. Exiting gracefully...`);
 
 		if (shuttingDown) {
-			console.error('Exiting immediately.');
+			console.error(`Exiting immediately.`);
 			originalExit(1);
 		}
 
@@ -49,20 +61,25 @@ function _real_register() {
 	});
 
 	process.on('SIGTERM', () => {
-		console.log('Received SIGTERM. Exiting gracefully...');
+		console.error(`${prefix}Received SIGTERM. Exiting gracefully...`);
 		shutdown(0);
 	});
 
-	process.on('beforeExit', shutdown);
+	process.on('beforeExit', (code) => {
+		console.error(`${prefix}Process beforeExit with code: ${code}`);
+		shutdown(code);
+	});
 
 	process.on('unhandledRejection', (reason, _promise) => {
+		if (hasInspect) debugger;
+
 		if (reason instanceof Error) {
 			if (reason instanceof AppExit) {
 				return;
 			}
-			prettyPrintError('Unhandled Rejection', reason);
+			prettyPrintError(`${prefix}Unhandled Rejection`, reason);
 		} else {
-			console.error('Unhandled Rejection / error type unknown:', reason);
+			console.error(`${prefix}Unhandled Rejection / error type unknown:`, reason);
 		}
 		shutdown(1);
 	});
@@ -75,13 +92,16 @@ function _real_register() {
 		if (error instanceof AppExit) {
 			return;
 		}
-		prettyPrintError('Uncaught Exception', error);
+
+		if (hasInspect) debugger;
+
+		prettyPrintError(`${prefix}Uncaught Exception`, error);
 		shutdown(1);
 	}
 
 	if (process.hasUncaughtExceptionCaptureCallback()) {
 		process.on('uncaughtException', uncaughtException);
-		throw new Error('[process uncaught exception capture] callback already registered by other module');
+		throw new Error(`${prefix} [uncaught exception capture] callback already registered by other module`);
 	}
 	process.setUncaughtExceptionCaptureCallback(uncaughtException);
 
@@ -92,6 +112,7 @@ function _real_register() {
  * @deprecated 仅用于测试
  */
 export function die(message: string): never {
-	console.error(message);
+	debugger;
+	console.error(`${prefix}DIE!`, message);
 	shutdown(1);
 }

package/src/path-resolve/lrelative.ts

@@ -7,8 +7,8 @@ export function lrelative(from: string, to: string) {
 	if (!isAbsolute(to)) {
 		throw new Error(`lrelative: to is not absolute: ${to}`);
 	}
-	const fa = from.split(/[\/\\]/g).filter((e) => e);
-	const ta = to.split(/[\/\\]/g).filter((e) => e);
+	const fa = from.split(/[/\\]/g).filter((e) => e);
+	const ta = to.split(/[/\\]/g).filter((e) => e);
 	const f = ta.pop();
 	while (fa[0] === ta[0]) {
 		fa.shift();

package/src/stream/loggerStream.ts

@@ -7,7 +7,7 @@ export class LoggerStream extends Transform {
 
 	constructor(
 		private readonly logFn: LogFunction,
-		prefix?: string
+		prefix?: string,
 	) {
 		super();
 		this.prefix = prefix ? `${prefix} %s` : '%s';
@@ -39,7 +39,7 @@ export class HexDumpLoggerStream extends Transform {
 
 	constructor(
 		private readonly logFn: LogFunction,
-		prefix?: string
+		prefix?: string,
 	) {
 		super();
 		this.prefix = prefix ? `${prefix} ` : '';