@agntn/registries 0.2.0

package/dist/commands/info.d.mts

@@ -0,0 +1,26 @@
+import { i as Package } from "../_chunks/types.mjs";
+import { t as Registry } from "../_chunks/registry.mjs";
+import * as citty from "citty";
+
+//#region src/commands/info.d.ts
+declare function outputPackageInfo(pkg: Package, name: string, reg: Registry): void;
+declare const _default: citty.CommandDef<{
+  readonly purl: {
+    readonly type: "positional";
+    readonly description: "Package PURL (e.g. pkg:npm/lodash, cargo/serde@1.0)";
+    readonly required: true;
+  };
+  readonly json: {
+    readonly type: "boolean";
+    readonly description: "Output as JSON";
+    readonly default: false;
+  };
+  readonly "no-cache": {
+    readonly type: "boolean";
+    readonly description: "Bypass cache, fetch fresh data";
+    readonly default: false;
+  };
+}>;
+//#endregion
+export { _default as default, outputPackageInfo };
+//# sourceMappingURL=info.d.mts.map

package/dist/commands/info.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.mts","names":[],"sources":["../../src/commands/info.ts"],"mappings":";;;;;iBAOgB,iBAAA,CAAkB,GAAA,EAAK,OAAA,EAAS,IAAA,UAAc,GAAA,EAAK,QAAA;AAAA,cA8BlE,QAAA"}

package/dist/commands/info.mjs

@@ -0,0 +1,54 @@
+import "../_chunks/registry.mjs";
+import "../_chunks/purl.mjs";
+import "../_chunks/registries.mjs";
+import { o as resolveDocsUrl } from "../_chunks/helpers.mjs";
+import { resolvePURL, sharedArgs, withErrorHandling } from "./shared.mjs";
+import { defineCommand } from "citty";
+import consola from "consola";
+function outputPackageInfo(pkg, name, reg) {
+	const urls = reg.urls();
+	const registryUrl = urls.registry(name);
+	const docsUrl = resolveDocsUrl(pkg, urls, pkg.latestVersion || void 0);
+	const showDocs = Boolean(docsUrl) && docsUrl !== pkg.homepage && docsUrl !== pkg.repository && docsUrl !== registryUrl;
+	consola.log("");
+	consola.log(`  \x1b[1m\x1b[36m${pkg.name}\x1b[0m${pkg.latestVersion ? `\x1b[90m@${pkg.latestVersion}\x1b[0m` : ""}`);
+	if (pkg.description) consola.log(`  ${pkg.description}`);
+	consola.log("");
+	if (pkg.licenses) consola.log(`  \x1b[90mLicense:\x1b[0m    ${pkg.licenses}`);
+	if (pkg.repository) consola.log(`  \x1b[90mRepository:\x1b[0m ${pkg.repository}`);
+	if (pkg.homepage) consola.log(`  \x1b[90mHomepage:\x1b[0m   ${pkg.homepage}`);
+	if (showDocs) consola.log(`  \x1b[90mDocs:\x1b[0m       ${docsUrl}`);
+	consola.log(`  \x1b[90mRegistry:\x1b[0m   ${registryUrl}`);
+	if (pkg.keywords.length > 0) consola.log(`  \x1b[90mKeywords:\x1b[0m   ${pkg.keywords.join(", ")}`);
+	if (pkg.namespace) consola.log(`  \x1b[90mNamespace:\x1b[0m  ${pkg.namespace}`);
+	consola.log(`  \x1b[90mEcosystem:\x1b[0m  ${reg.ecosystem()}`);
+	consola.log("");
+}
+var info_default = defineCommand({
+	meta: {
+		name: "info",
+		description: "Show package metadata"
+	},
+	args: {
+		...sharedArgs,
+		purl: {
+			type: "positional",
+			description: "Package PURL (e.g. pkg:npm/lodash, cargo/serde@1.0)",
+			required: true
+		}
+	},
+	async run({ args }) {
+		await withErrorHandling(async () => {
+			const [reg, name] = resolvePURL(args.purl, !args["no-cache"]);
+			const pkg = await reg.fetchPackage(name);
+			if (args.json) {
+				console.log(JSON.stringify(pkg, null, 2));
+				return;
+			}
+			outputPackageInfo(pkg, name, reg);
+		});
+	}
+});
+export { info_default as default, outputPackageInfo };
+
+//# sourceMappingURL=info.mjs.map

package/dist/commands/info.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.mjs","names":[],"sources":["../../src/commands/info.ts"],"sourcesContent":["import type { Package } from \"../core/types.ts\";\nimport type { Registry } from \"../core/registry.ts\";\nimport { defineCommand } from \"citty\";\nimport consola from \"consola\";\nimport { resolveDocsUrl } from \"../helpers.ts\";\nimport { sharedArgs, resolvePURL, withErrorHandling } from \"./shared.ts\";\n\nexport function outputPackageInfo(pkg: Package, name: string, reg: Registry): void {\n  const urls = reg.urls();\n  const registryUrl = urls.registry(name);\n  const docsUrl = resolveDocsUrl(pkg, urls, pkg.latestVersion || undefined);\n  const showDocs =\n    Boolean(docsUrl) &&\n    docsUrl !== pkg.homepage &&\n    docsUrl !== pkg.repository &&\n    docsUrl !== registryUrl;\n\n  consola.log(\"\");\n  consola.log(\n    `  \\x1b[1m\\x1b[36m${pkg.name}\\x1b[0m${pkg.latestVersion ? `\\x1b[90m@${pkg.latestVersion}\\x1b[0m` : \"\"}`,\n  );\n  if (pkg.description) {\n    consola.log(`  ${pkg.description}`);\n  }\n  consola.log(\"\");\n\n  if (pkg.licenses) consola.log(`  \\x1b[90mLicense:\\x1b[0m    ${pkg.licenses}`);\n  if (pkg.repository) consola.log(`  \\x1b[90mRepository:\\x1b[0m ${pkg.repository}`);\n  if (pkg.homepage) consola.log(`  \\x1b[90mHomepage:\\x1b[0m   ${pkg.homepage}`);\n  if (showDocs) consola.log(`  \\x1b[90mDocs:\\x1b[0m       ${docsUrl}`);\n  consola.log(`  \\x1b[90mRegistry:\\x1b[0m   ${registryUrl}`);\n  if (pkg.keywords.length > 0) {\n    consola.log(`  \\x1b[90mKeywords:\\x1b[0m   ${pkg.keywords.join(\", \")}`);\n  }\n  if (pkg.namespace) consola.log(`  \\x1b[90mNamespace:\\x1b[0m  ${pkg.namespace}`);\n  consola.log(`  \\x1b[90mEcosystem:\\x1b[0m  ${reg.ecosystem()}`);\n  consola.log(\"\");\n}\n\nexport default defineCommand({\n  meta: {\n    name: \"info\",\n    description: \"Show package metadata\",\n  },\n  args: {\n    ...sharedArgs,\n    purl: {\n      type: \"positional\",\n      description: \"Package PURL (e.g. pkg:npm/lodash, cargo/serde@1.0)\",\n      required: true,\n    },\n  },\n  async run({ args }) {\n    await withErrorHandling(async () => {\n      const [reg, name] = resolvePURL(args.purl, !args[\"no-cache\"]);\n      const pkg = await reg.fetchPackage(name);\n\n      if (args.json) {\n        console.log(JSON.stringify(pkg, null, 2));\n        return;\n      }\n\n      outputPackageInfo(pkg, name, reg);\n    });\n  },\n});\n"],"mappings":";;;;;;;AAOA,SAAgB,kBAAkB,KAAc,MAAc,KAAqB;CACjF,MAAM,OAAO,IAAI,MAAM;CACvB,MAAM,cAAc,KAAK,SAAS,KAAK;CACvC,MAAM,UAAU,eAAe,KAAK,MAAM,IAAI,iBAAiB,KAAA,EAAU;CACzE,MAAM,WACJ,QAAQ,QAAQ,IAChB,YAAY,IAAI,YAChB,YAAY,IAAI,cAChB,YAAY;AAEd,SAAQ,IAAI,GAAG;AACf,SAAQ,IACN,oBAAoB,IAAI,KAAK,SAAS,IAAI,gBAAgB,YAAY,IAAI,cAAc,WAAW,KACpG;AACD,KAAI,IAAI,YACN,SAAQ,IAAI,KAAK,IAAI,cAAc;AAErC,SAAQ,IAAI,GAAG;AAEf,KAAI,IAAI,SAAU,SAAQ,IAAI,gCAAgC,IAAI,WAAW;AAC7E,KAAI,IAAI,WAAY,SAAQ,IAAI,gCAAgC,IAAI,aAAa;AACjF,KAAI,IAAI,SAAU,SAAQ,IAAI,gCAAgC,IAAI,WAAW;AAC7E,KAAI,SAAU,SAAQ,IAAI,gCAAgC,UAAU;AACpE,SAAQ,IAAI,gCAAgC,cAAc;AAC1D,KAAI,IAAI,SAAS,SAAS,EACxB,SAAQ,IAAI,gCAAgC,IAAI,SAAS,KAAK,KAAK,GAAG;AAExE,KAAI,IAAI,UAAW,SAAQ,IAAI,gCAAgC,IAAI,YAAY;AAC/E,SAAQ,IAAI,gCAAgC,IAAI,WAAW,GAAG;AAC9D,SAAQ,IAAI,GAAG;;AAGjB,IAAA,eAAe,cAAc;CAC3B,MAAM;EACJ,MAAM;EACN,aAAa;EACd;CACD,MAAM;EACJ,GAAG;EACH,MAAM;GACJ,MAAM;GACN,aAAa;GACb,UAAU;;EAEb;CACD,MAAM,IAAI,EAAE,QAAQ;AAClB,QAAM,kBAAkB,YAAY;GAClC,MAAM,CAAC,KAAK,QAAQ,YAAY,KAAK,MAAM,CAAC,KAAK,YAAY;GAC7D,MAAM,MAAM,MAAM,IAAI,aAAa,KAAK;AAExC,OAAI,KAAK,MAAM;AACb,YAAQ,IAAI,KAAK,UAAU,KAAK,MAAM,EAAE,CAAC;AACzC;;AAGF,qBAAkB,KAAK,MAAM,IAAI;IACjC;;CAEL,CAAC"}

package/dist/commands/maintainers.d.mts

@@ -0,0 +1,23 @@
+import * as citty from "citty";
+
+//#region src/commands/maintainers.d.ts
+declare const _default: citty.CommandDef<{
+  readonly purl: {
+    readonly type: "positional";
+    readonly description: "Package PURL (e.g. pkg:npm/lodash, gem/rails)";
+    readonly required: true;
+  };
+  readonly json: {
+    readonly type: "boolean";
+    readonly description: "Output as JSON";
+    readonly default: false;
+  };
+  readonly "no-cache": {
+    readonly type: "boolean";
+    readonly description: "Bypass cache, fetch fresh data";
+    readonly default: false;
+  };
+}>;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=maintainers.d.mts.map

package/dist/commands/maintainers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintainers.d.mts","names":[],"sources":["../../src/commands/maintainers.ts"],"mappings":""}

package/dist/commands/maintainers.mjs

@@ -0,0 +1,46 @@
+import "../_chunks/registry.mjs";
+import "../_chunks/purl.mjs";
+import "../_chunks/registries.mjs";
+import { resolvePURL, sharedArgs, withErrorHandling } from "./shared.mjs";
+import { defineCommand } from "citty";
+import consola from "consola";
+var maintainers_default = defineCommand({
+	meta: {
+		name: "maintainers",
+		description: "List package maintainers"
+	},
+	args: {
+		...sharedArgs,
+		purl: {
+			type: "positional",
+			description: "Package PURL (e.g. pkg:npm/lodash, gem/rails)",
+			required: true
+		}
+	},
+	async run({ args }) {
+		await withErrorHandling(async () => {
+			const [reg, name] = resolvePURL(args.purl, !args["no-cache"]);
+			const maintainers = await reg.fetchMaintainers(name);
+			if (args.json) {
+				console.log(JSON.stringify(maintainers, null, 2));
+				return;
+			}
+			consola.log("");
+			consola.log(`  \x1b[1m${name}\x1b[0m — ${maintainers.length} maintainer${maintainers.length === 1 ? "" : "s"}`);
+			consola.log("");
+			for (const m of maintainers) {
+				const nameStr = m.name || m.login || "unknown";
+				const parts = [nameStr];
+				if (m.login && m.login !== nameStr) parts.push(`\x1b[90m(${m.login})\x1b[0m`);
+				if (m.email) parts.push(`\x1b[90m<${m.email}>\x1b[0m`);
+				if (m.role) parts.push(`\x1b[36m[${m.role}]\x1b[0m`);
+				consola.log(`  ${parts.join(" ")}`);
+				if (m.url) consola.log(`    \x1b[90m${m.url}\x1b[0m`);
+			}
+			consola.log("");
+		});
+	}
+});
+export { maintainers_default as default };
+
+//# sourceMappingURL=maintainers.mjs.map

package/dist/commands/maintainers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintainers.mjs","names":[],"sources":["../../src/commands/maintainers.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport consola from \"consola\";\nimport { sharedArgs, resolvePURL, withErrorHandling } from \"./shared.ts\";\n\nexport default defineCommand({\n  meta: {\n    name: \"maintainers\",\n    description: \"List package maintainers\",\n  },\n  args: {\n    ...sharedArgs,\n    purl: {\n      type: \"positional\",\n      description: \"Package PURL (e.g. pkg:npm/lodash, gem/rails)\",\n      required: true,\n    },\n  },\n  async run({ args }) {\n    await withErrorHandling(async () => {\n      const [reg, name] = resolvePURL(args.purl, !args[\"no-cache\"]);\n      const maintainers = await reg.fetchMaintainers(name);\n\n      if (args.json) {\n        console.log(JSON.stringify(maintainers, null, 2));\n        return;\n      }\n\n      consola.log(\"\");\n      consola.log(\n        `  \\x1b[1m${name}\\x1b[0m — ${maintainers.length} maintainer${maintainers.length === 1 ? \"\" : \"s\"}`,\n      );\n      consola.log(\"\");\n\n      for (const m of maintainers) {\n        const nameStr = m.name || m.login || \"unknown\";\n        const parts: string[] = [nameStr];\n        if (m.login && m.login !== nameStr) parts.push(`\\x1b[90m(${m.login})\\x1b[0m`);\n        if (m.email) parts.push(`\\x1b[90m<${m.email}>\\x1b[0m`);\n        if (m.role) parts.push(`\\x1b[36m[${m.role}]\\x1b[0m`);\n        consola.log(`  ${parts.join(\" \")}`);\n        if (m.url) consola.log(`    \\x1b[90m${m.url}\\x1b[0m`);\n      }\n      consola.log(\"\");\n    });\n  },\n});\n"],"mappings":";;;;;;AAIA,IAAA,sBAAe,cAAc;CAC3B,MAAM;EACJ,MAAM;EACN,aAAa;EACd;CACD,MAAM;EACJ,GAAG;EACH,MAAM;GACJ,MAAM;GACN,aAAa;GACb,UAAU;;EAEb;CACD,MAAM,IAAI,EAAE,QAAQ;AAClB,QAAM,kBAAkB,YAAY;GAClC,MAAM,CAAC,KAAK,QAAQ,YAAY,KAAK,MAAM,CAAC,KAAK,YAAY;GAC7D,MAAM,cAAc,MAAM,IAAI,iBAAiB,KAAK;AAEpD,OAAI,KAAK,MAAM;AACb,YAAQ,IAAI,KAAK,UAAU,aAAa,MAAM,EAAE,CAAC;AACjD;;AAGF,WAAQ,IAAI,GAAG;AACf,WAAQ,IACN,YAAY,KAAK,YAAY,YAAY,OAAO,aAAa,YAAY,WAAW,IAAI,KAAK,MAC9F;AACD,WAAQ,IAAI,GAAG;AAEf,QAAK,MAAM,KAAK,aAAa;IAC3B,MAAM,UAAU,EAAE,QAAQ,EAAE,SAAS;IACrC,MAAM,QAAkB,CAAC,QAAQ;AACjC,QAAI,EAAE,SAAS,EAAE,UAAU,QAAS,OAAM,KAAK,YAAY,EAAE,MAAM,UAAU;AAC7E,QAAI,EAAE,MAAO,OAAM,KAAK,YAAY,EAAE,MAAM,UAAU;AACtD,QAAI,EAAE,KAAM,OAAM,KAAK,YAAY,EAAE,KAAK,UAAU;AACpD,YAAQ,IAAI,KAAK,MAAM,KAAK,IAAI,GAAG;AACnC,QAAI,EAAE,IAAK,SAAQ,IAAI,eAAe,EAAE,IAAI,SAAS;;AAEvD,WAAQ,IAAI,GAAG;IACf;;CAEL,CAAC"}

package/dist/commands/shared.d.mts

@@ -0,0 +1,27 @@
+import "../_chunks/types.mjs";
+import { t as Registry } from "../_chunks/registry.mjs";
+import "../_chunks/index.mjs";
+
+//#region src/commands/shared.d.ts
+declare const sharedArgs: {
+  readonly json: {
+    readonly type: "boolean";
+    readonly description: "Output as JSON";
+    readonly default: false;
+  };
+  readonly "no-cache": {
+    readonly type: "boolean";
+    readonly description: "Bypass cache, fetch fresh data";
+    readonly default: false;
+  };
+};
+/**
+ * Resolve a PURL string or shorthand into [registry, name, version].
+ * Uses CachedRegistry unless --no-cache is set.
+ */
+declare function resolvePURL(input: string, useCache?: boolean): [Registry, string, string];
+/** Run a command with standard error handling. */
+declare function withErrorHandling(fn: () => Promise<void>): Promise<void>;
+//#endregion
+export { resolvePURL, sharedArgs, withErrorHandling };
+//# sourceMappingURL=shared.d.mts.map

package/dist/commands/shared.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.mts","names":[],"sources":["../../src/commands/shared.ts"],"mappings":";;;;;cAaa,UAAA;EAAA;;;;;;;;;;;;;;;iBAiBG,WAAA,CAAY,KAAA,UAAe,QAAA,cAAmB,QAAA;AAA9D;AAAA,iBAkBsB,iBAAA,CAAkB,EAAA,QAAU,OAAA,SAAgB,OAAA"}

package/dist/commands/shared.mjs

@@ -0,0 +1,69 @@
+import { c as HTTPError, f as RateLimitError, l as InvalidPURLError, n as create, p as UnknownEcosystemError, r as ecosystems, u as NotFoundError } from "../_chunks/registry.mjs";
+import { i as parsePURL, n as createFromPURL, r as fullName } from "../_chunks/purl.mjs";
+import "../_chunks/registries.mjs";
+import { CachedRegistry } from "../cache/cached-registry.mjs";
+import consola from "consola";
+const sharedArgs = {
+	json: {
+		type: "boolean",
+		description: "Output as JSON",
+		default: false
+	},
+	"no-cache": {
+		type: "boolean",
+		description: "Bypass cache, fetch fresh data",
+		default: false
+	}
+};
+/**
+* Resolve a PURL string or shorthand into [registry, name, version].
+* Uses CachedRegistry unless --no-cache is set.
+*/
+function resolvePURL(input, useCache = true) {
+	let purl = input;
+	if (!purl.startsWith("pkg:")) purl = `pkg:${purl}`;
+	if (useCache) {
+		const parsed = parsePURL(purl);
+		const baseURL = parsed.qualifiers["repository_url"] ?? "";
+		return [
+			new CachedRegistry(create(parsed.type, baseURL || void 0)),
+			fullName(parsed),
+			parsed.version
+		];
+	}
+	return createFromPURL(purl);
+}
+/** Run a command with standard error handling. */
+async function withErrorHandling(fn) {
+	try {
+		await fn();
+	} catch (error) {
+		if (error instanceof NotFoundError) {
+			consola.error(`Package not found: ${error.ecosystem}/${error.packageName}${error.version ? `@${error.version}` : ""}`);
+			return process.exit(1);
+		}
+		if (error instanceof UnknownEcosystemError) {
+			consola.error(`Unknown ecosystem: ${error.ecosystem}`);
+			consola.info(`Supported: ${ecosystems().join(", ")}`);
+			return process.exit(1);
+		}
+		if (error instanceof InvalidPURLError) {
+			consola.error(`Invalid PURL: ${error.purl}`);
+			consola.info("Examples: pkg:npm/lodash, npm/lodash@4.17.21, pkg:cargo/serde");
+			return process.exit(1);
+		}
+		if (error instanceof RateLimitError) {
+			consola.error(`Rate limited by registry. Retry after ${error.retryAfter}s`);
+			return process.exit(1);
+		}
+		if (error instanceof HTTPError) {
+			consola.error(`Registry request failed: HTTP ${error.statusCode} (${error.url})`);
+			if (error.isServerError()) consola.info("The registry may be temporarily unavailable. Try again later.");
+			return process.exit(1);
+		}
+		throw error;
+	}
+}
+export { resolvePURL, sharedArgs, withErrorHandling };
+
+//# sourceMappingURL=shared.mjs.map

package/dist/commands/shared.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.mjs","names":[],"sources":["../../src/commands/shared.ts"],"sourcesContent":["import consola from \"consola\";\nimport { createFromPURL, parsePURL, fullName } from \"../core/purl.ts\";\nimport { create, ecosystems, type Registry } from \"../core/registry.ts\";\nimport {\n  HTTPError,\n  NotFoundError,\n  RateLimitError,\n  UnknownEcosystemError,\n  InvalidPURLError,\n} from \"../core/errors.ts\";\nimport { CachedRegistry } from \"../cache/cached-registry.ts\";\nimport \"../registries/index.ts\";\n\nexport const sharedArgs = {\n  json: {\n    type: \"boolean\" as const,\n    description: \"Output as JSON\",\n    default: false,\n  },\n  \"no-cache\": {\n    type: \"boolean\" as const,\n    description: \"Bypass cache, fetch fresh data\",\n    default: false,\n  },\n} as const;\n\n/**\n * Resolve a PURL string or shorthand into [registry, name, version].\n * Uses CachedRegistry unless --no-cache is set.\n */\nexport function resolvePURL(input: string, useCache = true): [Registry, string, string] {\n  let purl = input;\n  if (!purl.startsWith(\"pkg:\")) {\n    purl = `pkg:${purl}`;\n  }\n\n  if (useCache) {\n    const parsed = parsePURL(purl);\n    const baseURL = parsed.qualifiers[\"repository_url\"] ?? \"\";\n    const inner = create(parsed.type, baseURL || undefined);\n    const reg = new CachedRegistry(inner);\n    return [reg, fullName(parsed), parsed.version];\n  }\n\n  return createFromPURL(purl);\n}\n\n/** Run a command with standard error handling. */\nexport async function withErrorHandling(fn: () => Promise<void>): Promise<void> {\n  try {\n    await fn();\n  } catch (error) {\n    if (error instanceof NotFoundError) {\n      consola.error(\n        `Package not found: ${error.ecosystem}/${error.packageName}${error.version ? `@${error.version}` : \"\"}`,\n      );\n      return process.exit(1);\n    }\n    if (error instanceof UnknownEcosystemError) {\n      consola.error(`Unknown ecosystem: ${error.ecosystem}`);\n      consola.info(`Supported: ${ecosystems().join(\", \")}`);\n      return process.exit(1);\n    }\n    if (error instanceof InvalidPURLError) {\n      consola.error(`Invalid PURL: ${error.purl}`);\n      consola.info(\"Examples: pkg:npm/lodash, npm/lodash@4.17.21, pkg:cargo/serde\");\n      return process.exit(1);\n    }\n    if (error instanceof RateLimitError) {\n      consola.error(`Rate limited by registry. Retry after ${error.retryAfter}s`);\n      return process.exit(1);\n    }\n    if (error instanceof HTTPError) {\n      consola.error(`Registry request failed: HTTP ${error.statusCode} (${error.url})`);\n      if (error.isServerError()) {\n        consola.info(\"The registry may be temporarily unavailable. Try again later.\");\n      }\n      return process.exit(1);\n    }\n    throw error;\n  }\n}\n"],"mappings":";;;;;AAaA,MAAa,aAAa;CACxB,MAAM;EACJ,MAAM;EACN,aAAa;EACb,SAAS;EACV;CACD,YAAY;EACV,MAAM;EACN,aAAa;EACb,SAAS;;CAEZ;;;;;AAMD,SAAgB,YAAY,OAAe,WAAW,MAAkC;CACtF,IAAI,OAAO;AACX,KAAI,CAAC,KAAK,WAAW,OAAO,CAC1B,QAAO,OAAO;AAGhB,KAAI,UAAU;EACZ,MAAM,SAAS,UAAU,KAAK;EAC9B,MAAM,UAAU,OAAO,WAAW,qBAAqB;AAGvD,SAAO;GADK,IAAI,eADF,OAAO,OAAO,MAAM,WAAW,KAAA,EAAU,CAClB;GACxB,SAAS,OAAO;GAAE,OAAO;GAAQ;;AAGhD,QAAO,eAAe,KAAK;;;AAI7B,eAAsB,kBAAkB,IAAwC;AAC9E,KAAI;AACF,QAAM,IAAI;UACH,OAAO;AACd,MAAI,iBAAiB,eAAe;AAClC,WAAQ,MACN,sBAAsB,MAAM,UAAU,GAAG,MAAM,cAAc,MAAM,UAAU,IAAI,MAAM,YAAY,KACpG;AACD,UAAO,QAAQ,KAAK,EAAE;;AAExB,MAAI,iBAAiB,uBAAuB;AAC1C,WAAQ,MAAM,sBAAsB,MAAM,YAAY;AACtD,WAAQ,KAAK,cAAc,YAAY,CAAC,KAAK,KAAK,GAAG;AACrD,UAAO,QAAQ,KAAK,EAAE;;AAExB,MAAI,iBAAiB,kBAAkB;AACrC,WAAQ,MAAM,iBAAiB,MAAM,OAAO;AAC5C,WAAQ,KAAK,gEAAgE;AAC7E,UAAO,QAAQ,KAAK,EAAE;;AAExB,MAAI,iBAAiB,gBAAgB;AACnC,WAAQ,MAAM,yCAAyC,MAAM,WAAW,GAAG;AAC3E,UAAO,QAAQ,KAAK,EAAE;;AAExB,MAAI,iBAAiB,WAAW;AAC9B,WAAQ,MAAM,iCAAiC,MAAM,WAAW,IAAI,MAAM,IAAI,GAAG;AACjF,OAAI,MAAM,eAAe,CACvB,SAAQ,KAAK,gEAAgE;AAE/E,UAAO,QAAQ,KAAK,EAAE;;AAExB,QAAM"}

package/dist/commands/versions.d.mts

@@ -0,0 +1,31 @@
+import { l as Version } from "../_chunks/types.mjs";
+import * as citty from "citty";
+
+//#region src/commands/versions.d.ts
+declare function selectRecentVersions(versions: Version[], limit: number): Version[];
+declare const _default: citty.CommandDef<{
+  readonly purl: {
+    readonly type: "positional";
+    readonly description: "Package PURL (e.g. pkg:npm/lodash, cargo/serde)";
+    readonly required: true;
+  };
+  readonly limit: {
+    readonly type: "string";
+    readonly alias: "l";
+    readonly description: "Max versions to show";
+    readonly default: "20";
+  };
+  readonly json: {
+    readonly type: "boolean";
+    readonly description: "Output as JSON";
+    readonly default: false;
+  };
+  readonly "no-cache": {
+    readonly type: "boolean";
+    readonly description: "Bypass cache, fetch fresh data";
+    readonly default: false;
+  };
+}>;
+//#endregion
+export { _default as default, selectRecentVersions };
+//# sourceMappingURL=versions.d.mts.map

package/dist/commands/versions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.mts","names":[],"sources":["../../src/commands/versions.ts"],"mappings":";;;;iBAKgB,oBAAA,CAAqB,QAAA,EAAU,OAAA,IAAW,KAAA,WAAgB,OAAA;AAAA,cAQzE,QAAA"}

package/dist/commands/versions.mjs

@@ -0,0 +1,58 @@
+import "../_chunks/registry.mjs";
+import "../_chunks/purl.mjs";
+import "../_chunks/registries.mjs";
+import { resolvePURL, sharedArgs, withErrorHandling } from "./shared.mjs";
+import { defineCommand } from "citty";
+import consola from "consola";
+function selectRecentVersions(versions, limit) {
+	return versions.toSorted((a, b) => {
+		if (a.publishedAt === null) return b.publishedAt === null ? 0 : 1;
+		if (b.publishedAt === null) return -1;
+		return b.publishedAt.getTime() - a.publishedAt.getTime();
+	}).slice(0, limit);
+}
+var versions_default = defineCommand({
+	meta: {
+		name: "versions",
+		description: "List package versions"
+	},
+	args: {
+		...sharedArgs,
+		purl: {
+			type: "positional",
+			description: "Package PURL (e.g. pkg:npm/lodash, cargo/serde)",
+			required: true
+		},
+		limit: {
+			type: "string",
+			alias: "l",
+			description: "Max versions to show",
+			default: "20"
+		}
+	},
+	async run({ args }) {
+		await withErrorHandling(async () => {
+			const [reg, name] = resolvePURL(args.purl, !args["no-cache"]);
+			const versions = await reg.fetchVersions(name);
+			const limit = Number.parseInt(args.limit, 10) || 20;
+			const shown = selectRecentVersions(versions, limit);
+			if (args.json) {
+				console.log(JSON.stringify(shown, null, 2));
+				return;
+			}
+			consola.log("");
+			consola.log(`  \x1b[1m${name}\x1b[0m — ${versions.length} version${versions.length === 1 ? "" : "s"}`);
+			consola.log("");
+			for (const v of shown) {
+				const status = v.status ? ` \x1b[33m[${v.status}]\x1b[0m` : "";
+				const date = v.publishedAt ? `  \x1b[90m${v.publishedAt.toISOString().slice(0, 10)}\x1b[0m` : "";
+				consola.log(`  ${v.number}${status}${date}`);
+			}
+			if (versions.length > limit) consola.log(`\n  \x1b[90m... and ${versions.length - limit} more (use --limit to show more)\x1b[0m`);
+			consola.log("");
+		});
+	}
+});
+export { versions_default as default, selectRecentVersions };
+
+//# sourceMappingURL=versions.mjs.map

package/dist/commands/versions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.mjs","names":[],"sources":["../../src/commands/versions.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport consola from \"consola\";\nimport type { Version } from \"../core/types.ts\";\n\nimport { sharedArgs, resolvePURL, withErrorHandling } from \"./shared.ts\";\nexport function selectRecentVersions(versions: Version[], limit: number): Version[] {\n  return versions\n    .toSorted((a, b) => {\n      if (a.publishedAt === null) return b.publishedAt === null ? 0 : 1;\n      if (b.publishedAt === null) return -1;\n      return b.publishedAt.getTime() - a.publishedAt.getTime();\n    })\n    .slice(0, limit);\n}\n\nexport default defineCommand({\n  meta: {\n    name: \"versions\",\n    description: \"List package versions\",\n  },\n  args: {\n    ...sharedArgs,\n    purl: {\n      type: \"positional\",\n      description: \"Package PURL (e.g. pkg:npm/lodash, cargo/serde)\",\n      required: true,\n    },\n    limit: {\n      type: \"string\",\n      alias: \"l\",\n      description: \"Max versions to show\",\n      default: \"20\",\n    },\n  },\n  async run({ args }) {\n    await withErrorHandling(async () => {\n      const [reg, name] = resolvePURL(args.purl, !args[\"no-cache\"]);\n      const versions = await reg.fetchVersions(name);\n      const limit = Number.parseInt(args.limit, 10) || 20;\n      const shown = selectRecentVersions(versions, limit);\n\n      if (args.json) {\n        console.log(JSON.stringify(shown, null, 2));\n        return;\n      }\n\n      consola.log(\"\");\n      consola.log(\n        `  \\x1b[1m${name}\\x1b[0m — ${versions.length} version${versions.length === 1 ? \"\" : \"s\"}`,\n      );\n      consola.log(\"\");\n\n      for (const v of shown) {\n        const status = v.status ? ` \\x1b[33m[${v.status}]\\x1b[0m` : \"\";\n        const date = v.publishedAt\n          ? `  \\x1b[90m${v.publishedAt.toISOString().slice(0, 10)}\\x1b[0m`\n          : \"\";\n        consola.log(`  ${v.number}${status}${date}`);\n      }\n\n      if (versions.length > limit) {\n        consola.log(\n          `\\n  \\x1b[90m... and ${versions.length - limit} more (use --limit to show more)\\x1b[0m`,\n        );\n      }\n      consola.log(\"\");\n    });\n  },\n});\n"],"mappings":";;;;;;AAKA,SAAgB,qBAAqB,UAAqB,OAA0B;AAClF,QAAO,SACJ,UAAU,GAAG,MAAM;AAClB,MAAI,EAAE,gBAAgB,KAAM,QAAO,EAAE,gBAAgB,OAAO,IAAI;AAChE,MAAI,EAAE,gBAAgB,KAAM,QAAO;AACnC,SAAO,EAAE,YAAY,SAAS,GAAG,EAAE,YAAY,SAAS;GACxD,CACD,MAAM,GAAG,MAAM;;AAGpB,IAAA,mBAAe,cAAc;CAC3B,MAAM;EACJ,MAAM;EACN,aAAa;EACd;CACD,MAAM;EACJ,GAAG;EACH,MAAM;GACJ,MAAM;GACN,aAAa;GACb,UAAU;GACX;EACD,OAAO;GACL,MAAM;GACN,OAAO;GACP,aAAa;GACb,SAAS;;EAEZ;CACD,MAAM,IAAI,EAAE,QAAQ;AAClB,QAAM,kBAAkB,YAAY;GAClC,MAAM,CAAC,KAAK,QAAQ,YAAY,KAAK,MAAM,CAAC,KAAK,YAAY;GAC7D,MAAM,WAAW,MAAM,IAAI,cAAc,KAAK;GAC9C,MAAM,QAAQ,OAAO,SAAS,KAAK,OAAO,GAAG,IAAI;GACjD,MAAM,QAAQ,qBAAqB,UAAU,MAAM;AAEnD,OAAI,KAAK,MAAM;AACb,YAAQ,IAAI,KAAK,UAAU,OAAO,MAAM,EAAE,CAAC;AAC3C;;AAGF,WAAQ,IAAI,GAAG;AACf,WAAQ,IACN,YAAY,KAAK,YAAY,SAAS,OAAO,UAAU,SAAS,WAAW,IAAI,KAAK,MACrF;AACD,WAAQ,IAAI,GAAG;AAEf,QAAK,MAAM,KAAK,OAAO;IACrB,MAAM,SAAS,EAAE,SAAS,aAAa,EAAE,OAAO,YAAY;IAC5D,MAAM,OAAO,EAAE,cACX,aAAa,EAAE,YAAY,aAAa,CAAC,MAAM,GAAG,GAAG,CAAC,WACtD;AACJ,YAAQ,IAAI,KAAK,EAAE,SAAS,SAAS,OAAO;;AAG9C,OAAI,SAAS,SAAS,MACpB,SAAQ,IACN,uBAAuB,SAAS,SAAS,MAAM,yCAChD;AAEH,WAAQ,IAAI,GAAG;IACf;;CAEL,CAAC"}

package/dist/core/index.d.mts

@@ -0,0 +1,4 @@
+import { a as ParsedPURL, c as URLBuilder, i as Package, l as Version, n as Dependency, o as RateLimiter, r as Maintainer, s as Scope, t as ClientOptions, u as VersionStatus } from "../_chunks/types.mjs";
+import { a as register, i as has, n as create, o as Client, r as ecosystems, s as defaultClient, t as Registry } from "../_chunks/registry.mjs";
+import { a as RateLimitError, c as combineLicenses, d as createFromPURL, f as fullName, i as PkioError, l as normalizeLicense, n as InvalidPURLError, o as UnknownEcosystemError, p as parsePURL, r as NotFoundError, s as normalizeRepositoryURL, t as HTTPError, u as buildPURL } from "../_chunks/errors.mjs";
+export { Client, type ClientOptions, type Dependency, HTTPError, InvalidPURLError, type Maintainer, NotFoundError, type Package, type ParsedPURL, PkioError, RateLimitError, type RateLimiter, Registry, type Scope, type URLBuilder, UnknownEcosystemError, type Version, type VersionStatus, buildPURL, combineLicenses, create, createFromPURL, defaultClient, ecosystems, fullName, has, normalizeLicense, normalizeRepositoryURL, parsePURL, register };

package/dist/core/index.mjs

@@ -0,0 +1,3 @@
+import { a as register, c as HTTPError, d as PkioError, f as RateLimitError, i as has, l as InvalidPURLError, n as create, o as Client, p as UnknownEcosystemError, r as ecosystems, s as defaultClient, t as Registry, u as NotFoundError } from "../_chunks/registry.mjs";
+import { a as normalizeRepositoryURL, i as parsePURL, n as createFromPURL, o as combineLicenses, r as fullName, s as normalizeLicense, t as buildPURL } from "../_chunks/purl.mjs";
+export { Client, HTTPError, InvalidPURLError, NotFoundError, PkioError, RateLimitError, Registry, UnknownEcosystemError, buildPURL, combineLicenses, create, createFromPURL, defaultClient, ecosystems, fullName, has, normalizeLicense, normalizeRepositoryURL, parsePURL, register };

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+import { a as ParsedPURL, c as URLBuilder, i as Package, l as Version, n as Dependency, o as RateLimiter, r as Maintainer, s as Scope, t as ClientOptions, u as VersionStatus } from "./_chunks/types.mjs";
+import { a as register, i as has, n as create, o as Client, r as ecosystems, s as defaultClient, t as Registry } from "./_chunks/registry.mjs";
+import { a as CargoRegistry, i as PyPIRegistry, n as PackagistRegistry, o as NpmRegistry, r as RubyGemsRegistry, t as AlpmRegistry } from "./_chunks/index.mjs";
+import { a as RateLimitError, c as combineLicenses, d as createFromPURL, f as fullName, i as PkioError, l as normalizeLicense, n as InvalidPURLError, o as UnknownEcosystemError, p as parsePURL, r as NotFoundError, s as normalizeRepositoryURL, t as HTTPError, u as buildPURL } from "./_chunks/errors.mjs";
+import { a as fetchVersionsFromPURL, c as selectVersion, i as fetchPackageFromPURL, n as fetchDependenciesFromPURL, o as resolveDocsUrl, r as fetchMaintainersFromPURL, s as resolveReadmeUrl, t as bulkFetchPackages } from "./_chunks/index2.mjs";
+import { t as getCacheDir } from "./_chunks/paths.mjs";
+import { a as getEcosystemStorage, i as disposeStorage, n as computeIntegrity, o as getStorage, r as configureStorage, t as clearStorage } from "./_chunks/storage.mjs";
+import { t as CachedRegistry } from "./_chunks/cached-registry.mjs";
+import { a as cacheKey, c as pruneStale, d as setEntry, f as writeLockfile, i as LockfileEntry, l as readLockfile, n as EntryType, o as getFreshEntry, r as Lockfile, s as isFresh, t as DEFAULT_TTL, u as removeEntry } from "./_chunks/lockfile.mjs";
+import { n as createCached, t as CreateCachedOptions } from "./_chunks/index3.mjs";
+export { AlpmRegistry, CachedRegistry, CargoRegistry, Client, ClientOptions, CreateCachedOptions, DEFAULT_TTL, Dependency, EntryType, HTTPError, InvalidPURLError, Lockfile, LockfileEntry, Maintainer, NotFoundError, NpmRegistry, Package, PackagistRegistry, ParsedPURL, PkioError, PyPIRegistry, RateLimitError, RateLimiter, Registry, RubyGemsRegistry, Scope, URLBuilder, UnknownEcosystemError, Version, VersionStatus, buildPURL, bulkFetchPackages, cacheKey, clearStorage, combineLicenses, computeIntegrity, configureStorage, create, createCached, createFromPURL, defaultClient, disposeStorage, ecosystems, fetchDependenciesFromPURL, fetchMaintainersFromPURL, fetchPackageFromPURL, fetchVersionsFromPURL, fullName, getCacheDir, getEcosystemStorage, getFreshEntry, getStorage, has, isFresh, normalizeLicense, normalizeRepositoryURL, parsePURL, pruneStale, readLockfile, register, removeEntry, resolveDocsUrl, resolveReadmeUrl, selectVersion, setEntry, writeLockfile };

package/dist/index.mjs

@@ -0,0 +1,10 @@
+import { a as register, c as HTTPError, d as PkioError, f as RateLimitError, i as has, l as InvalidPURLError, n as create, o as Client, p as UnknownEcosystemError, r as ecosystems, s as defaultClient, t as Registry, u as NotFoundError } from "./_chunks/registry.mjs";
+import { a as normalizeRepositoryURL, i as parsePURL, n as createFromPURL, o as combineLicenses, r as fullName, s as normalizeLicense, t as buildPURL } from "./_chunks/purl.mjs";
+import { a as CargoRegistry, i as PyPIRegistry, n as PackagistRegistry, o as NpmRegistry, r as RubyGemsRegistry, t as AlpmRegistry } from "./_chunks/registries.mjs";
+import { a as fetchVersionsFromPURL, c as selectVersion, i as fetchPackageFromPURL, n as fetchDependenciesFromPURL, o as resolveDocsUrl, r as fetchMaintainersFromPURL, s as resolveReadmeUrl, t as bulkFetchPackages } from "./_chunks/helpers.mjs";
+import { getCacheDir } from "./cache/paths.mjs";
+import { clearStorage, computeIntegrity, configureStorage, disposeStorage, getEcosystemStorage, getStorage } from "./cache/storage.mjs";
+import { DEFAULT_TTL, cacheKey, getFreshEntry, isFresh, pruneStale, readLockfile, removeEntry, setEntry, writeLockfile } from "./cache/lockfile.mjs";
+import { CachedRegistry } from "./cache/cached-registry.mjs";
+import { createCached } from "./cache/index.mjs";
+export { AlpmRegistry, CachedRegistry, CargoRegistry, Client, DEFAULT_TTL, HTTPError, InvalidPURLError, NotFoundError, NpmRegistry, PackagistRegistry, PkioError, PyPIRegistry, RateLimitError, Registry, RubyGemsRegistry, UnknownEcosystemError, buildPURL, bulkFetchPackages, cacheKey, clearStorage, combineLicenses, computeIntegrity, configureStorage, create, createCached, createFromPURL, defaultClient, disposeStorage, ecosystems, fetchDependenciesFromPURL, fetchMaintainersFromPURL, fetchPackageFromPURL, fetchVersionsFromPURL, fullName, getCacheDir, getEcosystemStorage, getFreshEntry, getStorage, has, isFresh, normalizeLicense, normalizeRepositoryURL, parsePURL, pruneStale, readLockfile, register, removeEntry, resolveDocsUrl, resolveReadmeUrl, selectVersion, setEntry, writeLockfile };

package/dist/registries/index.d.mts

@@ -0,0 +1,4 @@
+import "../_chunks/types.mjs";
+import "../_chunks/registry.mjs";
+import { a as CargoRegistry, i as PyPIRegistry, n as PackagistRegistry, o as NpmRegistry, r as RubyGemsRegistry, t as AlpmRegistry } from "../_chunks/index.mjs";
+export { AlpmRegistry, CargoRegistry, NpmRegistry, PackagistRegistry, PyPIRegistry, RubyGemsRegistry };

package/dist/registries/index.mjs

@@ -0,0 +1,4 @@
+import "../_chunks/registry.mjs";
+import "../_chunks/purl.mjs";
+import { a as CargoRegistry, i as PyPIRegistry, n as PackagistRegistry, o as NpmRegistry, r as RubyGemsRegistry, t as AlpmRegistry } from "../_chunks/registries.mjs";
+export { AlpmRegistry, CargoRegistry, NpmRegistry, PackagistRegistry, PyPIRegistry, RubyGemsRegistry };

package/dist/types.d.mts

@@ -0,0 +1,3 @@
+import { a as ParsedPURL, c as URLBuilder, i as Package, l as Version, n as Dependency, o as RateLimiter, r as Maintainer, s as Scope, t as ClientOptions, u as VersionStatus } from "./_chunks/types.mjs";
+import { t as Registry } from "./_chunks/registry.mjs";
+export { type ClientOptions, type Dependency, type Maintainer, type Package, type ParsedPURL, type RateLimiter, type Registry, type Scope, type URLBuilder, type Version, type VersionStatus };

package/dist/types.mjs

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

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@agntn/registries",
+  "version": "0.2.0",
+  "description": "Universal package registry client. Query npm, PyPI, crates.io, RubyGems, Packagist and more with a single PURL-native API.",
+  "keywords": [
+    "crates",
+    "metadata",
+    "npm",
+    "package-registry",
+    "packagist",
+    "purl",
+    "pypi",
+    "rubygems",
+    "universal"
+  ],
+  "homepage": "https://github.com/agntn/registries#readme",
+  "bugs": "https://github.com/agntn/registries/issues",
+  "license": "MIT",
+  "author": "oritwoen (https://github.com/oritwoen)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agntn/registries.git"
+  },
+  "bin": {
+    "registries": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "./src/index.ts",
+    "./src/registries/index.ts",
+    "./dist/index.mjs",
+    "./dist/registries/index.mjs"
+  ],
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./ai": {
+      "types": "./dist/ai.d.mts",
+      "import": "./dist/ai.mjs"
+    },
+    "./registries": {
+      "types": "./dist/registries/index.d.mts",
+      "import": "./dist/registries/index.mjs"
+    },
+    "./cache": {
+      "types": "./dist/cache/index.d.mts",
+      "import": "./dist/cache/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "citty": "^0.2.1",
+    "consola": "^3.4.2",
+    "ofetch": "^1.5.1",
+    "unstorage": "^1.17.4"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "ai": "^6.0.116",
+    "changelogen": "^0.6.2",
+    "obuild": "^0.4.31",
+    "oxfmt": "^0.36.0",
+    "oxlint": "^1.51.0",
+    "typescript": "^5.8.3",
+    "vitest": "^4.0.0",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "ai": "^6.0.116",
+    "zod": "^4.3.6"
+  },
+  "peerDependenciesMeta": {
+    "ai": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.6.0"
+  },
+  "scripts": {
+    "build": "obuild",
+    "dev:prepare": "obuild --stub",
+    "fmt": "oxlint . --fix && oxfmt .",
+    "lint": "oxlint . && oxfmt --check .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "release": "pnpm test:run && pnpm build && changelogen --release --push"
+  }
+}