@solvapay/init 0.3.0 → 0.4.0-preview-e7613cf5668b4f45b2e72a5047d08441e78ebd41

package/dist/index.cjs

@@ -30,7 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  SOLVAPAY_PRODUCT_REF_PLACEHOLDER: () => SOLVAPAY_PRODUCT_REF_PLACEHOLDER,
+  SOLVAPAY_PRODUCT_REF_PLACEHOLDER: () => SOLVAPAY_PRODUCT_REF_PLACEHOLDER2,
   askKeepConfiguredProduct: () => askKeepConfiguredProduct,
   createInitSession: () => createInitSession,
   detectPackageManager: () => detectPackageManager,
@@ -43,7 +43,10 @@ __export(index_exports, {
   listProducts: () => listProducts,
   openAuthUrl: () => openAuthUrl,
   pickProductInteractive: () => pickProductInteractive,
+  readSolvaPayApiBaseUrlFromEnv: () => readSolvaPayApiBaseUrlFromEnv,
   readSolvaPayProductRefFromEnv: () => readSolvaPayProductRefFromEnv,
+  readSolvaPaySecretKeyFromEnv: () => readSolvaPaySecretKeyFromEnv,
+  runDoctorInDirectory: () => runDoctorInDirectory,
   runInitInDirectory: () => runInitInDirectory,
   verifyProductRef: () => verifyProductRef,
   verifySecretKey: () => verifySecretKey,
@@ -56,6 +59,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/browser-auth.ts
+var import_core = require("@solvapay/core");
 var import_open = __toESM(require("open"), 1);
 var INIT_EXCHANGE_TIMEOUT_MS = 10 * 60 * 1e3;
 var POLL_INTERVAL_MS = 2e3;
@@ -139,9 +143,19 @@ var waitForExchange = async (apiBaseUrl, session) => {
     spinner.stop();
   }
 };
-var PRODUCT_REF_PLACEHOLDER = "__SOLVAPAY_PRODUCT_REF__";
+var parseVerifiedProduct = (payload) => {
+  if (!payload || typeof payload !== "object") return void 0;
+  const root = payload;
+  const data = root.data && typeof root.data === "object" ? root.data : root;
+  const name = typeof data.name === "string" ? data.name : void 0;
+  const status = typeof data.status === "string" ? data.status : void 0;
+  if (!name || !status) return void 0;
+  const rawPlans = Array.isArray(data.plans) ? data.plans : [];
+  const plans = rawPlans.filter((plan) => !!plan && typeof plan === "object").map((plan) => ({ isActive: plan.isActive === true }));
+  return { name, status, plans };
+};
 var verifyProductRef = async (apiBaseUrl, secretKey, productRef) => {
-  if (productRef === PRODUCT_REF_PLACEHOLDER) {
+  if (productRef === import_core.SOLVAPAY_PRODUCT_REF_PLACEHOLDER) {
     return { status: "invalid_placeholder" };
   }
   try {
@@ -155,7 +169,15 @@ var verifyProductRef = async (apiBaseUrl, secretKey, productRef) => {
       }
     );
     if (response.ok) {
-      return { status: "ok" };
+      const payload = await response.json();
+      const product = parseVerifiedProduct(payload);
+      if (!product) {
+        return {
+          status: "error",
+          message: "Product lookup succeeded but the response was missing name/status."
+        };
+      }
+      return { status: "ok", product };
     }
     const body = await response.text();
     if (response.status === 404) {
@@ -275,10 +297,11 @@ var import_node_fs = require("fs");
 var import_node_path = __toESM(require("path"), 1);
 var import_promises2 = __toESM(require("readline/promises"), 1);
 var import_node_process = require("process");
+var import_core2 = require("@solvapay/core");
 var SOLVAPAY_SECRET_KEY = "SOLVAPAY_SECRET_KEY";
 var SOLVAPAY_PRODUCT_REF = "SOLVAPAY_PRODUCT_REF";
 var SOLVAPAY_API_BASE_URL = "SOLVAPAY_API_BASE_URL";
-var SOLVAPAY_PRODUCT_REF_PLACEHOLDER = "__SOLVAPAY_PRODUCT_REF__";
+var SOLVAPAY_PRODUCT_REF_PLACEHOLDER2 = import_core2.SOLVAPAY_PRODUCT_REF_PLACEHOLDER;
 var envValueRegex = (key) => new RegExp(`^\\s*${key}\\s*=\\s*(.*)$`, "m");
 var secretKeyRegex = envValueRegex(SOLVAPAY_SECRET_KEY);
 var parseEnvValue = (raw) => {
@@ -353,20 +376,23 @@ var writeSolvaPaySecretToEnv = async (secretKey, options = {}) => {
   await (0, import_promises.writeFile)(envPath, updatedContent, "utf8");
   return { filePath: envPath, action: "updated" };
 };
-var readSolvaPayProductRefFromEnv = async (cwd = process.cwd()) => {
+var readEnvKeyFromFile = async (key, cwd) => {
   const envPath = import_node_path.default.join(cwd, ".env");
   const exists = await envFileExists(envPath);
   if (!exists) {
     return void 0;
   }
   const content = await (0, import_promises.readFile)(envPath, "utf8");
-  const match = content.match(envValueRegex(SOLVAPAY_PRODUCT_REF));
+  const match = content.match(envValueRegex(key));
   if (!match?.[1]) {
     return void 0;
   }
   const value = parseEnvValue(match[1]);
   return value.length > 0 ? value : void 0;
 };
+var readSolvaPayProductRefFromEnv = async (cwd = process.cwd()) => readEnvKeyFromFile(SOLVAPAY_PRODUCT_REF, cwd);
+var readSolvaPaySecretKeyFromEnv = async (cwd = process.cwd()) => readEnvKeyFromFile(SOLVAPAY_SECRET_KEY, cwd);
+var readSolvaPayApiBaseUrlFromEnv = async (cwd = process.cwd()) => readEnvKeyFromFile(SOLVAPAY_API_BASE_URL, cwd);
 var writeSolvaPayProductRefToEnv = async (productRef, options = {}) => {
   const envPath = import_node_path.default.join(options.cwd || process.cwd(), ".env");
   const keyLine = `${SOLVAPAY_PRODUCT_REF}=${productRef}`;
@@ -587,14 +613,14 @@ var parseProductSummary = (value) => {
     return null;
   }
   const record = value;
-  if (typeof record.reference !== "string" || typeof record.name !== "string" || typeof record.status !== "string" || typeof record.createdAt !== "string") {
+  if (typeof record.reference !== "string" || typeof record.name !== "string") {
     return null;
   }
   return {
     reference: record.reference,
     name: record.name,
-    status: record.status,
-    createdAt: record.createdAt
+    status: typeof record.status === "string" ? record.status : "",
+    createdAt: typeof record.createdAt === "string" ? record.createdAt : ""
   };
 };
 var listProducts = async (apiBaseUrl, secretKey, options = {}) => {
@@ -690,7 +716,7 @@ var pickProductInteractive = async (apiBaseUrl, secretKey, options) => {
     return { action: "skipped", reason: "network_error" };
   }
   const { products, total } = listResult;
-  if (products.length === 0) {
+  if (total === 0) {
     process.stdout.write(
       `\u26A0\uFE0F No products found on your SolvaPay account. Create one at ${CONSOLE_PRODUCTS_URL} and re-run \`solvapay init\`.
 `
@@ -881,7 +907,7 @@ var configureProductRef = async (apiBaseUrl, secretKey, cwd, options) => {
     return;
   }
   const existing = await readSolvaPayProductRefFromEnv(cwd);
-  if (existing && existing !== SOLVAPAY_PRODUCT_REF_PLACEHOLDER) {
+  if (existing && existing !== SOLVAPAY_PRODUCT_REF_PLACEHOLDER2) {
     const verified = await verifyProductRef(apiBaseUrl, secretKey, existing);
     if (verified.status === "ok") {
       if (options.yes) {
@@ -1112,6 +1138,153 @@ var runInitInDirectory = async ({
   process.stdout.write("\n");
   printSetupComplete();
 };
+
+// src/run-doctor.ts
+var import_chalk2 = __toESM(require("chalk"), 1);
+var import_core3 = require("@solvapay/core");
+var DEFAULT_API_BASE_URL2 = "https://api.solvapay.com";
+var DEV_API_BASE_URL2 = "https://api-dev.solvapay.com";
+var preferEnv = (processValue, fileValue) => {
+  if (typeof processValue === "string" && processValue.trim().length > 0) {
+    return processValue.trim();
+  }
+  if (typeof fileValue === "string" && fileValue.trim().length > 0) {
+    return fileValue.trim();
+  }
+  return void 0;
+};
+var resolveApiBaseUrl2 = async (cwd, opts) => {
+  if (opts.dev) return DEV_API_BASE_URL2;
+  const fromFile = await readSolvaPayApiBaseUrlFromEnv(cwd);
+  const resolved = preferEnv(process.env.SOLVAPAY_API_BASE_URL, fromFile);
+  return (resolved || DEFAULT_API_BASE_URL2).replace(/\/$/, "");
+};
+var printCheck = (check) => {
+  const mark = check.ok ? import_chalk2.default.green("\u2713") : import_chalk2.default.red("\u2717");
+  process.stdout.write(`${mark} ${check.name}: ${check.detail}
+`);
+};
+var runDoctorInDirectory = async ({
+  cwd,
+  options = {}
+}) => {
+  const checks = [];
+  const apiBaseUrl = await resolveApiBaseUrl2(cwd, options);
+  process.stdout.write(`
+SolvaPay doctor \u2014 ${apiBaseUrl}
+
+`);
+  const secretFromFile = await readSolvaPaySecretKeyFromEnv(cwd);
+  const secretKey = preferEnv(process.env.SOLVAPAY_SECRET_KEY, secretFromFile);
+  if (!secretKey) {
+    checks.push({
+      name: "SOLVAPAY_SECRET_KEY",
+      ok: false,
+      detail: "missing (set via `npx solvapay init` or your environment)"
+    });
+  } else {
+    const verified = await verifySecretKey(apiBaseUrl, secretKey);
+    checks.push({
+      name: "SOLVAPAY_SECRET_KEY",
+      ok: verified.ok,
+      detail: verified.ok ? "accepted by the API" : verified.warning ?? "rejected by the API"
+    });
+  }
+  checks.push({
+    name: "SOLVAPAY_API_BASE_URL",
+    ok: true,
+    detail: apiBaseUrl
+  });
+  if (!secretKey) {
+    try {
+      const response = await fetch(`${apiBaseUrl}/v1/sdk/products`, { method: "GET" });
+      checks.push({
+        name: "API reachability",
+        ok: response.status !== 0,
+        detail: response.status === 401 || response.status === 403 ? `reachable (HTTP ${response.status} without a key \u2014 expected)` : `HTTP ${response.status}`
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Network error";
+      checks.push({
+        name: "API reachability",
+        ok: false,
+        detail: message
+      });
+    }
+  }
+  const productRefFromFile = await readSolvaPayProductRefFromEnv(cwd);
+  const productRef = preferEnv(process.env.SOLVAPAY_PRODUCT_REF, productRefFromFile);
+  if (!productRef) {
+    checks.push({
+      name: "SOLVAPAY_PRODUCT_REF",
+      ok: false,
+      detail: "missing"
+    });
+  } else if (productRef === import_core3.SOLVAPAY_PRODUCT_REF_PLACEHOLDER) {
+    checks.push({
+      name: "SOLVAPAY_PRODUCT_REF",
+      ok: false,
+      detail: `still the scaffolder placeholder "${import_core3.SOLVAPAY_PRODUCT_REF_PLACEHOLDER}"`
+    });
+  } else if (!secretKey) {
+    checks.push({
+      name: "SOLVAPAY_PRODUCT_REF",
+      ok: false,
+      detail: `set to "${productRef}" but cannot verify without SOLVAPAY_SECRET_KEY`
+    });
+  } else {
+    const verified = await verifyProductRef(apiBaseUrl, secretKey, productRef);
+    if (verified.status === "ok") {
+      const readiness = (0, import_core3.evaluateProductReadiness)(verified.product);
+      checks.push({
+        name: "SOLVAPAY_PRODUCT_REF",
+        ok: true,
+        detail: `exists \u2014 "${verified.product.name}" (${verified.product.status})`
+      });
+      checks.push({
+        name: "Product readiness",
+        ok: readiness.ready,
+        detail: readiness.ready ? `${readiness.activePlans}/${readiness.totalPlans} active plan(s)` : readiness.issues.join("; ")
+      });
+    } else if (verified.status === "not_found") {
+      checks.push({
+        name: "SOLVAPAY_PRODUCT_REF",
+        ok: false,
+        detail: `"${productRef}" not found on ${apiBaseUrl}`
+      });
+    } else if (verified.status === "invalid_placeholder") {
+      checks.push({
+        name: "SOLVAPAY_PRODUCT_REF",
+        ok: false,
+        detail: `still the scaffolder placeholder`
+      });
+    } else {
+      checks.push({
+        name: "SOLVAPAY_PRODUCT_REF",
+        ok: false,
+        detail: verified.status === "error" ? verified.message : "could not verify"
+      });
+    }
+  }
+  const debugRaw = process.env.SOLVAPAY_DEBUG;
+  checks.push({
+    name: "SOLVAPAY_DEBUG defaults",
+    ok: true,
+    detail: debugRaw === void 0 ? 'warning: unset \u2014 factory treats debug as ON (!== "false") while client/paywall treat it as OFF (=== "true"). Set explicitly to "true" or "false".' : `set to "${debugRaw}"`
+  });
+  for (const check of checks) {
+    printCheck(check);
+  }
+  const ok = checks.every((check) => check.ok);
+  process.stdout.write(
+    ok ? `
+${import_chalk2.default.green("All checks passed.")}
+` : `
+${import_chalk2.default.red("Doctor found problems. Fix the \u2717 items above, then re-run.")}
+`
+  );
+  return { ok, checks, apiBaseUrl };
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SOLVAPAY_PRODUCT_REF_PLACEHOLDER,
@@ -1127,7 +1300,10 @@ var runInitInDirectory = async ({
   listProducts,
   openAuthUrl,
   pickProductInteractive,
+  readSolvaPayApiBaseUrlFromEnv,
   readSolvaPayProductRefFromEnv,
+  readSolvaPaySecretKeyFromEnv,
+  runDoctorInDirectory,
   runInitInDirectory,
   verifyProductRef,
   verifySecretKey,

package/dist/index.d.cts

@@ -13,10 +13,18 @@ type ExchangeResponse = {
 declare const createInitSession: (apiBaseUrl: string) => Promise<InitSessionResponse>;
 declare const openAuthUrl: (authUrl: string) => Promise<boolean>;
 declare const waitForExchange: (apiBaseUrl: string, session: InitSessionResponse) => Promise<ExchangeResponse>;
+type VerifiedProductSummary = {
+    name: string;
+    status: string;
+    plans: Array<{
+        isActive: boolean;
+    }>;
+};
 type VerifyProductRefResult = {
     status: 'skipped';
 } | {
     status: 'ok';
+    product: VerifiedProductSummary;
 } | {
     status: 'invalid_placeholder';
 } | {
@@ -48,6 +56,8 @@ type EnvWriteOptions = {
 declare const ensureEnvInGitignore: (cwd?: string) => Promise<GitignoreEnvResult>;
 declare const writeSolvaPaySecretToEnv: (secretKey: string, options?: EnvWriteOptions) => Promise<EnvWriteResult>;
 declare const readSolvaPayProductRefFromEnv: (cwd?: string) => Promise<string | undefined>;
+declare const readSolvaPaySecretKeyFromEnv: (cwd?: string) => Promise<string | undefined>;
+declare const readSolvaPayApiBaseUrlFromEnv: (cwd?: string) => Promise<string | undefined>;
 declare const writeSolvaPayProductRefToEnv: (productRef: string, options?: {
     cwd?: string;
 }) => Promise<EnvWriteResult>;
@@ -159,4 +169,29 @@ type RunInitInDirectoryOptions = {
 };
 declare const runInitInDirectory: ({ cwd, options, skipSdkInstall, }: RunInitInDirectoryOptions) => Promise<void>;
 
-export { type EnsureNodeProjectResult, type EnvWriteResult, type ExchangeResponse, type GitignoreEnvResult, type InitCommandOptions, type InitSessionResponse, type InstallResult, type ListProductsResult, type PackageManager, type PickResult, type ProductSummary, type RunInitInDirectoryOptions, SOLVAPAY_PRODUCT_REF_PLACEHOLDER, type VerifyProductRefResult, askKeepConfiguredProduct, createInitSession, detectPackageManager, ensureEnvInGitignore, ensureNodeProject, formatConfiguredProductLabel, getInstallCommand, getSolvaPayBasePackages, installSolvaPaySdk, listProducts, openAuthUrl, pickProductInteractive, readSolvaPayProductRefFromEnv, runInitInDirectory, verifyProductRef, verifySecretKey, waitForEnter, waitForExchange, writeSolvaPayApiBaseUrlToEnv, writeSolvaPayProductRefToEnv, writeSolvaPaySecretToEnv };
+type DoctorCommandOptions = {
+    /** Target api-dev.solvapay.com (same as `solvapay init --dev`). */
+    dev?: boolean;
+};
+type RunDoctorInDirectoryOptions = {
+    cwd: string;
+    options?: DoctorCommandOptions;
+};
+type DoctorCheckResult = {
+    name: string;
+    ok: boolean;
+    detail: string;
+};
+type DoctorReport = {
+    ok: boolean;
+    checks: DoctorCheckResult[];
+    apiBaseUrl: string;
+};
+/**
+ * Diagnose SolvaPay credentials + product readiness for the current project.
+ * Exits non-zero (via `report.ok === false`) when any hard check fails so it
+ * can gate CI / pre-deploy.
+ */
+declare const runDoctorInDirectory: ({ cwd, options, }: RunDoctorInDirectoryOptions) => Promise<DoctorReport>;
+
+export { type DoctorCheckResult, type DoctorCommandOptions, type DoctorReport, type EnsureNodeProjectResult, type EnvWriteResult, type ExchangeResponse, type GitignoreEnvResult, type InitCommandOptions, type InitSessionResponse, type InstallResult, type ListProductsResult, type PackageManager, type PickResult, type ProductSummary, type RunDoctorInDirectoryOptions, type RunInitInDirectoryOptions, SOLVAPAY_PRODUCT_REF_PLACEHOLDER, type VerifiedProductSummary, type VerifyProductRefResult, askKeepConfiguredProduct, createInitSession, detectPackageManager, ensureEnvInGitignore, ensureNodeProject, formatConfiguredProductLabel, getInstallCommand, getSolvaPayBasePackages, installSolvaPaySdk, listProducts, openAuthUrl, pickProductInteractive, readSolvaPayApiBaseUrlFromEnv, readSolvaPayProductRefFromEnv, readSolvaPaySecretKeyFromEnv, runDoctorInDirectory, runInitInDirectory, verifyProductRef, verifySecretKey, waitForEnter, waitForExchange, writeSolvaPayApiBaseUrlToEnv, writeSolvaPayProductRefToEnv, writeSolvaPaySecretToEnv };

package/dist/index.d.ts

@@ -13,10 +13,18 @@ type ExchangeResponse = {
 declare const createInitSession: (apiBaseUrl: string) => Promise<InitSessionResponse>;
 declare const openAuthUrl: (authUrl: string) => Promise<boolean>;
 declare const waitForExchange: (apiBaseUrl: string, session: InitSessionResponse) => Promise<ExchangeResponse>;
+type VerifiedProductSummary = {
+    name: string;
+    status: string;
+    plans: Array<{
+        isActive: boolean;
+    }>;
+};
 type VerifyProductRefResult = {
     status: 'skipped';
 } | {
     status: 'ok';
+    product: VerifiedProductSummary;
 } | {
     status: 'invalid_placeholder';
 } | {
@@ -48,6 +56,8 @@ type EnvWriteOptions = {
 declare const ensureEnvInGitignore: (cwd?: string) => Promise<GitignoreEnvResult>;
 declare const writeSolvaPaySecretToEnv: (secretKey: string, options?: EnvWriteOptions) => Promise<EnvWriteResult>;
 declare const readSolvaPayProductRefFromEnv: (cwd?: string) => Promise<string | undefined>;
+declare const readSolvaPaySecretKeyFromEnv: (cwd?: string) => Promise<string | undefined>;
+declare const readSolvaPayApiBaseUrlFromEnv: (cwd?: string) => Promise<string | undefined>;
 declare const writeSolvaPayProductRefToEnv: (productRef: string, options?: {
     cwd?: string;
 }) => Promise<EnvWriteResult>;
@@ -159,4 +169,29 @@ type RunInitInDirectoryOptions = {
 };
 declare const runInitInDirectory: ({ cwd, options, skipSdkInstall, }: RunInitInDirectoryOptions) => Promise<void>;
 
-export { type EnsureNodeProjectResult, type EnvWriteResult, type ExchangeResponse, type GitignoreEnvResult, type InitCommandOptions, type InitSessionResponse, type InstallResult, type ListProductsResult, type PackageManager, type PickResult, type ProductSummary, type RunInitInDirectoryOptions, SOLVAPAY_PRODUCT_REF_PLACEHOLDER, type VerifyProductRefResult, askKeepConfiguredProduct, createInitSession, detectPackageManager, ensureEnvInGitignore, ensureNodeProject, formatConfiguredProductLabel, getInstallCommand, getSolvaPayBasePackages, installSolvaPaySdk, listProducts, openAuthUrl, pickProductInteractive, readSolvaPayProductRefFromEnv, runInitInDirectory, verifyProductRef, verifySecretKey, waitForEnter, waitForExchange, writeSolvaPayApiBaseUrlToEnv, writeSolvaPayProductRefToEnv, writeSolvaPaySecretToEnv };
+type DoctorCommandOptions = {
+    /** Target api-dev.solvapay.com (same as `solvapay init --dev`). */
+    dev?: boolean;
+};
+type RunDoctorInDirectoryOptions = {
+    cwd: string;
+    options?: DoctorCommandOptions;
+};
+type DoctorCheckResult = {
+    name: string;
+    ok: boolean;
+    detail: string;
+};
+type DoctorReport = {
+    ok: boolean;
+    checks: DoctorCheckResult[];
+    apiBaseUrl: string;
+};
+/**
+ * Diagnose SolvaPay credentials + product readiness for the current project.
+ * Exits non-zero (via `report.ok === false`) when any hard check fails so it
+ * can gate CI / pre-deploy.
+ */
+declare const runDoctorInDirectory: ({ cwd, options, }: RunDoctorInDirectoryOptions) => Promise<DoctorReport>;
+
+export { type DoctorCheckResult, type DoctorCommandOptions, type DoctorReport, type EnsureNodeProjectResult, type EnvWriteResult, type ExchangeResponse, type GitignoreEnvResult, type InitCommandOptions, type InitSessionResponse, type InstallResult, type ListProductsResult, type PackageManager, type PickResult, type ProductSummary, type RunDoctorInDirectoryOptions, type RunInitInDirectoryOptions, SOLVAPAY_PRODUCT_REF_PLACEHOLDER, type VerifiedProductSummary, type VerifyProductRefResult, askKeepConfiguredProduct, createInitSession, detectPackageManager, ensureEnvInGitignore, ensureNodeProject, formatConfiguredProductLabel, getInstallCommand, getSolvaPayBasePackages, installSolvaPaySdk, listProducts, openAuthUrl, pickProductInteractive, readSolvaPayApiBaseUrlFromEnv, readSolvaPayProductRefFromEnv, readSolvaPaySecretKeyFromEnv, runDoctorInDirectory, runInitInDirectory, verifyProductRef, verifySecretKey, waitForEnter, waitForExchange, writeSolvaPayApiBaseUrlToEnv, writeSolvaPayProductRefToEnv, writeSolvaPaySecretToEnv };

package/dist/index.js

@@ -1,4 +1,5 @@
 // src/browser-auth.ts
+import { SOLVAPAY_PRODUCT_REF_PLACEHOLDER } from "@solvapay/core";
 import open from "open";
 var INIT_EXCHANGE_TIMEOUT_MS = 10 * 60 * 1e3;
 var POLL_INTERVAL_MS = 2e3;
@@ -82,9 +83,19 @@ var waitForExchange = async (apiBaseUrl, session) => {
     spinner.stop();
   }
 };
-var PRODUCT_REF_PLACEHOLDER = "__SOLVAPAY_PRODUCT_REF__";
+var parseVerifiedProduct = (payload) => {
+  if (!payload || typeof payload !== "object") return void 0;
+  const root = payload;
+  const data = root.data && typeof root.data === "object" ? root.data : root;
+  const name = typeof data.name === "string" ? data.name : void 0;
+  const status = typeof data.status === "string" ? data.status : void 0;
+  if (!name || !status) return void 0;
+  const rawPlans = Array.isArray(data.plans) ? data.plans : [];
+  const plans = rawPlans.filter((plan) => !!plan && typeof plan === "object").map((plan) => ({ isActive: plan.isActive === true }));
+  return { name, status, plans };
+};
 var verifyProductRef = async (apiBaseUrl, secretKey, productRef) => {
-  if (productRef === PRODUCT_REF_PLACEHOLDER) {
+  if (productRef === SOLVAPAY_PRODUCT_REF_PLACEHOLDER) {
     return { status: "invalid_placeholder" };
   }
   try {
@@ -98,7 +109,15 @@ var verifyProductRef = async (apiBaseUrl, secretKey, productRef) => {
       }
     );
     if (response.ok) {
-      return { status: "ok" };
+      const payload = await response.json();
+      const product = parseVerifiedProduct(payload);
+      if (!product) {
+        return {
+          status: "error",
+          message: "Product lookup succeeded but the response was missing name/status."
+        };
+      }
+      return { status: "ok", product };
     }
     const body = await response.text();
     if (response.status === 404) {
@@ -218,10 +237,11 @@ import { constants } from "fs";
 import path from "path";
 import readline from "readline/promises";
 import { stdin, stdout } from "process";
+import { SOLVAPAY_PRODUCT_REF_PLACEHOLDER as CORE_PRODUCT_REF_PLACEHOLDER } from "@solvapay/core";
 var SOLVAPAY_SECRET_KEY = "SOLVAPAY_SECRET_KEY";
 var SOLVAPAY_PRODUCT_REF = "SOLVAPAY_PRODUCT_REF";
 var SOLVAPAY_API_BASE_URL = "SOLVAPAY_API_BASE_URL";
-var SOLVAPAY_PRODUCT_REF_PLACEHOLDER = "__SOLVAPAY_PRODUCT_REF__";
+var SOLVAPAY_PRODUCT_REF_PLACEHOLDER2 = CORE_PRODUCT_REF_PLACEHOLDER;
 var envValueRegex = (key) => new RegExp(`^\\s*${key}\\s*=\\s*(.*)$`, "m");
 var secretKeyRegex = envValueRegex(SOLVAPAY_SECRET_KEY);
 var parseEnvValue = (raw) => {
@@ -296,20 +316,23 @@ var writeSolvaPaySecretToEnv = async (secretKey, options = {}) => {
   await writeFile(envPath, updatedContent, "utf8");
   return { filePath: envPath, action: "updated" };
 };
-var readSolvaPayProductRefFromEnv = async (cwd = process.cwd()) => {
+var readEnvKeyFromFile = async (key, cwd) => {
   const envPath = path.join(cwd, ".env");
   const exists = await envFileExists(envPath);
   if (!exists) {
     return void 0;
   }
   const content = await readFile(envPath, "utf8");
-  const match = content.match(envValueRegex(SOLVAPAY_PRODUCT_REF));
+  const match = content.match(envValueRegex(key));
   if (!match?.[1]) {
     return void 0;
   }
   const value = parseEnvValue(match[1]);
   return value.length > 0 ? value : void 0;
 };
+var readSolvaPayProductRefFromEnv = async (cwd = process.cwd()) => readEnvKeyFromFile(SOLVAPAY_PRODUCT_REF, cwd);
+var readSolvaPaySecretKeyFromEnv = async (cwd = process.cwd()) => readEnvKeyFromFile(SOLVAPAY_SECRET_KEY, cwd);
+var readSolvaPayApiBaseUrlFromEnv = async (cwd = process.cwd()) => readEnvKeyFromFile(SOLVAPAY_API_BASE_URL, cwd);
 var writeSolvaPayProductRefToEnv = async (productRef, options = {}) => {
   const envPath = path.join(options.cwd || process.cwd(), ".env");
   const keyLine = `${SOLVAPAY_PRODUCT_REF}=${productRef}`;
@@ -530,14 +553,14 @@ var parseProductSummary = (value) => {
     return null;
   }
   const record = value;
-  if (typeof record.reference !== "string" || typeof record.name !== "string" || typeof record.status !== "string" || typeof record.createdAt !== "string") {
+  if (typeof record.reference !== "string" || typeof record.name !== "string") {
     return null;
   }
   return {
     reference: record.reference,
     name: record.name,
-    status: record.status,
-    createdAt: record.createdAt
+    status: typeof record.status === "string" ? record.status : "",
+    createdAt: typeof record.createdAt === "string" ? record.createdAt : ""
   };
 };
 var listProducts = async (apiBaseUrl, secretKey, options = {}) => {
@@ -633,7 +656,7 @@ var pickProductInteractive = async (apiBaseUrl, secretKey, options) => {
     return { action: "skipped", reason: "network_error" };
   }
   const { products, total } = listResult;
-  if (products.length === 0) {
+  if (total === 0) {
     process.stdout.write(
       `\u26A0\uFE0F No products found on your SolvaPay account. Create one at ${CONSOLE_PRODUCTS_URL} and re-run \`solvapay init\`.
 `
@@ -824,7 +847,7 @@ var configureProductRef = async (apiBaseUrl, secretKey, cwd, options) => {
     return;
   }
   const existing = await readSolvaPayProductRefFromEnv(cwd);
-  if (existing && existing !== SOLVAPAY_PRODUCT_REF_PLACEHOLDER) {
+  if (existing && existing !== SOLVAPAY_PRODUCT_REF_PLACEHOLDER2) {
     const verified = await verifyProductRef(apiBaseUrl, secretKey, existing);
     if (verified.status === "ok") {
       if (options.yes) {
@@ -1055,8 +1078,158 @@ var runInitInDirectory = async ({
   process.stdout.write("\n");
   printSetupComplete();
 };
+
+// src/run-doctor.ts
+import chalk2 from "chalk";
+import {
+  evaluateProductReadiness,
+  SOLVAPAY_PRODUCT_REF_PLACEHOLDER as SOLVAPAY_PRODUCT_REF_PLACEHOLDER3
+} from "@solvapay/core";
+var DEFAULT_API_BASE_URL2 = "https://api.solvapay.com";
+var DEV_API_BASE_URL2 = "https://api-dev.solvapay.com";
+var preferEnv = (processValue, fileValue) => {
+  if (typeof processValue === "string" && processValue.trim().length > 0) {
+    return processValue.trim();
+  }
+  if (typeof fileValue === "string" && fileValue.trim().length > 0) {
+    return fileValue.trim();
+  }
+  return void 0;
+};
+var resolveApiBaseUrl2 = async (cwd, opts) => {
+  if (opts.dev) return DEV_API_BASE_URL2;
+  const fromFile = await readSolvaPayApiBaseUrlFromEnv(cwd);
+  const resolved = preferEnv(process.env.SOLVAPAY_API_BASE_URL, fromFile);
+  return (resolved || DEFAULT_API_BASE_URL2).replace(/\/$/, "");
+};
+var printCheck = (check) => {
+  const mark = check.ok ? chalk2.green("\u2713") : chalk2.red("\u2717");
+  process.stdout.write(`${mark} ${check.name}: ${check.detail}
+`);
+};
+var runDoctorInDirectory = async ({
+  cwd,
+  options = {}
+}) => {
+  const checks = [];
+  const apiBaseUrl = await resolveApiBaseUrl2(cwd, options);
+  process.stdout.write(`
+SolvaPay doctor \u2014 ${apiBaseUrl}
+
+`);
+  const secretFromFile = await readSolvaPaySecretKeyFromEnv(cwd);
+  const secretKey = preferEnv(process.env.SOLVAPAY_SECRET_KEY, secretFromFile);
+  if (!secretKey) {
+    checks.push({
+      name: "SOLVAPAY_SECRET_KEY",
+      ok: false,
+      detail: "missing (set via `npx solvapay init` or your environment)"
+    });
+  } else {
+    const verified = await verifySecretKey(apiBaseUrl, secretKey);
+    checks.push({
+      name: "SOLVAPAY_SECRET_KEY",
+      ok: verified.ok,
+      detail: verified.ok ? "accepted by the API" : verified.warning ?? "rejected by the API"
+    });
+  }
+  checks.push({
+    name: "SOLVAPAY_API_BASE_URL",
+    ok: true,
+    detail: apiBaseUrl
+  });
+  if (!secretKey) {
+    try {
+      const response = await fetch(`${apiBaseUrl}/v1/sdk/products`, { method: "GET" });
+      checks.push({
+        name: "API reachability",
+        ok: response.status !== 0,
+        detail: response.status === 401 || response.status === 403 ? `reachable (HTTP ${response.status} without a key \u2014 expected)` : `HTTP ${response.status}`
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Network error";
+      checks.push({
+        name: "API reachability",
+        ok: false,
+        detail: message
+      });
+    }
+  }
+  const productRefFromFile = await readSolvaPayProductRefFromEnv(cwd);
+  const productRef = preferEnv(process.env.SOLVAPAY_PRODUCT_REF, productRefFromFile);
+  if (!productRef) {
+    checks.push({
+      name: "SOLVAPAY_PRODUCT_REF",
+      ok: false,
+      detail: "missing"
+    });
+  } else if (productRef === SOLVAPAY_PRODUCT_REF_PLACEHOLDER3) {
+    checks.push({
+      name: "SOLVAPAY_PRODUCT_REF",
+      ok: false,
+      detail: `still the scaffolder placeholder "${SOLVAPAY_PRODUCT_REF_PLACEHOLDER3}"`
+    });
+  } else if (!secretKey) {
+    checks.push({
+      name: "SOLVAPAY_PRODUCT_REF",
+      ok: false,
+      detail: `set to "${productRef}" but cannot verify without SOLVAPAY_SECRET_KEY`
+    });
+  } else {
+    const verified = await verifyProductRef(apiBaseUrl, secretKey, productRef);
+    if (verified.status === "ok") {
+      const readiness = evaluateProductReadiness(verified.product);
+      checks.push({
+        name: "SOLVAPAY_PRODUCT_REF",
+        ok: true,
+        detail: `exists \u2014 "${verified.product.name}" (${verified.product.status})`
+      });
+      checks.push({
+        name: "Product readiness",
+        ok: readiness.ready,
+        detail: readiness.ready ? `${readiness.activePlans}/${readiness.totalPlans} active plan(s)` : readiness.issues.join("; ")
+      });
+    } else if (verified.status === "not_found") {
+      checks.push({
+        name: "SOLVAPAY_PRODUCT_REF",
+        ok: false,
+        detail: `"${productRef}" not found on ${apiBaseUrl}`
+      });
+    } else if (verified.status === "invalid_placeholder") {
+      checks.push({
+        name: "SOLVAPAY_PRODUCT_REF",
+        ok: false,
+        detail: `still the scaffolder placeholder`
+      });
+    } else {
+      checks.push({
+        name: "SOLVAPAY_PRODUCT_REF",
+        ok: false,
+        detail: verified.status === "error" ? verified.message : "could not verify"
+      });
+    }
+  }
+  const debugRaw = process.env.SOLVAPAY_DEBUG;
+  checks.push({
+    name: "SOLVAPAY_DEBUG defaults",
+    ok: true,
+    detail: debugRaw === void 0 ? 'warning: unset \u2014 factory treats debug as ON (!== "false") while client/paywall treat it as OFF (=== "true"). Set explicitly to "true" or "false".' : `set to "${debugRaw}"`
+  });
+  for (const check of checks) {
+    printCheck(check);
+  }
+  const ok = checks.every((check) => check.ok);
+  process.stdout.write(
+    ok ? `
+${chalk2.green("All checks passed.")}
+` : `
+${chalk2.red("Doctor found problems. Fix the \u2717 items above, then re-run.")}
+`
+  );
+  return { ok, checks, apiBaseUrl };
+};
 export {
-  SOLVAPAY_PRODUCT_REF_PLACEHOLDER,
+  SOLVAPAY_PRODUCT_REF_PLACEHOLDER2 as SOLVAPAY_PRODUCT_REF_PLACEHOLDER,
   askKeepConfiguredProduct,
   createInitSession,
   detectPackageManager,
@@ -1069,7 +1242,10 @@ export {
   listProducts,
   openAuthUrl,
   pickProductInteractive,
+  readSolvaPayApiBaseUrlFromEnv,
   readSolvaPayProductRefFromEnv,
+  readSolvaPaySecretKeyFromEnv,
+  runDoctorInDirectory,
   runInitInDirectory,
   verifyProductRef,
   verifySecretKey,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvapay/init",
-  "version": "0.3.0",
+  "version": "0.4.0-preview-e7613cf5668b4f45b2e72a5047d08441e78ebd41",
   "description": "Shared primitives for SolvaPay CLI tooling (browser auth, env writers, product picker, install runner). Consumed by `solvapay` and `create-solvapay`.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -31,7 +31,8 @@
   "sideEffects": false,
   "dependencies": {
     "chalk": "^5.6.2",
-    "open": "^11.0.0"
+    "open": "^11.0.0",
+    "@solvapay/core": "1.3.0-preview-e7613cf5668b4f45b2e72a5047d08441e78ebd41"
   },
   "devDependencies": {
     "tsup": "^8.5.1",