paddle-checkout-accelerator 2.2.0 → 2.4.0

package/README.md

@@ -386,3 +386,5 @@ npx paddle-accelerator init
 Copyright © NamahLogistics.
 
 Commercial license. Redistribution, resale, sublicensing, or republication of the source code is prohibited without written permission.
+
+- v2.2.0 — CLI Init Installer

package/bin/paddle-checkout-accelerator.js

@@ -2,86 +2,240 @@
 
 import fs from "node:fs";
 import path from "node:path";
+import prompts from "prompts";
 
 const cwd = process.cwd();
+const args = new Set(process.argv.slice(2));
+
+const command =
+  process.argv[2];
+
+const force =
+  args.has("--force");
+
+const interactive =
+  args.has("--interactive") ||
+  args.has("-i");
+
+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 dir = path.dirname(absolutePath);
+  const absolutePath =
+    path.join(cwd, filePath);
 
-  fs.mkdirSync(dir, {
-    recursive: true,
-  });
+  const existed =
+    fs.existsSync(absolutePath);
 
-  if (fs.existsSync(absolutePath)) {
-    console.log(`Skipped ${filePath} because it already exists`);
+  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(`Created ${filePath}`);
+  fs.writeFileSync(
+    absolutePath,
+    content
+  );
+
+  console.log(
+    `${existed ? "Updated" : "Created"} ${filePath}`
+  );
 }
 
-function appendEnvSafe(content) {
-  const envPath = path.join(cwd, ".env.local");
+function appendEnvSafe(values) {
+  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);
+    fs.writeFileSync(
+      envPath,
+      content + "\n"
+    );
+
     console.log("Created .env.local");
     return;
   }
 
-  const current = fs.readFileSync(envPath, "utf8");
+  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"
+    );
 
-  const nextLines = content
-    .split("\n")
-    .filter(Boolean)
-    .filter((line) => {
-      const key = line.split("=")[0];
-      return !current.includes(`${key}=`);
-    });
+    console.log("Updated .env.local");
+  } else {
+    console.log(
+      "Skipped .env.local because Paddle keys already exist"
+    );
+  }
+}
 
-  if (nextLines.length === 0) {
-    console.log("Skipped .env.local because Paddle keys already exist");
-    return;
+async function getConfig() {
+  const detectedAdapter =
+    detectAdapter();
+
+  if (!interactive) {
+    return {
+      adapter: detectedAdapter,
+      routes: true,
+      env: true,
+      schema:
+        detectedAdapter === "prisma",
+    };
   }
 
-  fs.appendFileSync(
-    envPath,
-    `\n${nextLines.join("\n")}\n`
-  );
+  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",
+      },
+    ]);
+
+  if (!answers.adapter) {
+    console.log("Install cancelled.");
+    process.exit(0);
+  }
 
-  console.log("Updated .env.local");
+  return answers;
 }
 
-const command = process.argv[2];
+function writeBillingFile(adapter) {
+  if (adapter === "prisma") {
+    writeFileSafe(
+      "src/lib/billing.ts",
+      `import {
+  configureBilling,
+  createPrismaBillingAdapter,
+} from "paddle-checkout-accelerator";
 
-if (!command || command === "--help" || command === "-h") {
-  console.log(`
-Paddle Checkout Accelerator
+import { prisma } from "@/lib/prisma";
 
-Usage:
-  npx paddle-checkout-accelerator init
+const adapter =
+  createPrismaBillingAdapter(prisma);
 
-This creates:
-  - src/lib/billing.ts
-  - src/app/api/paddle/webhook/route.ts
-  - src/app/api/paddle/portal-session/route.ts
-  - src/app/api/paddle/refresh-subscription/route.ts
-  - src/app/api/paddle/repair-by-email/route.ts
-  - .env.local placeholders
-`);
-  process.exit(0);
-}
+export const billing =
+  configureBilling({
+    adapter,
+  });
+`
+    );
 
-if (command !== "init") {
-  console.error(`Unknown command: ${command}`);
-  process.exit(1);
+    writeFileSafe(
+      "src/lib/prisma.ts",
+      `import { PrismaClient } from "@prisma/client";
+
+const globalForPrisma =
+  globalThis as unknown as {
+    prisma?: PrismaClient;
+  };
+
+export const prisma =
+  globalForPrisma.prisma ??
+  new PrismaClient();
+
+if (process.env.NODE_ENV !== "production") {
+  globalForPrisma.prisma = prisma;
 }
+`
+    );
+
+    return;
+  }
 
-writeFileSafe(
-  "src/lib/billing.ts",
-  `import {
+  writeFileSafe(
+    "src/lib/billing.ts",
+    `import {
   configureBilling,
   memoryBillingAdapter,
 } from "paddle-checkout-accelerator";
@@ -91,11 +245,54 @@ export const billing =
     adapter: memoryBillingAdapter,
   });
 `
-);
+  );
+}
+
+function writePrismaSchema() {
+  writeFileSafe(
+    "prisma/paddle-accelerator.schema.prisma",
+    `model Subscription {
+  userId               String  @id
+  plan                 String
+  status               String
+  paddleCustomerId     String?
+  paddleSubscriptionId String?
+  currentPeriodEnd     String?
+}
+
+model UsageEvent {
+  id     String @id @default(cuid())
+  userId String
+  key    String
+  period String
+  count  Int
+
+  @@unique([userId, key, period], name: "userId_key_period")
+}
+
+model Team {
+  teamId  String @id
+  name    String
+  plan    String
+  ownerId String
+  members Json
+}
+
+model BillingEvent {
+  id        String   @id
+  userId    String
+  type      String
+  createdAt DateTime
+  metadata  Json?
+}
+`
+  );
+}
 
-writeFileSafe(
-  "src/app/api/paddle/webhook/route.ts",
-  `import { NextRequest, NextResponse } from "next/server";
+function writeRoutes() {
+  writeFileSafe(
+    "src/app/api/paddle/webhook/route.ts",
+    `import { NextRequest, NextResponse } from "next/server";
 import {
   syncPaddleEvent,
   verifyPaddleWebhook,
@@ -103,9 +300,7 @@ import {
 
 export async function POST(request: NextRequest) {
   const rawBody = await request.text();
-
-  const signature =
-    request.headers.get("paddle-signature");
+  const signature = request.headers.get("paddle-signature");
 
   if (!signature) {
     return NextResponse.json(
@@ -139,11 +334,11 @@ export async function POST(request: NextRequest) {
   }
 }
 `
-);
+  );
 
-writeFileSafe(
-  "src/app/api/paddle/portal-session/route.ts",
-  `import { NextRequest, NextResponse } from "next/server";
+  writeFileSafe(
+    "src/app/api/paddle/portal-session/route.ts",
+    `import { NextRequest, NextResponse } from "next/server";
 import {
   createCustomerPortalSession,
 } from "paddle-checkout-accelerator";
@@ -171,11 +366,11 @@ export async function POST(request: NextRequest) {
   return NextResponse.json(session);
 }
 `
-);
+  );
 
-writeFileSafe(
-  "src/app/api/paddle/refresh-subscription/route.ts",
-  `import { NextRequest, NextResponse } from "next/server";
+  writeFileSafe(
+    "src/app/api/paddle/refresh-subscription/route.ts",
+    `import { NextRequest, NextResponse } from "next/server";
 import {
   refreshSubscriptionFromPaddle,
 } from "paddle-checkout-accelerator";
@@ -201,11 +396,11 @@ export async function POST(request: NextRequest) {
   return NextResponse.json(subscription);
 }
 `
-);
+  );
 
-writeFileSafe(
-  "src/app/api/paddle/repair-by-email/route.ts",
-  `import { NextRequest, NextResponse } from "next/server";
+  writeFileSafe(
+    "src/app/api/paddle/repair-by-email/route.ts",
+    `import { NextRequest, NextResponse } from "next/server";
 import {
   repairSubscriptionByEmail,
 } from "paddle-checkout-accelerator";
@@ -231,17 +426,91 @@ export async function POST(request: NextRequest) {
   return NextResponse.json(result);
 }
 `
-);
+  );
+}
 
-appendEnvSafe(`NEXT_PUBLIC_PADDLE_CLIENT_TOKEN=
-PADDLE_API_KEY=
-PADDLE_WEBHOOK_SECRET=
+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
 `);
+    process.exit(0);
+  }
+
+  if (command !== "init") {
+    console.error(
+      `Unknown command: ${command}`
+    );
+    process.exit(1);
+  }
+
+  const config =
+    await getConfig();
+
+  console.log("");
+  console.log(
+    `Detected adapter: ${config.adapter}`
+  );
+  console.log("");
 
-console.log("");
-console.log("Paddle Checkout Accelerator installed.");
-console.log("");
-console.log("Next:");
-console.log("1. Add your Paddle keys to .env.local");
-console.log("2. Replace memoryBillingAdapter with Prisma adapter for production");
-console.log("3. Configure Paddle webhook URL: /api/paddle/webhook");
+  writeBillingFile(config.adapter);
+
+  if (config.schema) {
+    writePrismaSchema();
+  }
+
+  if (config.routes) {
+    writeRoutes();
+  }
+
+  if (config.env) {
+    appendEnvSafe({
+      NEXT_PUBLIC_PADDLE_CLIENT_TOKEN: "",
+      PADDLE_API_KEY: "",
+      PADDLE_WEBHOOK_SECRET: "",
+    });
+  }
+
+  console.log("");
+  console.log(
+    "✅ Paddle Checkout Accelerator installed."
+  );
+  console.log("");
+  console.log("Next:");
+  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) => {
+  console.error(error);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paddle-checkout-accelerator",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "scripts": {
     "dev": "next dev",
     "build": "next build",
@@ -27,7 +27,8 @@
     "react": "19.2.4",
     "react-dom": "19.2.4",
     "svix": "^1.95.2",
-    "tailwind-merge": "^3.6.0"
+    "tailwind-merge": "^3.6.0",
+    "prompts": "^2.4.2"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4",
@@ -36,6 +37,7 @@
     "@types/react-dom": "^19",
     "eslint": "^9",
     "eslint-config-next": "16.2.9",
+    "prompts": "^2.4.2",
     "tailwindcss": "^4",
     "tsup": "^8.5.1",
     "typescript": "^5",