npmjscli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rocketor
+
+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,102 @@
+# 📦 npmjscli
+
+> Beautiful CLI for npm registry operations
+
+[![npm version](https://img.shields.io/npm/v/npmjscli.svg)](https://www.npmjs.com/package/npmjscli)
+[![license](https://img.shields.io/npm/l/npmjscli.svg)](https://github.com/rocketor/npmjscli/blob/main/LICENSE)
+
+## ✨ Features
+
+- 🔍 **Search** - Find packages in the npm registry
+- 📊 **Stats** - View download statistics
+- 📦 **Info** - Get detailed package information
+- 🚀 **Publish** - Publish your packages with ease
+- 📋 **Packages** - List all packages by a user
+
+## 🚀 Installation
+
+```bash
+npm install -g npmjscli
+```
+
+## 📖 Usage
+
+### Main command
+
+```bash
+npmjs <command> [options]
+```
+
+### Individual commands
+
+```bash
+# Get package info
+npmjs-info express
+npmjs-info express --json
+
+# Search packages
+npmjs-search react
+npmjs-search react --limit 50
+
+# Download stats
+npmjs-stats express
+npmjs-stats express --period last-week
+
+# List user packages (requires auth)
+export NPM_TOKEN=your_token_here
+npmjs-packages
+npmjs-packages --user rocketor
+
+# Publish package (requires auth)
+npmjs-publish
+npmjs-publish --tag beta --access public
+```
+
+## 🔐 Authentication
+
+Set your npm token as an environment variable:
+
+```bash
+export NPM_TOKEN=npm_xxxxxxxxxxxx
+```
+
+Or add to your `~/.bashrc` or `~/.zshrc`:
+
+```bash
+echo 'export NPM_TOKEN=your_token' >> ~/.bashrc
+```
+
+## 🛠️ Commands
+
+| Command | Description | Auth Required |
+|---------|-------------|---------------|
+| `info` | Get package metadata | No |
+| `search` | Search registry | No |
+| `stats` | Download statistics | No |
+| `packages` | List user packages | Yes |
+| `publish` | Publish package | Yes |
+
+## 📋 Examples
+
+```bash
+# Get info about Express
+npmjs info express
+
+# Search for React packages
+npmjs search react --limit 10
+
+# Check weekly downloads
+npmjs stats express --period last-week
+
+# List your packages
+export NPM_TOKEN=your_token
+npmjs packages
+```
+
+## 📝 License
+
+MIT © [rocketor](https://github.com/rocketor)
+
+---
+
+Made with 💜 by Cake Command

package/bin/npmjs-info.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * npmjs-info - Get package info
+ */
+const { getPackageInfo, formatPackage, colors } = require('../lib/utils');
+
+async function main() {
+  const args = process.argv.slice(2);
+  const pkgName = args[0];
+  const json = args.includes('--json');
+
+  if (!pkgName) {
+    console.log(`${colors.yellow}Usage: npmjs-info <package> [--json]${colors.reset}`);
+    process.exit(1);
+  }
+
+  try {
+    const data = await getPackageInfo(pkgName);
+    if (json) {
+      console.log(JSON.stringify(data, null, 2));
+    } else {
+      console.log(formatPackage(data));
+    }
+  } catch (err) {
+    console.log(`${colors.red}Error: ${err.message}${colors.reset}`);
+    process.exit(1);
+  }
+}
+
+main();

package/bin/npmjs-packages.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * npmjs-packages - List user packages
+ */
+const { getUserPackages, colors } = require('../lib/utils');
+
+async function main() {
+  const args = process.argv.slice(2);
+  const userIdx = args.indexOf('--user');
+  const user = userIdx >= 0 ? args[userIdx + 1] : null;
+  const json = args.includes('--json');
+  const token = process.env.NPM_TOKEN;
+
+  if (!token) {
+    console.log(`${colors.red}Error: NPM_TOKEN environment variable required${colors.reset}`);
+    process.exit(1);
+  }
+
+  try {
+    const data = await getUserPackages(user, token);
+    if (json) {
+      console.log(JSON.stringify(data, null, 2));
+    } else {
+      const packages = data.objects || [];
+      const username = user || process.env.NPM_USERNAME || 'you';
+      
+      console.log(`${colors.cyan}📦 Packages by ${username} (${packages.length} found)${colors.reset}\n`);
+      
+      for (const item of packages) {
+        const pkg = item.package;
+        console.log(`${colors.green}${pkg.name}${colors.reset}@${colors.yellow}${pkg.version}${colors.reset}`);
+        if (pkg.description) {
+          console.log(`  ${pkg.description.substring(0, 70)}${pkg.description.length > 70 ? '...' : ''}`);
+        }
+        console.log();
+      }
+    }
+  } catch (err) {
+    console.log(`${colors.red}Error: ${err.message}${colors.reset}`);
+    process.exit(1);
+  }
+}
+
+main();

package/bin/npmjs-publish.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+/**
+ * npmjs-publish - Publish package
+ */
+const { spawn } = require('child_process');
+const { colors } = require('../lib/utils');
+
+function runNpm(args) {
+  return new Promise((resolve, reject) => {
+    const npm = spawn('npm', ['publish', ...args], {
+      stdio: 'inherit',
+      env: process.env
+    });
+    npm.on('close', code => {
+      if (code === 0) resolve();
+      else reject(new Error(`npm publish failed with code ${code}`));
+    });
+  });
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const token = process.env.NPM_TOKEN;
+
+  if (!token) {
+    console.log(`${colors.red}Error: NPM_TOKEN environment variable required${colors.reset}`);
+    process.exit(1);
+  }
+
+  console.log(`${colors.cyan}📤 Publishing package...${colors.reset}\n`);
+
+  try {
+    await runNpm(args);
+    console.log(`\n${colors.green}✅ Published successfully!${colors.reset}`);
+  } catch (err) {
+    console.log(`\n${colors.red}❌ Publish failed${colors.reset}`);
+    process.exit(1);
+  }
+}
+
+main();

package/bin/npmjs-search.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * npmjs-search - Search npm registry
+ */
+const { searchPackages, colors } = require('../lib/utils');
+
+async function main() {
+  const args = process.argv.slice(2);
+  const query = args[0];
+  const limitIdx = args.indexOf('--limit');
+  const limit = limitIdx >= 0 ? parseInt(args[limitIdx + 1]) : 20;
+  const json = args.includes('--json');
+
+  if (!query) {
+    console.log(`${colors.yellow}Usage: npmjs-search <query> [--limit 20]${colors.reset}`);
+    process.exit(1);
+  }
+
+  try {
+    const data = await searchPackages(query, limit);
+    if (json) {
+      console.log(JSON.stringify(data, null, 2));
+    } else {
+      console.log(`${colors.cyan}🔍 Results for "${query}" (${data.objects?.length || 0} found)${colors.reset}\n`);
+      
+      for (const item of data.objects || []) {
+        const pkg = item.package;
+        console.log(`${colors.green}${pkg.name}${colors.reset}@${colors.yellow}${pkg.version}${colors.reset}`);
+        if (pkg.description) {
+          console.log(`  ${pkg.description.substring(0, 70)}${pkg.description.length > 70 ? '...' : ''}`);
+        }
+        if (pkg.publisher?.username) {
+          console.log(`  ${colors.dim}by ${pkg.publisher.username}${colors.reset}`);
+        }
+        console.log();
+      }
+    }
+  } catch (err) {
+    console.log(`${colors.red}Error: ${err.message}${colors.reset}`);
+    process.exit(1);
+  }
+}
+
+main();

package/bin/npmjs-stats.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * npmjs-stats - Get download statistics
+ */
+const { getStats, colors } = require('../lib/utils');
+
+async function main() {
+  const args = process.argv.slice(2);
+  const pkgName = args[0];
+  const periodIdx = args.indexOf('--period');
+  const period = periodIdx >= 0 ? args[periodIdx + 1] : 'last-month';
+  const json = args.includes('--json');
+
+  if (!pkgName) {
+    console.log(`${colors.yellow}Usage: npmjs-stats <package> [--period last-day|last-week|last-month]${colors.reset}`);
+    process.exit(1);
+  }
+
+  try {
+    const data = await getStats(pkgName, period);
+    if (json) {
+      console.log(JSON.stringify(data, null, 2));
+    } else {
+      console.log(`${colors.cyan}📊 ${data.package || pkgName}${colors.reset}`);
+      console.log(`   Downloads (${period}): ${colors.green}${data.downloads?.toLocaleString() || 0}${colors.reset}`);
+      if (data.start && data.end) {
+        console.log(`   Period: ${data.start} to ${data.end}`);
+      }
+    }
+  } catch (err) {
+    console.log(`${colors.red}Error: ${err.message}${colors.reset}`);
+    process.exit(1);
+  }
+}
+
+main();

package/bin/npmjs.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * npmjscli - Beautiful CLI for npm registry
+ * Main entry point
+ */
+
+const { showHelp, showVersion, colors } = require('../lib/utils');
+
+const commands = {
+  'info': 'Get package information',
+  'packages': 'List user packages',
+  'publish': 'Publish package',
+  'stats': 'Download statistics',
+  'search': 'Search registry',
+  'version': 'Bump version',
+  'help': 'Show help'
+};
+
+function main() {
+  const args = process.argv.slice(2);
+  const cmd = args[0];
+
+  if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
+    showHelp(commands);
+    return;
+  }
+
+  if (cmd === '--version' || cmd === '-v') {
+    showVersion();
+    return;
+  }
+
+  if (commands[cmd]) {
+    // Delegate to subcommand
+    const subcmd = require(`../lib/${cmd}`);
+    subcmd.run(args.slice(1));
+  } else {
+    console.log(`${colors.red}Unknown command: ${cmd}${colors.reset}`);
+    console.log(`Run ${colors.cyan}npmjs help${colors.reset} for available commands`);
+    process.exit(1);
+  }
+}
+
+main();

package/lib/utils.js

@@ -0,0 +1,128 @@
+/**
+ * Shared utilities for npmjscli
+ */
+const https = require('https');
+
+const REGISTRY = 'https://registry.npmjs.org';
+const API_BASE = 'https://api.npmjs.org';
+
+// Pretty colors
+const colors = {
+  reset: '\x1b[0m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  white: '\x1b[37m',
+  dim: '\x1b[2m'
+};
+
+// HTTP fetch helper
+function fetch(url, token) {
+  return new Promise((resolve, reject) => {
+    const options = new URL(url);
+    const headers = {};
+    if (token) headers['Authorization'] = `Bearer ${token}`;
+    
+    https.get(options, { headers }, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => {
+        if (res.statusCode >= 400) {
+          reject(new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`));
+        } else {
+          resolve(JSON.parse(data));
+        }
+      });
+    }).on('error', reject);
+  });
+}
+
+// API functions
+function getPackageInfo(name, token) {
+  return fetch(`${REGISTRY}/${name}`, token);
+}
+
+function getUserPackages(user, token) {
+  const username = user || '';
+  return fetch(`${REGISTRY}/-/v1/search?text=maintainer:${username}&size=250`, token);
+}
+
+function getStats(pkg, period) {
+  return fetch(`${API_BASE}/downloads/point/${period}/${pkg}`);
+}
+
+function searchPackages(query, limit = 20) {
+  return fetch(`${REGISTRY}/-/v1/search?text=${encodeURIComponent(query)}&size=${limit}`);
+}
+
+// Formatting
+function formatPackage(data) {
+  const lines = [
+    `${colors.cyan}📦 ${data.name}${colors.reset}`,
+    `   Latest: ${colors.yellow}${data['dist-tags']?.latest || 'N/A'}${colors.reset}`,
+    `   Description: ${data.description || 'N/A'}`,
+    `   Author: ${data.author?.name || data.author || 'N/A'}`,
+    `   License: ${data.license || 'N/A'}`,
+  ];
+  
+  const versions = Object.keys(data.versions || {});
+  lines.push(`   Versions: ${versions.length} total`);
+  
+  if (versions.length > 0) {
+    lines.push(`   Recent: ${versions.slice(-5).join(', ')}`);
+  }
+  
+  if (data.time?.modified) {
+    lines.push(`   Last updated: ${data.time.modified}`);
+  }
+  
+  return lines.join('\n');
+}
+
+function showHelp(commands) {
+  console.log(`${colors.cyan}
+╔══════════════════════════════════════════╗
+║           📦 npmjscli v1.0.0             ║
+║     Beautiful CLI for npm registry       ║
+╚══════════════════════════════════════════╝
+${colors.reset}
+Usage: npmjs <command> [options]
+
+Commands:`);
+
+  const maxLen = Math.max(...Object.keys(commands).map(c => c.length));
+  for (const [cmd, desc] of Object.entries(commands)) {
+    console.log(`  ${colors.green}${cmd.padEnd(maxLen)}${colors.reset}  ${desc}`);
+  }
+
+  console.log(`
+Examples:
+  ${colors.yellow}npmjs info express${colors.reset}
+  ${colors.yellow}npmjs packages --user rocketor${colors.reset}
+  ${colors.yellow}npmjs search react --limit 10${colors.reset}
+  ${colors.yellow}npmjs stats express --period last-week${colors.reset}
+
+Environment:
+  ${colors.cyan}NPM_TOKEN${colors.reset}    Your npm access token (for auth commands)
+`);
+}
+
+function showVersion() {
+  const pkg = require('../package.json');
+  console.log(`${colors.cyan}npmjscli${colors.reset} v${pkg.version}`);
+}
+
+module.exports = {
+  colors,
+  fetch,
+  getPackageInfo,
+  getUserPackages,
+  getStats,
+  searchPackages,
+  formatPackage,
+  showHelp,
+  showVersion
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "npmjscli",
+  "version": "1.0.0",
+  "description": "Beautiful CLI for npm registry operations",
+  "main": "index.js",
+  "bin": {
+    "npmjs": "./bin/npmjs.js",
+    "npmjs-info": "./bin/npmjs-info.js",
+    "npmjs-packages": "./bin/npmjs-packages.js",
+    "npmjs-publish": "./bin/npmjs-publish.js",
+    "npmjs-stats": "./bin/npmjs-stats.js",
+    "npmjs-search": "./bin/npmjs-search.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "npm",
+    "registry",
+    "cli",
+    "package",
+    "publish",
+    "stats"
+  ],
+  "author": "rocketor <rocketor@npmjs.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rocketor/npmjscli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rocketor/npmjscli/issues"
+  },
+  "homepage": "https://github.com/rocketor/npmjscli#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}