@anonymilyhq/cli 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,54 @@
+# @anonymilyhq/cli
+
+The official CLI for [Anonymily](https://anonymily.com), a simple and powerful webhook relayer.
+
+With the Anonymily CLI, you can forward webhooks directly from Anonymily to your local machine, allowing you to easily test, inspect, and debug incoming webhooks in real-time.
+
+## Installation
+
+You can install the CLI globally using npm:
+
+```bash
+npm install -g @anonymilyhq/cli
+```
+
+Alternatively, you can run it directly using `npx`:
+
+```bash
+npx @anonymilyhq/cli listen 8080
+```
+
+## Usage
+
+Start listening for incoming webhooks and forward them to a specific port on your localhost:
+
+```bash
+anonymily listen <port>
+```
+
+### Example
+
+To forward webhooks to your local development server running on port `3000` with a randomly generated endpoint ID:
+
+```bash
+anonymily listen 3000
+```
+
+To specify a custom endpoint ID (e.g., `stripe-test`) so that your URL is consistently `api.anonymily.com/h/stripe-test`:
+
+```bash
+anonymily listen 3000 --id stripe-test
+```
+
+1. The CLI will output a webhook connection URL and automatically connect via Server-Sent Events.
+2. Send your webhooks to the provided URL.
+3. The CLI will receive the requests natively and forward them precisely to `http://localhost:3000`, preserving exactly the same method, body, queries, and headers.
+
+
+## Issues
+
+If you encounter a bug, please create an issue in the main repository or contact our support.
+
+## License
+
+MIT

package/bin/cli.js

@@ -1,9 +1,8 @@
 #!/usr/bin/env node
 
-import { EventSource as EventSourceConstructor } from 'eventsource';
-
 import { program } from 'commander';
-import pc from 'picocolors';
+import { generateHookId } from '../lib/utils.js';
+import { startForwarding } from '../lib/forwarder.js';
 
 // Point this to your live production backend URL
 const API_URL = process.env.ANONYMILY_API_URL || 'https://api.anonymily.com';
@@ -17,57 +16,10 @@ program
     .command('listen')
     .description('Listen for incoming webhooks and forward them to a local port')
     .argument('<port>', 'Local port to forward to (e.g., 8080)')
-    .action((port) => {
-        startListening(port);
+    .option('-i, --id <id>', 'Provide a custom endpoint ID to listen to')
+    .action((port, options) => {
+        const hookId = options.id || generateHookId();
+        startForwarding(API_URL, hookId, parseInt(port, 10));
     });
 
-program.parse();
-
-async function startListening(port) {
-    // 1. Generate a random Hook ID
-    const hookId = Math.random().toString(36).substring(2, 10);
-    const webhookUrl = `${API_URL}/h/${hookId}`;
-    const localUrl = `http://localhost:${port}`;
-
-    console.log(pc.green(pc.bold(`\n🚀 Anonymily CLI is running!`)));
-    console.log(`\nForwarding: ${pc.cyan(webhookUrl)}  ➔  ${pc.cyan(localUrl)}`);
-    console.log(pc.dim(`Waiting for requests to arrive...\n`));
-
-    // 2. Connect to the Server-Sent Events stream using the safe constructor
-    const es = new EventSourceConstructor(`${API_URL}/stream/${hookId}`);
-
-    es.onmessage = async (event) => {
-        const reqData = JSON.parse(event.data);
-        const { method, headers, query, body } = reqData;
-
-        // 3. Clean up headers before forwarding
-        const forwardHeaders = { ...headers };
-        delete forwardHeaders.host;
-        delete forwardHeaders.connection;
-
-        // Reconstruct query parameters
-        const queryString = new URLSearchParams(query).toString();
-        const fullLocalUrl = queryString ? `${localUrl}?${queryString}` : localUrl;
-
-        console.log(pc.yellow(`[${new Date().toLocaleTimeString()}] ⚡ Incoming ${method} request...`));
-
-        try {
-            // 4. Forward the exact payload to localhost
-            const response = await fetch(fullLocalUrl, {
-                method: method,
-                headers: forwardHeaders,
-                body: ['GET', 'HEAD'].includes(method) ? undefined : JSON.stringify(body)
-            });
-
-            const statusColor = response.ok ? pc.green : pc.red;
-            console.log(`  └─ Forwarded to localhost | Status: ${statusColor(response.status)}\n`);
-        } catch (err) {
-            console.log(pc.red(`  └─ Error forwarding: ${err.message}`));
-            console.log(pc.dim(`     Make sure your local server is actually running on port ${port}\n`));
-        }
-    };
-
-    es.onerror = () => {
-        console.error(pc.red(`\nConnection error. Attempting to reconnect...`));
-    };
-}
+program.parse();

package/lib/forwarder.js

@@ -0,0 +1,48 @@
+import { EventSource as EventSourceConstructor } from 'eventsource';
+import pc from 'picocolors';
+import { logger } from './logger.js';
+
+export function startForwarding(apiUrl, hookId, port) {
+    const webhookUrl = `${apiUrl}/h/${hookId}`;
+    const localUrl = `http://localhost:${port}`;
+
+    logger.success(pc.bold(`\n🚀 Anonymily CLI is running!`));
+    logger.raw(`\nForwarding: ${pc.cyan(webhookUrl)}  ➔  ${pc.cyan(localUrl)}`);
+    logger.dim(`Waiting for requests to arrive...\n`);
+
+    const es = new EventSourceConstructor(`${apiUrl}/stream/${hookId}`);
+
+    es.onmessage = async (event) => {
+        try {
+            const reqData = JSON.parse(event.data);
+            const { method, headers, query, body } = reqData;
+
+            const forwardHeaders = { ...headers };
+            delete forwardHeaders.host;
+            delete forwardHeaders.connection;
+
+            const queryString = new URLSearchParams(query || {}).toString();
+            const fullLocalUrl = queryString ? `${localUrl}?${queryString}` : localUrl;
+
+            logger.warn(`[${new Date().toLocaleTimeString()}] ⚡ Incoming ${method} request...`);
+
+            const response = await fetch(fullLocalUrl, {
+                method: method,
+                headers: forwardHeaders,
+                body: ['GET', 'HEAD'].includes(method) ? undefined : JSON.stringify(body)
+            });
+
+            const statusColor = response.ok ? pc.green : pc.red;
+            logger.raw(`  └─ Forwarded to localhost | Status: ${statusColor(response.status)}\n`);
+        } catch (err) {
+            logger.error(`  └─ Error forwarding: ${err.message}`);
+            logger.dim(`     Make sure your local server is actually running on port ${port}\n`);
+        }
+    };
+
+    es.onerror = () => {
+        logger.dim(`\n[Network] Connection dropped. Automatically reconnecting...`);
+    };
+
+    return es;
+}

package/lib/logger.js

@@ -0,0 +1,11 @@
+import pc from 'picocolors';
+
+export const logger = {
+    info: (msg) => console.log(pc.cyan(msg)),
+    success: (msg) => console.log(pc.green(msg)),
+    warn: (msg) => console.log(pc.yellow(msg)),
+    error: (msg) => console.log(pc.red(msg)),
+    dim: (msg) => console.log(pc.dim(msg)),
+    bold: (msg) => console.log(pc.bold(msg)),
+    raw: (msg) => console.log(msg),
+};

package/lib/utils.js

@@ -0,0 +1,3 @@
+export function generateHookId() {
+    return Math.random().toString(36).substring(2, 10);
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@anonymilyhq/cli",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "CLI for Anonymily platform",
   "type": "module",
   "bin": {
-    "anonymily": "./bin/cli.js"
+    "anonymily": "bin/cli.js"
   },
   "scripts": {
     "start": "node ./bin/cli.js"
@@ -16,9 +16,11 @@
     "devtools",
     "api-client"
   ],
+  "author": "Anonymily",
+  "license": "MIT",
   "files": [
     "bin",
-    "index.js",
+    "lib",
     "README.md"
   ],
   "dependencies": {
@@ -26,4 +28,4 @@
     "eventsource": "^4.1.0",
     "picocolors": "^1.1.1"
   }
-}
+}