@moneydevkit/create 0.3.1 → 0.3.3

package/dist/index.js

@@ -5,8 +5,8 @@ import { createORPCClient } from "@orpc/client";
 import { RPCLink } from "@orpc/client/fetch";
 import * as p from "@clack/prompts";
 import minimist from "minimist";
-import path2 from "path";
-import fs from "fs";
+import path6 from "path";
+import fs5 from "fs";
 import os from "os";
 import open from "open";
 import clipboard from "clipboardy";
@@ -49,6 +49,556 @@ function deriveProjectName(input, webhookUrl) {
   return webhookUrl;
 }
 
+// src/utils/nextjs-detector.ts
+import fs from "fs";
+import path2 from "path";
+import semver from "semver";
+var NEXT_CONFIG_BASENAMES = [
+  "next.config.js",
+  "next.config.cjs",
+  "next.config.mjs",
+  "next.config.ts",
+  "next.config.mts"
+];
+var APP_DIR_CANDIDATES = ["app", path2.join("src", "app")];
+var PAGES_DIR_CANDIDATES = ["pages", path2.join("src", "pages")];
+function fileExists(target) {
+  try {
+    return fs.existsSync(target);
+  } catch {
+    return false;
+  }
+}
+function readPackageJson(pkgPath) {
+  try {
+    const content = fs.readFileSync(pkgPath, "utf8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function hasNextDependency(pkg) {
+  const deps = pkg.dependencies;
+  const devDeps = pkg.devDependencies;
+  return Boolean(deps?.next || devDeps?.next);
+}
+function extractNextVersion(pkg) {
+  const deps = pkg.dependencies;
+  const devDeps = pkg.devDependencies;
+  return deps?.next ?? devDeps?.next ?? void 0;
+}
+function findNearestPackageJson(startDir) {
+  let current = path2.resolve(startDir);
+  while (true) {
+    const candidate = path2.join(current, "package.json");
+    if (fileExists(candidate)) {
+      return candidate;
+    }
+    const parent = path2.dirname(current);
+    if (parent === current) {
+      return void 0;
+    }
+    current = parent;
+  }
+}
+function findNextConfig(rootDir) {
+  for (const basename of NEXT_CONFIG_BASENAMES) {
+    const candidate = path2.join(rootDir, basename);
+    if (fileExists(candidate)) {
+      return candidate;
+    }
+  }
+  return void 0;
+}
+function detectNextJsProject(startDir) {
+  const pkgPath = findNearestPackageJson(startDir);
+  const rootDir = pkgPath ? path2.dirname(pkgPath) : path2.resolve(startDir);
+  const pkg = pkgPath ? readPackageJson(pkgPath) : null;
+  const hasNext = pkg ? hasNextDependency(pkg) : false;
+  const nextVersion = pkg ? extractNextVersion(pkg) : void 0;
+  let versionIsSupported = true;
+  if (nextVersion) {
+    const minVersion = semver.minVersion(nextVersion);
+    if (minVersion) {
+      versionIsSupported = semver.gte(minVersion, "15.0.0");
+    }
+  }
+  const nextConfigPath = findNextConfig(rootDir);
+  const appDir = APP_DIR_CANDIDATES.map((candidate) => path2.join(rootDir, candidate)).find(
+    (candidate) => fileExists(candidate)
+  );
+  const pagesDir = PAGES_DIR_CANDIDATES.map((candidate) => path2.join(rootDir, candidate)).find(
+    (candidate) => fileExists(candidate)
+  );
+  const usesTypeScript = fileExists(path2.join(rootDir, "tsconfig.json")) || fileExists(path2.join(rootDir, "next-env.d.ts"));
+  const found = Boolean(hasNext || nextConfigPath || appDir || pagesDir);
+  return {
+    found,
+    rootDir: found ? rootDir : void 0,
+    nextConfigPath,
+    appDir,
+    pagesDir,
+    usesTypeScript,
+    nextVersion,
+    versionIsSupported
+  };
+}
+
+// src/scaffold/nextjs.ts
+import fs4 from "fs";
+import path5 from "path";
+import { spawn } from "child_process";
+
+// src/utils/package-manager.ts
+import fs2 from "fs";
+import path3 from "path";
+function detectPackageManager(rootDir) {
+  if (fs2.existsSync(path3.join(rootDir, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs2.existsSync(path3.join(rootDir, "yarn.lock"))) return "yarn";
+  if (fs2.existsSync(path3.join(rootDir, "bun.lockb"))) return "bun";
+  if (fs2.existsSync(path3.join(rootDir, "package-lock.json"))) return "npm";
+  return "npm";
+}
+function hasDependency(rootDir, depName) {
+  try {
+    const pkg = JSON.parse(fs2.readFileSync(path3.join(rootDir, "package.json"), "utf8"));
+    return Boolean(pkg.dependencies?.[depName] || pkg.devDependencies?.[depName]);
+  } catch {
+    return false;
+  }
+}
+
+// src/utils/fs-utils.ts
+import fs3 from "fs";
+import path4 from "path";
+function ensureDir(filePath) {
+  const dir = path4.dirname(filePath);
+  fs3.mkdirSync(dir, { recursive: true });
+}
+function readFileSafe(filePath) {
+  try {
+    return fs3.readFileSync(filePath, "utf8");
+  } catch {
+    return null;
+  }
+}
+function writeFileIfAbsent(filePath, content) {
+  if (fs3.existsSync(filePath)) {
+    const existing = readFileSafe(filePath);
+    if (existing?.trim() === content.trim()) {
+      return { status: "skipped-exists", path: filePath };
+    }
+    return { status: "skipped-different", path: filePath };
+  }
+  ensureDir(filePath);
+  fs3.writeFileSync(filePath, content, "utf8");
+  return { status: "created", path: filePath };
+}
+function writeFileWithBackup(filePath, content) {
+  if (!fs3.existsSync(filePath)) {
+    ensureDir(filePath);
+    fs3.writeFileSync(filePath, content, "utf8");
+    return { status: "created", path: filePath };
+  }
+  const existing = readFileSafe(filePath) ?? "";
+  if (existing.trim() === content.trim()) {
+    return { status: "skipped-exists", path: filePath };
+  }
+  const backupPath = `${filePath}.mdk-backup`;
+  fs3.writeFileSync(backupPath, existing, "utf8");
+  fs3.writeFileSync(filePath, content, "utf8");
+  return { status: "updated-with-backup", path: filePath, backupPath };
+}
+
+// src/scaffold/nextjs.ts
+function findExistingConfig(rootDir, preferred) {
+  if (preferred && fs4.existsSync(preferred)) return preferred;
+  const candidates = [
+    "next.config.js",
+    "next.config.cjs",
+    "next.config.mjs",
+    "next.config.ts",
+    "next.config.mts"
+  ];
+  for (const candidate of candidates) {
+    const fullPath = path5.join(rootDir, candidate);
+    if (fs4.existsSync(fullPath)) {
+      return fullPath;
+    }
+  }
+  return void 0;
+}
+async function installNextjsPackage(rootDir, packageManager) {
+  if (hasDependency(rootDir, "@moneydevkit/nextjs")) {
+    return { installed: false, skipped: true };
+  }
+  const commandForPm = {
+    pnpm: ["pnpm", ["add", "@moneydevkit/nextjs"]],
+    yarn: ["yarn", ["add", "@moneydevkit/nextjs"]],
+    npm: ["npm", ["install", "@moneydevkit/nextjs"]],
+    bun: ["bun", ["add", "@moneydevkit/nextjs"]]
+  };
+  const [cmd, args] = commandForPm[packageManager];
+  await new Promise((resolve, reject) => {
+    const child = spawn(cmd, args, { stdio: "inherit", cwd: rootDir });
+    child.on("exit", (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`${cmd} ${args.join(" ")} failed with code ${code}`));
+      }
+    });
+    child.on("error", reject);
+  });
+  return { installed: true, skipped: false };
+}
+function createAppRouteContent(isTypeScript) {
+  const ext = isTypeScript ? "ts" : "js";
+  if (ext === "ts") {
+    return 'export { POST } from "@moneydevkit/nextjs/server/route";\n';
+  }
+  return 'export { POST } from "@moneydevkit/nextjs/server/route";\n';
+}
+function createAppCheckoutPageContent(isTypeScript) {
+  if (isTypeScript) {
+    return [
+      '"use client";',
+      "",
+      'import { Checkout } from "@moneydevkit/nextjs";',
+      "",
+      "type CheckoutPageProps = { params: { id: string } };",
+      "",
+      "export default function CheckoutPage({ params }: CheckoutPageProps) {",
+      "  return <Checkout id={params.id} />;",
+      "}",
+      ""
+    ].join("\n");
+  }
+  return [
+    '"use client";',
+    "",
+    'import { Checkout } from "@moneydevkit/nextjs";',
+    "",
+    "export default function CheckoutPage({ params }) {",
+    "  return <Checkout id={params.id} />;",
+    "}",
+    ""
+  ].join("\n");
+}
+function createPagesApiRouteContent(isTypeScript) {
+  if (isTypeScript) {
+    return [
+      'import type { NextApiRequest, NextApiResponse } from "next";',
+      'import { POST as appRouteHandler } from "@moneydevkit/nextjs/server/route";',
+      "",
+      "export default async function handler(req: NextApiRequest, res: NextApiResponse) {",
+      '  const url = `http://${req.headers.host ?? "localhost"}${req.url ?? "/api/mdk"}`;',
+      "  const request = new Request(url, {",
+      '    method: req.method || "POST",',
+      "    headers: req.headers as Record<string, string>,",
+      "    body:",
+      '      req.method === "GET" || req.method === "HEAD"',
+      "        ? undefined",
+      '        : typeof req.body === "string"',
+      "          ? req.body",
+      "          : JSON.stringify(req.body ?? {}),",
+      "  });",
+      "",
+      "  const response = await appRouteHandler(request);",
+      "  res.status(response.status);",
+      "  response.headers.forEach((value, key) => {",
+      "    res.setHeader(key, value);",
+      "  });",
+      "  const body = await response.arrayBuffer();",
+      "  res.send(Buffer.from(body));",
+      "}",
+      ""
+    ].join("\n");
+  }
+  return [
+    'import { POST as appRouteHandler } from "@moneydevkit/nextjs/server/route";',
+    "",
+    "export default async function handler(req, res) {",
+    '  const url = `http://${req.headers.host ?? "localhost"}${req.url ?? "/api/mdk"}`;',
+    "  const request = new Request(url, {",
+    '    method: req.method || "POST",',
+    "    headers: req.headers,",
+    "    body:",
+    '      req.method === "GET" || req.method === "HEAD"',
+    "        ? undefined",
+    '        : typeof req.body === "string"',
+    "          ? req.body",
+    "          : JSON.stringify(req.body ?? {}),",
+    "  });",
+    "",
+    "  const response = await appRouteHandler(request);",
+    "  res.status(response.status);",
+    "  response.headers.forEach((value, key) => {",
+    "    res.setHeader(key, value);",
+    "  });",
+    "  const body = await response.arrayBuffer();",
+    "  res.send(Buffer.from(body));",
+    "}",
+    ""
+  ].join("\n");
+}
+function createPagesCheckoutContent(isTypeScript) {
+  if (isTypeScript) {
+    return [
+      '"use client";',
+      "",
+      'import { useRouter } from "next/router";',
+      'import { Checkout } from "@moneydevkit/nextjs";',
+      "",
+      "export default function CheckoutPage() {",
+      "  const router = useRouter();",
+      "  const id = Array.isArray(router.query.id)",
+      "    ? router.query.id[0]",
+      "    : router.query.id;",
+      "",
+      "  if (!id) {",
+      "    return null;",
+      "  }",
+      "",
+      "  return <Checkout id={id as string} />;",
+      "}",
+      ""
+    ].join("\n");
+  }
+  return [
+    '"use client";',
+    "",
+    'import { useRouter } from "next/router";',
+    'import { Checkout } from "@moneydevkit/nextjs";',
+    "",
+    "export default function CheckoutPage() {",
+    "  const router = useRouter();",
+    "  const id = Array.isArray(router.query.id)",
+    "    ? router.query.id[0]",
+    "    : router.query.id;",
+    "",
+    "  if (!id) {",
+    "    return null;",
+    "  }",
+    "",
+    "  return <Checkout id={id} />;",
+    "}",
+    ""
+  ].join("\n");
+}
+function isTypeScriptConfig(configPath) {
+  return configPath.endsWith(".ts") || configPath.endsWith(".mts");
+}
+function patchNextConfigTypes(source) {
+  let patched = source.replace(
+    /import\s+type\s+\{\s*NextConfig\s*\}\s+from\s+["']next["'];?\s*\n?/g,
+    ""
+  );
+  patched = patched.replace(/:\s*NextConfig\b/g, ": NextConfigOverrides");
+  return patched;
+}
+function updateConfigFile(configPath) {
+  const isTs = isTypeScriptConfig(configPath);
+  const pluginImport = isTs ? 'import withMdkCheckout, { type NextConfigOverrides } from "@moneydevkit/nextjs/next-plugin";' : 'import withMdkCheckout from "@moneydevkit/nextjs/next-plugin";';
+  if (!fs4.existsSync(configPath)) {
+    const content = [
+      pluginImport,
+      "",
+      "// Wrap your existing Next.js config with withMdkCheckout to enable Money Dev Kit.",
+      "// Example: export default withMdkCheckout(yourConfig)",
+      isTs ? "const nextConfig: NextConfigOverrides = {};" : "const nextConfig = {};",
+      "",
+      "export default withMdkCheckout(nextConfig);",
+      ""
+    ].join("\n");
+    const writeResult = writeFileWithBackup(configPath, content);
+    return {
+      status: "created",
+      path: configPath,
+      backupPath: writeResult.status === "updated-with-backup" ? writeResult.backupPath : void 0
+    };
+  }
+  const original = readFileSafe(configPath) ?? "";
+  if (original.includes("@moneydevkit/nextjs/next-plugin") || original.includes("withMdkCheckout")) {
+    return { status: "skipped", path: configPath, reason: "already configured" };
+  }
+  if (original.includes("module.exports")) {
+    const re = /module\.exports\s*=\s*(\{[\s\S]*?\});?/;
+    const match = original.match(re);
+    if (match) {
+      const prefix = 'const withMdkCheckout = require("@moneydevkit/nextjs/next-plugin").default ?? require("@moneydevkit/nextjs/next-plugin");\n';
+      const replaced = original.replace(
+        re,
+        `module.exports = withMdkCheckout(${match[1]});`
+      );
+      const result = writeFileWithBackup(configPath, `${prefix}${replaced}`);
+      return {
+        status: "updated",
+        path: configPath,
+        backupPath: result.status === "updated-with-backup" ? result.backupPath : void 0
+      };
+    }
+  }
+  if (original.includes("export default")) {
+    const reDefaultObject = /export\s+default\s+(\{[\s\S]*?\});?/;
+    const objectMatch = original.match(reDefaultObject);
+    if (objectMatch) {
+      const content = [
+        pluginImport,
+        "",
+        isTs ? "const nextConfig: NextConfigOverrides = " + objectMatch[1] + ";" : "const nextConfig = " + objectMatch[1] + ";",
+        "",
+        "export default withMdkCheckout(nextConfig);",
+        ""
+      ].join("\n");
+      const writeResult = writeFileWithBackup(configPath, content);
+      return {
+        status: "updated",
+        path: configPath,
+        backupPath: writeResult.status === "updated-with-backup" ? writeResult.backupPath : void 0
+      };
+    }
+    const reNamed = /export\s+default\s+([a-zA-Z0-9_]+)\s*;?/;
+    const namedMatch = original.match(reNamed);
+    if (namedMatch) {
+      const name = namedMatch[1];
+      const patched = isTs && original.includes("NextConfig") ? patchNextConfigTypes(original) : original;
+      const lines = [
+        pluginImport,
+        patched.replace(reNamed, `export default withMdkCheckout(${name});`)
+      ];
+      const writeResult = writeFileWithBackup(configPath, lines.join("\n"));
+      return {
+        status: "updated",
+        path: configPath,
+        backupPath: writeResult.status === "updated-with-backup" ? writeResult.backupPath : void 0
+      };
+    }
+  }
+  return {
+    status: "skipped",
+    path: configPath,
+    reason: "unrecognized format; wrap your export with withMdkCheckout, e.g. export default withMdkCheckout(yourConfig)"
+  };
+}
+function scaffoldAppRouter(appDir, isTypeScript) {
+  const added = [];
+  const skipped = [];
+  const routePath = path5.join(
+    appDir,
+    "api",
+    "mdk",
+    `route.${isTypeScript ? "ts" : "js"}`
+  );
+  const routeResult = writeFileIfAbsent(
+    routePath,
+    createAppRouteContent(isTypeScript)
+  );
+  if (routeResult.status === "created") {
+    added.push(routeResult.path);
+  } else {
+    skipped.push(routeResult.path);
+  }
+  const pagePath = path5.join(
+    appDir,
+    "checkout",
+    "[id]",
+    `page.${isTypeScript ? "tsx" : "js"}`
+  );
+  const pageResult = writeFileIfAbsent(
+    pagePath,
+    createAppCheckoutPageContent(isTypeScript)
+  );
+  if (pageResult.status === "created") {
+    added.push(pageResult.path);
+  } else {
+    skipped.push(pageResult.path);
+  }
+  return { added, skipped };
+}
+function scaffoldPagesRouter(pagesDir, isTypeScript) {
+  const added = [];
+  const skipped = [];
+  const apiPath = path5.join(
+    pagesDir,
+    "api",
+    `mdk.${isTypeScript ? "ts" : "js"}`
+  );
+  const apiResult = writeFileIfAbsent(
+    apiPath,
+    createPagesApiRouteContent(isTypeScript)
+  );
+  if (apiResult.status === "created") {
+    added.push(apiResult.path);
+  } else {
+    skipped.push(apiResult.path);
+  }
+  const checkoutPath = path5.join(
+    pagesDir,
+    "checkout",
+    `[id].${isTypeScript ? "tsx" : "js"}`
+  );
+  const checkoutResult = writeFileIfAbsent(
+    checkoutPath,
+    createPagesCheckoutContent(isTypeScript)
+  );
+  if (checkoutResult.status === "created") {
+    added.push(checkoutResult.path);
+  } else {
+    skipped.push(checkoutResult.path);
+  }
+  return { added, skipped };
+}
+async function scaffoldNextJs(options) {
+  const { detection, jsonMode, skipInstall } = options;
+  if (!detection.rootDir) {
+    throw new Error("Next.js project root not found for scaffolding.");
+  }
+  const warnings = [];
+  const rootDir = detection.rootDir;
+  const packageManager = detectPackageManager(rootDir);
+  const installResult = skipInstall ? { installed: false, skipped: true } : await installNextjsPackage(rootDir, packageManager);
+  const configPath = findExistingConfig(rootDir, detection.nextConfigPath) ?? path5.join(rootDir, "next.config.js");
+  const configResult = updateConfigFile(configPath);
+  if (configResult.status === "skipped") {
+    warnings.push(
+      `Could not automatically update ${path5.basename(configPath)} (${configResult.reason}). Please wrap your Next.js config with withMdkCheckout manually.`
+    );
+  }
+  let fileResults;
+  if (detection.appDir) {
+    fileResults = scaffoldAppRouter(detection.appDir, detection.usesTypeScript);
+  } else if (detection.pagesDir) {
+    fileResults = scaffoldPagesRouter(
+      detection.pagesDir,
+      detection.usesTypeScript
+    );
+  } else {
+    fileResults = scaffoldAppRouter(
+      path5.join(rootDir, "app"),
+      detection.usesTypeScript
+    );
+    warnings.push(
+      "No app/ or pages/ directory detected; created App Router scaffolding in app/."
+    );
+  }
+  if (!jsonMode) {
+    if (!installResult.installed && installResult.skipped) {
+      console.log("@moneydevkit/nextjs already present; skipping install.");
+    }
+  }
+  return {
+    rootDir,
+    packageManager,
+    installedPackage: installResult.installed,
+    installSkipped: installResult.skipped,
+    addedFiles: fileResults.added,
+    skippedFiles: fileResults.skipped,
+    config: configResult,
+    warnings
+  };
+}
+
 // src/index.ts
 var DEFAULT_BASE_URL = "https://moneydevkit.com";
 var DEFAULT_ENV_FILE = ".env.local";
@@ -86,7 +636,7 @@ var CookieJar = class {
 };
 function parseFlags(argv) {
   const result = minimist(argv, {
-    boolean: ["json", "no-clipboard", "no-open", "force-new-webhook", "yes"],
+    boolean: ["json", "no-clipboard", "no-open", "force-new-webhook", "scaffold-nextjs"],
     string: [
       "base-url",
       "env-target",
@@ -102,14 +652,14 @@ function parseFlags(argv) {
       "no-open": false,
       json: false,
       "force-new-webhook": false,
-      yes: false
+      "scaffold-nextjs": false
     }
   });
   return {
     json: Boolean(result.json),
     noClipboard: Boolean(result["no-clipboard"]),
     noOpen: Boolean(result["no-open"]),
-    yes: Boolean(result.yes),
+    scaffoldNextjs: Boolean(result["scaffold-nextjs"]),
     baseUrl: result["base-url"],
     envFile: result["env-target"],
     projectName: typeof result["project-name"] === "string" ? result["project-name"] : void 0,
@@ -119,20 +669,20 @@ function parseFlags(argv) {
   };
 }
 function normalizeDirectory(dir) {
-  if (path2.isAbsolute(dir)) return dir;
-  return path2.resolve(process.cwd(), dir);
+  if (path6.isAbsolute(dir)) return dir;
+  return path6.resolve(process.cwd(), dir);
 }
 function ensureDirectoryExists(dir) {
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
+  if (!fs5.existsSync(dir)) {
+    fs5.mkdirSync(dir, { recursive: true });
   }
 }
 function readEnvFile(filePath) {
   const env = /* @__PURE__ */ new Map();
-  if (!fs.existsSync(filePath)) {
+  if (!fs5.existsSync(filePath)) {
     return env;
   }
-  const contents = fs.readFileSync(filePath, "utf8");
+  const contents = fs5.readFileSync(filePath, "utf8");
   for (const line of contents.split(/\r?\n/)) {
     if (!line || line.startsWith("#")) continue;
     const [key, ...rest] = line.split("=");
@@ -153,15 +703,24 @@ function writeEnvFile(filePath, existing, updates) {
     existing.set(key, value);
   }
   const content = Array.from(existing.entries()).sort(([a], [b]) => a.localeCompare(b)).map(([key, value]) => `${key}=${value}`).join(os.EOL) + os.EOL;
-  fs.writeFileSync(filePath, content, "utf8");
+  fs5.writeFileSync(filePath, content, "utf8");
 }
 function ensureEnvFileExists(filePath) {
-  const dir = path2.dirname(filePath);
+  const dir = path6.dirname(filePath);
   ensureDirectoryExists(dir);
-  if (!fs.existsSync(filePath)) {
-    fs.writeFileSync(filePath, "", "utf8");
+  if (!fs5.existsSync(filePath)) {
+    fs5.writeFileSync(filePath, "", "utf8");
   }
 }
+function resolveLocalEnvPath(options) {
+  const organization = options.organizationId?.trim();
+  const apiKey = options.apiKeyId?.trim();
+  if (!organization || !apiKey) {
+    return void 0;
+  }
+  const homeDir = os.homedir();
+  return path6.join(homeDir, ".mdk", organization, apiKey, ".env");
+}
 function isValidHttpUrl(value) {
   if (!value) return false;
   try {
@@ -353,7 +912,7 @@ async function main() {
     }
     envFile = envPrompt.trim() || DEFAULT_ENV_FILE;
   }
-  const envPath = path2.join(projectDir, envFile);
+  const envPath = path6.join(projectDir, envFile);
   const existingEnvValues = readEnvFile(envPath);
   const mnemonicAlreadySet = existingEnvValues.get("MDK_MNEMONIC")?.trim();
   if (mnemonicAlreadySet) {
@@ -404,6 +963,39 @@ async function main() {
     projectName = namePrompt.trim() || void 0;
   }
   projectName = deriveProjectName(projectName, webhookUrl);
+  const nextJsDetection = detectNextJsProject(projectDir);
+  let shouldScaffoldNextJs = false;
+  if (flags.scaffoldNextjs) {
+    if (nextJsDetection.found) {
+      if (nextJsDetection.versionIsSupported) {
+        shouldScaffoldNextJs = true;
+      } else {
+        console.warn(
+          `Next.js version ${nextJsDetection.nextVersion ?? "unknown"} detected, but @moneydevkit/nextjs requires Next.js 15+. Skipping installation and scaffolding.`
+        );
+      }
+    } else {
+      console.warn(
+        "No NextJS app found, skipping @moneydevkit/nextjs installation. Please install manually."
+      );
+    }
+  } else if (!jsonMode && nextJsDetection.found) {
+    if (!nextJsDetection.versionIsSupported) {
+      console.warn(
+        `Next.js version ${nextJsDetection.nextVersion ?? "unknown"} detected, but @moneydevkit/nextjs requires Next.js 15+. Skipping scaffolding prompt.`
+      );
+    } else {
+      const scaffoldPrompt = await p.confirm({
+        message: `Next.js application detected at ${nextJsDetection.rootDir ?? projectDir} (version ${nextJsDetection.nextVersion ?? "unknown"}). Install and scaffold @moneydevkit/nextjs?`,
+        initialValue: true
+      });
+      if (p.isCancel(scaffoldPrompt)) {
+        p.cancel("Aborted.");
+        process.exit(1);
+      }
+      shouldScaffoldNextJs = Boolean(scaffoldPrompt);
+    }
+  }
   try {
     const result = await runDeviceFlow({
       flags,
@@ -421,6 +1013,15 @@ async function main() {
     const existingEnv = readEnvFile(envPath);
     const preview = renderEnvPreview(existingEnv, updates);
     writeEnvFile(envPath, existingEnv, updates);
+    const localEnvPath = resolveLocalEnvPath({
+      organizationId: result.credentials.organizationId,
+      apiKeyId: result.credentials.apiKeyId
+    });
+    if (localEnvPath) {
+      ensureEnvFileExists(localEnvPath);
+      const localEnv = readEnvFile(localEnvPath);
+      writeEnvFile(localEnvPath, localEnv, updates);
+    }
     if (!jsonMode) {
       p.note(preview, "Env file updated");
     }
@@ -431,6 +1032,72 @@ async function main() {
         )
       );
     }
+    let scaffoldSummary = null;
+    if (shouldScaffoldNextJs && nextJsDetection.found) {
+      try {
+        scaffoldSummary = await scaffoldNextJs({
+          detection: nextJsDetection,
+          jsonMode
+        });
+        if (!jsonMode && scaffoldSummary) {
+          const lines = [
+            scaffoldSummary.installedPackage ? `Installed @moneydevkit/nextjs with ${scaffoldSummary.packageManager}.` : scaffoldSummary.installSkipped ? "@moneydevkit/nextjs already installed; skipped package install." : "Skipped @moneydevkit/nextjs installation."
+          ];
+          if (scaffoldSummary.config) {
+            const cfg = scaffoldSummary.config;
+            if (cfg.status === "created") {
+              lines.push(`Created ${cfg.path} with withMdkCheckout().`);
+              if (cfg.backupPath) {
+                lines.push(`Created backup at ${cfg.backupPath}.`);
+              }
+            } else if (cfg.status === "updated") {
+              lines.push(`Updated ${cfg.path} with withMdkCheckout().`);
+              if (cfg.backupPath) {
+                lines.push(`Created backup at ${cfg.backupPath}.`);
+              }
+            } else {
+              lines.push(
+                `Could not update ${cfg.path} automatically (${cfg.reason ?? "unknown reason"}).`
+              );
+            }
+          }
+          if (scaffoldSummary.addedFiles.length > 0) {
+            lines.push(
+              `Added: ${scaffoldSummary.addedFiles.map((p2) => path6.relative(projectDir, p2)).join(", ")}`
+            );
+          }
+          if (scaffoldSummary.skippedFiles.length > 0) {
+            lines.push(
+              `Skipped existing files: ${scaffoldSummary.skippedFiles.map((p2) => path6.relative(projectDir, p2)).join(", ")}`
+            );
+          }
+          p.note(lines.join("\n"), "Next.js scaffolding");
+        }
+        if (scaffoldSummary?.warnings.length) {
+          for (const warning of scaffoldSummary.warnings) {
+            console.warn(warning);
+          }
+        }
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (jsonMode) {
+          console.error(
+            JSON.stringify(
+              {
+                status: "error",
+                error: {
+                  message: `Next.js scaffolding failed: ${message}`
+                }
+              },
+              null,
+              2
+            )
+          );
+        } else {
+          console.warn(`Next.js scaffolding failed: ${message}`);
+        }
+      }
+    }
     const summary = {
       projectDir,
       envFile: envPath,
@@ -438,7 +1105,8 @@ async function main() {
       webhookId: result.credentials.webhookId,
       organizationId: result.credentials.organizationId,
       webhookUrl: result.credentials.webhookUrl,
-      mnemonic: updates.MDK_MNEMONIC
+      mnemonic: updates.MDK_MNEMONIC,
+      scaffoldedNextjs: Boolean(scaffoldSummary)
     };
     if (jsonMode) {
       console.log(
@@ -453,7 +1121,8 @@ async function main() {
               webhookSecret: result.credentials.webhookSecret,
               webhookUrl: result.credentials.webhookUrl,
               organizationId: result.credentials.organizationId,
-              mnemonic: updates.MDK_MNEMONIC
+              mnemonic: updates.MDK_MNEMONIC,
+              scaffoldedNextjs: Boolean(scaffoldSummary)
             }
           },
           null,