@xano/sdk 1.0.4 → 1.0.6

package/dist/{chunk-L2GLOJAO.js → chunk-GW5RHGOB.js}

@@ -1,35 +1,35 @@
 import {
   resolveProjectEntry
-} from "./chunk-VRVKNY4A.js";
+} from "./chunk-Z4ZGTCCD.js";
 import {
   isUnusablePin,
   readPin,
   writePin
-} from "./chunk-D64XUF5Q.js";
+} from "./chunk-YYLUBYXM.js";
 import {
   ENGINE_RELEASES_URL_ENV,
   EngineReleaseNotFoundError,
   usesCustomReleaseManager
-} from "./chunk-CYB7UQA2.js";
+} from "./chunk-OIKLDDYC.js";
 import {
   LOCAL_ENGINE_OVERRIDE_ENV,
   engineOverrideFromEnv,
   resolveEnginePlatform,
   resolveEngineSource
-} from "./chunk-AM4FKL4J.js";
+} from "./chunk-PL7AIAWS.js";
 import {
   ORIGIN_READ_ONLY_BY_REFRESH
-} from "./chunk-SEUCZZCP.js";
+} from "./chunk-N5I37JFB.js";
 import {
   UsageError,
   info,
   warn
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-D7BUMOKU.js";
 
 // src/emit/local-engine-choice.ts
 function refuseCredentialFlagsForLocal(args, kinds) {
-  if (kinds.some((k) => k !== "local-engine")) return;
-  const why = "and a local engine takes none \u2014 it is reached with the engine's own bearer.";
+  if (kinds.some((k) => k !== "local")) return;
+  const why = "and a Xano Engine takes none \u2014 it is reached with the engine's own bearer.";
   const or = "or deploy from a hosted backend that reads it.";
   const refuse = (message) => {
     throw new UsageError(message, { hintFor: { command: "deploy" } });
@@ -38,7 +38,7 @@ function refuseCredentialFlagsForLocal(args, kinds) {
     refuse(`\`--config ${args.authFile}\` names a Xano credential file, ${why} Drop \`--config\`, ${or}`);
   }
   if (args.local === true) {
-    refuse(`\`--local\` selects the project-local Xano credential file, ${why} Drop \`--local\`, ${or}`);
+    refuse(`\`--local-auth\` selects the project-local Xano credential file, ${why} Drop \`--local-auth\`, ${or}`);
   }
   if (args.authHost !== void 0) {
     refuse(`\`--origin\` names a Xano sign-in server, ${why} ${ORIGIN_READ_ONLY_BY_REFRESH}`);
@@ -47,7 +47,7 @@ function refuseCredentialFlagsForLocal(args, kinds) {
 async function chooseLocalEngine(flagValue, dir, machineOutput) {
   if (flagValue !== void 0 && flagValue !== "") {
     const source = resolveEngineSource(flagValue);
-    announceOverride(source, "--local-engine", "run `--local-engine` bare to go back to it");
+    announceOverride(source, "--local", "run `--local` bare to go back to it");
     return { source, pinWrite: void 0, pin: "none", override: "flag" };
   }
   const fromEnv = engineOverrideFromEnv();
@@ -63,8 +63,8 @@ async function chooseLocalEngine(flagValue, dir, machineOutput) {
   }
   const pin = readPin(dir, {
     warn: (message) => warn(
-      `${message} This deploy runs the latest local engine and the field is left as written \u2014 set it to a version like "v0.1.5", or run \`xanosdk local-engine update\` to pin one.`,
-      "local-engine.version-invalid"
+      `${message} This deploy runs the latest Xano Engine and the field is left as written \u2014 set it to a version like "v0.1.5", or run \`xanosdk local update\` to pin one.`,
+      "local.version-invalid"
     )
   });
   if (isUnusablePin(pin)) {
@@ -72,8 +72,8 @@ async function chooseLocalEngine(flagValue, dir, machineOutput) {
   }
   if (pin === void 0 && resolveProjectEntry(dir) === void 0) {
     warn(
-      `No package.json in ${dir}, and it is not a Xano SDK project, so the local engine was not pinned \u2014 this deploy runs the latest engine.`,
-      "local-engine.not-pinned"
+      `No package.json in ${dir}, and it is not a Xano SDK project, so the Xano Engine was not pinned \u2014 this deploy runs the latest engine.`,
+      "local.not-pinned"
     );
     return { source: resolveEngineSource(void 0), pinWrite: void 0, pin: "none" };
   }
@@ -87,7 +87,7 @@ async function chooseLocalEngine(flagValue, dir, machineOutput) {
   };
   const platform = resolveEnginePlatform();
   if (platform === void 0) return keep;
-  const check = await import("./local-engine-update-check-R5SPDVEJ.js");
+  const check = await import("./local-engine-update-check-LVX4HBBI.js");
   const latest = await check.latestKnownVersion({ platform });
   if (latest === void 0) return keep;
   const decision = check.decideUpdate({
@@ -101,10 +101,10 @@ async function chooseLocalEngine(flagValue, dir, machineOutput) {
     info(check.updateNoticeText(pin, latest));
     return keep;
   }
-  const { confirm } = await import("./prompt-5GUQTCSP.js");
+  const { confirm } = await import("./prompt-U37K5RPQ.js");
   const yes = await confirm(check.updatePromptText(pin, latest), {
-    flag: "`xanosdk local-engine update`",
-    refusal: { details: { updated: false }, rerun: "xanosdk local-engine update" }
+    flag: "`xanosdk local update`",
+    refusal: { details: { updated: false }, rerun: "xanosdk local update" }
   });
   if (!yes) {
     check.recordDeclined(dir, latest);
@@ -126,7 +126,7 @@ function explainOverrideFailure(choice, err) {
   const missing = err instanceof EngineReleaseNotFoundError || (message?.includes("has no archive for") ?? false);
   if (override !== "flag" && override !== "env" || message === void 0 || !missing) throw err;
   const what = message.split("\n")[0];
-  const remedy = override === "flag" ? "Check the version, or drop it: `xanosdk deploy --local-engine` (bare) runs this project's pinned engine, and `xanosdk local-engine update` moves that pin to the latest release." : `Check ${LOCAL_ENGINE_OVERRIDE_ENV}, or unset it to run this project's pinned engine.`;
+  const remedy = override === "flag" ? "Check the version, or drop it: `xanosdk deploy --local` (bare) runs this project's pinned engine, and `xanosdk local update` moves that pin to the latest release." : `Check ${LOCAL_ENGINE_OVERRIDE_ENV}, or unset it to run this project's pinned engine.`;
   const text = `${what}
 ${remedy}`;
   throw err instanceof EngineReleaseNotFoundError ? new EngineReleaseNotFoundError(text, { cause: err }) : new Error(text, { cause: err });
@@ -156,10 +156,10 @@ function announceLocalEnginePin(ctx) {
     info(pinWrittenText({ ...written, moved: choice.pinWrite === "move" }));
     return;
   }
-  if (failure !== void 0) warn(`The local engine version was not pinned: ${failure}`, "local-engine.not-pinned");
+  if (failure !== void 0) warn(`The Xano Engine version was not pinned: ${failure}`, "local.not-pinned");
 }
 function pinWrittenText(written) {
-  const what = written.created ? `Created ${written.path} to pin local engine ${written.version}` : `${written.moved ? "Moved the local engine pin to" : "Pinned local engine"} ${written.version} in ${written.path}`;
+  const what = written.created ? `Created ${written.path} to pin Xano Engine ${written.version}` : `${written.moved ? "Moved the Xano Engine pin to" : "Pinned Xano Engine"} ${written.version} in ${written.path}`;
   return `${what} \u2014 commit it so everyone on this project runs the same engine.`;
 }
 
@@ -170,4 +170,4 @@ export {
   pinAfterAcquire,
   pinWrittenText
 };
-//# sourceMappingURL=chunk-L2GLOJAO.js.map
+//# sourceMappingURL=chunk-GW5RHGOB.js.map

package/dist/{chunk-A6QTTJUI.js → chunk-GWTFI3GA.js}

@@ -10,7 +10,7 @@ import {
   safeHttpFailure,
   statusLabel,
   writeStatusAftermath
-} from "./chunk-MN2PB6WB.js";
+} from "./chunk-YR2I5HGE.js";
 
 // src/deploy/release.ts
 var TIMEOUT_MS = 3e4;
@@ -405,4 +405,4 @@ export {
   exportRelease,
   deleteRelease
 };
-//# sourceMappingURL=chunk-A6QTTJUI.js.map
+//# sourceMappingURL=chunk-GWTFI3GA.js.map

package/dist/{chunk-MCTIKRMN.js → chunk-GZHLCUZ6.js}

@@ -3,11 +3,11 @@ import {
   reachableLines,
   readReachableWorkspaces,
   workspaceIdFix
-} from "./chunk-QAEQGT5I.js";
+} from "./chunk-2WBH5HUY.js";
 import {
   credentialRejected,
   getAccessToken
-} from "./chunk-LUTMOHOW.js";
+} from "./chunk-YGLMRH5U.js";
 import {
   CREDENTIAL_FILE_VERSION,
   UPGRADE_REMEDY,
@@ -15,16 +15,16 @@ import {
   loginCommand,
   readCredentialFile,
   resolveAuthFilePath
-} from "./chunk-I2BGYNHD.js";
+} from "./chunk-M5CSVB23.js";
 import {
   fetchOrExplain,
   httpFailure,
   parseJsonAnswer
-} from "./chunk-MN2PB6WB.js";
+} from "./chunk-YR2I5HGE.js";
 import {
   profileSourceLabel,
   selectionDocument
-} from "./chunk-QXTKSOFI.js";
+} from "./chunk-MF4W6FHU.js";
 import {
   formatFields,
   isMachineOutput,
@@ -32,7 +32,7 @@ import {
   stdoutStyle,
   warn,
   writeJson
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-D7BUMOKU.js";
 import {
   shellQuote
 } from "./chunk-5ZSO4T2G.js";
@@ -165,7 +165,7 @@ function prettyProfile(p) {
 }
 async function runWhoamiCommand(args) {
   const profile = await fetchProfile(args).catch(async (err) => {
-    const { unansweredRead } = await import("./source-resolve-DMDZVPMM.js");
+    const { unansweredRead } = await import("./source-resolve-MKLNYFWG.js");
     throw unansweredRead(err, "read the signed-in user", "workspace");
   });
   if (isMachineOutput(args)) {
@@ -185,4 +185,4 @@ export {
   profileValue,
   runWhoamiCommand
 };
-//# sourceMappingURL=chunk-MCTIKRMN.js.map
+//# sourceMappingURL=chunk-GZHLCUZ6.js.map

package/dist/{chunk-664LSWE5.js → chunk-HCG7NDIL.js}

@@ -1,10 +1,10 @@
 import {
   backendDirFor,
   backendDirIn
-} from "./chunk-E6H5ZEV3.js";
+} from "./chunk-TTEIDD5Q.js";
 import {
   XANO_DIR
-} from "./chunk-HUSH7LRI.js";
+} from "./chunk-LL7SGTRC.js";
 import {
   projectRootFrom
 } from "./chunk-ROY4YAEQ.js";
@@ -12,7 +12,7 @@ import {
   LocalFileNotFoundError,
   UsageError,
   displayPath
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-D7BUMOKU.js";
 import {
   isRepresentableName
 } from "./chunk-GSGDWJB5.js";
@@ -242,4 +242,4 @@ export {
   namesInEnvExample,
   renderWorkspaceEnvFile
 };
-//# sourceMappingURL=chunk-664LSWE5.js.map
+//# sourceMappingURL=chunk-HCG7NDIL.js.map

package/dist/{chunk-7PMVIHB3.js → chunk-I3H3HCPY.js}

@@ -2,10 +2,10 @@ import {
   keptDuplicates,
   replacedRegistrations,
   reportSuperseded
-} from "./chunk-IVKRT476.js";
+} from "./chunk-SPITRSOF.js";
 import {
   rerenderEnvExample
-} from "./chunk-6VBTPV2Y.js";
+} from "./chunk-U35MTOXQ.js";
 import {
   carriedSeedRows,
   decodeBundle,
@@ -17,48 +17,58 @@ import {
   verifyPulledTree,
   withSourceIdentities,
   writeDocumentationTokens
-} from "./chunk-ESZ2FF57.js";
+} from "./chunk-RIN4YY34.js";
+import {
+  ROUTES_MANIFEST_BASENAME
+} from "./chunk-LBJA7IEM.js";
 import {
   confirm
-} from "./chunk-4APOHK7Y.js";
+} from "./chunk-JXVJGF3Y.js";
+import {
+  recordSync,
+  syncBranchLabel
+} from "./chunk-NDWVJ2QZ.js";
+import {
+  syncDigests
+} from "./chunk-JI3BLXWQ.js";
 import {
   fetchSourceArchive
-} from "./chunk-VRVKNY4A.js";
+} from "./chunk-Z4ZGTCCD.js";
 import {
   decodeWorkspaceArchive,
   encodeWorkspaceArchive
 } from "./chunk-3DRXWLJ5.js";
 import {
   ensureSecretPathGitignored
-} from "./chunk-Y2ZLKBM6.js";
+} from "./chunk-UD2Z7K6W.js";
 import {
   readVersion,
   refreshAgentGuidance
-} from "./chunk-WYEQFD6A.js";
+} from "./chunk-XFBGXB7X.js";
 import {
   WORKSPACE_ENV_BASENAME,
   WORKSPACE_ENV_EXAMPLE_BASENAME,
   namesInEnvExample,
   readWorkspaceEnvFile
-} from "./chunk-664LSWE5.js";
+} from "./chunk-HCG7NDIL.js";
 import {
   memoCredential,
   refuseProfileForLocal,
   selectBackend
-} from "./chunk-LIVN53UV.js";
+} from "./chunk-I3VHW6XM.js";
 import {
   getAccessToken
-} from "./chunk-LUTMOHOW.js";
+} from "./chunk-YGLMRH5U.js";
 import {
   requireBackendSlot
-} from "./chunk-UDE5C2XN.js";
+} from "./chunk-VDHA5SSQ.js";
 import {
   contextFlags
-} from "./chunk-SEUCZZCP.js";
+} from "./chunk-N5I37JFB.js";
 import {
   backendDirIn,
   resolveBackendDir
-} from "./chunk-E6H5ZEV3.js";
+} from "./chunk-TTEIDD5Q.js";
 import {
   CODEGEN_MARKER,
   DECODE_MARKER,
@@ -73,15 +83,15 @@ import {
   readDecodeRecord,
   removeEmptiedDirs,
   removeFiles
-} from "./chunk-HUSH7LRI.js";
+} from "./chunk-LL7SGTRC.js";
 import {
   readLockFile,
   writeLockFile
-} from "./chunk-VD32O6KZ.js";
+} from "./chunk-CJDPSCMX.js";
 import {
   decodeMarkerHead,
   decodeMarkerWith
-} from "./chunk-UCQ2VUTG.js";
+} from "./chunk-M6ZFSTIZ.js";
 import {
   CliError,
   UsageError,
@@ -94,7 +104,7 @@ import {
   terminalText,
   warn,
   writeJson
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-D7BUMOKU.js";
 import {
   WORKSPACE_SECRETS_BASENAME
 } from "./chunk-3JDU4VRL.js";
@@ -104,7 +114,7 @@ import {
   lockKey,
   lockNameForObject,
   withObjects
-} from "./chunk-OOGXZL7Z.js";
+} from "./chunk-5KJBWIDZ.js";
 import {
   shellQuote
 } from "./chunk-5ZSO4T2G.js";
@@ -299,15 +309,16 @@ async function runPullCommand(args) {
   step(`Reading ${raw}`);
   const fetched = args.branch !== void 0 ? { archive: encodeWorkspaceArchive(JSON.stringify(await fetchWorkspaceBundle(await credential(), args.branch))), provenance: "workspace", label: `workspace branch "${args.branch.trim()}"` } : await fetchSourceArchive(credential, raw, cwd);
   const bundle = decodeWorkspaceArchive(fetched.archive);
-  const keptName = source.kind === "workspace" || source.kind === "local-engine" ? void 0 : projectWorkspaceName(join(cwd, backendDir, "index.ts"));
+  const keptName = source.kind === "workspace" || source.kind === "local" ? void 0 : projectWorkspaceName(join(cwd, backendDir, "index.ts"));
   const project = decodeBundle(bundle, {
     secretsFile: `${backendDir}/${WORKSPACE_SECRETS_BASENAME}`,
-    writesSecrets: args.noSecrets !== true,
     ...keptName !== void 0 ? { workspaceName: keptName } : {}
   });
   refuseDuplicateSourceGuids(project);
   const seedRows = carriedSeedRows(fetched.archive, bundle.payload);
-  const placed = placeGeneratedFiles(project, backendDir);
+  const { discoverManifestModules } = await import("./routes-manifest-file-UALYSZLY.js");
+  const modules = await discoverManifestModules(cwd, join(cwd, backendDir, ROUTES_MANIFEST_BASENAME), readVersion());
+  const placed = placeGeneratedFiles(project, backendDir, void 0, void 0, modules);
   const settings = source.kind === "release" ? keepProjectSettings(placed, backendDir, join(cwd, backendDir)) : { files: placed, kept: false, lost: [], from: WORKSPACE_SETTINGS_FILE };
   const files = settings.files;
   const dirAbs = join(cwd, backendDir);
@@ -320,6 +331,12 @@ async function runPullCommand(args) {
   const lockPath = join(cwd, backendDir, "xano.lock");
   const lock = existsSync(lockPath) ? readLockFile(lockPath) : void 0;
   const reconciliation = lock === void 0 ? void 0 : reconcileLock(lock, pulledIdentities(bundle.payload));
+  const syncTarget = source.kind === "workspace" && lock !== void 0 ? await (async () => {
+    const auth = await credential();
+    const branch = await syncBranchLabel(auth, args.branch);
+    return branch === void 0 ? void 0 : { instance: auth.instance, workspaceId: auth.workspaceId, branch };
+  })() : void 0;
+  const recordPullSync = () => syncTarget === void 0 ? null : recordSync({ lockPath, target: syncTarget, digests: syncDigests({ held: [bundle] }), by: "pull", complete: true });
   if (reconciliation?.disjoint === true && args.yes !== true) {
     throw await needsYes(
       args,
@@ -333,7 +350,7 @@ async function runPullCommand(args) {
   const duplicates = keptDuplicates(dirAbs, incoming, plan.kept, backendDir);
   if (upToDate) {
     await refreshAgentGuidance({ ...args, file: join(cwd, backendDir, "index.ts") });
-    finishUpToDate(cwd, backendDir, project, args, fetched, lock, lockPath, reconciliation, bundle.payload, files.length, plan.kept, settingsReport(settings, backendDir), seedRows, duplicates);
+    finishUpToDate(cwd, backendDir, project, args, fetched, lock, lockPath, reconciliation, bundle.payload, files.length, plan.kept, settingsReport(settings, backendDir), seedRows, duplicates, recordPullSync);
     return;
   }
   const cleanliness = backendDirCleanliness(cwd, backendDir);
@@ -420,7 +437,7 @@ async function runPullCommand(args) {
     );
   }
   if (args.yes !== true) {
-    const { yesRerun } = await import("./retry-command-Y5YJGOH3.js");
+    const { yesRerun } = await import("./retry-command-QJ57WVW7.js");
     const { rerun, note } = yesRerun(args, "pull");
     const ok = await confirm(`Replace ${backendDir}/ from ${fetched.label}?`, {
       flag: "--yes",
@@ -498,6 +515,7 @@ async function runPullCommand(args) {
       );
     }
   }
+  const syncBaseline = verified === false ? null : recordPullSync();
   if (isMachineOutput(args)) {
     writeJson({
       source: fetched.provenance,
@@ -517,7 +535,8 @@ async function runPullCommand(args) {
       droppedSeeds,
       keptDuplicates: duplicates,
       modulesReplaced,
-      verified
+      verified,
+      syncBaseline
     });
     if (verified === false) throw pullVerifyFailed(cwd, backendDir);
     success(`Pulled ${fetched.label}`);
@@ -552,11 +571,12 @@ function warnTsxNeeded(entry, written, backendDir, resolvable = tsxResolvable) {
     "pull.tsx-needed"
   );
 }
-function finishUpToDate(cwd, backendDir, project, args, fetched, lock, lockPath, reconciliation, payload, fileCount, kept, workspaceSettings, seedRows, duplicates) {
+function finishUpToDate(cwd, backendDir, project, args, fetched, lock, lockPath, reconciliation, payload, fileCount, kept, workspaceSettings, seedRows, duplicates, recordPullSync) {
   reportSeedRows(seedRows, fetched.label, fetched.provenance, backendDir, contextFlags(args));
   ensureSecretPathGitignored(join(cwd, backendDir, WORKSPACE_ENV_BASENAME));
   writeDocumentationTokens(cwd, project.documentationTokens, args, fetched.label, join(cwd, backendDir, WORKSPACE_SECRETS_BASENAME));
   if (lock !== void 0 && reconciliation !== void 0) writeLockFile(lockPath, pulledLock(lock, reconciliation, payload));
+  const syncBaseline = recordPullSync();
   if (isMachineOutput(args)) {
     writeJson({
       source: fetched.provenance,
@@ -579,7 +599,8 @@ function finishUpToDate(cwd, backendDir, project, args, fetched, lock, lockPath,
       keptDuplicates: duplicates,
       modulesReplaced: [],
       // Nothing was written, so there is nothing new to check.
-      verified: null
+      verified: null,
+      syncBaseline
     });
   }
   success(`${backendDir}/ is already up to date with ${fetched.label} \u2014 nothing to replace.`);
@@ -887,11 +908,11 @@ function envFillRemedy(kind, args, one = false) {
     return `a release carries no env values, so fill ${them} in by hand, or read ${them} from a running backend with \`xanosdk env pull --from <backend>\`.`;
   }
   const from = raw === void 0 ? "" : ` --from ${shellQuote(raw)}`;
-  const flags = kind === "local-engine" ? "" : contextFlags(args);
+  const flags = kind === "local" ? "" : contextFlags(args);
   return `fill ${them} in, or run \`xanosdk env pull${from}${flags}\`.`;
 }
 async function needsYes(args, head, why, details) {
-  const { yesRerun } = await import("./retry-command-Y5YJGOH3.js");
+  const { yesRerun } = await import("./retry-command-QJ57WVW7.js");
   const { rerun, note } = yesRerun(args, "pull");
   return new CliError("SDK_USAGE", `${head} Re-run as \`${rerun}\` ${why}.${note}`, {
     exitCode: 1,
@@ -920,4 +941,4 @@ export {
   projectWorkspaceName,
   envFillRemedy
 };
-//# sourceMappingURL=chunk-7PMVIHB3.js.map
+//# sourceMappingURL=chunk-I3H3HCPY.js.map

package/dist/{chunk-LIVN53UV.js → chunk-I3VHW6XM.js}

@@ -1,34 +1,34 @@
 import {
   readDeployed
-} from "./chunk-HSEQYBDO.js";
+} from "./chunk-WZHLMU6T.js";
 import {
   isProjectDir
-} from "./chunk-T4DUFQ2S.js";
+} from "./chunk-CCU5CCRX.js";
 import {
   LookupFailedError,
   SourceError,
   resolveSource
-} from "./chunk-2AUV6NXK.js";
+} from "./chunk-3II44CUJ.js";
 import {
   NotSignedInError
-} from "./chunk-LUTMOHOW.js";
+} from "./chunk-YGLMRH5U.js";
 import {
   otherCredentialRefusal
-} from "./chunk-3P3HXN76.js";
+} from "./chunk-ITC2R2OT.js";
 import {
   getEngineRecord
-} from "./chunk-WL2DSNJV.js";
+} from "./chunk-Q22BMRPF.js";
 import {
   commandPath,
   parseSlot,
   refusedKind,
   slotValueMissing
-} from "./chunk-UDE5C2XN.js";
+} from "./chunk-VDHA5SSQ.js";
 import {
   getEnvironment,
   readEphemeralState,
   unreadableEphemeralState
-} from "./chunk-UKUIUS3E.js";
+} from "./chunk-U6MTGB46.js";
 import {
   ENV_CREDENTIAL_VARS,
   ORIGIN_READ_ONLY_BY_REFRESH,
@@ -36,10 +36,10 @@ import {
   credentialFileFlagFor,
   recordedByEnvCredential,
   typedCredentialFlags
-} from "./chunk-SEUCZZCP.js";
+} from "./chunk-N5I37JFB.js";
 import {
   backendDirIn
-} from "./chunk-E6H5ZEV3.js";
+} from "./chunk-TTEIDD5Q.js";
 import {
   globalAuthFilePath,
   localAuthFilePath,
@@ -47,13 +47,13 @@ import {
   profileAddCommand,
   readCredentialFile,
   recordedCredentialPath
-} from "./chunk-I2BGYNHD.js";
+} from "./chunk-M5CSVB23.js";
 import {
   UsageError,
   displayPath,
   pastePath,
   sourceSpellings
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-D7BUMOKU.js";
 import {
   shellQuote
 } from "./chunk-5ZSO4T2G.js";
@@ -86,7 +86,7 @@ async function selectBackend(slot, raw, ctx) {
   }
   const decided = decide({ cwd, pointer, state, scope, engineRecorded: getEngineRecord(cwd, env) !== void 0 }, slot);
   if ("refusal" in decided) {
-    const { reachableFirst } = await import("./env-target-PO3MOLH5.js");
+    const { reachableFirst } = await import("./env-target-FZROWYFS.js");
     throw await reachableFirst(decided.refusal, scope);
   }
   refuseUnservable(slot, decided.kind);
@@ -98,7 +98,7 @@ async function resolveBackend(slot, raw, ctx) {
   if (source.kind === "file") {
     throw new Error(`Internal: \`${commandPath(slot.command, slot.subcommand)}\` resolved a bundle file; read it before resolving a backend.`);
   }
-  if (source.kind === "local-engine") refuseProfileForLocal(ctx.profile, [source.kind], slot);
+  if (source.kind === "local") refuseProfileForLocal(ctx.profile, [source.kind], slot);
   return resolveSource(source, credential, { ...ctx.deps, cwd: ctx.deps?.cwd ?? process.cwd() }).catch((err) => {
     throw lookupRetry(err, slot);
   });
@@ -108,9 +108,9 @@ function lookupRetry(err, slot) {
   return err.withRerun(`xanosdk ${commandPath(slot.command, slot.subcommand)} \u2026`, " as you ran it");
 }
 function refuseProfileForLocal(profile, kinds, slot, flags = typedCredentialFlags()) {
-  if (kinds.some((k) => k !== "local-engine")) return;
-  const why = "and a local engine takes none \u2014 it is reached with the engine's own bearer.";
-  const or = slot === void 0 ? "or drop `--local-engine` to deploy to a hosted backend." : `or ${nameOne(slot, "a hosted backend", true)}.`;
+  if (kinds.some((k) => k !== "local")) return;
+  const why = "and a Xano Engine takes none \u2014 it is reached with the engine's own bearer.";
+  const or = slot === void 0 ? "or add `--ephemeral` to deploy to a hosted backend." : `or ${nameOne(slot, "a hosted backend", true)}.`;
   if (profile !== void 0) {
     throw new UsageError(`\`--profile ${profile}\` selects a Xano credential, ${why} Drop \`--profile\`, ${or}`, hintOpts(slot));
   }
@@ -118,7 +118,7 @@ function refuseProfileForLocal(profile, kinds, slot, flags = typedCredentialFlag
     throw new UsageError(`\`--config ${flags.authFile}\` names a Xano credential file, ${why} Drop \`--config\`, ${or}`, hintOpts(slot));
   }
   if (flags.local === true) {
-    throw new UsageError(`\`--local\` selects the project-local Xano credential file, ${why} Drop \`--local\`, ${or}`, hintOpts(slot));
+    throw new UsageError(`\`--local-auth\` selects the project-local Xano credential file, ${why} Drop \`--local-auth\`, ${or}`, hintOpts(slot));
   }
   if (flags.authHost !== void 0) {
     throw new UsageError(`\`--origin\` names a Xano sign-in server, ${why} ${ORIGIN_READ_ONLY_BY_REFRESH}`, hintOpts(slot));
@@ -141,15 +141,15 @@ function readTrackedBackend(opts) {
 function decide(facts, slot) {
   const { cwd, pointer, state, scope, engineRecorded } = facts;
   const ephemeralHere = scope !== void 0 && getEnvironment(state, scope) !== void 0;
-  if (pointer === "local-engine") {
-    return engineRecorded ? { kind: "local-engine", via: "pointer" } : { refusal: noEngineRecorded(slot) };
+  if (pointer === "local") {
+    return engineRecorded ? { kind: "local", via: "pointer" } : { refusal: noEngineRecorded(slot) };
   }
   if (pointer === "ephemeral") {
     if (scope === void 0) return { refusal: signedOut(slot, state) };
     return ephemeralHere ? { kind: "ephemeral", via: "pointer" } : { refusal: untracked(cwd, state, scope, slot, true) };
   }
   if (ephemeralHere) return { kind: "ephemeral", via: "fallback" };
-  if (engineRecorded) return { kind: "local-engine", via: "fallback" };
+  if (engineRecorded) return { kind: "local", via: "fallback" };
   if (scope !== void 0) return { refusal: untracked(cwd, state, scope, slot, false) };
   return { refusal: nothingTracked(cwd, slot, Object.keys(state.environments).length > 0, state) };
 }
@@ -173,7 +173,7 @@ function refuseUnservable(slot, kind) {
 }
 var KIND_PHRASE = {
   ephemeral: "an ephemeral",
-  "local-engine": "a local engine"
+  "local": "a Xano Engine"
 };
 function hintOpts(slot) {
   if (slot === void 0) return {};
@@ -184,7 +184,7 @@ function hintOpts(slot) {
 function nameOne(slot, what = "a backend", hostedOnly = false) {
   if (slot === void 0) return `name ${what} on the command explicitly`;
   const spellings = sourceSpellings(
-    hostedOnly ? slot.selector.accepted.filter((k) => k !== "local-engine" && k !== "file") : slot.selector.accepted
+    hostedOnly ? slot.selector.accepted.filter((k) => k !== "local" && k !== "file") : slot.selector.accepted
   );
   if (!slot.spelling.startsWith("--")) {
     const verb = slot.subcommand === void 0 ? slot.command : `${slot.command} ${slot.subcommand}`;
@@ -195,8 +195,8 @@ function nameOne(slot, what = "a backend", hostedOnly = false) {
 function bothDeploys(cwd) {
   const flags = contextFlags();
   const entry = cwd === void 0 ? "" : soleNestedEntry(cwd);
-  const hosted = /(^| )--local( |$)/.test(flags) ? "an ephemeral, with the project-local credential" : "an ephemeral";
-  return `\`xanosdk deploy${entry}${flags}\` (${hosted}) or \`xanosdk deploy${entry} --local-engine\` (a local engine on this machine)`;
+  const hosted = /(^| )--local-auth( |$)/.test(flags) ? "an ephemeral, with the project-local credential" : "an ephemeral";
+  return `\`xanosdk deploy${entry} --local\` (a Xano Engine on this machine) or \`xanosdk deploy${entry} --ephemeral${flags}\` (${hosted})`;
 }
 function untracked(cwd, state, scope, slot, pointer) {
   const other = otherCredentialRefusal(state, scope, `or ${nameOne(slot)}`, hintOpts(slot));
@@ -211,7 +211,7 @@ function untracked(cwd, state, scope, slot, pointer) {
       );
     }
     return new SourceError(
-      `This project last deployed to an ephemeral, but the last one is gone (deleted or expired). Run \`xanosdk deploy${contextFlags()}\` to create one \u2014 or \`xanosdk deploy --local-engine\` for a local engine \u2014 or ${nameOne(slot)}.`,
+      `This project last deployed to an ephemeral, but the last one is gone (deleted or expired). Run \`xanosdk deploy --ephemeral${contextFlags()}\` to create one \u2014 or \`xanosdk deploy --local\` for a Xano Engine \u2014 or ${nameOne(slot)}.`,
       "gone",
       "ephemeral"
     );
@@ -234,7 +234,7 @@ function nothingTracked(cwd, slot, ephemeralRecordedElsewhere, state) {
   const flags = state === void 0 ? void 0 : recordedCredentialFlags(state);
   const signIn = !ephemeralRecordedElsewhere ? "" : flags !== void 0 ? flags.env ? ` An ephemeral is recorded under ${flags.who} \u2014 set ${ENV_CREDENTIAL_VARS} for that workspace again to reach it.` : flags.signIn ? ` An ephemeral is recorded under ${flags.who}, which no credential file holds \u2014 add it again with ${flags.flags} to reach it.` : ` An ephemeral is recorded under ${flags.who}, and no credential is signed in \u2014 re-run with \`${flags.flags}\` to reach it.` : ` An ephemeral is recorded, but no credential is signed in to look it up \u2014 \`${runLogin()}\` reaches it.`;
   return new NothingTrackedError(
-    `This project has no backend to default to: it has not deployed to an ephemeral under this credential or to a local engine from this directory.${signIn} Deploy first with ${bothDeploys(cwd)}, or ${nameOne(slot)}.`,
+    `This project has no backend to default to: it has not deployed to an ephemeral under this credential or to a Xano Engine from this directory.${signIn} Deploy first with ${bothDeploys(cwd)}, or ${nameOne(slot)}.`,
     hintOpts(slot)
   );
 }
@@ -295,11 +295,11 @@ function nestedTrackedBackends(cwd) {
   return found;
 }
 function noEngineRecorded(slot) {
-  const named = slot === void 0 ? "name one on the command" : slot.spelling.startsWith("--") ? `name one with \`${slot.spelling} local-engine:<name>\`` : `name one: \`xanosdk ${slot.subcommand === void 0 ? slot.command : `${slot.command} ${slot.subcommand}`} local-engine:<name>\``;
+  const named = slot === void 0 ? "name one on the command" : slot.spelling.startsWith("--") ? `name one with \`${slot.spelling} local:<name>\`` : `name one: \`xanosdk ${slot.subcommand === void 0 ? slot.command : `${slot.command} ${slot.subcommand}`} local:<name>\``;
   return new SourceError(
-    `This project last deployed to a local engine, but no engine is recorded for this directory. Run \`xanosdk deploy --local-engine\` to stand one up, or \`xanosdk local-engine list\` to see what is running and ${named}. \`xanosdk deploy${contextFlags()}\` still deploys to an ephemeral.`,
+    `This project last deployed to a Xano Engine, but no engine is recorded for this directory. Run \`xanosdk deploy --local\` to stand one up, or \`xanosdk local list\` to see what is running and ${named}. \`xanosdk deploy --ephemeral${contextFlags()}\` still deploys to an ephemeral.`,
     "gone",
-    "local-engine"
+    "local"
   );
 }
 function signedOut(slot, state) {
@@ -368,4 +368,4 @@ export {
   NothingTrackedError,
   nestedBackendEntries
 };
-//# sourceMappingURL=chunk-LIVN53UV.js.map
+//# sourceMappingURL=chunk-I3VHW6XM.js.map