@mcptoolshop/registry-stats 3.2.0 → 3.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -2
- package/dist/cli.js +288 -106
- package/dist/index.cjs +210 -46
- package/dist/index.d.cts +63 -4
- package/dist/index.d.ts +63 -4
- package/dist/index.js +210 -46
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -40,7 +40,7 @@ Zero runtime dependencies. Uses native `fetch()`. Node 18+.
|
|
|
40
40
|
| Layer | What it does |
|
|
41
41
|
|-------|-------------|
|
|
42
42
|
| **Engine** | TypeScript library + CLI + REST server + AI inference. Query five registries with one interface. Published to npm as `@mcptoolshop/registry-stats`. |
|
|
43
|
-
| **Dashboard** | Astro-powered web app with AI inference panel, Pulse AI co-pilot (streaming voice, web search, fullscreen, GitHub data connectors),
|
|
43
|
+
| **Dashboard** | Astro-powered web app with AI inference panel (health scores, forecasts, actionable advice), Pulse AI co-pilot (streaming voice, web search, fullscreen, GitHub data connectors), seven interactive charts with zoom/pan, live refresh, export reports (PDF / JSONL / Markdown), and tabbed Help guide. Rebuilt daily by CI; refreshable on demand. |
|
|
44
44
|
| **Desktop** | WinUI 3 + WebView2 native Windows app. Bundles the dashboard offline, fetches live stats on demand. |
|
|
45
45
|
|
|
46
46
|
## Dashboard
|
|
@@ -67,7 +67,7 @@ A self-updating stats dashboard lives at [`/dashboard/`](https://mcp-tool-shop-o
|
|
|
67
67
|
- **Dark / light theme** — follows system preference
|
|
68
68
|
- **Mobile responsive** — hamburger menu for small screens
|
|
69
69
|
|
|
70
|
-
Data is
|
|
70
|
+
Data is refreshed daily by CI (06:00 UTC) and the full site is rebuilt weekly (Mondays 06:00 UTC). Live refresh pulls the latest numbers directly from registry APIs on demand. Configure tracked packages in `site/src/data/packages.json`.
|
|
71
71
|
|
|
72
72
|
## AI Inference Engine
|
|
73
73
|
|
|
@@ -171,6 +171,12 @@ registry-stats express --compare
|
|
|
171
171
|
registry-stats express -r npm --range 2025-01-01:2025-06-30 --format csv
|
|
172
172
|
registry-stats express -r npm --range 2025-01-01:2025-06-30 --format chart
|
|
173
173
|
|
|
174
|
+
# Discover all your npm packages by maintainer name
|
|
175
|
+
registry-stats --mine mikefrilot
|
|
176
|
+
|
|
177
|
+
# JSON output for maintainer discovery
|
|
178
|
+
registry-stats --mine mikefrilot --format json
|
|
179
|
+
|
|
174
180
|
# Start a REST API server
|
|
175
181
|
registry-stats serve --port 3000
|
|
176
182
|
```
|
|
@@ -247,6 +253,10 @@ calc.toChartData(daily, 'express'); // { labels: [...], datasets: [{ labe
|
|
|
247
253
|
const comparison = await stats.compare('express');
|
|
248
254
|
await stats.compare('express', ['npm', 'pypi']); // specific registries only
|
|
249
255
|
|
|
256
|
+
// Maintainer discovery — find all npm packages by username
|
|
257
|
+
const mine = await stats.mine('mikefrilot');
|
|
258
|
+
// Returns PackageStats[] sorted by monthly downloads
|
|
259
|
+
|
|
250
260
|
// Caching (5 min TTL, in-memory)
|
|
251
261
|
const cache = createCache();
|
|
252
262
|
await stats('npm', 'express', { cache }); // fetches
|