@revstackhq/cli 0.0.0-dev-20260226054033

package/.turbo/turbo-build.log

@@ -0,0 +1,12 @@
+[?9001h[?1004h[?25l> @revstackhq/cli@0.0.0-dev-20260226054033 build C:\Users\flava\OneDrive\Desktop\Work\revstack-os\packages\cli
+> tsup]0;C:\WINDOWS\system32\cmd.exe[?25hCLI Building entry: src/cli.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: C:\Users\flava\OneDrive\Desktop\Work\revstack-os\packages\cli\tsup.config.ts
+CLI Target: node18
+CLI Cleaning output folder
+ESM Build start
+ESM dist\cli.js     17.97 KB
+ESM dist\cli.js.map 38.83 KB
+ESM ⚡️ Build success in 597ms
+[?9001l[?1004l

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @revstackhq/cli
+
+## 0.0.0-dev-20260226054033
+
+### Minor Changes
+
+- Initial release of the Revstack CLI.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Revstack Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,175 @@
+# @revstackhq/cli
+
+The official command-line interface for Revstack. Manages your billing configuration as code — define plans, features, and entitlements in `revstack.config.ts`, then push them to Revstack Cloud with a single command.
+
+## Features
+
+- **Billing as Code:** Define your entire billing model in a type-safe TypeScript config file.
+- **Zero-Build Config Loading:** Evaluates `revstack.config.ts` on the fly using `jiti` — no separate compilation step needed.
+- **Diff Before Deploy:** Every `push` shows a detailed diff of what will change before anything goes live.
+- **Environment Targeting:** Push and pull configs to/from different environments (`test`, `production`, etc.).
+- **Interactive Authentication:** Securely store your API key locally at `~/.revstack/credentials.json`.
+
+## Installation
+
+```bash
+npm install -g @revstackhq/cli
+```
+
+Or use it directly with `npx`:
+
+```bash
+npx @revstackhq/cli init
+```
+
+## Quick Start
+
+### 1. Initialize a Config
+
+Scaffold a new `revstack.config.ts` in your project root:
+
+```bash
+revstack init
+```
+
+This creates a starter config with example plans and features using the type-safe helpers from `@revstackhq/core`:
+
+```typescript
+import { defineConfig, definePlan, defineFeature } from "@revstackhq/core";
+
+const features = {
+  seats: defineFeature({
+    name: "Seats",
+    type: "static",
+    unit_type: "count",
+  }),
+  ai_tokens: defineFeature({
+    name: "AI Tokens",
+    type: "metered",
+    unit_type: "count",
+  }),
+};
+
+export default defineConfig({
+  features,
+  plans: {
+    default: definePlan<typeof features>({
+      name: "Default",
+      description: "Automatically created default plan for guests.",
+      is_default: true,
+      is_public: false,
+      type: "free",
+      features: {},
+    }),
+    pro: definePlan<typeof features>({
+      name: "Pro",
+      description: "For professional teams.",
+      is_default: false,
+      is_public: true,
+      type: "paid",
+      prices: [
+        {
+          amount: 2900,
+          currency: "USD",
+          billing_interval: "monthly",
+          trial_period_days: 14,
+        },
+        {
+          amount: 29000,
+          currency: "USD",
+          billing_interval: "yearly",
+          trial_period_days: 14,
+        },
+      ],
+      features: {
+        seats: { value_limit: 5, is_hard_limit: true },
+        ai_tokens: { value_limit: 1000, reset_period: "monthly" },
+      },
+    }),
+  },
+});
+```
+
+### 2. Authenticate
+
+Log in with your Revstack Secret Key (found in the [Revstack Dashboard](https://app.revstack.dev)):
+
+```bash
+revstack login
+```
+
+Your credentials are stored locally at `~/.revstack/credentials.json` and never leave your machine.
+
+### 3. Deploy
+
+Push your config to Revstack Cloud:
+
+```bash
+revstack push
+```
+
+The CLI will:
+
+1. Parse your `revstack.config.ts`.
+2. Send it to the Revstack API to compute a diff against the current remote state.
+3. Display a color-coded summary of changes (additions, removals, updates).
+4. Ask for confirmation before applying.
+
+### 4. Pull Remote State
+
+Fetch the current billing configuration from Revstack Cloud and overwrite your local `revstack.config.ts`:
+
+```bash
+revstack pull
+```
+
+### 5. Log Out
+
+Clear stored credentials:
+
+```bash
+revstack logout
+```
+
+## Commands
+
+| Command           | Description                                                 |
+| ----------------- | ----------------------------------------------------------- |
+| `revstack init`   | Scaffold a new `revstack.config.ts`                         |
+| `revstack login`  | Authenticate with your Revstack Secret Key                  |
+| `revstack logout` | Clear stored credentials                                    |
+| `revstack push`   | Diff and deploy your local config to Revstack Cloud         |
+| `revstack pull`   | Pull remote config and overwrite local `revstack.config.ts` |
+
+### Global Options
+
+| Option      | Description           |
+| ----------- | --------------------- |
+| `--version` | Print the CLI version |
+| `--help`    | Display help          |
+
+### Environment Targeting
+
+Both `push` and `pull` support the `-e, --env` flag to target a specific environment:
+
+```bash
+# Push to production
+revstack push --env production
+
+# Pull from test (default)
+revstack pull --env test
+```
+
+## Architecture
+
+The CLI is intentionally a **"dumb client"**. All complex diffing, validation, and migration logic lives on the Revstack Cloud backend. The CLI's responsibilities are limited to:
+
+1. **Config Loading** — Evaluate `revstack.config.ts` at runtime using `jiti` and sanitize the output to plain JSON.
+2. **Authentication** — Store and retrieve the API key from `~/.revstack/credentials.json`.
+3. **Network Communication** — Send the parsed config to the Revstack API and display the results.
+
+This keeps the CLI lightweight, fast to install, and ensures the source of truth for billing logic always lives server-side.
+
+## License
+
+MIT