@xano/sdk 1.0.4 → 1.0.6

package/dist/{chunk-WYEQFD6A.js → chunk-XFBGXB7X.js}

@@ -1,7 +1,7 @@
 import {
   assertOneName,
   noteRunArgs
-} from "./chunk-DIG3NITC.js";
+} from "./chunk-WBH4KJWM.js";
 import {
   WORKSPACE_ENV_FILE,
   classifyEnv,
@@ -10,37 +10,37 @@ import {
   namesInEnvExample,
   parseEnvFile,
   readWorkspaceEnvFile
-} from "./chunk-664LSWE5.js";
+} from "./chunk-HCG7NDIL.js";
 import {
   readTrackedBackend
-} from "./chunk-LIVN53UV.js";
+} from "./chunk-I3VHW6XM.js";
 import {
   isCI
-} from "./chunk-JP7M7OU7.js";
+} from "./chunk-FU3VCE5A.js";
 import {
   backendSlotForFlag,
   slotValueMissing
-} from "./chunk-UDE5C2XN.js";
+} from "./chunk-VDHA5SSQ.js";
 import {
   defaultWorkspaceSecretsPath,
   readSecretsFile
-} from "./chunk-MLGI2SRQ.js";
+} from "./chunk-PFBXSVZF.js";
 import {
   allLandings,
   getEnvironment,
   readEphemeralState
-} from "./chunk-UKUIUS3E.js";
+} from "./chunk-U6MTGB46.js";
 import {
   isUnwritableError,
   unwritableError
-} from "./chunk-3H3EPMFY.js";
+} from "./chunk-5TVFLG3C.js";
 import {
   isExpired
-} from "./chunk-BUECLQXK.js";
+} from "./chunk-SPKA2LV6.js";
 import {
   contextFlags,
   setHintContext
-} from "./chunk-SEUCZZCP.js";
+} from "./chunk-N5I37JFB.js";
 import {
   shellWord
 } from "./chunk-FWD7AL6N.js";
@@ -51,7 +51,7 @@ import {
   hostedFileResolver,
   isMissingFile,
   registerSeedHostedFiles
-} from "./chunk-37AHZ7JX.js";
+} from "./chunk-3BBIDW3Y.js";
 import {
   projectRootFrom
 } from "./chunk-ROY4YAEQ.js";
@@ -59,7 +59,7 @@ import {
   readLockFile,
   readLockFileReport,
   writeLockFile
-} from "./chunk-VD32O6KZ.js";
+} from "./chunk-CJDPSCMX.js";
 import {
   writeData
 } from "./chunk-AWQ7BQTQ.js";
@@ -70,16 +70,16 @@ import {
   inCredentialScope,
   lastResolvedAuth,
   pinnedWorkspaceMissed
-} from "./chunk-MN2PB6WB.js";
+} from "./chunk-YR2I5HGE.js";
 import {
   assertValidProfileName
-} from "./chunk-QXTKSOFI.js";
+} from "./chunk-MF4W6FHU.js";
 import {
   readEnvVar
 } from "./chunk-X2NL4KUO.js";
 import {
   bundleCapabilities
-} from "./chunk-6R7S775T.js";
+} from "./chunk-7REDHC4N.js";
 import {
   BARE,
   CliError,
@@ -134,7 +134,7 @@ import {
   warn,
   withCliPrefix,
   writeJson
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-D7BUMOKU.js";
 import {
   KNOWLEDGE_DIR,
   KNOWLEDGE_FILE,
@@ -142,15 +142,15 @@ import {
   isOsMetadataFile,
   registerAllKinds,
   serializeBundle
-} from "./chunk-II747OWE.js";
+} from "./chunk-FQ53GTII.js";
 import {
   Xano,
   checkFilterOperands,
   standaloneDefKind
-} from "./chunk-5YL5OC2G.js";
+} from "./chunk-5QMJOE2K.js";
 import {
   knowledgeBodiesAllEmpty
-} from "./chunk-EESV6NU2.js";
+} from "./chunk-7FIMUFBP.js";
 import {
   checkDecodeOnlyStatements,
   checkExpressionOperands,
@@ -174,7 +174,7 @@ import {
   checkUnboundVarRefs,
   checkZipPasswordKeys,
   isQueryExpressionFilter
-} from "./chunk-OPG4DYX2.js";
+} from "./chunk-T4LJ5UR2.js";
 import {
   FILTER_NAMES
 } from "./chunk-BEXZ4XRV.js";
@@ -195,7 +195,7 @@ import {
   DiagnosticError,
   isDiagnosticError,
   setDiagnosticSink
-} from "./chunk-GPI3OWRE.js";
+} from "./chunk-YHB34BN6.js";
 import {
   suggest
 } from "./chunk-UTI5G6OJ.js";
@@ -211,7 +211,7 @@ import {
   toolsetKindsFromPayload,
   validateLockModel,
   withoutGuidSources
-} from "./chunk-OOGXZL7Z.js";
+} from "./chunk-5KJBWIDZ.js";
 import {
   shellQuote
 } from "./chunk-5ZSO4T2G.js";
@@ -219,7 +219,7 @@ import {
   HOSTED_FILE_SCHEME,
   HOSTED_ICON_KINDS,
   uncarriedHostedIcons
-} from "./chunk-XNCP4KYO.js";
+} from "./chunk-VQPDATQT.js";
 import {
   IDENT,
   installLambdaFreeReads,
@@ -1328,7 +1328,7 @@ var NOUN_COMMANDS = /* @__PURE__ */ new Set([
   "env",
   "secrets",
   "ephemeral",
-  "local-engine",
+  "local",
   "workspace",
   "marketplace",
   "test",
@@ -1449,6 +1449,7 @@ function parseArgs(argv) {
   let staticDir;
   let to;
   let localEngine = false;
+  let ephemeral = false;
   let localEngineUrl;
   let engineVersion;
   let description;
@@ -1715,18 +1716,20 @@ function parseArgs(argv) {
       const value = arg === "--to" ? valueAfter() : arg.slice("--to=".length);
       if (value === void 0 || value === "") throw selectorValueMissing("to", "--to", command, subcommand);
       to = value;
-    } else if (arg === "--local-engine" || arg.startsWith("--local-engine=")) {
+    } else if (arg === "--ephemeral") {
+      ephemeral = true;
+    } else if (arg === "--local" || arg.startsWith("--local=")) {
       if (command === "env" && (subcommand === "set" || subcommand === "unset")) {
-        throw new UsageError("`--local-engine` here is `--to local-engine`.", {
+        throw new UsageError("`--local` here is `--to local`.", {
           helpFor: helpTargetFor(command, subcommand)
         });
       }
       localEngine = true;
-      if (arg.startsWith("--local-engine=")) {
-        const value = arg.slice("--local-engine=".length);
+      if (arg.startsWith("--local=")) {
+        const value = arg.slice("--local=".length);
         if (value === "") {
           throw new UsageError(
-            "--local-engine= expects an engine version (v0.1.5), a URL to fetch the engine from, or the path to an engine archive on this machine."
+            "--local= expects an engine version (v0.1.5), a URL to fetch the engine from, or the path to an engine archive on this machine."
           );
         }
         localEngineUrl = value;
@@ -1767,7 +1770,7 @@ function parseArgs(argv) {
       authFile = expandHome(requireValue(arg));
     } else if (arg.startsWith("--config=")) {
       authFile = expandHome(attachedValue(arg, "--config="));
-    } else if (arg === "--local") {
+    } else if (arg === "--local-auth") {
       useLocal = true;
     } else if (arg === "--paste") {
       paste = true;
@@ -2075,13 +2078,33 @@ function parseArgs(argv) {
   }
   if (localEngine) {
     refuseUnlessDeclared(
-      "local-engine",
-      "--local-engine",
-      "only `deploy` takes it, because only a deploy downloads, pins and starts an engine. " + // Command-aware: `publish` refuses `--to local-engine` too, so pointing
-      // it there sent the reader from one refusal to the next.
-      (command === "publish" ? "A local engine takes a frontend only through `xanosdk deploy --local-engine --static <dir>`; `publish` publishes to an ephemeral's, a tenant's or your workspace's static host (`--to`)." : "Elsewhere a local engine is a backend: `--to local-engine`, `--from local-engine`, or `local-engine` as the positional.")
+      "local",
+      "--local",
+      "only `deploy` takes it, because only a deploy downloads, pins and starts an engine. Elsewhere a Xano Engine is a backend: `--to local`, `--from local`, or `local` as the positional."
     );
   }
+  if (ephemeral) {
+    refuseUnlessDeclared(
+      "ephemeral",
+      "--ephemeral",
+      "only `deploy` takes it. Elsewhere an ephemeral is a backend: `--to ephemeral`, `--from ephemeral`, or `ephemeral` as the positional."
+    );
+  }
+  if (command === "deploy") {
+    if (ephemeral && localEngine) {
+      throw new UsageError(
+        "`--ephemeral` and `--local` are two destinations, and a deploy has one. Drop whichever is not meant.",
+        { helpFor: { command: "deploy" } }
+      );
+    }
+    if (ephemeral && to !== void 0) {
+      throw new UsageError(
+        "`--ephemeral` and `--to` are two destinations, and a deploy has one: `--ephemeral` replaces a disposable ephemeral, `--to` merges into a backend that already exists. Drop whichever is not meant.",
+        { helpFor: { command: "deploy" } }
+      );
+    }
+    if (!ephemeral && to === void 0) localEngine = true;
+  }
   if (guest) {
     refuseUnlessDeclared(
       "guest",
@@ -2254,6 +2277,7 @@ function parseArgs(argv) {
     staticHost,
     to,
     localEngine,
+    ephemeral,
     localEngineUrl,
     engineVersion,
     description,
@@ -2476,8 +2500,8 @@ async function tsxRemedy(file) {
         (block) => typeof pkg[block] === "object" && pkg[block] !== null && "tsx" in pkg[block]
       );
       if (!declared) return fallback;
-      const { detectPackageManager } = await import("./package-manager-PRAHUSCN.js");
-      const { inProject } = await import("./init-modules-HZRQFRLE.js");
+      const { detectPackageManager } = await import("./package-manager-K762W7XT.js");
+      const { inProject } = await import("./init-modules-NSKD4ASY.js");
       return `This project's package.json declares it, but its dependencies are not installed \u2014 run \`${inProject(dir)}${detectPackageManager(dir)} install\` first.`;
     }
     if (dirname2(dir) === dir) return fallback;
@@ -3098,7 +3122,7 @@ async function explainUnreachableWorkspace(err) {
   let verdict = unreachableVerdicts.get(auth);
   if (verdict === void 0) {
     verdict = (async () => {
-      const { readReachableWorkspaces, unreachableWorkspaceMessage } = await import("./workspace-binding-2TWZBHQY.js");
+      const { readReachableWorkspaces, unreachableWorkspaceMessage } = await import("./workspace-binding-JE6YNDZJ.js");
       const all = await readReachableWorkspaces(auth, 15e3);
       if (all === void 0 || all.length === 0 || all.some((w) => w.id === auth.workspaceId)) return void 0;
       return new UsageError(unreachableWorkspaceMessage(auth, all));
@@ -3112,7 +3136,7 @@ async function explainRejectedCredential(err) {
   if (!(err instanceof Error) || resolved === void 0) return err;
   const [first = "", ...rest] = err.message.split("\n");
   if (!/\(401\b[^)]*\)|\banswered (HTTP )?401\b/.test(first) || /\brejected\b/.test(err.message)) return err;
-  const { asRejectedCredential, rejectedRemedy } = await import("./whoami-command-KNWFWAX6.js");
+  const { asRejectedCredential, rejectedRemedy } = await import("./whoami-command-7WQII2H4.js");
   const { auth, args } = resolved;
   err.message = [first, rejectedRemedy(auth, args), ...rest].join("\n");
   if (failureCode(err) === "SDK_ERROR") asRejectedCredential(err, auth, args);
@@ -3150,10 +3174,10 @@ function withoutSecretValue(args) {
 }
 async function nameLookupRerun(failure) {
   if (!(failure instanceof Error) || runArgs?.argv === void 0) return failure;
-  const { LookupFailedError, rateLimitedFailure } = await import("./source-resolve-DMDZVPMM.js");
+  const { LookupFailedError, rateLimitedFailure } = await import("./source-resolve-MKLNYFWG.js");
   const err = rateLimitedFailure(failure);
   if (!(err instanceof LookupFailedError)) return err;
-  const { retryCommand, withheldNote } = await import("./deploy-command-5WTFHMBT.js");
+  const { retryCommand, withheldNote } = await import("./deploy-command-34T2LKQ5.js");
   if (runArgs.command === "env" && runArgs.subcommand === "set") {
     const retry2 = retryCommand(withoutSecretValue(runArgs));
     return err.withRerun(
@@ -3199,7 +3223,7 @@ var PATHLESS_VERBS = {
   ephemeral: /* @__PURE__ */ new Set(["list", "get", "delete"]),
   tenant: /* @__PURE__ */ new Set(["list", "get", "delete", "details"]),
   release: /* @__PURE__ */ new Set(["list", "show", "delete"]),
-  "local-engine": /* @__PURE__ */ new Set(["token", "stop"]),
+  "local": /* @__PURE__ */ new Set(["token", "stop"]),
   test: /* @__PURE__ */ new Set(["list", "run", "run-all"])
 };
 var PATHLESS_COMMANDS = /* @__PURE__ */ new Set(["tables", "impersonate"]);
@@ -3208,7 +3232,7 @@ function isPathlessRun(args) {
   return PATHLESS_COMMANDS.has(command) || PATHLESS_VERBS[command]?.has(args.subcommand ?? "") === true;
 }
 async function atProjectRoot(args, command, positional) {
-  const { enterProjectRoot } = await import("./xanosdk-project-6KTCO47O.js");
+  const { enterProjectRoot } = await import("./xanosdk-project-6AGMW2SL.js");
   const entered = enterProjectRoot(args, process.cwd(), positional);
   if (entered === void 0) return command(args);
   if (isPathlessRun(args)) {
@@ -3309,7 +3333,7 @@ async function dispatch(rawArgv) {
   if (typed[0] === "init") {
     const web = typed.indexOf("--web", 1);
     if (web !== -1) {
-      const { runInitWebCommand } = await import("./init-web-Y2PBNJTQ.js");
+      const { runInitWebCommand } = await import("./init-web-MKFFOQUU.js");
       return runInitWebCommand([...typed.slice(1, web), ...typed.slice(web + 1)]);
     }
   }
@@ -3327,7 +3351,7 @@ async function dispatch(rawArgv) {
       throw unknownSubcommand(helpRequest.command, helpRequest.unknownSubcommand, helpRequest.positionals ?? []);
     }
     if (argv.includes("--json")) {
-      const { helpDocument } = await import("./commands-CVFYC4GK.js");
+      const { helpDocument } = await import("./commands-H7CPMMHH.js");
       writeJson({ version: readVersion(), ...helpDocument(helpRequest) });
       return;
     }
@@ -3348,7 +3372,7 @@ async function dispatch(rawArgv) {
   setHintContext(args);
   runArgs = args;
   noteRunArgs(args);
-  if (isMachineOutput(args)) (await import("./update-check-LNNKIMML.js")).routeUpdateNoticeToDocument();
+  if (isMachineOutput(args)) (await import("./update-check-A7FXIINW.js")).routeUpdateNoticeToDocument();
   const { command } = args;
   const out = args.out === "-" ? void 0 : args.out;
   if (command === void 0) {
@@ -3369,11 +3393,11 @@ async function dispatch(rawArgv) {
     return;
   }
   if (command === "init") {
-    const { runInitCommand } = await import("./init-command-27SFBW2F.js");
+    const { runInitCommand } = await import("./init-command-HAO3WXH3.js");
     return runInitCommand(args);
   }
   if (command === "completion") {
-    const { isCompletionShell, runCompletionCommand, COMPLETION_SHELLS, UNSUPPORTED_SHELLS } = await import("./completion-AUEQC4XJ.js");
+    const { isCompletionShell, runCompletionCommand, COMPLETION_SHELLS, UNSUPPORTED_SHELLS } = await import("./completion-W5ZAI6TN.js");
     const shell = args.positionals[0];
     if (shell === void 0) throw missingArgument("shell", { command: "completion" });
     if (!isCompletionShell(shell)) {
@@ -3392,111 +3416,111 @@ async function dispatch(rawArgv) {
     return runCompletionCommand(shell);
   }
   if (command === "upgrade") {
-    const { runUpgradeCommand } = await import("./upgrade-command-7EUXML3P.js");
+    const { runUpgradeCommand } = await import("./upgrade-command-C5KBITFI.js");
     return runUpgradeCommand(args);
   }
   if (command === "lock") {
-    const { runLockCommand } = await import("./lock-commands-4VT3L5W5.js");
+    const { runLockCommand } = await import("./lock-commands-X2OECR4R.js");
     const verb = args.positionals[0];
-    const { isProjectDir } = await import("./xanosdk-project-6KTCO47O.js");
+    const { isProjectDir } = await import("./xanosdk-project-6AGMW2SL.js");
     const here = verb !== "prune" && args.lockPath === void 0 && args.entryPath === void 0 && existsSync2("xano.lock") && !isProjectDir(process.cwd()) ? { ...args, lockPath: "xano.lock" } : args;
     return atProjectRoot(here, runLockCommand, verb === "prune" || verb === "import" ? "verb-path" : void 0);
   }
   if (command === "login") {
-    const { runLoginCommand } = await import("./login-command-O6WA4FYL.js");
+    const { runLoginCommand } = await import("./login-command-RLLKD565.js");
     return runLoginCommand(args);
   }
   if (command === "logout") {
-    const { runLogoutCommand } = await import("./logout-command-6CPWGFY2.js");
+    const { runLogoutCommand } = await import("./logout-command-XDMSXCDO.js");
     return runLogoutCommand(args);
   }
   if (command === "deploy") {
-    const { runDeployCommand } = await import("./deploy-command-5WTFHMBT.js");
+    const { runDeployCommand } = await import("./deploy-command-34T2LKQ5.js");
     return atProjectRoot(args, runDeployCommand, entryPositional(args));
   }
   if (command === "ephemeral") {
-    const { runEphemeralCommand } = await import("./ephemeral-command-VDSQCOYL.js");
+    const { runEphemeralCommand } = await import("./ephemeral-command-OZ26RGXF.js");
     return atProjectRoot(args, runEphemeralCommand);
   }
-  if (command === "local-engine") {
-    const { runLocalEngineCommand } = await import("./local-engine-command-HMTQK7MN.js");
+  if (command === "local") {
+    const { runLocalEngineCommand } = await import("./local-engine-command-RYLGMQ2O.js");
     const project = ["token", "stop", "update"].includes(args.subcommand ?? "");
     return project ? atProjectRoot(args, runLocalEngineCommand) : runLocalEngineCommand(args);
   }
   if (command === "env") {
     if (args.subcommand === "set" || args.subcommand === "unset") {
-      const { runEnvVarCommand } = await import("./env-var-command-YKTJZFJN.js");
+      const { runEnvVarCommand } = await import("./env-var-command-VYDBQJJW.js");
       return atProjectRoot(args, (a) => runEnvVarCommand(a, args.subcommand));
     }
     if (args.subcommand !== "pull") throw unknownSubcommand("env", args.subcommand);
-    const { runEnvPullCommand } = await import("./env-pull-command-WZZ7RL2E.js");
+    const { runEnvPullCommand } = await import("./env-pull-command-UTG6IC2K.js");
     return atProjectRoot(args, runEnvPullCommand);
   }
   if (command === "secrets") {
     if (args.subcommand !== "fill") throw unknownSubcommand("secrets", args.subcommand);
-    const { runSecretsFillCommand } = await import("./secrets-fill-command-QEOCUOAY.js");
+    const { runSecretsFillCommand } = await import("./secrets-fill-command-QNBDGCGM.js");
     return atProjectRoot(args, runSecretsFillCommand, entryPositional(args));
   }
   if (command === "release") {
-    const { runReleaseCommand: runReleaseNs } = await import("./release-ns-command-EIBN3JVM.js");
+    const { runReleaseCommand: runReleaseNs } = await import("./release-ns-command-ATGVBVIU.js");
     return atProjectRoot(args, runReleaseNs);
   }
   if (command === "pull") {
-    const { runPullCommand } = await import("./pull-command-WQFPLITW.js");
+    const { runPullCommand } = await import("./pull-command-ZGUNP27P.js");
     const first = args.positionals[0];
     const file = first !== void 0 && !isKindShaped(first) && (/\.json$/i.test(first) || /[\\/]/.test(first));
     return file ? runPullCommand(args) : atProjectRoot(args, runPullCommand);
   }
   if (command === "generate") {
-    const { runGenerateCommand } = await import("./generate-command-3NTNRQRS.js");
+    const { runGenerateCommand } = await import("./generate-command-4HR7MR36.js");
     return runGenerateCommand(args);
   }
   if (command === "tables") {
-    const { runTablesCommand } = await import("./tables-command-X3JK7VSK.js");
+    const { runTablesCommand } = await import("./tables-command-UQLKTELN.js");
     return atProjectRoot(args, runTablesCommand);
   }
   if (command === "impersonate") {
-    const { runImpersonateCommand } = await import("./impersonate-command-QEJA72Q2.js");
+    const { runImpersonateCommand } = await import("./impersonate-command-WC7OGKUM.js");
     return atProjectRoot(args, runImpersonateCommand);
   }
   if (command === "promote") {
-    const { runPromoteCommand } = await import("./promote-command-4F2NAE6P.js");
+    const { runPromoteCommand } = await import("./promote-command-UYAMUXKB.js");
     return atProjectRoot(args, runPromoteCommand);
   }
   if (command === "publish") {
-    const { runPublishCommand } = await import("./publish-command-LGLZBOCB.js");
+    const { runPublishCommand } = await import("./publish-command-BUS27HGB.js");
     return atProjectRoot(args, runPublishCommand, "path");
   }
   if (command === "tenant") {
-    const { runTenantCommand } = await import("./tenant-command-P27EQHBU.js");
+    const { runTenantCommand } = await import("./tenant-command-2LWP2MPB.js");
     return atProjectRoot(args, runTenantCommand);
   }
   if (command === "test") {
-    const { runTestCommand } = await import("./test-command-A4G2FP7G.js");
+    const { runTestCommand } = await import("./test-command-IU5MBBXY.js");
     return atProjectRoot(args, runTestCommand);
   }
   if (command === "workspace") {
-    const { runWorkspaceCommand } = await import("./workspace-command-T7Z2BDHD.js");
+    const { runWorkspaceCommand } = await import("./workspace-command-FC4IMLAE.js");
     return runWorkspaceCommand(args);
   }
   if (command === "status") {
-    const { runStatusCommand } = await import("./status-command-XUH5OGQX.js");
+    const { runStatusCommand } = await import("./status-command-XKIFKBGM.js");
     return runStatusCommand(args);
   }
   if (command === "whoami") {
-    const { runWhoamiCommand } = await import("./whoami-command-KNWFWAX6.js");
+    const { runWhoamiCommand } = await import("./whoami-command-7WQII2H4.js");
     return runWhoamiCommand(args);
   }
   if (command === "profile") {
-    const { runProfileCommand } = await import("./profile-command-NPKBJYPM.js");
+    const { runProfileCommand } = await import("./profile-command-6JWT2BTL.js");
     return runProfileCommand(args);
   }
   if (command === "marketplace") {
     if (!["list", "search", "details", "install", "reinstall", "remove"].includes(args.subcommand ?? "")) {
       throw unknownSubcommand("marketplace", args.subcommand);
     }
-    const marketplace = await import("./marketplace-command-HKACSYKS.js");
-    const { withCatalogueRerun } = await import("./marketplace-resolve-KLFYVRWS.js");
+    const marketplace = await import("./marketplace-command-2NHHY2X3.js");
+    const { withCatalogueRerun } = await import("./marketplace-resolve-OTZYT4FG.js");
     try {
       if (args.subcommand === "list") return await marketplace.runMarketplaceListCommand(args);
       if (args.subcommand === "search") return await marketplace.runMarketplaceSearchCommand(args);
@@ -3509,7 +3533,7 @@ async function dispatch(rawArgv) {
     }
   }
   if (command === "preflight") {
-    const { runPreflightCommand } = await import("./preflight-command-EBQ6XQF3.js");
+    const { runPreflightCommand } = await import("./preflight-command-OHJXYND3.js");
     return runPreflightCommand(args);
   }
   if (command !== "compile" && command !== "export" && command !== "paths" && command !== "routes") {
@@ -3524,12 +3548,12 @@ async function dispatch(rawArgv) {
   if (command === "paths" || command === "routes") {
     return runPaths(args);
   }
-  const { discoverToolchainPlugins } = await import("./toolchain-modules-3M7QDJBV.js");
+  const { discoverToolchainPlugins } = await import("./toolchain-modules-VU7SURVJ.js");
   const toolchain = await discoverToolchainPlugins(process.cwd(), {
     frozen: args.frozenLock === true || args.check === true
   });
   if (out && !args.check) {
-    const { assertWritableTarget } = await import("./output-target-SZMBNYF4.js");
+    const { assertWritableTarget } = await import("./output-target-MOLCTPBP.js");
     assertWritableTarget(out, "--out");
   }
   const { bundle: json, bundleObject, omittedSeedTables, lock: lockOutcome, declaredEnvNames } = await compileBundle(args);
@@ -3539,7 +3563,7 @@ async function dispatch(rawArgv) {
       `Exported bundle omits seed rows for ${countOf(omittedSeedTables.length, "table")}: ${names}. Seed is applied only by \`xanosdk deploy <entry>\` \u2014 deploying this bundle via \`--bundle\` ships schema without seed data.`
     );
   }
-  const { hostedIconOwners } = await import("./hosted-file-PSHJB3HX.js");
+  const { hostedIconOwners } = await import("./hosted-file-S7YUQAH6.js");
   const hostedOwners = hostedIconOwners(bundleObject.payload ?? {});
   if (hostedOwners.length > 0 && !args.check) {
     warn(
@@ -3547,7 +3571,7 @@ async function dispatch(rawArgv) {
       "export.hosted-files-omitted"
     );
   }
-  const { runBundleHooks } = await import("./toolchain-hooks-BGZBDFAT.js");
+  const { runBundleHooks } = await import("./toolchain-hooks-4ZMQLBPQ.js");
   await runBundleHooks(
     toolchain.loaded,
     {
@@ -3560,15 +3584,15 @@ async function dispatch(rawArgv) {
     },
     ""
   );
-  const { refreshEnvExample, bundleEnvNames: bundleEnvNames2 } = await import("./env-example-refresh-ZO6XAV44.js");
-  const { backendDirFor } = await import("./backend-dir-WZADOK3L.js");
+  const { refreshEnvExample, bundleEnvNames: bundleEnvNames2 } = await import("./env-example-refresh-CQP3ZMKM.js");
+  const { backendDirFor } = await import("./backend-dir-3LIL6SCT.js");
   const declaredSet = new Set(declaredEnvNames);
   const templateDir = backendDirFor(args.file);
   const ownsTemplate = isWithin(resolve2(args.file), templateDir) && (dirname2(resolve2(args.file)) === templateDir || !existsSync2(join2(templateDir, "index.ts")));
   const templateEnv = Object.fromEntries(
     Object.entries(bundleEnvNames2(bundleObject)).filter(([name]) => declaredSet.has(name))
   );
-  const { skewedProjectSdk, skewNote, installedCliCommand } = await import("./project-sdk-FOR4IOXL.js");
+  const { skewedProjectSdk, skewNote, installedCliCommand } = await import("./project-sdk-3W72H5QO.js");
   const projectSdk = skewedProjectSdk(dirname2(resolve2(args.file)), readVersion());
   const regenerate = projectSdk === void 0 ? `xanosdk export ${shellWord(pastePath(args.file))} --out ${NULL_DEVICE}` : installedCliCommand(projectSdk.root, (path) => `export ${path(args.file)} --out ${NULL_DEVICE}`);
   if (args.check) {
@@ -3619,15 +3643,15 @@ async function dispatch(rawArgv) {
     info(`${hadEnvExample ? "Updated" : "Wrote"} ${displayPath(refreshed)} to list the env names this source declares.`);
   }
   if (out) {
-    const { secretsCarriedBy } = await import("./live-diff-2S7E3SBZ.js");
-    const { writeExportFile } = await import("./output-target-SZMBNYF4.js");
+    const { secretsCarriedBy } = await import("./live-diff-5E2BQWQ7.js");
+    const { writeExportFile } = await import("./output-target-MOLCTPBP.js");
     const written = lockOutcome?.changed ? `Only ${lockOutcome.path} was written` : void 0;
     writeExportFile(out, json + "\n", secretsCarriedBy(bundleObject), "--out", written);
     reportWrote(args, out, lockOutcome);
   } else {
     process.stdout.write(json + "\n");
-    const { secretsCarriedBy } = await import("./live-diff-2S7E3SBZ.js");
-    const { secretsPhrase } = await import("./output-target-SZMBNYF4.js");
+    const { secretsCarriedBy } = await import("./live-diff-5E2BQWQ7.js");
+    const { secretsPhrase } = await import("./output-target-MOLCTPBP.js");
     const secrets = secretsCarriedBy(bundleObject);
     if (secrets.length > 0) {
       warn(
@@ -3646,11 +3670,11 @@ async function refreshAgentGuidance(args) {
   if (args.noRefresh) return;
   if (args.check || args.frozenLock || args.dryRun) return;
   try {
-    const { installedSdk, skewedProjectSdk, skewNote, installedCliCommand } = await import("./project-sdk-FOR4IOXL.js");
+    const { installedSdk, skewedProjectSdk, skewNote, installedCliCommand } = await import("./project-sdk-3W72H5QO.js");
     const entryProject = args.file === void 0 ? void 0 : installedSdk(dirname2(resolve2(args.file)))?.root;
     const projectDir = existsSync2(join2(process.cwd(), "AGENTS.md")) || entryProject === void 0 ? process.cwd() : entryProject;
     const projectSdk = skewedProjectSdk(projectDir, readVersion());
-    const { refreshAgentFiles } = await import("./agent-file-refresh-LB6KIMFY.js");
+    const { refreshAgentFiles } = await import("./agent-file-refresh-67QIX45H.js");
     if (projectSdk !== void 0) {
       const stale = refreshAgentFiles({ projectDir, sdkVersion: readVersion(), write: false });
       const file = args.file;
@@ -3713,7 +3737,7 @@ function noteUnlockedBuild() {
 }
 function adoptBeforeFirstLock(lockPath, args) {
   const deploying = args?.command === "deploy";
-  if (deploying && (args.localEngine || args.to === void 0 || args.to.startsWith("local-engine"))) return void 0;
+  if (deploying && (args.localEngine || args.to === void 0 || args.to.startsWith("local"))) return void 0;
   const importLine = `\`xanosdk lock import live.json --lock=${shellWord(displayPath(lockPath))} --yes\``;
   const ending = "so the lock adopts the URLs it already serves instead of values it will not accept.";
   const target = deploying ? args.to : "workspace";
@@ -3866,6 +3890,13 @@ function withPinnedGuid(artifact, def) {
   if (parsed.guid !== void 0) return artifact;
   return JSON.stringify({ ...parsed, guid: def.guid }, null, 2);
 }
+function emitProjectDir(emit2, entry) {
+  if (emit2 !== "-") {
+    const root = projectRootFrom(dirname2(resolve2(emit2)));
+    if (existsSync2(join2(root, "package.json"))) return root;
+  }
+  return projectRootFrom(dirname2(resolve2(entry)));
+}
 async function runPaths(args) {
   const file = args.file;
   if (args.emit === "-" && args.strict) {
@@ -3877,6 +3908,12 @@ async function runPaths(args) {
   const lockPath = resolveLockPath(args, file);
   resetLockOverrides();
   const lockModel = existsSync2(lockPath) ? readLockFile(lockPath) : void 0;
+  const toolchain = args.emit !== void 0 ? await (await import("./toolchain-modules-VU7SURVJ.js")).discoverToolchainPlugins(emitProjectDir(args.emit, file), {
+    frozen: args.strict === true,
+    // A module outside its SDK peer range keeps its block and is named,
+    // as any other skip is; it does not abort every `dev` and `build`.
+    peerSkew: "skip"
+  }) : void 0;
   const def = await loadDefault(file);
   if (!Xano.isXano(def)) {
     throw new UsageError(
@@ -3893,7 +3930,7 @@ async function runPaths(args) {
     setDiagnosticSink(outerSink);
   }
   const payload = bundle.payload;
-  const { planRouteManifest } = await import("./routes-manifest-3BNZIVST.js");
+  const { planRouteManifest } = await import("./routes-manifest-YR4ZIMLM.js");
   const plan = planRouteManifest(payload, (kind, name) => lockModel?.objects[lockKey(kind, name)]?.canonical);
   const queryCount = plan.rows.length;
   const realtimeCount = plan.servers.length + plan.unresolvedServers.length;
@@ -3917,7 +3954,7 @@ async function runPaths(args) {
       );
     }
     if (unresolved.length > 0) {
-      const { unresolvedCanonicalMessage } = await import("./routes-manifest-3BNZIVST.js");
+      const { unresolvedCanonicalMessage } = await import("./routes-manifest-YR4ZIMLM.js");
       const why = `${args.emit} was not written: ${unresolvedCanonicalMessage(unresolved, shellWord(file))}`;
       if (args.strict) throw new Error(`--strict: ${why}`);
       warn(why, "routes.not-written");
@@ -3929,8 +3966,23 @@ async function runPaths(args) {
       if (machine && args.emit !== "-") writeJson({ emit: resolve2(args.emit), written: false, routes: 0, channels: 0 });
       return;
     }
-    const { renderPlannedManifest, renderRouteManifest } = await import("./routes-manifest-3BNZIVST.js");
-    const source = emptiedManifest ? renderRouteManifest([]) : renderPlannedManifest(plan);
+    const { renderManifestFile, reportModuleFailures } = await import("./routes-manifest-file-UALYSZLY.js");
+    const loaded = toolchain?.loaded ?? [];
+    const skipped = toolchain?.skipped ?? [];
+    const rendered = renderManifestFile(
+      plan,
+      {
+        loaded,
+        skipped,
+        // Read only when a module could fail or be skipped: with none, nothing
+        // is carried forward and `renderManifestFile` never consults it.
+        previous: loaded.length + skipped.length > 0 && args.emit !== "-" && existsSync2(args.emit) ? readFileSync3(args.emit, "utf8") : void 0,
+        sdkVersion: readVersion()
+      },
+      { orEmpty: true }
+    );
+    reportModuleFailures(rendered.failed, args.emit === "-" ? "the route manifest on stdout" : args.emit, args.strict === true);
+    const source = rendered.source;
     const routeCount = resolved.length === 1 ? "1 route" : `${resolved.length} routes`;
     const channelCount = channelRows.length === 1 ? "1 channel" : `${channelRows.length} channels`;
     const count = describableServers.length > 0 ? `${routeCount}, ${channelCount}` : routeCount;
@@ -3938,7 +3990,7 @@ async function runPaths(args) {
       writeData(process.stdout, source);
       return;
     }
-    const { installedSdk, skewedProjectSdk, skewNote, installedCliCommand } = await import("./project-sdk-FOR4IOXL.js");
+    const { installedSdk, skewedProjectSdk, skewNote, installedCliCommand } = await import("./project-sdk-3W72H5QO.js");
     const emitDir = dirname2(resolve2(args.emit));
     const projectSdk = skewedProjectSdk(installedSdk(emitDir) !== void 0 ? emitDir : dirname2(resolve2(file)), readVersion());
     if (projectSdk !== void 0 && existsSync2(args.emit) && readFileSync3(args.emit, "utf8") !== source) {
@@ -4011,14 +4063,16 @@ async function runPaths(args) {
     }
   }
   if (unresolved.length > 0) {
-    const { unresolvedCanonicalMessage } = await import("./routes-manifest-3BNZIVST.js");
+    const { unresolvedCanonicalMessage } = await import("./routes-manifest-YR4ZIMLM.js");
     throw new UsageError(`${commandLabel(args)}: ${unresolvedCanonicalMessage(unresolved, shellWord(file))}`);
   }
 }
-async function refreshRouteManifest(entry, emit2) {
+async function refreshRouteManifest(entry, emit2, projectDir) {
   resetLockOverrides();
   const lockPath = join2(dirname2(resolve2(entry)), "xano.lock");
   const lockModel = existsSync2(lockPath) ? readLockFile(lockPath) : void 0;
+  const { discoverToolchainPlugins } = await import("./toolchain-modules-VU7SURVJ.js");
+  const toolchain = existsSync2(emit2) ? await discoverToolchainPlugins(projectDir, { frozen: false, configuring: true, peerSkew: "skip" }) : void 0;
   const def = await loadDefault(entry);
   if (!Xano.isXano(def)) return { manifest: "absent", lockOrphans: 0 };
   const previousSink = setDiagnosticSink(() => {
@@ -4029,16 +4083,30 @@ async function refreshRouteManifest(entry, emit2) {
   } finally {
     setDiagnosticSink(previousSink);
   }
-  const { pulledIdentities } = await import("./pull-command-WQFPLITW.js");
+  const { pulledIdentities } = await import("./pull-command-ZGUNP27P.js");
   const live = pulledIdentities(payload);
   const lockOrphans = lockModel === void 0 ? 0 : Object.keys(lockModel.objects).filter((k) => k !== WORKSPACE_KEY && !live.has(k)).length;
   if (!existsSync2(emit2)) return { manifest: "absent", lockOrphans };
-  const { planRouteManifest, renderPlannedManifest, renderRouteManifest } = await import("./routes-manifest-3BNZIVST.js");
+  const { planRouteManifest, RouteManifestError } = await import("./routes-manifest-YR4ZIMLM.js");
+  const { renderManifestFile, reportModuleFailures } = await import("./routes-manifest-file-UALYSZLY.js");
   const plan = planRouteManifest(payload, (kind, name) => lockModel?.objects[lockKey(kind, name)]?.canonical);
   if (plan.unresolved.length > 0) return { manifest: "skipped", lockOrphans };
-  const source = renderPlannedManifest(plan) ?? (plan.resolved.length === 0 && plan.servers.length === 0 ? renderRouteManifest([]) : void 0);
-  if (source === void 0) return { manifest: "skipped", lockOrphans };
-  if (readFileSync3(emit2, "utf8") === source) return { manifest: "unchanged", lockOrphans };
+  const current = readFileSync3(emit2, "utf8");
+  let rendered;
+  try {
+    rendered = renderManifestFile(
+      plan,
+      { loaded: toolchain?.loaded ?? [], skipped: toolchain?.skipped ?? [], previous: current, sdkVersion: readVersion() },
+      { orEmpty: true }
+    );
+  } catch (err) {
+    if (!(err instanceof RouteManifestError)) throw err;
+    return { manifest: "skipped", lockOrphans, why: err.message };
+  }
+  if (rendered === void 0) return { manifest: "skipped", lockOrphans };
+  reportModuleFailures(rendered.failed, emit2);
+  const source = rendered.source;
+  if (current === source) return { manifest: "unchanged", lockOrphans };
   try {
     writeFileSync(emit2, source, "utf8");
   } catch (err) {
@@ -4481,7 +4549,7 @@ function checkStandInTokens(def) {
 }
 function docMergeOf(args) {
   if (args.command !== "deploy" || args.localEngine) return void 0;
-  if (args.to !== void 0) return args.replace || args.to.startsWith("local-engine") ? void 0 : "to";
+  if (args.to !== void 0) return args.replace || args.to.startsWith("local") ? void 0 : "to";
   return args.keepData && !args.reset ? "keep-data" : void 0;
 }
 function unsuppliedDocTokenError(unsupplied, remedy) {
@@ -4544,7 +4612,7 @@ async function refineGonePullHint(err) {
   if (offer === void 0 || auth === void 0 || !(err instanceof Error) || !err.message.includes(offer.clause)) return;
   let gone;
   try {
-    const { lookupEphemeral } = await import("./source-resolve-DMDZVPMM.js");
+    const { lookupEphemeral } = await import("./source-resolve-MKLNYFWG.js");
     gone = await lookupEphemeral(auth, offer.name) === null;
   } catch {
     return;
@@ -4747,4 +4815,4 @@ export {
   docTokenRefusalIfReplaced,
   envRefusalIfReplaced
 };
-//# sourceMappingURL=chunk-WYEQFD6A.js.map
+//# sourceMappingURL=chunk-XFBGXB7X.js.map