paddle-checkout-accelerator 2.1.1 → 2.3.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

@@ -0,0 +1,340 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import path from "node:path";
+import prompts from "prompts";
+
+const cwd = process.cwd();
+
+function writeFileSafe(filePath, content, overwrite = false) {
+  const absolutePath = path.join(cwd, filePath);
+  fs.mkdirSync(path.dirname(absolutePath), { recursive: true });
+
+  if (fs.existsSync(absolutePath) && !overwrite) {
+    console.log(`Skipped ${filePath} because it already exists`);
+    return;
+  }
+
+  fs.writeFileSync(absolutePath, content);
+  console.log(`${fs.existsSync(absolutePath) ? "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");
+
+  if (!fs.existsSync(envPath)) {
+    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}=`);
+    });
+
+  if (lines.length) {
+    fs.appendFileSync(envPath, "\n" + lines.join("\n") + "\n");
+    console.log("Updated .env.local");
+  } else {
+    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);
+  }
+
+  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",
+    },
+  ]);
+
+  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
+    );
+  }
+
+  if (answers.adapter === "prisma") {
+    writeFileSafe(
+      "src/lib/billing.ts",
+      `import {
+  configureBilling,
+  createPrismaBillingAdapter,
+} from "paddle-checkout-accelerator";
+
+import { prisma } from "@/lib/prisma";
+
+const adapter =
+  createPrismaBillingAdapter(prisma);
+
+export const billing =
+  configureBilling({
+    adapter,
+  });
+`,
+      answers.force
+    );
+
+    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;
+}
+`,
+      answers.force
+    );
+
+    if (answers.schema) {
+      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?
+}
+`,
+        answers.force
+      );
+    }
+  }
+
+  if (answers.routes) {
+    writeFileSafe(
+      "src/app/api/paddle/webhook/route.ts",
+      `import { NextRequest, NextResponse } from "next/server";
+import {
+  syncPaddleEvent,
+  verifyPaddleWebhook,
+} from "paddle-checkout-accelerator";
+
+export async function POST(request: NextRequest) {
+  const rawBody = await request.text();
+  const signature = request.headers.get("paddle-signature");
+
+  if (!signature) {
+    return NextResponse.json({ error: "Missing Paddle signature" }, { status: 400 });
+  }
+
+  try {
+    const event = await verifyPaddleWebhook(rawBody, signature);
+    await syncPaddleEvent(event);
+    return NextResponse.json({ success: true });
+  } catch (error) {
+    return NextResponse.json(
+      { 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";
+
+export async function POST(request: NextRequest) {
+  const body = (await request.json()) as {
+    customerId?: string;
+    returnUrl?: string;
+  };
+
+  if (!body.customerId) {
+    return NextResponse.json({ error: "Missing customerId" }, { status: 400 });
+  }
+
+  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";
+
+export async function POST(request: NextRequest) {
+  const body = (await request.json()) as {
+    subscriptionId?: string;
+  };
+
+  if (!body.subscriptionId) {
+    return NextResponse.json({ error: "Missing subscriptionId" }, { status: 400 });
+  }
+
+  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";
+
+export async function POST(request: NextRequest) {
+  const body = (await request.json()) as {
+    email?: string;
+  };
+
+  if (!body.email) {
+    return NextResponse.json({ error: "Missing email" }, { status: 400 });
+  }
+
+  const result = await repairSubscriptionByEmail(body.email);
+  return NextResponse.json(result);
+}
+`,
+      answers.force
+    );
+  }
+
+  if (answers.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");
+  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");
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paddle-checkout-accelerator",
-  "version": "2.1.1",
+  "version": "2.3.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",
@@ -53,10 +55,14 @@
   },
   "files": [
     "dist",
+    "bin",
     "README.md",
     "LICENSE",
     "docs",
     "recipes"
   ],
-  "module": "./dist/index.js"
+  "module": "./dist/index.js",
+  "bin": {
+    "paddle-checkout-accelerator": "./bin/paddle-checkout-accelerator.js"
+  }
 }