@x12i/npm-core 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,14 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @x12i/npm-core
+
+Read the public npm registry: list every package in an org, and read one package's README and metadata.
+
+```js
+import { listOrgPackages, getReadme } from "@x12i/npm-core";
+
+const names = await listOrgPackages("x12i");
+const readme = await getReadme("@x12i/sdk");
+```
+
+`listOrgPackages` uses `GET https://registry.npmjs.org/-/org/{org}/package`. Search is only the fallback when that listing is empty or fails. `listOrgCatalog` returns that same set, including unscoped names the org owns, and adds the latest publish time from the maintainer search when npm has one. `getReadme` and `getPackage` read the packument. `getLastMonthDownloads` reads the npm downloads API.
+
+This package does not crawl daily download history and it does not store reviews. Pass `fetch`, `userAgent`, `maxRetries`, `deadline`, and `beforeFetch` when the caller has to count or stub HTTP requests.

package/dist/http.d.ts

@@ -0,0 +1,21 @@
+export declare class RateLimitedError extends Error {
+    readonly status = 429;
+    retryAfterMs?: number;
+    constructor(message: string);
+}
+export type RequestError = Error & {
+    status?: number;
+    retryAfterMs?: number;
+};
+export type RequestOptions = {
+    fetch?: typeof fetch;
+    userAgent?: string;
+    /** Retries after the first attempt for network errors, 5xx, and 429. */
+    maxRetries?: number;
+    /** Epoch ms. A 429 whose wait would pass this deadline is thrown immediately. */
+    deadline?: number;
+    /** Called once per HTTP attempt. Throw to stop, for example when a fetch budget is spent. */
+    beforeFetch?: () => void;
+};
+/** GET JSON from the npm registry or downloads API. */
+export declare function fetchJson<T>(url: string, options?: RequestOptions): Promise<T>;

package/dist/http.js

@@ -0,0 +1,59 @@
+export class RateLimitedError extends Error {
+    status = 429;
+    retryAfterMs;
+    constructor(message) {
+        super(message);
+        this.name = "RateLimitedError";
+    }
+}
+function delay(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+/** GET JSON from the npm registry or downloads API. */
+export async function fetchJson(url, options = {}) {
+    const maxRetries = options.maxRetries ?? 2;
+    const doFetch = options.fetch ?? fetch;
+    let lastError = new Error("npm request failed");
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        options.beforeFetch?.();
+        try {
+            const response = await doFetch(url, {
+                headers: {
+                    Accept: "application/json",
+                    "User-Agent": options.userAgent ?? "@x12i/npm-core",
+                },
+            });
+            if (response.ok)
+                return (await response.json());
+            const retryAfter = Number(response.headers.get("retry-after"));
+            const error = new Error(`npm API returned status ${response.status} for ${url}`);
+            error.status = response.status;
+            error.retryAfterMs = Number.isFinite(retryAfter) ? retryAfter * 1000 : 0;
+            throw error;
+        }
+        catch (error) {
+            if (error instanceof RateLimitedError)
+                throw error;
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (lastError.name === "FetchBudgetExhausted")
+                throw lastError;
+            const status = lastError.status ?? 0;
+            const rateLimited = status === 429;
+            if (status >= 400 && status < 500 && !rateLimited)
+                break;
+            if (attempt >= maxRetries) {
+                if (rateLimited)
+                    throw new RateLimitedError(lastError.message);
+                break;
+            }
+            const backoff = rateLimited ? Math.min(30_000, 3_000 * 2 ** attempt) : (attempt + 1) * 1_500;
+            const wait = Math.max(lastError.retryAfterMs ?? 0, backoff) + Math.floor(Math.random() * 400);
+            if (rateLimited && options.deadline && Date.now() + wait > options.deadline) {
+                throw new RateLimitedError(lastError.message);
+            }
+            await delay(wait);
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { RateLimitedError, fetchJson, type RequestOptions } from "./http.js";
+export { getLastMonthDownloads, getPackage, getReadme, listOrgCatalog, listOrgPackages, normalizeOrg, packageInfo, readmeHeadings, searchPackages, type OrgPackageRecord, type PackageInfo, } from "./registry.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export { RateLimitedError, fetchJson } from "./http.js";
+export { getLastMonthDownloads, getPackage, getReadme, listOrgCatalog, listOrgPackages, normalizeOrg, packageInfo, readmeHeadings, searchPackages, } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAuB,MAAM,WAAW,CAAC;AAC7E,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,SAAS,EACT,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,cAAc,EACd,cAAc,GAGf,MAAM,eAAe,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,79 @@
+import { type RequestOptions } from "./http.js";
+export type PackageInfo = {
+    name: string;
+    version: string | null;
+    description: string;
+    keywords: string[];
+    homepage: string | null;
+    repository: string | null;
+    readme: string;
+    publishedAt: string | null;
+    modifiedAt: string | null;
+    license: string | null;
+};
+type Packument = {
+    name?: string;
+    description?: string;
+    readme?: string;
+    license?: string | {
+        type?: string;
+    };
+    keywords?: unknown;
+    homepage?: string;
+    repository?: unknown;
+    "dist-tags"?: {
+        latest?: string;
+    };
+    versions?: Record<string, VersionDoc>;
+    time?: Record<string, string>;
+};
+type VersionDoc = {
+    description?: string;
+    keywords?: unknown;
+    homepage?: string;
+    repository?: unknown;
+    license?: string | {
+        type?: string;
+    };
+};
+export type OrgPackageRecord = {
+    name: string;
+    version: string | null;
+    description: string;
+    keywords: string[];
+    homepage: string | null;
+    repository: string | null;
+    license: string | null;
+    /** Latest publish time from npm search. Null when search has not seen this package yet. */
+    modifiedAt: string | null;
+};
+/** `x12i`, `@x12i`, and `@x12i/` all name the org `x12i`. */
+export declare function normalizeOrg(org: string): string;
+export declare function readmeHeadings(markdown: string): string[];
+export declare function packageInfo(doc: Packument, fallbackName?: string): PackageInfo;
+/**
+ * Every package the org listing returns, including unscoped names the org owns.
+ * npm search is only the fallback: it drops packages and repeats others.
+ */
+export declare function listOrgPackages(org: string, options?: RequestOptions): Promise<string[]>;
+/**
+ * Every package the org owns, including unscoped names, with the latest publish
+ * time when the maintainer search knows it. Membership comes from the org listing.
+ * Search only supplies dates and short metadata, and a search failure still returns the names.
+ */
+export declare function listOrgCatalog(org: string, options?: RequestOptions): Promise<{
+    packages: OrgPackageRecord[];
+    fromOrgListing: boolean;
+}>;
+/** Registry search filtered to one scope, used when the catalog service is unreachable. */
+export declare function searchPackages(text: string, options?: RequestOptions & {
+    size?: number;
+    scope?: string;
+}): Promise<PackageInfo[]>;
+/** Full packument summary for one package. */
+export declare function getPackage(name: string, options?: RequestOptions): Promise<PackageInfo>;
+/** README plus the description, keywords, version, repository, and homepage from the same packument. */
+export declare function getReadme(name: string, options?: RequestOptions): Promise<PackageInfo>;
+/** Download count for the last month. A package npm has not counted yet is 0. */
+export declare function getLastMonthDownloads(name: string, options?: RequestOptions): Promise<number>;
+export {};

package/dist/registry.js

@@ -0,0 +1,202 @@
+import { fetchJson } from "./http.js";
+const SEARCH_PAGE_SIZE = 250;
+/** `x12i`, `@x12i`, and `@x12i/` all name the org `x12i`. */
+export function normalizeOrg(org) {
+    const name = org.trim().replace(/^@/, "").replace(/\/$/, "");
+    if (!/^[a-z0-9][a-z0-9-]*$/i.test(name))
+        throw new Error(`Invalid npm org: ${org}`);
+    return name;
+}
+function strings(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => typeof item === "string" && item.trim().length > 0);
+}
+function cleanRepository(value) {
+    const raw = typeof value === "string" ? value : value && typeof value === "object" && typeof value.url === "string" ? value.url : "";
+    const cleaned = raw.replace(/^git\+/, "").replace(/\.git$/, "").trim();
+    return cleaned || null;
+}
+function licenseOf(value) {
+    if (typeof value === "string" && value.trim())
+        return value.trim();
+    if (value && typeof value === "object" && typeof value.type === "string")
+        return value.type;
+    return null;
+}
+export function readmeHeadings(markdown) {
+    return markdown
+        .split(/\r?\n/)
+        .map((line) => /^#{1,3}\s+(.+?)\s*#*$/.exec(line)?.[1]?.trim() ?? "")
+        .filter((heading) => heading.length > 0);
+}
+export function packageInfo(doc, fallbackName = "") {
+    const version = doc["dist-tags"]?.latest ?? null;
+    const latest = version && doc.versions ? doc.versions[version] : undefined;
+    const name = doc.name || fallbackName;
+    if (!name)
+        throw new Error("npm packument has no package name");
+    return {
+        name,
+        version,
+        description: (doc.description || latest?.description || "").trim(),
+        keywords: strings(latest?.keywords ?? doc.keywords),
+        homepage: (typeof latest?.homepage === "string" && latest.homepage) || (typeof doc.homepage === "string" && doc.homepage) || null,
+        repository: cleanRepository(latest?.repository ?? doc.repository),
+        readme: typeof doc.readme === "string" ? doc.readme : "",
+        publishedAt: doc.time?.created ?? null,
+        modifiedAt: doc.time?.modified ?? (version ? doc.time?.[version] ?? null : null),
+        license: licenseOf(latest?.license ?? doc.license),
+    };
+}
+/**
+ * Every package the org listing returns, including unscoped names the org owns.
+ * npm search is only the fallback: it drops packages and repeats others.
+ */
+export async function listOrgPackages(org, options = {}) {
+    const name = normalizeOrg(org);
+    try {
+        const listing = await fetchJson(`https://registry.npmjs.org/-/org/${encodeURIComponent(name)}/package`, options);
+        if (listing && typeof listing === "object" && !Array.isArray(listing)) {
+            const names = Object.keys(listing);
+            if (names.length > 0)
+                return names.sort();
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === "FetchBudgetExhausted")
+            throw error;
+    }
+    return discoverViaSearch(name, options);
+}
+async function discoverViaSearch(org, options) {
+    const prefix = `@${org}/`;
+    const names = new Set();
+    let offset = 0;
+    let total = Infinity;
+    while (offset < total && offset <= 10_000) {
+        const data = await fetchJson(`https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(prefix)}&size=${SEARCH_PAGE_SIZE}&from=${offset}`, options);
+        total = Number.isFinite(data.total) ? data.total : 0;
+        const objects = data.objects ?? [];
+        if (objects.length === 0)
+            break;
+        for (const item of objects) {
+            const packageName = item.package?.name;
+            if (typeof packageName === "string" && packageName.startsWith(prefix))
+                names.add(packageName);
+        }
+        offset += SEARCH_PAGE_SIZE;
+    }
+    return [...names].sort();
+}
+const MAINTAINER_PAGE_SIZE = 250;
+const MAINTAINER_PAGE_CAP = 20;
+function blankOrgPackage(name) {
+    return { name, version: null, description: "", keywords: [], homepage: null, repository: null, license: null, modifiedAt: null };
+}
+/**
+ * Every package the org owns, including unscoped names, with the latest publish
+ * time when the maintainer search knows it. Membership comes from the org listing.
+ * Search only supplies dates and short metadata, and a search failure still returns the names.
+ */
+export async function listOrgCatalog(org, options = {}) {
+    const orgName = normalizeOrg(org);
+    let names = [];
+    let fromOrgListing = false;
+    try {
+        const listing = await fetchJson(`https://registry.npmjs.org/-/org/${encodeURIComponent(orgName)}/package`, options);
+        if (listing && typeof listing === "object" && !Array.isArray(listing)) {
+            names = Object.keys(listing).sort();
+            fromOrgListing = names.length > 0;
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === "FetchBudgetExhausted")
+            throw error;
+    }
+    if (!fromOrgListing)
+        names = await listOrgPackages(orgName, options);
+    const wanted = new Set(names);
+    const found = new Map();
+    try {
+        let offset = 0;
+        let total = Infinity;
+        for (let page = 0; page < MAINTAINER_PAGE_CAP && offset < total; page++) {
+            const data = await fetchJson(`https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(`maintainer:${orgName}`)}&size=${MAINTAINER_PAGE_SIZE}&from=${offset}`, options);
+            total = Number.isFinite(data.total) ? data.total : 0;
+            const objects = data.objects ?? [];
+            if (objects.length === 0)
+                break;
+            for (const item of objects) {
+                const pkg = item.package;
+                if (!pkg?.name || !wanted.has(pkg.name))
+                    continue;
+                found.set(pkg.name, {
+                    name: pkg.name,
+                    version: pkg.version ?? null,
+                    description: (pkg.description ?? "").trim(),
+                    keywords: strings(pkg.keywords),
+                    homepage: pkg.links?.homepage ?? null,
+                    repository: pkg.links?.repository ?? null,
+                    license: typeof pkg.license === "string" && pkg.license.trim() ? pkg.license.trim() : null,
+                    modifiedAt: typeof pkg.date === "string" && pkg.date ? pkg.date : null,
+                });
+            }
+            offset += MAINTAINER_PAGE_SIZE;
+        }
+    }
+    catch {
+        // Dates are best-effort. The org listing is still the catalog membership.
+    }
+    return { packages: names.map((name) => found.get(name) ?? blankOrgPackage(name)), fromOrgListing };
+}
+/** Registry search filtered to one scope, used when the catalog service is unreachable. */
+export async function searchPackages(text, options = {}) {
+    const scope = options.scope ?? "@x12i/";
+    const size = Math.min(250, Math.max(1, options.size ?? 20));
+    const query = `${text} ${scope}`.trim();
+    const data = await fetchJson(`https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(query)}&size=${size}`, options);
+    const found = [];
+    for (const item of data.objects ?? []) {
+        const pkg = item.package;
+        if (!pkg?.name || !pkg.name.startsWith(scope))
+            continue;
+        found.push({
+            name: pkg.name,
+            version: pkg.version ?? null,
+            description: (pkg.description ?? "").trim(),
+            keywords: strings(pkg.keywords),
+            homepage: pkg.links?.homepage ?? null,
+            repository: pkg.links?.repository ?? null,
+            license: typeof pkg.license === "string" && pkg.license.trim() ? pkg.license.trim() : null,
+            readme: "",
+            publishedAt: null,
+            modifiedAt: null,
+        });
+    }
+    return found;
+}
+/** Full packument summary for one package. */
+export async function getPackage(name, options = {}) {
+    const doc = await fetchJson(`https://registry.npmjs.org/${encodeURIComponent(name).replace("%40", "@")}`, options);
+    return packageInfo(doc, name);
+}
+/** README plus the description, keywords, version, repository, and homepage from the same packument. */
+export async function getReadme(name, options = {}) {
+    return getPackage(name, options);
+}
+/** Download count for the last month. A package npm has not counted yet is 0. */
+export async function getLastMonthDownloads(name, options = {}) {
+    try {
+        const data = await fetchJson(`https://api.npmjs.org/downloads/point/last-month/${encodeURIComponent(name)}`, options);
+        const count = Number(data.downloads);
+        return Number.isFinite(count) && count > 0 ? Math.floor(count) : 0;
+    }
+    catch (error) {
+        const status = error.status;
+        if (status === 404)
+            return 0;
+        throw error;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,44 @@
-{
-  "name": "@x12i/npm-core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "@x12i/npm-core",
+  "version": "0.1.0",
+  "description": "List packages in an npm org and read a package README from the registry.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/x12i/x12i-stats.git",
+    "directory": "packages/npm-core"
+  },
+  "homepage": "https://github.com/x12i/x12i-stats/tree/main/packages/npm-core#readme",
+  "bugs": {
+    "url": "https://github.com/x12i/x12i-stats/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "tsc -p tsconfig.json && node --test test/registry.test.mjs",
+    "prepublishOnly": "npm run typecheck && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.19",
+    "typescript": "5.9.3"
+  }
+}