@revstackhq/cli 0.0.0-dev-20260226054033

package/src/cli.ts

@@ -0,0 +1,32 @@
+/**
+ * @file cli.ts
+ * @description Entry point for the Revstack CLI.
+ * Registers all commands and parses process.argv.
+ */
+
+import { Command } from "commander";
+import { createRequire } from "node:module";
+
+import { loginCommand } from "@/commands/login.js";
+import { logoutCommand } from "@/commands/logout.js";
+import { initCommand } from "@/commands/init.js";
+import { pushCommand } from "@/commands/push.js";
+import { pullCommand } from "@/commands/pull.js";
+
+const require = createRequire(import.meta.url);
+const packageJson = require("../package.json") as { version: string };
+
+const program = new Command();
+
+program
+  .name("revstack")
+  .description("The official CLI for Revstack — Billing as Code")
+  .version(packageJson.version);
+
+program.addCommand(loginCommand);
+program.addCommand(logoutCommand);
+program.addCommand(initCommand);
+program.addCommand(pushCommand);
+program.addCommand(pullCommand);
+
+program.parse(process.argv);

package/src/commands/init.ts

@@ -0,0 +1,190 @@
+/**
+ * @file commands/init.ts
+ * @description Scaffolds a new `revstack.config.ts` in the current directory.
+ * Generates a starter config with the immutable Default Guest Plan and
+ * a sample Pro plan using type-safe helpers from @revstackhq/core.
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import fs from "node:fs";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import ora from "ora";
+
+const STARTER_CONFIG = `import { defineConfig, definePlan, defineFeature } from "@revstackhq/core";
+
+// ─── Features ────────────────────────────────────────────────
+
+const features = {
+  seats: defineFeature({
+    name: "Seats",
+    type: "static",
+    unit_type: "count",
+  }),
+  ai_tokens: defineFeature({
+    name: "AI Tokens",
+    type: "metered",
+    unit_type: "count",
+  }),
+};
+
+// ─── Plans ───────────────────────────────────────────────────
+
+export default defineConfig({
+  features,
+  plans: {
+    // DO NOT DELETE: Automatically created default plan for guests.
+    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" },
+      },
+    }),
+  },
+});
+`;
+
+export const initCommand = new Command("init")
+  .description("Scaffold a new revstack.config.ts in the current directory")
+  .action(async () => {
+    const cwd = process.cwd();
+    const configPath = path.resolve(cwd, "revstack.config.ts");
+
+    if (fs.existsSync(configPath)) {
+      console.log(
+        "\n" +
+          chalk.yellow("  ⚠ revstack.config.ts already exists.\n") +
+          chalk.dim("    Delete it first if you want to start fresh.\n"),
+      );
+      process.exit(1);
+    }
+
+    // Step 1: Create revstack.config.ts
+    fs.writeFileSync(configPath, STARTER_CONFIG, "utf-8");
+
+    // Step 2: Detect package manager & verify package.json
+    let packageManager = "npm";
+    if (fs.existsSync(path.resolve(cwd, "pnpm-lock.yaml"))) {
+      packageManager = "pnpm";
+    } else if (fs.existsSync(path.resolve(cwd, "yarn.lock"))) {
+      packageManager = "yarn";
+    } else if (fs.existsSync(path.resolve(cwd, "package-lock.json"))) {
+      packageManager = "npm";
+    }
+
+    const packageJsonPath = path.resolve(cwd, "package.json");
+    if (!fs.existsSync(packageJsonPath)) {
+      // Create a default package.json if it doesn't exist
+      try {
+        spawnSync("npm", ["init", "-y"], { cwd, stdio: "ignore", shell: true });
+      } catch (err) {
+        // Ignore initialization errors; the install command may still work or provide a better error.
+      }
+    }
+
+    // Step 3: Install @revstackhq/core
+    const spinner = ora("Installing @revstackhq/core...").start();
+    let installFailed = false;
+
+    try {
+      const installArgs =
+        packageManager === "yarn"
+          ? ["add", "@revstackhq/core"]
+          : packageManager === "pnpm"
+            ? ["add", "@revstackhq/core"]
+            : ["install", "@revstackhq/core"];
+
+      let result = spawnSync(packageManager, installArgs, { cwd, shell: true });
+      if (result.error || result.status !== 0) {
+        if (packageManager === "pnpm") {
+          result = spawnSync("pnpm", ["add", "-w", "@revstackhq/core"], {
+            cwd,
+            shell: true,
+          });
+        } else if (packageManager === "yarn") {
+          result = spawnSync("yarn", ["add", "-W", "@revstackhq/core"], {
+            cwd,
+            shell: true,
+          });
+        }
+      }
+
+      if (result.error || result.status !== 0) {
+        throw new Error(
+          "Install failed: " +
+            (result.stderr
+              ? result.stderr.toString()
+              : result.stdout
+                ? result.stdout.toString()
+                : "Unknown error"),
+        );
+      }
+      spinner.succeed("Dependencies installed");
+    } catch (err: any) {
+      installFailed = true;
+      spinner.fail(
+        "Failed to install @revstackhq/core automatically (" +
+          packageManager +
+          "). Reason: " +
+          err.message,
+      );
+    }
+
+    // Step 4: Final Success Message
+    console.log(
+      "\\n" +
+        chalk.green("  ✔ Created revstack.config.ts\\n") +
+        "\\n" +
+        chalk.dim("    Includes the ") +
+        chalk.white("Default Guest Plan") +
+        chalk.dim(" (required by Revstack).\\n") +
+        "\\n" +
+        chalk.dim("    Next steps:\\n") +
+        (installFailed
+          ? chalk.dim("    0. ") +
+            chalk.white(
+              "Run " +
+                chalk.bold(packageManager + " install @revstackhq/core") +
+                " manually\\n",
+            )
+          : "") +
+        chalk.dim("    1. ") +
+        chalk.white("Edit the config to match your billing model\\n") +
+        chalk.dim("    2. ") +
+        chalk.white("Run ") +
+        chalk.bold("revstack login") +
+        chalk.white(" to authenticate\\n") +
+        chalk.dim("    3. ") +
+        chalk.white("Run ") +
+        chalk.bold("revstack push") +
+        chalk.white(" to deploy\\n"),
+    );
+  });

package/src/commands/login.ts

@@ -0,0 +1,39 @@
+/**
+ * @file commands/login.ts
+ * @description Interactive authentication flow. Prompts the user for their
+ * Revstack Secret Key and stores it globally for subsequent CLI commands.
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import prompts from "prompts";
+import { setApiKey } from "@/utils/auth.js";
+
+export const loginCommand = new Command("login")
+  .description("Authenticate with your Revstack Secret Key")
+  .action(async () => {
+    console.log(
+      "\n" + chalk.bold("  Revstack ") + chalk.dim("— Authentication\n")
+    );
+
+    const response = await prompts({
+      type: "password",
+      name: "secretKey",
+      message: "Enter your Revstack Secret Key",
+      validate: (value: string) =>
+        value.startsWith("sk_") ? true : "Secret key must start with sk_",
+    });
+
+    if (!response.secretKey) {
+      console.log(chalk.dim("\n  Login cancelled.\n"));
+      process.exit(0);
+    }
+
+    setApiKey(response.secretKey);
+
+    console.log(
+      "\n" +
+        chalk.green("  ✔ Authenticated successfully!\n") +
+        chalk.dim("    Credentials saved to ~/.revstack/credentials.json\n")
+    );
+  });

package/src/commands/logout.ts

@@ -0,0 +1,25 @@
+/**
+ * @file commands/logout.ts
+ * @description Clears stored Revstack credentials.
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import { clearApiKey, getApiKey } from "@/utils/auth.js";
+
+export const logoutCommand = new Command("logout")
+  .description("Clear stored Revstack credentials")
+  .action(() => {
+    if (!getApiKey()) {
+      console.log(chalk.dim("\n  Not currently logged in.\n"));
+      return;
+    }
+
+    clearApiKey();
+
+    console.log(
+      "\n" +
+        chalk.green("  ✔ Successfully logged out.\n") +
+        chalk.dim("    Credentials removed from ~/.revstack/credentials.json\n")
+    );
+  });

package/src/commands/pull.ts

@@ -0,0 +1,266 @@
+/**
+ * @file commands/pull.ts
+ * @description Fetches the current billing configuration from Revstack Cloud
+ * and writes it back to the local `revstack.config.ts` file, overwriting
+ * the existing config after user confirmation.
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import prompts from "prompts";
+import fs from "node:fs";
+import path from "node:path";
+import { getApiKey } from "@/utils/auth";
+
+// ─── Types ───────────────────────────────────────────────────
+
+interface RemoteFeature {
+  name: string;
+  type: string;
+  unit_type: string;
+  description?: string;
+}
+
+interface RemotePrice {
+  amount: number;
+  currency: string;
+  billing_interval: string;
+  trial_period_days?: number;
+}
+
+interface RemotePlanFeature {
+  value_limit?: number;
+  value_bool?: boolean;
+  value_text?: string;
+  is_hard_limit?: boolean;
+  reset_period?: string;
+}
+
+interface RemotePlan {
+  name: string;
+  description?: string;
+  is_default: boolean;
+  is_public: boolean;
+  type: string;
+  prices?: RemotePrice[];
+  features: Record<string, RemotePlanFeature>;
+}
+
+interface RemoteConfig {
+  features: Record<string, RemoteFeature>;
+  plans: Record<string, RemotePlan>;
+}
+
+// ─── Code Generator ──────────────────────────────────────────
+
+function indent(text: string, spaces: number): string {
+  const pad = " ".repeat(spaces);
+  return text
+    .split("\n")
+    .map((line) => (line.trim() ? pad + line : line))
+    .join("\n");
+}
+
+function serializeObject(
+  obj: Record<string, unknown>,
+  depth: number = 0
+): string {
+  const entries = Object.entries(obj);
+  if (entries.length === 0) return "{}";
+
+  const pad = "  ".repeat(depth + 1);
+  const closePad = "  ".repeat(depth);
+
+  const lines = entries
+    .map(([key, value]) => {
+      if (value === undefined) return null;
+
+      const formattedValue =
+        typeof value === "string"
+          ? `"${value}"`
+          : typeof value === "number" || typeof value === "boolean"
+            ? String(value)
+            : Array.isArray(value)
+              ? serializeArray(value, depth + 1)
+              : typeof value === "object" && value !== null
+                ? serializeObject(value as Record<string, unknown>, depth + 1)
+                : String(value);
+
+      return `${pad}${key}: ${formattedValue},`;
+    })
+    .filter(Boolean);
+
+  return `{\n${lines.join("\n")}\n${closePad}}`;
+}
+
+function serializeArray(arr: unknown[], depth: number): string {
+  if (arr.length === 0) return "[]";
+
+  const pad = "  ".repeat(depth + 1);
+  const closePad = "  ".repeat(depth);
+
+  const items = arr.map((item) => {
+    if (typeof item === "object" && item !== null) {
+      return `${pad}${serializeObject(item as Record<string, unknown>, depth + 1)},`;
+    }
+    return `${pad}${JSON.stringify(item)},`;
+  });
+
+  return `[\n${items.join("\n")}\n${closePad}]`;
+}
+
+function generateConfigSource(config: RemoteConfig): string {
+  // ── Features ─────────────────────────────────────────────
+  const featureEntries = Object.entries(config.features).map(([slug, f]) => {
+    const props: Record<string, unknown> = {
+      name: f.name,
+      type: f.type,
+      unit_type: f.unit_type,
+    };
+    if (f.description) props.description = f.description;
+
+    return `  ${slug}: defineFeature(${serializeObject(props, 2)}),`;
+  });
+
+  // ── Plans ────────────────────────────────────────────────
+  const planEntries = Object.entries(config.plans).map(([slug, plan]) => {
+    const props: Record<string, unknown> = {
+      name: plan.name,
+    };
+    if (plan.description) props.description = plan.description;
+    props.is_default = plan.is_default;
+    props.is_public = plan.is_public;
+    props.type = plan.type;
+
+    if (plan.prices && plan.prices.length > 0) {
+      props.prices = plan.prices;
+    }
+
+    props.features = plan.features;
+
+    const comment = plan.is_default
+      ? `    // DO NOT DELETE: Automatically created default plan for guests.\n`
+      : "";
+
+    return `${comment}    ${slug}: definePlan<typeof features>(${serializeObject(props, 3)}),`;
+  });
+
+  return `import { defineConfig, definePlan, defineFeature } from "@revstackhq/core";
+
+// ─── Features ────────────────────────────────────────────────
+
+const features = {
+${featureEntries.join("\n")}
+};
+
+// ─── Plans ───────────────────────────────────────────────────
+
+export default defineConfig({
+  features,
+  plans: {
+${planEntries.join("\n")}
+  },
+});
+`;
+}
+
+// ─── Helpers ─────────────────────────────────────────────────
+
+const API_BASE = "https://app.revstack.dev";
+
+// ─── Command ─────────────────────────────────────────────────
+
+export const pullCommand = new Command("pull")
+  .description(
+    "Pull the remote billing config and overwrite revstack.config.ts"
+  )
+  .option("-e, --env <environment>", "Target environment", "test")
+  .action(async (options: { env: string }) => {
+    const apiKey = getApiKey();
+
+    if (!apiKey) {
+      console.error(
+        "\n" +
+          chalk.red("  ✖ Not authenticated.\n") +
+          chalk.dim("    Run ") +
+          chalk.bold("revstack login") +
+          chalk.dim(" first.\n")
+      );
+      process.exit(1);
+    }
+
+    // ── 1. Fetch remote config ─────────────────────────────
+    const spinner = ora({
+      text: "Fetching remote configuration...",
+      prefixText: " ",
+    }).start();
+
+    let remoteConfig: RemoteConfig;
+
+    try {
+      const res = await fetch(
+        `${API_BASE}/api/v1/cli/pull?env=${encodeURIComponent(options.env)}`,
+        {
+          headers: { Authorization: `Bearer ${apiKey}` },
+        }
+      );
+
+      if (!res.ok) {
+        spinner.fail("Failed to fetch remote config");
+        console.error(
+          chalk.red(`\n  API returned ${res.status}: ${res.statusText}\n`)
+        );
+        process.exit(1);
+      }
+
+      remoteConfig = (await res.json()) as RemoteConfig;
+      spinner.succeed("Remote config fetched");
+    } catch (error: unknown) {
+      spinner.fail("Failed to reach Revstack Cloud");
+      console.error(chalk.red(`\n  ${(error as Error).message}\n`));
+      process.exit(1);
+    }
+
+    // ── 2. Show summary ────────────────────────────────────
+    const featureCount = Object.keys(remoteConfig.features).length;
+    const planCount = Object.keys(remoteConfig.plans).length;
+
+    console.log(
+      "\n" +
+        chalk.dim("  Remote state: ") +
+        chalk.white(`${featureCount} features, ${planCount} plans`) +
+        chalk.dim(` (${options.env})\n`)
+    );
+
+    // ── 3. Confirm overwrite ───────────────────────────────
+    const configPath = path.resolve(process.cwd(), "revstack.config.ts");
+    const exists = fs.existsSync(configPath);
+
+    if (exists) {
+      const { confirm } = await prompts({
+        type: "confirm",
+        name: "confirm",
+        message:
+          "This will overwrite your local revstack.config.ts. Are you sure?",
+        initial: false,
+      });
+
+      if (!confirm) {
+        console.log(chalk.dim("\n  Pull cancelled.\n"));
+        return;
+      }
+    }
+
+    // ── 4. Generate and write ──────────────────────────────
+    const source = generateConfigSource(remoteConfig);
+    fs.writeFileSync(configPath, source, "utf-8");
+
+    console.log(
+      "\n" +
+        chalk.green("  ✔ revstack.config.ts updated from remote.\n") +
+        chalk.dim("    Review the file and run ") +
+        chalk.bold("revstack push") +
+        chalk.dim(" to re-deploy.\n")
+    );
+  });