@agntn/registries 0.3.0 → 0.3.1

package/packages/omp/extensions/registries.ts

@@ -0,0 +1,112 @@
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+
+import type { AgentToolResult, ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
+
+import type * as RegistryTools from "../../../dist/tool-operations.d.mts";
+
+const sourceModulePath = fileURLToPath(new URL("../../../src/tool-operations.ts", import.meta.url));
+let toolOperationsPromise: Promise<typeof RegistryTools> | undefined;
+
+function loadToolOperations(): Promise<typeof RegistryTools> {
+  toolOperationsPromise ??= (
+    existsSync(sourceModulePath)
+      ? import("../../../src/tool-operations.ts")
+      : import("../../../dist/tool-operations.mjs")
+  ) as Promise<typeof RegistryTools>;
+  return toolOperationsPromise;
+}
+
+type RegistryToolResult = AgentToolResult<unknown>;
+
+export default function registriesExtension(pi: ExtensionAPI): void {
+  const { Type } = pi.typebox;
+  const PURL = Type.String({
+    minLength: 1,
+    maxLength: 2_048,
+    description: "Package URL, for example pkg:npm/lodash or pkg:pypi/requests@2.32.3",
+  });
+  const PURLParams = Type.Object({ purl: PURL }, { additionalProperties: false });
+  const BulkPackagesParams = Type.Object(
+    {
+      purls: Type.Array(PURL, { minItems: 1, maxItems: 50 }),
+      concurrency: Type.Optional(Type.Integer({ minimum: 1, maximum: 50 })),
+    },
+    { additionalProperties: false },
+  );
+  const EmptyParams = Type.Object({}, { additionalProperties: false });
+
+  pi.setLabel("Registries");
+
+  pi.registerTool({
+    name: "registries_package",
+    label: "Registry Package",
+    description: "Fetch normalized metadata for one package URL",
+    parameters: PURLParams,
+    approval: "read",
+    async execute(_toolCallId, params, signal): Promise<RegistryToolResult> {
+      const { packageOperation } = await loadToolOperations();
+      return packageOperation(params, signal);
+    },
+  });
+
+  pi.registerTool({
+    name: "registries_versions",
+    label: "Registry Versions",
+    description: "List normalized versions for one package URL",
+    parameters: PURLParams,
+    approval: "read",
+    async execute(_toolCallId, params, signal): Promise<RegistryToolResult> {
+      const { versionsOperation } = await loadToolOperations();
+      return versionsOperation(params, signal);
+    },
+  });
+
+  pi.registerTool({
+    name: "registries_dependencies",
+    label: "Registry Dependencies",
+    description: "List dependencies for a versioned package URL",
+    parameters: PURLParams,
+    approval: "read",
+    async execute(_toolCallId, params, signal): Promise<RegistryToolResult> {
+      const { dependenciesOperation } = await loadToolOperations();
+      return dependenciesOperation(params, signal);
+    },
+  });
+
+  pi.registerTool({
+    name: "registries_maintainers",
+    label: "Registry Maintainers",
+    description: "List normalized maintainers for one package URL",
+    parameters: PURLParams,
+    approval: "read",
+    async execute(_toolCallId, params, signal): Promise<RegistryToolResult> {
+      const { maintainersOperation } = await loadToolOperations();
+      return maintainersOperation(params, signal);
+    },
+  });
+
+  pi.registerTool({
+    name: "registries_bulk_packages",
+    label: "Registry Bulk Packages",
+    description: "Fetch normalized metadata for up to 50 package URLs",
+    parameters: BulkPackagesParams,
+    approval: "read",
+    async execute(_toolCallId, params, signal): Promise<RegistryToolResult> {
+      const { bulkPackagesOperation } = await loadToolOperations();
+      return bulkPackagesOperation(params, signal);
+    },
+  });
+
+  pi.registerTool({
+    name: "registries_ecosystems",
+    label: "Registry Ecosystems",
+    description: "List package ecosystems registered by this package",
+    parameters: EmptyParams,
+    approval: "read",
+    async execute(): Promise<RegistryToolResult> {
+      const { ecosystemsOperation } = await loadToolOperations();
+      return ecosystemsOperation();
+    },
+  });
+}

package/packages/pi/extensions/registries.ts

@@ -0,0 +1,125 @@
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+
+import type { AgentToolResult, ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+
+import type * as RegistryTools from "../../../dist/tool-operations.d.mts";
+
+const sourceModuleUrl = new URL("../../../src/tool-operations.ts", import.meta.url);
+const distributionModuleUrl = new URL("../../../dist/tool-operations.mjs", import.meta.url);
+let toolOperationsPromise: Promise<typeof RegistryTools> | undefined;
+
+function loadToolOperations(): Promise<typeof RegistryTools> {
+  toolOperationsPromise ??= import(
+    existsSync(fileURLToPath(sourceModuleUrl)) ? sourceModuleUrl.href : distributionModuleUrl.href
+  ) as Promise<typeof RegistryTools>;
+  return toolOperationsPromise;
+}
+
+const PURL = Type.String({
+  minLength: 1,
+  maxLength: 2_048,
+  description: "Package URL, for example pkg:npm/lodash or pkg:pypi/requests@2.32.3",
+});
+const PURLParams = Type.Object({ purl: PURL }, { additionalProperties: false });
+const BulkPackagesParams = Type.Object(
+  {
+    purls: Type.Array(PURL, { minItems: 1, maxItems: 50 }),
+    concurrency: Type.Optional(Type.Integer({ minimum: 1, maximum: 50 })),
+  },
+  { additionalProperties: false },
+);
+const EmptyParams = Type.Object({}, { additionalProperties: false });
+
+type RegistryToolResult = AgentToolResult<unknown>;
+
+export default function registriesExtension(pi: ExtensionAPI): void {
+  pi.registerTool({
+    name: "registries_package",
+    label: "Registry Package",
+    description: "Fetch normalized metadata for one package URL",
+    promptSnippet: "Use registries_package to inspect normalized package metadata.",
+    promptGuidelines: [
+      "Use registries_package with a PURL such as pkg:npm/lodash or pkg:pypi/requests.",
+    ],
+    parameters: PURLParams,
+    async execute(_toolCallId, params, signal): Promise<RegistryToolResult> {
+      const { packageOperation } = await loadToolOperations();
+      return packageOperation(params, signal);
+    },
+  });
+
+  pi.registerTool({
+    name: "registries_versions",
+    label: "Registry Versions",
+    description: "List normalized versions for one package URL",
+    promptSnippet: "Use registries_versions to inspect package releases.",
+    promptGuidelines: ["Use registries_versions when release dates, integrity, or status matter."],
+    parameters: PURLParams,
+    async execute(_toolCallId, params, signal): Promise<RegistryToolResult> {
+      const { versionsOperation } = await loadToolOperations();
+      return versionsOperation(params, signal);
+    },
+  });
+
+  pi.registerTool({
+    name: "registries_dependencies",
+    label: "Registry Dependencies",
+    description: "List dependencies for a versioned package URL",
+    promptSnippet: "Use registries_dependencies to inspect one package release.",
+    promptGuidelines: [
+      "Use registries_dependencies with a versioned PURL such as pkg:npm/lodash@4.17.21.",
+    ],
+    parameters: PURLParams,
+    async execute(_toolCallId, params, signal): Promise<RegistryToolResult> {
+      const { dependenciesOperation } = await loadToolOperations();
+      return dependenciesOperation(params, signal);
+    },
+  });
+
+  pi.registerTool({
+    name: "registries_maintainers",
+    label: "Registry Maintainers",
+    description: "List normalized maintainers for one package URL",
+    promptSnippet: "Use registries_maintainers to inspect package ownership.",
+    promptGuidelines: [
+      "Use registries_maintainers to retrieve the identities published by the package registry.",
+    ],
+    parameters: PURLParams,
+    async execute(_toolCallId, params, signal): Promise<RegistryToolResult> {
+      const { maintainersOperation } = await loadToolOperations();
+      return maintainersOperation(params, signal);
+    },
+  });
+
+  pi.registerTool({
+    name: "registries_bulk_packages",
+    label: "Registry Bulk Packages",
+    description: "Fetch normalized metadata for up to 50 package URLs",
+    promptSnippet: "Use registries_bulk_packages to inspect several packages concurrently.",
+    promptGuidelines: [
+      "Use registries_bulk_packages for independent package lookups; failed packages are absent from the result.",
+    ],
+    parameters: BulkPackagesParams,
+    async execute(_toolCallId, params, signal): Promise<RegistryToolResult> {
+      const { bulkPackagesOperation } = await loadToolOperations();
+      return bulkPackagesOperation(params, signal);
+    },
+  });
+
+  pi.registerTool({
+    name: "registries_ecosystems",
+    label: "Registry Ecosystems",
+    description: "List package ecosystems registered by this package",
+    promptSnippet: "Use registries_ecosystems to discover supported package URL types.",
+    promptGuidelines: [
+      "Use registries_ecosystems before choosing a PURL type when ecosystem support is uncertain.",
+    ],
+    parameters: EmptyParams,
+    async execute(): Promise<RegistryToolResult> {
+      const { ecosystemsOperation } = await loadToolOperations();
+      return ecosystemsOperation();
+    },
+  });
+}

package/dist/_chunks/errors.d.mts

@@ -1,90 +0,0 @@
-import { a as ParsedPURL } from "./types.mjs";
-import { o as Client, t as Registry } from "./registry.mjs";
-
-//#region src/core/purl.d.ts
-/**
- * Parse a PURL string into its components.
- *
- * Format: `pkg:<type>/<namespace>/<name>@<version>?<qualifiers>#<subpath>`
- *
- * @see https://github.com/package-url/purl-spec (ECMA-427)
- */
-declare function parsePURL(purlStr: string): ParsedPURL;
-/** Build the full name from namespace + name (e.g., "@scope/pkg" for npm). */
-declare function fullName(parsed: ParsedPURL): string;
-/** Create a registry instance from a PURL, returning [registry, name, version]. */
-declare function createFromPURL(purlStr: string, client?: Client): [Registry, string, string];
-/** Build a PURL string from components. Inverse of `parsePURL`. */
-declare function buildPURL(parts: {
-  type: string;
-  name: string;
-  version?: string;
-  namespace?: string;
-  qualifiers?: Record<string, string>;
-  subpath?: string;
-}): string;
-//#endregion
-//#region src/core/license.d.ts
-/**
- * Normalize a license string to SPDX expression.
- *
- * Handles common variations: "MIT License" → "MIT", "Apache 2.0" → "Apache-2.0".
- * Passes through already-valid SPDX identifiers unchanged.
- */
-declare function normalizeLicense(raw: string | null | undefined): string;
-/**
- * Combine multiple license strings into a single SPDX expression.
- *
- * Default operator is OR (disjunctive, user picks one).
- * Pass "AND" for ecosystems where multiple licenses mean all apply (e.g. Arch Linux).
- */
-declare function combineLicenses(licenses: (string | null | undefined)[], operator?: "OR" | "AND"): string;
-//#endregion
-//#region src/core/repository.d.ts
-/**
- * Normalize a repository URL to a clean HTTPS git URL.
- *
- * Handles various formats:
- * - "git+https://github.com/foo/bar.git" → "https://github.com/foo/bar"
- * - "git://github.com/foo/bar" → "https://github.com/foo/bar"
- * - "ssh://git@github.com/foo/bar.git" → "https://github.com/foo/bar"
- * - "github:foo/bar" → "https://github.com/foo/bar"
- * - { url: "..." } → extracted and normalized
- */
-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
-export { RateLimitError as a, combineLicenses as c, createFromPURL as d, fullName as f, PkioError as i, normalizeLicense as l, InvalidPURLError as n, UnknownEcosystemError as o, parsePURL as p, NotFoundError as r, normalizeRepositoryURL as s, HTTPError as t, buildPURL as u };
-//# sourceMappingURL=errors.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.mts","names":[],"sources":["../../src/core/purl.ts","../../src/core/license.ts","../../src/core/repository.ts","../../src/core/errors.ts"],"mappings":";;;;;AAuBA;;;;;AA4FA;iBA5FgB,SAAA,CAAU,OAAA,WAAkB,UAAA;;iBA4F5B,QAAA,CAAS,MAAA,EAAQ,UAAA;;iBAQjB,cAAA,CAAe,OAAA,UAAiB,MAAA,GAAS,MAAA,IAAU,QAAA;;iBAQnD,SAAA,CAAU,KAAA;EACxB,IAAA;EACA,IAAA;EACA,OAAA;EACA,SAAA;EACA,UAAA,GAAa,MAAA;EACb,OAAA;AAAA;;;;;;;AAlHF;;iBCjBgB,gBAAA,CAAiB,GAAA;;;AD6GjC;;;;iBCpDgB,eAAA,CACd,QAAA,iCACA,QAAA;;;;;;;AD1CF;;;;;AA4FA;iBEzGgB,sBAAA,CAAuB,GAAA;;;;cCR1B,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"}

package/dist/_chunks/purl.mjs

@@ -1,200 +0,0 @@
-import { l as InvalidPURLError, n as create } from "./registry.mjs";
-/**
-* Normalize a license string to SPDX expression.
-*
-* Handles common variations: "MIT License" → "MIT", "Apache 2.0" → "Apache-2.0".
-* Passes through already-valid SPDX identifiers unchanged.
-*/
-function normalizeLicense(raw) {
-	if (!raw) return "";
-	const trimmed = raw.trim();
-	if (!trimmed) return "";
-	const lower = trimmed.toLowerCase();
-	const known = LICENSE_MAP.get(lower);
-	if (known) return known;
-	return trimmed;
-}
-const LICENSE_MAP = new Map([
-	["mit license", "MIT"],
-	["mit", "MIT"],
-	["apache license 2.0", "Apache-2.0"],
-	["apache 2.0", "Apache-2.0"],
-	["apache-2.0", "Apache-2.0"],
-	["apache license, version 2.0", "Apache-2.0"],
-	["apache2", "Apache-2.0"],
-	["bsd-2-clause", "BSD-2-Clause"],
-	["bsd-3-clause", "BSD-3-Clause"],
-	["bsd 2-clause", "BSD-2-Clause"],
-	["bsd 3-clause", "BSD-3-Clause"],
-	["simplified bsd license", "BSD-2-Clause"],
-	["new bsd license", "BSD-3-Clause"],
-	["isc license", "ISC"],
-	["isc", "ISC"],
-	["gpl-2.0", "GPL-2.0-only"],
-	["gpl-3.0", "GPL-3.0-only"],
-	["gpl-2.0-only", "GPL-2.0-only"],
-	["gpl-3.0-only", "GPL-3.0-only"],
-	["lgpl-2.1", "LGPL-2.1-only"],
-	["lgpl-3.0", "LGPL-3.0-only"],
-	["mpl-2.0", "MPL-2.0"],
-	["mozilla public license 2.0", "MPL-2.0"],
-	["unlicense", "Unlicense"],
-	["the unlicense", "Unlicense"],
-	["cc0-1.0", "CC0-1.0"],
-	["cc0", "CC0-1.0"],
-	["public domain", "Unlicense"],
-	["zlib", "Zlib"],
-	["wtfpl", "WTFPL"],
-	["artistic-2.0", "Artistic-2.0"],
-	["boost software license 1.0", "BSL-1.0"],
-	["bsl-1.0", "BSL-1.0"]
-]);
-/**
-* Combine multiple license strings into a single SPDX expression.
-*
-* Default operator is OR (disjunctive, user picks one).
-* Pass "AND" for ecosystems where multiple licenses mean all apply (e.g. Arch Linux).
-*/
-function combineLicenses(licenses, operator = "OR") {
-	const normalized = licenses.map((l) => normalizeLicense(l)).filter(Boolean);
-	if (normalized.length === 0) return "";
-	if (normalized.length === 1) return normalized[0];
-	return normalized.join(` ${operator} `);
-}
-/**
-* Normalize a repository URL to a clean HTTPS git URL.
-*
-* Handles various formats:
-* - "git+https://github.com/foo/bar.git" → "https://github.com/foo/bar"
-* - "git://github.com/foo/bar" → "https://github.com/foo/bar"
-* - "ssh://git@github.com/foo/bar.git" → "https://github.com/foo/bar"
-* - "github:foo/bar" → "https://github.com/foo/bar"
-* - { url: "..." } → extracted and normalized
-*/
-function normalizeRepositoryURL(raw) {
-	if (!raw) return "";
-	let url;
-	if (typeof raw === "string") url = raw;
-	else if (typeof raw === "object" && raw !== null) {
-		const obj = raw;
-		if (typeof obj["url"] === "string") url = obj["url"];
-		else return "";
-	} else return "";
-	url = url.trim();
-	if (!url) return "";
-	if (url.startsWith("github:")) url = `https://github.com/${url.slice(7)}`;
-	if (url.startsWith("gitlab:")) url = `https://gitlab.com/${url.slice(7)}`;
-	if (url.startsWith("bitbucket:")) url = `https://bitbucket.org/${url.slice(10)}`;
-	if (url.startsWith("git+")) url = url.slice(4);
-	if (url.startsWith("git://")) url = "https://" + url.slice(6);
-	if (url.startsWith("ssh://git@")) url = "https://" + url.slice(10);
-	const sshMatch = url.match(/^git@([^:]+):(.+)$/);
-	if (sshMatch) url = `https://${sshMatch[1]}/${sshMatch[2]}`;
-	if (url.endsWith("/")) url = url.slice(0, -1);
-	if (url.endsWith(".git")) url = url.slice(0, -4);
-	return url;
-}
-const QUALIFIER_KEY_PATTERN = /^[a-z][a-z0-9._-]*$/;
-/** Decode a percent-encoded PURL component, throwing InvalidPURLError on malformed sequences. */
-function decodePURLComponent(purlStr, value) {
-	try {
-		return decodeURIComponent(value);
-	} catch {
-		throw new InvalidPURLError(purlStr, "malformed percent-encoding");
-	}
-}
-/**
-* Parse a PURL string into its components.
-*
-* Format: `pkg:<type>/<namespace>/<name>@<version>?<qualifiers>#<subpath>`
-*
-* @see https://github.com/package-url/purl-spec (ECMA-427)
-*/
-function parsePURL(purlStr) {
-	if (!purlStr.startsWith("pkg:")) throw new InvalidPURLError(purlStr, "must start with \"pkg:\"");
-	let remainder = purlStr.slice(4);
-	let subpath = "";
-	const hashIdx = remainder.indexOf("#");
-	if (hashIdx !== -1) {
-		subpath = remainder.slice(hashIdx + 1).split("/").map((s) => decodePURLComponent(purlStr, s)).join("/");
-		remainder = remainder.slice(0, hashIdx);
-	}
-	const qualifiers = {};
-	const queryIdx = remainder.indexOf("?");
-	if (queryIdx !== -1) {
-		const queryStr = remainder.slice(queryIdx + 1);
-		remainder = remainder.slice(0, queryIdx);
-		for (const pair of queryStr.split("&")) {
-			const eqIdx = pair.indexOf("=");
-			if (eqIdx !== -1) qualifiers[decodePURLComponent(purlStr, pair.slice(0, eqIdx))] = decodePURLComponent(purlStr, pair.slice(eqIdx + 1));
-		}
-	}
-	let version = "";
-	const lastSlashBeforeVersion = remainder.lastIndexOf("/");
-	const lastAtIdx = remainder.lastIndexOf("@");
-	if (lastAtIdx !== -1 && lastAtIdx > lastSlashBeforeVersion) {
-		version = decodePURLComponent(purlStr, remainder.slice(lastAtIdx + 1));
-		remainder = remainder.slice(0, lastAtIdx);
-	}
-	const slashIdx = remainder.indexOf("/");
-	if (slashIdx === -1) throw new InvalidPURLError(purlStr, "missing type/name separator");
-	const type = remainder.slice(0, slashIdx).toLowerCase();
-	if (!type) throw new InvalidPURLError(purlStr, "empty type");
-	const rest = remainder.slice(slashIdx + 1);
-	if (!rest) throw new InvalidPURLError(purlStr, "empty name");
-	const lastSlashIdx = rest.lastIndexOf("/");
-	let namespace = "";
-	let name;
-	if (lastSlashIdx !== -1) {
-		namespace = rest.slice(0, lastSlashIdx).split("/").map((s) => decodePURLComponent(purlStr, s)).join("/");
-		name = decodePURLComponent(purlStr, rest.slice(lastSlashIdx + 1));
-	} else name = decodePURLComponent(purlStr, rest);
-	if (type === "pypi") name = name.toLowerCase().replace(/[-_.]+/g, "-");
-	if (type === "alpm") name = name.toLowerCase();
-	return {
-		type,
-		namespace,
-		name,
-		version,
-		qualifiers,
-		subpath
-	};
-}
-/** Build the full name from namespace + name (e.g., "@scope/pkg" for npm). */
-function fullName(parsed) {
-	if (parsed.namespace) return `${parsed.namespace}/${parsed.name}`;
-	return parsed.name;
-}
-/** Create a registry instance from a PURL, returning [registry, name, version]. */
-function createFromPURL(purlStr, client) {
-	const parsed = parsePURL(purlStr);
-	const baseURL = parsed.qualifiers["repository_url"] ?? "";
-	return [
-		create(parsed.type, baseURL || void 0, client),
-		fullName(parsed),
-		parsed.version
-	];
-}
-/** Build a PURL string from components. Inverse of `parsePURL`. */
-function buildPURL(parts) {
-	let purl = `pkg:${parts.type}/`;
-	if (parts.namespace) purl += `${parts.namespace.split("/").map((s) => encodeURIComponent(s)).join("/")}/`;
-	purl += encodeURIComponent(parts.name);
-	if (parts.version) purl += `@${encodeURIComponent(parts.version)}`;
-	if (parts.qualifiers && Object.keys(parts.qualifiers).length > 0) {
-		const qualifiers = /* @__PURE__ */ new Map();
-		for (const [key, value] of Object.entries(parts.qualifiers)) {
-			const canonicalKey = key.toLowerCase();
-			if (!QUALIFIER_KEY_PATTERN.test(canonicalKey)) throw new InvalidPURLError(purl, `invalid qualifier key "${key}"`);
-			if (qualifiers.has(canonicalKey)) throw new InvalidPURLError(purl, `duplicate qualifier key "${canonicalKey}"`);
-			qualifiers.set(canonicalKey, value);
-		}
-		const qs = [...qualifiers].sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).map(([key, value]) => `${key}=${encodeURIComponent(value)}`).join("&");
-		purl += `?${qs}`;
-	}
-	if (parts.subpath) purl += `#${parts.subpath.split("/").map((s) => encodeURIComponent(s)).join("/")}`;
-	return purl;
-}
-export { normalizeRepositoryURL as a, parsePURL as i, createFromPURL as n, combineLicenses as o, fullName as r, normalizeLicense as s, buildPURL as t };
-
-//# sourceMappingURL=purl.mjs.map

package/dist/_chunks/purl.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"purl.mjs","names":[],"sources":["../../src/core/license.ts","../../src/core/repository.ts","../../src/core/purl.ts"],"sourcesContent":["/**\n * Normalize a license string to SPDX expression.\n *\n * Handles common variations: \"MIT License\" → \"MIT\", \"Apache 2.0\" → \"Apache-2.0\".\n * Passes through already-valid SPDX identifiers unchanged.\n */\nexport function normalizeLicense(raw: string | null | undefined): string {\n  if (!raw) return \"\";\n\n  const trimmed = raw.trim();\n  if (!trimmed) return \"\";\n\n  // Common mappings\n  const lower = trimmed.toLowerCase();\n  const known = LICENSE_MAP.get(lower);\n  if (known) return known;\n\n  // Already looks like SPDX — return as-is\n  return trimmed;\n}\n\nconst LICENSE_MAP = new Map<string, string>([\n  [\"mit license\", \"MIT\"],\n  [\"mit\", \"MIT\"],\n  [\"apache license 2.0\", \"Apache-2.0\"],\n  [\"apache 2.0\", \"Apache-2.0\"],\n  [\"apache-2.0\", \"Apache-2.0\"],\n  [\"apache license, version 2.0\", \"Apache-2.0\"],\n  [\"apache2\", \"Apache-2.0\"],\n  [\"bsd-2-clause\", \"BSD-2-Clause\"],\n  [\"bsd-3-clause\", \"BSD-3-Clause\"],\n  [\"bsd 2-clause\", \"BSD-2-Clause\"],\n  [\"bsd 3-clause\", \"BSD-3-Clause\"],\n  [\"simplified bsd license\", \"BSD-2-Clause\"],\n  [\"new bsd license\", \"BSD-3-Clause\"],\n  [\"isc license\", \"ISC\"],\n  [\"isc\", \"ISC\"],\n  [\"gpl-2.0\", \"GPL-2.0-only\"],\n  [\"gpl-3.0\", \"GPL-3.0-only\"],\n  [\"gpl-2.0-only\", \"GPL-2.0-only\"],\n  [\"gpl-3.0-only\", \"GPL-3.0-only\"],\n  [\"lgpl-2.1\", \"LGPL-2.1-only\"],\n  [\"lgpl-3.0\", \"LGPL-3.0-only\"],\n  [\"mpl-2.0\", \"MPL-2.0\"],\n  [\"mozilla public license 2.0\", \"MPL-2.0\"],\n  [\"unlicense\", \"Unlicense\"],\n  [\"the unlicense\", \"Unlicense\"],\n  [\"cc0-1.0\", \"CC0-1.0\"],\n  [\"cc0\", \"CC0-1.0\"],\n  [\"public domain\", \"Unlicense\"],\n  [\"zlib\", \"Zlib\"],\n  [\"wtfpl\", \"WTFPL\"],\n  [\"artistic-2.0\", \"Artistic-2.0\"],\n  [\"boost software license 1.0\", \"BSL-1.0\"],\n  [\"bsl-1.0\", \"BSL-1.0\"],\n]);\n\n/**\n * Combine multiple license strings into a single SPDX expression.\n *\n * Default operator is OR (disjunctive, user picks one).\n * Pass \"AND\" for ecosystems where multiple licenses mean all apply (e.g. Arch Linux).\n */\nexport function combineLicenses(\n  licenses: (string | null | undefined)[],\n  operator: \"OR\" | \"AND\" = \"OR\",\n): string {\n  const normalized = licenses.map((l) => normalizeLicense(l)).filter(Boolean);\n\n  if (normalized.length === 0) return \"\";\n  if (normalized.length === 1) return normalized[0]!;\n  return normalized.join(` ${operator} `);\n}\n","/**\n * Normalize a repository URL to a clean HTTPS git URL.\n *\n * Handles various formats:\n * - \"git+https://github.com/foo/bar.git\" → \"https://github.com/foo/bar\"\n * - \"git://github.com/foo/bar\" → \"https://github.com/foo/bar\"\n * - \"ssh://git@github.com/foo/bar.git\" → \"https://github.com/foo/bar\"\n * - \"github:foo/bar\" → \"https://github.com/foo/bar\"\n * - { url: \"...\" } → extracted and normalized\n */\nexport function normalizeRepositoryURL(raw: unknown): string {\n  if (!raw) return \"\";\n\n  let url: string;\n\n  if (typeof raw === \"string\") {\n    url = raw;\n  } else if (typeof raw === \"object\" && raw !== null) {\n    const obj = raw as Record<string, unknown>;\n    if (typeof obj[\"url\"] === \"string\") {\n      url = obj[\"url\"];\n    } else {\n      return \"\";\n    }\n  } else {\n    return \"\";\n  }\n\n  url = url.trim();\n  if (!url) return \"\";\n\n  // GitHub shorthand: \"github:user/repo\"\n  if (url.startsWith(\"github:\")) {\n    url = `https://github.com/${url.slice(7)}`;\n  }\n\n  // GitLab shorthand\n  if (url.startsWith(\"gitlab:\")) {\n    url = `https://gitlab.com/${url.slice(7)}`;\n  }\n\n  // Bitbucket shorthand\n  if (url.startsWith(\"bitbucket:\")) {\n    url = `https://bitbucket.org/${url.slice(10)}`;\n  }\n\n  // Strip \"git+\" prefix\n  if (url.startsWith(\"git+\")) {\n    url = url.slice(4);\n  }\n\n  // Convert git:// to https://\n  if (url.startsWith(\"git://\")) {\n    url = \"https://\" + url.slice(6);\n  }\n\n  // Convert ssh://git@host/... to https://host/...\n  if (url.startsWith(\"ssh://git@\")) {\n    url = \"https://\" + url.slice(10);\n  }\n\n  // Convert git@host:user/repo to https://host/user/repo\n  const sshMatch = url.match(/^git@([^:]+):(.+)$/);\n  if (sshMatch) {\n    url = `https://${sshMatch[1]}/${sshMatch[2]}`;\n  }\n\n  // Strip trailing slash first so \".git/\" doesn't survive\n  if (url.endsWith(\"/\")) {\n    url = url.slice(0, -1);\n  }\n\n  // Strip .git suffix\n  if (url.endsWith(\".git\")) {\n    url = url.slice(0, -4);\n  }\n\n  return url;\n}\n","import type { ParsedPURL } from \"./types.ts\";\nimport type { Client } from \"./client.ts\";\nimport { create, type Registry } from \"./registry.ts\";\nimport { InvalidPURLError } from \"./errors.ts\";\n\nconst QUALIFIER_KEY_PATTERN = /^[a-z][a-z0-9._-]*$/;\n\n/** Decode a percent-encoded PURL component, throwing InvalidPURLError on malformed sequences. */\nfunction decodePURLComponent(purlStr: string, value: string): string {\n  try {\n    return decodeURIComponent(value);\n  } catch {\n    throw new InvalidPURLError(purlStr, \"malformed percent-encoding\");\n  }\n}\n\n/**\n * Parse a PURL string into its components.\n *\n * Format: `pkg:<type>/<namespace>/<name>@<version>?<qualifiers>#<subpath>`\n *\n * @see https://github.com/package-url/purl-spec (ECMA-427)\n */\nexport function parsePURL(purlStr: string): ParsedPURL {\n  if (!purlStr.startsWith(\"pkg:\")) {\n    throw new InvalidPURLError(purlStr, 'must start with \"pkg:\"');\n  }\n\n  let remainder = purlStr.slice(4); // strip 'pkg:'\n\n  // Extract subpath\n  let subpath = \"\";\n  const hashIdx = remainder.indexOf(\"#\");\n  if (hashIdx !== -1) {\n    subpath = remainder\n      .slice(hashIdx + 1)\n      .split(\"/\")\n      .map((s) => decodePURLComponent(purlStr, s))\n      .join(\"/\");\n    remainder = remainder.slice(0, hashIdx);\n  }\n\n  // Extract qualifiers\n  const qualifiers: Record<string, string> = {};\n  const queryIdx = remainder.indexOf(\"?\");\n  if (queryIdx !== -1) {\n    const queryStr = remainder.slice(queryIdx + 1);\n    remainder = remainder.slice(0, queryIdx);\n    for (const pair of queryStr.split(\"&\")) {\n      const eqIdx = pair.indexOf(\"=\");\n      if (eqIdx !== -1) {\n        qualifiers[decodePURLComponent(purlStr, pair.slice(0, eqIdx))] = decodePURLComponent(\n          purlStr,\n          pair.slice(eqIdx + 1),\n        );\n      }\n    }\n  }\n\n  // Extract version — the version separator is the last '@' that appears\n  // after the last '/', so scoped names like 'npm/@vue/core' are not mistaken\n  // for having a version.\n  let version = \"\";\n  const lastSlashBeforeVersion = remainder.lastIndexOf(\"/\");\n  const lastAtIdx = remainder.lastIndexOf(\"@\");\n  if (lastAtIdx !== -1 && lastAtIdx > lastSlashBeforeVersion) {\n    version = decodePURLComponent(purlStr, remainder.slice(lastAtIdx + 1));\n    remainder = remainder.slice(0, lastAtIdx);\n  }\n\n  // Extract type\n  const slashIdx = remainder.indexOf(\"/\");\n  if (slashIdx === -1) {\n    throw new InvalidPURLError(purlStr, \"missing type/name separator\");\n  }\n\n  const type = remainder.slice(0, slashIdx).toLowerCase();\n  if (!type) {\n    throw new InvalidPURLError(purlStr, \"empty type\");\n  }\n\n  const rest = remainder.slice(slashIdx + 1);\n  if (!rest) {\n    throw new InvalidPURLError(purlStr, \"empty name\");\n  }\n\n  // Extract namespace and name\n  const lastSlashIdx = rest.lastIndexOf(\"/\");\n  let namespace = \"\";\n  let name: string;\n\n  if (lastSlashIdx !== -1) {\n    namespace = rest\n      .slice(0, lastSlashIdx)\n      .split(\"/\")\n      .map((s) => decodePURLComponent(purlStr, s))\n      .join(\"/\");\n    name = decodePURLComponent(purlStr, rest.slice(lastSlashIdx + 1));\n  } else {\n    name = decodePURLComponent(purlStr, rest);\n  }\n\n  // Ecosystem-specific normalization per PURL spec\n  if (type === \"pypi\") {\n    name = name.toLowerCase().replace(/[-_.]+/g, \"-\");\n  }\n\n  if (type === \"alpm\") {\n    name = name.toLowerCase();\n  }\n\n  return { type, namespace, name, version, qualifiers, subpath };\n}\n\n/** Build the full name from namespace + name (e.g., \"@scope/pkg\" for npm). */\nexport function fullName(parsed: ParsedPURL): string {\n  if (parsed.namespace) {\n    return `${parsed.namespace}/${parsed.name}`;\n  }\n  return parsed.name;\n}\n\n/** Create a registry instance from a PURL, returning [registry, name, version]. */\nexport function createFromPURL(purlStr: string, client?: Client): [Registry, string, string] {\n  const parsed = parsePURL(purlStr);\n  const baseURL = parsed.qualifiers[\"repository_url\"] ?? \"\";\n  const reg = create(parsed.type, baseURL || undefined, client);\n  return [reg, fullName(parsed), parsed.version];\n}\n\n/** Build a PURL string from components. Inverse of `parsePURL`. */\nexport function buildPURL(parts: {\n  type: string;\n  name: string;\n  version?: string;\n  namespace?: string;\n  qualifiers?: Record<string, string>;\n  subpath?: string;\n}): string {\n  let purl = `pkg:${parts.type}/`;\n  if (parts.namespace) {\n    purl += `${parts.namespace\n      .split(\"/\")\n      .map((s) => encodeURIComponent(s))\n      .join(\"/\")}/`;\n  }\n  purl += encodeURIComponent(parts.name);\n  if (parts.version) {\n    purl += `@${encodeURIComponent(parts.version)}`;\n  }\n  if (parts.qualifiers && Object.keys(parts.qualifiers).length > 0) {\n    const qualifiers = new Map<string, string>();\n    for (const [key, value] of Object.entries(parts.qualifiers)) {\n      const canonicalKey = key.toLowerCase();\n      if (!QUALIFIER_KEY_PATTERN.test(canonicalKey)) {\n        throw new InvalidPURLError(purl, `invalid qualifier key \"${key}\"`);\n      }\n      if (qualifiers.has(canonicalKey)) {\n        throw new InvalidPURLError(purl, `duplicate qualifier key \"${canonicalKey}\"`);\n      }\n      qualifiers.set(canonicalKey, value);\n    }\n    const qs = [...qualifiers]\n      .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))\n      .map(([key, value]) => `${key}=${encodeURIComponent(value)}`)\n      .join(\"&\");\n    purl += `?${qs}`;\n  }\n  if (parts.subpath) {\n    purl += `#${parts.subpath\n      .split(\"/\")\n      .map((s) => encodeURIComponent(s))\n      .join(\"/\")}`;\n  }\n  return purl;\n}\n"],"mappings":"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"}

package/dist/_chunks/types.d.mts

@@ -1,73 +0,0 @@
-//#region src/core/types.d.ts
-/** Normalized package metadata returned by any registry. */
-interface Package {
-  name: string;
-  description: string;
-  homepage: string;
-  documentation: string;
-  repository: string;
-  licenses: string;
-  keywords: string[];
-  namespace: string;
-  latestVersion: string;
-  metadata: Record<string, unknown>;
-}
-/** A single version entry of a package. */
-interface Version {
-  number: string;
-  publishedAt: Date | null;
-  licenses: string;
-  integrity: string;
-  status: VersionStatus;
-  metadata: Record<string, unknown>;
-}
-/** Dependency of a package version. */
-interface Dependency {
-  name: string;
-  requirements: string;
-  scope: Scope;
-  optional: boolean;
-}
-/** Maintainer / author of a package. */
-interface Maintainer {
-  uuid: string;
-  login: string;
-  name: string;
-  email: string;
-  url: string;
-  role: string;
-}
-type VersionStatus = "" | "yanked" | "deprecated" | "retracted";
-type Scope = "runtime" | "development" | "test" | "build" | "optional";
-/** URL builder for a specific registry. */
-interface URLBuilder {
-  registry(name: string, version?: string): string;
-  download(name: string, version: string): string;
-  documentation(name: string, version?: string): string;
-  readme(name: string, version?: string): string;
-  purl(name: string, version?: string): string;
-}
-/** Options for the HTTP client. */
-interface ClientOptions {
-  maxRetries?: number;
-  baseDelay?: number;
-  timeout?: number;
-  rateLimiter?: RateLimiter;
-  userAgent?: string;
-}
-/** Rate limiter interface — bring your own implementation. */
-interface RateLimiter {
-  wait(signal?: AbortSignal): Promise<void>;
-}
-/** Parsed PURL components. */
-interface ParsedPURL {
-  type: string;
-  namespace: string;
-  name: string;
-  version: string;
-  qualifiers: Record<string, string>;
-  subpath: string;
-}
-//#endregion
-export { ParsedPURL as a, URLBuilder as c, Package as i, Version as l, Dependency as n, RateLimiter as o, Maintainer as r, Scope as s, ClientOptions as t, VersionStatus as u };
-//# sourceMappingURL=types.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/core/types.ts"],"mappings":";;UACiB,OAAA;EACf,IAAA;EACA,WAAA;EACA,QAAA;EACA,aAAA;EACA,UAAA;EACA,QAAA;EACA,QAAA;EACA,SAAA;EACA,aAAA;EACA,QAAA,EAAU,MAAA;AAAA;;UAIK,OAAA;EACf,MAAA;EACA,WAAA,EAAa,IAAA;EACb,QAAA;EACA,SAAA;EACA,MAAA,EAAQ,aAAA;EACR,QAAA,EAAU,MAAA;AAAA;;UAIK,UAAA;EACf,IAAA;EACA,YAAA;EACA,KAAA,EAAO,KAAA;EACP,QAAA;AAAA;;UAIe,UAAA;EACf,IAAA;EACA,KAAA;EACA,IAAA;EACA,KAAA;EACA,GAAA;EACA,IAAA;AAAA;AAAA,KAGU,aAAA;AAAA,KACA,KAAA;;UAGK,UAAA;EACf,QAAA,CAAS,IAAA,UAAc,OAAA;EACvB,QAAA,CAAS,IAAA,UAAc,OAAA;EACvB,aAAA,CAAc,IAAA,UAAc,OAAA;EAC5B,MAAA,CAAO,IAAA,UAAc,OAAA;EACrB,IAAA,CAAK,IAAA,UAAc,OAAA;AAAA;AAlBrB;AAAA,UAsBiB,aAAA;EACf,UAAA;EACA,SAAA;EACA,OAAA;EACA,WAAA,GAAc,WAAA;EACd,SAAA;AAAA;;UAIe,WAAA;EACf,IAAA,CAAK,MAAA,GAAS,WAAA,GAAc,OAAA;AAAA;AAvB9B;AAAA,UA2BiB,UAAA;EACf,IAAA;EACA,SAAA;EACA,IAAA;EACA,OAAA;EACA,UAAA,EAAY,MAAA;EACZ,OAAA;AAAA"}