permdock 0.5.0 → 0.7.0

package/dist/peer-12Q5I_RH.js

@@ -0,0 +1,976 @@
+import { n as CliError } from "./errors-DpP_U6Bf.js";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+import fs from "node:fs/promises";
+import process$1 from "node:process";
+//#region ../../node_modules/.pnpm/package-manager-detector@1.9.0/node_modules/package-manager-detector/dist/commands.mjs
+function splitRunArgs(args, valueFlags = []) {
+	for (let i = 0; i < args.length; i++) {
+		if (args[i].startsWith("-")) continue;
+		if (i > 0 && valueFlags.includes(args[i - 1])) continue;
+		return {
+			before: args.slice(0, i),
+			script: args[i],
+			after: args.slice(i + 1)
+		};
+	}
+	return {
+		before: args,
+		script: void 0,
+		after: []
+	};
+}
+function dashDashArg(agent, agentCommand, valueFlags = []) {
+	return (args) => {
+		const { before, script, after } = splitRunArgs(args, valueFlags);
+		if (script === void 0) return [
+			agent,
+			agentCommand,
+			...before
+		];
+		if (after.length > 0) return [
+			agent,
+			agentCommand,
+			...before,
+			script,
+			"--",
+			...after
+		];
+		return [
+			agent,
+			agentCommand,
+			...before,
+			script
+		];
+	};
+}
+const npm = {
+	"agent": ["npm", 0],
+	"run": dashDashArg("npm", "run", ["-w", "--workspace"]),
+	"install": [
+		"npm",
+		"i",
+		0
+	],
+	"frozen": [
+		"npm",
+		"ci",
+		0
+	],
+	"global": [
+		"npm",
+		"i",
+		"-g",
+		0
+	],
+	"add": [
+		"npm",
+		"i",
+		0
+	],
+	"upgrade": [
+		"npm",
+		"update",
+		0
+	],
+	"upgrade-interactive": null,
+	"dedupe": [
+		"npm",
+		"dedupe",
+		0
+	],
+	"why": [
+		"npm",
+		"why",
+		0
+	],
+	"execute": ["npx", 0],
+	"execute-local": ["npx", 0],
+	"uninstall": [
+		"npm",
+		"uninstall",
+		0
+	],
+	"global_uninstall": [
+		"npm",
+		"uninstall",
+		"-g",
+		0
+	]
+};
+const yarn = {
+	"agent": ["yarn", 0],
+	"run": [
+		"yarn",
+		"run",
+		0
+	],
+	"install": [
+		"yarn",
+		"install",
+		0
+	],
+	"frozen": [
+		"yarn",
+		"install",
+		"--frozen-lockfile",
+		0
+	],
+	"global": [
+		"yarn",
+		"global",
+		"add",
+		0
+	],
+	"add": [
+		"yarn",
+		"add",
+		0
+	],
+	"upgrade": [
+		"yarn",
+		"upgrade",
+		0
+	],
+	"upgrade-interactive": [
+		"yarn",
+		"upgrade-interactive",
+		0
+	],
+	"dedupe": null,
+	"why": [
+		"yarn",
+		"why",
+		0
+	],
+	"execute": ["npx", 0],
+	"execute-local": dashDashArg("yarn", "exec"),
+	"uninstall": [
+		"yarn",
+		"remove",
+		0
+	],
+	"global_uninstall": [
+		"yarn",
+		"global",
+		"remove",
+		0
+	]
+};
+const yarnBerry = {
+	...yarn,
+	"frozen": [
+		"yarn",
+		"install",
+		"--immutable",
+		0
+	],
+	"upgrade": [
+		"yarn",
+		"up",
+		0
+	],
+	"upgrade-interactive": [
+		"yarn",
+		"up",
+		"-i",
+		0
+	],
+	"dedupe": [
+		"yarn",
+		"dedupe",
+		0
+	],
+	"execute": [
+		"yarn",
+		"dlx",
+		0
+	],
+	"execute-local": [
+		"yarn",
+		"exec",
+		0
+	],
+	"global": [
+		"npm",
+		"i",
+		"-g",
+		0
+	],
+	"global_uninstall": [
+		"npm",
+		"uninstall",
+		"-g",
+		0
+	]
+};
+function createPnpmCommands(cli) {
+	return {
+		"agent": [cli, 0],
+		"run": [
+			cli,
+			"run",
+			0
+		],
+		"install": [
+			cli,
+			"i",
+			0
+		],
+		"frozen": [
+			cli,
+			"i",
+			"--frozen-lockfile",
+			0
+		],
+		"global": [
+			cli,
+			"add",
+			"-g",
+			0
+		],
+		"add": [
+			cli,
+			"add",
+			0
+		],
+		"upgrade": [
+			cli,
+			"update",
+			0
+		],
+		"upgrade-interactive": [
+			cli,
+			"update",
+			"-i",
+			0
+		],
+		"dedupe": [
+			cli,
+			"dedupe",
+			0
+		],
+		"why": [
+			cli,
+			"why",
+			0
+		],
+		"execute": [
+			cli,
+			"dlx",
+			0
+		],
+		"execute-local": [
+			cli,
+			"exec",
+			0
+		],
+		"uninstall": [
+			cli,
+			"remove",
+			0
+		],
+		"global_uninstall": [
+			cli,
+			"remove",
+			"--global",
+			0
+		]
+	};
+}
+const pnpm = createPnpmCommands("pnpm");
+const pnpmRush = createPnpmCommands("rush-pnpm");
+const bun = {
+	"agent": ["bun", 0],
+	"run": [
+		"bun",
+		"run",
+		0
+	],
+	"install": [
+		"bun",
+		"install",
+		0
+	],
+	"frozen": [
+		"bun",
+		"install",
+		"--frozen-lockfile",
+		0
+	],
+	"global": [
+		"bun",
+		"add",
+		"-g",
+		0
+	],
+	"add": [
+		"bun",
+		"add",
+		0
+	],
+	"upgrade": [
+		"bun",
+		"update",
+		0
+	],
+	"upgrade-interactive": [
+		"bun",
+		"update",
+		"-i",
+		0
+	],
+	"dedupe": null,
+	"why": [
+		"bun",
+		"why",
+		0
+	],
+	"execute": [
+		"bun",
+		"x",
+		0
+	],
+	"execute-local": [
+		"bun",
+		"x",
+		0
+	],
+	"uninstall": [
+		"bun",
+		"remove",
+		0
+	],
+	"global_uninstall": [
+		"bun",
+		"remove",
+		"-g",
+		0
+	]
+};
+const aube = {
+	"agent": ["aube", 0],
+	"run": [
+		"aube",
+		"run",
+		0
+	],
+	"install": [
+		"aube",
+		"install",
+		0
+	],
+	"frozen": [
+		"aube",
+		"install",
+		"--frozen-lockfile",
+		0
+	],
+	"global": [
+		"aube",
+		"add",
+		"-g",
+		0
+	],
+	"add": [
+		"aube",
+		"add",
+		0
+	],
+	"upgrade": [
+		"aube",
+		"update",
+		0
+	],
+	"upgrade-interactive": [
+		"aube",
+		"update",
+		"-i",
+		0
+	],
+	"dedupe": [
+		"aube",
+		"dedupe",
+		0
+	],
+	"why": [
+		"aube",
+		"why",
+		0
+	],
+	"execute": [
+		"aube",
+		"dlx",
+		0
+	],
+	"execute-local": [
+		"aube",
+		"exec",
+		0
+	],
+	"uninstall": [
+		"aube",
+		"remove",
+		0
+	],
+	"global_uninstall": [
+		"aube",
+		"remove",
+		"-g",
+		0
+	]
+};
+function denoAdd(args) {
+	if (args.includes("--npm") || args.includes("--jsr")) return [
+		"deno",
+		"add",
+		...args
+	];
+	return [
+		"deno",
+		"add",
+		...args.map((arg) => arg.startsWith("-") || arg.includes(":") ? arg : `npm:${arg}`)
+	];
+}
+const deno = {
+	"agent": ["deno", 0],
+	"run": [
+		"deno",
+		"task",
+		0
+	],
+	"install": [
+		"deno",
+		"install",
+		0
+	],
+	"frozen": [
+		"deno",
+		"install",
+		"--frozen",
+		0
+	],
+	"global": [
+		"deno",
+		"install",
+		"-g",
+		0
+	],
+	"add": denoAdd,
+	"upgrade": [
+		"deno",
+		"outdated",
+		"--update",
+		0
+	],
+	"upgrade-interactive": [
+		"deno",
+		"outdated",
+		"--update",
+		0
+	],
+	"dedupe": null,
+	"why": [
+		"deno",
+		"why",
+		0
+	],
+	"execute": [
+		"deno",
+		"x",
+		0
+	],
+	"execute-local": [
+		"deno",
+		"task",
+		"--eval",
+		0
+	],
+	"uninstall": [
+		"deno",
+		"remove",
+		0
+	],
+	"global_uninstall": [
+		"deno",
+		"uninstall",
+		"-g",
+		0
+	]
+};
+const nub = {
+	"agent": ["nub", 0],
+	"run": [
+		"nub",
+		"run",
+		0
+	],
+	"install": [
+		"nub",
+		"install",
+		0
+	],
+	"frozen": [
+		"nub",
+		"install",
+		"--frozen-lockfile",
+		0
+	],
+	"global": [
+		"nub",
+		"add",
+		"-g",
+		0
+	],
+	"add": [
+		"nub",
+		"add",
+		0
+	],
+	"upgrade": [
+		"nub",
+		"update",
+		0
+	],
+	"upgrade-interactive": [
+		"nub",
+		"update",
+		"-i",
+		0
+	],
+	"dedupe": [
+		"nub",
+		"dedupe",
+		0
+	],
+	"why": [
+		"nub",
+		"why",
+		0
+	],
+	"execute": ["nubx", 0],
+	"execute-local": [
+		"nub",
+		"exec",
+		0
+	],
+	"uninstall": [
+		"nub",
+		"remove",
+		0
+	],
+	"global_uninstall": [
+		"nub",
+		"remove",
+		"-g",
+		0
+	]
+};
+const upm = {
+	"agent": ["upm", 0],
+	"run": [
+		"upm",
+		"run",
+		0
+	],
+	"install": [
+		"upm",
+		"install",
+		0
+	],
+	"frozen": [
+		"upm",
+		"install",
+		"--frozen-lockfile",
+		0
+	],
+	"global": null,
+	"add": [
+		"upm",
+		"add",
+		0
+	],
+	"upgrade": null,
+	"upgrade-interactive": null,
+	"dedupe": [
+		"upm",
+		"dedupe",
+		0
+	],
+	"execute": ["upx", 0],
+	"execute-local": [
+		"upm",
+		"exec",
+		0
+	],
+	"uninstall": [
+		"upm",
+		"remove",
+		0
+	],
+	"global_uninstall": null,
+	"why": null
+};
+const COMMANDS = {
+	"npm": npm,
+	"yarn": yarn,
+	"yarn@berry": yarnBerry,
+	"pnpm": pnpm,
+	"pnpm@6": {
+		...pnpm,
+		run: dashDashArg("pnpm", "run", ["-F", "--filter"])
+	},
+	"pnpm-rush": pnpmRush,
+	"bun": bun,
+	"aube": aube,
+	"deno": deno,
+	"nub": nub,
+	"upm": upm
+};
+const WORKSPACE_ROOT_CHECK_COMMANDS = {
+	"yarn": ["add", "uninstall"],
+	"pnpm": ["add"],
+	"pnpm@6": ["add"],
+	"pnpm-rush": ["add"]
+};
+const MINIMUM_RELEASE_AGE_FLAGS = {
+	"npm": {
+		commands: [
+			"install",
+			"add",
+			"upgrade",
+			"global",
+			"execute"
+		],
+		flag: (minutes) => `--min-release-age=${minutes / 1440}`
+	},
+	"pnpm": {
+		commands: [
+			"install",
+			"add",
+			"upgrade",
+			"upgrade-interactive",
+			"global",
+			"execute"
+		],
+		flag: (minutes) => `--config.minimum-release-age=${minutes}`
+	},
+	"pnpm-rush": {
+		commands: [
+			"install",
+			"add",
+			"upgrade",
+			"upgrade-interactive",
+			"global",
+			"execute"
+		],
+		flag: (minutes) => `--config.minimum-release-age=${minutes}`
+	},
+	"bun": {
+		commands: [
+			"install",
+			"add",
+			"upgrade",
+			"upgrade-interactive",
+			"global"
+		],
+		flag: (minutes) => `--minimum-release-age=${minutes * 60}`
+	},
+	"deno": {
+		commands: [
+			"install",
+			"add",
+			"global",
+			"execute"
+		],
+		flag: (minutes) => `--minimum-dependency-age=${minutes}`
+	},
+	"nub": {
+		commands: [
+			"install",
+			"add",
+			"upgrade",
+			"upgrade-interactive",
+			"global",
+			"execute"
+		],
+		flag: (minutes) => `--minimum-release-age=${minutes}`
+	},
+	"upm": {
+		commands: [
+			"install",
+			"add",
+			"execute"
+		],
+		flag: (minutes) => `--min-release-age=${minutes / 1440}`
+	}
+};
+function resolveCommand(agent, command, args, options = {}) {
+	const value = COMMANDS[agent][command];
+	if (options.ignoreWorkspaceRootCheck && WORKSPACE_ROOT_CHECK_COMMANDS[agent]?.includes(command)) args = ["--ignore-workspace-root-check", ...args];
+	const releaseAge = MINIMUM_RELEASE_AGE_FLAGS[agent];
+	if (options.minimumReleaseAge != null && releaseAge?.commands.includes(command)) args = [releaseAge.flag(options.minimumReleaseAge), ...args];
+	return constructCommand(value, args);
+}
+function constructCommand(value, args) {
+	if (value == null) return null;
+	const list = typeof value === "function" ? value(args) : value.flatMap((v) => {
+		if (typeof v === "number") return args;
+		return [v];
+	});
+	return {
+		command: list[0],
+		args: list.slice(1)
+	};
+}
+//#endregion
+//#region ../../node_modules/.pnpm/package-manager-detector@1.9.0/node_modules/package-manager-detector/dist/constants.mjs
+const AGENTS = [
+	"npm",
+	"yarn",
+	"yarn@berry",
+	"pnpm",
+	"pnpm@6",
+	"pnpm-rush",
+	"bun",
+	"deno",
+	"nub",
+	"aube",
+	"upm"
+];
+const LOCKS = {
+	"aube-lock.yaml": "aube",
+	"aube-workspace.yaml": "aube",
+	"bun.lock": "bun",
+	"bun.lockb": "bun",
+	"deno.lock": "deno",
+	"nub.lock": "nub",
+	"upm.lock": "upm",
+	"pnpm-lock.yaml": "pnpm",
+	"pnpm-workspace.yaml": "pnpm",
+	"yarn.lock": "yarn",
+	"package-lock.json": "npm",
+	"npm-shrinkwrap.json": "npm"
+};
+const INSTALL_METADATA = {
+	"node_modules/.aube/": "aube",
+	"node_modules/.deno/": "deno",
+	"node_modules/.pnpm/": "pnpm",
+	"node_modules/.upm/": "upm",
+	"node_modules/.yarn-state.yml": "yarn",
+	"node_modules/.yarn_integrity": "yarn",
+	"node_modules/.package-lock.json": "npm",
+	".pnp.cjs": "yarn",
+	".pnp.js": "yarn",
+	"bun.lock": "bun",
+	"bun.lockb": "bun"
+};
+//#endregion
+//#region ../../node_modules/.pnpm/package-manager-detector@1.9.0/node_modules/package-manager-detector/dist/detect.mjs
+async function pathExists(path2, type) {
+	try {
+		const stat = await fs.stat(path2);
+		return type === "file" ? stat.isFile() : stat.isDirectory();
+	} catch {
+		return false;
+	}
+}
+function getUserAgent() {
+	const userAgent = process$1.env.npm_config_user_agent;
+	if (!userAgent) return null;
+	const name = userAgent.split("/")[0];
+	return AGENTS.includes(name) ? name : null;
+}
+function* lookup(cwd = process$1.cwd()) {
+	let directory = path.resolve(cwd);
+	const { root } = path.parse(directory);
+	while (directory && directory !== root) {
+		yield directory;
+		directory = path.dirname(directory);
+	}
+}
+async function parsePackageJson(filepath, options) {
+	if (!filepath || !await pathExists(filepath, "file")) return null;
+	return await handlePackageManager(filepath, options);
+}
+async function detect(options = {}) {
+	const { cwd, strategies = [
+		"lockfile",
+		"packageManager-field",
+		"devEngines-field"
+	] } = options;
+	let stopDir;
+	if (typeof options.stopDir === "string") {
+		const resolved = path.resolve(options.stopDir);
+		stopDir = (dir) => dir === resolved;
+	} else stopDir = options.stopDir;
+	for (const directory of lookup(cwd)) {
+		for (const strategy of strategies) switch (strategy) {
+			case "lockfile":
+				if (await pathExists(path.join(directory, "rush.json"), "file")) return {
+					name: "pnpm",
+					agent: "pnpm-rush"
+				};
+				for (const lock of Object.keys(LOCKS)) if (await pathExists(path.join(directory, lock), "file")) {
+					const name = LOCKS[lock];
+					const result = await parsePackageJson(path.join(directory, "package.json"), options);
+					if (result) return result;
+					else return {
+						name,
+						agent: name
+					};
+				}
+				break;
+			case "packageManager-field":
+			case "devEngines-field": {
+				const result = await parsePackageJson(path.join(directory, "package.json"), options);
+				if (result) return result;
+				break;
+			}
+			case "install-metadata": for (const metadata of Object.keys(INSTALL_METADATA)) {
+				const fileOrDir = metadata.endsWith("/") ? "dir" : "file";
+				if (await pathExists(path.join(directory, metadata), fileOrDir)) {
+					const name = INSTALL_METADATA[metadata];
+					return {
+						name,
+						agent: name === "yarn" ? isMetadataYarnClassic(metadata) ? "yarn" : "yarn@berry" : name
+					};
+				}
+			}
+		}
+		if (stopDir?.(directory)) break;
+	}
+	return null;
+}
+function normalizeAgentVersion(version) {
+	return version?.match(/\d+(\.\d+){0,2}/)?.[0] ?? version;
+}
+function getNameAndVer(pkg) {
+	if (typeof pkg.packageManager === "string") {
+		const [name, ver] = pkg.packageManager.replace(/^\^/, "").split("@");
+		return {
+			name,
+			ver: normalizeAgentVersion(ver)
+		};
+	}
+	if (typeof pkg.devEngines?.packageManager?.name === "string") return {
+		name: pkg.devEngines.packageManager.name,
+		ver: normalizeAgentVersion(pkg.devEngines.packageManager.version)
+	};
+}
+async function handlePackageManager(filepath, options) {
+	try {
+		const content = await fs.readFile(filepath, "utf8");
+		const pkg = options.packageJsonParser ? await options.packageJsonParser(content, filepath) : JSON.parse(content);
+		const nameAndVer = getNameAndVer(pkg);
+		if (nameAndVer) return resolveAgent(nameAndVer.name, nameAndVer.ver) ?? options.onUnknown?.(pkg.packageManager) ?? null;
+	} catch {}
+	return null;
+}
+function resolveAgent(name, ver) {
+	let agent;
+	let version = ver;
+	if (name === "yarn" && ver && Number.parseInt(ver) > 1) {
+		agent = "yarn@berry";
+		version = "berry";
+		return {
+			name,
+			agent,
+			version
+		};
+	} else if (name === "pnpm" && ver && Number.parseInt(ver) < 7) {
+		agent = "pnpm@6";
+		return {
+			name,
+			agent,
+			version
+		};
+	} else if (AGENTS.includes(name)) {
+		agent = name;
+		return {
+			name,
+			agent,
+			version
+		};
+	}
+}
+function isMetadataYarnClassic(metadataPath) {
+	return metadataPath.endsWith(".yarn_integrity");
+}
+//#endregion
+//#region src/cli/core/peer.ts
+/**
+* Loads an optional peer dependency for one command, or fails with the line
+* that installs it with the project's package manager. Only the commands that
+* need a peer ever load it.
+*/
+async function requirePeer(load, name, command, cwd = process.cwd(), minimumMajor) {
+	try {
+		const loaded = await load();
+		const found = installedMajor(name);
+		if (minimumMajor !== void 0 && found < minimumMajor) {
+			const agent = await packageManagerOf(cwd);
+			throw new CliError("unavailable", `PermDock CLI: ${command} needs ${name} ${String(minimumMajor)} or later; ${String(found)} is installed. Upgrade it with: ${addLine(agent, [`${name}@latest`], { dev: true })}`, {
+				code: "dependency_missing",
+				extensions: {
+					package: name,
+					minimum: minimumMajor,
+					found
+				},
+				next: [{
+					command: addLine(agent, [`${name}@latest`], { dev: true }),
+					when: "to upgrade it"
+				}]
+			});
+		}
+		return loaded;
+	} catch (error) {
+		if (!isMissingModule(error)) throw error;
+		const agent = await packageManagerOf(cwd);
+		throw new CliError("unavailable", peerHint(name, command, agent), {
+			cause: error,
+			code: "dependency_missing",
+			extensions: { package: name },
+			next: [{
+				command: addLine(agent, [name], { dev: true }),
+				when: "to install it"
+			}]
+		});
+	}
+}
+/** The major version of the installed `name`; `NaN` when its package.json cannot be read, which no minimum rejects. */
+function installedMajor(name) {
+	try {
+		const file = createRequire(import.meta.url).resolve(`${name}/package.json`);
+		const manifest = JSON.parse(readFileSync(file, "utf8"));
+		return Math.trunc(Number(String(manifest.version).split(".")[0]));
+	} catch {
+		return NaN;
+	}
+}
+/** The package manager whose lockfile the project has, else the one running the CLI. */
+async function packageManagerOf(cwd) {
+	return (await detect({ cwd }))?.agent ?? getUserAgent() ?? void 0;
+}
+/** The command that adds `packages` with `agent`, npm when there is none. */
+function addLine(agent, packages, options) {
+	const args = options?.dev === true ? ["-D", ...packages] : [...packages];
+	const command = resolveCommand(agent ?? "npm", "add", args);
+	return command === null ? `npm install ${args.join(" ")}` : [command.command, ...command.args].join(" ");
+}
+function isMissingModule(error) {
+	if (typeof error !== "object" || error === null || !("code" in error)) return false;
+	return error.code === "ERR_MODULE_NOT_FOUND" || error.code === "MODULE_NOT_FOUND";
+}
+/**
+* The error for a missing peer. `agent` is the package manager that ran the
+* command, or the one whose lockfile the project has; without one the line
+* names pnpm and npm.
+*/
+function peerHint(name, command, agent = getUserAgent() ?? void 0) {
+	const install = agent === void 0 ? void 0 : resolveCommand(agent, "add", ["-D", name]);
+	return `PermDock CLI: ${command} needs the optional peer ${name}. Install it with: ${install === null || install === void 0 ? `pnpm add -D ${name} (or npm install -D ${name})` : [install.command, ...install.args].join(" ")}`;
+}
+//#endregion
+export { requirePeer as i, packageManagerOf as n, peerHint as r, addLine as t };