@xano/sdk 1.0.6 → 1.0.7

package/dist/{chunk-ATJ2W7DC.js → chunk-SGK3PTTM.js}

@@ -3,29 +3,30 @@ import {
 } from "./chunk-LBJA7IEM.js";
 import {
   questionOrCancel
-} from "./chunk-JXVJGF3Y.js";
+} from "./chunk-7M6JP3FS.js";
 import {
   ensureWorkspaceEnvGitignored
-} from "./chunk-UD2Z7K6W.js";
+} from "./chunk-BZ6WTG3E.js";
 import {
   readVersion
-} from "./chunk-XFBGXB7X.js";
+} from "./chunk-DG3APBUJ.js";
 import {
   WORKSPACE_ENV_EXAMPLE_FILE,
   renderWorkspaceEnvExample
-} from "./chunk-HCG7NDIL.js";
+} from "./chunk-PV25BDCH.js";
 import {
   parseSlot,
   requireBackendSlot
-} from "./chunk-VDHA5SSQ.js";
+} from "./chunk-PY722CHR.js";
 import {
+  MERGED_IN_EXISTING,
   XANO_DIR,
   changedOnDisk,
-  decideOverwrite,
+  describeClash,
+  existingProjectClashes,
   isNonEmptyDir,
-  plannedAgentsMd,
   scaffoldProject
-} from "./chunk-LL7SGTRC.js";
+} from "./chunk-DIWF7L33.js";
 import {
   inProject,
   installModules,
@@ -33,7 +34,7 @@ import {
   preflightPackages,
   rebaseLocalSpec,
   renderXanoIndexWithModules
-} from "./chunk-YYC2DZMG.js";
+} from "./chunk-D5OZRJ3T.js";
 import {
   npmViewVersion
 } from "./chunk-ZFDZKNGG.js";
@@ -42,11 +43,14 @@ import {
 } from "./chunk-FWD7AL6N.js";
 import {
   isLocalSpecifier
-} from "./chunk-QJM5XZ4K.js";
+} from "./chunk-47XT6WQL.js";
 import {
   readToolchainBlock,
   readToolchainConfig
 } from "./chunk-DXUICABI.js";
+import {
+  statusLabel
+} from "./chunk-L6HZ67P6.js";
 import {
   detectInstallRoot,
   detectPackageManager,
@@ -58,24 +62,29 @@ import {
   localPathOf,
   packageNameOf,
   readInstalledManifestState
-} from "./chunk-763M6LX3.js";
-import {
-  statusLabel
-} from "./chunk-YR2I5HGE.js";
+} from "./chunk-CNZASQPL.js";
 import {
   readEnvVar
 } from "./chunk-X2NL4KUO.js";
 import {
   DEFAULT_FRAMEWORK,
   FRAMEWORKS,
-  NODE_MIN,
   allFrontendPresets,
+  findFrontendPreset
+} from "./chunk-BRANWM4U.js";
+import {
+  BACKEND_TSCONFIG_PATH,
+  ICON_LIBRARIES,
+  NODE_MIN,
   checkJobDir,
   checkWorkflowName,
   checkWorkflowPath,
-  findFrontendPreset,
   initLanding,
+  mergeGitignore,
   renderApiTs,
+  renderBackendPackageJson,
+  renderBackendReadme,
+  renderBackendTsconfig,
   renderCheckWorkflow,
   renderCnUtil,
   renderEnvExample,
@@ -91,13 +100,14 @@ import {
   renderViteConfig,
   renderXanoExampleMd,
   renderXanoIndex,
-  resolveFrameworkFlag,
+  resolveIconsFlag,
   sdkDep
-} from "./chunk-EQFYOOO6.js";
+} from "./chunk-5GIOCDUM.js";
 import {
-  ICON_LIBRARIES,
-  resolveIconsFlag
-} from "./chunk-M6ZFSTIZ.js";
+  composeBlock,
+  gitattributesSpec,
+  upsertBlock
+} from "./chunk-LJM5CIY4.js";
 import {
   UsageError,
   blank,
@@ -120,7 +130,7 @@ import {
   unknownFlag,
   warn,
   writeJson
-} from "./chunk-D7BUMOKU.js";
+} from "./chunk-CH23ONYG.js";
 import {
   suggest
 } from "./chunk-UTI5G6OJ.js";
@@ -235,6 +245,8 @@ async function resolveThemeChoice(args) {
 }
 
 // src/emit/frontend-resolve.ts
+var NO_FRONTEND = "none";
+var FRAMEWORK_CHOICES = [...FRAMEWORKS, NO_FRONTEND];
 function defaultFrontendPreset() {
   const preset = findFrontendPreset(DEFAULT_FRAMEWORK);
   if (preset === void 0) {
@@ -242,6 +254,10 @@ function defaultFrontendPreset() {
   }
   return preset;
 }
+function isNoFrontend(token) {
+  const t = token.trim().toLowerCase();
+  return t === NO_FRONTEND || t === "no frontend";
+}
 async function promptFramework() {
   const presets = allFrontendPresets();
   const rl = createInterface({ input: process.stdin, output: process.stderr });
@@ -250,6 +266,7 @@ async function promptFramework() {
       `
 Which frontend framework?
 ` + presets.map((p, i) => `  ${i + 1}) ${p.label}${p.id === DEFAULT_FRAMEWORK ? " (default)" : ""}`).join("\n") + `
+  ${presets.length + 1}) No frontend (the backend only)
 `
     );
     const answer = await questionOrCancel(rl, `Enter a number or name, or leave blank for the default: `);
@@ -259,13 +276,24 @@ Which frontend framework?
     if (Number.isInteger(byIndex) && byIndex >= 1 && byIndex <= presets.length) {
       return presets[byIndex - 1];
     }
+    if (byIndex === presets.length + 1 || isNoFrontend(token)) return null;
     return findFrontendPreset(token) ?? defaultFrontendPreset();
   } finally {
     rl.close();
   }
 }
+function resolveFrameworkValue(flag) {
+  if (isNoFrontend(flag)) return null;
+  return flagValue(flag, FRAMEWORK_CHOICES, () => {
+    const preset = findFrontendPreset(flag);
+    if (preset === void 0) {
+      throw new Error(`Unknown --framework "${flag}". Valid values: ${FRAMEWORK_CHOICES.join(", ")}.`);
+    }
+    return preset;
+  });
+}
 async function resolveFrontendPreset(flag) {
-  if (flag !== void 0 && flag !== "") return flagValue(flag, FRAMEWORKS, () => resolveFrameworkFlag(flag));
+  if (flag !== void 0 && flag !== "") return resolveFrameworkValue(flag);
   if (process.stdin.isTTY && process.stderr.isTTY) return promptFramework();
   return defaultFrontendPreset();
 }
@@ -432,12 +460,78 @@ function projectShellFiles(vars, preset, parts, choice = defaultThemeChoice(), c
     ...preset.files(vars, parts.landing, choice)
   ]);
 }
+function backendShellFiles(vars, shell, contributions = {}, existingXanoSdk) {
+  const backend = [
+    { path: BACKEND_TSCONFIG_PATH, content: renderBackendTsconfig() },
+    { path: "xano/lambdas/tsconfig.json", content: renderLambdaTsconfig("backend") }
+  ];
+  const manifest = {
+    path: "package.json",
+    content: withXanoSdkBlock(
+      renderBackendPackageJson(vars),
+      contributions.xanosdk,
+      shell.kind === "existing" ? void 0 : existingXanoSdk
+    )
+  };
+  if (shell.kind === "existing") {
+    return spelledForProject(vars, [
+      manifest,
+      ...backend,
+      ...moduleTypeMarker(shell.dir),
+      // The line-ending rule, scoped to `xano/`: a `*` rule at the project's
+      // root would renormalize every file the project already has.
+      { path: `${XANO_DIR}/.gitattributes`, content: renderGitattributes() },
+      ...moduleGitattributes(shell.dir, contributions.gitattributes ?? []),
+      ...gitignoreBlock(shell.dir, vars.sdkVersion)
+    ]);
+  }
+  return spelledForProject(vars, [
+    manifest,
+    ...backend,
+    { path: ".gitignore", content: renderGitignore() },
+    { path: ".gitattributes", content: renderGitattributes(contributions.gitattributes) },
+    { path: checkWorkflowPath(vars.install), content: renderCheckWorkflow(vars.install) },
+    { path: "README.md", content: shell.readme }
+  ]);
+}
+function moduleTypeMarker(dir) {
+  let manifest;
+  try {
+    manifest = JSON.parse(readFileSync2(join(dir, "package.json"), "utf8"));
+  } catch {
+    return [];
+  }
+  if (manifest?.type === "module") return [];
+  return [{ path: `${XANO_DIR}/package.json`, content: `${JSON.stringify({ type: "module" }, null, 2)}
+` }];
+}
+function gitignoreBlock(dir, version) {
+  const path = join(dir, ".gitignore");
+  const existing = existsSync(path) ? readFileSync2(path, "utf8") : null;
+  const merged = mergeGitignore(existing, version);
+  return merged === existing ? [] : [{ path: ".gitignore", content: merged }];
+}
+function moduleGitattributes(dir, contributions) {
+  if (contributions.length === 0) return [];
+  const path = join(dir, ".gitattributes");
+  let text = existsSync(path) ? readFileSync2(path, "utf8") : "";
+  for (const { pkg, version, lines } of contributions) {
+    const spec = gitattributesSpec(pkg);
+    text = upsertBlock(text, spec, composeBlock(spec, lines, version)).text;
+  }
+  return [{ path: ".gitattributes", content: text }];
+}
 function spelledForProject(vars, files) {
   return files.map((f) => ({ ...f, content: spellProjectSdkDir(spellProjectCli(f.content, vars.cli), vars.sdkDir) }));
 }
-function buildFileSet(vars, preset, choice, contributions = {}, existingXanoSdk) {
+function buildFileSet(targetDir, vars, preset, mode, choice, contributions = {}, existingXanoSdk) {
   return [
-    ...projectShellFiles(
+    ...preset === null ? backendShellFiles(
+      vars,
+      mode === "new" ? { kind: "new", readme: renderBackendReadme(vars) } : { kind: "existing", dir: targetDir },
+      contributions,
+      existingXanoSdk
+    ) : projectShellFiles(
       vars,
       preset,
       { readme: renderReadme(vars, preset, choice), landing: initLanding(vars) },
@@ -488,14 +582,41 @@ function rejectPullOnlyFlags(args) {
     { helpFor: { command: "init" } }
   );
 }
-function decideScaffoldTarget(targetDir, force) {
-  const decided = decideOverwrite(targetDir, { force, regenerable: false });
-  if (decided === "refuse") {
-    throw new UsageError(
-      `Target directory ${targetDir} is not empty. ` + (process.stdin.isTTY === true ? `Re-run with --force to scaffold into it anyway.` : `Re-run with --force --yes to scaffold into it anyway (--yes confirms the overwrite, which cannot be asked without a terminal).`)
-    );
+function frontendOnlyFlags(args) {
+  return [
+    ...args.theme !== void 0 ? ["--theme"] : [],
+    ...args.radius !== void 0 ? ["--radius"] : [],
+    ...args.dark !== void 0 ? ["--dark"] : [],
+    ...args.font !== void 0 ? ["--font"] : [],
+    ...args.fontMono !== void 0 ? ["--font-mono"] : [],
+    ...args.fontHeading !== void 0 ? ["--font-heading"] : [],
+    ...args.icons !== void 0 ? ["--icons"] : []
+  ];
+}
+function refuseFrontendOnlyFlags(args, why) {
+  const passed = frontendOnlyFlags(args);
+  if (passed.length === 0) return;
+  const one = passed.length === 1;
+  throw new UsageError(
+    `${passed.join(", ")} ${one ? "applies" : "apply"} only with a frontend, and ${why}. Drop ${one ? "it" : "them"}.`,
+    { helpFor: { command: "init" } }
+  );
+}
+async function resolveInitFrontend(args, targetDir, mode) {
+  if (mode === "existing") {
+    if (args.framework !== void 0 && resolveFrameworkValue(args.framework) !== null) {
+      throw new UsageError(
+        `\`--framework ${args.framework}\` writes a new frontend, and ${targetDir} is not empty: an existing app gets the backend only. Drop --framework to add the backend to it, or run init in an empty directory for a full app.`,
+        { helpFor: { command: "init" } }
+      );
+    }
+    refuseFrontendOnlyFlags(args, `${targetDir} is an existing project, which gets the backend only`);
+    return null;
   }
-  return decided;
+  if (args.framework === void 0) return void 0;
+  const preset = resolveFrameworkValue(args.framework);
+  if (preset === null) refuseFrontendOnlyFlags(args, `\`--framework ${NO_FRONTEND}\` writes none`);
+  return preset;
 }
 function readLockEntryCount(targetDir) {
   const path = join(targetDir, LOCK_REL);
@@ -507,32 +628,43 @@ function readLockEntryCount(targetDir) {
     return 0;
   }
 }
-async function confirmForcedOverwrite(targetDir, files, args, agents) {
-  const agentsMd = plannedAgentsMd(targetDir, {
-    agentsMd: !args.noAgentsMd,
-    appName: agents.appName,
-    regenerable: false,
-    sdkVersion: readVersion(),
-    frontend: agents.frontend,
-    theme: agents.theme
-  });
-  const changed = changedOnDisk(targetDir, agentsMd === void 0 ? files : [...files, agentsMd]);
-  if (changed.length === 0) return true;
-  warn(
-    `init --force overwrites ${changed.length} file${changed.length === 1 ? "" : "s"} already in ${targetDir}:`,
-    "init.overwrite",
-    [...changed.slice(0, 30), ...changed.length > 30 ? [`\u2026 and ${changed.length - 30} more`] : []]
-  );
-  if (args.yes === true) return true;
-  const { confirm } = await import("./prompt-U37K5RPQ.js");
-  const { yesRerun } = await import("./retry-command-QJ57WVW7.js");
+async function settleClashes(targetDir, files, args) {
+  const clashes = existingProjectClashes(targetDir, files);
+  if (clashes.length === 0) return [];
+  const one = clashes.length === 1;
+  if (!args.force) {
+    throw new UsageError(
+      `init adds the backend to ${targetDir}, and ${one ? "this clashes" : `these ${clashes.length} clash`} with what is already there:
+${clashes.map((c) => `  ${describeClash(c)}`).join("\n")}
+Nothing was written. ` + (process.stdin.isTTY === true ? `Re-run with --force to write over ${one ? "it" : "them"}.` : `Re-run with --force --yes to write over ${one ? "it" : "them"} (--yes confirms the overwrite, which cannot be asked without a terminal).`)
+    );
+  }
+  const scripts = clashes.flatMap((c) => c.kind === "script" ? [c.name] : []);
+  const changed = changedOnDisk(targetDir, files.filter((f) => !MERGED_IN_EXISTING.has(f.path)));
+  const listed = [...changed, ...clashes.filter((c) => c.kind === "script").map(describeClash)];
+  if (listed.length === 0) return scripts;
+  const counted = [
+    ...changed.length === 0 ? [] : [`${changed.length} file${changed.length === 1 ? "" : "s"}`],
+    ...scripts.length === 0 ? [] : [`${scripts.length} script${scripts.length === 1 ? "" : "s"}`]
+  ].join(" and ");
+  warn(`init --force overwrites ${counted} already in ${targetDir}:`, "init.overwrite", [
+    ...listed.slice(0, 30),
+    ...listed.length > 30 ? [`\u2026 and ${listed.length - 30} more`] : []
+  ]);
+  if (args.yes === true) return scripts;
+  const { confirm } = await import("./prompt-MQPGU4ZI.js");
+  const { yesRerun } = await import("./retry-command-GL5HCMVB.js");
   const { rerun, note } = yesRerun(args, "init");
+  const noun = scripts.length === 0 ? "file" : changed.length === 0 ? "script" : "file and script";
   const ok = await confirm(
-    `Overwrite ${changed.length === 1 ? "this file" : `these ${changed.length} files`} in ${targetDir}?`,
-    { flag: "--yes", refusal: { details: { written: false, files: changed }, rerun, note } }
+    `Overwrite ${listed.length === 1 ? `this ${noun}` : `these ${listed.length} ${noun === "file and script" ? "files and scripts" : `${noun}s`}`} in ${targetDir}?`,
+    { flag: "--yes", refusal: { details: { written: false, files: listed }, rerun, note } }
   );
-  if (!ok) info("Cancelled. Nothing was written.");
-  return ok;
+  if (!ok) {
+    info("Cancelled. Nothing was written.");
+    return "cancelled";
+  }
+  return scripts;
 }
 function renderMinimalPackageJson(appName, sdkVersion) {
   return `${JSON.stringify(
@@ -596,7 +728,7 @@ async function runInitCommand(args) {
     }
     const source = resolveFromSource(args.from);
     if (source.kind === "file") await refuseUnknownProfileFlag(args, resolve(args.positionals[0] ?? "."));
-    const { runInitFromCommand } = await import("./codegen-command-R5IASBFC.js");
+    const { runInitFromCommand } = await import("./codegen-command-T7TC7PQO.js");
     return runInitFromCommand(args, source);
   }
   rejectPullOnlyFlags(args);
@@ -604,10 +736,11 @@ async function runInitCommand(args) {
   const targetDir = resolve(targetArg);
   await refuseUnknownProfileFlag(args, targetDir);
   const appName = sanitizeAppName(args.name ?? basename(targetDir));
+  const mode = isNonEmptyDir(targetDir) ? "existing" : "new";
   const existingXanoSdk = readToolchainBlock(targetDir);
   const typedModules = parseMarketplaceFlag(args.marketplace);
-  if (args.framework !== void 0) await resolveFrontendPreset(args.framework);
-  await resolveThemeChoice(args);
+  const flagFrontend = await resolveInitFrontend(args, targetDir, mode);
+  if (flagFrontend !== null) await resolveThemeChoice(args);
   const unclaimable = args.unknownFlags.filter((f) => {
     const name = flagName(f);
     if (!name.startsWith("--")) return true;
@@ -615,10 +748,10 @@ async function runInitCommand(args) {
     return flagNames().includes(bare) || bare.startsWith("no-") && flagNames().includes(bare.slice(3));
   });
   if (unclaimable.length > 0) throw unknownFlag(unclaimable, { command: "init" });
-  const { refusePlugAndPlay } = await import("./project-dependency-GZWWGWEW.js");
-  const { retryCommand } = await import("./retry-command-QJ57WVW7.js");
+  const { refusePlugAndPlay } = await import("./project-dependency-OQ5575QQ.js");
+  const { retryCommand } = await import("./retry-command-GL5HCMVB.js");
   refusePlugAndPlay(targetDir, retryCommand(args, { command: "init" }).command);
-  const { resolveMarketplaceSpecs, withCatalogueRerun } = await import("./marketplace-resolve-OTZYT4FG.js");
+  const { resolveMarketplaceSpecs, withCatalogueRerun } = await import("./marketplace-resolve-AWH3RG57.js");
   const resolvedModules = typedModules.length === 0 ? [] : await resolveMarketplaceSpecs(typedModules, "xanosdk init --marketplace").catch(async (err) => {
     throw await withCatalogueRerun(err, args, "init");
   });
@@ -627,50 +760,45 @@ async function runInitCommand(args) {
   if (requestedModules.length > 0) preflightPackages(requestedModules, targetDir);
   const deferredModules = args.noInstall ? requestedModules : [];
   const modules = args.noInstall ? [] : requestedModules;
-  let overwrite;
   let moduleOutcome;
-  const forcedOver = args.force && isNonEmptyDir(targetDir);
   const hadLock = readLockEntryCount(targetDir);
-  let earlyPreset;
+  let overrideScripts;
+  const settle = async () => mode === "existing" ? settleClashes(
+    targetDir,
+    buildFileSet(targetDir, { appName, sdkVersion: readVersion() }, null, mode, defaultThemeChoice(), {}, existingXanoSdk),
+    args
+  ) : [];
   let passOne;
   if (modules.length > 0) {
-    overwrite = decideScaffoldTarget(targetDir, args.force);
-    if (forcedOver) {
-      earlyPreset = await resolveFrontendPreset(args.framework);
-      const earlyTheme = await resolveThemeChoice(args);
-      const provisional = buildFileSet(
-        { appName, sdkVersion: readVersion() },
-        earlyPreset,
-        earlyTheme,
-        { gitattributes: [], xanosdk: {} },
-        existingXanoSdk
-      );
-      const agents = { appName, frontend: earlyPreset, theme: earlyTheme };
-      if (!await confirmForcedOverwrite(targetDir, provisional, args, agents)) return;
-    }
+    const settled = await settle();
+    if (settled === "cancelled") return;
+    overrideScripts = settled;
     passOne = snapshotForRollback(targetDir);
     mkdirSync(targetDir, { recursive: true });
-    writeFileSync(
-      join(targetDir, "package.json"),
-      renderMinimalPackageJson(appName, readVersion()),
-      "utf8"
-    );
+    if (mode === "new" || !existsSync(join(targetDir, "package.json"))) {
+      writeFileSync(
+        join(targetDir, "package.json"),
+        renderMinimalPackageJson(appName, readVersion()),
+        "utf8"
+      );
+    }
     blank();
     moduleOutcome = await installModules(targetDir, modules);
     if (moduleOutcome.toolchain.length > 0) {
-      const { addToolchainPeers } = await import("./toolchain-peers-CIDNEEQV.js");
+      const { addToolchainPeers } = await import("./toolchain-peers-KQ7TQ2AR.js");
       const rerun = retryCommand(args, { command: "init" }).command;
       for (const pkg of moduleOutcome.toolchain) await addToolchainPeers(targetDir, pkg, rerun);
     }
   }
   let scaffolded = false;
   try {
-    const { discoverToolchainPlugins } = await import("./toolchain-modules-VU7SURVJ.js");
+    const { discoverToolchainPlugins } = await import("./toolchain-modules-OTNSKK52.js");
     const toolchain = await discoverToolchainPlugins(targetDir, { frozen: false, configuring: true });
-    const preset = earlyPreset ?? await resolveFrontendPreset(args.framework);
+    const preset = flagFrontend !== void 0 ? flagFrontend : await resolveFrontendPreset(args.framework);
+    if (preset === null && flagFrontend === void 0) refuseFrontendOnlyFlags(args, "no frontend was chosen");
     const choice = await resolveThemeChoice(args);
-    const { pluginPrompter } = await import("./plugin-prompt-ZUYQQIX4.js");
-    const { contributionOutcomes, recordedConfig, runPluginQuestionnaire } = await import("./plugin-contributions-WR26U7NT.js");
+    const { pluginPrompter } = await import("./plugin-prompt-IODX5EU6.js");
+    const { contributionOutcomes, recordedConfig, runPluginQuestionnaire } = await import("./plugin-contributions-E6XHLQWK.js");
     const { answers: pluginAnswers } = await runPluginQuestionnaire(toolchain.loaded, {
       host: "init",
       unknownFlags: args.unknownFlags,
@@ -689,12 +817,14 @@ async function runInitCommand(args) {
       if (record !== void 0) pluginConfig[outcome.pkg] = record;
     }
     const vars = templateVarsFor(appName, targetDir);
-    overwrite ??= decideScaffoldTarget(targetDir, args.force);
-    const fileSet = buildFileSet(vars, preset, choice, { gitattributes, xanosdk: pluginConfig }, existingXanoSdk);
-    if (forcedOver && earlyPreset === void 0 && !await confirmForcedOverwrite(targetDir, fileSet, args, { appName, frontend: preset, theme: choice }))
-      return;
+    if (overrideScripts === void 0) {
+      const settled = await settle();
+      if (settled === "cancelled") return;
+      overrideScripts = settled;
+    }
+    const fileSet = buildFileSet(targetDir, vars, preset, mode, choice, { gitattributes, xanosdk: pluginConfig }, existingXanoSdk);
     step(
-      `Scaffolding ${style.bold(appName)} (${preset.label}, ${choice.theme.label}) in ${targetDir}`
+      mode === "existing" ? `Adding a Xano backend to ${style.bold(appName)} in ${targetDir}` : preset === null ? `Scaffolding ${style.bold(appName)} (no frontend) in ${targetDir}` : `Scaffolding ${style.bold(appName)} (${preset.label}, ${choice.theme.label}) in ${targetDir}`
     );
     const pin = await planProfilePin(args, targetDir);
     scaffolded = true;
@@ -708,9 +838,14 @@ async function runInitCommand(args) {
       // An `init` project's `xano/` is hand-authored, never machine-written: it is
       // not refreshable, and `--force` must not clear it.
       regenerable: false,
-      overwrite,
-      // Only this path writes package.json twice, so only this path merges.
-      mergePackageJson: modules.length > 0,
+      // A new project's directory is empty, and an existing one's clashes were
+      // settled above: nothing here is refused.
+      overwrite: "full",
+      // An existing project's manifest is the user's, merged into with the
+      // project winning. Otherwise only the module path writes package.json
+      // twice, so only that path merges.
+      mergePackageJson: mode === "existing" ? "project" : modules.length > 0 ? "rendered" : void 0,
+      overrideScripts,
       // A project install failing for the reason an add-on's already did (the
       // manifest they share names a range npm has no version for) is that one
       // failure, already warned — not a second warning repeating npm's text.
@@ -728,7 +863,7 @@ async function runInitCommand(args) {
     reportWorkflowPlacement(result.written, vars.install, targetDir);
     pin.report();
     const pinnedProfile = pin.name;
-    info(`Theme: ${choice.theme.label} \u2014 dark mode: ${choice.dark}`);
+    if (preset !== null) info(`Theme: ${choice.theme.label} \u2014 dark mode: ${choice.dark}`);
     if (deferredModules.length > 0) {
       recordDeferredModules(targetDir, deferredModules);
       info(`Added to package.json, not installed (--no-install): ${deferredModules.join(", ")}.`);
@@ -789,10 +924,10 @@ async function runInitCommand(args) {
       }
     }
     if (result.install === "installed") {
-      const { skewedProjectSdk } = await import("./project-sdk-3W72H5QO.js");
+      const { skewedProjectSdk } = await import("./project-sdk-2ESHHZVL.js");
       const installedSdk = skewedProjectSdk(targetDir, readVersion());
       if (installedSdk !== void 0) {
-        const { reconcileWithInstalled } = await import("./upgrade-command-C5KBITFI.js");
+        const { reconcileWithInstalled } = await import("./upgrade-command-BXMSQN4C.js");
         const rendered = reconcileWithInstalled(targetDir);
         if (rendered.length > 0) {
           info(`Rendered ${rendered.join(", ")} with the installed @xano/sdk ${installedSdk.version} (this CLI is ${readVersion()}).`);
@@ -824,17 +959,18 @@ async function runInitCommand(args) {
     }
     const cdHint = targetDir === process.cwd() ? "" : `  cd ${shellWord(targetArg)}
 `;
+    const needsInstall = !(result.install === "installed" || sdkResolves(targetDir));
     detail(
       `Next steps:
-` + cdHint + (result.install === "installed" || sdkResolves(targetDir) ? `` : `  ${installLine}
-`) + // A declared name with no line in xano/.env refuses the deploy, so the
+` + cdHint + (needsInstall ? `  ${installLine}
+` : ``) + // A declared name with no line in xano/.env refuses the deploy, so the
       // step that supplies it comes first.
       (addonEnv.length > 0 ? `  cp xano/.env.example xano/.env   # then set ${addonEnv.join(", ")} \u2014 the add-ons read ${addonEnv.length === 1 ? "it" : "them"}
 ` : ``) + // The Xano Engine first: it needs no account, so sign-in waits for
       // the cloud deploy that does.
       `  npm run xano:deploy    # run the backend on the Xano Engine, on this machine
-  npm run dev            # run the frontend, pointed at it
-` + loginNextStep(pin, targetDir) + `  npm run xano:deploy:ephemeral   # build the frontend, then deploy \u2192 live ephemeral URL
+` + (preset === null ? `` : `  npm run dev            # run the frontend, pointed at it
+`) + loginNextStep(pin, targetDir) + `${ephemeralNextStep(preset !== null)}
 
 ` + (hadLock !== void 0 ? `xano/xano.lock was kept (${hadLock} ${hadLock === 1 ? "entry" : "entries"}). An entry the new xano/index.ts
 does not export fails \`npm run xano:check\`; once those objects are gone for good,
@@ -848,11 +984,18 @@ ${ROUTES_REL} was written for the add-ons' endpoints \u2014 commit it too.` : ""
       writeJson({
         dir: targetDir,
         name: appName,
-        framework: preset.id,
-        theme: choice.theme.id,
-        dark: choice.dark,
+        // `new` or `existing`: whether this run wrote a project, or added the
+        // backend to one that was already there.
+        mode,
+        framework: preset?.id ?? NO_FRONTEND,
+        theme: preset === null ? null : choice.theme.id,
+        dark: preset === null ? null : choice.dark,
         install: result.install,
         pinnedProfile,
+        // Every file this run wrote or merged into, project-relative.
+        files: runFiles(result.written, derived),
+        // The one command to run next, from where `init` was typed.
+        next: deployNextCommand(cdHint === "" ? null : targetArg, needsInstall ? installLine : null, manager),
         // `--no-install` still names what it added: recorded in package.json,
         // not installed, not wired.
         ...moduleOutcome === void 0 && deferredModules.length > 0 ? {
@@ -928,14 +1071,14 @@ async function writeDerivedFiles(targetDir, renderIndexWithEnv, toolchain) {
     const { readLockFile, writeLockFile } = await import("./io-PGTCBSIQ.js");
     const { setDiagnosticSink } = await import("./diagnostics-OMN5Y2AH.js");
     const { planRouteManifest } = await import("./routes-manifest-YR4ZIMLM.js");
-    const { renderManifestFile, reportModuleFailures } = await import("./routes-manifest-file-UALYSZLY.js");
-    const { isEnabled } = await import("./toolchain-modules-VU7SURVJ.js");
+    const { renderManifestFile, reportModuleFailures } = await import("./routes-manifest-file-LCIKPDAG.js");
+    const { isEnabled } = await import("./toolchain-modules-OTNSKK52.js");
     const existing = existsSync(lockPath) ? readLockFile(lockPath) : void 0;
     resetLockOverrides();
     if (existing !== void 0) seedLockOverrides(existing);
     const ctx = createLockContext(existing);
     const { envNamesRead } = await import("./guards-KYEOCVHN.js");
-    const { refreshEnvExample } = await import("./env-example-refresh-CQP3ZMKM.js");
+    const { refreshEnvExample } = await import("./env-example-refresh-WNSOH534.js");
     const def = await loadDefault(join(targetDir, XANO_DIR, "index.ts"));
     if (!Xano.isXano(def)) return { written, env: declaredEnv };
     const previousSink = setDiagnosticSink(() => {
@@ -994,15 +1137,15 @@ async function refuseUnknownProfileFlag(args, targetDir) {
   const name = args.profile ?? (fromEnv ? envRaw : void 0);
   if (name === void 0) return;
   if (fromEnv && targetDir !== void 0) {
-    const { POINTER_FILE } = await import("./profile-pointer-PDA5XBIB.js");
+    const { POINTER_FILE } = await import("./profile-pointer-KTYXL6FU.js");
     if (existsSync(join(targetDir, POINTER_FILE))) return;
   }
-  const { readCredentialFile, resolveAuthFilePath, profileNames, loginHint } = await import("./store-X6ZH7EC3.js");
+  const { readCredentialFile, resolveAuthFilePath, profileNames, loginHint } = await import("./store-VJ3OS6VO.js");
   const path = resolveAuthFilePath(args, "read");
   const file = readCredentialFile(path);
   const stored = file === null ? [] : profileNames(file);
   if (stored.includes(name)) return;
-  const { ProfileNotFoundError } = await import("./token-7AWSJLKO.js");
+  const { ProfileNotFoundError } = await import("./token-DJJUW5HY.js");
   const have = stored.length === 0 ? "Nothing is signed in on this machine." : `Stored profiles: ${quotedNames(stored)}.`;
   throw new ProfileNotFoundError(
     `No credential profile "${name}" in ${path} (from ${fromEnv ? `$${ENV_PROFILE}` : "--profile"}), so there is nothing to pin this project to. ${have} Run ${loginHint(name)} to add it, or name a stored one${fromEnv ? ` (or unset ${ENV_PROFILE})` : ""}.`,
@@ -1011,13 +1154,22 @@ async function refuseUnknownProfileFlag(args, targetDir) {
   );
 }
 async function envCredentialSet() {
-  const { envMetaCredentialVarsSet } = await import("./token-7AWSJLKO.js");
+  const { envMetaCredentialVarsSet } = await import("./token-DJJUW5HY.js");
   return envMetaCredentialVarsSet().length > 0;
 }
 function loginNextStep(pin, projectDir) {
   return pin.signedIn ? "" : `  ${projectCli(projectDir)} login       # authenticate with Xano
 `;
 }
+function ephemeralNextStep(frontend) {
+  return frontend ? `  npm run xano:deploy:ephemeral   # build the frontend, then deploy \u2192 live ephemeral URL` : `  npm run xano:deploy:ephemeral   # deploy the backend \u2192 live ephemeral URL`;
+}
+function deployNextCommand(cdArg, install, manager) {
+  return (cdArg === null ? "" : `cd ${shellWord(cdArg)} && `) + (install === null ? "" : `${install} && `) + `${manager} run xano:deploy`;
+}
+function runFiles(...groups) {
+  return [...new Set(groups.flat())].sort();
+}
 function projectCli(projectDir) {
   const prefix = cliPrefixAt(projectDir);
   return prefix === "xanosdk" || prefix === "npx @xano/sdk" ? "npx xanosdk" : prefix;
@@ -1026,8 +1178,8 @@ function runFromHere(text, targetDir) {
   return text.replace(/`npx xanosdk /g, `\`${inProject(targetDir)}xanosdk `);
 }
 async function planProfilePin(args, targetDir, opts = {}) {
-  const { POINTER_FILE, readPointerFile } = await import("./profile-pointer-PDA5XBIB.js");
-  const { readCredentialFile, resolveAuthFilePath, profileNames, loginHint } = await import("./store-X6ZH7EC3.js");
+  const { POINTER_FILE, readPointerFile } = await import("./profile-pointer-KTYXL6FU.js");
+  const { readCredentialFile, resolveAuthFilePath, profileNames, loginHint } = await import("./store-VJ3OS6VO.js");
   const credentialPath = resolveAuthFilePath(args, "read");
   const file = readCredentialFile(credentialPath);
   const signedIn = file !== null && profileNames(file).length > 0 || await envCredentialSet();
@@ -1057,7 +1209,7 @@ async function planProfilePin(args, targetDir, opts = {}) {
     };
   }
   if (opts.credentialRead === true) {
-    const { environmentCredentialVars } = await import("./token-7AWSJLKO.js");
+    const { environmentCredentialVars } = await import("./token-DJJUW5HY.js");
     const env = environmentCredentialVars();
     if (env.complete) {
       return {
@@ -1080,7 +1232,7 @@ async function planProfilePin(args, targetDir, opts = {}) {
   });
   const stored = file === null ? [] : profileNames(file);
   if (!stored.includes(selection.name)) {
-    const env = stored.length === 0 ? (await import("./token-7AWSJLKO.js")).environmentCredentialVars() : void 0;
+    const env = stored.length === 0 ? (await import("./token-DJJUW5HY.js")).environmentCredentialVars() : void 0;
     const storeEnv = env?.complete === true ? await storeEnvCredentialCommand(credentialPath, targetDir) : "";
     return {
       name: null,
@@ -1104,7 +1256,7 @@ async function planProfilePin(args, targetDir, opts = {}) {
       };
     }
   }
-  const { writePointerFile } = await import("./profile-pointer-PDA5XBIB.js");
+  const { writePointerFile } = await import("./profile-pointer-KTYXL6FU.js");
   return {
     name: selection.name,
     signedIn,
@@ -1121,7 +1273,7 @@ async function envAddressesElsewhere(file, name, credentialPath) {
   const instance = readEnvVar("XANO_INSTANCE_URL")?.trim();
   const workspace = readEnvVar("XANO_WORKSPACE_ID")?.trim();
   if (instance === void 0 || workspace === void 0 || readEnvVar("XANO_META_TOKEN") === void 0) return null;
-  const { readProfile, sameOriginAs } = await import("./store-X6ZH7EC3.js");
+  const { readProfile, sameOriginAs } = await import("./store-VJ3OS6VO.js");
   let record;
   try {
     record = readProfile(file, name, credentialPath);
@@ -1137,7 +1289,7 @@ async function envAddressesElsewhere(file, name, credentialPath) {
   };
 }
 async function storeEnvCredentialCommand(credentialPath, targetDir) {
-  const { credentialFileFlag, profileAddCommand } = await import("./store-X6ZH7EC3.js");
+  const { credentialFileFlag, profileAddCommand } = await import("./store-VJ3OS6VO.js");
   const { DEFAULT_PROFILE } = await import("./profile-select-45G5VPJK.js");
   const instance = readEnvVar("XANO_INSTANCE_URL");
   const workspaceId = readEnvVar("XANO_WORKSPACE_ID");
@@ -1151,6 +1303,7 @@ function sdkResolves(dir) {
 
 export {
   resolveThemeChoice,
+  resolveFrameworkValue,
   resolveFrontendPreset,
   projectInstallOf,
   workflowPlacementNote,
@@ -1159,10 +1312,17 @@ export {
   templateVarsFor,
   sanitizeAppName,
   projectShellFiles,
+  backendShellFiles,
   resolveFromSource,
+  refuseFrontendOnlyFlags,
+  resolveInitFrontend,
+  settleClashes,
   runInitCommand,
   loginNextStep,
+  ephemeralNextStep,
+  deployNextCommand,
+  runFiles,
   projectCli,
   planProfilePin
 };
-//# sourceMappingURL=chunk-ATJ2W7DC.js.map
+//# sourceMappingURL=chunk-SGK3PTTM.js.map