@xano/sdk 1.0.4 → 1.0.6

package/dist/{chunk-HUSH7LRI.js → chunk-LL7SGTRC.js}

@@ -1,6 +1,6 @@
 import {
   classifyNpmFailure
-} from "./chunk-ZG7E72VI.js";
+} from "./chunk-YYC2DZMG.js";
 import {
   condenseNpmError,
   runNpmQuiet,
@@ -8,17 +8,18 @@ import {
 } from "./chunk-ZFDZKNGG.js";
 import {
   detectInstallRoot
-} from "./chunk-WRBKLYSJ.js";
+} from "./chunk-DNBP4GJN.js";
 import {
   decodeDigest,
   reactPreset
-} from "./chunk-UCQ2VUTG.js";
+} from "./chunk-M6ZFSTIZ.js";
 import {
   blockVersion,
   composeBlock,
   findBlock,
+  htmlDialect,
   upsertBlock
-} from "./chunk-DGWHAVRG.js";
+} from "./chunk-3EDSPMXN.js";
 import {
   detail,
   projectFileCli,
@@ -28,7 +29,7 @@ import {
   success,
   warn,
   withSpinner
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-D7BUMOKU.js";
 import {
   defaultThemeChoice,
   themeGuidanceSection
@@ -58,6 +59,8 @@ The published types and JSDoc (\`node_modules/@xano/sdk/**/*.d.ts\`) are that
 same surface with the compiler attached. Author against those signatures. Do
 **not** invent an API that isn't there \u2014 if the types don't offer something,
 make your best typed guess from the exported signatures and note the gap.`;
+var README_GUIDANCE = `- \`README.md\` \u2014 for a visitor to the repository: what the app does, how to run it, and
+  what it is built on. Its \`## Built with\` footer is a managed block this SDK refreshes.`;
 var LOCK_GUIDANCE = `Object identity derives from \`(type, name)\`, so a rename
 changes an object's guid and the engine DELETES and recreates it rather than
 renaming in place. \`xano/xano.lock\` freezes each guid and each API group's
@@ -98,14 +101,14 @@ backend reads with \`env("NAME")\`; the VALUES live in \`xano/.env\`, which is g
 - On Windows there is no ACL equivalent to the 0600 the file is created with, the
   same exposure \`.xano/auth.json\` already carries.`;
 var BACKENDS_GUIDANCE = `- A bare command (\`npm run xano:test\`, \`npx xanosdk env set\`, \`npx xanosdk tables\`,
-  \`npx xanosdk impersonate\`) reaches the ephemeral or local engine this project last
+  \`npx xanosdk impersonate\`) reaches the ephemeral or Xano Engine this project last
   deployed to, never the workspace; the grammar that names another is **Backends**
-  in \`node_modules/@xano/sdk/llms.txt\`. After a local-engine deploy, which
-  \`publish\` does not reach and which cannot be released from, publish with
-  \`npm run xano:deploy:frontend -- --to ephemeral\` (or add \`--static <dir>\` to the
-  local deploy to have the engine serve the build) and cut with
+  in \`node_modules/@xano/sdk/llms.txt\`. After a local deploy,
+  \`npm run xano:deploy:frontend\` publishes the build to the engine. A Xano Engine
+  cannot be released from, so stand the code up with \`npm run xano:deploy:ephemeral\`
+  and cut with
   \`npx xanosdk release create <name> --from ephemeral\`.
-- \`npm run xano:deploy:local-engine\` and every bare command after it need no Xano
+- \`npm run xano:deploy\` and every bare command after it need no Xano
   account \u2014 the local loop runs without \`npx xanosdk login\`.
 - \`npx xanosdk impersonate\` prints a session URL: treat it as a credential. \`--guest\`
   opens a read-only look.`;
@@ -149,9 +152,10 @@ ${LEARN_FROM_THE_LIBRARY}
 
 \`frontend/src/lib/api.ts\` takes request paths from \`xano/routes.gen.ts\`
 (\`routePath("GET notes/{id}", { id })\`), generated from the query defs by
-\`npm run xano:routes\` and regenerated by dev, build and typecheck, and takes
-request/response types from the defs with \`import type\` (\`InferInput\` /
-\`InferResponse\`). Never hand-type a URL or a request body, and never import a
+\`npm run xano:routes\` and regenerated by dev, build and typecheck. Request types
+come from the same file (\`RouteInputs["POST create_note"]\`, \`MessageInputs\` for
+realtime); response types from the defs with \`import type\` (\`InferResponse\`).
+Never hand-type a URL or a request body, and never import a
 def as a value in the frontend: its \`getPath()\` drags the backend into the bundle.
 
 ### Layout
@@ -160,6 +164,7 @@ def as a value in the frontend: its \`getPath()\` drags the backend into the bun
   groups, and endpoints. Pin each API group's canonical slug so public paths are
   stable and \`xano:routes\` resolves without a lock file.
 - \`xano/EXAMPLE.md\` \u2014 the walkthrough for adding your first table + endpoint.
+${README_GUIDANCE}
 ${frontendSection(frontend)}
 
 ### Workflow
@@ -167,8 +172,10 @@ ${frontendSection(frontend)}
 - \`npm run dev\` \u2014 run the frontend.
 - \`npm run typecheck\` / \`npm run build\` \u2014 must stay green.
 - \`npm run xano:export\` \u2014 compile the backend to \`workspace.json\` (never commit it).
-- \`npx xanosdk login\` then \`npm run xano:deploy\` \u2014 ship the backend + static
-  frontend to a disposable **ephemeral** environment.
+- \`npm run xano:deploy\` \u2014 deploy the backend to the Xano Engine on this machine
+  (no account needed; redeploys keep the rows). Run it after every backend change.
+- \`npx xanosdk login\` then \`npm run xano:deploy:ephemeral\` \u2014 ship the backend +
+  static frontend to a disposable **ephemeral** environment on Xano's cloud.
 - \`npm run xano:test\` \u2014 run the DEPLOYED environment's unit + workflow tests
   (exits 5 on a failure). See "Testing" below.
 ${BACKENDS_GUIDANCE}
@@ -182,7 +189,7 @@ ${ENV_GUIDANCE}
 A deploy targets a throwaway environment. Reaching a real one goes through a
 **release** \u2014 the stored record that code came up and answered:
 
-1. \`npm run xano:deploy\` \u2014 stand the current code up on an ephemeral.
+1. \`npm run xano:deploy:ephemeral\` \u2014 stand the current code up on an ephemeral.
 2. \`npx xanosdk release create <name>\` \u2014 cut a release from it. An existing name is
    refused; cut a new one.
 3. \`npx xanosdk promote <name>\` \u2014 land it in the workspace, or
@@ -247,9 +254,10 @@ drive a Xano workspace from code.
   re-running \`init --from\`) refreshes it from a backend: it lists what will change
   and asks first, keeps files you added, and overwrites the files it decodes. Commit
   before refreshing, so an overwritten edit is still in git.
-- **\`npx xanosdk deploy\` is a full replace** of a disposable **ephemeral** environment
-  (\`npm run xano:deploy\`), unless \`--keep-data\` merges into the one an earlier
-  deploy filled. A real workspace is reached with \`npx xanosdk promote <release>\` or
+- **\`npx xanosdk deploy\` is a full replace** of a Xano Engine or a disposable
+  **ephemeral** environment (\`npm run xano:deploy:ephemeral\`), unless \`--keep-data\`
+  merges into the one an earlier deploy filled (\`npm run xano:deploy\` passes it). A
+  real workspace is reached with \`npx xanosdk promote <release>\` or
   \`deploy --to workspace\`, which merge and leave table rows alone.
 
 Read \`xano/README.md\` first: it is the generated record of what did and did not
@@ -261,8 +269,9 @@ ${LEARN_FROM_THE_LIBRARY}
 
 \`frontend/src/lib/api.ts\` takes request paths from \`xano/routes.gen.ts\`
 (\`routePath("GET notes/{id}", { id })\`), generated from the query defs in
-\`xano/\` by \`npm run xano:routes\`, and request/response types from the defs with
-\`import type\` (\`InferInput\` / \`InferResponse\`). Never hand-type a URL or a
+\`xano/\` by \`npm run xano:routes\`. Request types come from the same file
+(\`RouteInputs["<VERB> <name>"]\`, \`MessageInputs\` for realtime); response types
+from the defs with \`import type\` (\`InferResponse\`). Never hand-type a URL or a
 request body, and never import a def as a value in the frontend.
 
 ### Layout
@@ -270,6 +279,7 @@ request body, and never import a def as a value in the frontend.
 - \`xano/index.ts\` \u2014 the barrel: default-exports the \`workspace()\` with every pulled object registered.
 - \`xano/<kind>/<name>.ts\` \u2014 one file per object (tables in \`xano/table/\`); \`xano/_shared.ts\` \u2014 anything else referenced from more than one file.
 - \`xano/README.md\` \u2014 the decode report for this pull.
+${README_GUIDANCE}
 ${frontendSection(frontend)}
 
 ### Workflow
@@ -277,7 +287,8 @@ ${frontendSection(frontend)}
 - \`npm run dev\` \u2014 run the frontend.
 - \`npm run typecheck\` / \`npm run build\` \u2014 must stay green.
 - \`npm run xano:export\` \u2014 compile the backend to \`workspace.json\` (never commit it).
-- \`npx xanosdk login\` then \`npm run xano:deploy\` \u2014 ship the backend + static frontend to an ephemeral env.
+- \`npm run xano:deploy\` \u2014 deploy the backend to the Xano Engine on this machine (no account needed).
+- \`npx xanosdk login\` then \`npm run xano:deploy:ephemeral\` \u2014 ship the backend + static frontend to an ephemeral env.
 - \`npx xanosdk release create <name>\` then \`npx xanosdk promote <name>\` \u2014 the path to a real workspace.
 - \`npx xanosdk pull [source]\` \u2014 refresh \`xano/\` from a live backend; it REPLACES the directory.
 - \`npm run xano:test\` \u2014 run the DEPLOYED environment's unit + workflow tests (exits 5 on a failure). See "Testing" below.
@@ -302,15 +313,7 @@ Other \`@xano-sdk/*\` packages register onto the same workspace \u2014 but a
 composing them from a module outside \`xano/\`.
 `;
 }
-var BLOCK_BEGIN = "<!-- BEGIN:xanosdk-agent-rules -->";
-var BLOCK_END = "<!-- END:xanosdk-agent-rules -->";
-var AGENT_DIALECT = {
-  begin: () => BLOCK_BEGIN,
-  end: () => BLOCK_END,
-  stamp: (version) => `<!-- xanosdk ${version} \u2014 generated; edits inside this block are overwritten -->`,
-  parseStamp: (block) => /<!-- xanosdk ([^\s]+) — generated/.exec(block)?.[1] ?? null
-};
-var AGENT_BLOCK = { dialect: AGENT_DIALECT, pkg: "xanosdk-agent-rules" };
+var AGENT_BLOCK = { dialect: htmlDialect("xanosdk-agent-rules"), pkg: "xanosdk-agent-rules" };
 function managedBlock(body, version) {
   return composeBlock(AGENT_BLOCK, [body], version);
 }
@@ -657,4 +660,4 @@ export {
   changedOnDisk,
   scaffoldProject
 };
-//# sourceMappingURL=chunk-HUSH7LRI.js.map
+//# sourceMappingURL=chunk-LL7SGTRC.js.map

package/dist/{chunk-I2BGYNHD.js → chunk-M5CSVB23.js}

@@ -12,11 +12,11 @@ import {
   httpFailure,
   isTimeoutError,
   statusLabel
-} from "./chunk-MN2PB6WB.js";
+} from "./chunk-YR2I5HGE.js";
 import {
   pointerRootFor,
   resolveProjectProfile
-} from "./chunk-FPBGAT5D.js";
+} from "./chunk-26MOFAJT.js";
 import {
   atomicWrite,
   linkTarget
@@ -24,13 +24,13 @@ import {
 import {
   DEFAULT_PROFILE,
   resolveActiveProfile
-} from "./chunk-QXTKSOFI.js";
+} from "./chunk-MF4W6FHU.js";
 import {
   readEnvVar
 } from "./chunk-X2NL4KUO.js";
 import {
   UsageError
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-D7BUMOKU.js";
 import {
   shellQuote
 } from "./chunk-5ZSO4T2G.js";
@@ -450,7 +450,7 @@ function resolveAuthFilePath(args, mode = "read") {
   if (explicit !== void 0 && args.local && resolve(explicit) !== localAuthFilePath()) {
     const named = args.authFile !== void 0 ? `\`--config ${explicit}\`` : `XANO_CONFIG=${explicit}`;
     throw new UsageError(
-      `\`--local\` selects the project-local .xano/auth.json and ${named} names another credential file \u2014 they cannot both be the one this command uses. Drop \`--local\`` + (args.authFile !== void 0 ? `, or drop \`--config\`.` : `, or unset XANO_CONFIG.`)
+      `\`--local-auth\` selects the project-local .xano/auth.json and ${named} names another credential file \u2014 they cannot both be the one this command uses. Drop \`--local-auth\`` + (args.authFile !== void 0 ? `, or drop \`--config\`.` : `, or unset XANO_CONFIG.`)
     );
   }
   if (explicit !== void 0) {
@@ -698,7 +698,7 @@ function credentialFileFlag(path) {
     return abs === resolve(byEnv) ? "" : ` --config ${shellQuote(abs)}`;
   }
   if (abs === resolve(globalAuthFilePath())) return "";
-  if (abs === localAuthFilePath()) return " --local";
+  if (abs === localAuthFilePath()) return " --local-auth";
   return ` --config ${shellQuote(abs)}`;
 }
 function loginCommand(profile, target = {}, extra = []) {
@@ -1189,4 +1189,4 @@ export {
   addGitignoreRule,
   gitSaysIgnored
 };
-//# sourceMappingURL=chunk-I2BGYNHD.js.map
+//# sourceMappingURL=chunk-M5CSVB23.js.map

package/dist/{chunk-UCQ2VUTG.js → chunk-M6ZFSTIZ.js}

@@ -160,7 +160,7 @@ function decodeMarkerWith(previous, files) {
     digests: Object.fromEntries(sorted.map((f) => [f.path, decodeDigest(f.content)]))
   };
 }
-var SOURCE_KINDS = /* @__PURE__ */ new Set(["workspace", "ephemeral", "local-engine", "tenant", "release"]);
+var SOURCE_KINDS = /* @__PURE__ */ new Set(["workspace", "ephemeral", "local", "tenant", "release"]);
 function decodeMarkerHead(previous, command, provenance, sdkVersion, report) {
   const colon = provenance.indexOf(":");
   const kind = colon === -1 ? provenance : provenance.slice(0, colon);
@@ -627,4 +627,4 @@ export {
   decodeMarkerWith,
   decodeMarkerHead
 };
-//# sourceMappingURL=chunk-UCQ2VUTG.js.map
+//# sourceMappingURL=chunk-M6ZFSTIZ.js.map

package/dist/{chunk-MNVDVR3M.js → chunk-MBDFH7XB.js}

@@ -3,17 +3,17 @@ import {
   listAnswer,
   notTheAnswer,
   writeTransportFailure
-} from "./chunk-CFSFBKHP.js";
+} from "./chunk-7GAIJW62.js";
 import {
   SENT_AFTERMATH,
   fetchOrExplain,
   readBodyText,
   safeHttpFailure,
   withWriteStatusAftermath
-} from "./chunk-MN2PB6WB.js";
+} from "./chunk-YR2I5HGE.js";
 import {
   isNonPublicColumn
-} from "./chunk-4PQHO74B.js";
+} from "./chunk-SLGJIWCY.js";
 
 // src/deploy/table.ts
 var TIMEOUT_MS = 3e4;
@@ -184,4 +184,4 @@ export {
   truncateTable,
   insertTableRows
 };
-//# sourceMappingURL=chunk-MNVDVR3M.js.map
+//# sourceMappingURL=chunk-MBDFH7XB.js.map

package/dist/{chunk-QXTKSOFI.js → chunk-MF4W6FHU.js}

@@ -73,4 +73,4 @@ export {
   assertValidProfileName,
   selectionDocument
 };
-//# sourceMappingURL=chunk-QXTKSOFI.js.map
+//# sourceMappingURL=chunk-MF4W6FHU.js.map

package/dist/{chunk-RX3EMQGN.js → chunk-MFWF2NZJ.js}

@@ -1,7 +1,8 @@
 import {
   LOCK_PAYLOAD_KEYS,
-  lockKey
-} from "./chunk-OOGXZL7Z.js";
+  lockKey,
+  withSyncedOf
+} from "./chunk-5KJBWIDZ.js";
 
 // src/lock/landed.ts
 function destinationKey(instance, dest) {
@@ -82,7 +83,10 @@ function applyLanding(lock, destKey, update) {
   if (Object.keys(next).length > 0) landed[destKey] = next;
   else delete landed[destKey];
   const objects = withoutPrunedObjects(lock.objects, update);
-  return Object.keys(landed).length > 0 ? { version: lock.version, objects, landed } : { version: lock.version, objects };
+  return withSyncedOf(
+    Object.keys(landed).length > 0 ? { version: lock.version, objects, landed } : { version: lock.version, objects },
+    lock
+  );
 }
 function withoutPrunedObjects(objects, update) {
   const drop = Object.entries(update.removed ?? {}).filter(
@@ -131,7 +135,10 @@ function withStoredColumns(identities, stored) {
 function withoutLanding(lock, destKey) {
   if (lock.landed?.[destKey] === void 0) return lock;
   const { [destKey]: _dropped, ...landed } = lock.landed;
-  return Object.keys(landed).length > 0 ? { version: lock.version, objects: lock.objects, landed } : { version: lock.version, objects: lock.objects };
+  return withSyncedOf(
+    Object.keys(landed).length > 0 ? { version: lock.version, objects: lock.objects, landed } : { version: lock.version, objects: lock.objects },
+    lock
+  );
 }
 function landedOn(lock, destKey) {
   const record = lock.landed?.[destKey];
@@ -153,4 +160,4 @@ export {
   withoutLanding,
   landedOn
 };
-//# sourceMappingURL=chunk-RX3EMQGN.js.map
+//# sourceMappingURL=chunk-MFWF2NZJ.js.map

package/dist/{chunk-SEUCZZCP.js → chunk-N5I37JFB.js}

@@ -3,7 +3,7 @@ import {
   recordedCredentialFile,
   recordedCredentialPath,
   resolveAuthFilePath
-} from "./chunk-I2BGYNHD.js";
+} from "./chunk-M5CSVB23.js";
 import {
   readEnvVar
 } from "./chunk-X2NL4KUO.js";
@@ -43,7 +43,7 @@ function contextFlags(args = ambient, opts = {}) {
   try {
     file = credentialFileFlag(resolveAuthFilePath(args));
   } catch {
-    file = args.local ? " --local" : args.authFile !== void 0 ? ` --config ${shellQuote(args.authFile)}` : "";
+    file = args.local ? " --local-auth" : args.authFile !== void 0 ? ` --config ${shellQuote(args.authFile)}` : "";
   }
   const profile = args.profile !== void 0 && args.profile !== "" ? ` --profile ${shellQuote(args.profile)}` : "";
   return `${profile}${file}`;
@@ -73,4 +73,4 @@ export {
   ENV_CREDENTIAL_VARS,
   recordedByEnvCredential
 };
-//# sourceMappingURL=chunk-SEUCZZCP.js.map
+//# sourceMappingURL=chunk-N5I37JFB.js.map

package/dist/{chunk-IJ3SXSZM.js → chunk-ND43ZOS3.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-X4DVXBFY.js";
 import {
   ImportHttpError
-} from "./chunk-MEE5RZ6G.js";
+} from "./chunk-BL3AZ3AP.js";
 import {
   describeWrite
 } from "./chunk-4KHEMC32.js";
@@ -26,16 +26,16 @@ import {
   statusLabel,
   transportTarget,
   writeStatusAftermath
-} from "./chunk-MN2PB6WB.js";
+} from "./chunk-YR2I5HGE.js";
 import {
   calcSignatureJson,
   signatureHolds
-} from "./chunk-EESV6NU2.js";
+} from "./chunk-7FIMUFBP.js";
 import {
   HOSTED_FILE_SCHEME,
   HOSTED_ICON_KINDS,
   HOSTED_ROW_PATH_PREFIX
-} from "./chunk-XNCP4KYO.js";
+} from "./chunk-VQPDATQT.js";
 
 // src/deploy/xanosdk-import.ts
 var IMPORT_TIMEOUT_MS = 12e4;
@@ -461,7 +461,7 @@ async function post(auth, url, opts, action) {
   const aftermath = !writes ? `A dry run writes nothing, so ${target} is untouched. Retry when the instance is reachable.` : opts.mode === "replace" ? `The request did not complete, so the import may or may not have landed, in whole or in part. A replace rewrites all of ${target}, so it is safe to run again once the instance is reachable.` : `The request did not complete, so the import may or may not have landed, in whole or in part.` + (opts.stateCheck !== void 0 ? ` ${opts.stateCheck}` : "");
   const where = `${transportTarget(url)}${opts.label !== void 0 ? ` (${opts.label})` : ""}`;
   if (res === void 0) {
-    const { classifyFailure } = await import("./operation-outcome-2P4BVSEV.js");
+    const { classifyFailure } = await import("./operation-outcome-RN62735X.js");
     if (writes && !isTimeoutError(failure) && classifyFailure(failure, { writeSent: true }) === "no") {
       const untrusted = certificateFailureCode(failure) !== void 0;
       throw new ImportNotSentError(
@@ -557,4 +557,4 @@ export {
   withDefaultBranchPointer,
   xanosdkImport
 };
-//# sourceMappingURL=chunk-IJ3SXSZM.js.map
+//# sourceMappingURL=chunk-ND43ZOS3.js.map

package/dist/chunk-NDWVJ2QZ.js

@@ -0,0 +1,67 @@
+import {
+  findBranch,
+  listBranches,
+  liveBranchLabel
+} from "./chunk-NPODGBVJ.js";
+import {
+  readLockFile,
+  recordSyncInLockFile,
+  syncedOn
+} from "./chunk-CJDPSCMX.js";
+import {
+  destinationKey
+} from "./chunk-MFWF2NZJ.js";
+import {
+  displayPath,
+  info,
+  warn
+} from "./chunk-D7BUMOKU.js";
+
+// src/emit/sync-record.ts
+import { existsSync } from "fs";
+function readSyncBaseline(lockPath, target) {
+  if (lockPath === void 0 || !existsSync(lockPath)) return void 0;
+  try {
+    const key = destinationKey(target.instance, { kind: "workspace", workspaceId: target.workspaceId });
+    return syncedOn(readLockFile(lockPath), key, target.branch);
+  } catch {
+    return void 0;
+  }
+}
+function recordSync(opts) {
+  if (opts.lockPath === void 0) return null;
+  const destination = destinationKey(opts.target.instance, { kind: "workspace", workspaceId: opts.target.workspaceId });
+  const shown = displayPath(opts.lockPath);
+  let result;
+  try {
+    result = recordSyncInLockFile(opts.lockPath, destination, opts.target.branch, { digests: opts.digests, by: opts.by, complete: opts.complete });
+  } catch (err) {
+    warn(
+      `The ${opts.by} succeeded, but its sync baseline could not be recorded in ${shown}: ${err instanceof Error ? err.message : String(err)}`,
+      "sync.record-failed",
+      ["`xanosdk workspace diff` reads the older baseline, so it may say the wrong side changed until the next deploy or pull records one."]
+    );
+    return null;
+  }
+  if (result === void 0) return null;
+  if (result.changed) {
+    info(`Recorded the sync baseline for branch "${opts.target.branch}" in ${shown}. Commit it: \`workspace diff\` reads it to say which side changed.`);
+  }
+  return { destination, branch: opts.target.branch, file: shown, objects: Object.keys(opts.digests.objects).length, changed: result.changed };
+}
+function storedBranchLabel(branches, typed) {
+  if (typed !== void 0) return (branches === void 0 ? void 0 : findBranch(branches, typed)?.label) ?? typed.trim();
+  return branches === void 0 ? void 0 : liveBranchLabel(branches);
+}
+async function syncBranchLabel(auth, typed) {
+  const branches = await listBranches(auth, { baseUrl: auth.instance, workspaceId: auth.workspaceId }).catch(() => void 0);
+  return storedBranchLabel(branches, typed);
+}
+
+export {
+  readSyncBaseline,
+  recordSync,
+  storedBranchLabel,
+  syncBranchLabel
+};
+//# sourceMappingURL=chunk-NDWVJ2QZ.js.map

package/dist/{chunk-E65QIWOO.js → chunk-NPODGBVJ.js}

@@ -3,10 +3,10 @@ import {
 } from "./chunk-2MNLRIOX.js";
 import {
   pipedYes
-} from "./chunk-FMOEVAGT.js";
+} from "./chunk-6X3MY2JP.js";
 import {
   contextFlags
-} from "./chunk-SEUCZZCP.js";
+} from "./chunk-N5I37JFB.js";
 import {
   shellWord
 } from "./chunk-FWD7AL6N.js";
@@ -18,7 +18,7 @@ import {
   retryingFetch,
   transportTarget,
   withWriteStatusAftermath
-} from "./chunk-MN2PB6WB.js";
+} from "./chunk-YR2I5HGE.js";
 import {
   suggestAll
 } from "./chunk-UTI5G6OJ.js";
@@ -288,4 +288,4 @@ export {
   freeBranchLabel,
   requireBranch
 };
-//# sourceMappingURL=chunk-E65QIWOO.js.map
+//# sourceMappingURL=chunk-NPODGBVJ.js.map

package/dist/{chunk-CYB7UQA2.js → chunk-OIKLDDYC.js}

@@ -1,11 +1,11 @@
 import {
   LOOPBACK_HOSTS
-} from "./chunk-AM4FKL4J.js";
+} from "./chunk-PL7AIAWS.js";
 import {
   TransportError,
   describeTransportFailure,
   fetchOrExplain
-} from "./chunk-MN2PB6WB.js";
+} from "./chunk-YR2I5HGE.js";
 import {
   readEnvVar
 } from "./chunk-X2NL4KUO.js";
@@ -137,7 +137,7 @@ async function resolveEngineRelease(opts) {
     if (status === 404) {
       throw new EngineReleaseNotFoundError(
         `There is no published engine release ${wanted}.
-Check the version, or run \`xanosdk local-engine update\` to move to the latest one.`
+Check the version, or run \`xanosdk local update\` to move to the latest one.`
       );
     }
     if (body === void 0) throw failed(status, display);
@@ -145,7 +145,7 @@ Check the version, or run \`xanosdk local-engine update\` to move to the latest
     if (asset === void 0) {
       throw new Error(
         `Engine release ${wanted} has no archive for ${platform}, so nothing was downloaded.
-Run \`xanosdk local-engine update\` to move to a release built for ${platform}.`
+Run \`xanosdk local update\` to move to a release built for ${platform}.`
       );
     }
     return asset;
@@ -179,4 +179,4 @@ export {
   EngineReleaseNotFoundError,
   resolveEngineRelease
 };
-//# sourceMappingURL=chunk-CYB7UQA2.js.map
+//# sourceMappingURL=chunk-OIKLDDYC.js.map

package/dist/{chunk-MLGI2SRQ.js → chunk-PFBXSVZF.js}

@@ -1,10 +1,10 @@
 import {
   contextFlags
-} from "./chunk-SEUCZZCP.js";
+} from "./chunk-N5I37JFB.js";
 import {
   backendDirFor,
   backendDirIn
-} from "./chunk-E6H5ZEV3.js";
+} from "./chunk-TTEIDD5Q.js";
 import {
   projectRootFrom
 } from "./chunk-ROY4YAEQ.js";
@@ -15,7 +15,7 @@ import {
   LocalFileNotFoundError,
   displayPath,
   relForwardSlash
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-D7BUMOKU.js";
 import {
   normalizeDocumentationScopeKey
 } from "./chunk-3JDU4VRL.js";
@@ -127,4 +127,4 @@ export {
   entryWordOf,
   readSecretsFile
 };
-//# sourceMappingURL=chunk-MLGI2SRQ.js.map
+//# sourceMappingURL=chunk-PFBXSVZF.js.map

package/dist/{chunk-AM4FKL4J.js → chunk-PL7AIAWS.js}

@@ -26,7 +26,7 @@ function assertLoopbackUrl(url, what) {
   if (isLoopbackUrl(url)) return;
   throw new Error(
     `${what} reports a url this SDK will not send a token to: ${url}
-A local engine has to serve loopback over http on a port of its own \u2014 ${LOOPBACK_HOSTS.join(", ")} \u2014 and anything else is reachable from off this machine. Stop that engine and start a fresh one without binding it to all interfaces.`
+A Xano Engine has to serve loopback over http on a port of its own \u2014 ${LOOPBACK_HOSTS.join(", ")} \u2014 and anything else is reachable from off this machine. Stop that engine and start a fresh one without binding it to all interfaces.`
   );
 }
 function requireString(raw, key, source) {
@@ -34,7 +34,7 @@ function requireString(raw, key, source) {
   if (typeof value !== "string" || value === "") {
     throw new Error(
       `${source} is missing \`${key}\`, or gave it as something other than text.
-That is not an engine this SDK knows how to drive \u2014 the engine on this machine is older or newer than the one it was built against. Move to a current one with \`xanosdk local-engine update\`.`
+That is not an engine this SDK knows how to drive \u2014 the engine on this machine is older or newer than the one it was built against. Move to a current one with \`xanosdk local update\`.`
     );
   }
   return value;
@@ -44,7 +44,7 @@ function requireNumber(raw, key, source) {
   if (typeof value !== "number" || !Number.isFinite(value)) {
     throw new Error(
       `${source} is missing \`${key}\`, or gave it as something other than a number.
-That is not an engine this SDK knows how to drive \u2014 the engine on this machine is older or newer than the one it was built against. Move to a current one with \`xanosdk local-engine update\`.`
+That is not an engine this SDK knows how to drive \u2014 the engine on this machine is older or newer than the one it was built against. Move to a current one with \`xanosdk local update\`.`
     );
   }
   return value;
@@ -53,7 +53,7 @@ function readEngine(value, source) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) {
     throw new Error(
       `${source} did not print an engine description.
-Re-run, and if it happens again fetch a fresh copy with \`xanosdk local-engine cache clear\`, then \`xanosdk deploy --local-engine\`.`
+Re-run, and if it happens again fetch a fresh copy with \`xanosdk local cache clear\`, then \`xanosdk deploy --local\`.`
     );
   }
   const raw = value;
@@ -77,7 +77,7 @@ function parseEngineHandshake(stdout) {
   } catch {
     throw new Error(
       `${HANDSHAKE_SOURCE} did not print an engine description.
-Re-run, and if it happens again fetch a fresh copy with \`xanosdk local-engine cache clear\`, then \`xanosdk deploy --local-engine\`.`
+Re-run, and if it happens again fetch a fresh copy with \`xanosdk local cache clear\`, then \`xanosdk deploy --local\`.`
     );
   }
   const engine = readEngine(value, HANDSHAKE_SOURCE);
@@ -93,13 +93,13 @@ function parseEngineListing(stdout) {
   } catch {
     throw new Error(
       `${LISTING_SOURCE} was not readable.
-Re-run, and if it happens again fetch a fresh copy with \`xanosdk local-engine cache clear\`, then \`xanosdk deploy --local-engine\`.`
+Re-run, and if it happens again fetch a fresh copy with \`xanosdk local cache clear\`, then \`xanosdk deploy --local\`.`
     );
   }
   if (!Array.isArray(value)) {
     throw new Error(
       `${LISTING_SOURCE} was not a list.
-Re-run, and if it happens again fetch a fresh copy with \`xanosdk local-engine cache clear\`, then \`xanosdk deploy --local-engine\`.`
+Re-run, and if it happens again fetch a fresh copy with \`xanosdk local cache clear\`, then \`xanosdk deploy --local\`.`
     );
   }
   return value.filter((entry) => !isForeignEngine(entry)).map((entry) => readEngine(entry, LISTING_SOURCE));
@@ -120,7 +120,7 @@ function resolveEnginePlatform(platform = process.platform, arch = process.arch)
   const pair = `${platform}-${arch}`;
   return SUPPORTED_PLATFORMS.find((p) => p === pair);
 }
-var LOCAL_ENGINE_HOME_ENV = "XANOSDK_LOCAL_ENGINE_HOME";
+var LOCAL_ENGINE_HOME_ENV = "XANOSDK_ENGINE_HOME";
 function localEngineHome(env = process.env) {
   return readEnvVar(LOCAL_ENGINE_HOME_ENV, env) ?? join(homedir(), ".xanosdk", "local-engine");
 }
@@ -145,7 +145,7 @@ function legacyRuntimeDirs(env = process.env, platform = process.platform) {
 function localEngineBinDir(env = process.env) {
   return join(localEngineHome(env), "bin");
 }
-var LOCAL_ENGINE_OVERRIDE_ENV = "XANOSDK_LOCAL_ENGINE_OVERRIDE";
+var LOCAL_ENGINE_OVERRIDE_ENV = "XANOSDK_ENGINE_OVERRIDE";
 var OVERRIDE_VERSION = /^v?\d+\.\d+\.\d+$/;
 function overrideSpec(value) {
   if (OVERRIDE_VERSION.test(value)) {
@@ -172,7 +172,7 @@ var ARCHIVE_SUFFIX = /\.(tar\.gz|tgz|gz|tar|zip)$/i;
 function engineOverrideRefusal(value, where, env = process.env) {
   if (/^https?:\/\//i.test(value)) {
     if (isTrustedEngineUrl(value)) return void 0;
-    return `${where} names an engine over plain http on a host that is not this machine. An engine is a program this command runs, so fetched that way anyone on the network path could swap it (and read XANOSDK_LOCAL_ENGINE_TOKEN if it is set). Nothing was requested.
+    return `${where} names an engine over plain http on a host that is not this machine. An engine is a program this command runs, so fetched that way anyone on the network path could swap it (and read XANOSDK_ENGINE_TOKEN if it is set). Nothing was requested.
 Serve the archive over https://, or over http:// from 127.0.0.1, ::1 or localhost.`;
   }
   const scheme = /^([a-z][a-z0-9+.-]*):\/\//i.exec(value);
@@ -195,7 +195,7 @@ Check the path \u2014 ${where} is read exactly as passed, with \`~\` and relativ
 }
 var MISSING_ARCHIVE = "There is no engine archive to read at";
 function engineSourceRefusal(flagValue, env = process.env) {
-  if (flagValue !== void 0 && flagValue !== "") return engineOverrideRefusal(flagValue, "`--local-engine`", env);
+  if (flagValue !== void 0 && flagValue !== "") return engineOverrideRefusal(flagValue, "`--local`", env);
   const fromEnv = readEnvVar(LOCAL_ENGINE_OVERRIDE_ENV, env)?.trim();
   if (fromEnv === void 0) return void 0;
   return engineOverrideRefusal(fromEnv, LOCAL_ENGINE_OVERRIDE_ENV, env);
@@ -234,4 +234,4 @@ export {
   engineOverrideFromEnv,
   resolveEngineSource
 };
-//# sourceMappingURL=chunk-AM4FKL4J.js.map
+//# sourceMappingURL=chunk-PL7AIAWS.js.map