@anonymilyhq/cli 1.1.1 → 1.2.0

package/README.md

@@ -38,16 +38,17 @@ npm install -g @anonymilyhq/cli
 
 ## Quick Start
 
-**No account or signup required** — works immediately with free tier (50 requests, 24h retention).
+**No account or signup required** — works immediately with free tier (random ID, 50 requests, 24h retention).
 
 ```bash
-# Start listening — generates a random endpoint ID automatically
+# Start listening — generates a random 8-char endpoint ID automatically
 npx @anonymilyhq/cli listen 3000
 
 # Output:
 # 🚀 Anonymily CLI is running!
 # Forwarding: https://api.anonymily.com/h/xk92bzte  ➔  http://127.0.0.1:3000
 # Tier: 🆓 FREE | Storage: 0/50 | Retention: 24 hours
+# 💡 Upgrade to Pro for custom endpoint IDs + 500 req/30d at https://anonymily.com/upgrade
 # Waiting for requests to arrive...
 ```
 
@@ -79,35 +80,18 @@ anonymily listen <port> [options]
 | Option | Description |
 |--------|-------------|
 | `<port>` | **Required.** Local port to forward to (e.g. `3000`, `8080`) |
-| `-i, --id <id>` | Use a custom, memorable endpoint name (e.g. `stripe-test`) |
-| `--pro` | Register the hook as Pro-tier (legacy). Requires `--id` and a configured Pro API key |
+| `-i, --id <id>` | **Pro only.** Use a custom endpoint ID (e.g. `stripe-test`) instead of a random one. Requires Pro subscription (₹750/month). |
 
 **Examples:**
 ```bash
-# Random endpoint ID (ephemeral)
+# Random endpoint ID (Free tier: 50 requests, 24h retention)
 npx @anonymilyhq/cli listen 3000
 
-# Custom named endpoint → api.anonymily.com/h/stripe-dev
+# Custom named endpoint (Pro only: requires subscription + claiming via dashboard)
 npx @anonymilyhq/cli listen 3000 --id stripe-dev
 
-# Pro-tier named endpoint (legacy hook-based Pro)
-npx @anonymilyhq/cli listen 3000 --id stripe-dev --pro
-```
-
----
-
-### `config set-key <key>`
-
-Save your Pro API key locally so you don't need to export it every session.
-
-```bash
-anonymily config set-key <your-pro-api-key>
-```
-
-The key is stored in `~/.anonymily/config.json`. You can also set it via environment variable:
-
-```bash
-export PRO_API_KEY=<your-pro-api-key>
+# Use your Pro-claimed endpoint (500 requests, 30 days)
+npx @anonymilyhq/cli listen 3000 --id my-claimed-hook
 ```
 
 ---
@@ -143,20 +127,23 @@ Your feedback helps us improve Anonymily. All submissions are anonymous unless y
 
 ## Upgrading to Pro (₹750/month)
 
-To get Pro limits (500 requests, 30-day retention), you need a **paid Pro subscription** at [anonymily.com/upgrade](https://anonymily.com/upgrade). This is an account-level subscription — all your claimed hooks get Pro limits automatically.
-
-**Workflow:**
-1. Create an account at [anonymily.com/signup](https://anonymily.com/signup) (free)
-2. Subscribe to Pro at [anonymily.com/upgrade](https://anonymily.com/upgrade) (₹750/month)
-3. Open the dashboard, generate or use a custom hook ID
-4. Click "Claim for Pro" to associate the hook with your account
-5. Run the CLI with the same hook ID:
+**What Pro gives you:**
+- **Custom named endpoints** - Use memorable IDs like `stripe-prod` or `github-webhooks`
+- **Claim & manage** - Link endpoints to your account permanently via dashboard
+- **500 requests** per endpoint (vs 50 for Free random IDs)
+- **30-day retention** (vs 24 hours for Free tier)
+
+**How to upgrade and use custom endpoints:**
+1. Subscribe to Pro at [anonymily.com/upgrade](https://anonymily.com/upgrade) (₹750/month)
+2. Log in to your dashboard at [anonymily.com/dashboard](https://anonymily.com/dashboard)
+3. Enter your custom endpoint ID (e.g. `my-webhook`) and click "Claim"
+4. Run the CLI with your claimed hook ID:
    ```bash
-   npx @anonymilyhq/cli listen 3000 --id your-claimed-hook
+   npx @anonymilyhq/cli listen 3000 --id my-webhook
    ```
-6. All Pro limits apply automatically — 500 requests, 30-day history
+5. Enjoy Pro limits — 500 requests, 30-day history
 
-**Note:** Account creation is free, but Pro features require a paid subscription.
+**Important:** Custom endpoint IDs are a **Pro-only feature**. Free users can only use randomly-generated 8-character IDs with 50 requests and 24h retention.
 
 ---
 
@@ -185,12 +172,15 @@ External Service (Stripe, GitHub, etc.)
 
 | Feature | Free | Pro |
 |---------|------|-----|
+| Endpoint ID format | Random 8-char (e.g. `xk92bzte`) | Custom named (e.g. `stripe-prod`) |
 | Requests stored per hook | 50 | 500 |
 | History retention | 24 hours | 30 days |
-| Custom endpoint ID | ✅ | ✅ |
-| Persistent history in dashboard | ✅ | ✅ |
+| Hook claiming & management | ❌ | ✅ |
+| Dashboard access | ✅ | ✅ |
 | Price | Free | ₹750/month |
 
+**Note:** Custom endpoint IDs (via `--id` flag) are a **Pro-only feature**. Free users receive randomly-generated IDs.
+
 ---
 
 ## Testing Locally
@@ -233,7 +223,6 @@ npx @anonymilyhq/cli listen 4000
 
 | Variable | Description |
 |----------|-------------|
-| `PRO_API_KEY` | Legacy Pro API key (overrides `~/.anonymily/config.json`) |
 | `ANONYMILY_API_URL` | Override the backend URL (default: `https://api.anonymily.com`) |
 
 ---

package/bin/cli.js

@@ -4,13 +4,6 @@ import { program } from 'commander';
 import pc from 'picocolors';
 import { generateHookId } from '../lib/utils.js';
 import { startForwarding } from '../lib/forwarder.js';
-import { writeConfig, CONFIG_PATH } from '../lib/config.js';
-import {
-  registerProHook,
-  ProApiKeyMissingError,
-  ProApiAuthError,
-  ProApiError,
-} from '../lib/proRegister.js';
 import { logger } from '../lib/logger.js';
 import { submitFeedback } from '../lib/feedback.js';
 
@@ -20,7 +13,7 @@ const API_URL = process.env.ANONYMILY_API_URL || 'https://api.anonymily.com';
 program
   .name('anonymily')
   .description('Forward webhooks from Anonymily directly to your local machine.')
-  .version('1.1.1');
+  .version('1.2.0');
 
 // ---------------------------------------------------------------------------
 // listen
@@ -29,66 +22,12 @@ 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)')
-  .option('-i, --id <id>', 'Provide a custom endpoint ID to listen to')
-  .option(
-    '--pro',
-    'Register the hook as Pro-tier (requires --id and PRO_API_KEY)',
-  )
+  .option('-i, --id <id>', '[Pro only] Use a custom endpoint ID instead of random (requires ₹750/month subscription)')
   .action(async (port, options) => {
-    // --pro requires --id
-    if (options.pro && !options.id) {
-      logger.error(
-        pc.bold(
-          '--pro requires --id to specify a persistent hook name.',
-        ),
-      );
-      process.exit(1);
-    }
-
     const hookId = options.id || generateHookId();
-
-    if (options.pro) {
-      try {
-        await registerProHook(API_URL, hookId);
-      } catch (err) {
-        if (
-          err instanceof ProApiKeyMissingError ||
-          err instanceof ProApiAuthError ||
-          err instanceof ProApiError
-        ) {
-          logger.error(err.message);
-        } else {
-          logger.error(`Unexpected error during Pro registration: ${err.message}`);
-        }
-        process.exit(1);
-      }
-    }
-
     startForwarding(API_URL, hookId, parseInt(port, 10));
   });
 
-// ---------------------------------------------------------------------------
-// config
-// ---------------------------------------------------------------------------
-const configCmd = program
-  .command('config')
-  .description('Manage CLI configuration');
-
-configCmd
-  .command('set-key <key>')
-  .description(
-    'Save your Pro API key to ~/.anonymily/config.json',
-  )
-  .action((key) => {
-    if (!key || !key.trim()) {
-      logger.error('API key cannot be empty.');
-      process.exit(1);
-    }
-    writeConfig({ proApiKey: key.trim() });
-    logger.success(
-      `Pro API key saved to ${CONFIG_PATH}`,
-    );
-  });
 
 // ---------------------------------------------------------------------------
 // feedback

package/lib/forwarder.js

@@ -68,7 +68,7 @@ export async function startForwarding(apiUrl, hookId, port) {
         logger.raw(`Tier: ${tierColor(pc.bold(tierBadge))} | Storage: ${tierInfo.requestCount}/${tierInfo.maxRequests} | Retention: ${tierInfo.retention}`);
 
         if (tierInfo.tier === 'free') {
-            logger.dim(`\n💡 Upgrade to Pro for 500 requests + 30-day retention at https://anonymily.com/upgrade`);
+            logger.dim(`\n💡 Upgrade to Pro for custom endpoint IDs + 500 req/30d at https://anonymily.com/upgrade`);
         }
     }
 
@@ -118,7 +118,7 @@ export async function startForwarding(apiUrl, hookId, port) {
             if (requestCount === maxRequests) {
                 logger.warn(`⚠️  Tier limit reached (${maxRequests} requests). Older requests will be purged.\n`);
             } else if (requestCount === Math.floor(maxRequests * 0.9)) {
-                logger.warn(`⚠️  90% of tier limit reached. Consider upgrading to Pro for 500 requests.\n`);
+                logger.warn(`⚠️  90% of tier limit reached. Upgrade to Pro for 500 requests at https://anonymily.com/upgrade\n`);
             }
         } catch (err) {
             logger.error(`  └─ Error forwarding: ${err.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anonymilyhq/cli",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "CLI for Anonymily platform",
   "type": "module",
   "bin": {

package/lib/config.js

@@ -1,70 +0,0 @@
-/**
- * lib/config.js
- *
- * Read and write the Anonymily CLI config file at ~/.anonymily/config.json.
- * The config file stores user-scoped settings such as the Pro API key.
- *
- * Schema:
- *   {
- *     "proApiKey": "<string>"   // Pro subscriber API key
- *   }
- */
-
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join, dirname } from 'node:path';
-
-/** Absolute path to the config directory. */
-export const CONFIG_DIR = join(homedir(), '.anonymily');
-
-/** Absolute path to the config JSON file. */
-export const CONFIG_PATH = join(CONFIG_DIR, 'config.json');
-
-/**
- * Read and parse the config file.
- * Returns an empty object if the file doesn't exist yet.
- *
- * @returns {Record<string, unknown>}
- */
-export function readConfig() {
-  if (!existsSync(CONFIG_PATH)) return {};
-  try {
-    const raw = readFileSync(CONFIG_PATH, 'utf8');
-    return JSON.parse(raw);
-  } catch {
-    return {};
-  }
-}
-
-/**
- * Write (merge) key-value pairs into the config file.
- * Creates the config directory and file if they don't exist.
- *
- * @param {Record<string, unknown>} updates
- */
-export function writeConfig(updates) {
-  const existing = readConfig();
-  const merged = { ...existing, ...updates };
-
-  if (!existsSync(CONFIG_DIR)) {
-    mkdirSync(CONFIG_DIR, { recursive: true });
-  }
-
-  writeFileSync(CONFIG_PATH, JSON.stringify(merged, null, 2) + '\n', 'utf8');
-}
-
-/**
- * Retrieve the user's Pro API key.
- *
- * Resolution order (highest precedence first):
- *   1. PRO_API_KEY environment variable
- *   2. proApiKey field in ~/.anonymily/config.json
- *
- * @returns {string | undefined}
- */
-export function getProApiKey() {
-  if (process.env.PRO_API_KEY) return process.env.PRO_API_KEY;
-  const cfg = readConfig();
-  return typeof cfg.proApiKey === 'string' ? cfg.proApiKey : undefined;
-}
-

package/lib/proRegister.js

@@ -1,100 +0,0 @@
-/**
- * lib/proRegister.js
- *
- * Registers a hook ID as Pro-tier by calling the backend's
- * POST /hooks/pro/register endpoint.
- *
- * Acceptance criteria (ANO-47):
- *   - Uses the PRO_API_KEY from env or ~/.anonymily/config.json
- *   - If the key is missing → throws ProApiKeyMissingError
- *   - If the API returns 401 → throws ProApiAuthError
- *   - If the API returns any other non-2xx → throws ProApiError
- *   - On success → prints confirmation message and returns the response body
- */
-
-import pc from 'picocolors';
-import { logger } from './logger.js';
-import { getProApiKey } from './config.js';
-
-/** Thrown when no Pro API key is configured. */
-export class ProApiKeyMissingError extends Error {
-  constructor() {
-    super(
-      'Pro API key not configured. Run: anonymily config set-key <key>',
-    );
-    this.name = 'ProApiKeyMissingError';
-  }
-}
-
-/** Thrown when the backend returns 401 Unauthorized. */
-export class ProApiAuthError extends Error {
-  constructor() {
-    super(
-      'Pro API key is invalid or revoked. Please verify your key with: anonymily config set-key <key>',
-    );
-    this.name = 'ProApiAuthError';
-  }
-}
-
-/** Thrown when the backend returns any other non-2xx status. */
-export class ProApiError extends Error {
-  /** @param {number} status @param {string} [body] */
-  constructor(status, body = '') {
-    super(`Pro registration failed (HTTP ${status}): ${body}`);
-    this.name = 'ProApiError';
-    this.status = status;
-  }
-}
-
-/**
- * Register a hook ID as Pro-tier via the backend API.
- *
- * @param {string} apiUrl   Base URL, e.g. https://api.anonymily.com
- * @param {string} hookId   The hook ID to register
- * @returns {Promise<object>} Parsed response body from the API
- *
- * @throws {ProApiKeyMissingError}  No API key available
- * @throws {ProApiAuthError}        API returned 401
- * @throws {ProApiError}            API returned other non-2xx
- */
-export async function registerProHook(apiUrl, hookId) {
-  const apiKey = getProApiKey();
-
-  if (!apiKey) {
-    throw new ProApiKeyMissingError();
-  }
-
-  let response;
-  try {
-    response = await fetch(`${apiUrl}/hooks/pro/register`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'x-api-key': apiKey,
-      },
-      body: JSON.stringify({ hookId }),
-    });
-  } catch (networkErr) {
-    throw new Error(`Network error contacting Pro API: ${networkErr.message}`);
-  }
-
-  if (response.status === 401) {
-    throw new ProApiAuthError();
-  }
-
-  if (!response.ok) {
-    const body = await response.text().catch(() => '');
-    throw new ProApiError(response.status, body);
-  }
-
-  const data = await response.json().catch(() => ({}));
-
-  logger.success(
-    pc.bold(
-      `[Pro] Hook registered: persists for 30 days, up to 500 requests stored.`,
-    ),
-  );
-
-  return data;
-}
-