@mcptoolshop/registry-stats 1.2.1 → 1.2.3

package/dist/cli.js

@@ -25,8 +25,10 @@ var REGISTRY_DELAYS = {
   // ~2.5 req/s — safe for 54+ scoped packages
   pypi: 2200,
   // 30 req/60s = 1 per 2s, with headroom
-  docker: 4e3
+  docker: 4e3,
   // 10 req/3600s — very tight
+  ghcr: 200
+  // 5000 req/hr authenticated, 60/hr unauth
 };
 var DEFAULT_DELAY = 100;
 function acquireSlot(registry) {
@@ -301,6 +303,71 @@ var docker = {
   }
 };
 
+// src/providers/ghcr.ts
+var API5 = "https://api.github.com";
+var ghcr = {
+  name: "ghcr",
+  rateLimit: { maxRequests: 50, windowSeconds: 3600, authRaisesLimit: true },
+  async getStats(pkg, options) {
+    const slash = pkg.indexOf("/");
+    if (slash === -1) return null;
+    const owner = pkg.slice(0, slash);
+    const name = pkg.slice(slash + 1);
+    const headers = {
+      "Accept": "application/vnd.github+json",
+      "X-GitHub-Api-Version": "2022-11-28"
+    };
+    if (options?.ghcrToken) {
+      headers["Authorization"] = `Bearer ${options.ghcrToken}`;
+    }
+    const versions = await fetchWithRetry(
+      `${API5}/orgs/${owner}/packages/container/${encodeURIComponent(name)}/versions?per_page=100`,
+      "ghcr",
+      { headers }
+    );
+    if (!versions || !Array.isArray(versions)) return null;
+    const now = Date.now();
+    const DAY = 864e5;
+    let activity7d = 0;
+    let activity30d = 0;
+    let lastPublished = null;
+    for (const v of versions) {
+      const created = v.created_at ? new Date(v.created_at).getTime() : 0;
+      if (created > 0) {
+        const age = now - created;
+        if (age <= 7 * DAY) activity7d++;
+        if (age <= 30 * DAY) activity30d++;
+        if (!lastPublished || v.created_at > lastPublished) {
+          lastPublished = v.created_at;
+        }
+      }
+    }
+    const tags = versions.flatMap((v) => v.metadata?.container?.tags ?? []);
+    return {
+      registry: "ghcr",
+      package: pkg,
+      downloads: {
+        total: versions.length,
+        // versionCount as primary number
+        lastWeek: activity7d,
+        // new versions in 7d
+        lastMonth: activity30d
+        // new versions in 30d
+      },
+      extra: {
+        metricType: "versions",
+        // signals this is version activity, not downloads
+        tags: tags.slice(0, 10),
+        versionCount: versions.length,
+        activity7d,
+        activity30d,
+        lastPublished
+      },
+      fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+};
+
 // src/calc.ts
 var calc = {
   total(records) {
@@ -604,7 +671,8 @@ var providers = {
   pypi,
   nuget,
   vscode,
-  docker
+  docker,
+  ghcr
 };
 var DEFAULT_TTL = 3e5;
 async function stats(registry, pkg, options) {

package/dist/index.cjs

@@ -54,8 +54,10 @@ var REGISTRY_DELAYS = {
   // ~2.5 req/s — safe for 54+ scoped packages
   pypi: 2200,
   // 30 req/60s = 1 per 2s, with headroom
-  docker: 4e3
+  docker: 4e3,
   // 10 req/3600s — very tight
+  ghcr: 200
+  // 5000 req/hr authenticated, 60/hr unauth
 };
 var DEFAULT_DELAY = 100;
 function acquireSlot(registry) {
@@ -330,6 +332,71 @@ var docker = {
   }
 };
 
+// src/providers/ghcr.ts
+var API5 = "https://api.github.com";
+var ghcr = {
+  name: "ghcr",
+  rateLimit: { maxRequests: 50, windowSeconds: 3600, authRaisesLimit: true },
+  async getStats(pkg, options) {
+    const slash = pkg.indexOf("/");
+    if (slash === -1) return null;
+    const owner = pkg.slice(0, slash);
+    const name = pkg.slice(slash + 1);
+    const headers = {
+      "Accept": "application/vnd.github+json",
+      "X-GitHub-Api-Version": "2022-11-28"
+    };
+    if (options?.ghcrToken) {
+      headers["Authorization"] = `Bearer ${options.ghcrToken}`;
+    }
+    const versions = await fetchWithRetry(
+      `${API5}/orgs/${owner}/packages/container/${encodeURIComponent(name)}/versions?per_page=100`,
+      "ghcr",
+      { headers }
+    );
+    if (!versions || !Array.isArray(versions)) return null;
+    const now = Date.now();
+    const DAY = 864e5;
+    let activity7d = 0;
+    let activity30d = 0;
+    let lastPublished = null;
+    for (const v of versions) {
+      const created = v.created_at ? new Date(v.created_at).getTime() : 0;
+      if (created > 0) {
+        const age = now - created;
+        if (age <= 7 * DAY) activity7d++;
+        if (age <= 30 * DAY) activity30d++;
+        if (!lastPublished || v.created_at > lastPublished) {
+          lastPublished = v.created_at;
+        }
+      }
+    }
+    const tags = versions.flatMap((v) => v.metadata?.container?.tags ?? []);
+    return {
+      registry: "ghcr",
+      package: pkg,
+      downloads: {
+        total: versions.length,
+        // versionCount as primary number
+        lastWeek: activity7d,
+        // new versions in 7d
+        lastMonth: activity30d
+        // new versions in 30d
+      },
+      extra: {
+        metricType: "versions",
+        // signals this is version activity, not downloads
+        tags: tags.slice(0, 10),
+        versionCount: versions.length,
+        activity7d,
+        activity30d,
+        lastPublished
+      },
+      fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+};
+
 // src/calc.ts
 var calc = {
   total(records) {
@@ -642,7 +709,8 @@ var providers = {
   pypi,
   nuget,
   vscode,
-  docker
+  docker,
+  ghcr
 };
 function registerProvider(provider) {
   providers[provider.name] = provider;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as node_http from 'node:http';
 import { IncomingMessage, ServerResponse } from 'node:http';
 
-type RegistryName = 'npm' | 'pypi' | 'nuget' | 'vscode' | 'docker';
+type RegistryName = 'npm' | 'pypi' | 'nuget' | 'vscode' | 'docker' | 'ghcr';
 interface PackageStats {
     registry: RegistryName;
     package: string;
@@ -38,6 +38,8 @@ interface StatsCache {
 }
 interface StatsOptions {
     dockerToken?: string;
+    /** GitHub token for GHCR (GitHub Container Registry) — read:packages scope */
+    ghcrToken?: string;
     /** Max concurrent requests for bulk operations (default: 5) */
     concurrency?: number;
     /** Cache instance — use createCache() for built-in TTL cache */

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as node_http from 'node:http';
 import { IncomingMessage, ServerResponse } from 'node:http';
 
-type RegistryName = 'npm' | 'pypi' | 'nuget' | 'vscode' | 'docker';
+type RegistryName = 'npm' | 'pypi' | 'nuget' | 'vscode' | 'docker' | 'ghcr';
 interface PackageStats {
     registry: RegistryName;
     package: string;
@@ -38,6 +38,8 @@ interface StatsCache {
 }
 interface StatsOptions {
     dockerToken?: string;
+    /** GitHub token for GHCR (GitHub Container Registry) — read:packages scope */
+    ghcrToken?: string;
     /** Max concurrent requests for bulk operations (default: 5) */
     concurrency?: number;
     /** Cache instance — use createCache() for built-in TTL cache */

package/dist/index.js

@@ -19,8 +19,10 @@ var REGISTRY_DELAYS = {
   // ~2.5 req/s — safe for 54+ scoped packages
   pypi: 2200,
   // 30 req/60s = 1 per 2s, with headroom
-  docker: 4e3
+  docker: 4e3,
   // 10 req/3600s — very tight
+  ghcr: 200
+  // 5000 req/hr authenticated, 60/hr unauth
 };
 var DEFAULT_DELAY = 100;
 function acquireSlot(registry) {
@@ -295,6 +297,71 @@ var docker = {
   }
 };
 
+// src/providers/ghcr.ts
+var API5 = "https://api.github.com";
+var ghcr = {
+  name: "ghcr",
+  rateLimit: { maxRequests: 50, windowSeconds: 3600, authRaisesLimit: true },
+  async getStats(pkg, options) {
+    const slash = pkg.indexOf("/");
+    if (slash === -1) return null;
+    const owner = pkg.slice(0, slash);
+    const name = pkg.slice(slash + 1);
+    const headers = {
+      "Accept": "application/vnd.github+json",
+      "X-GitHub-Api-Version": "2022-11-28"
+    };
+    if (options?.ghcrToken) {
+      headers["Authorization"] = `Bearer ${options.ghcrToken}`;
+    }
+    const versions = await fetchWithRetry(
+      `${API5}/orgs/${owner}/packages/container/${encodeURIComponent(name)}/versions?per_page=100`,
+      "ghcr",
+      { headers }
+    );
+    if (!versions || !Array.isArray(versions)) return null;
+    const now = Date.now();
+    const DAY = 864e5;
+    let activity7d = 0;
+    let activity30d = 0;
+    let lastPublished = null;
+    for (const v of versions) {
+      const created = v.created_at ? new Date(v.created_at).getTime() : 0;
+      if (created > 0) {
+        const age = now - created;
+        if (age <= 7 * DAY) activity7d++;
+        if (age <= 30 * DAY) activity30d++;
+        if (!lastPublished || v.created_at > lastPublished) {
+          lastPublished = v.created_at;
+        }
+      }
+    }
+    const tags = versions.flatMap((v) => v.metadata?.container?.tags ?? []);
+    return {
+      registry: "ghcr",
+      package: pkg,
+      downloads: {
+        total: versions.length,
+        // versionCount as primary number
+        lastWeek: activity7d,
+        // new versions in 7d
+        lastMonth: activity30d
+        // new versions in 30d
+      },
+      extra: {
+        metricType: "versions",
+        // signals this is version activity, not downloads
+        tags: tags.slice(0, 10),
+        versionCount: versions.length,
+        activity7d,
+        activity30d,
+        lastPublished
+      },
+      fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+};
+
 // src/calc.ts
 var calc = {
   total(records) {
@@ -607,7 +674,8 @@ var providers = {
   pypi,
   nuget,
   vscode,
-  docker
+  docker,
+  ghcr
 };
 function registerProvider(provider) {
   providers[provider.name] = provider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcptoolshop/registry-stats",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Multi-registry download stats for npm, PyPI, NuGet, VS Code Marketplace, and Docker Hub",
   "type": "module",
   "main": "./dist/index.cjs",