@agntn/registries 0.2.0 → 0.3.1

package/README.md

@@ -15,12 +15,14 @@ There is no embeddable TypeScript library that normalizes across registries. The
 
 @agntn/registries fills that gap. One `fetchPackage` call, same response shape, regardless of whether the package lives on npm or Packagist. Uses [PURL (ECMA-427)](https://github.com/package-url/purl-spec) for addressing, so `pkg:npm/lodash` and `pkg:cargo/serde` resolve through the same code path. Storage-backed caching with a lockfile keeps things fast on repeated lookups.
 
+Docs and the live lookup explorer: [registries.agntn.dev](https://registries.agntn.dev). The source lives in [`docs/`](./docs); run `pnpm docs` after `pnpm build` for a local copy.
+
 ## Features
 
 - 🔍 **Single API, six registries** - npm, PyPI, crates.io, RubyGems, Packagist, Arch Linux (official + AUR)
 - 📦 **PURL-native** - [ECMA-427](https://github.com/package-url/purl-spec) identifiers as first-class input
 - 🏷️ **Normalized data model** - same `Package`, `Version`, `Dependency`, `Maintainer` types everywhere
-- 💾 **Storage-backed cache + lockfile** - unstorage-native, sha256 integrity checks, configurable TTL
+- 💾 **Cache on unstorage with a lockfile** - sha256 integrity checks, configurable TTL
 - ⌨️ **CLI included** - `registries info npm/lodash`, `registries versions cargo/serde`, `registries deps pypi/flask@3.1.1`
 - 🔁 **Retry + backoff** - exponential backoff with jitter, rate limiter interface
 - 🪶 **ESM-only, zero CJS** - built with [obuild](https://github.com/unjs/obuild)
@@ -78,7 +80,7 @@ Add `--json` for machine-readable output, `--no-cache` to skip the cache.
 
 ### AI SDK tool
 
-`@agntn/registries/ai` exports a ready-made tool for AI SDK apps:
+`@agntn/registries/ai` exports a tool for AI SDK apps that needs no wiring:
 
 ```ts
 import { generateText } from "ai";
@@ -101,6 +103,26 @@ The tool supports these operations through one input schema:
 // { operation: 'bulk-packages', purls: ['pkg:npm/lodash', 'pkg:cargo/serde'], concurrency?: number }
 ```
 
+### MCP
+
+The package ships an MCP server with six read-only tools for metadata, versions, dependencies, maintainers, bulk lookups, and ecosystem discovery:
+
+```bash
+claude mcp add registries --scope user -- npx @agntn/registries mcp
+```
+
+Hosts with their own transport can import `createMcpServer` from `@agntn/registries/mcp`.
+
+### Pi and OMP extensions
+
+Install the published package in OMP:
+
+```bash
+omp install @agntn/registries
+```
+
+From a source checkout, use `omp install .`. The package manifests point OMP and Pi at their matching extension entrypoints, and both expose the same six read-only tools as MCP.
+
 ## Registries
 
 | Ecosystem  | PURL type          | Registry                         |
@@ -229,6 +251,7 @@ registries <command> [options]
 | `registries versions <purl>`    | List all published versions                            |
 | `registries deps <purl>`        | Dependencies for a specific version                    |
 | `registries maintainers <purl>` | Package maintainers / authors                          |
+| `registries mcp`                | Start the MCP server over stdio                        |
 | `registries cache status`       | Show cache stats (entries, freshness)                  |
 | `registries cache path`         | Print cache directory path                             |
 | `registries cache clear`        | Remove all cached data                                 |
@@ -265,7 +288,7 @@ interface Package {
   homepage: string;
   documentation: string; // docs URL (docs.rs, readthedocs, rubydoc, etc.)
   repository: string;
-  licenses: string; // SPDX-normalized
+  licenses: string; // normalized to SPDX
   keywords: string[];
   namespace: string; // e.g. "@vue" for npm scoped packages
   latestVersion: string;

package/dist/THIRD-PARTY-LICENSES.md

@@ -0,0 +1,36 @@
+# Licenses of Bundled Dependencies
+
+The published artifact additionally contains code with the following licenses:
+MIT
+
+# Bundled Dependencies
+
+## typebox
+
+License: MIT
+By: sinclairzx81
+Repository: https://github.com/sinclairzx81/typebox
+
+> TypeBox
+> 
+> The MIT License (MIT)
+> 
+> Copyright (c) 2017-2026 Haydn Paterson
+> 
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+> 
+> The above copyright notice and this permission notice shall be included in
+> all copies or substantial portions of the Software.
+> 
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+> THE SOFTWARE.

package/dist/_chunks/cache.mjs

@@ -0,0 +1,15 @@
+import { n as create } from "./registry.mjs";
+import { t as CachedRegistry } from "./cached-registry.mjs";
+/**
+* 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.
+*/
+function createCached(ecosystem, options) {
+	return new CachedRegistry(create(ecosystem, options?.baseURL, options?.client), options?.storage);
+}
+export { createCached as t };
+
+//# sourceMappingURL=cache.mjs.map

package/dist/{cache/index.mjs.map → _chunks/cache.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/cache/index.ts"],"sourcesContent":["// Cache\nexport { getCacheDir } from \"./paths.ts\";\nexport {\n  getStorage,\n  getEcosystemStorage,\n  computeIntegrity,\n  disposeStorage,\n  clearStorage,\n  configureStorage,\n} from \"./storage.ts\";\nexport { CachedRegistry } from \"./cached-registry.ts\";\nexport {\n  readLockfile,\n  writeLockfile,\n  cacheKey,\n  isFresh,\n  getFreshEntry,\n  setEntry,\n  removeEntry,\n  pruneStale,\n  DEFAULT_TTL,\n} from \"./lockfile.ts\";\nexport type { Lockfile, LockfileEntry, EntryType } from \"./lockfile.ts\";\n\n// Convenience\nimport type { Storage } from \"unstorage\";\nimport type { Client } from \"../core/client.ts\";\nimport { create, type Registry } from \"../core/registry.ts\";\nimport { CachedRegistry } from \"./cached-registry.ts\";\n\n/** Options for creating a cached registry. */\nexport interface CreateCachedOptions {\n  /** Custom base URL for the registry API. */\n  baseURL?: string;\n  /** Custom HTTP client. */\n  client?: Client;\n  /** Custom unstorage instance. Overrides the globally configured storage. */\n  storage?: Storage;\n}\n\n/** Create a registry instance with caching + lockfile tracking. */\nexport function createCached(ecosystem: string, options?: CreateCachedOptions): Registry {\n  const inner = create(ecosystem, options?.baseURL, options?.client);\n  return new CachedRegistry(inner, options?.storage);\n}\n"],"mappings":";;;;;;AAyCA,SAAgB,aAAa,WAAmB,SAAyC;AAEvF,QAAO,IAAI,eADG,OAAO,WAAW,SAAS,SAAS,SAAS,OAAO,EACjC,SAAS,QAAQ"}
+{"version":3,"file":"cache.mjs","names":[],"sources":["../../src/cache/index.ts"],"sourcesContent":["// Cache\nexport { getCacheDir } from \"./paths.ts\";\nexport {\n  getStorage,\n  getEcosystemStorage,\n  computeIntegrity,\n  disposeStorage,\n  clearStorage,\n  configureStorage,\n} from \"./storage.ts\";\nexport { CachedRegistry } from \"./cached-registry.ts\";\nexport {\n  readLockfile,\n  writeLockfile,\n  cacheKey,\n  isFresh,\n  getFreshEntry,\n  setEntry,\n  removeEntry,\n  pruneStale,\n  DEFAULT_TTL,\n} from \"./lockfile.ts\";\nexport type { Lockfile, LockfileEntry, EntryType } from \"./lockfile.ts\";\n\n// Convenience\nimport type { Storage } from \"unstorage\";\nimport type { Client } from \"../core/client.ts\";\nimport { create, type Registry } from \"../core/registry.ts\";\nimport { CachedRegistry } from \"./cached-registry.ts\";\n\n/** Options for creating a cached registry. */\nexport interface CreateCachedOptions {\n  /** Custom base URL for the registry API. */\n  baseURL?: string;\n  /** Custom HTTP client. */\n  client?: Client;\n  /** Custom unstorage instance. Overrides the globally configured storage. */\n  storage?: Storage;\n}\n\n/**\n * Create a registry with cache and lockfile tracking.\n *\n * @param ecosystem - Registry ecosystem key.\n * @param options - Optional registry, client, and storage overrides.\n * @returns {Registry} A cached registry instance.\n */\nexport function createCached(ecosystem: string, options?: CreateCachedOptions): Registry {\n  const inner = create(ecosystem, options?.baseURL, options?.client);\n  return new CachedRegistry(inner, options?.storage);\n}\n"],"mappings":";;;;;;;;;AA+CA,SAAgB,aAAa,WAAmB,SAAyC;AAEvF,QAAO,IAAI,eADG,OAAO,WAAW,SAAS,SAAS,SAAS,OAAO,EACjC,SAAS,QAAQ"}

package/dist/{commands/cache.mjs → _chunks/cache2.mjs}

@@ -1,6 +1,4 @@
-import { getCacheDir } from "../cache/paths.mjs";
-import { clearStorage } from "../cache/storage.mjs";
-import { pruneStale, readLockfile, writeLockfile } from "../cache/lockfile.mjs";
+import { a as pruneStale, g as getCacheDir, l as writeLockfile, o as readLockfile, u as clearStorage } from "./lockfile.mjs";
 import { defineCommand } from "citty";
 import consola from "consola";
 var cache_default = defineCommand({
@@ -46,9 +44,9 @@ var cache_default = defineCommand({
 				});
 				const stale = entries.length - fresh.length;
 				consola.log("");
-				consola.log(`  \x1b[1mCache status\x1b[0m`);
-				consola.log(`  \x1b[90mDirectory:\x1b[0m  ${getCacheDir()}`);
-				consola.log(`  \x1b[90mEntries:\x1b[0m    ${entries.length} total, ${fresh.length} fresh, ${stale} stale`);
+				consola.log(`  \x1B[1mCache status\x1B[0m`);
+				consola.log(`  \x1B[90mDirectory:\x1B[0m  ${getCacheDir()}`);
+				consola.log(`  \x1B[90mEntries:\x1B[0m    ${entries.length} total, ${fresh.length} fresh, ${stale} stale`);
 				consola.log("");
 				if (fresh.length > 0) {
 					const byEco = /* @__PURE__ */ new Map();
@@ -56,7 +54,7 @@ var cache_default = defineCommand({
 						const eco = e.key.split(":")[0];
 						byEco.set(eco, (byEco.get(eco) ?? 0) + 1);
 					}
-					for (const [eco, count] of byEco) consola.log(`  \x1b[36m${eco}\x1b[0m: ${count} cached`);
+					for (const [eco, count] of byEco) consola.log(`  \x1B[36m${eco}\x1B[0m: ${count} cached`);
 					consola.log("");
 				}
 			}
@@ -77,4 +75,4 @@ var cache_default = defineCommand({
 });
 export { cache_default as default };
 
-//# sourceMappingURL=cache.mjs.map
+//# sourceMappingURL=cache2.mjs.map

package/dist/_chunks/cache2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache2.mjs","names":[],"sources":["../../src/commands/cache.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport consola from \"consola\";\nimport { getCacheDir } from \"../cache/paths.ts\";\nimport { clearStorage } from \"../cache/storage.ts\";\nimport { readLockfile, writeLockfile, pruneStale } from \"../cache/lockfile.ts\";\n\nexport default defineCommand({\n  meta: {\n    name: \"cache\",\n    description: \"Manage the registries cache\",\n  },\n  subCommands: {\n    clear: defineCommand({\n      meta: {\n        name: \"clear\",\n        description: \"Remove all cached data\",\n      },\n      async run() {\n        await clearStorage();\n        await writeLockfile({ version: 1, entries: {} });\n        consola.success(\"Cache cleared\");\n      },\n    }),\n    path: defineCommand({\n      meta: {\n        name: \"path\",\n        description: \"Show cache directory path\",\n      },\n      run() {\n        console.log(getCacheDir());\n      },\n    }),\n    status: defineCommand({\n      meta: {\n        name: \"status\",\n        description: \"Show cache status and entry count\",\n      },\n      async run() {\n        const lockfile = await readLockfile();\n        const entries = Object.values(lockfile.entries);\n        const fresh = entries.filter((e) => {\n          const expiresAt = e.fetchedAt + e.ttl * 1000;\n          return Date.now() < expiresAt;\n        });\n        const stale = entries.length - fresh.length;\n\n        consola.log(\"\");\n        consola.log(`  \\x1B[1mCache status\\x1B[0m`);\n        consola.log(`  \\x1B[90mDirectory:\\x1B[0m  ${getCacheDir()}`);\n        consola.log(\n          `  \\x1B[90mEntries:\\x1B[0m    ${entries.length} total, ${fresh.length} fresh, ${stale} stale`,\n        );\n        consola.log(\"\");\n\n        if (fresh.length > 0) {\n          // Group by ecosystem\n          const byEco = new Map<string, number>();\n          for (const e of fresh) {\n            const eco = e.key.split(\":\")[0]!;\n            byEco.set(eco, (byEco.get(eco) ?? 0) + 1);\n          }\n          for (const [eco, count] of byEco) {\n            consola.log(`  \\x1B[36m${eco}\\x1B[0m: ${count} cached`);\n          }\n          consola.log(\"\");\n        }\n      },\n    }),\n    prune: defineCommand({\n      meta: {\n        name: \"prune\",\n        description: \"Remove stale cache entries\",\n      },\n      async run() {\n        const lockfile = await readLockfile();\n        const removed = pruneStale(lockfile);\n        await writeLockfile(lockfile);\n        consola.success(`Pruned ${removed} stale entries`);\n      },\n    }),\n  },\n});\n"],"mappings":";;;AAMA,IAAA,gBAAe,cAAc;CAC3B,MAAM;EACJ,MAAM;EACN,aAAa;EACd;CACD,aAAa;EACX,OAAO,cAAc;GACnB,MAAM;IACJ,MAAM;IACN,aAAa;IACd;GACD,MAAM,MAAM;AACV,UAAM,cAAc;AACpB,UAAM,cAAc;KAAE,SAAS;KAAG,SAAS,EAAA;KAAI,CAAC;AAChD,YAAQ,QAAQ,gBAAgB;;GAEnC,CAAC;EACF,MAAM,cAAc;GAClB,MAAM;IACJ,MAAM;IACN,aAAa;IACd;GACD,MAAM;AACJ,YAAQ,IAAI,aAAa,CAAC;;GAE7B,CAAC;EACF,QAAQ,cAAc;GACpB,MAAM;IACJ,MAAM;IACN,aAAa;IACd;GACD,MAAM,MAAM;IACV,MAAM,WAAW,MAAM,cAAc;IACrC,MAAM,UAAU,OAAO,OAAO,SAAS,QAAQ;IAC/C,MAAM,QAAQ,QAAQ,QAAQ,MAAM;KAClC,MAAM,YAAY,EAAE,YAAY,EAAE,MAAM;AACxC,YAAO,KAAK,KAAK,GAAG;MACpB;IACF,MAAM,QAAQ,QAAQ,SAAS,MAAM;AAErC,YAAQ,IAAI,GAAG;AACf,YAAQ,IAAI,+BAA+B;AAC3C,YAAQ,IAAI,gCAAgC,aAAa,GAAG;AAC5D,YAAQ,IACN,gCAAgC,QAAQ,OAAO,UAAU,MAAM,OAAO,UAAU,MAAM,QACvF;AACD,YAAQ,IAAI,GAAG;AAEf,QAAI,MAAM,SAAS,GAAG;KAEpB,MAAM,wBAAQ,IAAI,KAAqB;AACvC,UAAK,MAAM,KAAK,OAAO;MACrB,MAAM,MAAM,EAAE,IAAI,MAAM,IAAI,CAAC;AAC7B,YAAM,IAAI,MAAM,MAAM,IAAI,IAAI,IAAI,KAAK,EAAE;;AAE3C,UAAK,MAAM,CAAC,KAAK,UAAU,MACzB,SAAQ,IAAI,aAAa,IAAI,WAAW,MAAM,SAAS;AAEzD,aAAQ,IAAI,GAAG;;;GAGpB,CAAC;EACF,OAAO,cAAc;GACnB,MAAM;IACJ,MAAM;IACN,aAAa;IACd;GACD,MAAM,MAAM;IACV,MAAM,WAAW,MAAM,cAAc;IACrC,MAAM,UAAU,WAAW,SAAS;AACpC,UAAM,cAAc,SAAS;AAC7B,YAAQ,QAAQ,UAAU,QAAQ,gBAAgB;;GAErD,CAAA;;CAEJ,CAAC"}

package/dist/{cache → _chunks}/cached-registry.mjs

@@ -1,6 +1,5 @@
-import { t as Registry } from "../_chunks/registry.mjs";
-import { computeIntegrity, getStorage } from "./storage.mjs";
-import { DEFAULT_TTL, cacheKey, getFreshEntry, readLockfile, setEntry, writeLockfile } from "./lockfile.mjs";
+import { t as Registry } from "./registry.mjs";
+import { c as setEntry, d as computeIntegrity, h as getStorage, l as writeLockfile, n as cacheKey, o as readLockfile, r as getFreshEntry, t as DEFAULT_TTL } from "./lockfile.mjs";
 /**
 * CachedRegistry wraps any Registry and adds caching backed by unstorage
 * with a lockfile for freshness tracking.
@@ -41,10 +40,15 @@ var CachedRegistry = class extends Registry {
 		return this.cached(name, "maintainers", void 0, () => this.inner.fetchMaintainers(name, signal), signal);
 	}
 	/**
-	* Generic cache-through method:
-	* 1. Check lockfile for fresh entry
-	* 2. If fresh -> read from storage
-	* 3. If stale/missing -> fetch, store, update lockfile
+	* 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.
 	*/
 	async cached(name, type, version, fetcher, signal, extraMeta) {
 		const key = cacheKey(this.inner.ecosystem(), name, type, version);
@@ -87,6 +91,6 @@ var CachedRegistry = class extends Registry {
 		}
 	}
 };
-export { CachedRegistry };
+export { CachedRegistry as t };
 
 //# sourceMappingURL=cached-registry.mjs.map

package/dist/_chunks/cached-registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-registry.mjs","names":[],"sources":["../../src/cache/cached-registry.ts"],"sourcesContent":["import type { Dependency, Maintainer, Package, URLBuilder, Version } from \"../core/types.ts\";\nimport { Registry } from \"../core/registry.ts\";\nimport { getStorage, computeIntegrity } from \"./storage.ts\";\nimport {\n  readLockfile,\n  writeLockfile,\n  cacheKey,\n  getFreshEntry,\n  setEntry,\n  DEFAULT_TTL,\n} from \"./lockfile.ts\";\nimport type { EntryType, LockfileEntry } from \"./lockfile.ts\";\nimport type { Storage } from \"unstorage\";\n\n/**\n * CachedRegistry wraps any Registry and adds caching backed by unstorage\n * with a lockfile for freshness tracking.\n *\n * Pass a custom `storage` to use a non-default driver (e.g. Cloudflare KV).\n * If omitted, uses the globally configured storage (see `configureStorage()`).\n */\nexport class CachedRegistry extends Registry {\n  readonly inner: Registry;\n  readonly storage: Storage;\n  private readonly lockfileStorage: Storage;\n  private readonly inflight = new Map<string, Promise<unknown>>();\n\n  constructor(inner: Registry, storage?: Storage) {\n    super();\n    this.inner = inner;\n    this.storage = storage ?? getStorage();\n    this.lockfileStorage = storage ?? getStorage();\n  }\n\n  ecosystem(): string {\n    return this.inner.ecosystem();\n  }\n\n  urls(): URLBuilder {\n    return this.inner.urls();\n  }\n\n  async fetchPackage(name: string, signal?: AbortSignal): Promise<Package> {\n    return this.cached<Package>(\n      name,\n      \"package\",\n      undefined,\n      () => this.inner.fetchPackage(name, signal),\n      signal,\n      (value) => ({ latestVersion: value.latestVersion }),\n    );\n  }\n\n  async fetchVersions(name: string, signal?: AbortSignal): Promise<Version[]> {\n    const versions = await this.cached<Version[]>(\n      name,\n      \"versions\",\n      undefined,\n      () => this.inner.fetchVersions(name, signal),\n      signal,\n    );\n    // JSON round-trip through storage turns Date objects into ISO strings.\n    // Revive them so consumers can safely call .getTime() / .toISOString().\n    return versions.map((v) => ({\n      ...v,\n      publishedAt: v.publishedAt ? new Date(v.publishedAt as unknown as string) : null,\n    }));\n  }\n\n  async fetchDependencies(\n    name: string,\n    version: string,\n    signal?: AbortSignal,\n  ): Promise<Dependency[]> {\n    return this.cached<Dependency[]>(\n      name,\n      \"dependencies\",\n      version,\n      () => this.inner.fetchDependencies(name, version, signal),\n      signal,\n    );\n  }\n\n  async fetchMaintainers(name: string, signal?: AbortSignal): Promise<Maintainer[]> {\n    return this.cached<Maintainer[]>(\n      name,\n      \"maintainers\",\n      undefined,\n      () => this.inner.fetchMaintainers(name, signal),\n      signal,\n    );\n  }\n\n  /**\n   * Read a fresh cached value or fetch and persist its replacement.\n   *\n   * @param name - Package name.\n   * @param type - Cached data type.\n   * @param version - Package version when the cache entry is versioned.\n   * @param fetcher - Upstream operation used after a cache miss.\n   * @param signal - Optional cancellation signal.\n   * @param extraMeta - Optional lockfile metadata derived from the fetched value.\n   * @returns {Promise<T>} The cached or freshly fetched value.\n   */\n  private async cached<T>(\n    name: string,\n    type: EntryType,\n    version: string | undefined,\n    fetcher: () => Promise<T>,\n    signal: AbortSignal | undefined,\n    extraMeta?: (value: T) => Record<string, unknown>,\n  ): Promise<T> {\n    const eco = this.inner.ecosystem();\n    const key = cacheKey(eco, name, type, version);\n    const storageKey = key;\n\n    // 1. Check lockfile\n    const lockfile = await readLockfile(this.lockfileStorage);\n    const entry = getFreshEntry(lockfile, key);\n\n    if (entry) {\n      // 2. Read from storage\n      const cached = await this.storage.getItem<T>(storageKey);\n      if (cached !== null) {\n        // Verify integrity\n        const currentHash = computeIntegrity(cached);\n        if (currentHash === entry.integrity) {\n          return cached;\n        }\n        // Integrity mismatch - refetch\n      }\n    }\n\n    // 3. Coalesce concurrent fetches for the same key (single-flight).\n    // Skip dedup when caller provides an AbortSignal to avoid sharing\n    // cancellation context across unrelated callers.\n    if (!signal) {\n      const pending = this.inflight.get(key);\n      if (pending) {\n        return pending as Promise<T>;\n      }\n    }\n\n    const flight = (async () => {\n      const value = await fetcher();\n\n      // Persist to cache (best-effort - storage failures must not discard fetched data)\n      const meta = extraMeta ? extraMeta(value) : {};\n      const newEntry: LockfileEntry = {\n        key,\n        type,\n        fetchedAt: Date.now(),\n        ttl: DEFAULT_TTL[type],\n        integrity: computeIntegrity(value),\n        ...(\"latestVersion\" in meta ? { latestVersion: meta[\"latestVersion\"] as string } : {}),\n      };\n      try {\n        await this.storage.setItem(storageKey, value as Record<string, unknown>);\n        // Re-read lockfile before writing to avoid overwriting entries\n        // added by concurrent calls for different keys.\n        const freshLockfile = await readLockfile(this.lockfileStorage);\n        setEntry(freshLockfile, newEntry);\n        await writeLockfile(freshLockfile, this.lockfileStorage);\n      } catch {\n        // Storage I/O failed (disk full, permissions, remote driver timeout, etc.).\n        // The data was already fetched successfully - return it anyway.\n      }\n\n      return value;\n    })();\n\n    if (!signal) {\n      this.inflight.set(key, flight);\n    }\n    try {\n      return await flight;\n    } finally {\n      if (!signal) {\n        this.inflight.delete(key);\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AAqBA,IAAa,iBAAb,cAAoC,SAAS;CAC3C;CACA;CACA;CACA,2BAA4B,IAAI,KAA+B;CAE/D,YAAY,OAAiB,SAAmB;AAC9C,SAAO;AACP,OAAK,QAAQ;AACb,OAAK,UAAU,WAAW,YAAY;AACtC,OAAK,kBAAkB,WAAW,YAAY;;CAGhD,YAAoB;AAClB,SAAO,KAAK,MAAM,WAAW;;CAG/B,OAAmB;AACjB,SAAO,KAAK,MAAM,MAAM;;CAG1B,MAAM,aAAa,MAAc,QAAwC;AACvE,SAAO,KAAK,OACV,MACA,WACA,KAAA,SACM,KAAK,MAAM,aAAa,MAAM,OAAO,EAC3C,SACC,WAAW,EAAE,eAAe,MAAM,eAAe,EACnD;;CAGH,MAAM,cAAc,MAAc,QAA0C;AAU1E,UATiB,MAAM,KAAK,OAC1B,MACA,YACA,KAAA,SACM,KAAK,MAAM,cAAc,MAAM,OAAO,EAC5C,OACD,EAGe,KAAK,OAAO;GAC1B,GAAG;GACH,aAAa,EAAE,cAAc,IAAI,KAAK,EAAE,YAAiC,GAAG;GAC7E,EAAE;;CAGL,MAAM,kBACJ,MACA,SACA,QACuB;AACvB,SAAO,KAAK,OACV,MACA,gBACA,eACM,KAAK,MAAM,kBAAkB,MAAM,SAAS,OAAO,EACzD,OACD;;CAGH,MAAM,iBAAiB,MAAc,QAA6C;AAChF,SAAO,KAAK,OACV,MACA,eACA,KAAA,SACM,KAAK,MAAM,iBAAiB,MAAM,OAAO,EAC/C,OACD;;;;;;;;;;;;;CAcH,MAAc,OACZ,MACA,MACA,SACA,SACA,QACA,WACY;EAEZ,MAAM,MAAM,SADA,KAAK,MAAM,WAAW,EACR,MAAM,MAAM,QAAQ;EAC9C,MAAM,aAAa;EAInB,MAAM,QAAQ,cADG,MAAM,aAAa,KAAK,gBAAgB,EACnB,IAAI;AAE1C,MAAI,OAAO;GAET,MAAM,SAAS,MAAM,KAAK,QAAQ,QAAW,WAAW;AACxD,OAAI,WAAW;QAEO,iBAAiB,OAAO,KACxB,MAAM,UACxB,QAAO;;;AASb,MAAI,CAAC,QAAQ;GACX,MAAM,UAAU,KAAK,SAAS,IAAI,IAAI;AACtC,OAAI,QACF,QAAO;;EAIX,MAAM,UAAU,YAAY;GAC1B,MAAM,QAAQ,MAAM,SAAS;GAG7B,MAAM,OAAO,YAAY,UAAU,MAAM,GAAG,EAAE;GAC9C,MAAM,WAA0B;IAC9B;IACA;IACA,WAAW,KAAK,KAAK;IACrB,KAAK,YAAY;IACjB,WAAW,iBAAiB,MAAM;IAClC,GAAI,mBAAmB,OAAO,EAAE,eAAe,KAAK,kBAA4B,GAAG,EAAA;IACpF;AACD,OAAI;AACF,UAAM,KAAK,QAAQ,QAAQ,YAAY,MAAiC;IAGxE,MAAM,gBAAgB,MAAM,aAAa,KAAK,gBAAgB;AAC9D,aAAS,eAAe,SAAS;AACjC,UAAM,cAAc,eAAe,KAAK,gBAAgB;WAClD;AAKR,UAAO;MACL;AAEJ,MAAI,CAAC,OACH,MAAK,SAAS,IAAI,KAAK,OAAO;AAEhC,MAAI;AACF,UAAO,MAAM;YACL;AACR,OAAI,CAAC,OACH,MAAK,SAAS,OAAO,IAAI"}

package/dist/{commands → _chunks}/deps.mjs

@@ -1,7 +1,8 @@
-import "../_chunks/registry.mjs";
-import "../_chunks/purl.mjs";
-import "../_chunks/registries.mjs";
-import { resolvePURL, sharedArgs, withErrorHandling } from "./shared.mjs";
+import "./registry.mjs";
+import "./registries.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";
 var deps_default = defineCommand({
@@ -27,7 +28,7 @@ var deps_default = defineCommand({
 					consola.info("Example: pkg:npm/lodash@4.17.21");
 					process.exit(1);
 				}
-				consola.info(`No version specified, using latest: ${pkg.latestVersion}`);
+				if (!args.json) consola.info(`No version specified, using latest: ${pkg.latestVersion}`);
 				const deps = await reg.fetchDependencies(name, pkg.latestVersion);
 				outputDeps(name, pkg.latestVersion, deps, args.json);
 				return;
@@ -42,14 +43,9 @@ function outputDeps(name, version, deps, json) {
 		return;
 	}
 	consola.log("");
-	consola.log(`  \x1b[1m${name}@${version}\x1b[0m — ${deps.length} dependenc${deps.length === 1 ? "y" : "ies"}`);
+	consola.log(`  \x1B[1m${name}@${version}\x1B[0m — ${deps.length} dependenc${deps.length === 1 ? "y" : "ies"}`);
 	consola.log("");
-	const byScope = /* @__PURE__ */ new Map();
-	for (const dep of deps) {
-		const scope = dep.scope || "runtime";
-		if (!byScope.has(scope)) byScope.set(scope, []);
-		byScope.get(scope).push(dep);
-	}
+	const byScope = groupByScope(deps);
 	const scopeColors = {
 		runtime: "\x1B[32m",
 		development: "\x1B[33m",
@@ -59,14 +55,24 @@ function outputDeps(name, version, deps, json) {
 	};
 	for (const [scope, scopeDeps] of byScope) {
 		const color = scopeColors[scope] ?? "\x1B[0m";
-		consola.log(`  ${color}${scope}\x1b[0m (${scopeDeps.length})`);
+		consola.log(`  ${color}${scope}\x1B[0m (${scopeDeps.length})`);
 		for (const dep of scopeDeps) {
 			const opt = dep.optional ? " \x1B[90m(optional)\x1B[0m" : "";
-			consola.log(`    ${dep.name} \x1b[90m${dep.requirements}\x1b[0m${opt}`);
+			consola.log(`    ${dep.name} \x1B[90m${dep.requirements}\x1B[0m${opt}`);
 		}
 		consola.log("");
 	}
 }
+function groupByScope(deps) {
+	const byScope = /* @__PURE__ */ new Map();
+	for (const dep of deps) {
+		const scope = dep.scope || "runtime";
+		const scopeDeps = byScope.get(scope) ?? [];
+		scopeDeps.push(dep);
+		byScope.set(scope, scopeDeps);
+	}
+	return byScope;
+}
 export { deps_default as default };
 
 //# sourceMappingURL=deps.mjs.map

package/dist/_chunks/deps.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.mjs","names":[],"sources":["../../src/commands/deps.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: \"deps\",\n    description: \"List package dependencies\",\n  },\n  args: {\n    ...sharedArgs,\n    purl: {\n      type: \"positional\",\n      description: \"Package PURL with version (e.g. pkg:npm/lodash@4.17.21, cargo/serde@1.0)\",\n      required: true,\n    },\n  },\n  async run({ args }) {\n    await withErrorHandling(async () => {\n      const [reg, name, version] = resolvePURL(args.purl, !args[\"no-cache\"]);\n\n      if (!version) {\n        // Try to resolve latest version\n        const pkg = await reg.fetchPackage(name);\n        if (!pkg.latestVersion) {\n          consola.error(\n            \"PURL must include a version for dependency lookup, and no latest version found.\",\n          );\n          consola.info(\"Example: pkg:npm/lodash@4.17.21\");\n          process.exit(1);\n        }\n        if (!args.json) {\n          consola.info(`No version specified, using latest: ${pkg.latestVersion}`);\n        }\n        const deps = await reg.fetchDependencies(name, pkg.latestVersion);\n        outputDeps(name, pkg.latestVersion, deps, args.json);\n        return;\n      }\n\n      const deps = await reg.fetchDependencies(name, version);\n      outputDeps(name, version, deps, args.json);\n    });\n  },\n});\n\nimport type { Dependency } from \"../core/types.ts\";\n\nfunction outputDeps(\n  name: string,\n  version: string,\n  deps: readonly Dependency[],\n  json: boolean,\n): void {\n  if (json) {\n    console.log(JSON.stringify(deps, null, 2));\n    return;\n  }\n\n  consola.log(\"\");\n  consola.log(\n    `  \\x1B[1m${name}@${version}\\x1B[0m — ${deps.length} dependenc${deps.length === 1 ? \"y\" : \"ies\"}`,\n  );\n  consola.log(\"\");\n\n  const byScope = groupByScope(deps);\n\n  const scopeColors: Record<string, string> = {\n    runtime: \"\\x1B[32m\",\n    development: \"\\x1B[33m\",\n    build: \"\\x1B[35m\",\n    test: \"\\x1B[36m\",\n    optional: \"\\x1B[90m\",\n  };\n\n  for (const [scope, scopeDeps] of byScope) {\n    const color = scopeColors[scope] ?? \"\\x1B[0m\";\n    consola.log(`  ${color}${scope}\\x1B[0m (${scopeDeps.length})`);\n    for (const dep of scopeDeps) {\n      const opt = dep.optional ? \" \\x1B[90m(optional)\\x1B[0m\" : \"\";\n      consola.log(`    ${dep.name} \\x1B[90m${dep.requirements}\\x1B[0m${opt}`);\n    }\n    consola.log(\"\");\n  }\n}\n\nfunction groupByScope(deps: readonly Dependency[]): Map<string, Dependency[]> {\n  const byScope = new Map<string, Dependency[]>();\n\n  for (const dep of deps) {\n    const scope = dep.scope || \"runtime\";\n    const scopeDeps = byScope.get(scope) ?? [];\n    scopeDeps.push(dep);\n    byScope.set(scope, scopeDeps);\n  }\n\n  return byScope;\n}\n"],"mappings":";;;;;;;AAIA,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,MAAM,WAAW,YAAY,KAAK,MAAM,CAAC,KAAK,YAAY;AAEtE,OAAI,CAAC,SAAS;IAEZ,MAAM,MAAM,MAAM,IAAI,aAAa,KAAK;AACxC,QAAI,CAAC,IAAI,eAAe;AACtB,aAAQ,MACN,kFACD;AACD,aAAQ,KAAK,kCAAkC;AAC/C,aAAQ,KAAK,EAAE;;AAEjB,QAAI,CAAC,KAAK,KACR,SAAQ,KAAK,uCAAuC,IAAI,gBAAgB;IAE1E,MAAM,OAAO,MAAM,IAAI,kBAAkB,MAAM,IAAI,cAAc;AACjE,eAAW,MAAM,IAAI,eAAe,MAAM,KAAK,KAAK;AACpD;;AAIF,cAAW,MAAM,SADJ,MAAM,IAAI,kBAAkB,MAAM,QAAQ,EACvB,KAAK,KAAK;IAC1C;;CAEL,CAAC;AAIF,SAAS,WACP,MACA,SACA,MACA,MACM;AACN,KAAI,MAAM;AACR,UAAQ,IAAI,KAAK,UAAU,MAAM,MAAM,EAAE,CAAC;AAC1C;;AAGF,SAAQ,IAAI,GAAG;AACf,SAAQ,IACN,YAAY,KAAK,GAAG,QAAQ,YAAY,KAAK,OAAO,YAAY,KAAK,WAAW,IAAI,MAAM,QAC3F;AACD,SAAQ,IAAI,GAAG;CAEf,MAAM,UAAU,aAAa,KAAK;CAElC,MAAM,cAAsC;EAC1C,SAAS;EACT,aAAa;EACb,OAAO;EACP,MAAM;EACN,UAAU;EACX;AAED,MAAK,MAAM,CAAC,OAAO,cAAc,SAAS;EACxC,MAAM,QAAQ,YAAY,UAAU;AACpC,UAAQ,IAAI,KAAK,QAAQ,MAAM,WAAW,UAAU,OAAO,GAAG;AAC9D,OAAK,MAAM,OAAO,WAAW;GAC3B,MAAM,MAAM,IAAI,WAAW,+BAA+B;AAC1D,WAAQ,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,aAAa,SAAS,MAAM;;AAEzE,UAAQ,IAAI,GAAG;;;AAInB,SAAS,aAAa,MAAwD;CAC5E,MAAM,0BAAU,IAAI,KAA2B;AAE/C,MAAK,MAAM,OAAO,MAAM;EACtB,MAAM,QAAQ,IAAI,SAAS;EAC3B,MAAM,YAAY,QAAQ,IAAI,MAAM,IAAI,EAAE;AAC1C,YAAU,KAAK,IAAI;AACnB,UAAQ,IAAI,OAAO,UAAU;;AAG/B,QAAO"}

package/dist/_chunks/helpers.mjs

@@ -1,28 +1,62 @@
 import { l as InvalidPURLError } from "./registry.mjs";
-import { n as createFromPURL } from "./purl.mjs";
-/** Fetch normalized package metadata from a PURL. */
+import { c as createFromPURL } from "./registries.mjs";
+/**
+* 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.
+*/
 async function fetchPackageFromPURL(purl, signal, client) {
 	const [reg, name] = createFromPURL(purl, client);
 	return reg.fetchPackage(name, signal);
 }
-/** Fetch all versions from a PURL. */
+/**
+* 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.
+*/
 async function fetchVersionsFromPURL(purl, signal, client) {
 	const [reg, name] = createFromPURL(purl, client);
 	return reg.fetchVersions(name, signal);
 }
-/** Fetch dependencies for a specific version from a PURL. */
+/**
+* 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.
+*/
 async function fetchDependenciesFromPURL(purl, signal, client) {
 	const [reg, name, version] = createFromPURL(purl, client);
 	if (!version) throw new InvalidPURLError(purl, "must include a version for dependency lookup");
 	return reg.fetchDependencies(name, version, signal);
 }
-/** Fetch maintainers from a PURL. */
+/**
+* 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.
+*/
 async function fetchMaintainersFromPURL(purl, signal, client) {
 	const [reg, name] = createFromPURL(purl, client);
 	return reg.fetchMaintainers(name, signal);
 }
 const DEFAULT_CONCURRENCY = 15;
-/** Bulk fetch packages from multiple PURLs, with concurrency limit. */
+/**
+* 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.
+*/
 async function bulkFetchPackages(purls, options) {
 	const concurrency = options?.concurrency ?? DEFAULT_CONCURRENCY;
 	const results = /* @__PURE__ */ new Map();
@@ -44,14 +78,11 @@ async function bulkFetchPackages(purls, options) {
 	return results;
 }
 /**
-* Select the best matching version from a list.
-*
-* Resolution order:
-* 1. Exact match for `requested` (non-yanked/deprecated/retracted)
-* 2. Exact match for `latest` (non-yanked/deprecated/retracted)
-* 3. Newest available version with no negative status (by publishedAt)
+* Select an exact requested or latest version, then the newest usable one.
 *
-* Returns `null` when no usable version exists.
+* @param versions - Candidate versions.
+* @param options - Optional requested and latest version numbers.
+* @returns {Version | null} The selected version, or null.
 */
 function selectVersion(versions, options) {
 	const { requested, latest } = options ?? {};
@@ -74,18 +105,21 @@ function selectVersion(versions, options) {
 /**
 * Resolve the best documentation URL for a package.
 *
-* Fallback chain:
-* 1. `package.documentation` (explicit docs URL from registry)
-* 2. `package.homepage` (project homepage)
-* 3. `urls.documentation()` (ecosystem default, e.g. docs.rs, rubydoc.info)
+* @param pkg - Package metadata.
+* @param urls - Ecosystem URL builder.
+* @param version - Optional package version.
+* @returns {string} The explicit, homepage, or ecosystem documentation URL.
 */
 function resolveDocsUrl(pkg, urls, version) {
 	return pkg.documentation || pkg.homepage || urls.documentation(pkg.name, version);
 }
 /**
-* Resolve the best README URL for a package.
+* Resolve the ecosystem README URL for a package.
 *
-* Returns the ecosystem-specific URL where the package README can be fetched.
+* @param pkg - Package metadata.
+* @param urls - Ecosystem URL builder.
+* @param version - Optional package version.
+* @returns {string} The README URL.
 */
 function resolveReadmeUrl(pkg, urls, version) {
 	return urls.readme(pkg.name, version);

package/dist/_chunks/helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/helpers.ts"],"sourcesContent":["import type { Package, Version, Dependency, Maintainer, URLBuilder } from \"./core/types.ts\";\nimport type { Client } from \"./core/client.ts\";\nimport { createFromPURL } from \"./core/purl.ts\";\nimport { InvalidPURLError } from \"./core/errors.ts\";\n\n/** Fetch normalized package metadata from a PURL. */\nexport async function fetchPackageFromPURL(\n  purl: string,\n  signal?: AbortSignal,\n  client?: Client,\n): Promise<Package> {\n  const [reg, name] = createFromPURL(purl, client);\n  return reg.fetchPackage(name, signal);\n}\n\n/** Fetch all versions from a PURL. */\nexport async function fetchVersionsFromPURL(\n  purl: string,\n  signal?: AbortSignal,\n  client?: Client,\n): Promise<Version[]> {\n  const [reg, name] = createFromPURL(purl, client);\n  return reg.fetchVersions(name, signal);\n}\n\n/** Fetch dependencies for a specific version from a PURL. */\nexport async function fetchDependenciesFromPURL(\n  purl: string,\n  signal?: AbortSignal,\n  client?: Client,\n): Promise<Dependency[]> {\n  const [reg, name, version] = createFromPURL(purl, client);\n  if (!version) {\n    throw new InvalidPURLError(purl, \"must include a version for dependency lookup\");\n  }\n  return reg.fetchDependencies(name, version, signal);\n}\n\n/** Fetch maintainers from a PURL. */\nexport async function fetchMaintainersFromPURL(\n  purl: string,\n  signal?: AbortSignal,\n  client?: Client,\n): Promise<Maintainer[]> {\n  const [reg, name] = createFromPURL(purl, client);\n  return reg.fetchMaintainers(name, signal);\n}\n\nconst DEFAULT_CONCURRENCY = 15;\n\n/** Bulk fetch packages from multiple PURLs, with concurrency limit. */\nexport async function bulkFetchPackages(\n  purls: string[],\n  options?: { concurrency?: number; signal?: AbortSignal; client?: Client },\n): Promise<Map<string, Package>> {\n  const concurrency = options?.concurrency ?? DEFAULT_CONCURRENCY;\n  const results = new Map<string, Package>();\n  const queue = [...purls];\n\n  const signal = options?.signal;\n\n  const workers = Array.from({ length: Math.min(concurrency, queue.length) }, async () => {\n    while (queue.length > 0) {\n      if (signal?.aborted) break;\n\n      const purl = queue.shift()!;\n      try {\n        const pkg = await fetchPackageFromPURL(purl, signal, options?.client);\n        results.set(purl, pkg);\n      } catch {\n        if (signal?.aborted) break;\n        // Silently skip failed lookups — absent from results map\n      }\n    }\n  });\n\n  await Promise.all(workers);\n  return results;\n}\n\n/**\n * Select the best matching version from a list.\n *\n * Resolution order:\n * 1. Exact match for `requested` (non-yanked/deprecated/retracted)\n * 2. Exact match for `latest` (non-yanked/deprecated/retracted)\n * 3. Newest available version with no negative status (by publishedAt)\n *\n * Returns `null` when no usable version exists.\n */\nexport function selectVersion(\n  versions: Version[],\n  options?: {\n    requested?: string;\n    latest?: string;\n  },\n): Version | null {\n  const { requested, latest } = options ?? {};\n\n  if (requested) {\n    const exact = versions.find((v) => v.number === requested && v.status === \"\");\n    if (exact) return exact;\n  }\n\n  if (latest) {\n    const latestV = versions.find((v) => v.number === latest && v.status === \"\");\n    if (latestV) return latestV;\n  }\n\n  const usable = versions.filter((v) => v.status === \"\");\n  if (usable.length === 0) return null;\n\n  usable.sort((a, b) => {\n    const at = a.publishedAt?.getTime() ?? 0;\n    const bt = b.publishedAt?.getTime() ?? 0;\n    return bt - at;\n  });\n\n  return usable[0] ?? null;\n}\n\n/**\n * Resolve the best documentation URL for a package.\n *\n * Fallback chain:\n * 1. `package.documentation` (explicit docs URL from registry)\n * 2. `package.homepage` (project homepage)\n * 3. `urls.documentation()` (ecosystem default, e.g. docs.rs, rubydoc.info)\n */\nexport function resolveDocsUrl(pkg: Package, urls: URLBuilder, version?: string): string {\n  return pkg.documentation || pkg.homepage || urls.documentation(pkg.name, version);\n}\n\n/**\n * Resolve the best README URL for a package.\n *\n * Returns the ecosystem-specific URL where the package README can be fetched.\n */\nexport function resolveReadmeUrl(pkg: Package, urls: URLBuilder, version?: string): string {\n  return urls.readme(pkg.name, version);\n}\n"],"mappings":";;;AAMA,eAAsB,qBACpB,MACA,QACA,QACkB;CAClB,MAAM,CAAC,KAAK,QAAQ,eAAe,MAAM,OAAO;AAChD,QAAO,IAAI,aAAa,MAAM,OAAO;;;AAIvC,eAAsB,sBACpB,MACA,QACA,QACoB;CACpB,MAAM,CAAC,KAAK,QAAQ,eAAe,MAAM,OAAO;AAChD,QAAO,IAAI,cAAc,MAAM,OAAO;;;AAIxC,eAAsB,0BACpB,MACA,QACA,QACuB;CACvB,MAAM,CAAC,KAAK,MAAM,WAAW,eAAe,MAAM,OAAO;AACzD,KAAI,CAAC,QACH,OAAM,IAAI,iBAAiB,MAAM,+CAA+C;AAElF,QAAO,IAAI,kBAAkB,MAAM,SAAS,OAAO;;;AAIrD,eAAsB,yBACpB,MACA,QACA,QACuB;CACvB,MAAM,CAAC,KAAK,QAAQ,eAAe,MAAM,OAAO;AAChD,QAAO,IAAI,iBAAiB,MAAM,OAAO;;AAG3C,MAAM,sBAAsB;;AAG5B,eAAsB,kBACpB,OACA,SAC+B;CAC/B,MAAM,cAAc,SAAS,eAAe;CAC5C,MAAM,0BAAU,IAAI,KAAsB;CAC1C,MAAM,QAAQ,CAAC,GAAG,MAAM;CAExB,MAAM,SAAS,SAAS;CAExB,MAAM,UAAU,MAAM,KAAK,EAAE,QAAQ,KAAK,IAAI,aAAa,MAAM,OAAO,EAAE,EAAE,YAAY;AACtF,SAAO,MAAM,SAAS,GAAG;AACvB,OAAI,QAAQ,QAAS;GAErB,MAAM,OAAO,MAAM,OAAO;AAC1B,OAAI;IACF,MAAM,MAAM,MAAM,qBAAqB,MAAM,QAAQ,SAAS,OAAO;AACrE,YAAQ,IAAI,MAAM,IAAI;WAChB;AACN,QAAI,QAAQ,QAAS;;;GAIzB;AAEF,OAAM,QAAQ,IAAI,QAAQ;AAC1B,QAAO;;;;;;;;;;;;AAaT,SAAgB,cACd,UACA,SAIgB;CAChB,MAAM,EAAE,WAAW,WAAW,WAAW,EAAE;AAE3C,KAAI,WAAW;EACb,MAAM,QAAQ,SAAS,MAAM,MAAM,EAAE,WAAW,aAAa,EAAE,WAAW,GAAG;AAC7E,MAAI,MAAO,QAAO;;AAGpB,KAAI,QAAQ;EACV,MAAM,UAAU,SAAS,MAAM,MAAM,EAAE,WAAW,UAAU,EAAE,WAAW,GAAG;AAC5E,MAAI,QAAS,QAAO;;CAGtB,MAAM,SAAS,SAAS,QAAQ,MAAM,EAAE,WAAW,GAAG;AACtD,KAAI,OAAO,WAAW,EAAG,QAAO;AAEhC,QAAO,MAAM,GAAG,MAAM;EACpB,MAAM,KAAK,EAAE,aAAa,SAAS,IAAI;AAEvC,UADW,EAAE,aAAa,SAAS,IAAI,KAC3B;GACZ;AAEF,QAAO,OAAO,MAAM;;;;;;;;;;AAWtB,SAAgB,eAAe,KAAc,MAAkB,SAA0B;AACvF,QAAO,IAAI,iBAAiB,IAAI,YAAY,KAAK,cAAc,IAAI,MAAM,QAAQ;;;;;;;AAQnF,SAAgB,iBAAiB,KAAc,MAAkB,SAA0B;AACzF,QAAO,KAAK,OAAO,IAAI,MAAM,QAAQ"}
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/helpers.ts"],"sourcesContent":["import type { Package, Version, Dependency, Maintainer, URLBuilder } from \"./core/types.ts\";\nimport type { Client } from \"./core/client.ts\";\nimport { createFromPURL } from \"./core/purl.ts\";\nimport { InvalidPURLError } from \"./core/errors.ts\";\n\n/**\n * Fetch normalized package metadata from a package URL.\n *\n * @param purl - Package URL.\n * @param signal - Optional cancellation signal.\n * @param client - Optional HTTP client.\n * @returns {Promise<Package>} Normalized package metadata.\n */\nexport async function fetchPackageFromPURL(\n  purl: string,\n  signal?: AbortSignal,\n  client?: Client,\n): Promise<Package> {\n  const [reg, name] = createFromPURL(purl, client);\n  return reg.fetchPackage(name, signal);\n}\n\n/**\n * Fetch all versions from a package URL.\n *\n * @param purl - Package URL.\n * @param signal - Optional cancellation signal.\n * @param client - Optional HTTP client.\n * @returns {Promise<Version[]>} Normalized versions.\n */\nexport async function fetchVersionsFromPURL(\n  purl: string,\n  signal?: AbortSignal,\n  client?: Client,\n): Promise<Version[]> {\n  const [reg, name] = createFromPURL(purl, client);\n  return reg.fetchVersions(name, signal);\n}\n\n/**\n * Fetch dependencies for a versioned package URL.\n *\n * @param purl - Versioned package URL.\n * @param signal - Optional cancellation signal.\n * @param client - Optional HTTP client.\n * @returns {Promise<Dependency[]>} Normalized dependencies.\n */\nexport async function fetchDependenciesFromPURL(\n  purl: string,\n  signal?: AbortSignal,\n  client?: Client,\n): Promise<Dependency[]> {\n  const [reg, name, version] = createFromPURL(purl, client);\n  if (!version) {\n    throw new InvalidPURLError(purl, \"must include a version for dependency lookup\");\n  }\n  return reg.fetchDependencies(name, version, signal);\n}\n\n/**\n * Fetch maintainers from a package URL.\n *\n * @param purl - Package URL.\n * @param signal - Optional cancellation signal.\n * @param client - Optional HTTP client.\n * @returns {Promise<Maintainer[]>} Normalized maintainers.\n */\nexport async function fetchMaintainersFromPURL(\n  purl: string,\n  signal?: AbortSignal,\n  client?: Client,\n): Promise<Maintainer[]> {\n  const [reg, name] = createFromPURL(purl, client);\n  return reg.fetchMaintainers(name, signal);\n}\n\nconst DEFAULT_CONCURRENCY = 15;\n\n/**\n * Fetch packages concurrently, skipping failed lookups.\n *\n * @param purls - Package URLs to fetch.\n * @param options - Optional concurrency, cancellation, and client settings.\n * @returns {Promise<Map<string, Package>>} Results keyed by package URL.\n */\nexport async function bulkFetchPackages(\n  purls: readonly string[],\n  options?: Readonly<{ concurrency?: number; signal?: AbortSignal; client?: Client }>,\n): Promise<Map<string, Package>> {\n  const concurrency = options?.concurrency ?? DEFAULT_CONCURRENCY;\n  const results = new Map<string, Package>();\n  const queue = [...purls];\n\n  const signal = options?.signal;\n\n  const workers = Array.from({ length: Math.min(concurrency, queue.length) }, async () => {\n    while (queue.length > 0) {\n      if (signal?.aborted) break;\n\n      const purl = queue.shift()!;\n      try {\n        const pkg = await fetchPackageFromPURL(purl, signal, options?.client);\n        results.set(purl, pkg);\n      } catch {\n        if (signal?.aborted) break;\n        // Silently skip failed lookups — absent from results map\n      }\n    }\n  });\n\n  await Promise.all(workers);\n  return results;\n}\n\n/**\n * Select an exact requested or latest version, then the newest usable one.\n *\n * @param versions - Candidate versions.\n * @param options - Optional requested and latest version numbers.\n * @returns {Version | null} The selected version, or null.\n */\nexport function selectVersion(\n  versions: readonly Version[],\n  options?: Readonly<{\n    requested?: string;\n    latest?: string;\n  }>,\n): Version | null {\n  const { requested, latest } = options ?? {};\n\n  if (requested) {\n    const exact = versions.find((v) => v.number === requested && v.status === \"\");\n    if (exact) return exact;\n  }\n\n  if (latest) {\n    const latestV = versions.find((v) => v.number === latest && v.status === \"\");\n    if (latestV) return latestV;\n  }\n\n  const usable = versions.filter((v) => v.status === \"\");\n  if (usable.length === 0) return null;\n\n  usable.sort((a, b) => {\n    const at = a.publishedAt?.getTime() ?? 0;\n    const bt = b.publishedAt?.getTime() ?? 0;\n    return bt - at;\n  });\n\n  return usable[0] ?? null;\n}\n\n/**\n * Resolve the best documentation URL for a package.\n *\n * @param pkg - Package metadata.\n * @param urls - Ecosystem URL builder.\n * @param version - Optional package version.\n * @returns {string} The explicit, homepage, or ecosystem documentation URL.\n */\nexport function resolveDocsUrl(pkg: Package, urls: URLBuilder, version?: string): string {\n  return pkg.documentation || pkg.homepage || urls.documentation(pkg.name, version);\n}\n\n/**\n * Resolve the ecosystem README URL for a package.\n *\n * @param pkg - Package metadata.\n * @param urls - Ecosystem URL builder.\n * @param version - Optional package version.\n * @returns {string} The README URL.\n */\nexport function resolveReadmeUrl(pkg: Package, urls: URLBuilder, version?: string): string {\n  return urls.readme(pkg.name, version);\n}\n"],"mappings":";;;;;;;;;;AAaA,eAAsB,qBACpB,MACA,QACA,QACkB;CAClB,MAAM,CAAC,KAAK,QAAQ,eAAe,MAAM,OAAO;AAChD,QAAO,IAAI,aAAa,MAAM,OAAO;;;;;;;;;;AAWvC,eAAsB,sBACpB,MACA,QACA,QACoB;CACpB,MAAM,CAAC,KAAK,QAAQ,eAAe,MAAM,OAAO;AAChD,QAAO,IAAI,cAAc,MAAM,OAAO;;;;;;;;;;AAWxC,eAAsB,0BACpB,MACA,QACA,QACuB;CACvB,MAAM,CAAC,KAAK,MAAM,WAAW,eAAe,MAAM,OAAO;AACzD,KAAI,CAAC,QACH,OAAM,IAAI,iBAAiB,MAAM,+CAA+C;AAElF,QAAO,IAAI,kBAAkB,MAAM,SAAS,OAAO;;;;;;;;;;AAWrD,eAAsB,yBACpB,MACA,QACA,QACuB;CACvB,MAAM,CAAC,KAAK,QAAQ,eAAe,MAAM,OAAO;AAChD,QAAO,IAAI,iBAAiB,MAAM,OAAO;;AAG3C,MAAM,sBAAsB;;;;;;;;AAS5B,eAAsB,kBACpB,OACA,SAC+B;CAC/B,MAAM,cAAc,SAAS,eAAe;CAC5C,MAAM,0BAAU,IAAI,KAAsB;CAC1C,MAAM,QAAQ,CAAC,GAAG,MAAM;CAExB,MAAM,SAAS,SAAS;CAExB,MAAM,UAAU,MAAM,KAAK,EAAE,QAAQ,KAAK,IAAI,aAAa,MAAM,OAAO,EAAE,EAAE,YAAY;AACtF,SAAO,MAAM,SAAS,GAAG;AACvB,OAAI,QAAQ,QAAS;GAErB,MAAM,OAAO,MAAM,OAAO;AAC1B,OAAI;IACF,MAAM,MAAM,MAAM,qBAAqB,MAAM,QAAQ,SAAS,OAAO;AACrE,YAAQ,IAAI,MAAM,IAAI;WAChB;AACN,QAAI,QAAQ,QAAS;;;GAIzB;AAEF,OAAM,QAAQ,IAAI,QAAQ;AAC1B,QAAO;;;;;;;;;AAUT,SAAgB,cACd,UACA,SAIgB;CAChB,MAAM,EAAE,WAAW,WAAW,WAAW,EAAE;AAE3C,KAAI,WAAW;EACb,MAAM,QAAQ,SAAS,MAAM,MAAM,EAAE,WAAW,aAAa,EAAE,WAAW,GAAG;AAC7E,MAAI,MAAO,QAAO;;AAGpB,KAAI,QAAQ;EACV,MAAM,UAAU,SAAS,MAAM,MAAM,EAAE,WAAW,UAAU,EAAE,WAAW,GAAG;AAC5E,MAAI,QAAS,QAAO;;CAGtB,MAAM,SAAS,SAAS,QAAQ,MAAM,EAAE,WAAW,GAAG;AACtD,KAAI,OAAO,WAAW,EAAG,QAAO;AAEhC,QAAO,MAAM,GAAG,MAAM;EACpB,MAAM,KAAK,EAAE,aAAa,SAAS,IAAI;AAEvC,UADW,EAAE,aAAa,SAAS,IAAI,KAC3B;GACZ;AAEF,QAAO,OAAO,MAAM;;;;;;;;;;AAWtB,SAAgB,eAAe,KAAc,MAAkB,SAA0B;AACvF,QAAO,IAAI,iBAAiB,IAAI,YAAY,KAAK,cAAc,IAAI,MAAM,QAAQ;;;;;;;;;;AAWnF,SAAgB,iBAAiB,KAAc,MAAkB,SAA0B;AACzF,QAAO,KAAK,OAAO,IAAI,MAAM,QAAQ"}

package/dist/_chunks/index.d.mts

@@ -1,5 +1,4 @@
-import { c as URLBuilder, i as Package, l as Version, n as Dependency, r as Maintainer } from "./types.mjs";
-import { o as Client, t as Registry } from "./registry.mjs";
+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";
 
 //#region src/registries/npm.d.ts
 /** npm registry client. */
@@ -13,13 +12,12 @@ declare class NpmRegistry extends Registry {
   fetchDependencies(name: string, version: string, signal?: AbortSignal): Promise<Dependency[]>;
   fetchMaintainers(name: string, signal?: AbortSignal): Promise<Maintainer[]>;
   urls(): URLBuilder;
-  /** Build a stable dedup key. Prefers email (unique per account), falls back to name. */
+  private mapDependencies;
+  private collectMaintainers;
+  private toMaintainer;
   private maintainerKey;
-  /** Encode package name for URL (handle scoped packages). */
   private encodeName;
-  /** Extract namespace from scoped package name. */
   private extractNamespace;
-  /** Extract and normalize license. */
   private extractLicense;
 }
 //#endregion
@@ -50,17 +48,14 @@ declare class PyPIRegistry extends Registry {
   fetchDependencies(name: string, version: string, signal?: AbortSignal): Promise<Dependency[]>;
   fetchMaintainers(name: string, signal?: AbortSignal): Promise<Maintainer[]>;
   urls(): URLBuilder;
-  /** Match a filename to a version from the known versions list. */
+  private indexFilesByVersion;
+  private toVersion;
   private matchFileVersion;
-  /** Normalize package name per PEP 503. */
   private normalizeName;
-  /** Extract repository URL from project_urls. */
   private extractRepository;
-  /** Find a project URL by key, case-insensitive. */
   private findProjectUrl;
-  /** Parse comma-separated keywords. */
   private parseKeywords;
-  /** Parse PEP 508 dependency string into a normalized Dependency. */
+  private parseExtraMarker;
   private parsePEP508;
 }
 //#endregion
@@ -90,13 +85,11 @@ declare class PackagistRegistry extends Registry {
   fetchDependencies(name: string, version: string, signal?: AbortSignal): Promise<Dependency[]>;
   fetchMaintainers(name: string, signal?: AbortSignal): Promise<Maintainer[]>;
   urls(): URLBuilder;
-  /** Parse "vendor/package" format. */
+  private collectMaintainers;
+  private toMaintainer;
   private parseName;
-  /** Find the highest non-dev version. */
   private findLatestVersion;
-  /** Extract and normalize licenses. */
   private extractLicenses;
-  /** Skip PHP and extension dependencies. */
   private shouldSkipDependency;
 }
 //#endregion
@@ -116,25 +109,18 @@ declare class AlpmRegistry extends Registry {
   private fetchOfficialVersions;
   private fetchOfficialDependencies;
   private fetchOfficialMaintainers;
-  /** Search official repos by exact package name. Prefers x86_64 results. */
   private searchOfficial;
   private fetchAurPackage;
   private fetchAurVersions;
   private fetchAurDependencies;
   private fetchAurMaintainers;
-  /** Fetch package info from AUR RPC v5. */
   private fetchAurInfo;
-  /** Parse "namespace/name" into components. Defaults to "arch" namespace. */
   private parseName;
   private assertSupportedNamespace;
   private assertVersionMatches;
-  /** Format ALPM version: epoch:pkgver-pkgrel (epoch omitted when 0). */
   private formatVersion;
-  /** Build normalized dependency list from ALPM dependency arrays. */
   private buildDependencies;
-  /** Parse a dependency string like "glibc>=2.33" or "bash". */
   private parseDep;
-  /** Parse optional dependency like "perl-locale-gettext: translation support". */
   private parseOptDep;
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/registries/npm.ts","../../src/registries/cargo.ts","../../src/registries/pypi.ts","../../src/registries/rubygems.ts","../../src/registries/packagist.ts","../../src/registries/alpm.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/registries/npm.ts","../../src/registries/cargo.ts","../../src/registries/pypi.ts","../../src/registries/rubygems.ts","../../src/registries/packagist.ts","../../src/registries/alpm.ts"],"mappings":"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"}