@revstackhq/cli 0.0.0-dev-20260226063200 → 0.0.0-dev-20260227092523

package/src/commands/push.ts

@@ -1,206 +1,244 @@
-/**
- * @file commands/push.ts
- * @description The core deployment command. Loads the local config, sends it
- * to Revstack Cloud for diffing, presents the changes, and (upon confirmation)
- * pushes the config to production.
- */
-
-import { Command } from "commander";
-import chalk from "chalk";
-import prompts from "prompts";
-import ora from "ora";
-import { getApiKey } from "@/utils/auth";
-import { loadLocalConfig } from "@/utils/config-loader";
-
-// ─── Types ───────────────────────────────────────────────────
-
-interface DiffEntry {
-  action: "added" | "removed" | "updated";
-  entity: string;
-  id: string;
-  message: string;
-}
-
-interface DiffResponse {
-  diff: DiffEntry[];
-  canPush: boolean;
-  blockedReason?: string;
-}
-
-// ─── Helpers ─────────────────────────────────────────────────
-
-const API_BASE = "https://app.revstack.dev";
-
-const DIFF_ICONS: Record<DiffEntry["action"], string> = {
-  added: chalk.green("  + "),
-  removed: chalk.red("  − "),
-  updated: chalk.yellow("  ~ "),
-};
-
-const DIFF_COLORS: Record<DiffEntry["action"], (text: string) => string> = {
-  added: chalk.green,
-  removed: chalk.red,
-  updated: chalk.yellow,
-};
-
-function printDiff(diff: DiffEntry[]): void {
-  if (diff.length === 0) {
-    console.log(
-      chalk.dim("\n  No changes detected. Your config is up to date.\n")
-    );
-    return;
-  }
-
-  console.log(chalk.bold("\n  Changes:\n"));
-
-  for (const entry of diff) {
-    const icon = DIFF_ICONS[entry.action];
-    const color = DIFF_COLORS[entry.action];
-    const label = chalk.dim(`[${entry.entity}]`);
-    console.log(
-      `${icon}${color(entry.id)} ${label} ${chalk.white(entry.message)}`
-    );
-  }
-
-  console.log();
-}
-
-function requireAuth(): 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);
-  }
-
-  return apiKey;
-}
-
-// ─── Command ─────────────────────────────────────────────────
-
-export const pushCommand = new Command("push")
-  .description("Push your local billing config to Revstack Cloud")
-  .option("-e, --env <environment>", "Target environment", "test")
-  .action(async (options: { env: string }) => {
-    const apiKey = requireAuth();
-    const config = await loadLocalConfig(process.cwd());
-
-    // ── Step 1: Compute diff ──────────────────────────────────
-
-    const spinner = ora({
-      text: "Calculating diff...",
-      prefixText: " ",
-    }).start();
-
-    let diffResponse: DiffResponse;
-
-    try {
-      const res = await fetch(`${API_BASE}/api/v1/cli/diff`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${apiKey}`,
-        },
-        body: JSON.stringify({ env: options.env, config }),
-      });
-
-      if (!res.ok) {
-        spinner.fail("Failed to calculate diff");
-        console.error(
-          chalk.red(`\n  API returned ${res.status}: ${res.statusText}\n`)
-        );
-        process.exit(1);
-      }
-
-      diffResponse = (await res.json()) as DiffResponse;
-      spinner.succeed("Diff calculated");
-    } catch (error: unknown) {
-      spinner.fail("Failed to reach Revstack Cloud");
-      console.error(chalk.red(`\n  ${(error as Error).message}\n`));
-      process.exit(1);
-    }
-
-    // ── Step 2: Present diff ──────────────────────────────────
-
-    printDiff(diffResponse.diff);
-
-    if (diffResponse.diff.length === 0) {
-      return;
-    }
-
-    // ── Step 3: Check if push is allowed ──────────────────────
-
-    if (!diffResponse.canPush) {
-      console.log(
-        chalk.red("  ✖ Push is blocked.\n") +
-          chalk.dim(
-            `    ${diffResponse.blockedReason ?? "The server rejected this configuration."}\n`
-          )
-      );
-      process.exit(1);
-    }
-
-    // ── Step 4: Confirm ───────────────────────────────────────
-
-    const envLabel =
-      options.env === "production"
-        ? chalk.red.bold(options.env)
-        : chalk.cyan.bold(options.env);
-
-    const { confirm } = await prompts({
-      type: "confirm",
-      name: "confirm",
-      message: `Apply these changes to ${envLabel}?`,
-      initial: false,
-    });
-
-    if (!confirm) {
-      console.log(chalk.dim("\n  Push cancelled.\n"));
-      return;
-    }
-
-    // ── Step 5: Push ──────────────────────────────────────────
-
-    const pushSpinner = ora({
-      text: `Pushing to ${options.env}...`,
-      prefixText: " ",
-    }).start();
-
-    try {
-      const res = await fetch(`${API_BASE}/api/v1/cli/push`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${apiKey}`,
-        },
-        body: JSON.stringify({ env: options.env, config }),
-      });
-
-      if (!res.ok) {
-        pushSpinner.fail("Push failed");
-        console.error(
-          chalk.red(`\n  API returned ${res.status}: ${res.statusText}\n`)
-        );
-        process.exit(1);
-      }
-
-      pushSpinner.succeed("Pushed successfully");
-      console.log(
-        "\n" +
-          chalk.green("  ✔ Config deployed to ") +
-          envLabel +
-          "\n" +
-          chalk.dim("    Changes are now live.\n")
-      );
-    } catch (error: unknown) {
-      pushSpinner.fail("Push failed");
-      console.error(chalk.red(`\n  ${(error as Error).message}\n`));
-      process.exit(1);
-    }
-  });
+/**
+ * @file commands/push.ts
+ * @description The core deployment command. Loads the local config, sends it
+ * to Revstack Cloud for diffing, presents the changes, and (upon confirmation)
+ * pushes the config to production.
+ */
+
+import { Command } from "commander";
+import chalk from "chalk";
+import prompts from "prompts";
+import ora from "ora";
+import { getApiKey } from "@/utils/auth";
+import { loadLocalConfig } from "@/utils/config-loader";
+import { validateConfig, RevstackValidationError } from "@revstackhq/core";
+
+// ─── Types ───────────────────────────────────────────────────
+
+interface DiffEntry {
+  action: "added" | "removed" | "updated";
+  entity: string;
+  id: string;
+  message: string;
+}
+
+interface DiffResponse {
+  diff: DiffEntry[];
+  canPush: boolean;
+  blockedReason?: string;
+}
+
+// ─── Helpers ─────────────────────────────────────────────────
+
+const API_BASE = "https://app.revstack.dev";
+
+const DIFF_ICONS: Record<DiffEntry["action"], string> = {
+  added: chalk.green("  + "),
+  removed: chalk.red("  − "),
+  updated: chalk.yellow("  ~ "),
+};
+
+const DIFF_COLORS: Record<DiffEntry["action"], (text: string) => string> = {
+  added: chalk.green,
+  removed: chalk.red,
+  updated: chalk.yellow,
+};
+
+function printDiff(diff: DiffEntry[]): void {
+  if (diff.length === 0) {
+    console.log(
+      chalk.dim("\n  No changes detected. Your config is up to date.\n"),
+    );
+    return;
+  }
+
+  console.log(chalk.bold("\n  Changes:\n"));
+
+  for (const entry of diff) {
+    const icon = DIFF_ICONS[entry.action];
+    const color = DIFF_COLORS[entry.action];
+    const label = chalk.dim(`[${entry.entity}]`);
+    console.log(
+      `${icon}${color(entry.id)} ${label} ${chalk.white(entry.message)}`,
+    );
+  }
+
+  console.log();
+}
+
+function requireAuth(): 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);
+  }
+
+  return apiKey;
+}
+
+// ─── Command ─────────────────────────────────────────────────
+
+export const pushCommand = new Command("push")
+  .description("Push your local billing config to Revstack Cloud")
+  .option("-e, --env <environment>", "Target environment", "test")
+  .action(async (options: { env: string }) => {
+    const apiKey = requireAuth();
+    const config = await loadLocalConfig(process.cwd());
+
+    // ── Step 1: Validate config ────────────────────────────────
+
+    const validationSpinner = ora({
+      text: "Validating billing configuration...",
+      prefixText: " ",
+    }).start();
+
+    try {
+      validateConfig(config as any); // cast to match RevstackConfig expected by validateConfig
+      validationSpinner.succeed("Configuration validated");
+    } catch (error: any) {
+      if (
+        error instanceof RevstackValidationError ||
+        error?.name === "RevstackValidationError"
+      ) {
+        validationSpinner.fail("Configuration invalid");
+        console.error(
+          chalk.red(
+            "\n  ✖ The billing configuration contains business logic errors:\n",
+          ),
+        );
+        for (const err of error.errors || []) {
+          console.error(chalk.red(`    • ${err}`));
+        }
+        console.log();
+        process.exit(1);
+      }
+
+      validationSpinner.fail("Validation failed");
+      console.error(
+        chalk.red(
+          `\n  An unexpected error occurred during validation: ${error?.message || String(error)}\n`,
+        ),
+      );
+      process.exit(1);
+    }
+
+    // ── Step 2: Compute diff ──────────────────────────────────
+
+    const spinner = ora({
+      text: "Calculating diff...",
+      prefixText: " ",
+    }).start();
+
+    let diffResponse: DiffResponse;
+
+    try {
+      const res = await fetch(`${API_BASE}/api/v1/cli/diff`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({ env: options.env, config }),
+      });
+
+      if (!res.ok) {
+        spinner.fail("Failed to calculate diff");
+        console.error(
+          chalk.red(`\n  API returned ${res.status}: ${res.statusText}\n`),
+        );
+        process.exit(1);
+      }
+
+      diffResponse = (await res.json()) as DiffResponse;
+      spinner.succeed("Diff calculated");
+    } catch (error: unknown) {
+      spinner.fail("Failed to reach Revstack Cloud");
+      console.error(chalk.red(`\n  ${(error as Error).message}\n`));
+      process.exit(1);
+    }
+
+    // ── Step 2: Present diff ──────────────────────────────────
+
+    printDiff(diffResponse.diff);
+
+    if (diffResponse.diff.length === 0) {
+      return;
+    }
+
+    // ── Step 3: Check if push is allowed ──────────────────────
+
+    if (!diffResponse.canPush) {
+      console.log(
+        chalk.red("  ✖ Push is blocked.\n") +
+          chalk.dim(
+            `    ${diffResponse.blockedReason ?? "The server rejected this configuration."}\n`,
+          ),
+      );
+      process.exit(1);
+    }
+
+    // ── Step 4: Confirm ───────────────────────────────────────
+
+    const envLabel =
+      options.env === "production"
+        ? chalk.red.bold(options.env)
+        : chalk.cyan.bold(options.env);
+
+    const { confirm } = await prompts({
+      type: "confirm",
+      name: "confirm",
+      message: `Apply these changes to ${envLabel}?`,
+      initial: false,
+    });
+
+    if (!confirm) {
+      console.log(chalk.dim("\n  Push cancelled.\n"));
+      return;
+    }
+
+    // ── Step 5: Push ──────────────────────────────────────────
+
+    const pushSpinner = ora({
+      text: `Pushing to ${options.env}...`,
+      prefixText: " ",
+    }).start();
+
+    try {
+      const res = await fetch(`${API_BASE}/api/v1/cli/push`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({ env: options.env, config }),
+      });
+
+      if (!res.ok) {
+        pushSpinner.fail("Push failed");
+        console.error(
+          chalk.red(`\n  API returned ${res.status}: ${res.statusText}\n`),
+        );
+        process.exit(1);
+      }
+
+      pushSpinner.succeed("Pushed successfully");
+      console.log(
+        "\n" +
+          chalk.green("  ✔ Config deployed to ") +
+          envLabel +
+          "\n" +
+          chalk.dim("    Changes are now live.\n"),
+      );
+    } catch (error: unknown) {
+      pushSpinner.fail("Push failed");
+      console.error(chalk.red(`\n  ${(error as Error).message}\n`));
+      process.exit(1);
+    }
+  });

package/src/commands/templates/b2b-saas.ts

@@ -0,0 +1,99 @@
+import { TemplateConfig } from "./starter";
+
+export const b2bSaas: TemplateConfig = {
+  features: `import { defineFeature } from "@revstackhq/core";
+
+export const features = {
+  active_users: defineFeature({ name: "Active Users", type: "static", unit_type: "count" }),
+  api_access: defineFeature({ name: "API Access", type: "boolean", unit_type: "custom" }),
+  custom_domain: defineFeature({ name: "Custom Domain", type: "boolean", unit_type: "custom" }),
+};
+`,
+  addons: `import { defineAddon } from "@revstackhq/core";
+import { features } from "./features";
+
+export const addons = {
+  extra_users: defineAddon<typeof features>({
+    name: "10 Extra Users",
+    description: "Add 10 more active users to your workspace.",
+    type: "recurring",
+    prices: [
+      { amount: 5000, currency: "USD", billing_interval: "monthly" }
+    ],
+    features: {
+      active_users: { value_limit: 10, type: "increment", is_hard_limit: true },
+    }
+  }),
+  dedicated_support: defineAddon<typeof features>({
+    name: "Dedicated Support",
+    description: "Enterprise SLA with 1-hour response time.",
+    type: "recurring",
+    prices: [
+      { amount: 49900, currency: "USD", billing_interval: "monthly" }
+    ],
+    features: {}
+  })
+};
+`,
+  plans: `import { definePlan } from "@revstackhq/core";
+import { features } from "./features";
+
+export const plans = {
+  default: definePlan<typeof features>({
+    name: "Default",
+    description: "Automatically created default plan for guests.",
+    is_default: true,
+    is_public: false,
+    type: "free",
+    features: {},
+  }),
+  startup: definePlan<typeof features>({
+    name: "Startup",
+    description: "For small teams getting started.",
+    is_default: false,
+    is_public: true,
+    type: "paid",
+    available_addons: ["extra_users"],
+    prices: [
+      { amount: 9900, currency: "USD", billing_interval: "monthly" }
+    ],
+    features: {
+      active_users: { value_limit: 10, is_hard_limit: true },
+      api_access: { value_bool: false },
+      custom_domain: { value_bool: false },
+    },
+  }),
+  enterprise: definePlan<typeof features>({
+    name: "Enterprise",
+    description: "Advanced features for scale.",
+    is_default: false,
+    is_public: true,
+    type: "paid",
+    available_addons: ["extra_users", "dedicated_support"],
+    prices: [
+      { amount: 49900, currency: "USD", billing_interval: "monthly" }
+    ],
+    features: {
+      active_users: { value_limit: 100, is_hard_limit: false },
+      api_access: { value_bool: true },
+      custom_domain: { value_bool: true },
+    },
+  }),
+};
+`,
+  index: `import { defineConfig } from "@revstackhq/core";
+import { features } from "./features";
+import { addons } from "./addons";
+import { plans } from "./plans";
+
+export default defineConfig({
+  features,
+  addons,
+  plans,
+});
+`,
+  root: `import config from "./revstack";
+
+export default config;
+`,
+};

package/src/commands/templates/index.ts

@@ -0,0 +1,12 @@
+import { starter } from "./starter";
+import { b2bSaas } from "./b2b-saas";
+import { usageBased } from "./usage-based";
+import type { TemplateConfig } from "./starter";
+
+export const TEMPLATES: Record<string, TemplateConfig> = {
+  starter: starter,
+  "b2b-saas": b2bSaas,
+  "usage-based": usageBased,
+};
+
+export type { TemplateConfig };

package/src/commands/templates/starter.ts

@@ -0,0 +1,89 @@
+export interface TemplateConfig {
+  features: string;
+  addons: string;
+  plans: string;
+  index: string;
+  root: string;
+}
+
+export const starter: TemplateConfig = {
+  features: `import { defineFeature } from "@revstackhq/core";
+
+export const features = {
+  seats: defineFeature({ name: "Seats", type: "static", unit_type: "count" }),
+  priority_support: defineFeature({ name: "Priority Support", type: "boolean", unit_type: "custom" }),
+};
+`,
+  addons: `import { defineAddon } from "@revstackhq/core";
+import { features } from "./features";
+
+export const addons = {
+  extra_seats: defineAddon<typeof features>({
+    name: "5 Extra Seats",
+    description: "Add 5 more team members to your workspace.",
+    type: "recurring",
+    prices: [
+      { amount: 1500, currency: "USD", billing_interval: "monthly" }
+    ],
+    features: {
+      seats: { value_limit: 5, type: "increment", is_hard_limit: false },
+    }
+  }),
+  vip_support: defineAddon<typeof features>({
+    name: "Priority Support",
+    description: "24/7 Slack channel support.",
+    type: "recurring",
+    prices: [
+      { amount: 9900, currency: "USD", billing_interval: "monthly" }
+    ],
+    features: {
+      priority_support: { has_access: true },
+    }
+  })
+};
+`,
+  plans: `import { definePlan } from "@revstackhq/core";
+import { features } from "./features";
+
+export const 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",
+    available_addons: ["extra_seats", "vip_support"],
+    prices: [
+      { amount: 2900, currency: "USD", billing_interval: "monthly", trial_period_days: 14 }
+    ],
+    features: {
+      seats: { value_limit: 5, is_hard_limit: true },
+    },
+  }),
+};
+`,
+  index: `import { defineConfig } from "@revstackhq/core";
+import { features } from "./features";
+import { addons } from "./addons";
+import { plans } from "./plans";
+
+export default defineConfig({
+  features,
+  addons,
+  plans,
+});
+`,
+  root: `import config from "./revstack";
+
+export default config;
+`,
+};