@xano/sdk 1.0.4 → 1.0.6

package/dist/chunk-BTVUYHWV.js

@@ -0,0 +1,111 @@
+import {
+  satisfiesRange
+} from "./chunk-2TFRR6JV.js";
+import {
+  addDependencies
+} from "./chunk-PMMHSX4H.js";
+import {
+  condenseNpmError
+} from "./chunk-ZFDZKNGG.js";
+import {
+  shellWord
+} from "./chunk-FWD7AL6N.js";
+import {
+  readProjectManifest
+} from "./chunk-DXUICABI.js";
+import {
+  addCommandFor
+} from "./chunk-DNBP4GJN.js";
+import {
+  moduleKind,
+  packageNameOf,
+  readInstalledManifest,
+  readInstalledManifestState,
+  requiredPeersOf
+} from "./chunk-763M6LX3.js";
+import {
+  spinner,
+  style,
+  success,
+  terminalText,
+  warn
+} from "./chunk-D7BUMOKU.js";
+
+// src/emit/toolchain-peers.ts
+async function addToolchainPeers(dir, pkg, rerun) {
+  const state = readInstalledManifestState(dir, pkg);
+  if (state.kind !== "ok" || !isToolchainModule(pkg, state.manifest)) return [];
+  const declared = projectDeclaredRanges(readProjectManifest(dir));
+  const missing = [];
+  for (const [peer, range] of requiredPeersOf(state.manifest)) {
+    const has = declared.get(peer);
+    if (has === void 0) {
+      missing.push(`${peer}@${range}`);
+      continue;
+    }
+    const version = readInstalledManifest(dir, peer)?.["version"];
+    if (typeof version === "string" && satisfiesRange(version, range) === false) {
+      warn(
+        `${pkg} needs ${peer} ${range}, and this project has ${version} (declared ${has}) \u2014 left as it is.`,
+        "module.peer-mismatch",
+        [`Move it into range with \`${addCommandFor(dir, shellWord(`${peer}@${range}`))}\`, or keep it and expect ${pkg}'s output not to compile.`]
+      );
+    }
+  }
+  if (missing.length === 0) return [];
+  const spin = spinner(`Adding ${missing.map((m) => style.bold(m)).join(", ")}`);
+  let result;
+  try {
+    result = await addDependencies(dir, missing, {
+      rerun,
+      onRetry: () => spin.update(`Adding ${missing.join(", ")} (retrying with --legacy-peer-deps)`)
+    });
+  } finally {
+    spin.stop();
+  }
+  const command = addCommandFor(dir, missing.map(shellWord).join(" "));
+  if (result.status !== 0 || result.unrecorded.length > 0) {
+    process.stderr.write(terminalText(result.output.trimEnd()) + "\n");
+    warn(
+      `${pkg} needs ${missing.join(", ")}, and ${result.status !== 0 ? `\`${command}\` failed (exit ${result.status})` : `\`${command}\` did not add ${result.unrecorded.join(", ")}`}.`,
+      "module.peer-not-added",
+      [`Run \`${command}\` once that is fixed \u2014 code ${pkg} generates imports ${missing.length === 1 ? "it" : "them"}.`]
+    );
+    return missing.filter((m) => !result.unrecorded.includes(packageNameOf(m)));
+  }
+  if (result.peerConflict !== null) {
+    const refused = condenseNpmError(result.peerConflict);
+    warn(
+      `${missing.join(", ")} ${missing.length === 1 ? "declares" : "declare"} a peer range this project does not satisfy \u2014 installed with --legacy-peer-deps.`,
+      "module.legacy-peer-deps",
+      ["npm refused the tree it would otherwise have installed:", ...refused !== "" ? [refused] : []]
+    );
+  }
+  success(
+    `Added ${missing.join(", ")}, ${missing.length === 1 ? "a peer" : "peers"} ${pkg} needs, as ${missing.length === 1 ? "a direct dependency" : "direct dependencies"}.`
+  );
+  return missing;
+}
+function isToolchainModule(pkg, manifest) {
+  try {
+    return moduleKind(pkg, manifest) === "toolchain";
+  } catch {
+    return false;
+  }
+}
+function projectDeclaredRanges(manifest) {
+  const ranges = /* @__PURE__ */ new Map();
+  for (const block of ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]) {
+    const deps = manifest?.[block];
+    if (typeof deps !== "object" || deps === null) continue;
+    for (const [name, range] of Object.entries(deps)) {
+      if (!ranges.has(name)) ranges.set(name, typeof range === "string" ? range : String(range));
+    }
+  }
+  return ranges;
+}
+
+export {
+  addToolchainPeers
+};
+//# sourceMappingURL=chunk-BTVUYHWV.js.map

package/dist/{chunk-T4DUFQ2S.js → chunk-CCU5CCRX.js}

@@ -1,6 +1,6 @@
 import {
   backendDirIn
-} from "./chunk-E6H5ZEV3.js";
+} from "./chunk-TTEIDD5Q.js";
 import {
   shellWord
 } from "./chunk-FWD7AL6N.js";
@@ -9,11 +9,11 @@ import {
 } from "./chunk-EUUUMY7J.js";
 import {
   pointerRootFor
-} from "./chunk-FPBGAT5D.js";
+} from "./chunk-26MOFAJT.js";
 import {
   UsageError,
   setTypedCwd
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-D7BUMOKU.js";
 
 // src/emit/xanosdk-project.ts
 import { existsSync, realpathSync, statSync } from "fs";
@@ -32,7 +32,7 @@ function projectDirFrom(start) {
   }
 }
 var RELATIVE_PATH_ARGS = ["out", "lockPath", "entryPath", "static", "bundle", "envFile", "secretsFile", "backendDir", "emit", "path"];
-var PATH_VARS = ["XANO_CONFIG", "XANO_GLOBAL_CONFIG", "XANO_CLIENT_FILE", "XANOSDK_UPDATE_CACHE", "XANOSDK_PROVE_DIFF", "XANOSDK_LOCAL_ENGINE_HOME", "XANOSDK_LOCAL_ENGINE_OVERRIDE"];
+var PATH_VARS = ["XANO_CONFIG", "XANO_GLOBAL_CONFIG", "XANO_CLIENT_FILE", "XANOSDK_UPDATE_CACHE", "XANOSDK_PROVE_DIFF", "XANOSDK_ENGINE_HOME", "XANOSDK_ENGINE_OVERRIDE"];
 function enterProjectRoot(args, cwd = process.cwd(), positional) {
   const here = resolve(cwd);
   const at = positional === "verb-path" ? 1 : 0;
@@ -154,4 +154,4 @@ export {
   RELATIVE_PATH_ARGS,
   enterProjectRoot
 };
-//# sourceMappingURL=chunk-T4DUFQ2S.js.map
+//# sourceMappingURL=chunk-CCU5CCRX.js.map

package/dist/{chunk-5T2CTWTB.js → chunk-CHINR7WD.js}

@@ -4,25 +4,25 @@ import {
   sectionKind,
   tableAdditions,
   vectorSize
-} from "./chunk-HMLGM2MW.js";
+} from "./chunk-IYXL5NYU.js";
 import {
   ReleaseHttpError
-} from "./chunk-A6QTTJUI.js";
+} from "./chunk-GWTFI3GA.js";
 import {
   TenantHttpError
-} from "./chunk-KCAL4QYP.js";
+} from "./chunk-VW4CWVYX.js";
 import {
   CliError,
   detail,
   warn,
   withoutUrls
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-D7BUMOKU.js";
 import {
   suggest
 } from "./chunk-UTI5G6OJ.js";
 import {
   authoredFieldType
-} from "./chunk-4DJTQ6W4.js";
+} from "./chunk-JIKGT7DO.js";
 
 // src/emit/plan-disclosure.ts
 var NO_TABLE_EFFECTS = {
@@ -677,4 +677,4 @@ export {
   CONSTRAINT_PHRASE,
   CONSTRAINT_FIX
 };
-//# sourceMappingURL=chunk-5T2CTWTB.js.map
+//# sourceMappingURL=chunk-CHINR7WD.js.map

package/dist/{chunk-VD32O6KZ.js → chunk-CJDPSCMX.js}

@@ -1,14 +1,15 @@
 import {
   applyLanding,
   withoutPrunedObjects
-} from "./chunk-RX3EMQGN.js";
+} from "./chunk-MFWF2NZJ.js";
 import {
   atomicWrite
 } from "./chunk-LLNZGEFK.js";
 import {
   parseLockReport,
-  serializeLock
-} from "./chunk-OOGXZL7Z.js";
+  serializeLock,
+  withSyncedOf
+} from "./chunk-5KJBWIDZ.js";
 import {
   tagLockSource
 } from "./chunk-4BW2SG2N.js";
@@ -16,6 +17,37 @@ import {
 // src/lock/io.ts
 import { readFileSync, existsSync } from "fs";
 import { resolve } from "path";
+
+// src/lock/synced.ts
+function syncedOn(lock, destKey, branch) {
+  const record = lock?.synced?.[destKey];
+  return record !== void 0 && Object.hasOwn(record, branch) ? record[branch] : void 0;
+}
+function withSyncBaseline(lock, destKey, branch, baseline) {
+  const synced = { ...lock.synced ?? {} };
+  synced[destKey] = { ...synced[destKey] ?? {}, [branch]: baseline };
+  const { synced: _old, ...rest } = lock;
+  return withSyncedOf(rest, { synced });
+}
+function nextBaseline(previous, digests, by, complete, now = () => /* @__PURE__ */ new Date()) {
+  if (previous !== void 0 && previous.complete === complete && previous.scheme === digests.scheme && sameDigests(previous.objects, digests.objects) && sameDigests(previous.others ?? {}, digests.others)) {
+    return previous;
+  }
+  return {
+    at: now().toISOString(),
+    by,
+    scheme: digests.scheme,
+    complete,
+    objects: { ...digests.objects },
+    ...Object.keys(digests.others).length > 0 ? { others: { ...digests.others } } : {}
+  };
+}
+function sameDigests(a, b) {
+  const keys = Object.keys(a);
+  return keys.length === Object.keys(b).length && keys.every((k) => Object.hasOwn(b, k) && a[k] === b[k]);
+}
+
+// src/lock/io.ts
 function readLockFile(path, opts = {}) {
   return readLockFileReport(path, opts).lock;
 }
@@ -62,12 +94,20 @@ function forgetPrunedInLockFile(path, update) {
   writeLockFile(path, { ...lock, objects });
   return Object.keys(lock.objects).filter((key) => !(key in objects));
 }
+function recordSyncInLockFile(path, destKey, branch, sync) {
+  if (!existsSync(path)) return void 0;
+  const lock = readLockFile(path);
+  const baseline = nextBaseline(syncedOn(lock, destKey, branch), sync.digests, sync.by, sync.complete);
+  return { changed: writeLockFile(path, withSyncBaseline(lock, destKey, branch, baseline)) };
+}
 
 export {
+  syncedOn,
   readLockFile,
   readLockFileReport,
   writeLockFile,
   recordLandingInLockFile,
-  forgetPrunedInLockFile
+  forgetPrunedInLockFile,
+  recordSyncInLockFile
 };
-//# sourceMappingURL=chunk-VD32O6KZ.js.map
+//# sourceMappingURL=chunk-CJDPSCMX.js.map

package/dist/{chunk-3HOGFGKG.js → chunk-D3KEPRRN.js}

@@ -1,6 +1,6 @@
 import {
   impliedInputs
-} from "./chunk-7GX445AE.js";
+} from "./chunk-4XHAT7C5.js";
 
 // src/validate/normalize.ts
 var STRIP_KEYS = /* @__PURE__ */ new Set([
@@ -1062,4 +1062,4 @@ export {
   filledContext,
   normalize
 };
-//# sourceMappingURL=chunk-3HOGFGKG.js.map
+//# sourceMappingURL=chunk-D3KEPRRN.js.map

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

@@ -1,6 +1,6 @@
 import {
   setDiagnosticSink
-} from "./chunk-GPI3OWRE.js";
+} from "./chunk-YHB34BN6.js";
 import {
   suggest
 } from "./chunk-UTI5G6OJ.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-D7BUMOKU.js.map

package/dist/{chunk-WRBKLYSJ.js → chunk-DNBP4GJN.js}

@@ -201,8 +201,9 @@ function removeArgs(manager, pkg) {
   return [manager === "npm" ? "uninstall" : "remove", pkg];
 }
 function addArgs(manager, spec, dev = false) {
-  if (manager === "npm") return ["install", spec, ...dev ? ["--save-dev"] : []];
-  return ["add", spec, ...dev ? [manager === "pnpm" ? "--save-dev" : "--dev"] : []];
+  const specs = typeof spec === "string" ? [spec] : [...spec];
+  if (manager === "npm") return ["install", ...specs, ...dev ? ["--save-dev"] : []];
+  return ["add", ...specs, ...dev ? [manager === "pnpm" ? "--save-dev" : "--dev"] : []];
 }
 
 export {
@@ -221,4 +222,4 @@ export {
   removeArgs,
   addArgs
 };
-//# sourceMappingURL=chunk-WRBKLYSJ.js.map
+//# sourceMappingURL=chunk-DNBP4GJN.js.map

package/dist/{chunk-JTUKLCXS.js → chunk-DXUICABI.js}

@@ -89,4 +89,4 @@ export {
   composeToolchainConfig,
   writeToolchainConfig
 };
-//# sourceMappingURL=chunk-JTUKLCXS.js.map
+//# sourceMappingURL=chunk-DXUICABI.js.map

package/dist/{chunk-XMDDBEEM.js → chunk-E763QI3G.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-A2AOUBJS.js";
 import {
   RAW_FIELD
-} from "./chunk-4DJTQ6W4.js";
+} from "./chunk-JIKGT7DO.js";
 import {
   describeEntry
 } from "./chunk-4MIV244X.js";
@@ -139,4 +139,4 @@ export {
   rawField,
   codegen_entry_exports
 };
-//# sourceMappingURL=chunk-XMDDBEEM.js.map
+//# sourceMappingURL=chunk-E763QI3G.js.map