Aktueller Stand

backend/node_modules/nypm/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

backend/node_modules/nypm/dist/cli.mjs

@@ -0,0 +1,547 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { defineCommand, runMain } from "citty";
+import { join, normalize, resolve } from "pathe";
+import { x } from "tinyexec";
+import * as fs from "node:fs";
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join as join$1 } from "node:path";
+
+//#region package.json
+var name = "nypm";
+var version = "0.6.3";
+var description = "Unified Package Manager for Node.js";
+
+//#endregion
+//#region src/package-manager.ts
+const packageManagers = [
+	{
+		name: "npm",
+		command: "npm",
+		lockFile: "package-lock.json"
+	},
+	{
+		name: "pnpm",
+		command: "pnpm",
+		lockFile: "pnpm-lock.yaml",
+		files: ["pnpm-workspace.yaml"]
+	},
+	{
+		name: "bun",
+		command: "bun",
+		lockFile: ["bun.lockb", "bun.lock"]
+	},
+	{
+		name: "yarn",
+		command: "yarn",
+		lockFile: "yarn.lock",
+		files: [".yarnrc.yml"]
+	},
+	{
+		name: "deno",
+		command: "deno",
+		lockFile: "deno.lock",
+		files: ["deno.json"]
+	}
+];
+/**
+* Detect the package manager used in a directory (and up) by checking various sources:
+*
+* 1. Use `packageManager` field from package.json
+*
+* 2. Known lock files and other files
+*/
+async function detectPackageManager(cwd, options = {}) {
+	const detected = await findup(resolve(cwd || "."), async (path) => {
+		if (!options.ignorePackageJSON) {
+			const packageJSONPath = join(path, "package.json");
+			if (existsSync(packageJSONPath)) {
+				const packageJSON = JSON.parse(await readFile(packageJSONPath, "utf8"));
+				if (packageJSON?.packageManager) {
+					const { name: name$1, version: version$1 = "0.0.0", buildMeta, warnings } = parsePackageManagerField(packageJSON.packageManager);
+					if (name$1) {
+						const majorVersion = version$1.split(".")[0];
+						const packageManager = packageManagers.find((pm) => pm.name === name$1 && pm.majorVersion === majorVersion) || packageManagers.find((pm) => pm.name === name$1);
+						return {
+							name: name$1,
+							command: name$1,
+							version: version$1,
+							majorVersion,
+							buildMeta,
+							warnings,
+							files: packageManager?.files,
+							lockFile: packageManager?.lockFile
+						};
+					}
+				}
+			}
+			if (existsSync(join(path, "deno.json"))) return packageManagers.find((pm) => pm.name === "deno");
+		}
+		if (!options.ignoreLockFile) {
+			for (const packageManager of packageManagers) if ([packageManager.lockFile, packageManager.files].flat().filter(Boolean).some((file) => existsSync(resolve(path, file)))) return { ...packageManager };
+		}
+	}, { includeParentDirs: options.includeParentDirs ?? true });
+	if (!detected && !options.ignoreArgv) {
+		const scriptArg = process.argv[1];
+		if (scriptArg) {
+			for (const packageManager of packageManagers) if ((/* @__PURE__ */ new RegExp(`[/\\\\]\\.?${packageManager.command}`)).test(scriptArg)) return packageManager;
+		}
+	}
+	return detected;
+}
+
+//#endregion
+//#region src/_utils.ts
+async function findup(cwd, match, options = {}) {
+	const segments = normalize(cwd).split("/");
+	while (segments.length > 0) {
+		const result = await match(segments.join("/") || "/");
+		if (result || !options.includeParentDirs) return result;
+		segments.pop();
+	}
+}
+async function readPackageJSON(cwd) {
+	return findup(cwd, (p) => {
+		const pkgPath = join$1(p, "package.json");
+		if (existsSync(pkgPath)) return readFile(pkgPath, "utf8").then((data) => JSON.parse(data));
+	});
+}
+function cached(fn) {
+	let v;
+	return () => {
+		if (v === void 0) v = fn().then((r) => {
+			v = r;
+			return v;
+		});
+		return v;
+	};
+}
+const hasCorepack = cached(async () => {
+	if (globalThis.process?.versions?.webcontainer) return false;
+	try {
+		const { exitCode } = await x("corepack", ["--version"]);
+		return exitCode === 0;
+	} catch {
+		return false;
+	}
+});
+async function executeCommand(command, args, options = {}) {
+	const xArgs = command !== "npm" && command !== "bun" && command !== "deno" && options.corepack !== false && await hasCorepack() ? ["corepack", [command, ...args]] : [command, args];
+	const { exitCode, stdout, stderr } = await x(xArgs[0], xArgs[1], { nodeOptions: {
+		cwd: resolve(options.cwd || process.cwd()),
+		env: options.env,
+		stdio: options.silent ? "pipe" : "inherit"
+	} });
+	if (exitCode !== 0) throw new Error(`\`${xArgs.flat().join(" ")}\` failed.${options.silent ? [
+		"",
+		stdout,
+		stderr
+	].join("\n") : ""}`);
+}
+const NO_PACKAGE_MANAGER_DETECTED_ERROR_MSG = "No package manager auto-detected.";
+async function resolveOperationOptions(options = {}) {
+	const cwd = options.cwd || process.cwd();
+	const env = {
+		...process.env,
+		...options.env
+	};
+	const packageManager = (typeof options.packageManager === "string" ? packageManagers.find((pm) => pm.name === options.packageManager) : options.packageManager) || await detectPackageManager(options.cwd || process.cwd());
+	if (!packageManager) throw new Error(NO_PACKAGE_MANAGER_DETECTED_ERROR_MSG);
+	return {
+		cwd,
+		env,
+		silent: options.silent ?? false,
+		packageManager,
+		dev: options.dev ?? false,
+		workspace: options.workspace,
+		global: options.global ?? false,
+		dry: options.dry ?? false,
+		corepack: options.corepack ?? true
+	};
+}
+function getWorkspaceArgs(options) {
+	if (!options.workspace) return [];
+	const workspacePkg = typeof options.workspace === "string" && options.workspace !== "" ? options.workspace : void 0;
+	if (options.packageManager.name === "pnpm") return workspacePkg ? ["--filter", workspacePkg] : ["--workspace-root"];
+	if (options.packageManager.name === "npm") return workspacePkg ? ["-w", workspacePkg] : ["--workspaces"];
+	if (options.packageManager.name === "yarn") if (!options.packageManager.majorVersion || options.packageManager.majorVersion === "1") return workspacePkg ? ["--cwd", workspacePkg] : ["-W"];
+	else return workspacePkg ? ["workspace", workspacePkg] : [];
+	return [];
+}
+function parsePackageManagerField(packageManager) {
+	const [name$1, _version] = (packageManager || "").split("@");
+	const [version$1, buildMeta] = _version?.split("+") || [];
+	if (name$1 && name$1 !== "-" && /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(name$1)) return {
+		name: name$1,
+		version: version$1,
+		buildMeta
+	};
+	const sanitized = (name$1 || "").replace(/\W+/g, "");
+	return {
+		name: sanitized,
+		version: version$1,
+		buildMeta,
+		warnings: [`Abnormal characters found in \`packageManager\` field, sanitizing from \`${name$1}\` to \`${sanitized}\``]
+	};
+}
+
+//#endregion
+//#region src/api.ts
+/**
+* Installs project dependencies.
+*
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.frozenLockFile - Whether to install dependencies with frozen lock file.
+*/
+async function installDependencies(options = {}) {
+	const resolvedOptions = await resolveOperationOptions(options);
+	const commandArgs = options.frozenLockFile ? {
+		npm: ["ci"],
+		yarn: ["install", "--immutable"],
+		bun: ["install", "--frozen-lockfile"],
+		pnpm: ["install", "--frozen-lockfile"],
+		deno: ["install", "--frozen"]
+	}[resolvedOptions.packageManager.name] : ["install"];
+	if (options.ignoreWorkspace && resolvedOptions.packageManager.name === "pnpm") commandArgs.push("--ignore-workspace");
+	if (!resolvedOptions.dry) await executeCommand(resolvedOptions.packageManager.command, commandArgs, {
+		cwd: resolvedOptions.cwd,
+		silent: resolvedOptions.silent,
+		corepack: resolvedOptions.corepack
+	});
+	return { exec: {
+		command: resolvedOptions.packageManager.command,
+		args: commandArgs
+	} };
+}
+/**
+* Adds dependency to the project.
+*
+* @param name - Name of the dependency to add.
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.dev - Whether to add the dependency as dev dependency.
+* @param options.workspace - The name of the workspace to use.
+* @param options.global - Whether to run the command in global mode.
+*/
+async function addDependency(name$1, options = {}) {
+	const resolvedOptions = await resolveOperationOptions(options);
+	const names = Array.isArray(name$1) ? name$1 : [name$1];
+	if (resolvedOptions.packageManager.name === "deno") {
+		for (let i = 0; i < names.length; i++) if (!/^(npm|jsr|file):.+$/.test(names[i] || "")) names[i] = `npm:${names[i]}`;
+	}
+	if (names.length === 0) return {};
+	const args = (resolvedOptions.packageManager.name === "yarn" ? [
+		...getWorkspaceArgs(resolvedOptions),
+		resolvedOptions.global && resolvedOptions.packageManager.majorVersion === "1" ? "global" : "",
+		"add",
+		resolvedOptions.dev ? "-D" : "",
+		...names
+	] : [
+		resolvedOptions.packageManager.name === "npm" ? "install" : "add",
+		...getWorkspaceArgs(resolvedOptions),
+		resolvedOptions.dev ? "-D" : "",
+		resolvedOptions.global ? "-g" : "",
+		...names
+	]).filter(Boolean);
+	if (!resolvedOptions.dry) await executeCommand(resolvedOptions.packageManager.command, args, {
+		cwd: resolvedOptions.cwd,
+		silent: resolvedOptions.silent,
+		corepack: resolvedOptions.corepack
+	});
+	if (!resolvedOptions.dry && options.installPeerDependencies) {
+		const existingPkg = await readPackageJSON(resolvedOptions.cwd);
+		const peerDeps = [];
+		const peerDevDeps = [];
+		for (const _name of names) {
+			const pkgName = _name.match(/^(.[^@]+)/)?.[0];
+			const pkg = createRequire(join$1(resolvedOptions.cwd, "/_.js"))(`${pkgName}/package.json`);
+			if (!pkg.peerDependencies || pkg.name !== pkgName) continue;
+			for (const [peerDependency, version$1] of Object.entries(pkg.peerDependencies)) {
+				if (pkg.peerDependenciesMeta?.[peerDependency]?.optional) continue;
+				if (existingPkg?.dependencies?.[peerDependency] || existingPkg?.devDependencies?.[peerDependency]) continue;
+				(pkg.peerDependenciesMeta?.[peerDependency]?.dev ? peerDevDeps : peerDeps).push(`${peerDependency}@${version$1}`);
+			}
+		}
+		if (peerDeps.length > 0) await addDependency(peerDeps, { ...resolvedOptions });
+		if (peerDevDeps.length > 0) await addDevDependency(peerDevDeps, { ...resolvedOptions });
+	}
+	return { exec: {
+		command: resolvedOptions.packageManager.command,
+		args
+	} };
+}
+/**
+* Adds dev dependency to the project.
+*
+* @param name - Name of the dev dependency to add.
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.workspace - The name of the workspace to use.
+* @param options.global - Whether to run the command in global mode.
+*
+*/
+async function addDevDependency(name$1, options = {}) {
+	return await addDependency(name$1, {
+		...options,
+		dev: true
+	});
+}
+/**
+* Removes dependency from the project.
+*
+* @param name - Name of the dependency to remove.
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.dev - Whether to remove dev dependency.
+* @param options.workspace - The name of the workspace to use.
+* @param options.global - Whether to run the command in global mode.
+*/
+async function removeDependency(name$1, options = {}) {
+	const resolvedOptions = await resolveOperationOptions(options);
+	const names = Array.isArray(name$1) ? name$1 : [name$1];
+	if (names.length === 0) return {};
+	const args = (resolvedOptions.packageManager.name === "yarn" ? [
+		resolvedOptions.global && resolvedOptions.packageManager.majorVersion === "1" ? "global" : "",
+		...getWorkspaceArgs(resolvedOptions),
+		"remove",
+		resolvedOptions.dev ? "-D" : "",
+		resolvedOptions.global ? "-g" : "",
+		...names
+	] : [
+		resolvedOptions.packageManager.name === "npm" ? "uninstall" : "remove",
+		...getWorkspaceArgs(resolvedOptions),
+		resolvedOptions.dev ? "-D" : "",
+		resolvedOptions.global ? "-g" : "",
+		...names
+	]).filter(Boolean);
+	if (!resolvedOptions.dry) await executeCommand(resolvedOptions.packageManager.command, args, {
+		cwd: resolvedOptions.cwd,
+		silent: resolvedOptions.silent,
+		corepack: resolvedOptions.corepack
+	});
+	return { exec: {
+		command: resolvedOptions.packageManager.command,
+		args
+	} };
+}
+/**
+* Dedupe dependencies in the project.
+*
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.recreateLockfile - Whether to recreate the lockfile instead of deduping.
+*/
+async function dedupeDependencies(options = {}) {
+	const resolvedOptions = await resolveOperationOptions(options);
+	const isSupported = !["bun", "deno"].includes(resolvedOptions.packageManager.name);
+	if (options.recreateLockfile ?? !isSupported) {
+		const lockfiles = Array.isArray(resolvedOptions.packageManager.lockFile) ? resolvedOptions.packageManager.lockFile : [resolvedOptions.packageManager.lockFile];
+		for (const lockfile of lockfiles) if (lockfile) fs.rmSync(resolve(resolvedOptions.cwd, lockfile), { force: true });
+		return await installDependencies(resolvedOptions);
+	}
+	if (isSupported) {
+		const isyarnv1 = resolvedOptions.packageManager.name === "yarn" && resolvedOptions.packageManager.majorVersion === "1";
+		if (!resolvedOptions.dry) await executeCommand(resolvedOptions.packageManager.command, [isyarnv1 ? "install" : "dedupe"], {
+			cwd: resolvedOptions.cwd,
+			silent: resolvedOptions.silent,
+			corepack: resolvedOptions.corepack
+		});
+		return { exec: {
+			command: resolvedOptions.packageManager.command,
+			args: [isyarnv1 ? "install" : "dedupe"]
+		} };
+	}
+	throw new Error(`Deduplication is not supported for ${resolvedOptions.packageManager.name}`);
+}
+/**
+* Runs a script defined in the package.json file.
+*
+* @param name - Name of the script to run.
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.env - Additional environment variables to set for the script execution.
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.args - Additional arguments to pass to the script.
+*/
+async function runScript(name$1, options = {}) {
+	const resolvedOptions = await resolveOperationOptions(options);
+	const args = [
+		resolvedOptions.packageManager.name === "deno" ? "task" : "run",
+		name$1,
+		...options.args || []
+	];
+	if (!resolvedOptions.dry) await executeCommand(resolvedOptions.packageManager.command, args, {
+		cwd: resolvedOptions.cwd,
+		env: resolvedOptions.env,
+		silent: resolvedOptions.silent,
+		corepack: resolvedOptions.corepack
+	});
+	return { exec: {
+		command: resolvedOptions.packageManager.command,
+		args
+	} };
+}
+
+//#endregion
+//#region src/cli.ts
+const operationArgs = {
+	cwd: {
+		type: "string",
+		description: "Current working directory"
+	},
+	workspace: {
+		type: "boolean",
+		description: "Add to workspace"
+	},
+	silent: {
+		type: "boolean",
+		description: "Run in silent mode"
+	},
+	corepack: {
+		type: "boolean",
+		default: true,
+		description: "Use corepack"
+	},
+	dry: {
+		type: "boolean",
+		description: "Run in dry run mode (does not execute commands)"
+	}
+};
+const install = defineCommand({
+	meta: { description: "Install dependencies" },
+	args: {
+		...operationArgs,
+		name: {
+			type: "positional",
+			description: "Dependency name",
+			required: false
+		},
+		dev: {
+			type: "boolean",
+			alias: "D",
+			description: "Add as dev dependency"
+		},
+		global: {
+			type: "boolean",
+			alias: "g",
+			description: "Add globally"
+		},
+		"frozen-lockfile": {
+			type: "boolean",
+			description: "Install dependencies with frozen lock file"
+		},
+		"install-peer-dependencies": {
+			type: "boolean",
+			description: "Also install peer dependencies"
+		}
+	},
+	run: async ({ args }) => {
+		handleRes(await (args._.length > 0 ? addDependency(args._, args) : installDependencies(args)), args);
+	}
+});
+const remove = defineCommand({
+	meta: { description: "Remove dependencies" },
+	args: {
+		name: {
+			type: "positional",
+			description: "Dependency name",
+			required: true
+		},
+		...operationArgs
+	},
+	run: async ({ args }) => {
+		handleRes(await removeDependency(args._, args), args);
+	}
+});
+const detect = defineCommand({
+	meta: { description: "Detect the current package manager" },
+	args: { cwd: {
+		type: "string",
+		description: "Current working directory"
+	} },
+	run: async ({ args }) => {
+		const cwd = resolve(args.cwd || ".");
+		const packageManager = await detectPackageManager(cwd);
+		if (packageManager?.warnings) for (const warning of packageManager.warnings) console.warn(warning);
+		if (!packageManager) {
+			console.error(`Cannot detect package manager in "${cwd}"`);
+			return process.exit(1);
+		}
+		console.log(`Detected package manager in "${cwd}": "${packageManager.name}@${packageManager.version}"`);
+	}
+});
+const dedupe = defineCommand({
+	meta: { description: "Dedupe dependencies" },
+	args: {
+		cwd: {
+			type: "string",
+			description: "Current working directory"
+		},
+		silent: {
+			type: "boolean",
+			description: "Run in silent mode"
+		},
+		recreateLockFile: {
+			type: "boolean",
+			description: "Recreate lock file"
+		}
+	},
+	run: async ({ args }) => {
+		handleRes(await dedupeDependencies(args), args);
+	}
+});
+const run = defineCommand({
+	meta: { description: "Run script" },
+	args: {
+		name: {
+			type: "positional",
+			description: "Script name",
+			required: true
+		},
+		...operationArgs
+	},
+	run: async ({ args }) => {
+		handleRes(await runScript(args.name, {
+			...args,
+			args: args._.slice(1)
+		}), args);
+	}
+});
+runMain(defineCommand({
+	meta: {
+		name,
+		version,
+		description
+	},
+	subCommands: {
+		install,
+		i: install,
+		add: install,
+		remove,
+		rm: remove,
+		uninstall: remove,
+		un: remove,
+		detect,
+		dedupe,
+		run
+	}
+}));
+function handleRes(result, args) {
+	if (args.dry && !args.silent) console.log(`${result.exec?.command} ${result.exec?.args.join(" ")}`);
+}
+
+//#endregion
+export {  };

backend/node_modules/nypm/dist/index.d.mts

@@ -0,0 +1,209 @@
+//#region src/types.d.ts
+type PackageManagerName = "npm" | "yarn" | "pnpm" | "bun" | "deno";
+type PackageManager = {
+  name: PackageManagerName;
+  command: string;
+  version?: string;
+  buildMeta?: string;
+  majorVersion?: string;
+  lockFile?: string | string[];
+  files?: string[];
+};
+type OperationOptions = {
+  cwd?: string;
+  env?: Record<string, string>;
+  silent?: boolean;
+  packageManager?: PackageManager | PackageManagerName;
+  installPeerDependencies?: boolean;
+  dev?: boolean;
+  workspace?: boolean | string;
+  global?: boolean;
+  corepack?: boolean; /** Do not execute actual command */
+  dry?: boolean;
+};
+type OperationResult = {
+  exec?: {
+    command: string;
+    args: string[];
+  };
+};
+//#endregion
+//#region src/package-manager.d.ts
+type DetectPackageManagerOptions = {
+  /**
+       * Whether to ignore the lock file
+       *
+       * @default false
+       */
+  ignoreLockFile?: boolean;
+  /**
+       * Whether to ignore the package.json file
+       *
+       * @default false
+       */
+  ignorePackageJSON?: boolean;
+  /**
+       * Whether to include parent directories
+       *
+       * @default false
+       */
+  includeParentDirs?: boolean;
+  /**
+       * Weather to ignore argv[1] to detect script
+       */
+  ignoreArgv?: boolean;
+};
+declare const packageManagers: PackageManager[];
+/**
+ * Detect the package manager used in a directory (and up) by checking various sources:
+ *
+ * 1. Use `packageManager` field from package.json
+ *
+ * 2. Known lock files and other files
+ */
+declare function detectPackageManager(cwd: string, options?: DetectPackageManagerOptions): Promise<(PackageManager & {
+  warnings?: string[];
+}) | undefined>;
+//#endregion
+//#region src/api.d.ts
+/**
+ * Installs project dependencies.
+ *
+ * @param options - Options to pass to the API call.
+ * @param options.cwd - The directory to run the command in.
+ * @param options.silent - Whether to run the command in silent mode.
+ * @param options.packageManager - The package manager info to use (auto-detected).
+ * @param options.frozenLockFile - Whether to install dependencies with frozen lock file.
+ */
+declare function installDependencies(options?: Pick<OperationOptions, "cwd" | "silent" | "packageManager" | "dry" | "corepack"> & {
+  frozenLockFile?: boolean;
+  ignoreWorkspace?: boolean;
+}): Promise<OperationResult>;
+/**
+ * Adds dependency to the project.
+ *
+ * @param name - Name of the dependency to add.
+ * @param options - Options to pass to the API call.
+ * @param options.cwd - The directory to run the command in.
+ * @param options.silent - Whether to run the command in silent mode.
+ * @param options.packageManager - The package manager info to use (auto-detected).
+ * @param options.dev - Whether to add the dependency as dev dependency.
+ * @param options.workspace - The name of the workspace to use.
+ * @param options.global - Whether to run the command in global mode.
+ */
+declare function addDependency(name: string | string[], options?: OperationOptions): Promise<OperationResult>;
+/**
+ * Adds dev dependency to the project.
+ *
+ * @param name - Name of the dev dependency to add.
+ * @param options - Options to pass to the API call.
+ * @param options.cwd - The directory to run the command in.
+ * @param options.silent - Whether to run the command in silent mode.
+ * @param options.packageManager - The package manager info to use (auto-detected).
+ * @param options.workspace - The name of the workspace to use.
+ * @param options.global - Whether to run the command in global mode.
+ *
+ */
+declare function addDevDependency(name: string | string[], options?: Omit<OperationOptions, "dev">): Promise<OperationResult>;
+/**
+ * Removes dependency from the project.
+ *
+ * @param name - Name of the dependency to remove.
+ * @param options - Options to pass to the API call.
+ * @param options.cwd - The directory to run the command in.
+ * @param options.silent - Whether to run the command in silent mode.
+ * @param options.packageManager - The package manager info to use (auto-detected).
+ * @param options.dev - Whether to remove dev dependency.
+ * @param options.workspace - The name of the workspace to use.
+ * @param options.global - Whether to run the command in global mode.
+ */
+declare function removeDependency(name: string | string[], options?: OperationOptions): Promise<OperationResult>;
+/**
+ * Ensures dependency is installed.
+ *
+ * @param name - Name of the dependency.
+ * @param options - Options to pass to the API call.
+ * @param options.cwd - The directory to run the command in.
+ * @param options.dev - Whether to install as dev dependency (if not already installed).
+ * @param options.workspace - The name of the workspace to install dependency in (if not already installed).
+ */
+declare function ensureDependencyInstalled(name: string, options?: Pick<OperationOptions, "cwd" | "dev" | "workspace">): Promise<true | undefined>;
+/**
+ * Dedupe dependencies in the project.
+ *
+ * @param options - Options to pass to the API call.
+ * @param options.cwd - The directory to run the command in.
+ * @param options.packageManager - The package manager info to use (auto-detected).
+ * @param options.silent - Whether to run the command in silent mode.
+ * @param options.recreateLockfile - Whether to recreate the lockfile instead of deduping.
+ */
+declare function dedupeDependencies(options?: Pick<OperationOptions, "cwd" | "silent" | "packageManager" | "dry" | "corepack"> & {
+  recreateLockfile?: boolean;
+}): Promise<OperationResult>;
+/**
+ * Runs a script defined in the package.json file.
+ *
+ * @param name - Name of the script to run.
+ * @param options - Options to pass to the API call.
+ * @param options.cwd - The directory to run the command in.
+ * @param options.env - Additional environment variables to set for the script execution.
+ * @param options.silent - Whether to run the command in silent mode.
+ * @param options.packageManager - The package manager info to use (auto-detected).
+ * @param options.args - Additional arguments to pass to the script.
+ */
+declare function runScript(name: string, options?: Pick<OperationOptions, "cwd" | "env" | "silent" | "packageManager" | "dry" | "corepack"> & {
+  args?: string[];
+}): Promise<OperationResult>;
+/**
+ * Download and execute a package with the package manager.
+ *
+ * @param name - Name of the package to download and execute.
+ * @param options - Options to pass to the API call.
+ * @param options.cwd - The directory to run the command in.
+ * @param options.env - Additional environment variables to set for the command execution.
+ * @param options.silent - Whether to run the command in silent mode.
+ * @param options.packageManager - The package manager info to use (auto-detected).
+ * @param options.args - The arguments to pass to the command.
+ * @param options.short - Whether to use the short version of the command (e.g. pnpx instead of pnpm dlx).
+ * @param options.packages - The packages to pass to the command (e.g. npx --package=<package1> --package=<package2> <command>).
+ */
+declare function dlx(name: string, options?: Pick<OperationOptions, "cwd" | "env" | "silent" | "packageManager" | "dry" | "corepack"> & {
+  args?: string[];
+  short?: boolean;
+  packages?: string[];
+}): Promise<OperationResult>;
+//#endregion
+//#region src/cmd.d.ts
+/**
+ * Get the command to install dependencies with the package manager.
+ */
+declare function installDependenciesCommand(packageManager: PackageManagerName, options?: {
+  short?: boolean;
+  frozenLockFile?: boolean;
+}): string;
+/**
+ * Get the command to add a dependency with the package manager.
+ */
+declare function addDependencyCommand(packageManager: PackageManagerName, name: string | string[], options?: {
+  dev?: boolean;
+  global?: boolean;
+  yarnBerry?: boolean;
+  workspace?: boolean | string;
+  short?: boolean;
+}): string;
+/**
+ * Get the command to run a script with the package manager.
+ */
+declare function runScriptCommand(packageManager: PackageManagerName, name: string, options?: {
+  args?: string[];
+}): string;
+/**
+ * Get the command to download and execute a package with the package manager.
+ */
+declare function dlxCommand(packageManager: PackageManagerName, name: string, options?: {
+  args?: string[];
+  short?: boolean;
+  packages?: string[];
+}): string;
+//#endregion
+export { DetectPackageManagerOptions, OperationOptions, OperationResult, PackageManager, PackageManagerName, addDependency, addDependencyCommand, addDevDependency, dedupeDependencies, detectPackageManager, dlx, dlxCommand, ensureDependencyInstalled, installDependencies, installDependenciesCommand, packageManagers, removeDependency, runScript, runScriptCommand };

backend/node_modules/nypm/dist/index.mjs

@@ -0,0 +1,541 @@
+import { createRequire } from "node:module";
+import * as fs from "node:fs";
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join, normalize, resolve } from "pathe";
+import { x } from "tinyexec";
+import { join as join$1 } from "node:path";
+
+//#region src/_utils.ts
+async function findup(cwd, match, options = {}) {
+	const segments = normalize(cwd).split("/");
+	while (segments.length > 0) {
+		const result = await match(segments.join("/") || "/");
+		if (result || !options.includeParentDirs) return result;
+		segments.pop();
+	}
+}
+async function readPackageJSON(cwd) {
+	return findup(cwd, (p) => {
+		const pkgPath = join$1(p, "package.json");
+		if (existsSync(pkgPath)) return readFile(pkgPath, "utf8").then((data) => JSON.parse(data));
+	});
+}
+function cached(fn) {
+	let v;
+	return () => {
+		if (v === void 0) v = fn().then((r) => {
+			v = r;
+			return v;
+		});
+		return v;
+	};
+}
+const hasCorepack = cached(async () => {
+	if (globalThis.process?.versions?.webcontainer) return false;
+	try {
+		const { exitCode } = await x("corepack", ["--version"]);
+		return exitCode === 0;
+	} catch {
+		return false;
+	}
+});
+async function executeCommand(command, args, options = {}) {
+	const xArgs = command !== "npm" && command !== "bun" && command !== "deno" && options.corepack !== false && await hasCorepack() ? ["corepack", [command, ...args]] : [command, args];
+	const { exitCode, stdout, stderr } = await x(xArgs[0], xArgs[1], { nodeOptions: {
+		cwd: resolve(options.cwd || process.cwd()),
+		env: options.env,
+		stdio: options.silent ? "pipe" : "inherit"
+	} });
+	if (exitCode !== 0) throw new Error(`\`${xArgs.flat().join(" ")}\` failed.${options.silent ? [
+		"",
+		stdout,
+		stderr
+	].join("\n") : ""}`);
+}
+const NO_PACKAGE_MANAGER_DETECTED_ERROR_MSG = "No package manager auto-detected.";
+async function resolveOperationOptions(options = {}) {
+	const cwd = options.cwd || process.cwd();
+	const env = {
+		...process.env,
+		...options.env
+	};
+	const packageManager = (typeof options.packageManager === "string" ? packageManagers.find((pm) => pm.name === options.packageManager) : options.packageManager) || await detectPackageManager(options.cwd || process.cwd());
+	if (!packageManager) throw new Error(NO_PACKAGE_MANAGER_DETECTED_ERROR_MSG);
+	return {
+		cwd,
+		env,
+		silent: options.silent ?? false,
+		packageManager,
+		dev: options.dev ?? false,
+		workspace: options.workspace,
+		global: options.global ?? false,
+		dry: options.dry ?? false,
+		corepack: options.corepack ?? true
+	};
+}
+function getWorkspaceArgs(options) {
+	if (!options.workspace) return [];
+	const workspacePkg = typeof options.workspace === "string" && options.workspace !== "" ? options.workspace : void 0;
+	if (options.packageManager.name === "pnpm") return workspacePkg ? ["--filter", workspacePkg] : ["--workspace-root"];
+	if (options.packageManager.name === "npm") return workspacePkg ? ["-w", workspacePkg] : ["--workspaces"];
+	if (options.packageManager.name === "yarn") if (!options.packageManager.majorVersion || options.packageManager.majorVersion === "1") return workspacePkg ? ["--cwd", workspacePkg] : ["-W"];
+	else return workspacePkg ? ["workspace", workspacePkg] : [];
+	return [];
+}
+function getWorkspaceArgs2(options) {
+	if (!options.workspace) return [];
+	const workspacePkg = typeof options.workspace === "string" && options.workspace !== "" ? options.workspace : void 0;
+	if (options.packageManager === "pnpm") return workspacePkg ? ["--filter", workspacePkg] : ["--workspace-root"];
+	if (options.packageManager === "npm") return workspacePkg ? ["-w", workspacePkg] : ["--workspaces"];
+	if (options.packageManager === "yarn") if (options.yarnBerry) return workspacePkg ? ["workspace", workspacePkg] : [];
+	else return workspacePkg ? ["--cwd", workspacePkg] : ["-W"];
+	return [];
+}
+function fmtCommand(args) {
+	return args.filter(Boolean).map((arg, i) => i > 0 && arg.includes(" ") ? `"${arg}"` : arg).join(" ");
+}
+function doesDependencyExist(name, options) {
+	const require = createRequire(options.cwd.endsWith("/") ? options.cwd : options.cwd + "/");
+	try {
+		return require.resolve(name).startsWith(options.cwd);
+	} catch {
+		return false;
+	}
+}
+function parsePackageManagerField(packageManager) {
+	const [name, _version] = (packageManager || "").split("@");
+	const [version, buildMeta] = _version?.split("+") || [];
+	if (name && name !== "-" && /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(name)) return {
+		name,
+		version,
+		buildMeta
+	};
+	const sanitized = (name || "").replace(/\W+/g, "");
+	return {
+		name: sanitized,
+		version,
+		buildMeta,
+		warnings: [`Abnormal characters found in \`packageManager\` field, sanitizing from \`${name}\` to \`${sanitized}\``]
+	};
+}
+
+//#endregion
+//#region src/package-manager.ts
+const packageManagers = [
+	{
+		name: "npm",
+		command: "npm",
+		lockFile: "package-lock.json"
+	},
+	{
+		name: "pnpm",
+		command: "pnpm",
+		lockFile: "pnpm-lock.yaml",
+		files: ["pnpm-workspace.yaml"]
+	},
+	{
+		name: "bun",
+		command: "bun",
+		lockFile: ["bun.lockb", "bun.lock"]
+	},
+	{
+		name: "yarn",
+		command: "yarn",
+		lockFile: "yarn.lock",
+		files: [".yarnrc.yml"]
+	},
+	{
+		name: "deno",
+		command: "deno",
+		lockFile: "deno.lock",
+		files: ["deno.json"]
+	}
+];
+/**
+* Detect the package manager used in a directory (and up) by checking various sources:
+*
+* 1. Use `packageManager` field from package.json
+*
+* 2. Known lock files and other files
+*/
+async function detectPackageManager(cwd, options = {}) {
+	const detected = await findup(resolve(cwd || "."), async (path) => {
+		if (!options.ignorePackageJSON) {
+			const packageJSONPath = join(path, "package.json");
+			if (existsSync(packageJSONPath)) {
+				const packageJSON = JSON.parse(await readFile(packageJSONPath, "utf8"));
+				if (packageJSON?.packageManager) {
+					const { name, version = "0.0.0", buildMeta, warnings } = parsePackageManagerField(packageJSON.packageManager);
+					if (name) {
+						const majorVersion = version.split(".")[0];
+						const packageManager = packageManagers.find((pm) => pm.name === name && pm.majorVersion === majorVersion) || packageManagers.find((pm) => pm.name === name);
+						return {
+							name,
+							command: name,
+							version,
+							majorVersion,
+							buildMeta,
+							warnings,
+							files: packageManager?.files,
+							lockFile: packageManager?.lockFile
+						};
+					}
+				}
+			}
+			if (existsSync(join(path, "deno.json"))) return packageManagers.find((pm) => pm.name === "deno");
+		}
+		if (!options.ignoreLockFile) {
+			for (const packageManager of packageManagers) if ([packageManager.lockFile, packageManager.files].flat().filter(Boolean).some((file) => existsSync(resolve(path, file)))) return { ...packageManager };
+		}
+	}, { includeParentDirs: options.includeParentDirs ?? true });
+	if (!detected && !options.ignoreArgv) {
+		const scriptArg = process.argv[1];
+		if (scriptArg) {
+			for (const packageManager of packageManagers) if ((/* @__PURE__ */ new RegExp(`[/\\\\]\\.?${packageManager.command}`)).test(scriptArg)) return packageManager;
+		}
+	}
+	return detected;
+}
+
+//#endregion
+//#region src/cmd.ts
+/**
+* Get the command to install dependencies with the package manager.
+*/
+function installDependenciesCommand(packageManager, options = {}) {
+	const installCmd = options.short ? "i" : "install";
+	const pmToFrozenLockfileInstallCommand = {
+		npm: ["ci"],
+		yarn: [installCmd, "--immutable"],
+		bun: [installCmd, "--frozen-lockfile"],
+		pnpm: [installCmd, "--frozen-lockfile"],
+		deno: [installCmd, "--frozen"]
+	};
+	return fmtCommand([packageManager, ...options.frozenLockFile ? pmToFrozenLockfileInstallCommand[packageManager] : [installCmd]]);
+}
+/**
+* Get the command to add a dependency with the package manager.
+*/
+function addDependencyCommand(packageManager, name, options = {}) {
+	const names = Array.isArray(name) ? name : [name];
+	if (packageManager === "deno") {
+		for (let i = 0; i < names.length; i++) if (!/^(npm|jsr|file):.+$/.test(names[i])) names[i] = `npm:${names[i]}`;
+	}
+	return fmtCommand([packageManager, ...(packageManager === "yarn" ? [
+		...getWorkspaceArgs2({
+			packageManager,
+			...options
+		}),
+		options.global && !options.yarnBerry ? "global" : "",
+		"add",
+		options.dev ? options.short ? "-D" : "--dev" : "",
+		...names
+	] : [
+		packageManager === "npm" ? options.short ? "i" : "install" : "add",
+		...getWorkspaceArgs2({
+			packageManager,
+			...options
+		}),
+		options.dev ? options.short ? "-D" : "--dev" : "",
+		options.global ? "-g" : "",
+		...names
+	]).filter(Boolean)]);
+}
+/**
+* Get the command to run a script with the package manager.
+*/
+function runScriptCommand(packageManager, name, options = {}) {
+	return fmtCommand([packageManager, ...[
+		packageManager === "deno" ? "task" : "run",
+		name,
+		...options.args || []
+	]]);
+}
+/**
+* Get the command to download and execute a package with the package manager.
+*/
+function dlxCommand(packageManager, name, options = {}) {
+	const command = {
+		npm: options.short ? "npx" : "npm exec",
+		yarn: "yarn dlx",
+		pnpm: options.short ? "pnpx" : "pnpm dlx",
+		bun: options.short ? "bunx" : "bun x",
+		deno: "deno run -A"
+	}[packageManager];
+	let packages = options.packages || [];
+	if (packageManager === "deno") {
+		if (!name.startsWith("npm:")) name = `npm:${name}`;
+		packages = packages.map((pkg) => pkg.startsWith("npm:") ? pkg : `npm:${pkg}`);
+	}
+	const packageArgs = [];
+	if (packages.length > 0 && packageManager !== "deno") {
+		const packageFlag = options.short && /^npm|yarn$/.test(packageManager) ? "-p" : "--package";
+		for (const pkg of packages) packageArgs.push(`${packageFlag}=${pkg}`);
+	}
+	const argSep = packageManager === "npm" && !options.short ? "--" : "";
+	return fmtCommand([
+		command,
+		...packageArgs,
+		name,
+		argSep,
+		...options.args || []
+	]);
+}
+
+//#endregion
+//#region src/api.ts
+/**
+* Installs project dependencies.
+*
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.frozenLockFile - Whether to install dependencies with frozen lock file.
+*/
+async function installDependencies(options = {}) {
+	const resolvedOptions = await resolveOperationOptions(options);
+	const commandArgs = options.frozenLockFile ? {
+		npm: ["ci"],
+		yarn: ["install", "--immutable"],
+		bun: ["install", "--frozen-lockfile"],
+		pnpm: ["install", "--frozen-lockfile"],
+		deno: ["install", "--frozen"]
+	}[resolvedOptions.packageManager.name] : ["install"];
+	if (options.ignoreWorkspace && resolvedOptions.packageManager.name === "pnpm") commandArgs.push("--ignore-workspace");
+	if (!resolvedOptions.dry) await executeCommand(resolvedOptions.packageManager.command, commandArgs, {
+		cwd: resolvedOptions.cwd,
+		silent: resolvedOptions.silent,
+		corepack: resolvedOptions.corepack
+	});
+	return { exec: {
+		command: resolvedOptions.packageManager.command,
+		args: commandArgs
+	} };
+}
+/**
+* Adds dependency to the project.
+*
+* @param name - Name of the dependency to add.
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.dev - Whether to add the dependency as dev dependency.
+* @param options.workspace - The name of the workspace to use.
+* @param options.global - Whether to run the command in global mode.
+*/
+async function addDependency(name, options = {}) {
+	const resolvedOptions = await resolveOperationOptions(options);
+	const names = Array.isArray(name) ? name : [name];
+	if (resolvedOptions.packageManager.name === "deno") {
+		for (let i = 0; i < names.length; i++) if (!/^(npm|jsr|file):.+$/.test(names[i] || "")) names[i] = `npm:${names[i]}`;
+	}
+	if (names.length === 0) return {};
+	const args = (resolvedOptions.packageManager.name === "yarn" ? [
+		...getWorkspaceArgs(resolvedOptions),
+		resolvedOptions.global && resolvedOptions.packageManager.majorVersion === "1" ? "global" : "",
+		"add",
+		resolvedOptions.dev ? "-D" : "",
+		...names
+	] : [
+		resolvedOptions.packageManager.name === "npm" ? "install" : "add",
+		...getWorkspaceArgs(resolvedOptions),
+		resolvedOptions.dev ? "-D" : "",
+		resolvedOptions.global ? "-g" : "",
+		...names
+	]).filter(Boolean);
+	if (!resolvedOptions.dry) await executeCommand(resolvedOptions.packageManager.command, args, {
+		cwd: resolvedOptions.cwd,
+		silent: resolvedOptions.silent,
+		corepack: resolvedOptions.corepack
+	});
+	if (!resolvedOptions.dry && options.installPeerDependencies) {
+		const existingPkg = await readPackageJSON(resolvedOptions.cwd);
+		const peerDeps = [];
+		const peerDevDeps = [];
+		for (const _name of names) {
+			const pkgName = _name.match(/^(.[^@]+)/)?.[0];
+			const pkg = createRequire(join$1(resolvedOptions.cwd, "/_.js"))(`${pkgName}/package.json`);
+			if (!pkg.peerDependencies || pkg.name !== pkgName) continue;
+			for (const [peerDependency, version] of Object.entries(pkg.peerDependencies)) {
+				if (pkg.peerDependenciesMeta?.[peerDependency]?.optional) continue;
+				if (existingPkg?.dependencies?.[peerDependency] || existingPkg?.devDependencies?.[peerDependency]) continue;
+				(pkg.peerDependenciesMeta?.[peerDependency]?.dev ? peerDevDeps : peerDeps).push(`${peerDependency}@${version}`);
+			}
+		}
+		if (peerDeps.length > 0) await addDependency(peerDeps, { ...resolvedOptions });
+		if (peerDevDeps.length > 0) await addDevDependency(peerDevDeps, { ...resolvedOptions });
+	}
+	return { exec: {
+		command: resolvedOptions.packageManager.command,
+		args
+	} };
+}
+/**
+* Adds dev dependency to the project.
+*
+* @param name - Name of the dev dependency to add.
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.workspace - The name of the workspace to use.
+* @param options.global - Whether to run the command in global mode.
+*
+*/
+async function addDevDependency(name, options = {}) {
+	return await addDependency(name, {
+		...options,
+		dev: true
+	});
+}
+/**
+* Removes dependency from the project.
+*
+* @param name - Name of the dependency to remove.
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.dev - Whether to remove dev dependency.
+* @param options.workspace - The name of the workspace to use.
+* @param options.global - Whether to run the command in global mode.
+*/
+async function removeDependency(name, options = {}) {
+	const resolvedOptions = await resolveOperationOptions(options);
+	const names = Array.isArray(name) ? name : [name];
+	if (names.length === 0) return {};
+	const args = (resolvedOptions.packageManager.name === "yarn" ? [
+		resolvedOptions.global && resolvedOptions.packageManager.majorVersion === "1" ? "global" : "",
+		...getWorkspaceArgs(resolvedOptions),
+		"remove",
+		resolvedOptions.dev ? "-D" : "",
+		resolvedOptions.global ? "-g" : "",
+		...names
+	] : [
+		resolvedOptions.packageManager.name === "npm" ? "uninstall" : "remove",
+		...getWorkspaceArgs(resolvedOptions),
+		resolvedOptions.dev ? "-D" : "",
+		resolvedOptions.global ? "-g" : "",
+		...names
+	]).filter(Boolean);
+	if (!resolvedOptions.dry) await executeCommand(resolvedOptions.packageManager.command, args, {
+		cwd: resolvedOptions.cwd,
+		silent: resolvedOptions.silent,
+		corepack: resolvedOptions.corepack
+	});
+	return { exec: {
+		command: resolvedOptions.packageManager.command,
+		args
+	} };
+}
+/**
+* Ensures dependency is installed.
+*
+* @param name - Name of the dependency.
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.dev - Whether to install as dev dependency (if not already installed).
+* @param options.workspace - The name of the workspace to install dependency in (if not already installed).
+*/
+async function ensureDependencyInstalled(name, options = {}) {
+	const resolvedOptions = await resolveOperationOptions(options);
+	if (doesDependencyExist(name, resolvedOptions)) return true;
+	await addDependency(name, resolvedOptions);
+}
+/**
+* Dedupe dependencies in the project.
+*
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.recreateLockfile - Whether to recreate the lockfile instead of deduping.
+*/
+async function dedupeDependencies(options = {}) {
+	const resolvedOptions = await resolveOperationOptions(options);
+	const isSupported = !["bun", "deno"].includes(resolvedOptions.packageManager.name);
+	if (options.recreateLockfile ?? !isSupported) {
+		const lockfiles = Array.isArray(resolvedOptions.packageManager.lockFile) ? resolvedOptions.packageManager.lockFile : [resolvedOptions.packageManager.lockFile];
+		for (const lockfile of lockfiles) if (lockfile) fs.rmSync(resolve(resolvedOptions.cwd, lockfile), { force: true });
+		return await installDependencies(resolvedOptions);
+	}
+	if (isSupported) {
+		const isyarnv1 = resolvedOptions.packageManager.name === "yarn" && resolvedOptions.packageManager.majorVersion === "1";
+		if (!resolvedOptions.dry) await executeCommand(resolvedOptions.packageManager.command, [isyarnv1 ? "install" : "dedupe"], {
+			cwd: resolvedOptions.cwd,
+			silent: resolvedOptions.silent,
+			corepack: resolvedOptions.corepack
+		});
+		return { exec: {
+			command: resolvedOptions.packageManager.command,
+			args: [isyarnv1 ? "install" : "dedupe"]
+		} };
+	}
+	throw new Error(`Deduplication is not supported for ${resolvedOptions.packageManager.name}`);
+}
+/**
+* Runs a script defined in the package.json file.
+*
+* @param name - Name of the script to run.
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.env - Additional environment variables to set for the script execution.
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.args - Additional arguments to pass to the script.
+*/
+async function runScript(name, options = {}) {
+	const resolvedOptions = await resolveOperationOptions(options);
+	const args = [
+		resolvedOptions.packageManager.name === "deno" ? "task" : "run",
+		name,
+		...options.args || []
+	];
+	if (!resolvedOptions.dry) await executeCommand(resolvedOptions.packageManager.command, args, {
+		cwd: resolvedOptions.cwd,
+		env: resolvedOptions.env,
+		silent: resolvedOptions.silent,
+		corepack: resolvedOptions.corepack
+	});
+	return { exec: {
+		command: resolvedOptions.packageManager.command,
+		args
+	} };
+}
+/**
+* Download and execute a package with the package manager.
+*
+* @param name - Name of the package to download and execute.
+* @param options - Options to pass to the API call.
+* @param options.cwd - The directory to run the command in.
+* @param options.env - Additional environment variables to set for the command execution.
+* @param options.silent - Whether to run the command in silent mode.
+* @param options.packageManager - The package manager info to use (auto-detected).
+* @param options.args - The arguments to pass to the command.
+* @param options.short - Whether to use the short version of the command (e.g. pnpx instead of pnpm dlx).
+* @param options.packages - The packages to pass to the command (e.g. npx --package=<package1> --package=<package2> <command>).
+*/
+async function dlx(name, options = {}) {
+	const resolvedOptions = await resolveOperationOptions(options);
+	const [command, ...args] = dlxCommand(resolvedOptions.packageManager.name, name, {
+		args: options.args,
+		short: options.short,
+		packages: options.packages
+	}).split(" ");
+	if (!resolvedOptions.dry) await executeCommand(command, args, {
+		cwd: resolvedOptions.cwd,
+		env: resolvedOptions.env,
+		silent: resolvedOptions.silent,
+		corepack: resolvedOptions.corepack
+	});
+	return { exec: {
+		command,
+		args
+	} };
+}
+
+//#endregion
+export { addDependency, addDependencyCommand, addDevDependency, dedupeDependencies, detectPackageManager, dlx, dlxCommand, ensureDependencyInstalled, installDependencies, installDependenciesCommand, packageManagers, removeDependency, runScript, runScriptCommand };