paddle-checkout-accelerator 2.4.0 → 2.6.0

package/bin/paddle-checkout-accelerator.js

@@ -17,6 +17,9 @@ const interactive =
   args.has("--interactive") ||
   args.has("-i");
 
+const minimal =
+  args.has("--minimal");
+
 function exists(filePath) {
   return fs.existsSync(
     path.join(cwd, filePath)
@@ -115,6 +118,120 @@ function appendEnvSafe(values) {
   }
 }
 
+function readEnvFile() {
+  const envPath =
+    path.join(cwd, ".env.local");
+
+  if (!fs.existsSync(envPath)) {
+    return null;
+  }
+
+  return fs.readFileSync(envPath, "utf8");
+}
+
+function hasEnvValue(env, key) {
+  if (!env) return false;
+
+  const line =
+    env
+      .split("\n")
+      .find((entry) =>
+        entry.startsWith(`${key}=`)
+      );
+
+  if (!line) return false;
+
+  const value =
+    line.slice(key.length + 1).trim();
+
+  return value.length > 0;
+}
+
+function runDoctor() {
+  const env =
+    readEnvFile();
+
+  const checks = [
+    {
+      label: ".env.local exists",
+      pass: Boolean(env),
+    },
+    {
+      label: "PADDLE_API_KEY set",
+      pass: hasEnvValue(env, "PADDLE_API_KEY"),
+    },
+    {
+      label: "PADDLE_WEBHOOK_SECRET set",
+      pass: hasEnvValue(env, "PADDLE_WEBHOOK_SECRET"),
+    },
+    {
+      label: "NEXT_PUBLIC_PADDLE_CLIENT_TOKEN set",
+      pass: hasEnvValue(env, "NEXT_PUBLIC_PADDLE_CLIENT_TOKEN"),
+    },
+    {
+      label: "billing config exists",
+      pass: exists("src/lib/billing.ts"),
+    },
+    {
+      label: "webhook route exists",
+      pass: exists("src/app/api/paddle/webhook/route.ts"),
+    },
+    {
+      label: "portal route exists",
+      pass: exists("src/app/api/paddle/portal-session/route.ts"),
+    },
+    {
+      label: "refresh route exists",
+      pass: exists("src/app/api/paddle/refresh-subscription/route.ts"),
+    },
+    {
+      label: "repair route exists",
+      pass: exists("src/app/api/paddle/repair-by-email/route.ts"),
+    },
+    {
+      label: "pricing page exists",
+      pass: exists("src/app/billing/pricing/page.tsx"),
+    },
+    {
+      label: "billing dashboard exists",
+      pass: exists("src/app/billing/dashboard/page.tsx"),
+    },
+    {
+      label: "customer repair page exists",
+      pass: exists("src/app/billing/customer-repair/page.tsx"),
+    },
+  ];
+
+  console.log("");
+  console.log("Paddle Checkout Accelerator Doctor");
+  console.log("");
+
+  let failed = 0;
+
+  for (const check of checks) {
+    if (check.pass) {
+      console.log(`✅ ${check.label}`);
+    } else {
+      failed += 1;
+      console.log(`❌ ${check.label}`);
+    }
+  }
+
+  console.log("");
+
+  if (failed === 0) {
+    console.log("All checks passed.");
+    process.exit(0);
+  }
+
+  console.log(`${failed} check(s) failed.`);
+  console.log("");
+  console.log("Fix the missing items above, then run:");
+  console.log("  npx paddle-checkout-accelerator doctor");
+
+  process.exit(1);
+}
+
 async function getConfig() {
   const detectedAdapter =
     detectAdapter();
@@ -126,6 +243,7 @@ async function getConfig() {
       env: true,
       schema:
         detectedAdapter === "prisma",
+      ui: !minimal,
     };
   }
 
@@ -180,6 +298,15 @@ async function getConfig() {
         active: "yes",
         inactive: "no",
       },
+      {
+        type: "toggle",
+        name: "ui",
+        message:
+          "Generate billing UI pages?",
+        initial: true,
+        active: "yes",
+        inactive: "no",
+      },
     ]);
 
   if (!answers.adapter) {
@@ -289,6 +416,198 @@ model BillingEvent {
   );
 }
 
+function writeUiPages() {
+  writeFileSafe(
+    "src/app/billing/pricing/page.tsx",
+    `import {
+  PricingTable,
+} from "paddle-checkout-accelerator";
+
+export default function BillingPricingPage() {
+  return (
+    <main className="mx-auto max-w-5xl p-10">
+      <h1 className="text-4xl font-bold">
+        Choose your plan
+      </h1>
+
+      <p className="mt-3 text-gray-500">
+        Upgrade your account with Paddle billing.
+      </p>
+
+      <div className="mt-8">
+        <PricingTable />
+      </div>
+    </main>
+  );
+}
+`
+  );
+
+  writeFileSafe(
+    "src/app/billing/dashboard/page.tsx",
+    `import {
+  BillingHistory,
+  CustomerPortalButton,
+  SubscriptionCard,
+  TrialBanner,
+  UsageMeter,
+} from "paddle-checkout-accelerator";
+
+export default function BillingDashboardPage() {
+  return (
+    <main className="mx-auto max-w-5xl space-y-6 p-10">
+      <TrialBanner daysRemaining={5} />
+
+      <SubscriptionCard
+        plan="Pro"
+        status="Active"
+      />
+
+      <UsageMeter
+        current={37}
+        limit={50}
+      />
+
+      <CustomerPortalButton />
+
+      <BillingHistory />
+    </main>
+  );
+}
+`
+  );
+
+  writeFileSafe(
+    "src/app/billing/customer-repair/page.tsx",
+    `"use client";
+
+import { useState } from "react";
+
+export default function CustomerRepairPage() {
+  const [email, setEmail] =
+    useState("");
+  const [result, setResult] =
+    useState("");
+
+  async function repair() {
+    const response =
+      await fetch(
+        "/api/paddle/repair-by-email",
+        {
+          method: "POST",
+          headers: {
+            "Content-Type":
+              "application/json",
+          },
+          body: JSON.stringify({
+            email,
+          }),
+        }
+      );
+
+    const data =
+      await response.json();
+
+    setResult(
+      JSON.stringify(data, null, 2)
+    );
+  }
+
+  return (
+    <main className="mx-auto max-w-3xl space-y-6 p-10">
+      <div>
+        <h1 className="text-4xl font-bold">
+          Repair Customer Access
+        </h1>
+
+        <p className="mt-3 text-gray-500">
+          Use this when a customer paid but their account did not unlock.
+        </p>
+      </div>
+
+      <input
+        value={email}
+        onChange={(event) =>
+          setEmail(event.target.value)
+        }
+        placeholder="customer@example.com"
+        className="w-full rounded-xl border p-4"
+      />
+
+      <button
+        onClick={repair}
+        className="rounded-xl bg-black px-6 py-3 text-white"
+      >
+        Repair Subscription
+      </button>
+
+      {result && (
+        <pre className="overflow-auto rounded-xl border bg-slate-50 p-5 text-sm">
+          {result}
+        </pre>
+      )}
+    </main>
+  );
+}
+`
+  );
+
+  writeFileSafe(
+    "src/app/billing/protected-api/page.tsx",
+    `"use client";
+
+import { useState } from "react";
+
+export default function ProtectedApiPage() {
+  const [result, setResult] =
+    useState("");
+
+  async function run() {
+    const response =
+      await fetch(
+        "/api/demo/protected-generation",
+        {
+          method: "POST",
+        }
+      );
+
+    const data =
+      await response.json();
+
+    setResult(
+      JSON.stringify(data, null, 2)
+    );
+  }
+
+  return (
+    <main className="mx-auto max-w-3xl space-y-6 p-10">
+      <h1 className="text-4xl font-bold">
+        Protected API Demo
+      </h1>
+
+      <p className="text-gray-500">
+        Test paid-route protection, feature checks, and usage limits.
+      </p>
+
+      <button
+        onClick={run}
+        className="rounded-xl bg-black px-6 py-3 text-white"
+      >
+        Run Protected Action
+      </button>
+
+      {result && (
+        <pre className="overflow-auto rounded-xl border bg-slate-50 p-5 text-sm">
+          {result}
+        </pre>
+      )}
+    </main>
+  );
+}
+`
+  );
+}
+
 function writeRoutes() {
   writeFileSafe(
     "src/app/api/paddle/webhook/route.ts",
@@ -442,10 +761,16 @@ Usage:
   npx paddle-checkout-accelerator init
   npx paddle-checkout-accelerator init --interactive
   npx paddle-checkout-accelerator init --force
+  npx paddle-checkout-accelerator doctor
+  npx paddle-checkout-accelerator init --minimal
 `);
     process.exit(0);
   }
 
+  if (command === "doctor") {
+    runDoctor();
+  }
+
   if (command !== "init") {
     console.error(
       `Unknown command: ${command}`
@@ -472,6 +797,10 @@ Usage:
     writeRoutes();
   }
 
+  if (config.ui) {
+    writeUiPages();
+  }
+
   if (config.env) {
     appendEnvSafe({
       NEXT_PUBLIC_PADDLE_CLIENT_TOKEN: "",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paddle-checkout-accelerator",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "scripts": {
     "dev": "next dev",
     "build": "next build",