fast-npm-meta 1.2.1 → 1.4.0

package/dist/cli.mjs

@@ -0,0 +1,879 @@
+#!/usr/bin/env node
+import process$1 from "node:process";
+
+//#region ../node_modules/.pnpm/cac@7.0.0/node_modules/cac/dist/index.js
+function toArr(any) {
+	return any == null ? [] : Array.isArray(any) ? any : [any];
+}
+function toVal(out, key, val, opts) {
+	var x, old = out[key], nxt = !!~opts.string.indexOf(key) ? val == null || val === true ? "" : String(val) : typeof val === "boolean" ? val : !!~opts.boolean.indexOf(key) ? val === "false" ? false : val === "true" || (out._.push((x = +val, x * 0 === 0) ? x : val), !!val) : (x = +val, x * 0 === 0) ? x : val;
+	out[key] = old == null ? nxt : Array.isArray(old) ? old.concat(nxt) : [old, nxt];
+}
+function lib_default(args, opts) {
+	args = args || [];
+	opts = opts || {};
+	var k, arr, arg, name, val, out = { _: [] };
+	var i = 0, j = 0, idx = 0, len = args.length;
+	const alibi = opts.alias !== void 0;
+	const strict = opts.unknown !== void 0;
+	const defaults = opts.default !== void 0;
+	opts.alias = opts.alias || {};
+	opts.string = toArr(opts.string);
+	opts.boolean = toArr(opts.boolean);
+	if (alibi) for (k in opts.alias) {
+		arr = opts.alias[k] = toArr(opts.alias[k]);
+		for (i = 0; i < arr.length; i++) (opts.alias[arr[i]] = arr.concat(k)).splice(i, 1);
+	}
+	for (i = opts.boolean.length; i-- > 0;) {
+		arr = opts.alias[opts.boolean[i]] || [];
+		for (j = arr.length; j-- > 0;) opts.boolean.push(arr[j]);
+	}
+	for (i = opts.string.length; i-- > 0;) {
+		arr = opts.alias[opts.string[i]] || [];
+		for (j = arr.length; j-- > 0;) opts.string.push(arr[j]);
+	}
+	if (defaults) for (k in opts.default) {
+		name = typeof opts.default[k];
+		arr = opts.alias[k] = opts.alias[k] || [];
+		if (opts[name] !== void 0) {
+			opts[name].push(k);
+			for (i = 0; i < arr.length; i++) opts[name].push(arr[i]);
+		}
+	}
+	const keys = strict ? Object.keys(opts.alias) : [];
+	for (i = 0; i < len; i++) {
+		arg = args[i];
+		if (arg === "--") {
+			out._ = out._.concat(args.slice(++i));
+			break;
+		}
+		for (j = 0; j < arg.length; j++) if (arg.charCodeAt(j) !== 45) break;
+		if (j === 0) out._.push(arg);
+		else if (arg.substring(j, j + 3) === "no-") {
+			name = arg.substring(j + 3);
+			if (strict && !~keys.indexOf(name)) return opts.unknown(arg);
+			out[name] = false;
+		} else {
+			for (idx = j + 1; idx < arg.length; idx++) if (arg.charCodeAt(idx) === 61) break;
+			name = arg.substring(j, idx);
+			val = arg.substring(++idx) || i + 1 === len || ("" + args[i + 1]).charCodeAt(0) === 45 || args[++i];
+			arr = j === 2 ? [name] : name;
+			for (idx = 0; idx < arr.length; idx++) {
+				name = arr[idx];
+				if (strict && !~keys.indexOf(name)) return opts.unknown("-".repeat(j) + name);
+				toVal(out, name, idx + 1 < arr.length || val, opts);
+			}
+		}
+	}
+	if (defaults) {
+		for (k in opts.default) if (out[k] === void 0) out[k] = opts.default[k];
+	}
+	if (alibi) for (k in out) {
+		arr = opts.alias[k] || [];
+		while (arr.length > 0) out[arr.shift()] = out[k];
+	}
+	return out;
+}
+function removeBrackets(v) {
+	return v.replace(/[<[].+/, "").trim();
+}
+function findAllBrackets(v) {
+	const ANGLED_BRACKET_RE_GLOBAL = /<([^>]+)>/g;
+	const SQUARE_BRACKET_RE_GLOBAL = /\[([^\]]+)\]/g;
+	const res = [];
+	const parse = (match) => {
+		let variadic = false;
+		let value = match[1];
+		if (value.startsWith("...")) {
+			value = value.slice(3);
+			variadic = true;
+		}
+		return {
+			required: match[0].startsWith("<"),
+			value,
+			variadic
+		};
+	};
+	let angledMatch;
+	while (angledMatch = ANGLED_BRACKET_RE_GLOBAL.exec(v)) res.push(parse(angledMatch));
+	let squareMatch;
+	while (squareMatch = SQUARE_BRACKET_RE_GLOBAL.exec(v)) res.push(parse(squareMatch));
+	return res;
+}
+function getMriOptions(options) {
+	const result = {
+		alias: {},
+		boolean: []
+	};
+	for (const [index, option] of options.entries()) {
+		if (option.names.length > 1) result.alias[option.names[0]] = option.names.slice(1);
+		if (option.isBoolean) if (option.negated) {
+			if (!options.some((o, i) => {
+				return i !== index && o.names.some((name) => option.names.includes(name)) && typeof o.required === "boolean";
+			})) result.boolean.push(option.names[0]);
+		} else result.boolean.push(option.names[0]);
+	}
+	return result;
+}
+function findLongest(arr) {
+	return arr.sort((a, b) => {
+		return a.length > b.length ? -1 : 1;
+	})[0];
+}
+function padRight(str, length) {
+	return str.length >= length ? str : `${str}${" ".repeat(length - str.length)}`;
+}
+function camelcase(input) {
+	return input.replaceAll(/([a-z])-([a-z])/g, (_, p1, p2) => {
+		return p1 + p2.toUpperCase();
+	});
+}
+function setDotProp(obj, keys, val) {
+	let current = obj;
+	for (let i = 0; i < keys.length; i++) {
+		const key = keys[i];
+		if (i === keys.length - 1) {
+			current[key] = val;
+			return;
+		}
+		if (current[key] == null) {
+			const nextKeyIsArrayIndex = +keys[i + 1] > -1;
+			current[key] = nextKeyIsArrayIndex ? [] : {};
+		}
+		current = current[key];
+	}
+}
+function setByType(obj, transforms) {
+	for (const key of Object.keys(transforms)) {
+		const transform = transforms[key];
+		if (transform.shouldTransform) {
+			obj[key] = [obj[key]].flat();
+			if (typeof transform.transformFunction === "function") obj[key] = obj[key].map(transform.transformFunction);
+		}
+	}
+}
+function getFileName(input) {
+	const m = /([^\\/]+)$/.exec(input);
+	return m ? m[1] : "";
+}
+function camelcaseOptionName(name) {
+	return name.split(".").map((v, i) => {
+		return i === 0 ? camelcase(v) : v;
+	}).join(".");
+}
+var CACError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "CACError";
+		if (typeof Error.captureStackTrace !== "function") this.stack = new Error(message).stack;
+	}
+};
+var Option = class {
+	rawName;
+	description;
+	/** Option name */
+	name;
+	/** Option name and aliases */
+	names;
+	isBoolean;
+	required;
+	config;
+	negated;
+	constructor(rawName, description, config) {
+		this.rawName = rawName;
+		this.description = description;
+		this.config = Object.assign({}, config);
+		rawName = rawName.replaceAll(".*", "");
+		this.negated = false;
+		this.names = removeBrackets(rawName).split(",").map((v) => {
+			let name = v.trim().replace(/^-{1,2}/, "");
+			if (name.startsWith("no-")) {
+				this.negated = true;
+				name = name.replace(/^no-/, "");
+			}
+			return camelcaseOptionName(name);
+		}).sort((a, b) => a.length > b.length ? 1 : -1);
+		this.name = this.names.at(-1);
+		if (this.negated && this.config.default == null) this.config.default = true;
+		if (rawName.includes("<")) this.required = true;
+		else if (rawName.includes("[")) this.required = false;
+		else this.isBoolean = true;
+	}
+};
+let runtimeProcessArgs;
+let runtimeInfo;
+if (typeof process !== "undefined") {
+	let runtimeName;
+	if (typeof Deno !== "undefined" && typeof Deno.version?.deno === "string") runtimeName = "deno";
+	else if (typeof Bun !== "undefined" && typeof Bun.version === "string") runtimeName = "bun";
+	else runtimeName = "node";
+	runtimeInfo = `${process.platform}-${process.arch} ${runtimeName}-${process.version}`;
+	runtimeProcessArgs = process.argv;
+} else if (typeof navigator === "undefined") runtimeInfo = `unknown`;
+else runtimeInfo = `${navigator.platform} ${navigator.userAgent}`;
+var Command = class {
+	rawName;
+	description;
+	config;
+	cli;
+	options;
+	aliasNames;
+	name;
+	args;
+	commandAction;
+	usageText;
+	versionNumber;
+	examples;
+	helpCallback;
+	globalCommand;
+	constructor(rawName, description, config = {}, cli) {
+		this.rawName = rawName;
+		this.description = description;
+		this.config = config;
+		this.cli = cli;
+		this.options = [];
+		this.aliasNames = [];
+		this.name = removeBrackets(rawName);
+		this.args = findAllBrackets(rawName);
+		this.examples = [];
+	}
+	usage(text) {
+		this.usageText = text;
+		return this;
+	}
+	allowUnknownOptions() {
+		this.config.allowUnknownOptions = true;
+		return this;
+	}
+	ignoreOptionDefaultValue() {
+		this.config.ignoreOptionDefaultValue = true;
+		return this;
+	}
+	version(version, customFlags = "-v, --version") {
+		this.versionNumber = version;
+		this.option(customFlags, "Display version number");
+		return this;
+	}
+	example(example) {
+		this.examples.push(example);
+		return this;
+	}
+	/**
+	* Add a option for this command
+	* @param rawName Raw option name(s)
+	* @param description Option description
+	* @param config Option config
+	*/
+	option(rawName, description, config) {
+		const option = new Option(rawName, description, config);
+		this.options.push(option);
+		return this;
+	}
+	alias(name) {
+		this.aliasNames.push(name);
+		return this;
+	}
+	action(callback) {
+		this.commandAction = callback;
+		return this;
+	}
+	/**
+	* Check if a command name is matched by this command
+	* @param name Command name
+	*/
+	isMatched(name) {
+		return this.name === name || this.aliasNames.includes(name);
+	}
+	get isDefaultCommand() {
+		return this.name === "" || this.aliasNames.includes("!");
+	}
+	get isGlobalCommand() {
+		return this instanceof GlobalCommand;
+	}
+	/**
+	* Check if an option is registered in this command
+	* @param name Option name
+	*/
+	hasOption(name) {
+		name = name.split(".")[0];
+		return this.options.find((option) => {
+			return option.names.includes(name);
+		});
+	}
+	outputHelp() {
+		const { name, commands } = this.cli;
+		const { versionNumber, options: globalOptions, helpCallback } = this.cli.globalCommand;
+		let sections = [{ body: `${name}${versionNumber ? `/${versionNumber}` : ""}` }];
+		sections.push({
+			title: "Usage",
+			body: `  $ ${name} ${this.usageText || this.rawName}`
+		});
+		if ((this.isGlobalCommand || this.isDefaultCommand) && commands.length > 0) {
+			const longestCommandName = findLongest(commands.map((command) => command.rawName));
+			sections.push({
+				title: "Commands",
+				body: commands.map((command) => {
+					return `  ${padRight(command.rawName, longestCommandName.length)}  ${command.description}`;
+				}).join("\n")
+			}, {
+				title: `For more info, run any command with the \`--help\` flag`,
+				body: commands.map((command) => `  $ ${name}${command.name === "" ? "" : ` ${command.name}`} --help`).join("\n")
+			});
+		}
+		let options = this.isGlobalCommand ? globalOptions : [...this.options, ...globalOptions || []];
+		if (!this.isGlobalCommand && !this.isDefaultCommand) options = options.filter((option) => option.name !== "version");
+		if (options.length > 0) {
+			const longestOptionName = findLongest(options.map((option) => option.rawName));
+			sections.push({
+				title: "Options",
+				body: options.map((option) => {
+					return `  ${padRight(option.rawName, longestOptionName.length)}  ${option.description} ${option.config.default === void 0 ? "" : `(default: ${option.config.default})`}`;
+				}).join("\n")
+			});
+		}
+		if (this.examples.length > 0) sections.push({
+			title: "Examples",
+			body: this.examples.map((example) => {
+				if (typeof example === "function") return example(name);
+				return example;
+			}).join("\n")
+		});
+		if (helpCallback) sections = helpCallback(sections) || sections;
+		console.info(sections.map((section) => {
+			return section.title ? `${section.title}:\n${section.body}` : section.body;
+		}).join("\n\n"));
+	}
+	outputVersion() {
+		const { name } = this.cli;
+		const { versionNumber } = this.cli.globalCommand;
+		if (versionNumber) console.info(`${name}/${versionNumber} ${runtimeInfo}`);
+	}
+	checkRequiredArgs() {
+		const minimalArgsCount = this.args.filter((arg) => arg.required).length;
+		if (this.cli.args.length < minimalArgsCount) throw new CACError(`missing required args for command \`${this.rawName}\``);
+	}
+	/**
+	* Check if the parsed options contain any unknown options
+	*
+	* Exit and output error when true
+	*/
+	checkUnknownOptions() {
+		const { options, globalCommand } = this.cli;
+		if (!this.config.allowUnknownOptions) {
+			for (const name of Object.keys(options)) if (name !== "--" && !this.hasOption(name) && !globalCommand.hasOption(name)) throw new CACError(`Unknown option \`${name.length > 1 ? `--${name}` : `-${name}`}\``);
+		}
+	}
+	/**
+	* Check if the required string-type options exist
+	*/
+	checkOptionValue() {
+		const { options: parsedOptions, globalCommand } = this.cli;
+		const options = [...globalCommand.options, ...this.options];
+		for (const option of options) {
+			const value = parsedOptions[option.name.split(".")[0]];
+			if (option.required) {
+				const hasNegated = options.some((o) => o.negated && o.names.includes(option.name));
+				if (value === true || value === false && !hasNegated) throw new CACError(`option \`${option.rawName}\` value is missing`);
+			}
+		}
+	}
+	/**
+	* Check if the number of args is more than expected
+	*/
+	checkUnusedArgs() {
+		const maximumArgsCount = this.args.some((arg) => arg.variadic) ? Infinity : this.args.length;
+		if (maximumArgsCount < this.cli.args.length) throw new CACError(`Unused args: ${this.cli.args.slice(maximumArgsCount).map((arg) => `\`${arg}\``).join(", ")}`);
+	}
+};
+var GlobalCommand = class extends Command {
+	constructor(cli) {
+		super("@@global@@", "", {}, cli);
+	}
+};
+var CAC = class extends EventTarget {
+	/** The program name to display in help and version message */
+	name;
+	commands;
+	globalCommand;
+	matchedCommand;
+	matchedCommandName;
+	/**
+	* Raw CLI arguments
+	*/
+	rawArgs;
+	/**
+	* Parsed CLI arguments
+	*/
+	args;
+	/**
+	* Parsed CLI options, camelCased
+	*/
+	options;
+	showHelpOnExit;
+	showVersionOnExit;
+	/**
+	* @param name The program name to display in help and version message
+	*/
+	constructor(name = "") {
+		super();
+		this.name = name;
+		this.commands = [];
+		this.rawArgs = [];
+		this.args = [];
+		this.options = {};
+		this.globalCommand = new GlobalCommand(this);
+		this.globalCommand.usage("<command> [options]");
+	}
+	/**
+	* Add a global usage text.
+	*
+	* This is not used by sub-commands.
+	*/
+	usage(text) {
+		this.globalCommand.usage(text);
+		return this;
+	}
+	/**
+	* Add a sub-command
+	*/
+	command(rawName, description, config) {
+		const command = new Command(rawName, description || "", config, this);
+		command.globalCommand = this.globalCommand;
+		this.commands.push(command);
+		return command;
+	}
+	/**
+	* Add a global CLI option.
+	*
+	* Which is also applied to sub-commands.
+	*/
+	option(rawName, description, config) {
+		this.globalCommand.option(rawName, description, config);
+		return this;
+	}
+	/**
+	* Show help message when `-h, --help` flags appear.
+	*
+	*/
+	help(callback) {
+		this.globalCommand.option("-h, --help", "Display this message");
+		this.globalCommand.helpCallback = callback;
+		this.showHelpOnExit = true;
+		return this;
+	}
+	/**
+	* Show version number when `-v, --version` flags appear.
+	*
+	*/
+	version(version, customFlags = "-v, --version") {
+		this.globalCommand.version(version, customFlags);
+		this.showVersionOnExit = true;
+		return this;
+	}
+	/**
+	* Add a global example.
+	*
+	* This example added here will not be used by sub-commands.
+	*/
+	example(example) {
+		this.globalCommand.example(example);
+		return this;
+	}
+	/**
+	* Output the corresponding help message
+	* When a sub-command is matched, output the help message for the command
+	* Otherwise output the global one.
+	*
+	*/
+	outputHelp() {
+		if (this.matchedCommand) this.matchedCommand.outputHelp();
+		else this.globalCommand.outputHelp();
+	}
+	/**
+	* Output the version number.
+	*
+	*/
+	outputVersion() {
+		this.globalCommand.outputVersion();
+	}
+	setParsedInfo({ args, options }, matchedCommand, matchedCommandName) {
+		this.args = args;
+		this.options = options;
+		if (matchedCommand) this.matchedCommand = matchedCommand;
+		if (matchedCommandName) this.matchedCommandName = matchedCommandName;
+		return this;
+	}
+	unsetMatchedCommand() {
+		this.matchedCommand = void 0;
+		this.matchedCommandName = void 0;
+	}
+	/**
+	* Parse argv
+	*/
+	parse(argv, { run = true } = {}) {
+		if (!argv) {
+			if (!runtimeProcessArgs) throw new Error("No argv provided and runtime process argv is not available.");
+			argv = runtimeProcessArgs;
+		}
+		this.rawArgs = argv;
+		if (!this.name) this.name = argv[1] ? getFileName(argv[1]) : "cli";
+		let shouldParse = true;
+		for (const command of this.commands) {
+			const parsed = this.mri(argv.slice(2), command);
+			const commandName = parsed.args[0];
+			if (command.isMatched(commandName)) {
+				shouldParse = false;
+				const parsedInfo = {
+					...parsed,
+					args: parsed.args.slice(1)
+				};
+				this.setParsedInfo(parsedInfo, command, commandName);
+				this.dispatchEvent(new CustomEvent(`command:${commandName}`, { detail: command }));
+			}
+		}
+		if (shouldParse) {
+			for (const command of this.commands) if (command.isDefaultCommand) {
+				shouldParse = false;
+				const parsed = this.mri(argv.slice(2), command);
+				this.setParsedInfo(parsed, command);
+				this.dispatchEvent(new CustomEvent("command:!", { detail: command }));
+			}
+		}
+		if (shouldParse) {
+			const parsed = this.mri(argv.slice(2));
+			this.setParsedInfo(parsed);
+		}
+		if (this.options.help && this.showHelpOnExit) {
+			this.outputHelp();
+			run = false;
+			this.unsetMatchedCommand();
+		}
+		if (this.options.version && this.showVersionOnExit && this.matchedCommandName == null) {
+			this.outputVersion();
+			run = false;
+			this.unsetMatchedCommand();
+		}
+		const parsedArgv = {
+			args: this.args,
+			options: this.options
+		};
+		if (run) this.runMatchedCommand();
+		if (!this.matchedCommand && this.args[0]) this.dispatchEvent(new CustomEvent("command:*", { detail: this.args[0] }));
+		return parsedArgv;
+	}
+	mri(argv, command) {
+		const cliOptions = [...this.globalCommand.options, ...command ? command.options : []];
+		const mriOptions = getMriOptions(cliOptions);
+		let argsAfterDoubleDashes = [];
+		const doubleDashesIndex = argv.indexOf("--");
+		if (doubleDashesIndex !== -1) {
+			argsAfterDoubleDashes = argv.slice(doubleDashesIndex + 1);
+			argv = argv.slice(0, doubleDashesIndex);
+		}
+		let parsed = lib_default(argv, mriOptions);
+		parsed = Object.keys(parsed).reduce((res, name) => {
+			return {
+				...res,
+				[camelcaseOptionName(name)]: parsed[name]
+			};
+		}, { _: [] });
+		const args = parsed._;
+		const options = { "--": argsAfterDoubleDashes };
+		const ignoreDefault = command && command.config.ignoreOptionDefaultValue ? command.config.ignoreOptionDefaultValue : this.globalCommand.config.ignoreOptionDefaultValue;
+		const transforms = Object.create(null);
+		for (const cliOption of cliOptions) {
+			if (!ignoreDefault && cliOption.config.default !== void 0) for (const name of cliOption.names) options[name] = cliOption.config.default;
+			if (Array.isArray(cliOption.config.type) && transforms[cliOption.name] === void 0) {
+				transforms[cliOption.name] = Object.create(null);
+				transforms[cliOption.name].shouldTransform = true;
+				transforms[cliOption.name].transformFunction = cliOption.config.type[0];
+			}
+		}
+		for (const key of Object.keys(parsed)) if (key !== "_") {
+			setDotProp(options, key.split("."), parsed[key]);
+			setByType(options, transforms);
+		}
+		return {
+			args,
+			options
+		};
+	}
+	runMatchedCommand() {
+		const { args, options, matchedCommand: command } = this;
+		if (!command || !command.commandAction) return;
+		command.checkUnknownOptions();
+		command.checkOptionValue();
+		command.checkRequiredArgs();
+		command.checkUnusedArgs();
+		const actionArgs = [];
+		command.args.forEach((arg, index) => {
+			if (arg.variadic) actionArgs.push(args.slice(index));
+			else actionArgs.push(args[index]);
+		});
+		actionArgs.push(options);
+		return command.commandAction.apply(this, actionArgs);
+	}
+};
+/**
+* @param name The program name to display in help and version message
+*/
+const cac = (name = "") => new CAC(name);
+
+//#endregion
+//#region package.json
+var version = "1.4.0";
+
+//#endregion
+//#region ../node_modules/.pnpm/is-network-error@1.3.0/node_modules/is-network-error/index.js
+const objectToString = Object.prototype.toString;
+const isError = (value) => objectToString.call(value) === "[object Error]";
+const errorMessages = new Set([
+	"network error",
+	"Failed to fetch",
+	"NetworkError when attempting to fetch resource.",
+	"The Internet connection appears to be offline.",
+	"Network request failed",
+	"fetch failed",
+	"terminated",
+	" A network error occurred.",
+	"Network connection lost"
+]);
+function isNetworkError(error) {
+	if (!(error && isError(error) && error.name === "TypeError" && typeof error.message === "string")) return false;
+	const { message, stack } = error;
+	if (message === "Load failed") return stack === void 0 || "__sentry_captured__" in error;
+	if (message.startsWith("error sending request for url")) return true;
+	return errorMessages.has(message);
+}
+
+//#endregion
+//#region ../node_modules/.pnpm/p-retry@7.1.1/node_modules/p-retry/index.js
+function validateRetries(retries) {
+	if (typeof retries === "number") {
+		if (retries < 0) throw new TypeError("Expected `retries` to be a non-negative number.");
+		if (Number.isNaN(retries)) throw new TypeError("Expected `retries` to be a valid number or Infinity, got NaN.");
+	} else if (retries !== void 0) throw new TypeError("Expected `retries` to be a number or Infinity.");
+}
+function validateNumberOption(name, value, { min = 0, allowInfinity = false } = {}) {
+	if (value === void 0) return;
+	if (typeof value !== "number" || Number.isNaN(value)) throw new TypeError(`Expected \`${name}\` to be a number${allowInfinity ? " or Infinity" : ""}.`);
+	if (!allowInfinity && !Number.isFinite(value)) throw new TypeError(`Expected \`${name}\` to be a finite number.`);
+	if (value < min) throw new TypeError(`Expected \`${name}\` to be \u2265 ${min}.`);
+}
+var AbortError = class extends Error {
+	constructor(message) {
+		super();
+		if (message instanceof Error) {
+			this.originalError = message;
+			({message} = message);
+		} else {
+			this.originalError = new Error(message);
+			this.originalError.stack = this.stack;
+		}
+		this.name = "AbortError";
+		this.message = message;
+	}
+};
+function calculateDelay(retriesConsumed, options) {
+	const attempt = Math.max(1, retriesConsumed + 1);
+	const random = options.randomize ? Math.random() + 1 : 1;
+	let timeout = Math.round(random * options.minTimeout * options.factor ** (attempt - 1));
+	timeout = Math.min(timeout, options.maxTimeout);
+	return timeout;
+}
+function calculateRemainingTime(start, max) {
+	if (!Number.isFinite(max)) return max;
+	return max - (performance.now() - start);
+}
+async function onAttemptFailure({ error, attemptNumber, retriesConsumed, startTime, options }) {
+	const normalizedError = error instanceof Error ? error : /* @__PURE__ */ new TypeError(`Non-error was thrown: "${error}". You should only throw errors.`);
+	if (normalizedError instanceof AbortError) throw normalizedError.originalError;
+	const retriesLeft = Number.isFinite(options.retries) ? Math.max(0, options.retries - retriesConsumed) : options.retries;
+	const maxRetryTime = options.maxRetryTime ?? Number.POSITIVE_INFINITY;
+	const context = Object.freeze({
+		error: normalizedError,
+		attemptNumber,
+		retriesLeft,
+		retriesConsumed
+	});
+	await options.onFailedAttempt(context);
+	if (calculateRemainingTime(startTime, maxRetryTime) <= 0) throw normalizedError;
+	const consumeRetry = await options.shouldConsumeRetry(context);
+	const remainingTime = calculateRemainingTime(startTime, maxRetryTime);
+	if (remainingTime <= 0 || retriesLeft <= 0) throw normalizedError;
+	if (normalizedError instanceof TypeError && !isNetworkError(normalizedError)) {
+		if (consumeRetry) throw normalizedError;
+		options.signal?.throwIfAborted();
+		return false;
+	}
+	if (!await options.shouldRetry(context)) throw normalizedError;
+	if (!consumeRetry) {
+		options.signal?.throwIfAborted();
+		return false;
+	}
+	const delayTime = calculateDelay(retriesConsumed, options);
+	const finalDelay = Math.min(delayTime, remainingTime);
+	options.signal?.throwIfAborted();
+	if (finalDelay > 0) await new Promise((resolve, reject) => {
+		const onAbort = () => {
+			clearTimeout(timeoutToken);
+			options.signal?.removeEventListener("abort", onAbort);
+			reject(options.signal.reason);
+		};
+		const timeoutToken = setTimeout(() => {
+			options.signal?.removeEventListener("abort", onAbort);
+			resolve();
+		}, finalDelay);
+		if (options.unref) timeoutToken.unref?.();
+		options.signal?.addEventListener("abort", onAbort, { once: true });
+	});
+	options.signal?.throwIfAborted();
+	return true;
+}
+async function pRetry(input, options = {}) {
+	options = { ...options };
+	validateRetries(options.retries);
+	if (Object.hasOwn(options, "forever")) throw new Error("The `forever` option is no longer supported. For many use-cases, you can set `retries: Infinity` instead.");
+	options.retries ??= 10;
+	options.factor ??= 2;
+	options.minTimeout ??= 1e3;
+	options.maxTimeout ??= Number.POSITIVE_INFINITY;
+	options.maxRetryTime ??= Number.POSITIVE_INFINITY;
+	options.randomize ??= false;
+	options.onFailedAttempt ??= () => {};
+	options.shouldRetry ??= () => true;
+	options.shouldConsumeRetry ??= () => true;
+	validateNumberOption("factor", options.factor, {
+		min: 0,
+		allowInfinity: false
+	});
+	validateNumberOption("minTimeout", options.minTimeout, {
+		min: 0,
+		allowInfinity: false
+	});
+	validateNumberOption("maxTimeout", options.maxTimeout, {
+		min: 0,
+		allowInfinity: true
+	});
+	validateNumberOption("maxRetryTime", options.maxRetryTime, {
+		min: 0,
+		allowInfinity: true
+	});
+	if (!(options.factor > 0)) options.factor = 1;
+	options.signal?.throwIfAborted();
+	let attemptNumber = 0;
+	let retriesConsumed = 0;
+	const startTime = performance.now();
+	while (Number.isFinite(options.retries) ? retriesConsumed <= options.retries : true) {
+		attemptNumber++;
+		try {
+			options.signal?.throwIfAborted();
+			const result = await input(attemptNumber);
+			options.signal?.throwIfAborted();
+			return result;
+		} catch (error) {
+			if (await onAttemptFailure({
+				error,
+				attemptNumber,
+				retriesConsumed,
+				startTime,
+				options
+			})) retriesConsumed++;
+		}
+	}
+	throw new Error("Retry attempts exhausted without throwing an error.");
+}
+
+//#endregion
+//#region src/api.ts
+const defaultRetryOptions = {
+	retries: 5,
+	factor: 2,
+	minTimeout: 1e3,
+	maxTimeout: Infinity,
+	randomize: false
+};
+const defaultOptions = { apiEndpoint: "https://npm.antfu.dev/" };
+async function getLatestVersionBatch(packages, options = {}) {
+	const { apiEndpoint = defaultOptions.apiEndpoint, fetch: fetchApi = fetch, throw: throwError = true, retry = defaultRetryOptions } = options;
+	let query = [
+		options.force ? "force=true" : "",
+		options.metadata ? "metadata=true" : "",
+		throwError ? "" : "throw=false"
+	].filter(Boolean).join("&");
+	if (query) query = `?${query}`;
+	const fetchFn = () => fetchApi(new URL(packages.join("+") + query, apiEndpoint)).then((r) => r.json());
+	const retryOptions = typeof retry === "number" ? {
+		...defaultRetryOptions,
+		retries: retry
+	} : retry;
+	const list = toArray(await (retryOptions === false ? fetchFn() : pRetry(fetchFn, retryOptions)));
+	return throwError ? throwErrorObject(list) : list;
+}
+async function getVersionsBatch(packages, options = {}) {
+	const { apiEndpoint = defaultOptions.apiEndpoint, fetch: fetchApi = fetch, throw: throwError = true, retry = defaultRetryOptions } = options;
+	let query = [
+		options.force ? "force=true" : "",
+		options.loose ? "loose=true" : "",
+		options.metadata ? "metadata=true" : "",
+		options.after ? `after=${encodeURIComponent(options.after)}` : "",
+		throwError ? "" : "throw=false"
+	].filter(Boolean).join("&");
+	if (query) query = `?${query}`;
+	const fetchFn = () => fetchApi(new URL(`/versions/${packages.join("+")}${query}`, apiEndpoint)).then((r) => r.json());
+	const list = toArray(await (retry === false ? fetchFn() : pRetry(fetchFn, typeof retry === "number" ? {
+		...defaultRetryOptions,
+		retries: retry
+	} : retry)));
+	return throwError ? throwErrorObject(list) : list;
+}
+function throwErrorObject(data) {
+	for (const item of toArray(data)) if (item && "error" in item) throw new Error(item.message || item.error);
+	return data;
+}
+function toArray(data) {
+	if (Array.isArray(data)) return data;
+	return [data];
+}
+
+//#endregion
+//#region src/cli.ts
+const cli = cac("fast-npm-meta");
+cli.command("version <...pkgs>", "Get the latest version of one or more packages").option("--json", "Output as JSON").option("--force", "Bypass cache and get the latest data").option("--metadata", "Include version metadata (engines, deprecated, etc.)").option("--api-endpoint <url>", "API endpoint URL").action(async (pkgs, options) => {
+	try {
+		const results = await getLatestVersionBatch(pkgs, {
+			force: options.force,
+			metadata: options.metadata,
+			apiEndpoint: options.apiEndpoint
+		});
+		if (options.json) {
+			const output = results.length === 1 ? results[0] : results;
+			console.log(JSON.stringify(output, null, 2));
+		} else for (const result of results) console.log(result.version);
+	} catch (e) {
+		console.error(e.message);
+		process$1.exit(1);
+	}
+});
+cli.command("full <...pkgs>", "Get full package metadata (versions list, dist-tags, etc.)").option("--force", "Bypass cache and get the latest data").option("--loose", "Include all versions that are newer than the specified version").option("--metadata", "Include per-version metadata (time, engines, deprecated, etc.)").option("--after <date>", "Only return versions published after this ISO date-time").option("--api-endpoint <url>", "API endpoint URL").action(async (pkgs, options) => {
+	try {
+		const results = await getVersionsBatch(pkgs, {
+			force: options.force,
+			loose: options.loose,
+			metadata: options.metadata,
+			after: options.after,
+			apiEndpoint: options.apiEndpoint
+		});
+		const output = results.length === 1 ? results[0] : results;
+		console.log(JSON.stringify(output, null, 2));
+	} catch (e) {
+		console.error(e.message);
+		process$1.exit(1);
+	}
+});
+cli.help();
+cli.version(version);
+cli.parse();
+
+//#endregion
+export {  };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fast-npm-meta",
   "type": "module",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "Get npm package metadata",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -19,12 +19,17 @@
     "./package.json": "./package.json"
   },
   "types": "./dist/index.d.mts",
+  "bin": {
+    "fast-npm-meta": "./dist/cli.mjs"
+  },
   "files": [
-    "dist"
+    "dist",
+    "skills"
   ],
   "devDependencies": {
+    "cac": "^7.0.0",
     "p-retry": "^7.1.1",
-    "tsdown": "^0.20.1"
+    "tsdown": "^0.20.3"
   },
   "scripts": {
     "build": "tsdown",

package/skills/fast-npm-meta/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: fast-npm-meta
+description: Get npm package metadata
+license: MIT
+---
+
+# fast-npm-meta CLI
+
+When querying npm package versions or metadata, **prefer `fast-npm-meta` over `npm view`**.
+
+`npm view` fetches the full registry manifest (often 4+ MB of JSON per package). `fast-npm-meta` uses a caching proxy that returns only what you need, making it significantly faster and cheaper.
+
+## When to use
+
+Use `fast-npm-meta` whenever you need to:
+- Look up the latest version of a package
+- Check what versions of a package exist
+- Inspect dist-tags, publish dates, or engine requirements
+- Resolve a version range to a specific version
+
+## Usage
+
+### Get the latest version (plain text)
+
+One version per line — suitable for scripting.
+
+```sh
+fast-npm-meta version vite
+# 7.3.1
+fast-npm-meta version vite@8
+# 8.0.0
+fast-npm-meta version "nuxt@^3.5"
+# 3.5.22
+
+fast-npm-meta version vite nuxt vue
+# 7.3.1
+# 4.3.1
+# 3.5.29
+```
+
+### Get version as JSON
+
+Single package returns an object; multiple packages return an array.
+
+```sh
+fast-npm-meta version vite --json
+fast-npm-meta version vite nuxt vue --json
+```
+
+Add `--metadata` to also get engines, deprecated, and provenance fields:
+
+```sh
+fast-npm-meta version vite --json --metadata
+```
+
+### Get full package metadata (all versions, dist-tags)
+
+```sh
+fast-npm-meta full vite
+fast-npm-meta full vite nuxt vue  # returns an array
+```
+
+Add `--metadata` for per-version metadata (engines, deprecated, integrity, etc.):
+
+```sh
+fast-npm-meta full vite --metadata
+```
+
+Filter to versions published after a date:
+
+```sh
+fast-npm-meta full vite --after 2025-01-01T00:00:00Z
+```
+
+## Do NOT use these instead
+
+| Avoid | Use instead |
+|-------|-------------|
+| `npm view vite version` | `fast-npm-meta version vite` |
+| `npm view vite versions --json` | `fast-npm-meta full vite` |
+| `npm view vite dist-tags --json` | `fast-npm-meta full vite` |
+
+## Flags reference
+
+| Flag | Commands | Description |
+|------|----------|-------------|
+| `--json` | `version` | Output as JSON instead of plain text |
+| `--force` | both | Bypass cache, fetch fresh data |
+| `--metadata` | both | Include per-version metadata |
+| `--loose` | `full` | Include all versions newer than the specifier |
+| `--after <date>` | `full` | Only versions published after this ISO date |
+| `--api-endpoint <url>` | both | Custom API endpoint |