@fusionfroze/statsy 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FusionFroze
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# Statsy
+
+Get basic stats about public **npm** packages maintained by you, in your terminal.
+
+## Installation
+
+**Prerequisite:** Node.js v18+
+
+**Install Globally:**
+
+```shell
+Publication to NPM registry is pending
+```
+
+**For Local Development:**
+
+After cloning the repo into your machine locally, run these -
+
+```shell
+$ npm install
+```
+
+```shell
+$ npm link
+```
+
+## How to Use it
+
+### Setting up
+
+After installing, run -
+
+```shell
+$ statsy setup
+```
+
+This will open an input interface and ask for two things (both saved locally in your machine) -
+
+- **_Your npm username_**
+- **_Your personal Github Access token_**
+
+(**Tip:** To know more about github access tokens [click here](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic). Remember to select the _repo_ scope, otherwise the api will not be able to fetch info about your repository.)
+
+### Viewing stats
+
+**_statsy_** support four options, each showing a different stat. These are as follows -
+
+```shell
+Options:
+  -v, --version    current version of the package
+  -s, --stars      star count on the repository of the package on github
+  -i, --issues     issue count on the repository of the package on github
+  -d, --downloads  download count of the package from npm registry
+```
+
+You can run the command in four ways -
+
+```shell
+$ statsy
+```
+
+Shows all four stats for all packages maintained by you.
+
+```shell
+$ statsy -d -i
+```
+
+or
+
+```shell
+$ statsy -di
+```
+
+Shows only the download and issues count for all packages.
+
+```shell
+$ statsy examplePackage
+```
+
+Shows all stats for a single specified package (examplePackage).
+
+```shell
+$ statsy examplePackage -d
+```
+
+Shows only the download count for a single specified package.
+
+### Resetting your credentials
+
+To delete/reset your credentials, run -
+
+```shell
+$ statsy reset
+```
+
+You will be asked to give your confirmation once. Once confirmed, the action is irreversible.

package/commands/reset.js

@@ -0,0 +1,32 @@
+import chalk from "chalk";
+import Conf from "conf";
+import { confirm } from "@inquirer/prompts";
+
+const conf = new Conf({ projectName: "statsy" });
+
+export default async function reset() {
+  const config = conf.get();
+  const credentials = Object.keys(config);
+
+  if (credentials.length === 0) {
+    console.log(
+      chalk.red(
+        `You don't have your credentials set yet\nRun ${chalk.white("statsy setup")} to set it up`,
+      ),
+    );
+    process.exit(1);
+  }
+
+  const answer = await confirm({ message: "Are you sure?" });
+  if (!answer) {
+    process.exit(0);
+  }
+
+  conf.clear();
+  console.log(
+    chalk.green(
+      `Your credentials have been reset\nRun ${chalk.white("statsy setup")} to set it again`,
+    ),
+  );
+  process.exit(0);
+}

package/commands/setup.js

@@ -0,0 +1,52 @@
+import Conf from "conf";
+import { input, password } from "@inquirer/prompts";
+import chalk from "chalk";
+
+const conf = new Conf({ projectName: "statsy" });
+
+async function takeInput() {
+  const npmUsername = await input({
+    message: "Enter your NPM username:",
+    required: true,
+  });
+  const githubToken = await password({
+    message: "Enter your Github access token:",
+    mask: true,
+  });
+
+  const config = {
+    npmUsername: npmUsername,
+    githubToken: githubToken,
+  };
+
+  return config;
+}
+
+export default async function setup() {
+  let config = conf.get();
+  const credentials = Object.keys(config);
+
+  if (credentials.length === 0) {
+    try {
+      const config = await takeInput();
+      conf.set(config);
+
+      console.log(
+        `\nYour credentials are saved successfully.\nuse ${chalk.blue("statsy -h")} for usage information`,
+      );
+
+      process.exit(0);
+    } catch (error) {
+      if (error instanceof Error && error.name === "ExitPromptError") {
+        console.log(chalk.magenta("Until next time 🫡"));
+        process.exit(1);
+      } else {
+        throw error;
+      }
+    }
+  }
+
+  console.log(
+    `Already set.\nUse ${chalk.blue("statsy reset")} to clear your current setup.`,
+  );
+}

package/index.js

@@ -0,0 +1,44 @@
+#! /usr/bin/env node
+
+import { program } from "commander";
+import showStats from "./lib/showStats.js";
+import setup from "./commands/setup.js";
+import table from "text-table";
+import reset from "./commands/reset.js";
+
+program
+  .command("setup")
+  .description("setup your credentials for fetching package information")
+  .action(setup);
+
+program.command("reset").description("reset your credentials").action(reset);
+
+program
+  .argument("[package_name]", "name of the package", undefined)
+  .option("-v, --version", "current version of the package")
+  .option(
+    "-s, --stars",
+    "star count on the repository of the package on github",
+  )
+  .option(
+    "-i, --issues",
+    "issue count on the repository of the package on github",
+  )
+  .option("-d, --downloads", "download count of the package from npm registry")
+  .addHelpText(
+    "after",
+    `\nExample usage:\n${table([
+      ["  statsy", "(all packages, all stats)"],
+      ["  statsy -d", "(only download count for all packages)"],
+      ["  statsy example", "(all stats only for package named 'example')"],
+      [
+        "  statsy example -d -s",
+        "(only download and star count for package named 'example')",
+      ],
+    ])}\n`,
+  )
+  .action((package_name, options) => {
+    showStats(package_name, options);
+  });
+
+program.parse();

package/lib/fetchStats.js

@@ -0,0 +1,114 @@
+import chalk from "chalk";
+
+export default async function fetchStats(packageName, config) {
+  const packageData = await getPackageData(packageName, config);
+
+  if (!packageData) {
+    console.log(
+      chalk.red(
+        `Something went wrong!\nPlease check your internet connection...`,
+      ),
+    );
+    process.exit(1);
+  }
+
+  if (!packageData[0]) {
+    console.error(chalk.red(`Package named ${packageName} not found!`));
+    process.exit(1);
+  }
+
+  const rowPromises = packageData.map(async (p) => {
+    try {
+      const downloadDataResponse = await fetch(
+        `https://api.npmjs.org/downloads/point/last-week/${p.package.name}`,
+      );
+
+      if (!downloadDataResponse.ok) {
+        throw new Error(
+          `Can't fetch download stats: ${downloadDataResponse.status}`,
+        );
+      }
+
+      const downloadData = await downloadDataResponse.json();
+
+      let repositoryData = { starsCount: "N/A", issuesCount: "N/A" };
+
+      const scopedPackageName = p.package.name;
+      const packageVersion = p.package.version;
+
+      const repositoryUrl = p.package.links?.repository;
+
+      if (repositoryUrl) {
+        const urlWithoutExtention = repositoryUrl.split(".git")[0];
+        const finalRepoUrlArray = urlWithoutExtention.split("/");
+        const ownerName = finalRepoUrlArray[finalRepoUrlArray.length - 2];
+        const repositoryName = finalRepoUrlArray[finalRepoUrlArray.length - 1];
+
+        try {
+          const repositoryDataResponse = await fetch(
+            `https://api.github.com/repos/${ownerName}/${repositoryName}`,
+            {
+              headers: {
+                Authorization: `Bearer ${config["githubToken"]}`,
+              },
+            },
+          );
+
+          if (!repositoryDataResponse.ok) {
+            throw new Error(
+              `Failed to fetch repository data from Github: ${repositoryDataResponse.status}`,
+            );
+          }
+
+          const r = await repositoryDataResponse.json();
+          repositoryData.starsCount = r.stargazers_count;
+          repositoryData.issuesCount = r.open_issues_count;
+        } catch (error) {
+          console.error(chalk.red(error.message));
+        }
+      }
+
+      return {
+        package: scopedPackageName,
+        version: packageVersion,
+        stars: repositoryData.starsCount,
+        issues: repositoryData.issuesCount,
+        downloads: downloadData.downloads,
+      };
+    } catch (error) {
+      console.error(chalk.red(error.message));
+    }
+  });
+
+  const rows = await Promise.all(rowPromises);
+  return rows;
+}
+
+async function getPackageData(pkg, config) {
+  const npmUrl = `https://registry.npmjs.org/-/v1/search?text=maintainer:${config["npmUsername"]}`;
+
+  try {
+    const allPackageDataResponse = await fetch(npmUrl);
+
+    if (!allPackageDataResponse.ok) {
+      throw new Error(
+        `NPM package fetch failed: ${allPackageDataResponse.status}`,
+      );
+    }
+
+    const allPackageData = await allPackageDataResponse.json();
+
+    if (pkg) {
+      const packageArray = allPackageData.objects;
+      const requestedPackage = packageArray.find((p) =>
+        p["package"].name.includes(pkg),
+      );
+
+      return [requestedPackage];
+    }
+
+    return allPackageData.objects;
+  } catch (error) {
+    console.error(chalk.red(error.message));
+  }
+}

package/lib/showStats.js

@@ -0,0 +1,59 @@
+import Conf from "conf";
+import table from "text-table";
+import chalk from "chalk";
+import fetchStats from "./fetchStats.js";
+
+const conf = new Conf({ projectName: "statsy" });
+
+export default async function showStats(packageName, options) {
+  let config = conf.get();
+  const credentials = Object.keys(config);
+
+  if (credentials.length === 0) {
+    console.error(
+      chalk.red(
+        `Credentials has not been set up.\n${chalk.white(`Run ${chalk.bold("statsy setup")} first...`)}`,
+      ),
+    );
+
+    process.exit(1);
+  }
+
+  const rowsObjectArray = await fetchStats(packageName, config);
+
+  const optionsArray = Object.keys(options);
+
+  if (optionsArray.length === 0) {
+    const rows = rowsObjectArray.map((row) => {
+      return [row.package, row.version, row.stars, row.issues, row.downloads];
+    });
+
+    const t = table([
+      ["Package", "Version", "Stars", "Issues", "Downloads"],
+      ...rows,
+    ]);
+    console.log(t);
+  } else {
+    const headerRow = generateHeaderRow(optionsArray);
+
+    const dataRows = rowsObjectArray.map((row) => {
+      const r = [row.package];
+      for (let i = 0; i < headerRow.length; i++) {
+        const key = headerRow[i].toLowerCase();
+        r.push(row[key]);
+      }
+      return r;
+    });
+
+    const t = table([["Package", ...headerRow], ...dataRows]);
+    console.log(t);
+  }
+}
+
+function generateHeaderRow(optionsArray) {
+  const headerRow = optionsArray.map((option) => {
+    return option.charAt(0).toUpperCase() + option.slice(1);
+  });
+
+  return headerRow;
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@fusionfroze/statsy",
+  "version": "1.0.0",
+  "description": "Get stats about the npm packages maintained by you in your terminal",
+  "license": "MIT",
+  "author": "FusionFroze",
+  "type": "module",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.3.2",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "conf": "^15.1.0",
+    "text-table": "^0.2.0"
+  },
+  "bin": {
+    "statsy": "index.js"
+  },
+  "keywords": [
+    "statsy",
+    "cli",
+    "package",
+    "terminal"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FusionFroze/statsy"
+  },
+  "homepage": "https://github.com/FusionFroze/statsy/#readme",
+  "bugs": {
+    "url": "https://github.com/FusionFroze/statsy/issues"
+  }
+}