@agntn/registries 0.3.0 → 0.3.1

package/dist/_chunks/index2.d.mts

@@ -0,0 +1,181 @@
+import { d as Package, f as ParsedPURL, g as Version, h as URLBuilder, l as Dependency, o as Client, t as Registry, u as Maintainer } from "./registry.mjs";
+
+//#region src/core/purl.d.ts
+/**
+ * Parse a package URL into normalized components.
+ *
+ * @param purlStr - Package URL to parse.
+ * @returns {ParsedPURL} The normalized components.
+ * @see https://github.com/package-url/purl-spec (ECMA-427)
+ */
+declare function parsePURL(purlStr: string): ParsedPURL;
+/**
+ * Build a registry package name from PURL components.
+ *
+ * @param parsed - Parsed package URL components.
+ * @returns {string} The namespace-qualified package name.
+ */
+declare function fullName(parsed: ParsedPURL): string;
+/**
+ * Create a registry from a package URL.
+ *
+ * @param purlStr - Package URL to resolve.
+ * @param client - Optional HTTP client.
+ * @returns {[Registry, string, string]} The registry, package name, and version.
+ */
+declare function createFromPURL(purlStr: string, client?: Client): [Registry, string, string];
+/**
+ * Build a package URL from normalized components.
+ *
+ * @param parts - Package URL components.
+ * @returns {string} The canonical package URL.
+ */
+declare function buildPURL(parts: Readonly<{
+  type: string;
+  name: string;
+  version?: string;
+  namespace?: string;
+  qualifiers?: Readonly<Record<string, string>>;
+  subpath?: string;
+}>): string;
+//#endregion
+//#region src/core/license.d.ts
+/**
+ * Normalize common license names to SPDX expressions.
+ *
+ * @param raw - License name or SPDX expression.
+ * @returns {string} The normalized SPDX expression, or an empty string.
+ */
+declare function normalizeLicense(raw: string | null | undefined): string;
+/**
+ * Combine license strings into one SPDX expression.
+ *
+ * @param licenses - License names or expressions to normalize.
+ * @param operator - SPDX operator joining multiple licenses.
+ * @returns {string} The combined SPDX expression, or an empty string.
+ */
+declare function combineLicenses(licenses: readonly (string | null | undefined)[], operator?: "OR" | "AND"): string;
+//#endregion
+//#region src/core/repository.d.ts
+/**
+ * Normalize repository shorthands and Git transports to HTTPS.
+ *
+ * @param raw - Repository URL string or object with a URL field.
+ * @returns {string} The normalized URL, or an empty string.
+ */
+declare function normalizeRepositoryURL(raw: unknown): string;
+//#endregion
+//#region src/core/errors.d.ts
+/** Custom error types for registry operations. */
+declare class PkioError extends Error {
+  constructor(message: string, options?: ErrorOptions);
+}
+declare class HTTPError extends PkioError {
+  readonly statusCode: number;
+  readonly url: string;
+  readonly body: string;
+  constructor(statusCode: number, url: string, body: string);
+  isNotFound(): boolean;
+  isRateLimit(): boolean;
+  isServerError(): boolean;
+}
+declare class NotFoundError extends PkioError {
+  readonly ecosystem: string;
+  readonly packageName: string;
+  readonly version: string;
+  constructor(ecosystem: string, packageName: string, version?: string);
+}
+declare class RateLimitError extends PkioError {
+  readonly retryAfter: number;
+  constructor(retryAfter: number);
+}
+declare class UnknownEcosystemError extends PkioError {
+  readonly ecosystem: string;
+  constructor(ecosystem: string);
+}
+declare class InvalidPURLError extends PkioError {
+  readonly purl: string;
+  constructor(purl: string, reason: string);
+}
+//#endregion
+//#region src/helpers.d.ts
+/**
+ * Fetch normalized package metadata from a package URL.
+ *
+ * @param purl - Package URL.
+ * @param signal - Optional cancellation signal.
+ * @param client - Optional HTTP client.
+ * @returns {Promise<Package>} Normalized package metadata.
+ */
+declare function fetchPackageFromPURL(purl: string, signal?: AbortSignal, client?: Client): Promise<Package>;
+/**
+ * Fetch all versions from a package URL.
+ *
+ * @param purl - Package URL.
+ * @param signal - Optional cancellation signal.
+ * @param client - Optional HTTP client.
+ * @returns {Promise<Version[]>} Normalized versions.
+ */
+declare function fetchVersionsFromPURL(purl: string, signal?: AbortSignal, client?: Client): Promise<Version[]>;
+/**
+ * Fetch dependencies for a versioned package URL.
+ *
+ * @param purl - Versioned package URL.
+ * @param signal - Optional cancellation signal.
+ * @param client - Optional HTTP client.
+ * @returns {Promise<Dependency[]>} Normalized dependencies.
+ */
+declare function fetchDependenciesFromPURL(purl: string, signal?: AbortSignal, client?: Client): Promise<Dependency[]>;
+/**
+ * Fetch maintainers from a package URL.
+ *
+ * @param purl - Package URL.
+ * @param signal - Optional cancellation signal.
+ * @param client - Optional HTTP client.
+ * @returns {Promise<Maintainer[]>} Normalized maintainers.
+ */
+declare function fetchMaintainersFromPURL(purl: string, signal?: AbortSignal, client?: Client): Promise<Maintainer[]>;
+/**
+ * Fetch packages concurrently, skipping failed lookups.
+ *
+ * @param purls - Package URLs to fetch.
+ * @param options - Optional concurrency, cancellation, and client settings.
+ * @returns {Promise<Map<string, Package>>} Results keyed by package URL.
+ */
+declare function bulkFetchPackages(purls: readonly string[], options?: Readonly<{
+  concurrency?: number;
+  signal?: AbortSignal;
+  client?: Client;
+}>): Promise<Map<string, Package>>;
+/**
+ * Select an exact requested or latest version, then the newest usable one.
+ *
+ * @param versions - Candidate versions.
+ * @param options - Optional requested and latest version numbers.
+ * @returns {Version | null} The selected version, or null.
+ */
+declare function selectVersion(versions: readonly Version[], options?: Readonly<{
+  requested?: string;
+  latest?: string;
+}>): Version | null;
+/**
+ * Resolve the best documentation URL for a package.
+ *
+ * @param pkg - Package metadata.
+ * @param urls - Ecosystem URL builder.
+ * @param version - Optional package version.
+ * @returns {string} The explicit, homepage, or ecosystem documentation URL.
+ */
+declare function resolveDocsUrl(pkg: Package, urls: URLBuilder, version?: string): string;
+/**
+ * Resolve the ecosystem README URL for a package.
+ *
+ * @param pkg - Package metadata.
+ * @param urls - Ecosystem URL builder.
+ * @param version - Optional package version.
+ * @returns {string} The README URL.
+ */
+declare function resolveReadmeUrl(pkg: Package, urls: URLBuilder, version?: string): string;
+//#endregion
+export { normalizeLicense as _, fetchVersionsFromPURL as a, fullName as b, selectVersion as c, NotFoundError as d, PkioError as f, combineLicenses as g, normalizeRepositoryURL as h, fetchPackageFromPURL as i, HTTPError as l, UnknownEcosystemError as m, fetchDependenciesFromPURL as n, resolveDocsUrl as o, RateLimitError as p, fetchMaintainersFromPURL as r, resolveReadmeUrl as s, bulkFetchPackages as t, InvalidPURLError as u, buildPURL as v, parsePURL as x, createFromPURL as y };
+//# sourceMappingURL=index2.d.mts.map

package/dist/_chunks/index2.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index2.d.mts","names":[],"sources":["../../src/core/purl.ts","../../src/core/license.ts","../../src/core/repository.ts","../../src/core/errors.ts","../../src/helpers.ts"],"mappings":";;;AAiEA;;;;;AAmEA;;AAnEA,iBAAgB,SAAA,CAAU,OAAA,WAAkB,UAAA;;;AAiF5C;;;;iBAdgB,QAAA,CAAS,MAAA,EAAQ,UAAA;;;;;;AA2BjC;;iBAbgB,cAAA,CAAe,OAAA,UAAiB,MAAA,GAAS,MAAA,IAAU,QAAA;;;;;;;iBAanD,SAAA,CACd,KAAA,EAAO,QAAA;EACL,IAAA;EACA,IAAA;EACA,OAAA;EACA,SAAA;EACA,UAAA,GAAa,QAAA,CAAS,MAAA;EACtB,OAAA;AAAA;;;;;;AArGJ;;;iBC3DgB,gBAAA,CAAiB,GAAA;;AD8HjC;;;;;AAcA;iBClFgB,eAAA,CACd,QAAA,0CACA,QAAA;;;;;;ADDF;;;iBE/BgB,sBAAA,CAAuB,GAAA;;;;cChC1B,SAAA,SAAkB,KAAA;cACjB,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;AAAA,cAM5B,SAAA,SAAkB,SAAA;EAAA,SACpB,UAAA;EAAA,SACA,GAAA;EAAA,SACA,IAAA;cAEG,UAAA,UAAoB,GAAA,UAAa,IAAA;EAQ7C,UAAA,CAAA;EAIA,WAAA,CAAA;EAIA,aAAA,CAAA;AAAA;AAAA,cAKW,aAAA,SAAsB,SAAA;EAAA,SACxB,SAAA;EAAA,SACA,WAAA;EAAA,SACA,OAAA;cAEG,SAAA,UAAmB,WAAA,UAAqB,OAAA;AAAA;AAAA,cAUzC,cAAA,SAAuB,SAAA;EAAA,SACzB,UAAA;cAEG,UAAA;AAAA;AAAA,cAOD,qBAAA,SAA8B,SAAA;EAAA,SAChC,SAAA;cAEG,SAAA;AAAA;AAAA,cAOD,gBAAA,SAAyB,SAAA;EAAA,SAC3B,IAAA;cAEG,IAAA,UAAc,MAAA;AAAA;;;;AHR5B;;;;;AAmEA;;iBIvHsB,oBAAA,CACpB,IAAA,UACA,MAAA,GAAS,WAAA,EACT,MAAA,GAAS,MAAA,GACR,OAAA,CAAQ,OAAA;;;AJiIX;;;;;;iBIpHsB,qBAAA,CACpB,IAAA,UACA,MAAA,GAAS,WAAA,EACT,MAAA,GAAS,MAAA,GACR,OAAA,CAAQ,OAAA;;;;AJ6HX;;;;;iBIhHsB,yBAAA,CACpB,IAAA,UACA,MAAA,GAAS,WAAA,EACT,MAAA,GAAS,MAAA,GACR,OAAA,CAAQ,UAAA;;;;;;;;;iBAgBW,wBAAA,CACpB,IAAA,UACA,MAAA,GAAS,WAAA,EACT,MAAA,GAAS,MAAA,GACR,OAAA,CAAQ,UAAA;;;;;;;;iBAcW,iBAAA,CACpB,KAAA,qBACA,OAAA,GAAU,QAAA;EAAW,WAAA;EAAsB,MAAA,GAAS,WAAA;EAAa,MAAA,GAAS,MAAA;AAAA,KACzE,OAAA,CAAQ,GAAA,SAAY,OAAA;;AHxBvB;;;;;;iBGyDgB,aAAA,CACd,QAAA,WAAmB,OAAA,IACnB,OAAA,GAAU,QAAA;EACR,SAAA;EACA,MAAA;AAAA,KAED,OAAA;;;;;;;AD7HH;;iBC8JgB,cAAA,CAAe,GAAA,EAAK,OAAA,EAAS,IAAA,EAAM,UAAA,EAAY,OAAA;;;;;;;;;iBAY/C,gBAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,IAAA,EAAM,UAAA,EAAY,OAAA"}

package/dist/_chunks/index3.d.mts

@@ -0,0 +1,188 @@
+import { d as Package, g as Version, h as URLBuilder, l as Dependency, o as Client, t as Registry, u as Maintainer } from "./registry.mjs";
+import { Storage } from "unstorage";
+
+//#region src/cache/paths.d.ts
+/**
+ * Resolve the cache directory using the current platform convention.
+ *
+ * @returns {string} The absolute cache directory path.
+ */
+declare function getCacheDir(): string;
+//#endregion
+//#region src/cache/storage.d.ts
+/**
+ * Configure the storage backend before the first cache operation.
+ *
+ * @param storage - Storage backend to use.
+ */
+declare function configureStorage(storage: Storage): void;
+/**
+ * Get or create the shared storage backend.
+ *
+ * @returns {Storage} The configured or filesystem-backed storage.
+ */
+declare function getStorage(): Storage;
+/**
+ * Get storage scoped to one registry ecosystem.
+ *
+ * @param ecosystem - Registry ecosystem key.
+ * @returns {Storage} Namespaced storage for the ecosystem.
+ */
+declare function getEcosystemStorage(ecosystem: string): Storage;
+/**
+ * Compute a SHA-256 integrity value for JSON-serializable data.
+ *
+ * @param value - Value to hash.
+ * @returns {string} The prefixed hexadecimal digest.
+ */
+declare function computeIntegrity(value: unknown): string;
+/** Dispose the storage instance. Call on process exit. */
+declare function disposeStorage(): Promise<void>;
+/** Clear all cached data. */
+declare function clearStorage(): Promise<void>;
+//#endregion
+//#region src/cache/cached-registry.d.ts
+/**
+ * CachedRegistry wraps any Registry and adds caching backed by unstorage
+ * with a lockfile for freshness tracking.
+ *
+ * Pass a custom `storage` to use a non-default driver (e.g. Cloudflare KV).
+ * If omitted, uses the globally configured storage (see `configureStorage()`).
+ */
+declare class CachedRegistry extends Registry {
+  readonly inner: Registry;
+  readonly storage: Storage;
+  private readonly lockfileStorage;
+  private readonly inflight;
+  constructor(inner: Registry, storage?: Storage);
+  ecosystem(): string;
+  urls(): URLBuilder;
+  fetchPackage(name: string, signal?: AbortSignal): Promise<Package>;
+  fetchVersions(name: string, signal?: AbortSignal): Promise<Version[]>;
+  fetchDependencies(name: string, version: string, signal?: AbortSignal): Promise<Dependency[]>;
+  fetchMaintainers(name: string, signal?: AbortSignal): Promise<Maintainer[]>;
+  /**
+   * Read a fresh cached value or fetch and persist its replacement.
+   *
+   * @param name - Package name.
+   * @param type - Cached data type.
+   * @param version - Package version when the cache entry is versioned.
+   * @param fetcher - Upstream operation used after a cache miss.
+   * @param signal - Optional cancellation signal.
+   * @param extraMeta - Optional lockfile metadata derived from the fetched value.
+   * @returns {Promise<T>} The cached or freshly fetched value.
+   */
+  private cached;
+}
+//#endregion
+//#region src/cache/lockfile.d.ts
+/** Default TTL per data type (seconds). */
+declare const DEFAULT_TTL: {
+  readonly package: 3600;
+  readonly versions: 1800;
+  readonly dependencies: 86400;
+  readonly maintainers: 86400;
+};
+type EntryType = keyof typeof DEFAULT_TTL;
+/** A single cached entry tracked in the lockfile. */
+interface LockfileEntry {
+  /** PURL-style key: 'npm:lodash', 'cargo:serde' */
+  key: string;
+  /** What kind of data: package, versions, dependencies, maintainers */
+  type: EntryType;
+  /** Unix timestamp (ms) when fetched */
+  fetchedAt: number;
+  /** TTL in seconds */
+  ttl: number;
+  /** Latest version at time of caching (for package entries) */
+  latestVersion?: string;
+  /** Content hash (sha256 of JSON-serialized value) for integrity */
+  integrity: string;
+}
+/** The full lockfile structure. */
+interface Lockfile {
+  version: number;
+  entries: Record<string, LockfileEntry>;
+}
+/**
+ * Read the lockfile, falling back to an empty valid structure.
+ *
+ * @param storage - Optional storage backend.
+ * @returns {Promise<Lockfile>} The stored or empty lockfile.
+ */
+declare function readLockfile(storage?: Storage): Promise<Lockfile>;
+/**
+ * Persist the lockfile.
+ *
+ * @param lockfile - Lockfile to persist.
+ * @param storage - Optional storage backend.
+ */
+declare function writeLockfile(lockfile: Lockfile, storage?: Storage): Promise<void>;
+/**
+ * Build a stable cache key.
+ *
+ * @param ecosystem - Registry ecosystem.
+ * @param name - Package name.
+ * @param type - Cached data type.
+ * @param version - Optional package version.
+ * @returns {string} The cache key.
+ */
+declare function cacheKey(ecosystem: string, name: string, type: EntryType, version?: string): string;
+/**
+ * Check whether a lockfile entry is fresh.
+ *
+ * @param entry - Entry to inspect.
+ * @returns {boolean} Whether the entry is still valid.
+ */
+declare function isFresh(entry: LockfileEntry): boolean;
+/**
+ * Read a fresh lockfile entry.
+ *
+ * @param lockfile - Lockfile to inspect.
+ * @param key - Cache key.
+ * @returns {LockfileEntry | null} The fresh entry, or null.
+ */
+declare function getFreshEntry(lockfile: Lockfile, key: string): LockfileEntry | null;
+/**
+ * Upsert an in-memory lockfile entry without persisting it.
+ *
+ * @param lockfile - Lockfile to mutate.
+ * @param entry - Entry to store.
+ */
+declare function setEntry(lockfile: Lockfile, entry: LockfileEntry): void;
+/**
+ * Remove an in-memory lockfile entry.
+ *
+ * @param lockfile - Lockfile to mutate.
+ * @param key - Cache key to remove.
+ */
+declare function removeEntry(lockfile: Lockfile, key: string): void;
+/**
+ * Remove every stale in-memory entry.
+ *
+ * @param lockfile - Lockfile to prune.
+ * @returns {number} The number of removed entries.
+ */
+declare function pruneStale(lockfile: Lockfile): number;
+//#endregion
+//#region src/cache/index.d.ts
+/** Options for creating a cached registry. */
+interface CreateCachedOptions {
+  /** Custom base URL for the registry API. */
+  baseURL?: string;
+  /** Custom HTTP client. */
+  client?: Client;
+  /** Custom unstorage instance. Overrides the globally configured storage. */
+  storage?: Storage;
+}
+/**
+ * Create a registry with cache and lockfile tracking.
+ *
+ * @param ecosystem - Registry ecosystem key.
+ * @param options - Optional registry, client, and storage overrides.
+ * @returns {Registry} A cached registry instance.
+ */
+declare function createCached(ecosystem: string, options?: CreateCachedOptions): Registry;
+//#endregion
+export { getCacheDir as S, computeIntegrity as _, Lockfile as a, getEcosystemStorage as b, getFreshEntry as c, readLockfile as d, removeEntry as f, clearStorage as g, CachedRegistry as h, EntryType as i, isFresh as l, writeLockfile as m, createCached as n, LockfileEntry as o, setEntry as p, DEFAULT_TTL as r, cacheKey as s, CreateCachedOptions as t, pruneStale as u, configureStorage as v, getStorage as x, disposeStorage as y };
+//# sourceMappingURL=index3.d.mts.map

package/dist/_chunks/index3.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index3.d.mts","names":[],"sources":["../../src/cache/paths.ts","../../src/cache/storage.ts","../../src/cache/cached-registry.ts","../../src/cache/lockfile.ts","../../src/cache/index.ts"],"mappings":";;;;;;;;AAUA;iBAAgB,WAAA,CAAA;;;;;;AAAhB;;iBCGgB,gBAAA,CAAiB,OAAA,EAAS,OAAA;;;;;;iBAS1B,UAAA,CAAA,GAAc,OAAA;;;;;AAA9B;;iBAagB,mBAAA,CAAoB,SAAA,WAAoB,OAAA;;;AAAxD;;;;iBAUgB,gBAAA,CAAiB,KAAA;AAAjC;AAAA,iBAKsB,cAAA,CAAA,GAAkB,OAAA;;iBAQlB,YAAA,CAAA,GAAgB,OAAA;;;;ADhDtC;;;;;;cEWa,cAAA,SAAuB,QAAA;EAAA,SACzB,KAAA,EAAO,QAAA;EAAA,SACP,OAAA,EAAS,OAAA;EAAA,iBACD,eAAA;EAAA,iBACA,QAAA;cAEL,KAAA,EAAO,QAAA,EAAU,OAAA,GAAU,OAAA;EAOvC,SAAA,CAAA;EAIA,IAAA,CAAA,GAAQ,UAAA;EAIF,YAAA,CAAa,IAAA,UAAc,MAAA,GAAS,WAAA,GAAc,OAAA,CAAQ,OAAA;EAW1D,aAAA,CAAc,IAAA,UAAc,MAAA,GAAS,WAAA,GAAc,OAAA,CAAQ,OAAA;EAgB3D,iBAAA,CACJ,IAAA,UACA,OAAA,UACA,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,UAAA;EAUL,gBAAA,CAAiB,IAAA,UAAc,MAAA,GAAS,WAAA,GAAc,OAAA,CAAQ,UAAA;EDhDtD;;;;;AAUhB;;;;;AAKA;EAfgB,QCqEA,MAAA;AAAA;;;;cCjGH,WAAA;EAAA;;;;;KAOD,SAAA,gBAAyB,WAAA;;UAGpB,aAAA;;EAEf,GAAA;EFN8B;EEQ9B,IAAA,EAAM,SAAA;EFRkC;EEUxC,SAAA;EFDc;EEGd,GAAA;;EAEA,aAAA;EFLmC;EEOnC,SAAA;AAAA;;UAIe,QAAA;EACf,OAAA;EACA,OAAA,EAAS,MAAA,SAAe,aAAA;AAAA;;;;AFe1B;;;iBEFsB,YAAA,CAAa,OAAA,GAAU,OAAA,GAAU,OAAA,CAAQ,QAAA;;AFU/D;;;;;iBEOsB,aAAA,CAAc,QAAA,EAAU,QAAA,EAAU,OAAA,GAAU,OAAA,GAAU,OAAA;;;AD5C5E;;;;;;;iBC0DgB,QAAA,CACd,SAAA,UACA,IAAA,UACA,IAAA,EAAM,SAAA,EACN,OAAA;;;;;;;iBAYc,OAAA,CAAQ,KAAA,EAAO,aAAA;;;;;;;;iBAYf,aAAA,CAAc,QAAA,EAAU,QAAA,EAAU,GAAA,WAAc,aAAA;;;;;;;iBAahD,QAAA,CAAS,QAAA,EAAU,QAAA,EAAU,KAAA,EAAO,aAAA;;;;;;;iBAUpC,WAAA,CAAY,QAAA,EAAU,QAAA,EAAU,GAAA;;;;;;;iBAUhC,UAAA,CAAW,QAAA,EAAU,QAAA;;;;UC7GpB,mBAAA;;EAEf,OAAA;EHpBc;EGsBd,MAAA,GAAS,MAAA;;EAET,OAAA,GAAU,OAAA;AAAA;AHfZ;;;;;AAaA;;AAbA,iBGyBgB,YAAA,CAAa,SAAA,UAAmB,OAAA,GAAU,mBAAA,GAAsB,QAAA"}

package/dist/_chunks/info.mjs

@@ -0,0 +1,105 @@
+import "./registry.mjs";
+import "./registries.mjs";
+import { o as resolveDocsUrl } from "./helpers.mjs";
+import "./lockfile.mjs";
+import "./cached-registry.mjs";
+import { n as sharedArgs, r as withErrorHandling, t as resolvePURL } 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 = shouldShowDocs(docsUrl, pkg, 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("");
+	const rows = [
+		[
+			"License:",
+			"    ",
+			pkg.licenses,
+			Boolean(pkg.licenses)
+		],
+		[
+			"Repository:",
+			" ",
+			pkg.repository,
+			Boolean(pkg.repository)
+		],
+		[
+			"Homepage:",
+			"   ",
+			pkg.homepage,
+			Boolean(pkg.homepage)
+		],
+		[
+			"Docs:",
+			"       ",
+			docsUrl,
+			showDocs
+		],
+		[
+			"Registry:",
+			"   ",
+			registryUrl,
+			true
+		],
+		[
+			"Keywords:",
+			"   ",
+			pkg.keywords.join(", "),
+			pkg.keywords.length > 0
+		],
+		[
+			"Namespace:",
+			"  ",
+			pkg.namespace,
+			Boolean(pkg.namespace)
+		],
+		[
+			"Ecosystem:",
+			"  ",
+			reg.ecosystem(),
+			true
+		]
+	];
+	for (const [label, spacing, value, visible] of rows) if (visible) consola.log(`  \x1B[90m${label}\x1B[0m${spacing}${value}`);
+	consola.log("");
+}
+function shouldShowDocs(docsUrl, pkg, registryUrl) {
+	return Boolean(docsUrl) && ![
+		pkg.homepage,
+		pkg.repository,
+		registryUrl
+	].includes(docsUrl);
+}
+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 };
+
+//# sourceMappingURL=info.mjs.map

package/dist/_chunks/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 = shouldShowDocs(docsUrl, pkg, 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  const rows = [\n    [\"License:\", \"    \", pkg.licenses, Boolean(pkg.licenses)],\n    [\"Repository:\", \" \", pkg.repository, Boolean(pkg.repository)],\n    [\"Homepage:\", \"   \", pkg.homepage, Boolean(pkg.homepage)],\n    [\"Docs:\", \"       \", docsUrl, showDocs],\n    [\"Registry:\", \"   \", registryUrl, true],\n    [\"Keywords:\", \"   \", pkg.keywords.join(\", \"), pkg.keywords.length > 0],\n    [\"Namespace:\", \"  \", pkg.namespace, Boolean(pkg.namespace)],\n    [\"Ecosystem:\", \"  \", reg.ecosystem(), true],\n  ] as const;\n\n  for (const [label, spacing, value, visible] of rows) {\n    if (visible) consola.log(`  \\x1B[90m${label}\\x1B[0m${spacing}${value}`);\n  }\n  consola.log(\"\");\n}\n\nfunction shouldShowDocs(\n  docsUrl: string,\n  pkg: Readonly<Pick<Package, \"homepage\" | \"repository\">>,\n  registryUrl: string,\n): boolean {\n  return Boolean(docsUrl) && ![pkg.homepage, pkg.repository, registryUrl].includes(docsUrl);\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,WAAW,eAAe,SAAS,KAAK,YAAY;AAE1D,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;CAEf,MAAM,OAAO;EACX;GAAC;GAAY;GAAQ,IAAI;GAAU,QAAQ,IAAI,SAAA;GAAU;EACzD;GAAC;GAAe;GAAK,IAAI;GAAY,QAAQ,IAAI,WAAA;GAAY;EAC7D;GAAC;GAAa;GAAO,IAAI;GAAU,QAAQ,IAAI,SAAA;GAAU;EACzD;GAAC;GAAS;GAAW;GAAS;GAAS;EACvC;GAAC;GAAa;GAAO;GAAa;GAAK;EACvC;GAAC;GAAa;GAAO,IAAI,SAAS,KAAK,KAAK;GAAE,IAAI,SAAS,SAAS;GAAE;EACtE;GAAC;GAAc;GAAM,IAAI;GAAW,QAAQ,IAAI,UAAA;GAAW;EAC3D;GAAC;GAAc;GAAM,IAAI,WAAW;GAAE;;EACvC;AAED,MAAK,MAAM,CAAC,OAAO,SAAS,OAAO,YAAY,KAC7C,KAAI,QAAS,SAAQ,IAAI,aAAa,MAAM,SAAS,UAAU,QAAQ;AAEzE,SAAQ,IAAI,GAAG;;AAGjB,SAAS,eACP,SACA,KACA,aACS;AACT,QAAO,QAAQ,QAAQ,IAAI,CAAC;EAAC,IAAI;EAAU,IAAI;EAAY;EAAY,CAAC,SAAS,QAAQ;;AAG3F,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"}