@vibe-db/cli 1.0.0

package/BILLING_CLI.md

@@ -0,0 +1,198 @@
+# VibeDB CLI - Billing Commands
+
+The VibeDB CLI now includes full billing management capabilities!
+
+## Available Commands
+
+### View Billing Information
+
+```bash
+vibedb billing info
+```
+
+Shows:
+- Stripe customer ID
+- Current subscription status
+- Payment method on file
+- Upcoming invoice details
+
+**Example output:**
+```
+💳 Billing Information
+
+Stripe Customer ID: cus_TlhoFBgSVv10yz
+
+Subscription:
+  Status: ● Active
+  Period: Jan 10, 2026 → Feb 10, 2026
+
+Payment Method:
+  Card: visa ****4242
+  Expires: 12/2025
+
+Upcoming Invoice:
+  Amount: $10.00
+  Period: Feb 10, 2026 → Mar 10, 2026
+```
+
+### Subscribe
+
+```bash
+vibedb billing subscribe
+```
+
+Creates a new subscription with interactive prompts:
+- Checks if you already have an active subscription
+- Verifies payment method is on file
+- Confirms before creating subscription
+- Shows subscription details on success
+
+**Note:** You need to add a payment method in the Stripe dashboard first.
+
+### Cancel Subscription
+
+```bash
+vibedb billing cancel
+```
+
+Cancels your subscription with confirmation:
+- Shows current subscription details
+- Warns about access ending at period end
+- Requires confirmation
+- Subscription remains active until period end
+
+### View Invoices
+
+```bash
+vibedb billing invoices
+```
+
+Lists all your invoices in a table format:
+- Date
+- Amount
+- Status (paid/open/unpaid)
+- Billing period
+- PDF download link for latest invoice
+
+**Example output:**
+```
+📄 Your Invoices
+
+┌───────────────┬────────────┬────────────┬──────────────────────────────┐
+│ Date          │ Amount     │ Status     │ Period                       │
+├───────────────┼────────────┼────────────┼──────────────────────────────┤
+│ Jan 10, 2026  │ $10.00     │ paid       │ Jan 10 - Feb 10              │
+│ Dec 10, 2025  │ $10.00     │ paid       │ Dec 10 - Jan 10              │
+└───────────────┴────────────┴────────────┴──────────────────────────────┘
+
+Total: 2 invoices
+Latest invoice PDF: https://...
+```
+
+## Quick Start
+
+1. **Sign up or login:**
+   ```bash
+   vibedb signup
+   # or
+   vibedb login
+   ```
+
+2. **Check billing status:**
+   ```bash
+   vibedb billing info
+   ```
+
+3. **Add payment method:**
+   - Go to Stripe dashboard
+   - Find your customer (search by email)
+   - Add payment method (test card: 4242 4242 4242 4242)
+
+4. **Subscribe:**
+   ```bash
+   vibedb billing subscribe
+   ```
+
+5. **View invoices:**
+   ```bash
+   vibedb billing invoices
+   ```
+
+## Error Handling
+
+All commands gracefully handle common errors:
+
+- **Not logged in:** Prompts to run `vibedb login` or `vibedb signup`
+- **Billing not configured:** Shows warning that Stripe isn't set up on server
+- **No payment method:** Provides instructions for adding one
+- **Already subscribed:** Shows current subscription details
+- **No subscription:** Shows helpful message about subscribing
+
+## Full Command List
+
+```bash
+vibedb billing --help
+```
+
+Shows:
+```
+Usage: vibedb billing [options] [command]
+
+Manage billing and subscriptions
+
+Commands:
+  info            View billing information and subscription status
+  subscribe       Subscribe to VibeDB
+  cancel          Cancel your subscription
+  invoices        View your invoices
+  help [command]  display help for command
+```
+
+## Test Cards (Stripe Test Mode)
+
+When testing subscriptions, use these test cards:
+
+- **Success:** 4242 4242 4242 4242
+- **Declined:** 4000 0000 0000 0002
+- **Requires 3DS:** 4000 0027 6000 3184
+
+Any future expiry date and any 3-digit CVC will work.
+
+## Integration with AI Assistants
+
+The CLI billing commands work great in AI-assisted development workflows:
+
+**Tell your AI:**
+```
+"Check my VibeDB billing status"
+"Subscribe me to VibeDB"
+"Show my VibeDB invoices"
+"Cancel my VibeDB subscription"
+```
+
+The AI assistant can run these commands and show you the results!
+
+## Files Added
+
+New command files:
+- `/cli/src/commands/billing-info.js` - View billing info
+- `/cli/src/commands/billing-subscribe.js` - Subscribe
+- `/cli/src/commands/billing-cancel.js` - Cancel subscription
+- `/cli/src/commands/billing-invoices.js` - View invoices
+
+Updated files:
+- `/cli/bin/vibedb.js` - Added billing subcommands
+- `/cli/src/api.js` - Added billing API methods
+
+## Next Steps
+
+- ✅ All billing commands working
+- ✅ Full error handling
+- ✅ Pretty formatted output with colors and tables
+- ✅ Interactive confirmations for destructive actions
+- 🔜 Add payment method via CLI (future enhancement)
+- 🔜 Update subscription plan (future enhancement)
+
+---
+
+**The billing system is now fully manageable from the CLI!** 🎉