errorhub-cli 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,111 @@
+# errorhub-cli
+
+Official CLI for [ErrorHub](https://errorhub.vercel.app) — authenticate, manage projects and configure error tracking directly from your terminal.
+
+---
+
+## Installation
+
+```bash
+npm install -g errorhub-cli
+```
+
+Or use without installing:
+
+```bash
+npx errorhub-cli <command>
+```
+
+---
+
+## Quick Start
+
+```bash
+# 1. Login to your ErrorHub account
+errorhub login
+
+# 2. Link your project using its API key
+errorhub project <your-api-key>
+
+# 3. Verify your session
+errorhub whoami
+```
+
+---
+
+## Commands
+
+### `errorhub login`
+
+Opens your browser and walks you through the authentication flow. Your JWT token is saved locally at `~/.token.json` and reused for all subsequent commands.
+
+```bash
+errorhub login
+```
+
+---
+
+### `errorhub project <apiKey>`
+
+Links a project to your local environment using its API key. The project ID is saved to `~/projectId.json` and used by the SDK automatically.
+
+```bash
+errorhub project abc123yourkey
+```
+
+---
+
+### `errorhub whoami`
+
+Displays your currently authenticated account and token details — including expiry, role, and email decoded from the JWT.
+
+```bash
+errorhub whoami
+```
+
+---
+
+### `errorhub init`
+
+Initializes your workspace and launches the auth flow for first-time setup.
+
+```bash
+errorhub init
+```
+
+---
+
+## Getting Your API Key
+
+1. Sign in at [errorhub.vercel.app](https://errorhub.vercel.app)
+2. Open or create a project
+3. Copy the API key from the project settings
+4. Run `errorhub project <your-api-key>`
+
+---
+
+## Token Storage
+
+| File | Contents |
+|---|---|
+| `~/.token.json` | Your JWT auth token |
+| `~/projectId.json` | Your linked project ID |
+
+To log out, simply delete `~/.token.json`:
+
+```bash
+rm ~/.token.json
+```
+
+---
+
+## Requirements
+
+- Node.js `v18` or higher
+- An account at [errorhub.vercel.app](https://errorhub.vercel.app)
+
+---
+
+## License
+
+MIT © [ErrorHub](https://errorhub.vercel.app)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "errorhub-cli",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "",
   "main": "index.js",
   "type": "module",

package/src/index.ts

@@ -6,19 +6,17 @@ import express from 'express';
 import fs from 'fs';
 import os from 'os';
 import path from 'path';
+import net from 'net';
 import { fileURLToPath } from 'url';
 import clc from 'cli-color';
-import { json } from 'stream/consumers';
 
 const program = new Command();
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const CONFIG_PATH = path.join(os.homedir(), '.token.json');
-const PROJECTS = path.join(os.homedir(), 'projectId.json')
+const PROJECTS = path.join(os.homedir(), 'projectId.json');
 
-
-// ─── Color Palette ──────────────────────────────────────────
-// ─────────────────
+// ─── Color Palette ────────────────────────────────────────────────────────────
 const c = {
   cyan:       clc.xterm(51).bold,
   cyanDim:    clc.xterm(38),
@@ -35,16 +33,18 @@ const c = {
   bgGreen:    clc.bgXterm(28),
   bgOrange:   clc.bgXterm(208),
 };
+
 const FRONTENDBASE = "https://errorhub.vercel.app";
+
 // ─── Layout Helpers ───────────────────────────────────────────────────────────
-const W = 62; // box width
+const W = 62;
 
 const line  = (char = '─') => c.teal('─'.repeat(W));
 const dLine = () => c.teal('═'.repeat(W));
 const blank = () => console.log(c.teal('│') + ' '.repeat(W - 2) + c.teal('│'));
 
 const boxRow = (text: string, color = c.white) => {
-  const inner = W - 4; // 2 border chars + 2 padding chars
+  const inner = W - 4;
   const stripped = text.replace(/\x1B\[[0-9;]*m/g, '');
   const pad = Math.max(0, inner - stripped.length);
   const left = Math.floor(pad / 2);
@@ -80,7 +80,6 @@ const LOGO = [
 const printLogo = () => {
   console.log('');
   LOGO.forEach((row, i) => {
-    // Gradient: cyan → teal → green
     const color = i < 3 ? c.cyan : i < 6 ? c.teal : c.green;
     console.log(color(row));
   });
@@ -112,7 +111,7 @@ const badge = {
   loading: (msg: string) => console.log(c.cyan('  ⟳ ') + c.cyanDim(msg)),
 };
 
-// ─── Spinner (simple dot progress) ───────────────────────────────────────────
+// ─── Spinner ──────────────────────────────────────────────────────────────────
 const spinner = (label: string) => {
   const frames = ['⠋', '⠙', '⠸', '⠴', '⠦', '⠇'];
   let i = 0;
@@ -128,18 +127,32 @@ const spinner = (label: string) => {
 // ─── Section Divider ──────────────────────────────────────────────────────────
 const section = (title: string) => {
   console.log('');
-  const line = '─'.repeat(4);
-  console.log(c.teal(line) + ' ' + c.yellow(title.toUpperCase()) + ' ' + c.teal(line));
+  const l = '─'.repeat(4);
+  console.log(c.teal(l) + ' ' + c.yellow(title.toUpperCase()) + ' ' + c.teal(l));
 };
 
+// ─── Free Port Helper ─────────────────────────────────────────────────────────
+function getFreePort(startPort = 4000): Promise<number> {
+  return new Promise((resolve) => {
+    const server = net.createServer();
+    server.listen(startPort, () => {
+      const port = (server.address() as net.AddressInfo).port;
+      server.close(() => resolve(port));
+    });
+    server.on('error', () => {
+      resolve(getFreePort(startPort + 1));
+    });
+  });
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 //  CLI Setup
 // ─────────────────────────────────────────────────────────────────────────────
 
 program
-  .name('errorhub')
+  .name('errorhub-cli')
   .description('CLI with JWT login')
-  .version('1.0.0');
+  .version('1.0.1');
 
 // ─────────────────────────────────────────────────────────────────────────────
 //  INIT
@@ -148,33 +161,29 @@ program
 program
   .command('init')
   .description('Initialize project')
-  .action(() => {
+  .action(async () => {
     printLogo();
-
     printBanner('PROJECT INITIALIZER', 'Setting up your workspace...');
-
     console.log(c.teal('│'));
     labelRow('Version:', '1.0.0');
     labelRow('Node:', process.version);
     labelRow('Platform:', process.platform);
     labelRow('CWD:', process.cwd().slice(0, 40));
     console.log(c.teal('│'));
-
     closeBanner();
 
     section('Launching Auth Server');
     console.log('');
 
     const app = express();
-    const port = 4000;
-    const stop = spinner('Starting local server on port 4000...');
+    const port = await getFreePort();
+    const stop = spinner(`Starting local server on port ${port}...`);
 
     const server = app.listen(port, () => {
       stop();
       badge.ok(`Server listening on ${c.cyan(`http://localhost:${port}`)}`);
 
       const loginUrl = `${FRONTENDBASE}/login?callback=http://localhost:${port}/callback`;
-
       badge.info(`Opening: ${c.cyanDim(loginUrl)}`);
       console.log('');
       open(loginUrl);
@@ -195,28 +204,23 @@ program
   .description('Login and store JWT')
   .action(async () => {
     printLogo();
-
     printBanner('AUTHENTICATION', 'Secure JWT login flow');
-
-    labelRow('Callback Port:', '4000');
     labelRow('Auth Server:', FRONTENDBASE);
     labelRow('Config Path:', CONFIG_PATH.replace(os.homedir(), '~'));
     console.log(c.teal('│'));
-
     closeBanner();
 
     section('Starting OAuth Flow');
     console.log('');
 
     const app = express();
-    const port = 4000;
-    const stop = spinner('Binding to port 4000...');
+    const port = await getFreePort();
+    const stop = spinner(`Binding to port ${port}...`);
 
     const server = app.listen(port, () => {
       stop();
       const loginUrl = `${FRONTENDBASE}/login?callback=http://localhost:${port}/callback`;
-
-      badge.ok('Local callback server ready');
+      badge.ok(`Local callback server ready on port ${c.cyan(String(port))}`);
       badge.loading('Opening browser for login...');
       console.log('');
       open(loginUrl);
@@ -231,9 +235,7 @@ program
         return;
       }
 
-      // Save token
       fs.writeFileSync(CONFIG_PATH, JSON.stringify({ token }, null, 2));
-
       res.send(renderHtmlPage('Success!', '✔ Login successful — you may close this tab.', '#00e5a0'));
 
       section('Login Complete');
@@ -272,11 +274,11 @@ program
 
     if (!fs.existsSync(CONFIG_PATH)) {
       console.log('');
-      badge.error('No credentials found. Run ' + c.cyan('login-cli login') + ' first.');
+      badge.error('No credentials found. Run ' + c.cyan('errorhub login') + ' first.');
       console.log('');
       console.log(c.teal('┌' + '─'.repeat(W - 2) + '┐'));
       boxRow('NOT AUTHENTICATED', c.red);
-      boxRow('Use:  login-cli login', c.dim);
+      boxRow('Use:  errorhub login', c.dim);
       console.log(c.teal('└' + '─'.repeat(W - 2) + '┘'));
       console.log('');
       return;
@@ -285,43 +287,38 @@ program
     const data = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
     const { token } = data;
 
-    // Decode JWT header/payload for display (no verification)
     let jwtInfo: { header?: any; payload?: any } = {};
     try {
       const [h, p] = token.split('.');
       jwtInfo.header  = JSON.parse(Buffer.from(h, 'base64').toString());
       jwtInfo.payload = JSON.parse(Buffer.from(p, 'base64').toString());
     } catch {
-      // not a valid JWT, just show raw
+      // not a valid JWT
     }
 
     section('Stored Token');
     console.log('');
-
     console.log(c.teal('┌' + '─'.repeat(W - 2) + '┐'));
 
     if (jwtInfo.payload) {
       const p = jwtInfo.payload;
-
-      // Header meta
       boxRow('JWT DECODED', c.yellow);
       console.log(c.teal('├' + '─'.repeat(W - 2) + '┤'));
 
       const fields: [string, any][] = Object.entries({
-        sub:  p.sub  ?? '—',
-        name: p.name ?? '—',
+        sub:   p.sub   ?? '—',
+        name:  p.name  ?? '—',
         email: p.email ?? '—',
-        role: p.role ?? '—',
-        iat:  p.iat  ? new Date(p.iat  * 1000).toISOString() : '—',
-        exp:  p.exp  ? new Date(p.exp  * 1000).toISOString() : '—',
-        alg:  jwtInfo.header?.alg ?? '—',
+        role:  p.role  ?? '—',
+        iat:   p.iat   ? new Date(p.iat  * 1000).toISOString() : '—',
+        exp:   p.exp   ? new Date(p.exp  * 1000).toISOString() : '—',
+        alg:   jwtInfo.header?.alg ?? '—',
       });
 
       for (const [k, v] of fields) {
         labelRow(`${k}:`, String(v));
       }
 
-      // Expiry warning
       if (jwtInfo.payload.exp) {
         const expired = Date.now() / 1000 > jwtInfo.payload.exp;
         console.log(c.teal('├' + '─'.repeat(W - 2) + '┤'));
@@ -331,60 +328,56 @@ program
 
     console.log(c.teal('├' + '─'.repeat(W - 2) + '┤'));
     boxRow('RAW TOKEN', c.yellow);
-
-    // Print token split at 58 chars per line
     const chunks = token.match(/.{1,54}/g) ?? [token];
     for (const chunk of chunks) {
       boxRow(chunk, c.cyanDim);
     }
-
     console.log(c.teal('└' + '─'.repeat(W - 2) + '┘'));
     console.log('');
   });
 
-
+// ─────────────────────────────────────────────────────────────────────────────
+//  PROJECT
+// ─────────────────────────────────────────────────────────────────────────────
 
 program
   .command('project <apiKey>')
   .description('Find and store project by API key')
   .action(async (apiKey) => {
-    // 1. check if token exists
     if (!fs.existsSync(CONFIG_PATH)) {
-      badge.error('Not logged in. Run errorhub login first.')
-      return
+      badge.error('Not logged in. Run errorhub login first.');
+      return;
     }
 
-    // 2. read token
-    const data = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'))
-    const token = data.token
+    const data = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+    const token = data.token;
 
-    // 3. fetch all projects
-    const response = await fetch(`${FRONTENDBASE}/projects`, {
-      headers: {
-        Authorization: `Bearer ${token}`
-      }
-    })
-    const projects = await response.json()
+    const stop = spinner('Fetching projects...');
 
-    // 4. find matching project
-    const match = projects.find((p: any) => p.api_key === apiKey)
+    try {
+      const response = await fetch(`${FRONTENDBASE}/api/projects`, {
+        headers: { Authorization: `Bearer ${token}` }
+      });
+      const projects = await response.json();
+      stop();
 
-    // 5. no match found
-    if (!match) {
-      badge.error('No project found with that API key.')
-      return
-    }
+      const match = projects.find((p: any) => p.api_key === apiKey);
 
-    // 6. save projectId
-    fs.writeFileSync(PROJECTS, JSON.stringify({ projectId: match.id }, null, 2))
+      if (!match) {
+        badge.error('No project found with that API key.');
+        return;
+      }
 
-    // 7. confirm
-    badge.ok(`Project found and saved: ${match.id}`)
-  })
+      fs.writeFileSync(PROJECTS, JSON.stringify({ projectId: match.id }, null, 2));
+      badge.ok(`Project found and saved: ${c.cyan(match.id)}`);
+    } catch (e) {
+      stop();
+      badge.error('Failed to fetch projects. Check your connection.');
+    }
+  });
 
-  
-// ─────────────────────────=────────────────────────────────────────────────────
-//  HTML response page helper
+// ─────────────────────────────────────────────────────────────────────────────
+//  HTML Helper
 // ─────────────────────────────────────────────────────────────────────────────
 
 function renderHtmlPage(title: string, message: string, color: string): string {