@insforge/cli 0.1.61 → 0.1.63

package/README.md

@@ -1,6 +1,6 @@
 # @insforge/cli
 
-Command line tool for the [InsForge](https://insforge.dev) platform. Manage your databases, edge functions, storage, deployments, secrets, and more — directly from the terminal.
+Command line tool for the [InsForge](https://insforge.dev) platform. Manage your databases, edge functions, storage, deployments, payments, secrets, and more — directly from the terminal.
 
 Designed to be both human-friendly (interactive prompts, formatted tables) and agent-friendly (structured JSON output, non-interactive mode, semantic exit codes).
 
@@ -63,12 +63,12 @@ npx @insforge/cli logout
 
 All commands support the following flags:
 
-| Flag | Description |
-|------|-------------|
-| `--json` | Output in JSON format (useful for scripts and AI agents) |
-| `--project-id <id>` | Override the linked project ID |
-| `--api-url <url>` | Override the Platform API URL |
-| `-y, --yes` | Skip confirmation prompts |
+| Flag                | Description                                              |
+| ------------------- | -------------------------------------------------------- |
+| `--json`            | Output in JSON format (useful for scripts and AI agents) |
+| `--project-id <id>` | Override the linked project ID                           |
+| `--api-url <url>`   | Override the Platform API URL                            |
+| `-y, --yes`         | Skip confirmation prompts                                |
 
 ## Commands
 
@@ -149,9 +149,11 @@ npx @insforge/cli logs <source> [options]
 **Sources:** `insforge.logs`, `postgREST.logs`, `postgres.logs`, `function.logs`
 
 **Options:**
+
 - `--limit <n>`: Number of log entries to return (default: 20)
 
 **Examples:**
+
 ```bash
 npx @insforge/cli logs insforge.logs
 npx @insforge/cli logs postgres.logs --limit 50
@@ -170,6 +172,7 @@ npx @insforge/cli docs [feature] [language]
 **Languages:** `typescript`, `swift`, `kotlin`, `rest-api`
 
 **Examples:**
+
 ```bash
 # List all available docs
 npx @insforge/cli docs
@@ -411,6 +414,110 @@ npx @insforge/cli deployments cancel abc-123
 
 ---
 
+### Payments — `npx @insforge/cli payments`
+
+Manage the Stripe payments foundation for the linked InsForge project. These commands are intended for developers and agents configuring Stripe keys, syncing catalog state, inspecting mirrored customers, and managing products/prices. Runtime checkout and customer portal calls should usually be made from the app via the SDK.
+
+#### `npx @insforge/cli payments status`
+
+Show Stripe key, account, sync, and webhook status for test/live environments.
+
+```bash
+npx @insforge/cli payments status
+npx @insforge/cli payments status --json
+```
+
+#### `npx @insforge/cli payments config`
+
+List, set, or remove Stripe secret keys.
+
+```bash
+npx @insforge/cli payments config
+npx @insforge/cli payments config set test sk_test_xxx
+npx @insforge/cli payments config set live        # prompts securely
+npx @insforge/cli payments config remove test -y
+```
+
+#### `npx @insforge/cli payments sync`
+
+Sync Stripe products, prices, customers, and subscriptions from configured environments.
+
+```bash
+npx @insforge/cli payments sync
+npx @insforge/cli payments sync --environment test
+npx @insforge/cli payments sync --environment live --json
+```
+
+#### `npx @insforge/cli payments webhooks configure <environment>`
+
+Create or recreate the InsForge-managed Stripe webhook endpoint for an environment.
+
+```bash
+npx @insforge/cli payments webhooks configure test
+```
+
+#### `npx @insforge/cli payments catalog --environment <environment>`
+
+Inspect mirrored Stripe products and prices for one environment.
+
+```bash
+npx @insforge/cli payments catalog --environment test
+npx @insforge/cli payments catalog --environment test --json
+```
+
+#### `npx @insforge/cli payments customers`
+
+List mirrored Stripe customers for admin/debugging workflows.
+
+```bash
+npx @insforge/cli payments customers --environment test
+npx @insforge/cli payments customers --environment test --limit 20 --json
+```
+
+#### `npx @insforge/cli payments products`
+
+List, inspect, create, update, or delete Stripe products.
+
+```bash
+npx @insforge/cli payments products list --environment test
+npx @insforge/cli payments products get prod_123 --environment test
+npx @insforge/cli payments products create --environment test --name "Pro Plan"
+npx @insforge/cli payments products update prod_123 --environment test --description "Updated"
+npx @insforge/cli payments products delete prod_123 --environment test -y
+```
+
+#### `npx @insforge/cli payments prices`
+
+List, inspect, create, update, or archive Stripe prices.
+
+```bash
+npx @insforge/cli payments prices list --environment test
+npx @insforge/cli payments prices create --environment test --product prod_123 --currency usd --unit-amount 2000
+npx @insforge/cli payments prices create --environment test --product prod_123 --currency usd --unit-amount 2000 --interval month
+npx @insforge/cli payments prices update price_123 --environment test --active false
+npx @insforge/cli payments prices archive price_123 --environment test
+```
+
+#### `npx @insforge/cli payments subscriptions`
+
+List mirrored Stripe subscriptions for admin/debugging workflows.
+
+```bash
+npx @insforge/cli payments subscriptions --environment test
+npx @insforge/cli payments subscriptions --environment test --subject-type team --subject-id team_123
+```
+
+#### `npx @insforge/cli payments history`
+
+List mirrored payment history for admin/debugging workflows.
+
+```bash
+npx @insforge/cli payments history --environment test
+npx @insforge/cli payments history --environment test --limit 20 --json
+```
+
+---
+
 ### Secrets — `npx @insforge/cli secrets`
 
 #### `npx @insforge/cli secrets list`
@@ -551,19 +658,19 @@ Skill files are written to per-agent directories (e.g. `.claude/`, `.cursor/`, `
 
 ## Analytics
 
-The CLI reports anonymous usage events to [PostHog](https://posthog.com) so we can understand which features are being used and prioritize improvements. 
+The CLI reports anonymous usage events to [PostHog](https://posthog.com) so we can understand which features are being used and prioritize improvements.
 
 Analytics are enabled by default in the published npm package. If you build the CLI from source without setting `POSTHOG_API_KEY` at build time, analytics become a no-op automatically.
 
 ## Environment Variables
 
-| Variable | Description |
-|----------|-------------|
-| `INSFORGE_ACCESS_TOKEN` | Override the stored access token |
-| `INSFORGE_PROJECT_ID` | Override the linked project ID |
-| `INSFORGE_API_URL` | Override the Platform API URL |
-| `INSFORGE_EMAIL` | Email for non-interactive login |
-| `INSFORGE_PASSWORD` | Password for non-interactive login |
+| Variable                | Description                        |
+| ----------------------- | ---------------------------------- |
+| `INSFORGE_ACCESS_TOKEN` | Override the stored access token   |
+| `INSFORGE_PROJECT_ID`   | Override the linked project ID     |
+| `INSFORGE_API_URL`      | Override the Platform API URL      |
+| `INSFORGE_EMAIL`        | Email for non-interactive login    |
+| `INSFORGE_PASSWORD`     | Password for non-interactive login |
 
 ## Non-Interactive / CI Usage
 
@@ -588,14 +695,14 @@ npx @insforge/cli storage upload ./dist/bundle.js --bucket assets --key "v1.2.0/
 
 ## Exit Codes
 
-| Code | Meaning |
-|------|---------|
-| 0 | Success |
-| 1 | General error |
-| 2 | Authentication failure |
-| 3 | Project not linked (run `npx @insforge/cli link` first) |
-| 4 | Resource not found |
-| 5 | Permission denied |
+| Code | Meaning                                                 |
+| ---- | ------------------------------------------------------- |
+| 0    | Success                                                 |
+| 1    | General error                                           |
+| 2    | Authentication failure                                  |
+| 3    | Project not linked (run `npx @insforge/cli link` first) |
+| 4    | Resource not found                                      |
+| 5    | Permission denied                                       |
 
 ## Development
 
@@ -628,14 +735,17 @@ npm run test:integration:real
 ```
 
 Prerequisites:
+
 - Logged in (`npx @insforge/cli login`) so `~/.insforge/credentials.json` exists
 - Linked project in this repo (`npx @insforge/cli link`) so `.insforge/project.json` exists
 
 Optional environment variables:
+
 - `INSFORGE_API_URL`: Platform API URL override (defaults to `https://api.insforge.dev`)
 - `INTEGRATION_LOG_SOURCE`: Log source for `logs` test (default `insforge.logs`)
 
 Current real-project checks:
+
 - `whoami --json`
 - `metadata --json`
 - `logs <source> --json`