paddle-checkout-accelerator 2.5.0 → 2.7.0

package/bin/paddle-checkout-accelerator.js

@@ -118,6 +118,331 @@ 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
+  npx paddle-checkout-accelerator verify");
+
+  process.exit(1);
+}
+
+function parseEnv(env) {
+  const values = {};
+
+  if (!env) return values;
+
+  for (const line of env.split("\n")) {
+    if (!line || line.trim().startsWith("#")) {
+      continue;
+    }
+
+    const index = line.indexOf("=");
+
+    if (index === -1) {
+      continue;
+    }
+
+    const key = line.slice(0, index).trim();
+    const value = line.slice(index + 1).trim();
+
+    values[key] = value;
+  }
+
+  return values;
+}
+
+async function paddleRequest(pathname, apiKey) {
+  const response = await fetch(
+    `https://api.paddle.com${pathname}`,
+    {
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+      },
+    }
+  );
+
+  return response;
+}
+
+async function runVerify() {
+  const env =
+    readEnvFile();
+
+  const values =
+    parseEnv(env);
+
+  const apiKey =
+    values.PADDLE_API_KEY;
+
+  const checks = [];
+
+  function add(label, pass, details = "") {
+    checks.push({
+      label,
+      pass,
+      details,
+    });
+  }
+
+  add(
+    ".env.local exists",
+    Boolean(env)
+  );
+
+  add(
+    "PADDLE_API_KEY present",
+    Boolean(apiKey)
+  );
+
+  add(
+    "PADDLE_WEBHOOK_SECRET present",
+    Boolean(values.PADDLE_WEBHOOK_SECRET)
+  );
+
+  add(
+    "NEXT_PUBLIC_PADDLE_CLIENT_TOKEN present",
+    Boolean(values.NEXT_PUBLIC_PADDLE_CLIENT_TOKEN)
+  );
+
+  add(
+    "billing config exists",
+    exists("src/lib/billing.ts")
+  );
+
+  add(
+    "webhook route exists",
+    exists("src/app/api/paddle/webhook/route.ts")
+  );
+
+  if (apiKey) {
+    try {
+      const productsResponse =
+        await paddleRequest(
+          "/products",
+          apiKey
+        );
+
+      add(
+        "Paddle API reachable",
+        productsResponse.ok,
+        productsResponse.ok
+          ? ""
+          : `status ${productsResponse.status}`
+      );
+
+      if (productsResponse.ok) {
+        const products =
+          await productsResponse.json();
+
+        const count =
+          Array.isArray(products?.data)
+            ? products.data.length
+            : 0;
+
+        add(
+          "Paddle products found",
+          count > 0,
+          `${count} product(s)`
+        );
+      }
+
+      const pricesResponse =
+        await paddleRequest(
+          "/prices",
+          apiKey
+        );
+
+      if (pricesResponse.ok) {
+        const prices =
+          await pricesResponse.json();
+
+        const count =
+          Array.isArray(prices?.data)
+            ? prices.data.length
+            : 0;
+
+        add(
+          "Paddle prices found",
+          count > 0,
+          `${count} price(s)`
+        );
+      } else {
+        add(
+          "Paddle prices found",
+          false,
+          `status ${pricesResponse.status}`
+        );
+      }
+    } catch (error) {
+      add(
+        "Paddle API reachable",
+        false,
+        error instanceof Error
+          ? error.message
+          : "unknown error"
+      );
+    }
+  } else {
+    add(
+      "Paddle API reachable",
+      false,
+      "missing PADDLE_API_KEY"
+    );
+
+    add(
+      "Paddle products found",
+      false,
+      "missing PADDLE_API_KEY"
+    );
+
+    add(
+      "Paddle prices found",
+      false,
+      "missing PADDLE_API_KEY"
+    );
+  }
+
+  console.log("");
+  console.log("Paddle Checkout Accelerator Verify");
+  console.log("");
+
+  let passed = 0;
+
+  for (const check of checks) {
+    if (check.pass) {
+      passed += 1;
+      console.log(
+        `✅ ${check.label}${check.details ? ` — ${check.details}` : ""}`
+      );
+    } else {
+      console.log(
+        `❌ ${check.label}${check.details ? ` — ${check.details}` : ""}`
+      );
+    }
+  }
+
+  const score =
+    Math.round(
+      (passed / checks.length) * 100
+    );
+
+  console.log("");
+  console.log(`Readiness Score: ${score}%`);
+
+  if (score < 100) {
+    process.exit(1);
+  }
+
+  process.exit(0);
+}
+
 async function getConfig() {
   const detectedAdapter =
     detectAdapter();
@@ -647,11 +972,21 @@ 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 verify
   npx paddle-checkout-accelerator init --minimal
 `);
     process.exit(0);
   }
 
+  if (command === "doctor") {
+    runDoctor();
+  }
+
+  if (command === "verify") {
+    await runVerify();
+  }
+
   if (command !== "init") {
     console.error(
       `Unknown command: ${command}`

package/package.json

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