@solvapay/init 0.5.0 → 0.6.0-preview-7c1def75e5173f539a8bb4ea312cdeb445ae654c

package/dist/index.cjs

@@ -32,10 +32,12 @@ var index_exports = {};
 __export(index_exports, {
   SOLVAPAY_PRODUCT_REF_PLACEHOLDER: () => SOLVAPAY_PRODUCT_REF_PLACEHOLDER2,
   askKeepConfiguredProduct: () => askKeepConfiguredProduct,
+  compareStable: () => compareStable,
   createInitSession: () => createInitSession,
   detectPackageManager: () => detectPackageManager,
   ensureEnvInGitignore: () => ensureEnvInGitignore,
   ensureNodeProject: () => ensureNodeProject,
+  findOutdatedSolvapayPackages: () => findOutdatedSolvapayPackages,
   formatConfiguredProductLabel: () => formatConfiguredProductLabel,
   getInstallCommand: () => getInstallCommand,
   getSolvaPayBasePackages: () => getSolvaPayBasePackages,
@@ -48,6 +50,8 @@ __export(index_exports, {
   readSolvaPaySecretKeyFromEnv: () => readSolvaPaySecretKeyFromEnv,
   runDoctorInDirectory: () => runDoctorInDirectory,
   runInitInDirectory: () => runInitInDirectory,
+  solvapayDependencies: () => solvapayDependencies,
+  upgradeCommand: () => upgradeCommand,
   verifyProductRef: () => verifyProductRef,
   verifySecretKey: () => verifySecretKey,
   waitForEnter: () => waitForEnter,
@@ -1165,6 +1169,83 @@ var runInitInDirectory = async ({
 // src/run-doctor.ts
 var import_chalk2 = __toESM(require("chalk"), 1);
 var import_core3 = require("@solvapay/core");
+
+// src/sdk-versions.ts
+var import_promises6 = require("fs/promises");
+var import_node_path3 = __toESM(require("path"), 1);
+var REGISTRY = "https://registry.npmjs.org";
+var readJson = async (file) => {
+  try {
+    return JSON.parse(await (0, import_promises6.readFile)(file, "utf8"));
+  } catch (error) {
+    if (error.code === "ENOENT") return null;
+    throw error;
+  }
+};
+var solvapayDependencies = async (cwd) => {
+  const pkg = await readJson(import_node_path3.default.join(cwd, "package.json"));
+  if (!pkg) return null;
+  const names = /* @__PURE__ */ new Set([
+    ...Object.keys(pkg.dependencies ?? {}),
+    ...Object.keys(pkg.devDependencies ?? {})
+  ]);
+  return [...names].filter((name) => name.startsWith("@solvapay/")).sort();
+};
+var fetchDistTags = async (name) => {
+  const url = `${REGISTRY}/-/package/${name}/dist-tags`;
+  let response;
+  try {
+    response = await fetch(url, {
+      headers: { accept: "application/json" },
+      signal: AbortSignal.timeout(1e4)
+    });
+  } catch (error) {
+    throw new Error(
+      `Could not reach ${url}: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  if (!response.ok) throw new Error(`${url} answered ${response.status}`);
+  return await response.json();
+};
+var isPreview = (version) => version.includes("-");
+var compareStable = (a, b) => {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const x = pa[i] ?? 0;
+    const y = pb[i] ?? 0;
+    if (x !== y) return x < y ? -1 : 1;
+  }
+  return 0;
+};
+var findOutdatedSolvapayPackages = async (cwd, names, distTags = fetchDistTags) => {
+  const outdated = [];
+  for (const name of names) {
+    const installedPkg = await readJson(
+      import_node_path3.default.join(cwd, "node_modules", ...name.split("/"), "package.json")
+    );
+    if (!installedPkg || typeof installedPkg.version !== "string") {
+      throw new Error(
+        `${name} is in package.json but not installed. Run your package manager's install first.`
+      );
+    }
+    const installed = installedPkg.version;
+    const tag = isPreview(installed) ? "preview" : "latest";
+    const wanted = (await distTags(name))[tag];
+    if (typeof wanted !== "string") throw new Error(`npm has no '${tag}' tag for ${name}`);
+    const behind = isPreview(installed) ? installed !== wanted : compareStable(installed, wanted) < 0;
+    if (behind) outdated.push({ name, installed, wanted, tag });
+  }
+  return outdated;
+};
+var upgradeCommand = (packageManager, outdated) => {
+  const specs = outdated.map((o) => `${o.name}@${o.wanted}`).join(" ");
+  if (packageManager === "pnpm") return `pnpm add --save-exact ${specs}`;
+  if (packageManager === "yarn") return `yarn add --exact ${specs}`;
+  return `npm install --save-exact ${specs}`;
+};
+
+// src/run-doctor.ts
 var DEFAULT_API_BASE_URL2 = "https://api.solvapay.com";
 var DEV_API_BASE_URL2 = "https://api-dev.solvapay.com";
 var preferEnv = (processValue, fileValue) => {
@@ -1187,9 +1268,25 @@ var printCheck = (check) => {
   process.stdout.write(`${mark} ${check.name}: ${check.detail}
 `);
 };
+var checkSdkVersions = async (cwd, distTags) => {
+  const name = "@solvapay/* versions";
+  try {
+    const names = await solvapayDependencies(cwd);
+    if (names === null) return { name, ok: true, detail: `no package.json in ${cwd}, nothing to check` };
+    if (names.length === 0) return { name, ok: true, detail: "no @solvapay/* dependencies" };
+    const outdated = await findOutdatedSolvapayPackages(cwd, names, distTags);
+    if (outdated.length === 0) return { name, ok: true, detail: `${names.length} package(s) match npm` };
+    const behind = outdated.map((o) => `${o.name} ${o.installed} (npm ${o.tag} ${o.wanted})`).join(", ");
+    const command = upgradeCommand(await detectPackageManager(cwd), outdated);
+    return { name, ok: false, detail: `behind npm: ${behind}. Upgrade with: ${command}` };
+  } catch (error) {
+    return { name, ok: false, detail: error instanceof Error ? error.message : String(error) };
+  }
+};
 var runDoctorInDirectory = async ({
   cwd,
-  options = {}
+  options = {},
+  distTags = fetchDistTags
 }) => {
   const checks = [];
   const apiBaseUrl = await resolveApiBaseUrl2(cwd, options);
@@ -1289,6 +1386,7 @@ SolvaPay doctor \u2014 ${apiBaseUrl}
       });
     }
   }
+  checks.push(await checkSdkVersions(cwd, distTags));
   const debugRaw = process.env.SOLVAPAY_DEBUG;
   checks.push({
     name: "SOLVAPAY_DEBUG defaults",
@@ -1312,10 +1410,12 @@ ${import_chalk2.default.red("Doctor found problems. Fix the \u2717 items above,
 0 && (module.exports = {
   SOLVAPAY_PRODUCT_REF_PLACEHOLDER,
   askKeepConfiguredProduct,
+  compareStable,
   createInitSession,
   detectPackageManager,
   ensureEnvInGitignore,
   ensureNodeProject,
+  findOutdatedSolvapayPackages,
   formatConfiguredProductLabel,
   getInstallCommand,
   getSolvaPayBasePackages,
@@ -1328,6 +1428,8 @@ ${import_chalk2.default.red("Doctor found problems. Fix the \u2717 items above,
   readSolvaPaySecretKeyFromEnv,
   runDoctorInDirectory,
   runInitInDirectory,
+  solvapayDependencies,
+  upgradeCommand,
   verifyProductRef,
   verifySecretKey,
   waitForEnter,

package/dist/index.d.cts

@@ -169,6 +169,23 @@ type RunInitInDirectoryOptions = {
 };
 declare const runInitInDirectory: ({ cwd, options, skipSdkInstall, }: RunInitInDirectoryOptions) => Promise<void>;
 
+type DistTags = Record<string, string | undefined>;
+type FetchDistTags = (name: string) => Promise<DistTags>;
+type OutdatedPackage = {
+    name: string;
+    installed: string;
+    wanted: string;
+    tag: 'latest' | 'preview';
+};
+/** `@solvapay/*` names in dependencies and devDependencies, or `null` without a package.json. */
+declare const solvapayDependencies: (cwd: string) => Promise<string[] | null>;
+/** -1, 0 or 1 for two plain `x.y.z` versions. */
+declare const compareStable: (a: string, b: string) => number;
+/** Each declared `@solvapay/*` package whose installed version is behind npm. */
+declare const findOutdatedSolvapayPackages: (cwd: string, names: string[], distTags?: FetchDistTags) => Promise<OutdatedPackage[]>;
+/** The install command that pins each package exactly, for the project's package manager. */
+declare const upgradeCommand: (packageManager: PackageManager, outdated: OutdatedPackage[]) => string;
+
 type DoctorCommandOptions = {
     /** Target api-dev.solvapay.com (same as `solvapay init --dev`). */
     dev?: boolean;
@@ -176,6 +193,8 @@ type DoctorCommandOptions = {
 type RunDoctorInDirectoryOptions = {
     cwd: string;
     options?: DoctorCommandOptions;
+    /** npm dist-tag lookup, injectable for tests. */
+    distTags?: FetchDistTags;
 };
 type DoctorCheckResult = {
     name: string;
@@ -187,11 +206,6 @@ type DoctorReport = {
     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>;
+declare const runDoctorInDirectory: ({ cwd, options, distTags, }: 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 };
+export { type DistTags, type DoctorCheckResult, type DoctorCommandOptions, type DoctorReport, type EnsureNodeProjectResult, type EnvWriteResult, type ExchangeResponse, type FetchDistTags, type GitignoreEnvResult, type InitCommandOptions, type InitSessionResponse, type InstallResult, type ListProductsResult, type OutdatedPackage, type PackageManager, type PickResult, type ProductSummary, type RunDoctorInDirectoryOptions, type RunInitInDirectoryOptions, SOLVAPAY_PRODUCT_REF_PLACEHOLDER, type VerifiedProductSummary, type VerifyProductRefResult, askKeepConfiguredProduct, compareStable, createInitSession, detectPackageManager, ensureEnvInGitignore, ensureNodeProject, findOutdatedSolvapayPackages, formatConfiguredProductLabel, getInstallCommand, getSolvaPayBasePackages, installSolvaPaySdk, listProducts, openAuthUrl, pickProductInteractive, readSolvaPayApiBaseUrlFromEnv, readSolvaPayProductRefFromEnv, readSolvaPaySecretKeyFromEnv, runDoctorInDirectory, runInitInDirectory, solvapayDependencies, upgradeCommand, verifyProductRef, verifySecretKey, waitForEnter, waitForExchange, writeSolvaPayApiBaseUrlToEnv, writeSolvaPayProductRefToEnv, writeSolvaPaySecretToEnv };

package/dist/index.d.ts

@@ -169,6 +169,23 @@ type RunInitInDirectoryOptions = {
 };
 declare const runInitInDirectory: ({ cwd, options, skipSdkInstall, }: RunInitInDirectoryOptions) => Promise<void>;
 
+type DistTags = Record<string, string | undefined>;
+type FetchDistTags = (name: string) => Promise<DistTags>;
+type OutdatedPackage = {
+    name: string;
+    installed: string;
+    wanted: string;
+    tag: 'latest' | 'preview';
+};
+/** `@solvapay/*` names in dependencies and devDependencies, or `null` without a package.json. */
+declare const solvapayDependencies: (cwd: string) => Promise<string[] | null>;
+/** -1, 0 or 1 for two plain `x.y.z` versions. */
+declare const compareStable: (a: string, b: string) => number;
+/** Each declared `@solvapay/*` package whose installed version is behind npm. */
+declare const findOutdatedSolvapayPackages: (cwd: string, names: string[], distTags?: FetchDistTags) => Promise<OutdatedPackage[]>;
+/** The install command that pins each package exactly, for the project's package manager. */
+declare const upgradeCommand: (packageManager: PackageManager, outdated: OutdatedPackage[]) => string;
+
 type DoctorCommandOptions = {
     /** Target api-dev.solvapay.com (same as `solvapay init --dev`). */
     dev?: boolean;
@@ -176,6 +193,8 @@ type DoctorCommandOptions = {
 type RunDoctorInDirectoryOptions = {
     cwd: string;
     options?: DoctorCommandOptions;
+    /** npm dist-tag lookup, injectable for tests. */
+    distTags?: FetchDistTags;
 };
 type DoctorCheckResult = {
     name: string;
@@ -187,11 +206,6 @@ type DoctorReport = {
     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>;
+declare const runDoctorInDirectory: ({ cwd, options, distTags, }: 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 };
+export { type DistTags, type DoctorCheckResult, type DoctorCommandOptions, type DoctorReport, type EnsureNodeProjectResult, type EnvWriteResult, type ExchangeResponse, type FetchDistTags, type GitignoreEnvResult, type InitCommandOptions, type InitSessionResponse, type InstallResult, type ListProductsResult, type OutdatedPackage, type PackageManager, type PickResult, type ProductSummary, type RunDoctorInDirectoryOptions, type RunInitInDirectoryOptions, SOLVAPAY_PRODUCT_REF_PLACEHOLDER, type VerifiedProductSummary, type VerifyProductRefResult, askKeepConfiguredProduct, compareStable, createInitSession, detectPackageManager, ensureEnvInGitignore, ensureNodeProject, findOutdatedSolvapayPackages, formatConfiguredProductLabel, getInstallCommand, getSolvaPayBasePackages, installSolvaPaySdk, listProducts, openAuthUrl, pickProductInteractive, readSolvaPayApiBaseUrlFromEnv, readSolvaPayProductRefFromEnv, readSolvaPaySecretKeyFromEnv, runDoctorInDirectory, runInitInDirectory, solvapayDependencies, upgradeCommand, verifyProductRef, verifySecretKey, waitForEnter, waitForExchange, writeSolvaPayApiBaseUrlToEnv, writeSolvaPayProductRefToEnv, writeSolvaPaySecretToEnv };

package/dist/index.js

@@ -1108,6 +1108,83 @@ import {
   evaluateProductReadiness,
   SOLVAPAY_PRODUCT_REF_PLACEHOLDER as SOLVAPAY_PRODUCT_REF_PLACEHOLDER3
 } from "@solvapay/core";
+
+// src/sdk-versions.ts
+import { readFile as readFile3 } from "fs/promises";
+import path3 from "path";
+var REGISTRY = "https://registry.npmjs.org";
+var readJson = async (file) => {
+  try {
+    return JSON.parse(await readFile3(file, "utf8"));
+  } catch (error) {
+    if (error.code === "ENOENT") return null;
+    throw error;
+  }
+};
+var solvapayDependencies = async (cwd) => {
+  const pkg = await readJson(path3.join(cwd, "package.json"));
+  if (!pkg) return null;
+  const names = /* @__PURE__ */ new Set([
+    ...Object.keys(pkg.dependencies ?? {}),
+    ...Object.keys(pkg.devDependencies ?? {})
+  ]);
+  return [...names].filter((name) => name.startsWith("@solvapay/")).sort();
+};
+var fetchDistTags = async (name) => {
+  const url = `${REGISTRY}/-/package/${name}/dist-tags`;
+  let response;
+  try {
+    response = await fetch(url, {
+      headers: { accept: "application/json" },
+      signal: AbortSignal.timeout(1e4)
+    });
+  } catch (error) {
+    throw new Error(
+      `Could not reach ${url}: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  if (!response.ok) throw new Error(`${url} answered ${response.status}`);
+  return await response.json();
+};
+var isPreview = (version) => version.includes("-");
+var compareStable = (a, b) => {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const x = pa[i] ?? 0;
+    const y = pb[i] ?? 0;
+    if (x !== y) return x < y ? -1 : 1;
+  }
+  return 0;
+};
+var findOutdatedSolvapayPackages = async (cwd, names, distTags = fetchDistTags) => {
+  const outdated = [];
+  for (const name of names) {
+    const installedPkg = await readJson(
+      path3.join(cwd, "node_modules", ...name.split("/"), "package.json")
+    );
+    if (!installedPkg || typeof installedPkg.version !== "string") {
+      throw new Error(
+        `${name} is in package.json but not installed. Run your package manager's install first.`
+      );
+    }
+    const installed = installedPkg.version;
+    const tag = isPreview(installed) ? "preview" : "latest";
+    const wanted = (await distTags(name))[tag];
+    if (typeof wanted !== "string") throw new Error(`npm has no '${tag}' tag for ${name}`);
+    const behind = isPreview(installed) ? installed !== wanted : compareStable(installed, wanted) < 0;
+    if (behind) outdated.push({ name, installed, wanted, tag });
+  }
+  return outdated;
+};
+var upgradeCommand = (packageManager, outdated) => {
+  const specs = outdated.map((o) => `${o.name}@${o.wanted}`).join(" ");
+  if (packageManager === "pnpm") return `pnpm add --save-exact ${specs}`;
+  if (packageManager === "yarn") return `yarn add --exact ${specs}`;
+  return `npm install --save-exact ${specs}`;
+};
+
+// src/run-doctor.ts
 var DEFAULT_API_BASE_URL2 = "https://api.solvapay.com";
 var DEV_API_BASE_URL2 = "https://api-dev.solvapay.com";
 var preferEnv = (processValue, fileValue) => {
@@ -1130,9 +1207,25 @@ var printCheck = (check) => {
   process.stdout.write(`${mark} ${check.name}: ${check.detail}
 `);
 };
+var checkSdkVersions = async (cwd, distTags) => {
+  const name = "@solvapay/* versions";
+  try {
+    const names = await solvapayDependencies(cwd);
+    if (names === null) return { name, ok: true, detail: `no package.json in ${cwd}, nothing to check` };
+    if (names.length === 0) return { name, ok: true, detail: "no @solvapay/* dependencies" };
+    const outdated = await findOutdatedSolvapayPackages(cwd, names, distTags);
+    if (outdated.length === 0) return { name, ok: true, detail: `${names.length} package(s) match npm` };
+    const behind = outdated.map((o) => `${o.name} ${o.installed} (npm ${o.tag} ${o.wanted})`).join(", ");
+    const command = upgradeCommand(await detectPackageManager(cwd), outdated);
+    return { name, ok: false, detail: `behind npm: ${behind}. Upgrade with: ${command}` };
+  } catch (error) {
+    return { name, ok: false, detail: error instanceof Error ? error.message : String(error) };
+  }
+};
 var runDoctorInDirectory = async ({
   cwd,
-  options = {}
+  options = {},
+  distTags = fetchDistTags
 }) => {
   const checks = [];
   const apiBaseUrl = await resolveApiBaseUrl2(cwd, options);
@@ -1232,6 +1325,7 @@ SolvaPay doctor \u2014 ${apiBaseUrl}
       });
     }
   }
+  checks.push(await checkSdkVersions(cwd, distTags));
   const debugRaw = process.env.SOLVAPAY_DEBUG;
   checks.push({
     name: "SOLVAPAY_DEBUG defaults",
@@ -1254,10 +1348,12 @@ ${chalk2.red("Doctor found problems. Fix the \u2717 items above, then re-run.")}
 export {
   SOLVAPAY_PRODUCT_REF_PLACEHOLDER2 as SOLVAPAY_PRODUCT_REF_PLACEHOLDER,
   askKeepConfiguredProduct,
+  compareStable,
   createInitSession,
   detectPackageManager,
   ensureEnvInGitignore,
   ensureNodeProject,
+  findOutdatedSolvapayPackages,
   formatConfiguredProductLabel,
   getInstallCommand,
   getSolvaPayBasePackages,
@@ -1270,6 +1366,8 @@ export {
   readSolvaPaySecretKeyFromEnv,
   runDoctorInDirectory,
   runInitInDirectory,
+  solvapayDependencies,
+  upgradeCommand,
   verifyProductRef,
   verifySecretKey,
   waitForEnter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvapay/init",
-  "version": "0.5.0",
+  "version": "0.6.0-preview-7c1def75e5173f539a8bb4ea312cdeb445ae654c",
   "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",