pkg-stats 0.0.1

package/README.md

@@ -0,0 +1,3 @@
+## PKG Stats
+
+Beautiful package download stats.

package/dist/bin.js

@@ -0,0 +1,82 @@
+import { renderChart } from "./chart.js";
+import { parseVersion, versionCompare } from "./version.js";
+const PACKAGE_NAME = process.argv[2];
+const NPM_STATS_URL = `https://api.npmjs.org/versions/${encodeURIComponent(PACKAGE_NAME)}/last-week`;
+export async function bin() {
+    const response = await fetch(NPM_STATS_URL);
+    const data = await response.json();
+    const rawStats = Object.keys(data.downloads)
+        .map((versionString) => {
+        const version = parseVersion(versionString);
+        return {
+            ...version,
+            downloads: data.downloads[versionString],
+        };
+    })
+        .sort(versionCompare);
+    const groupedStats = sumByMajor(rawStats);
+    const totalDownloads = Object.values(groupedStats).reduce((sum, version) => sum + version.downloads, 0);
+    console.log(`${PACKAGE_NAME} weekly downloads\n`);
+    console.log(`Total: ${totalDownloads.toLocaleString()}.\n`);
+    console.log("By version:\n");
+    const maxDownloads = Math.max(...groupedStats.map((v) => v.downloads));
+    for (const item of groupedStats) {
+        console.log(`${item.versionString.padStart(6)} ${renderChart(item.downloads / maxDownloads)} ${formatDownloads(item.downloads, maxDownloads).padStart(6)}`);
+    }
+    console.log(`\nGenerated on ${new Date().toISOString().slice(0, 10)} by npm-stats.`);
+}
+function sumByMajor(stats) {
+    const result = {};
+    for (const versionStats of stats) {
+        const key = `${versionStats.major}`;
+        const entry = result[key] ?? {
+            version: { major: versionStats.major },
+            versionString: key,
+            downloads: 0,
+        };
+        result[key] = entry;
+        entry.downloads += versionStats.downloads;
+    }
+    return Object.values(result).sort((a, b) => versionCompare(a.version, b.version));
+}
+function sumByMinor(stats) {
+    const result = {};
+    for (const versionStats of stats) {
+        const key = `${versionStats.major}.${versionStats.minor}`;
+        const entry = result[key] ?? {
+            version: { major: versionStats.major, minor: versionStats.minor },
+            versionString: key,
+            downloads: 0,
+        };
+        result[key] = entry;
+        entry.downloads += versionStats.downloads;
+    }
+    return Object.values(result).sort((a, b) => versionCompare(a.version, b.version));
+}
+function sumByPatch(stats) {
+    const result = {};
+    for (const versionStats of stats) {
+        const key = `${versionStats.major}.${versionStats.minor}.${versionStats.patch}`;
+        const entry = result[key] ?? {
+            version: {
+                major: versionStats.major,
+                minor: versionStats.minor,
+                patch: versionStats.patch,
+            },
+            versionString: key,
+            downloads: 0,
+        };
+        result[key] = entry;
+        entry.downloads += versionStats.downloads;
+    }
+    return Object.values(result).sort((a, b) => versionCompare(a.version, b.version));
+}
+function formatDownloads(downloads, maxDownloads) {
+    if (maxDownloads > 1000000) {
+        return `${(downloads / 1000000).toFixed(1)}M`;
+    }
+    if (maxDownloads > 1000) {
+        return `${(downloads / 1000).toFixed(1)}K`;
+    }
+    return downloads.toString();
+}

package/dist/chart.js

@@ -0,0 +1,5 @@
+export function renderChart(value, { length = 50 } = {}) {
+    const filledChars = Math.round(value * length);
+    const emptyChars = length - filledChars;
+    return "█".repeat(filledChars) + " ".repeat(emptyChars);
+}

package/dist/index.js

@@ -0,0 +1,2 @@
+import { bin } from "./bin.js";
+bin();

package/dist/version.js

@@ -0,0 +1,25 @@
+export function parseVersion(version) {
+    const [versionCore, preRelease] = version.split("-");
+    const [major, minor, patch] = versionCore.split(".");
+    return {
+        major: Number(major),
+        minor: Number(minor),
+        patch: Number(patch),
+        preRelease,
+    };
+}
+export function versionCompare(a, b) {
+    if (a.major !== b.major) {
+        return b.major - a.major;
+    }
+    if (a.minor !== undefined && b.minor !== undefined && a.minor !== b.minor) {
+        return b.minor - a.minor;
+    }
+    if (a.patch !== undefined && b.patch !== undefined && a.patch !== b.patch) {
+        return b.patch - a.patch;
+    }
+    if (a.preRelease !== undefined && b.preRelease !== undefined) {
+        return a.preRelease.localeCompare(b.preRelease);
+    }
+    return 0;
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "pkg-stats",
+  "version": "0.0.1",
+  "description": "Beautiful package download stats",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "packageManager": "pnpm@9.15.0+sha512.76e2379760a4328ec4415815bcd6628dee727af3779aaa4c914e3944156c4299921a89f976381ee107d41f12cfa4b66681ca9c718f0668fa0831ed4c6d8ba56c",
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3"
+  }
+}