@xano/sdk 1.0.3 → 1.0.5

package/dist/{chunk-SBR2WZXG.js → chunk-XNZURZ7T.js}

@@ -21,7 +21,7 @@ import { randomBytes } from "crypto";
 import { AsyncLocalStorage } from "async_hooks";
 
 // src/emit/json-target.ts
-var BACKEND_KINDS = /* @__PURE__ */ new Set(["workspace", "ephemeral", "tenant", "local-engine"]);
+var BACKEND_KINDS = /* @__PURE__ */ new Set(["workspace", "ephemeral", "tenant", "local"]);
 var isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 var text = (v) => typeof v === "string" && v !== "" ? v : void 0;
 function backendSelector(kind, name) {
@@ -43,7 +43,7 @@ function derive(doc) {
     const kind = doc.deployed.kind;
     const env = isObject(doc.environment) ? doc.environment.name : void 0;
     if (kind === "ephemeral" && text(env) !== void 0) out.selector = `ephemeral:${env}`;
-    else if (kind === "local-engine") out.selector = "local-engine";
+    else if (kind === "local") out.selector = "local";
   }
   if (out.workspaceId === void 0 && isObject(doc.workspace) && typeof doc.workspace.id === "number") {
     out.workspaceId = doc.workspace.id;
@@ -604,11 +604,11 @@ function formatExpiration(expiresAt) {
   return `in ${hours}h ${minutes}m`;
 }
 function isLocalEngine(target) {
-  return "kind" in target && target.kind === "local-engine";
+  return "kind" in target && target.kind === "local";
 }
 function describeWriteTarget(target) {
   if (isLocalEngine(target)) {
-    return `local engine \xB7 ${hostLabel(target.url)} \xB7 workspace ${target.workspaceId}`;
+    return `Xano Engine \xB7 ${hostLabel(target.url)} \xB7 workspace ${target.workspaceId}`;
   }
   const where = `${hostLabel(target.base)} \xB7 workspace ${target.workspaceId}`;
   return target.label === void 0 || target.label === "" ? where : `${target.label} \u2014 ${where}`;
@@ -621,7 +621,7 @@ function credentialWriteTarget(binding) {
 }
 function writeTargetPayload(target) {
   if (isLocalEngine(target)) {
-    return { instance: target.url, workspaceId: target.workspaceId, kind: "local-engine", local: true };
+    return { instance: target.url, workspaceId: target.workspaceId, kind: "local", local: true };
   }
   return {
     instance: target.base,
@@ -1048,7 +1048,7 @@ function extraArguments(extras, target, max, attachedValueFlag) {
     }
   );
 }
-var BACKEND_HANDLE = /^(?:workspace|ephemeral|local-engine|tenant)(?::[^\s=]+)?$/;
+var BACKEND_HANDLE = /^(?:workspace|ephemeral|local|tenant)(?::[^\s=]+)?$/;
 function positionalSelectorHint(extra, target) {
   if (!BACKEND_HANDLE.test(extra)) return void 0;
   const own = selectorSpellings(target.command, target.subcommand);
@@ -1176,8 +1176,8 @@ function processExitCode(err) {
   return err instanceof Error && statesOutcomeUnknown(err.message) ? EXIT_OUTCOME_UNKNOWN : 1;
 }
 var MOVED_TO_TOP_LEVEL = /* @__PURE__ */ new Map([
-  ["tables", /* @__PURE__ */ new Set(["workspace", "ephemeral", "tenant", "local-engine"])],
-  ["impersonate", /* @__PURE__ */ new Set(["ephemeral", "tenant", "local-engine"])]
+  ["tables", /* @__PURE__ */ new Set(["workspace", "ephemeral", "tenant", "local"])],
+  ["impersonate", /* @__PURE__ */ new Set(["ephemeral", "tenant", "local"])]
 ]);
 function movedVerb(command, sub, positionals) {
   if (command === void 0 || sub === void 0 || MOVED_TO_TOP_LEVEL.get(sub)?.has(command) !== true) {
@@ -1257,9 +1257,12 @@ var PREFIXED = {
   release: "required",
   tenant: "required",
   ephemeral: "optional",
-  "local-engine": "optional"
+  "local": "optional"
 };
-var BARE = ["workspace", "ephemeral", "local-engine"];
+var BARE = ["workspace", "ephemeral", "local"];
+function kindNoun(kind) {
+  return kind === "local" ? "Xano Engine" : kind;
+}
 function isKindShaped(raw) {
   return /^[a-z][a-z-]*:/.test(raw);
 }
@@ -1269,8 +1272,8 @@ function spellingsOf(kind) {
       return ["workspace"];
     case "ephemeral":
       return ["ephemeral", "ephemeral:<name>"];
-    case "local-engine":
-      return ["local-engine", "local-engine:<name>"];
+    case "local":
+      return ["local", "local:<name>"];
     case "release":
       return ["release:<name>"];
     case "tenant":
@@ -1310,7 +1313,7 @@ function parseSource(raw, accepted, helpFor, noun = SOURCE_NOUN) {
       throw BARE.includes(kind) ? refuse(raw, accepted, helpFor, `takes no name \u2014 ${kind} names one thing`, noun) : refuse(raw, accepted, helpFor, `names no ${noun.singular} kind "${kind}"`, noun, keywordSuggestion(raw, accepted));
     }
     if (!accepted.includes(kind)) {
-      throw refuse(raw, accepted, helpFor, `names ${withArticle(kind.replace("-", " "))}, which this command does not take`, noun);
+      throw refuse(raw, accepted, helpFor, `names ${withArticle(kindNoun(kind))}, which this command does not take`, noun);
     }
     if (name === "") throw refuse(raw, accepted, helpFor, `names no ${kind}`, noun);
     return { kind, name };
@@ -1350,7 +1353,7 @@ function verbBackendName(raw, kind, helpFor, flags = "") {
   const other = shared && (typed === "tenant" || typed === "ephemeral") ? `xanosdk ${typed} ${helpFor.subcommand}` : void 0;
   const known = Object.hasOwn(PREFIXED, typed) || BARE.includes(typed);
   throw new UsageError(
-    `"${raw}" ${known ? `names ${withArticle(typed.replace("-", " "))}` : `names no backend kind "${typed}"`}, and \`${verb}\` takes ${withArticle(kind)} name (\`${kind}:<name>\` or the bare name).` + (other !== void 0 && name !== "" ? ` For ${withArticle(typed)}, run \`${other} ${shellQuote(name)}${flags}\`.` : ""),
+    `"${raw}" ${known ? `names ${withArticle(kindNoun(typed))}` : `names no backend kind "${typed}"`}, and \`${verb}\` takes ${withArticle(kind)} name (\`${kind}:<name>\` or the bare name).` + (other !== void 0 && name !== "" ? ` For ${withArticle(typed)}, run \`${other} ${shellQuote(name)}${flags}\`.` : ""),
     { hintFor: helpFor }
   );
 }
@@ -1414,9 +1417,13 @@ var FLAGS = {
   },
   "expires-hours": { spec: "--expires-hours <n>", summary: "Ephemeral TTL at create time, 1\u201324 (default: 1)" },
   static: { spec: "--static <dir>", summary: "Archive this built frontend and deploy it to the static host" },
-  "local-engine": {
-    spec: "--local-engine[=<version|url|path>]",
-    summary: "Deploy to an engine on this machine instead of an ephemeral. Bare: runs the project's pinned engine version (the latest on first run, then pinned in package.json \u2014 commit it); a newer engine is offered, never applied without a yes. A version, URL or archive path (or XANOSDK_LOCAL_ENGINE_OVERRIDE, for every run in a shell) runs that engine as an override and never touches the pin; a URL must be https (plain http only from this machine). Not combinable with --to or --static"
+  ephemeral: {
+    spec: "--ephemeral",
+    summary: "Deploy to a disposable ephemeral on Xano's cloud instead of the Xano Engine on this machine"
+  },
+  "local": {
+    spec: "--local[=<version|url|path>]",
+    summary: "Deploy to the Xano Engine on this machine \u2014 the default, so the flag is needed only to name an engine. Bare: runs the project's pinned engine version (the latest on first run, then pinned in package.json \u2014 commit it); a newer engine is offered, never applied without a yes. A version, URL or archive path (or XANOSDK_ENGINE_OVERRIDE, for every run in a shell) runs that engine as an override and never touches the pin; a URL must be https (plain http only from this machine). Not combinable with --to or --ephemeral"
   },
   // Keyed apart from the global `version` row: that one is the first-argument
   // `xanosdk --version`, this one a value an engine verb takes after the verb.
@@ -1506,7 +1513,7 @@ var FLAGS = {
     summary: "Xano OAuth host for `login` and a XANO_REFRESH_TOKEN exchange (default: $XANO_ORIGIN)"
   },
   config: { spec: "--config <path>", summary: "Explicit credential file (default: $XANO_CONFIG)" },
-  local: { spec: "--local", summary: "Use the project-local ./.xano/auth.json instead of the shared cache" },
+  "local-auth": { spec: "--local-auth", summary: "Use the project-local ./.xano/auth.json instead of the shared cache" },
   profile: {
     spec: "--profile, -p <name>",
     summary: "Commands that sign in: which stored credential profile to act as \u2014 the only thing that overrides this project's xano.profile.json (then $XANO_PROFILE, then the credential file default)"
@@ -1696,8 +1703,8 @@ var GLOBAL_FLAGS = [
   "help",
   "version"
 ];
-var AUTH = ["origin", "config", "local"];
-var CREDENTIAL_FILE = ["config", "local"];
+var AUTH = ["origin", "config", "local-auth"];
+var CREDENTIAL_FILE = ["config", "local-auth"];
 function isAuthenticatedCommand(command, subcommand) {
   return flagRefFor(command, subcommand, "config") !== void 0;
 }
@@ -1707,7 +1714,7 @@ function takesProfileFlag(command, subcommand) {
   return isAuthenticatedCommand(command, subcommand);
 }
 var CUT = ["workspace", "ephemeral", "tenant"];
-var BACKEND = ["workspace", "ephemeral", "local-engine", "tenant"];
+var BACKEND = ["workspace", "ephemeral", "local", "tenant"];
 var TEST_ON = {
   key: "on",
   summary: "Run on this backend instead of the one this project last deployed to",
@@ -1958,7 +1965,7 @@ var COMMANDS = {
   deploy: {
     group: "Deploy",
     display: "deploy [source]",
-    summary: "Ship to a live ephemeral env \u2192 URL",
+    summary: "Deploy to the Xano Engine on this machine (default) or an ephemeral (--ephemeral) \u2192 URL",
     // Optional: a bare `deploy` inside a project compiles its entry, and the
     // argument may name a backend to take the bytes FROM instead of a path.
     args: [
@@ -1978,8 +1985,8 @@ var COMMANDS = {
       ),
       {
         key: "to",
-        summary: "Merge into a real destination instead of replacing an ephemeral. The escape hatch from the release flow",
-        // An ephemeral and a local engine are where a deploy goes WITHOUT
+        summary: "Merge into a real destination instead of replacing the Xano Engine or an ephemeral. The escape hatch from the release flow",
+        // An ephemeral and a Xano Engine are where a deploy goes WITHOUT
         // `--to`; naming one here is the other path spelled wrong, and the
         // reason says which flag that path is.
         selector: {
@@ -1987,12 +1994,13 @@ var COMMANDS = {
           role: "to",
           default: "none",
           refused: {
-            "local-engine": "a deploy to a local engine is `--local-engine`, which also downloads, pins and starts one",
-            ephemeral: "a deploy with no `--to` already replaces an ephemeral. To merge into one instead, name it as the tenant it is: `--to tenant:<ephemeral name>`"
+            "local": "a deploy to a Xano Engine is `--local`, which also downloads, pins and starts one",
+            ephemeral: "`--ephemeral` already replaces an ephemeral. To merge into one instead, name it as the tenant it is: `--to tenant:<ephemeral name>`"
           }
         }
       },
-      "local-engine",
+      "local",
+      "ephemeral",
       withToOnly("dry-run"),
       withToOnly("prune"),
       withToOnly("reset-data"),
@@ -2101,7 +2109,7 @@ var COMMANDS = {
         args: [{ name: "name", required: true }],
         flags: [
           // A release is cut from something that RAN, so a path is not in the
-          // set, and the cut runs on the instance, so a local engine is refused
+          // set, and the cut runs on the instance, so a Xano Engine is refused
           // with that reason rather than left unknown.
           {
             key: "from",
@@ -2111,7 +2119,7 @@ var COMMANDS = {
               role: "from",
               default: "tracked",
               refused: {
-                "local-engine": "the cut runs on the instance, which cannot reach an engine on this machine"
+                "local": "the cut runs on the instance, which cannot reach an engine on this machine"
               }
             }
           },
@@ -2289,10 +2297,9 @@ var COMMANDS = {
         key: "to",
         summary: "Where to publish, instead of the backend this project last deployed to",
         selector: {
-          accepted: CUT,
+          accepted: BACKEND,
           role: "to",
-          default: "tracked",
-          refused: { "local-engine": "a local engine takes a frontend only through `xanosdk deploy --local-engine --static <dir>`" }
+          default: "tracked"
         }
       },
       "release",
@@ -2464,31 +2471,31 @@ var COMMANDS = {
       }
     }
   },
-  "local-engine": {
+  "local": {
     group: "Environments",
-    display: "local-engine",
-    // The handles that ship with `deploy --local-engine`: a local engine has no
+    display: "local",
+    // The handles that ship with `deploy --local`: a Xano Engine has no
     // TTL and nothing reclaims it, and its binary is never on `PATH`, so these
-    // verbs are the only way to see or stop one (`impersonate local-engine`
+    // verbs are the only way to see or stop one (`impersonate local`
     // opens one, like any other backend).
-    summary: "See, authenticate against and stop local engines on this machine; move the project's engine pin and manage cached engine versions",
+    summary: "See, authenticate against and stop Xano Engines on this machine; move the project's engine pin and manage cached engine versions",
     subcommands: {
       list: {
-        summary: "List local engines on this machine, marking the ones xanosdk started",
-        example: "xanosdk local-engine list"
+        summary: "List Xano Engines on this machine, marking the ones xanosdk started",
+        example: "xanosdk local list"
       },
       token: {
         // The engine's meta API accepts only its own bearer, and no summary
         // carries it — so this verb is the only way a suite gets one. Bare on
         // stdout even when piped, because `$(…)` is the form it exists for.
-        summary: "Print a local engine's meta API bearer \u2014 the local XANO_META_TOKEN; `--json` adds its url and workspace id. Re-run after a restart, which re-mints it (default: the engine this project deployed to)",
+        summary: "Print a Xano Engine's meta API bearer \u2014 the local XANO_META_TOKEN; `--json` adds its url and workspace id. Re-run after a restart, which re-mints it (default: the engine this project deployed to)",
         args: [{ name: "name", required: false }],
-        example: "XANO_META_TOKEN=$(xanosdk local-engine token)"
+        example: "XANO_META_TOKEN=$(xanosdk local token)"
       },
       stop: {
         // The name is optional because `--all` stands in for it — and `--all`
         // is the form most runs want, since it covers every project.
-        summary: "Stop one local engine by name, or every one xanosdk started on this machine",
+        summary: "Stop one Xano Engine by name, or every one xanosdk started on this machine",
         args: [{ name: "name", required: true, satisfiedBy: ["all"] }],
         flags: [
           {
@@ -2496,7 +2503,7 @@ var COMMANDS = {
             summary: "Every engine xanosdk started on this machine, across projects (foreign ones are reported, not stopped)"
           }
         ],
-        example: "xanosdk local-engine stop --all"
+        example: "xanosdk local stop --all"
       },
       update: {
         // Running it IS the confirmation, so it never prompts — the deploy only
@@ -2508,7 +2515,7 @@ var COMMANDS = {
             summary: "Pin this engine version instead of the latest, like v0.1.5 \u2014 or `latest`, the default"
           }
         ],
-        example: "xanosdk local-engine update"
+        example: "xanosdk local update"
       },
       cache: {
         // One verb with an action argument, not two top-level verbs: both act on
@@ -2526,7 +2533,7 @@ var COMMANDS = {
           },
           { key: "yes", summary: "Skip the `--legacy-runtime` confirmation (required when there is no terminal)" }
         ],
-        example: "xanosdk local-engine cache clear --version v0.1.5"
+        example: "xanosdk local cache clear --version v0.1.5"
       }
     }
   },
@@ -2593,7 +2600,7 @@ var COMMANDS = {
         name: "backend",
         required: false,
         selector: {
-          accepted: ["ephemeral", "local-engine", "tenant"],
+          accepted: ["ephemeral", "local", "tenant"],
           role: "subject",
           default: "tracked",
           refused: {
@@ -2614,9 +2621,9 @@ var COMMANDS = {
   login: {
     group: "Account",
     display: "login",
-    summary: "OAuth sign-in \u2014 shared cache, or --local per project",
+    summary: "OAuth sign-in \u2014 shared cache, or --local-auth per project",
     flags: [
-      "local",
+      "local-auth",
       "paste",
       "port",
       "scope",
@@ -2624,13 +2631,13 @@ var COMMANDS = {
       "config",
       { key: "force", summary: "Overwrite the cached credential \u2014 sign in again even when one is already there" }
     ],
-    example: "xanosdk login --local"
+    example: "xanosdk login --local-auth"
   },
   logout: {
     group: "Account",
     display: "logout",
     summary: "Revoke the active profile and remove it from the credential file",
-    flags: ["all", "yes", "local", "config"],
+    flags: ["all", "yes", "local-auth", "config"],
     example: "xanosdk logout --profile staging"
   },
   status: {
@@ -2823,7 +2830,7 @@ function flagSummary(ref) {
 function selectorValues(selector) {
   return SELECTOR_BARE.filter((k) => selector.accepted.includes(k));
 }
-var SELECTOR_BARE = ["workspace", "ephemeral", "local-engine"];
+var SELECTOR_BARE = ["workspace", "ephemeral", "local"];
 function argValues(arg) {
   if (arg.values !== void 0) return arg.values;
   return arg.selector !== void 0 ? selectorValues(arg.selector) : void 0;
@@ -3033,4 +3040,4 @@ export {
   movedVerb,
   installCliDiagnosticSink
 };
-//# sourceMappingURL=chunk-SBR2WZXG.js.map
+//# sourceMappingURL=chunk-XNZURZ7T.js.map

package/dist/{chunk-WFG67AYS.js → chunk-Y6NO3DLQ.js}

@@ -1,10 +1,10 @@
 import {
   questionOrCancel
-} from "./chunk-4APOHK7Y.js";
+} from "./chunk-AESE434J.js";
 import {
   style,
   terminalText
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-XNZURZ7T.js";
 
 // src/emit/plugin-prompt.ts
 import { createInterface } from "readline/promises";
@@ -54,4 +54,4 @@ export {
   promptPluginQuestion,
   pluginPrompter
 };
-//# sourceMappingURL=chunk-WFG67AYS.js.map
+//# sourceMappingURL=chunk-Y6NO3DLQ.js.map

package/dist/{chunk-37AHZ7JX.js → chunk-Y76ERHLK.js}

@@ -3,10 +3,10 @@ import {
 } from "./chunk-ROY4YAEQ.js";
 import {
   LocalFileNotFoundError
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-XNZURZ7T.js";
 import {
   buildContentEnvelope
-} from "./chunk-EESV6NU2.js";
+} from "./chunk-XJU6UAFV.js";
 import {
   SEED_FILE,
   assertSeedIds,
@@ -17,7 +17,7 @@ import {
   seedFailure,
   tableColumns,
   tableIndexes
-} from "./chunk-4PQHO74B.js";
+} from "./chunk-VZ22VUAS.js";
 import {
   DiagnosticError
 } from "./chunk-GPI3OWRE.js";
@@ -26,7 +26,7 @@ import {
   HOSTED_FILE_SCHEME,
   HOSTED_ROW_PATH_PREFIX,
   isHostedFile
-} from "./chunk-XNCP4KYO.js";
+} from "./chunk-VQPDATQT.js";
 import {
   resolveRef
 } from "./chunk-LL6ED5IB.js";
@@ -404,4 +404,4 @@ export {
   collectNonPublicSeedValues,
   seedRowsByTableGuid
 };
-//# sourceMappingURL=chunk-37AHZ7JX.js.map
+//# sourceMappingURL=chunk-Y76ERHLK.js.map

package/dist/{chunk-HHW5AWVD.js → chunk-YI76TURL.js}

@@ -6,43 +6,43 @@ import {
   startEngine,
   stopEngineNamed,
   stopOrphanedEngineProcesses
-} from "./chunk-O7QOWS6M.js";
+} from "./chunk-RXCT3OCU.js";
 import {
   RELEASE_VERSION,
   readEngineEntry,
   stageEngine,
   verifiedEngineExecutable
-} from "./chunk-D64XUF5Q.js";
+} from "./chunk-Z3SNX45M.js";
 import {
   sha256Hex
-} from "./chunk-NA3PXMEF.js";
+} from "./chunk-64WWE3EF.js";
 import {
   normalizeEngineVersion,
   resolveEngineRelease,
   usesCustomReleaseManager
-} from "./chunk-CYB7UQA2.js";
+} from "./chunk-JQOX6HW4.js";
 import {
   compareSemver,
   parseSemver
 } from "./chunk-2TFRR6JV.js";
 import {
   recordDeployed
-} from "./chunk-HSEQYBDO.js";
+} from "./chunk-HOOOOJJP.js";
 import {
   ImportHttpError
-} from "./chunk-MEE5RZ6G.js";
+} from "./chunk-5XVBT6CQ.js";
 import {
   engineNameForProject,
   getEngineRecord,
   setEngineRecord
-} from "./chunk-WL2DSNJV.js";
+} from "./chunk-Q22BMRPF.js";
 import {
   SUPPORTED_PLATFORMS,
   assertLoopbackUrl,
   expandArchivePath,
   isTrustedEngineUrl,
   resolveEnginePlatform
-} from "./chunk-AM4FKL4J.js";
+} from "./chunk-PL7AIAWS.js";
 import {
   registerSecret,
   tokenTextProblem
@@ -50,18 +50,18 @@ import {
 import {
   TransportError,
   fetchOrExplain
-} from "./chunk-MN2PB6WB.js";
+} from "./chunk-HLQH3AXB.js";
 import {
   readEnvVar
 } from "./chunk-X2NL4KUO.js";
 import {
   UsageError
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-XNZURZ7T.js";
 
 // src/deploy/local-engine-release.ts
 import { readFileSync } from "fs";
 import { gunzipSync } from "zlib";
-var LOCAL_ENGINE_TOKEN_ENV = "XANOSDK_LOCAL_ENGINE_TOKEN";
+var LOCAL_ENGINE_TOKEN_ENV = "XANOSDK_ENGINE_TOKEN";
 var MAX_ENGINE_BYTES = 256 * 1024 * 1024;
 var DOWNLOAD_TIMEOUT_MS = 6e5;
 var MAX_REDIRECTS = 5;
@@ -73,7 +73,7 @@ function displayDownloadUrl(url) {
     return "the engine download URL";
   }
 }
-var defaultFetch = (url, init) => fetchOrExplain(url, init, "The local engine download", DOWNLOAD_TIMEOUT_MS, displayDownloadUrl(url));
+var defaultFetch = (url, init) => fetchOrExplain(url, init, "The Xano Engine download", DOWNLOAD_TIMEOUT_MS, displayDownloadUrl(url));
 function isRedirect(status) {
   return status === 301 || status === 302 || status === 303 || status === 307 || status === 308;
 }
@@ -99,7 +99,7 @@ async function fetchFollowingRedirects(url, opts) {
   }
   throw new Error(
     `The engine download redirected more than ${MAX_REDIRECTS} times, so it was abandoned.
-` + (opts.release === void 0 ? `Check the URL passed to \`--local-engine\` addresses the artifact itself.` : `Re-run in a moment; if it keeps failing, engine ${opts.release}'s archive is unavailable \u2014 \`xanosdk local-engine update\` moves to another release.`)
+` + (opts.release === void 0 ? `Check the URL passed to \`--local\` addresses the artifact itself.` : `Re-run in a moment; if it keeps failing, engine ${opts.release}'s archive is unavailable \u2014 \`xanosdk local update\` moves to another release.`)
   );
 }
 function safeOrigin(url) {
@@ -114,7 +114,7 @@ function releaseDownloadRefusal(status, version) {
     status,
     new Error(
       `The download of engine ${version} failed (HTTP ${status}), so nothing was written.
-Re-run in a moment; if it keeps failing, that release's archive is unavailable \u2014 \`xanosdk local-engine update\` moves to another release.`
+Re-run in a moment; if it keeps failing, that release's archive is unavailable \u2014 \`xanosdk local update\` moves to another release.`
     )
   );
 }
@@ -126,7 +126,7 @@ function downloadRefusal(status, hasToken) {
   if (status === 404) {
     return new Error(
       `The engine download found nothing at that URL (HTTP 404 Not Found).
-Check the URL passed to \`--local-engine\` addresses the artifact` + (hasToken ? ` and that ${LOCAL_ENGINE_TOKEN_ENV} can read it` : `; if it is a private release, which also answers 404 without a credential, set ${LOCAL_ENGINE_TOKEN_ENV} to one that can read it`) + `, then re-run.`
+Check the URL passed to \`--local\` addresses the artifact` + (hasToken ? ` and that ${LOCAL_ENGINE_TOKEN_ENV} can read it` : `; if it is a private release, which also answers 404 without a credential, set ${LOCAL_ENGINE_TOKEN_ENV} to one that can read it`) + `, then re-run.`
     );
   }
   if (status === 401 || status === 403) {
@@ -140,13 +140,13 @@ Set ${LOCAL_ENGINE_TOKEN_ENV} to a credential that can read the release and re-r
       status,
       new Error(
         `The engine download failed (HTTP ${status}) \u2014 the server hosting it erred, so nothing was written.
-Re-run in a moment; if it keeps failing, check the URL passed to \`--local-engine\` is still served.`
+Re-run in a moment; if it keeps failing, check the URL passed to \`--local\` is still served.`
       )
     );
   }
   return new Error(
     `The engine download failed (HTTP ${status}).
-Check the URL passed to \`--local-engine\` still addresses the artifact` + (hasToken ? ` and that ${LOCAL_ENGINE_TOKEN_ENV} can read it` : ``) + `, then re-run.`
+Check the URL passed to \`--local\` still addresses the artifact` + (hasToken ? ` and that ${LOCAL_ENGINE_TOKEN_ENV} can read it` : ``) + `, then re-run.`
   );
 }
 function artifactName(url) {
@@ -212,7 +212,7 @@ function headerChecksumOk(block) {
 }
 var badArchive = (why, release) => new Error(
   `The engine archive ${why}.
-It is not the artifact this expects, so nothing was written. ` + (release === void 0 ? `Check the URL or path passed to \`--local-engine\` addresses the engine archive itself \u2014 a partial download, a login page and a release listing all save as ordinary files.` : `Engine ${release}'s published archive is unusable; \`xanosdk local-engine update\` moves to another release.`)
+It is not the artifact this expects, so nothing was written. ` + (release === void 0 ? `Check the URL or path passed to \`--local\` addresses the engine archive itself \u2014 a partial download, a login page and a release listing all save as ordinary files.` : `Engine ${release}'s published archive is unusable; \`xanosdk local update\` moves to another release.`)
 );
 function extractEngineExecutable(archive, opts = {}) {
   const maxBytes = opts.maxBytes ?? MAX_ENGINE_BYTES;
@@ -267,7 +267,7 @@ function readArchiveFile(path) {
   } catch {
     throw new Error(
       `There is no engine archive to read at ${path}.
-Check the path \u2014 it is read exactly as passed to \`--local-engine\`, with \`~\` and relative paths resolved from where the command ran.`
+Check the path \u2014 it is read exactly as passed to \`--local\`, with \`~\` and relative paths resolved from where the command ran.`
     );
   }
 }
@@ -294,8 +294,8 @@ async function acquireEngineUnclassified(opts) {
   const platform = resolveEnginePlatform(opts.platform ?? process.platform, opts.arch ?? process.arch);
   if (platform === void 0) {
     throw new Error(
-      `There is no local engine build for ${opts.platform ?? process.platform} ${opts.arch ?? process.arch} \u2014 it runs on ${SUPPORTED_PLATFORMS.join(", ")} and nothing else.
-Deploy from one of those machines, or drop \`--local-engine\`: \`xanosdk deploy\` reaches an ephemeral from anywhere.`
+      `There is no Xano Engine build for ${opts.platform ?? process.platform} ${opts.arch ?? process.arch} \u2014 it runs on ${SUPPORTED_PLATFORMS.join(", ")} and nothing else.
+Deploy from one of those machines, or drop \`--local\`: \`xanosdk deploy\` reaches an ephemeral from anywhere.`
     );
   }
   if (opts.spec.kind === "release") {
@@ -438,7 +438,7 @@ async function ensureProjectEngine(opts) {
     throw withDeployFallbackNote(err);
   }
 }
-var DEPLOY_FALLBACK_NOTE = "Meanwhile `xanosdk deploy` still deploys to an ephemeral.";
+var DEPLOY_FALLBACK_NOTE = "Meanwhile `xanosdk deploy --ephemeral` still deploys to an ephemeral.";
 function withDeployFallbackNote(err) {
   if (!(err instanceof Error) || err.message.includes(DEPLOY_FALLBACK_NOTE)) return err;
   err.message = `${err.message.trimEnd()}
@@ -472,7 +472,7 @@ async function ensureProjectEngineUnnoted(opts) {
   const priorFilled = record?.filled;
   const carry = opts.carryFilled?.({ reused, hadRecord, priorFilled, url: engine.url }) === true;
   writeRecord(opts.dir, engine, entry, shownVersion, reused && carry ? priorFilled : void 0, env);
-  if (!reused) recordDeployed(opts.dir, "local-engine");
+  if (!reused) recordDeployed(opts.dir, "local");
   return {
     engine,
     reused,
@@ -550,8 +550,8 @@ function stopMismatched(name, record, entry, env, run) {
   const previous = recordedBinary(record, env);
   if (previous !== void 0 && previous.digest !== entry.digest && attempt(previous)) return;
   throw new Error(
-    `The local engine "${name}" already serving this project is not the engine this deploy resolved to, and it could not be stopped` + (previous === void 0 ? `` : ` by either engine version`) + `.
-Stop it with \`xanosdk local-engine stop ${name}\` (or end the process), then deploy again.`
+    `The Xano Engine "${name}" already serving this project is not the engine this deploy resolved to, and it could not be stopped` + (previous === void 0 ? `` : ` by either engine version`) + `.
+Stop it with \`xanosdk local stop ${name}\` (or end the process), then deploy again.`
   );
 }
 function recordedBinary(record, env) {
@@ -576,22 +576,22 @@ function reuseCandidate(name, record, running) {
 }
 function explainUnsupportedEngineImport(err, engineVersion2, ctx = {}) {
   if (!(err instanceof ImportHttpError) || err.status !== 501) return void 0;
-  const which = engineVersion2 === void 0 ? "The local engine" : `Local engine ${engineVersion2}`;
+  const which = engineVersion2 === void 0 ? "The Xano Engine" : `Xano Engine ${engineVersion2}`;
   const newer = newerRelease(engineVersion2, ctx.latest);
   if (newer !== void 0) {
     return new Error(
-      `${which} does not support this import (HTTP 501): it is older than this SDK needs. Nothing was written. Deploy with ${newer} \u2014 \`xanosdk local-engine update\` moves this project's pin to it, or pass \`--local-engine=${newer}\` for one deploy.`,
+      `${which} does not support this import (HTTP 501): it is older than this SDK needs. Nothing was written. Deploy with ${newer} \u2014 \`xanosdk local update\` moves this project's pin to it, or pass \`--local=${newer}\` for one deploy.`,
       { cause: err }
     );
   }
   if (ctx.resetRerun !== void 0) {
     return new Error(
-      `${which} cannot apply this merge (HTTP 501): keeping the rows through this schema change is not available on the local engine yet. Nothing was written. Deploy with \`${ctx.resetRerun}\` instead \u2014 it replaces the workspace and writes every table's seed rows, so rows entered since the last deploy are lost.`,
+      `${which} cannot apply this merge (HTTP 501): keeping the rows through this schema change is not available on the Xano Engine yet. Nothing was written. Deploy with \`${ctx.resetRerun}\` instead \u2014 it replaces the workspace and writes every table's seed rows, so rows entered since the last deploy are lost.`,
       { cause: err }
     );
   }
   return new Error(
-    `${which} does not support this import (HTTP 501). Nothing was written. \`xanosdk deploy\` deploys to an ephemeral meanwhile.`,
+    `${which} does not support this import (HTTP 501). Nothing was written. \`xanosdk deploy --ephemeral\` deploys to an ephemeral meanwhile.`,
     { cause: err }
   );
 }
@@ -609,4 +609,4 @@ export {
   restartMismatchedEngine,
   explainUnsupportedEngineImport
 };
-//# sourceMappingURL=chunk-HHW5AWVD.js.map
+//# sourceMappingURL=chunk-YI76TURL.js.map