ragebuttonapi 1.0.0

package/cli.js

@@ -0,0 +1,307 @@
+#!/usr/bin/env node
+/**
+ * RAGEBUTTONAPI™ CLI — rage from ur terminal
+ * install: npm install -g ragebuttonapi
+ * usage:
+ *   rage                      → register a rage (prompts for reason)
+ *   rage setup                → configure server url + api key
+ *   rage "this bug is insane" → rage with inline reason
+ *   rage --reason "msg"       → rage with reason flag
+ *   rage stats                → global stats
+ *   rage feed                 → live feed
+ *   rage --help               → help
+ */
+
+'use strict';
+
+const readline = require('readline');
+const fs       = require('fs');
+const path     = require('path');
+const os       = require('os');
+const rageApi  = require('./index.js');
+
+const CONFIG_PATH = path.join(os.homedir(), '.ragebuttonapirc');
+const VERSION     = '1.0.0';
+
+// ─── Config file helpers ──────────────────────────────────────────────────────
+function loadConfig() {
+    try {
+        if (fs.existsSync(CONFIG_PATH)) {
+            return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8'));
+        }
+    } catch { /* corrupt config, treat as missing */ }
+    return {};
+}
+
+function saveConfig(cfg) {
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2), { mode: 0o600 });
+}
+
+// ─── Colors (no deps, raw ANSI) ───────────────────────────────────────────────
+const c = {
+    reset  : '\x1b[0m',
+    bold   : '\x1b[1m',
+    dim    : '\x1b[2m',
+    red    : '\x1b[31m',
+    green  : '\x1b[32m',
+    yellow : '\x1b[33m',
+    blue   : '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan   : '\x1b[36m',
+    white  : '\x1b[37m',
+};
+
+const acc = s => `${c.magenta}${c.bold}${s}${c.reset}`;
+const dim = s => `${c.dim}${s}${c.reset}`;
+const ok  = s => `${c.green}${s}${c.reset}`;
+const err = s => `${c.red}${s}${c.reset}`;
+const hl  = s => `${c.cyan}${s}${c.reset}`;
+
+function logo() {
+    console.log(`
+${acc('💢 RAGEBUTTONAPI™')} ${dim(`v${VERSION}`)}
+${dim('─────────────────────────────────────────')}
+`);
+}
+
+// ─── Prompts (pure readline, no deps) ────────────────────────────────────────
+function prompt(question) {
+    return new Promise(resolve => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(question, ans => { rl.close(); resolve(ans.trim()); });
+    });
+}
+
+function promptPassword(question) {
+    return new Promise(resolve => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        // hide input
+        process.stdout.write(question);
+        process.stdin.setRawMode?.(true);
+        let pass = '';
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+
+        const handler = ch => {
+            if (ch === '\r' || ch === '\n') {
+                process.stdin.setRawMode?.(false);
+                process.stdin.removeListener('data', handler);
+                process.stdin.pause();
+                console.log('');
+                rl.close();
+                resolve(pass);
+            } else if (ch === '\u0003') { // ctrl+c
+                process.exit(0);
+            } else if (ch === '\u007f' || ch === '\b') {
+                pass = pass.slice(0, -1);
+            } else {
+                pass += ch;
+                process.stdout.write('*');
+            }
+        };
+
+        process.stdin.on('data', handler);
+    });
+}
+
+// ─── Setup command ────────────────────────────────────────────────────────────
+async function cmdSetup(existing = {}) {
+    logo();
+    console.log(`${acc('Setup')} — lets get u configured fr\n`);
+
+    const defaultUrl = existing.url || '';
+    let serverUrl = await prompt(
+        `Server URL ${defaultUrl ? dim(`[${defaultUrl}]`) : ''}: `
+    );
+    if (!serverUrl && defaultUrl) serverUrl = defaultUrl;
+    if (!serverUrl) { console.log(err('\nurls cant be empty. try again.')); process.exit(1); }
+    serverUrl = serverUrl.replace(/\/$/, '');
+
+    const defaultKey = existing.apiKey ? '***' + existing.apiKey.slice(-4) : '';
+    console.log(`\nAPI Key (from ur dashboard)${defaultKey ? dim(` [${defaultKey}]`) : ''}:`);
+    let apiKey;
+    try {
+        apiKey = await promptPassword('> ');
+    } catch {
+        // fallback if raw mode unavailable (piped stdin etc)
+        apiKey = await prompt('API Key: ');
+    }
+    if (!apiKey && existing.apiKey) apiKey = existing.apiKey;
+    if (!apiKey) { console.log(err('\napi key cant be empty bestie.')); process.exit(1); }
+
+    const cfg = { url: serverUrl, apiKey };
+    saveConfig(cfg);
+
+    console.log(`\n${ok('✓')} saved to ${dim(CONFIG_PATH)}`);
+    console.log(`\n  url: ${hl(serverUrl)}`);
+    console.log(`  key: ${dim('***' + apiKey.slice(-4))}\n`);
+    console.log(ok(`all done! run ${hl('rage')} anytime to register ur suffering 💢\n`));
+}
+
+// ─── Rage command ─────────────────────────────────────────────────────────────
+async function cmdRage(reason, cfg) {
+    if (!cfg.url || !cfg.apiKey) {
+        console.log(`\n${err('not configured yet fr.')} run ${hl('rage setup')} first.\n`);
+        process.exit(1);
+    }
+
+    // ask for reason if not provided inline
+    if (reason === null || reason === undefined) {
+        reason = await prompt(`${dim('what broke? (enter to skip):')} `);
+    }
+
+    process.stdout.write(`\n${acc('💢')} registering ur rage...`);
+
+    try {
+        rageApi.init({ url: cfg.url, apiKey: cfg.apiKey });
+        const res = await rageApi.rage(reason, { source: 'cli' });
+
+        process.stdout.write('\r' + ' '.repeat(40) + '\r'); // clear the "registering..." line
+
+        console.log(`\n  ${acc('💢 RAGE REGISTERED')}\n`);
+        console.log(`  ${ok('✓')} message:    ${dim(res.message)}`);
+        console.log(`  ${ok('✓')} ur total:   ${hl(res.your_total)} rages`);
+        console.log(`  ${ok('✓')} streak:     ${hl(res.your_streak + 'd')} 🔥`);
+        console.log(`  ${ok('✓')} rank:       ${hl(res.rank_emoji + ' ' + res.rank)}`);
+        console.log(`  ${ok('✓')} remaining:  ${hl(res.daily_remaining + '/24')} today`);
+        console.log(`  ${dim('cooldown:')}   ${res.cooldown_sec}s`);
+
+        if (res.new_achievements?.length) {
+            console.log('');
+            res.new_achievements.forEach(a => {
+                console.log(`  🏅 ${c.yellow}${c.bold}ACHIEVEMENT UNLOCKED${c.reset}: ${acc(a.name)}`);
+                console.log(`     ${dim(a.desc)}`);
+            });
+        }
+
+        if (reason) {
+            console.log(`\n  ${dim('reason:')} ${c.yellow}"${reason}"${c.reset}`);
+        }
+
+        console.log('');
+
+    } catch (e) {
+        process.stdout.write('\r' + ' '.repeat(40) + '\r');
+        if (e.code === 'cooldown') {
+            console.log(`\n  ${err('⏱️  cooldown active')} — ${e.message}\n`);
+        } else if (e.code === 'daily_limit') {
+            console.log(`\n  ${err('😤 daily limit hit')} — 24/24 rages today. iconic. come back tomorrow.\n`);
+        } else if (e.code === 'ECONNREFUSED' || e.code === 'ENOTFOUND') {
+            console.log(`\n  ${err('❌ couldnt connect')} — is ur server up? check the url in ur config (${dim('rage setup')} to edit)\n`);
+        } else {
+            console.log(`\n  ${err('💀 error:')} ${e.message}\n`);
+        }
+        process.exit(1);
+    }
+}
+
+// ─── Stats command ────────────────────────────────────────────────────────────
+async function cmdStats(cfg) {
+    if (!cfg.url) {
+        console.log(`\n${err('no url configured.')} run ${hl('rage setup')} first.\n`);
+        process.exit(1);
+    }
+    try {
+        const res = await rageApi.stats({ url: cfg.url });
+        logo();
+        console.log(`  ${acc('📊 global stats')}\n`);
+        console.log(`  total rages:  ${hl(Number(res.total_rages).toLocaleString())}`);
+        console.log(`  rages today:  ${hl(Number(res.today_rages).toLocaleString())}`);
+        console.log(`  total users:  ${hl(Number(res.user_count).toLocaleString())}`);
+        console.log('');
+    } catch (e) {
+        console.log(`\n  ${err('error:')} ${e.message}\n`);
+        process.exit(1);
+    }
+}
+
+// ─── Feed command ─────────────────────────────────────────────────────────────
+async function cmdFeed(limit, cfg) {
+    if (!cfg.url) {
+        console.log(`\n${err('no url configured.')} run ${hl('rage setup')} first.\n`);
+        process.exit(1);
+    }
+    try {
+        const res  = await rageApi.feed(limit, { url: cfg.url });
+        const feed = res.feed || [];
+        logo();
+        console.log(`  ${acc('🔴 live rage feed')} ${dim(`(last ${feed.length})`)} \n`);
+
+        if (!feed.length) {
+            console.log(`  ${dim('no rages yet... wild.')}`);
+        } else {
+            feed.forEach(item => {
+                const user = item.user === 'Anonymous Gremlin' ? dim('anonymous gremlin') : acc(item.user);
+                const time = dim(`  [${item.time_ago}]`);
+                const reason = item.reason ? `  ${c.yellow}"${item.reason}"${c.reset}` : '';
+                console.log(`  ${user}${time}`);
+                if (reason) console.log(`  ${reason}`);
+                console.log('');
+            });
+        }
+    } catch (e) {
+        console.log(`\n  ${err('error:')} ${e.message}\n`);
+        process.exit(1);
+    }
+}
+
+// ─── Help ─────────────────────────────────────────────────────────────────────
+function showHelp() {
+    logo();
+    console.log(`  ${acc('Commands')}\n`);
+    console.log(`  ${hl('rage')}                    → register rage (asks reason interactively)`);
+    console.log(`  ${hl('rage setup')}              → configure server url + api key`);
+    console.log(`  ${hl('rage stats')}              → global stats`);
+    console.log(`  ${hl('rage feed')}               → live rage feed`);
+    console.log(`  ${hl('rage "reason here"')}      → rage with inline reason`);
+    console.log(`  ${hl('rage --reason "msg"')}     → rage with reason flag`);
+    console.log(`  ${hl('rage --no-prompt')}        → rage silently (no reason prompt)`);
+    console.log(`  ${hl('rage --version')}          → show version`);
+    console.log(`  ${hl('rage --help')}             → this menu`);
+    console.log('');
+    console.log(`  ${dim('config stored at:')} ${CONFIG_PATH}`);
+    console.log('');
+}
+
+// ─── Main ─────────────────────────────────────────────────────────────────────
+async function main() {
+    const args   = process.argv.slice(2);
+    const cfg    = loadConfig();
+
+    // flags
+    const reasonFlag  = args.find((a, i) => a === '--reason' && args[i + 1]);
+    const reasonVal   = reasonFlag ? args[args.indexOf('--reason') + 1] : undefined;
+    const noPrompt    = args.includes('--no-prompt') || args.includes('--silent') || args.includes('-s');
+    const helpFlag    = args.includes('--help') || args.includes('-h');
+    const versionFlag = args.includes('--version') || args.includes('-v');
+
+    if (versionFlag) { console.log(`RAGEBUTTONAPI™ CLI v${VERSION}`); process.exit(0); }
+    if (helpFlag)    { showHelp(); process.exit(0); }
+
+    const subcommand = args.find(a => !a.startsWith('-'));
+
+    if (subcommand === 'setup')          { await cmdSetup(cfg);                         return; }
+    if (subcommand === 'stats')          { await cmdStats(cfg);                          return; }
+    if (subcommand === 'feed') {
+        const limit = parseInt(args[args.indexOf('feed') + 1]) || 10;
+        await cmdFeed(limit, cfg);
+        return;
+    }
+
+    // default: rage
+    // inline reason: first non-flag, non-subcommand arg
+    const inlineReason = args.find(a => !a.startsWith('-') && a !== 'rage');
+
+    let reason;
+    if (reasonVal !== undefined)              { reason = reasonVal;   }   // --reason "..."
+    else if (inlineReason !== undefined)      { reason = inlineReason; }  // rage "inline"
+    else if (noPrompt)                        { reason = '';            }  // --no-prompt
+    else                                      { reason = null;          }  // ask interactively
+
+    await cmdRage(reason, cfg);
+}
+
+main().catch(e => {
+    console.error(`\n${err('unexpected error:')} ${e.message}\n`);
+    process.exit(1);
+});

package/index.js

@@ -0,0 +1,145 @@
+/**
+ * RAGEBUTTONAPI™ — Official Node.js / npm Library
+ *
+ * Usage:
+ *   const rageApi = require('ragebuttonapi');
+ *
+ *   // one-time init
+ *   rageApi.init({ url: 'https://ragebutton.yoursite.com', apiKey: 'rbapi_xxx' });
+ *
+ *   // register rage
+ *   await rageApi.rage('this stupid bug omg');
+ *
+ *   // or inline config
+ *   await rageApi.rage('why', { url: '...', apiKey: '...' });
+ *
+ *   // get global stats
+ *   const stats = await rageApi.stats();
+ *
+ *   // get live feed
+ *   const feed = await rageApi.feed(5);
+ */
+
+'use strict';
+
+const https = require('https');
+const http  = require('http');
+const url   = require('url');
+
+let _globalConfig = { url: null, apiKey: null };
+
+// ─── low-level request helper ────────────────────────────────────────────────
+function request(endpoint, { method = 'GET', body = null } = {}) {
+    return new Promise((resolve, reject) => {
+        const parsed  = url.parse(endpoint);
+        const isHttps = parsed.protocol === 'https:';
+        const lib     = isHttps ? https : http;
+
+        const payload = body ? Object.entries(body)
+            .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v ?? '')}`)
+            .join('&') : null;
+
+        const opts = {
+            hostname: parsed.hostname,
+            port    : parsed.port || (isHttps ? 443 : 80),
+            path    : parsed.path,
+            method,
+            headers : {
+                'User-Agent': 'RAGEBUTTONAPI-npm/1.0',
+                ...(payload ? {
+                    'Content-Type'  : 'application/x-www-form-urlencoded',
+                    'Content-Length': Buffer.byteLength(payload),
+                } : {}),
+            },
+        };
+
+        const req = lib.request(opts, res => {
+            let data = '';
+            res.on('data', c => { data += c; });
+            res.on('end', () => {
+                try {
+                    const json = JSON.parse(data);
+                    if (!json.ok && json.error) {
+                        const err = new Error(json.error);
+                        err.data  = json;
+                        err.code  = json.reason || 'api_error';
+                        reject(err);
+                    } else {
+                        resolve(json);
+                    }
+                } catch {
+                    reject(new Error(`bad response from server (status ${res.statusCode}). is ur server up?`));
+                }
+            });
+        });
+
+        req.on('error', reject);
+        if (payload) req.write(payload);
+        req.end();
+    });
+}
+
+// ─── resolve config, merging inline overrides ────────────────────────────────
+function resolveConfig(inline = {}) {
+    const cfg = {
+        url   : inline.url    ?? _globalConfig.url,
+        apiKey: inline.apiKey ?? _globalConfig.apiKey,
+    };
+    if (!cfg.url)    throw new Error('ragebuttonapi: server url is required. call rageApi.init({ url }) or pass it inline.');
+    if (!cfg.apiKey) throw new Error('ragebuttonapi: apiKey is required. get it from ur dashboard.');
+    return { ...cfg, url: cfg.url.replace(/\/$/, '') };
+}
+
+// ─── Public API ──────────────────────────────────────────────────────────────
+
+/**
+ * One-time global config. call this at app startup.
+ * @param {{ url: string, apiKey: string }} config
+ */
+function init(config = {}) {
+    if (config.url)    _globalConfig.url    = config.url.replace(/\/$/, '');
+    if (config.apiKey) _globalConfig.apiKey = config.apiKey;
+}
+
+/**
+ * Register a rage. returns the API response with ur new stats.
+ * @param {string} [reason]  - optional, 255 char max
+ * @param {{ url?, apiKey?, source? }} [config] - inline config override
+ * @returns {Promise<{ok, total_rages, your_total, your_streak, rank, new_achievements, ...}>}
+ */
+async function rage(reason, config = {}) {
+    const { url: serverUrl, apiKey } = resolveConfig(config);
+    return request(`${serverUrl}/api/rage.php`, {
+        method: 'POST',
+        body  : {
+            api_key: apiKey,
+            reason : reason ?? '',
+            source : config.source ?? 'npm',
+        },
+    });
+}
+
+/**
+ * Get global stats (no auth required).
+ * @param {{ url? }} [config]
+ * @returns {Promise<{total_rages, today_rages, user_count}>}
+ */
+async function stats(config = {}) {
+    const serverUrl = config.url ?? _globalConfig.url;
+    if (!serverUrl) throw new Error('ragebuttonapi: url is required for stats()');
+    return request(`${serverUrl.replace(/\/$/, '')}/api/stats.php`);
+}
+
+/**
+ * Get the live rage feed (no auth required).
+ * @param {number} [limit=10]
+ * @param {{ url? }} [config]
+ * @returns {Promise<{ feed: Array<{user, reason, time_ago}> }>}
+ */
+async function feed(limit = 10, config = {}) {
+    const serverUrl = config.url ?? _globalConfig.url;
+    if (!serverUrl) throw new Error('ragebuttonapi: url is required for feed()');
+    return request(`${serverUrl.replace(/\/$/, '')}/api/feed.php?limit=${limit}`);
+}
+
+module.exports = { init, rage, stats, feed };

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "ragebuttonapi",
+  "version": "1.0.0",
+  "description": "official npm package + cli for RAGEBUTTONAPI™ — register developer rage from ur terminal or node app. no account needed for anon rages.",
+  "main": "index.js",
+  "bin": {
+    "rage": "cli.js",
+    "npm-cli": "cli.js",
+    "npmc": "cli.js"
+  },
+  "scripts": {
+    "test": "node cli.js --help"
+  },
+  "keywords": [
+    "rage",
+    "developer",
+    "api",
+    "cli",
+    "fun",
+    "mental-health",
+    "programming",
+    "anger"
+  ],
+  "author": "RAGEBUTTONAPI™",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}