@idlebox/node 1.4.5 → 1.4.7

package/package.json

@@ -1,49 +1,35 @@
 {
   "name": "@idlebox/node",
   "type": "module",
-  "version": "1.4.5",
-  "license": "MIT",
-  "main": "./lib/cjs/__create_index.generated.cjs",
-  "module": "./lib/esm/__create_index.generated.js",
-  "types": "./lib/esm/__create_index.generated.d.ts",
+  "version": "1.4.7",
   "exports": {
     ".": {
-      "types": "./lib/esm/__create_index.generated.d.ts",
-      "require": "./lib/cjs/__create_index.generated.cjs",
-      "import": "./lib/esm/__create_index.generated.js"
+      "source": "./src/autoindex.generated.ts",
+      "types": "./src/autoindex.generated.ts",
+      "default": "./lib/autoindex.generated.js"
     },
     "./package.json": "./package.json"
   },
   "sideEffects": false,
-  "repository": "https://github.com/GongT/baobao",
   "dependencies": {
-    "execa": "^9.4.0",
+    "execa": "^9.6.0",
     "source-map-support": "^0.5.21",
-    "@gongt/fix-esm": "^1.1.3",
-    "@idlebox/common": "^1.4.5"
+    "@idlebox/node-error-codes": "",
+    "@idlebox/common": "^1.4.14"
   },
   "devDependencies": {
-    "@rushstack/heft": "^0.68.2",
-    "@types/node": "^22.8.6",
-    "@build-script/single-dog-asset": "^1.0.34",
+    "@rushstack/heft": "^0.74.0",
+    "@types/node": "^24.0.14",
+    "@build-script/single-dog-asset": "^1.0.35",
+    "@mpis/run": "^0.0.2",
     "@internal/local-rig": "^1.0.1"
   },
-  "peerDependencies": {
-    "fix-esm": "^1.0.1"
-  },
-  "peerDependenciesMeta": {
-    "fix-esm": {
-      "optional": true
-    }
-  },
-  "optionalDependencies": {
-    "kexec": "npm:@gongt/kexec@latest"
-  },
+  "decoupledDependents": "*",
   "scripts": {
-    "test": "heft test",
-    "build": "heft --unmanaged build",
-    "_phase:build": "heft --unmanaged build",
-    "watch": "heft --unmanaged build-watch",
-    "clean": "heft clean"
+    "prepublishHook": "internal-prepublish-hook",
+    "build": "mpis-run build",
+    "watch": "mpis-run watch",
+    "clean": "mpis-run clean",
+    "lint": "internal-lint"
   }
 }

package/src/asyncLoad.ts

@@ -1,16 +1,7 @@
-import { prettyPrintError } from '@idlebox/common';
+import { AppExit, prettyPrintError } from '@idlebox/common';
 
 export type AsyncMainFunction = () => Promise<undefined | number> | Promise<void>;
 
-export class ExitError extends Error {
-	constructor(
-		message: string,
-		public readonly code: number = 1
-	) {
-		super(message);
-	}
-}
-
 type OnExit = (error?: Error) => Promise<any>;
 
 /**
@@ -19,7 +10,7 @@ type OnExit = (error?: Error) => Promise<any>;
  * setErrorLogRoot(require('path').dirname(__dirname));
  * ```
  **/
-export function runMain(main: AsyncMainFunction, onExit?: OnExit) {
+export function executeMainFunction(main: AsyncMainFunction, onExit?: OnExit) {
 	Promise.resolve()
 		.then(async () => {
 			try {
@@ -34,7 +25,7 @@ export function runMain(main: AsyncMainFunction, onExit?: OnExit) {
 			}
 		})
 		.catch((e) => {
-			if (e instanceof ExitError) {
+			if (e instanceof AppExit) {
 				if (e.code) {
 					console.error('[exit] %s', e.message);
 					process.exitCode = e.code;

package/src/autoindex.generated.ts

@@ -0,0 +1,159 @@
+// DO NOT EDIT THIS FILE
+// @ts-ignore
+/* eslint-disable */
+
+/* asyncLoad.ts */
+	// Identifiers
+	export type { AsyncMainFunction } from "./asyncLoad.js";
+	export { executeMainFunction } from "./asyncLoad.js";
+/* child_process/error.ts */
+	// 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";
+/* cli-io/output.ts */
+	// 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";
+/* error/linux.ts */
+	// 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";
+/* fs/exists.ts */
+	// 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";
+/* environment/pathEnvironment.ts */
+	// Identifiers
+	export { PATH_SEPARATOR } from "./environment/pathEnvironment.js";
+	export { PathEnvironment } from "./environment/pathEnvironment.js";
+/* environment/findBinary.ts */
+	// 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";
+/* crypto/md5.ts */
+	// Identifiers
+	export { md5 } from "./crypto/md5.js";
+/* crypto/sha256.ts */
+	// Identifiers
+	export { sha256 } from "./crypto/sha256.js";
+/* environment/npmConfig.ts */
+	// Identifiers
+	export { getNpmConfigValue } from "./environment/npmConfig.js";
+/* events/dumpEventEmitter.ts */
+	// Identifiers
+	export { dumpEventEmitterEmit } from "./events/dumpEventEmitter.js";
+/* fs/commandExists.ts */
+	// Identifiers
+	export { commandInPath } from "./fs/commandExists.js";
+	export { commandInPathSync } from "./fs/commandExists.js";
+/* fs/emptyDir.ts */
+	// Identifiers
+	export { emptyDir } from "./fs/emptyDir.js";
+/* fs/ensureDir.ts */
+	// Identifiers
+	export { ensureDirExists } from "./fs/ensureDir.js";
+	export { ensureParentExists } from "./fs/ensureDir.js";
+/* fs/tempFolder.ts */
+	// Identifiers
+	export { createTempFolder } from "./fs/tempFolder.js";
+/* fs/weiteChanged.ts */
+	// 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";
+/* log/terminal.ts */
+	// 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 { findUp } from "./path-resolve/findUp.js";
+	export { findUpUntilSync } from "./path-resolve/findUp.js";
+	export { findUpSync } from "./path-resolve/findUp.js";
+/* path-resolve/findPackageRoot.ts */
+	// Identifiers
+	export { findPackageRoot } from "./path-resolve/findPackageRoot.js";
+/* path-resolve/getAllUp.ts */
+	// Identifiers
+	export { getAllPathUpToRoot } from "./path-resolve/getAllUp.js";
+/* path-resolve/lrelative.ts */
+	// Identifiers
+	export { lrelative } from "./path-resolve/lrelative.js";
+/* path-resolve/nodeResolvePathArray.ts */
+	// 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";
+/* stream/blackHoleStream.ts */
+	// Identifiers
+	export { BlackHoleStream } from "./stream/blackHoleStream.js";
+/* stream/streamPromise.ts */
+	// 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";
+/* stream/disposableStream.ts */
+	// Identifiers
+	export { disposableStream } from "./stream/disposableStream.js";
+/* stream/drainStream.ts */
+	// 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";
+/* autoindex.ts */
+	// Identifiers
+	// References
+	export * from "@idlebox/node-error-codes";
+/* preload.ts */
+	// Identifiers

package/src/autoindex.ts

@@ -0,0 +1,153 @@
+// DO NOT EDIT THIS FILE
+// @ts-ignore
+/* eslint-disable */
+
+/* asyncLoad.ts */
+	// Identifiers
+	export type { AsyncMainFunction } from "./asyncLoad.js";
+	export { executeMainFunction } from "./asyncLoad.js";
+/* preload.ts */
+	// Identifiers
+/* child_process/error.ts */
+	// 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";
+/* cli-io/output.ts */
+	// 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";
+/* error/linux.ts */
+	// 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";
+/* fs/exists.ts */
+	// 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";
+/* environment/pathEnvironment.ts */
+	// Identifiers
+	export { PATH_SEPARATOR } from "./environment/pathEnvironment.js";
+	export { PathEnvironment } from "./environment/pathEnvironment.js";
+/* environment/findBinary.ts */
+	// 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";
+/* crypto/md5.ts */
+	// Identifiers
+	export { md5 } from "./crypto/md5.js";
+/* crypto/sha256.ts */
+	// Identifiers
+	export { sha256 } from "./crypto/sha256.js";
+/* environment/npmConfig.ts */
+	// Identifiers
+	export { getNpmConfigValue } from "./environment/npmConfig.js";
+/* events/dumpEventEmitter.ts */
+	// Identifiers
+	export { dumpEventEmitterEmit } from "./events/dumpEventEmitter.js";
+/* fs/commandExists.ts */
+	// Identifiers
+	export { commandInPath } from "./fs/commandExists.js";
+	export { commandInPathSync } from "./fs/commandExists.js";
+/* fs/emptyDir.ts */
+	// Identifiers
+	export { emptyDir } from "./fs/emptyDir.js";
+/* fs/ensureDir.ts */
+	// Identifiers
+	export { ensureDirExists } from "./fs/ensureDir.js";
+	export { ensureParentExists } from "./fs/ensureDir.js";
+/* fs/tempFolder.ts */
+	// Identifiers
+	export { createTempFolder } from "./fs/tempFolder.js";
+/* fs/weiteChanged.ts */
+	// 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";
+/* log/terminal.ts */
+	// 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";
+/* path-resolve/findPackageRoot.ts */
+	// Identifiers
+	export { findPackageRoot } from "./path-resolve/findPackageRoot.js";
+/* path-resolve/getAllUp.ts */
+	// Identifiers
+	export { getAllPathUpToRoot } from "./path-resolve/getAllUp.js";
+/* path-resolve/lrelative.ts */
+	// Identifiers
+	export { lrelative } from "./path-resolve/lrelative.js";
+/* path-resolve/nodeResolvePathArray.ts */
+	// 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";
+/* stream/blackHoleStream.ts */
+	// Identifiers
+	export { BlackHoleStream } from "./stream/blackHoleStream.js";
+/* stream/streamPromise.ts */
+	// 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";
+/* stream/disposableStream.ts */
+	// Identifiers
+	export { disposableStream } from "./stream/disposableStream.js";
+/* stream/drainStream.ts */
+	// 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";

package/src/child_process/execa.ts

@@ -1,4 +1,3 @@
-import '@gongt/fix-esm';
 import { isWindows, sepList } from '@idlebox/common';
 import type { Options as AsyncOptions, Result as AsyncResult, SyncOptions, SyncResult } from 'execa';
 import { execa, execaSync } from 'execa';
@@ -94,9 +93,15 @@ export async function spawnGetOutput({ exec, cwd, env, addonPath }: ICommand) {
 	return result.stdout as string;
 }
 
-export async function spawnGetEverything({ exec, cwd, env, addonPath }: ICommand) {
+type EveryOut = {
+	stdout: string;
+	stderr: string;
+	all: string;
+};
+export async function spawnGetEverything({ exec, cwd, env, addonPath }: ICommand): Promise<EveryOut> {
 	const [cmd, ...args] = exec;
-	const opts: AsyncOptions = {
+
+	const result = await execa(cmd, args, {
 		stdio: ['ignore', 'pipe', 'pipe'],
 		cwd,
 		reject: false,
@@ -104,9 +109,11 @@ export async function spawnGetEverything({ exec, cwd, env, addonPath }: ICommand
 		encoding: 'utf8',
 		all: true,
 		env: sanitizeEnv(env, addonPath),
-	};
-
-	const result = await execa(cmd, args, opts);
+	});
 	handleError(result);
-	return result.all as string;
+	return {
+		all: result.all,
+		stdout: result.stdout,
+		stderr: result.stderr,
+	};
 }

package/src/child_process/respawn.ts

@@ -1,5 +1,4 @@
 import { spawnSync } from 'node:child_process';
-import { createRequire } from 'node:module';
 import { platform } from 'node:os';
 import { findBinary } from '../environment/findBinary.js';
 import { spawnGetOutputSync } from './execa.js';
@@ -29,7 +28,7 @@ function shutdown_quit(signal: string, code: number) {
  * If can't do that (eg. on Windows), spawn as normal, but quit self after it quit.
  */
 export function trySpawnInScope(cmds: string[]): never {
-	if (process.env.NEVER_UNSHARE || insideScope() || !supportScope()) {
+	if (process.env.NEVER_UNSHARE || !process.execve || insideScope() || !supportScope()) {
 		spawnSimulate(cmds[0], cmds.slice(1));
 	} else {
 		execLinux(cmds);
@@ -37,7 +36,7 @@ export function trySpawnInScope(cmds: string[]): never {
 }
 
 /**
- * Self restart in a pid/cgroup namespace on linux.
+ * Self restart in a pid+cgroup+mount namespace on linux.
  * Your application must inside mainFunc, not before or after it.
  *
  * ```typescript
@@ -47,7 +46,7 @@ export function trySpawnInScope(cmds: string[]): never {
  * });
  * ```
  */
-export function respawnInScope(mainFunc: Function): unknown | never {
+export function respawnInScope(mainFunc: CallableFunction): unknown | never {
 	if (process.env.NEVER_UNSHARE || insideScope() || !supportScope()) {
 		spawnRecreateEventHandlers();
 		mainFunc();
@@ -107,16 +106,12 @@ function execLinux(cmds: string[]): never {
 
 	try {
 		process.env.NEVER_UNSHARE = 'true';
-		const require = createRequire(
-			// @ts-ignore
-			import.meta.url
-		);
-		const kexec = require('kexec');
 
 		process.removeAllListeners('SIGINT');
 		process.removeAllListeners('SIGTERM');
-		kexec(unshare, args);
-		console.error('[Linux] kexec failed.');
+		// biome-ignore lint/style/noNonNullAssertion: 上面判断过了
+		process.execve!(unshare, args);
+		console.error('[Linux] execve failed.');
 	} catch (err: any) {
 		if (
 			err.code === 'MODULE_NOT_FOUND' ||
@@ -125,7 +120,7 @@ function execLinux(cmds: string[]): never {
 		) {
 			spawnSimulate(unshare, args);
 		} else {
-			console.error('[Linux] <%s> kexec failed:', err.code, err);
+			console.error('[Linux] <%s> execve failed:', err.code, err);
 		}
 	}
 	process.exit(1);

package/src/environment/findBinary.ts

@@ -1,12 +1,9 @@
+import type { PathArray } from '@idlebox/common';
 import { resolve } from 'node:path';
 import { existsSync } from '../fs/exists.js';
 import { PathEnvironment } from './pathEnvironment.js';
 
-export function findBinary(
-	what: string,
-	pathvar: import('@idlebox/common').PathArray = new PathEnvironment(),
-	cwd = process.cwd()
-) {
+export function findBinary(what: string, pathvar: PathArray = new PathEnvironment(), cwd = process.cwd()) {
 	for (const path of pathvar.values()) {
 		if (existsSync(`${path}/${what}`)) {
 			return resolve(cwd, path, what);

package/src/environment/getEnvironment.ts

@@ -4,7 +4,7 @@ export interface IEnvironmentResult {
 }
 
 export function getEnvironment(name: string, env = process.env): IEnvironmentResult {
-	if (env.hasOwnProperty(name)) {
+	if (Object.hasOwn(env, name)) {
 		return {
 			value: env[name],
 			name: name,
@@ -35,7 +35,7 @@ export function deleteEnvironment(name: string, env = process.env) {
 }
 
 export function cleanupEnvironment(name: string, env = process.env) {
-	if (env.hasOwnProperty(name)) {
+	if (Object.hasOwn(env, name)) {
 		for (const item of Object.keys(env)) {
 			if (item.toLowerCase() === name && name !== item) {
 				delete env[item];

package/src/environment/pathEnvironment.ts

@@ -1,13 +1,16 @@
-import { platform } from 'node:os';
-import { PathArray } from '@idlebox/common';
+import { isWindows, PathArray } from '@idlebox/common';
 import { cleanupEnvironment, getEnvironment } from './getEnvironment.js';
 
-export const PATH_SEPARATOR = platform() === 'win32' ? ';' : ':';
+/**
+ * PATH_SEPARATOR is the separator used in the PATH environment variable.
+ * It is ';' on Windows and ':' on other platforms.
+ */
+export const PATH_SEPARATOR = isWindows ? ';' : ':';
 export class PathEnvironment extends PathArray {
 	private readonly name: string;
 	private readonly env: NodeJS.ProcessEnv;
 
-	constructor(varName = platform() === 'win32' ? 'Path' : 'PATH', env: NodeJS.ProcessEnv = process.env) {
+	constructor(varName = isWindows ? 'Path' : 'PATH', env: NodeJS.ProcessEnv = process.env) {
 		const { name, value } = getEnvironment(varName, env);
 		super('', PATH_SEPARATOR);
 

package/src/error/types.ts

@@ -1,5 +1,6 @@
+import { NodeError } from '@idlebox/node-error-codes';
 import { LinuxError } from './linux.js';
-import { NodeError } from './nodejs-error-code.generated.js';
+export * from '@idlebox/node-error-codes';
 
 type NodeException<T extends string = any> = NodeJS.ErrnoException & { code: T };
 
@@ -15,7 +16,7 @@ export interface OpenSSLException extends Error {
  * ERR_MODULE_NOT_FOUND: import() not found
  */
 export function isModuleResolutionError(
-	ex: unknown
+	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/fs/commandExists.ts

@@ -20,7 +20,7 @@ function exts(alterExt?: string[]) {
 
 export async function commandInPath(cmd: string, alterExt?: string[]): Promise<string | undefined> {
 	const pathVar = new PathEnvironment();
-	for (const item of pathVar.join(cmd)) {
+	for (const item of pathVar.joinpath(cmd)) {
 		for (const ext of exts(alterExt)) {
 			const found = await new Promise((resolve) => {
 				access(item + ext, constants.X_OK, (e) => {
@@ -35,7 +35,7 @@ export async function commandInPath(cmd: string, alterExt?: string[]): Promise<s
 }
 export function commandInPathSync(cmd: string, alterExt?: string[]): string | undefined {
 	const pathVar = new PathEnvironment();
-	for (const item of pathVar.join(cmd)) {
+	for (const item of pathVar.joinpath(cmd)) {
 		for (const ext of exts(alterExt)) {
 			try {
 				accessSync(item + ext, constants.X_OK);

package/src/fs/emptyDir.ts

@@ -5,14 +5,17 @@ import { resolve } from 'node:path';
  * delete all content in a dir,
  * and create it if not exists
  * @public
+ *
+ * @param path - the path to the directory
+ * @param create_not_exists - create the directory if it does not exist, defaults to true
  */
-export async function emptyDir(path: string, create_if_nexists = true) {
-	let files;
+export async function emptyDir(path: string, create_not_exists = true) {
+	let files: string[];
 	try {
 		files = await readdir(path);
 	} catch (e: any) {
 		if (e.code === 'ENOENT') {
-			if (create_if_nexists) await mkdir(path, { recursive: true });
+			if (create_not_exists) await mkdir(path, { recursive: true });
 			return;
 		}
 		throw e;

package/src/fs/ensureDir.ts

@@ -0,0 +1,19 @@
+import { mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+
+export async function ensureDirExists(dir: string) {
+	try {
+		await mkdir(dir, { recursive: true });
+	} catch (error) {
+		console.error(`Error creating directory ${dir}:`, error);
+	}
+}
+
+export async function ensureParentExists(file: string) {
+	const dir = dirname(file);
+	try {
+		await mkdir(dir, { recursive: true });
+	} catch (error) {
+		console.error(`Error creating directory ${dir}:`, error);
+	}
+}