paddle-checkout-accelerator 2.3.0 → 2.5.0

package/bin/paddle-checkout-accelerator.js

@@ -5,134 +5,206 @@ import path from "node:path";
 import prompts from "prompts";
 
 const cwd = process.cwd();
+const args = new Set(process.argv.slice(2));
 
-function writeFileSafe(filePath, content, overwrite = false) {
-  const absolutePath = path.join(cwd, filePath);
-  fs.mkdirSync(path.dirname(absolutePath), { recursive: true });
+const command =
+  process.argv[2];
 
-  if (fs.existsSync(absolutePath) && !overwrite) {
-    console.log(`Skipped ${filePath} because it already exists`);
+const force =
+  args.has("--force");
+
+const interactive =
+  args.has("--interactive") ||
+  args.has("-i");
+
+const minimal =
+  args.has("--minimal");
+
+function exists(filePath) {
+  return fs.existsSync(
+    path.join(cwd, filePath)
+  );
+}
+
+function detectAdapter() {
+  if (
+    exists("prisma/schema.prisma") ||
+    exists("src/lib/prisma.ts") ||
+    exists("lib/prisma.ts")
+  ) {
+    return "prisma";
+  }
+
+  return "memory";
+}
+
+function writeFileSafe(filePath, content) {
+  const absolutePath =
+    path.join(cwd, filePath);
+
+  const existed =
+    fs.existsSync(absolutePath);
+
+  fs.mkdirSync(
+    path.dirname(absolutePath),
+    { recursive: true }
+  );
+
+  if (existed && !force) {
+    console.log(
+      `Skipped ${filePath} because it already exists`
+    );
     return;
   }
 
-  fs.writeFileSync(absolutePath, content);
-  console.log(`${fs.existsSync(absolutePath) ? "Updated" : "Created"} ${filePath}`);
+  fs.writeFileSync(
+    absolutePath,
+    content
+  );
+
+  console.log(
+    `${existed ? "Updated" : "Created"} ${filePath}`
+  );
 }
 
 function appendEnvSafe(values) {
-  const envPath = path.join(cwd, ".env.local");
-  const content = Object.entries(values)
-    .map(([key, value]) => `${key}=${value ?? ""}`)
-    .join("\n");
+  const envPath =
+    path.join(cwd, ".env.local");
+
+  const content =
+    Object.entries(values)
+      .map(
+        ([key, value]) =>
+          `${key}=${value ?? ""}`
+      )
+      .join("\n");
 
   if (!fs.existsSync(envPath)) {
-    fs.writeFileSync(envPath, content + "\n");
+    fs.writeFileSync(
+      envPath,
+      content + "\n"
+    );
+
     console.log("Created .env.local");
     return;
   }
 
-  const current = fs.readFileSync(envPath, "utf8");
-  const lines = content
-    .split("\n")
-    .filter((line) => {
-      const key = line.split("=")[0];
-      return !current.includes(`${key}=`);
-    });
+  const current =
+    fs.readFileSync(envPath, "utf8");
+
+  const lines =
+    content
+      .split("\n")
+      .filter((line) => {
+        const key =
+          line.split("=")[0];
+
+        return !current.includes(
+          `${key}=`
+        );
+      });
 
   if (lines.length) {
-    fs.appendFileSync(envPath, "\n" + lines.join("\n") + "\n");
+    fs.appendFileSync(
+      envPath,
+      "\n" + lines.join("\n") + "\n"
+    );
+
     console.log("Updated .env.local");
   } else {
-    console.log("Skipped .env.local because Paddle keys already exist");
+    console.log(
+      "Skipped .env.local because Paddle keys already exist"
+    );
   }
 }
 
-async function main() {
-  const command = process.argv[2];
-
-  if (!command || command === "--help" || command === "-h") {
-    console.log(`
-Paddle Checkout Accelerator
-
-Usage:
-  npx paddle-checkout-accelerator init
-`);
-    process.exit(0);
+async function getConfig() {
+  const detectedAdapter =
+    detectAdapter();
+
+  if (!interactive) {
+    return {
+      adapter: detectedAdapter,
+      routes: true,
+      env: true,
+      schema:
+        detectedAdapter === "prisma",
+      ui: !minimal,
+    };
   }
 
-  if (command !== "init") {
-    console.error(`Unknown command: ${command}`);
-    process.exit(1);
-  }
-
-  const answers = await prompts([
-    {
-      type: "select",
-      name: "adapter",
-      message: "Which storage adapter do you want?",
-      choices: [
-        { title: "Memory demo adapter", value: "memory" },
-        { title: "Prisma production adapter", value: "prisma" },
-      ],
-      initial: 0,
-    },
-    {
-      type: "toggle",
-      name: "routes",
-      message: "Generate Paddle API routes?",
-      initial: true,
-      active: "yes",
-      inactive: "no",
-    },
-    {
-      type: "toggle",
-      name: "env",
-      message: "Create/update .env.local placeholders?",
-      initial: true,
-      active: "yes",
-      inactive: "no",
-    },
-    {
-      type: "toggle",
-      name: "schema",
-      message: "Generate Prisma schema example?",
-      initial: true,
-      active: "yes",
-      inactive: "no",
-    },
-    {
-      type: "toggle",
-      name: "force",
-      message: "Overwrite existing generated files?",
-      initial: false,
-      active: "yes",
-      inactive: "no",
-    },
-  ]);
+  const answers =
+    await prompts([
+      {
+        type: "select",
+        name: "adapter",
+        message:
+          "Which storage adapter do you want?",
+        choices: [
+          {
+            title: "Auto-detect",
+            value: detectedAdapter,
+          },
+          {
+            title: "Memory demo adapter",
+            value: "memory",
+          },
+          {
+            title: "Prisma production adapter",
+            value: "prisma",
+          },
+        ],
+        initial: 0,
+      },
+      {
+        type: "toggle",
+        name: "routes",
+        message:
+          "Generate Paddle API routes?",
+        initial: true,
+        active: "yes",
+        inactive: "no",
+      },
+      {
+        type: "toggle",
+        name: "env",
+        message:
+          "Create/update .env.local placeholders?",
+        initial: true,
+        active: "yes",
+        inactive: "no",
+      },
+      {
+        type: "toggle",
+        name: "schema",
+        message:
+          "Generate Prisma schema example?",
+        initial:
+          detectedAdapter === "prisma",
+        active: "yes",
+        inactive: "no",
+      },
+      {
+        type: "toggle",
+        name: "ui",
+        message:
+          "Generate billing UI pages?",
+        initial: true,
+        active: "yes",
+        inactive: "no",
+      },
+    ]);
 
   if (!answers.adapter) {
     console.log("Install cancelled.");
     process.exit(0);
   }
 
-  if (answers.adapter === "memory") {
-    writeFileSafe(
-      "src/lib/billing.ts",
-      `import {
-  configureBilling,
-  memoryBillingAdapter,
-} from "paddle-checkout-accelerator";
-
-export const billing =
-  configureBilling({
-    adapter: memoryBillingAdapter,
-  });
-`,
-      answers.force
-    );
-  }
+  return answers;
+}
 
-  if (answers.adapter === "prisma") {
+function writeBillingFile(adapter) {
+  if (adapter === "prisma") {
     writeFileSafe(
       "src/lib/billing.ts",
       `import {
@@ -149,8 +221,7 @@ export const billing =
   configureBilling({
     adapter,
   });
-`,
-      answers.force
+`
     );
 
     writeFileSafe(
@@ -169,14 +240,31 @@ export const prisma =
 if (process.env.NODE_ENV !== "production") {
   globalForPrisma.prisma = prisma;
 }
-`,
-      answers.force
+`
     );
 
-    if (answers.schema) {
-      writeFileSafe(
-        "prisma/paddle-accelerator.schema.prisma",
-        `model Subscription {
+    return;
+  }
+
+  writeFileSafe(
+    "src/lib/billing.ts",
+    `import {
+  configureBilling,
+  memoryBillingAdapter,
+} from "paddle-checkout-accelerator";
+
+export const billing =
+  configureBilling({
+    adapter: memoryBillingAdapter,
+  });
+`
+  );
+}
+
+function writePrismaSchema() {
+  writeFileSafe(
+    "prisma/paddle-accelerator.schema.prisma",
+    `model Subscription {
   userId               String  @id
   plan                 String
   status               String
@@ -210,16 +298,206 @@ model BillingEvent {
   createdAt DateTime
   metadata  Json?
 }
-`,
-        answers.force
+`
+  );
+}
+
+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)
+    );
   }
 
-  if (answers.routes) {
-    writeFileSafe(
-      "src/app/api/paddle/webhook/route.ts",
-      `import { NextRequest, NextResponse } from "next/server";
+  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",
+    `import { NextRequest, NextResponse } from "next/server";
 import {
   syncPaddleEvent,
   verifyPaddleWebhook,
@@ -230,94 +508,181 @@ export async function POST(request: NextRequest) {
   const signature = request.headers.get("paddle-signature");
 
   if (!signature) {
-    return NextResponse.json({ error: "Missing Paddle signature" }, { status: 400 });
+    return NextResponse.json(
+      { error: "Missing Paddle signature" },
+      { status: 400 }
+    );
   }
 
   try {
-    const event = await verifyPaddleWebhook(rawBody, signature);
+    const event =
+      await verifyPaddleWebhook(
+        rawBody,
+        signature
+      );
+
     await syncPaddleEvent(event);
-    return NextResponse.json({ success: true });
+
+    return NextResponse.json({
+      success: true,
+    });
   } catch (error) {
     return NextResponse.json(
-      { error: error instanceof Error ? error.message : "Webhook verification failed" },
+      {
+        error:
+          error instanceof Error
+            ? error.message
+            : "Webhook verification failed",
+      },
       { status: 401 }
     );
   }
 }
-`,
-      answers.force
-    );
+`
+  );
 
-    writeFileSafe(
-      "src/app/api/paddle/portal-session/route.ts",
-      `import { NextRequest, NextResponse } from "next/server";
-import { createCustomerPortalSession } from "paddle-checkout-accelerator";
+  writeFileSafe(
+    "src/app/api/paddle/portal-session/route.ts",
+    `import { NextRequest, NextResponse } from "next/server";
+import {
+  createCustomerPortalSession,
+} from "paddle-checkout-accelerator";
 
 export async function POST(request: NextRequest) {
-  const body = (await request.json()) as {
-    customerId?: string;
-    returnUrl?: string;
-  };
+  const body =
+    (await request.json()) as {
+      customerId?: string;
+      returnUrl?: string;
+    };
 
   if (!body.customerId) {
-    return NextResponse.json({ error: "Missing customerId" }, { status: 400 });
+    return NextResponse.json(
+      { error: "Missing customerId" },
+      { status: 400 }
+    );
   }
 
-  const session = await createCustomerPortalSession({
-    customerId: body.customerId,
-    returnUrl: body.returnUrl,
-  });
+  const session =
+    await createCustomerPortalSession({
+      customerId: body.customerId,
+      returnUrl: body.returnUrl,
+    });
 
   return NextResponse.json(session);
 }
-`,
-      answers.force
-    );
+`
+  );
 
-    writeFileSafe(
-      "src/app/api/paddle/refresh-subscription/route.ts",
-      `import { NextRequest, NextResponse } from "next/server";
-import { refreshSubscriptionFromPaddle } from "paddle-checkout-accelerator";
+  writeFileSafe(
+    "src/app/api/paddle/refresh-subscription/route.ts",
+    `import { NextRequest, NextResponse } from "next/server";
+import {
+  refreshSubscriptionFromPaddle,
+} from "paddle-checkout-accelerator";
 
 export async function POST(request: NextRequest) {
-  const body = (await request.json()) as {
-    subscriptionId?: string;
-  };
+  const body =
+    (await request.json()) as {
+      subscriptionId?: string;
+    };
 
   if (!body.subscriptionId) {
-    return NextResponse.json({ error: "Missing subscriptionId" }, { status: 400 });
+    return NextResponse.json(
+      { error: "Missing subscriptionId" },
+      { status: 400 }
+    );
   }
 
-  const subscription = await refreshSubscriptionFromPaddle(body.subscriptionId);
+  const subscription =
+    await refreshSubscriptionFromPaddle(
+      body.subscriptionId
+    );
+
   return NextResponse.json(subscription);
 }
-`,
-      answers.force
-    );
+`
+  );
 
-    writeFileSafe(
-      "src/app/api/paddle/repair-by-email/route.ts",
-      `import { NextRequest, NextResponse } from "next/server";
-import { repairSubscriptionByEmail } from "paddle-checkout-accelerator";
+  writeFileSafe(
+    "src/app/api/paddle/repair-by-email/route.ts",
+    `import { NextRequest, NextResponse } from "next/server";
+import {
+  repairSubscriptionByEmail,
+} from "paddle-checkout-accelerator";
 
 export async function POST(request: NextRequest) {
-  const body = (await request.json()) as {
-    email?: string;
-  };
+  const body =
+    (await request.json()) as {
+      email?: string;
+    };
 
   if (!body.email) {
-    return NextResponse.json({ error: "Missing email" }, { status: 400 });
+    return NextResponse.json(
+      { error: "Missing email" },
+      { status: 400 }
+    );
   }
 
-  const result = await repairSubscriptionByEmail(body.email);
+  const result =
+    await repairSubscriptionByEmail(
+      body.email
+    );
+
   return NextResponse.json(result);
 }
-`,
-      answers.force
+`
+  );
+}
+
+async function main() {
+  if (
+    !command ||
+    command === "--help" ||
+    command === "-h"
+  ) {
+    console.log(`
+Paddle Checkout Accelerator
+
+Usage:
+  npx paddle-checkout-accelerator init
+  npx paddle-checkout-accelerator init --interactive
+  npx paddle-checkout-accelerator init --force
+  npx paddle-checkout-accelerator init --minimal
+`);
+    process.exit(0);
+  }
+
+  if (command !== "init") {
+    console.error(
+      `Unknown command: ${command}`
     );
+    process.exit(1);
   }
 
-  if (answers.env) {
+  const config =
+    await getConfig();
+
+  console.log("");
+  console.log(
+    `Detected adapter: ${config.adapter}`
+  );
+  console.log("");
+
+  writeBillingFile(config.adapter);
+
+  if (config.schema) {
+    writePrismaSchema();
+  }
+
+  if (config.routes) {
+    writeRoutes();
+  }
+
+  if (config.ui) {
+    writeUiPages();
+  }
+
+  if (config.env) {
     appendEnvSafe({
       NEXT_PUBLIC_PADDLE_CLIENT_TOKEN: "",
       PADDLE_API_KEY: "",
@@ -326,12 +691,33 @@ export async function POST(request: NextRequest) {
   }
 
   console.log("");
-  console.log("✅ Paddle Checkout Accelerator installed.");
+  console.log(
+    "✅ Paddle Checkout Accelerator installed."
+  );
   console.log("");
   console.log("Next:");
-  console.log("1. Add your Paddle keys to .env.local");
-  console.log("2. Add schema models to your main prisma/schema.prisma if using Prisma");
-  console.log("3. Configure Paddle webhook URL: /api/paddle/webhook");
+  console.log(
+    "1. Add your Paddle keys to .env.local"
+  );
+
+  if (config.adapter === "prisma") {
+    console.log(
+      "2. Copy generated Prisma models into your main prisma/schema.prisma"
+    );
+    console.log(
+      "3. Run your Prisma migration"
+    );
+    console.log(
+      "4. Configure Paddle webhook URL: /api/paddle/webhook"
+    );
+  } else {
+    console.log(
+      "2. Use Prisma adapter for production"
+    );
+    console.log(
+      "3. Configure Paddle webhook URL: /api/paddle/webhook"
+    );
+  }
 }
 
 main().catch((error) => {

package/package.json

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