@xano/sdk 1.0.3 → 1.0.5

package/dist/{chunk-IVKRT476.js → chunk-4QFBEKXI.js}

@@ -5,7 +5,7 @@ import {
 import {
   pastePath,
   warn
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-XNZURZ7T.js";
 import {
   shellQuote
 } from "./chunk-5ZSO4T2G.js";
@@ -103,4 +103,4 @@ export {
   replacedRegistrations,
   reportSuperseded
 };
-//# sourceMappingURL=chunk-IVKRT476.js.map
+//# sourceMappingURL=chunk-4QFBEKXI.js.map

package/dist/{chunk-OOXWYAA4.js → chunk-57A5ZKPO.js}

@@ -12,4 +12,4 @@ export {
   SERVER_ENV,
   isServerPath
 };
-//# sourceMappingURL=chunk-OOXWYAA4.js.map
+//# sourceMappingURL=chunk-57A5ZKPO.js.map

package/dist/{chunk-A4KBHTMK.js → chunk-57B56I4B.js}

@@ -1,26 +1,26 @@
 import {
   createOperation,
   runOperation
-} from "./chunk-FURLOAUM.js";
+} from "./chunk-SNGFEESM.js";
 import {
   fetchWorkspaceBundle
-} from "./chunk-7KLAMYMS.js";
+} from "./chunk-LZDA6SVD.js";
 import {
   assertReleaseIdentitiesFree,
   pinnedCanonicalGuids,
   setLiveRollback
-} from "./chunk-ZTUNCVAR.js";
+} from "./chunk-Z2BRSQ6M.js";
 import {
   liveBranchMismatch,
   liveMismatch
-} from "./chunk-ZVYN4FXD.js";
+} from "./chunk-YSLMMR2U.js";
 import {
   confirm
-} from "./chunk-4APOHK7Y.js";
+} from "./chunk-AESE434J.js";
 import {
   landingLockPath,
   recordForeignLanding
-} from "./chunk-LAKHO2B7.js";
+} from "./chunk-ES5A66IH.js";
 import {
   CONSTRAINT_FIX,
   CONSTRAINT_PHRASE,
@@ -39,24 +39,24 @@ import {
   releaseTableEffects,
   renameHint,
   tableEffectsPayload
-} from "./chunk-5T2CTWTB.js";
+} from "./chunk-BBPAXOU6.js";
 import {
   tableRowCounter
-} from "./chunk-MNVDVR3M.js";
+} from "./chunk-GMVW6ZZK.js";
 import {
   asWorkspaceArchive,
   resolveProjectEntry
-} from "./chunk-7KGASMCE.js";
+} from "./chunk-PIPIA7K7.js";
 import {
   exportWorkspaceBundle
-} from "./chunk-QV3GXQRE.js";
+} from "./chunk-XIABDKFQ.js";
 import {
   decodeWorkspaceArchive
 } from "./chunk-3DRXWLJ5.js";
 import {
   SettledWriteFailure,
   classifyFailure
-} from "./chunk-JTM5D7CT.js";
+} from "./chunk-5D6DGF3W.js";
 import {
   BranchTakenError,
   assertBranchAbsent,
@@ -67,16 +67,16 @@ import {
   listBranchListing,
   liveBranchLabel,
   setLiveBranch
-} from "./chunk-E65QIWOO.js";
+} from "./chunk-5RLAF6RL.js";
 import {
   envValuesOf
-} from "./chunk-HMLGM2MW.js";
+} from "./chunk-SF2B7MZK.js";
 import {
   assertOneName
-} from "./chunk-DIG3NITC.js";
+} from "./chunk-A4NNCI4O.js";
 import {
   resolveSource
-} from "./chunk-46TUUNM3.js";
+} from "./chunk-JXKO6JT7.js";
 import {
   ReleaseHttpError,
   UNPROMOTABLE_RELEASE_PARTS,
@@ -85,27 +85,27 @@ import {
   promotableReleaseName,
   unpromotableReleasePart,
   untenantDeployableReleasePart
-} from "./chunk-A6QTTJUI.js";
+} from "./chunk-3BJYQGAZ.js";
 import {
   getAccessToken
-} from "./chunk-CJPLBFFY.js";
+} from "./chunk-CJ76PSJT.js";
 import {
   pipedYes,
   retryCommand,
   withheldNote
-} from "./chunk-FMOEVAGT.js";
+} from "./chunk-Z4VN347O.js";
 import {
   contextFlags
-} from "./chunk-SEUCZZCP.js";
+} from "./chunk-G57RYMKB.js";
 import {
   shellWord
 } from "./chunk-FWD7AL6N.js";
 import {
   readLockFile
-} from "./chunk-VD32O6KZ.js";
+} from "./chunk-SQPIECXD.js";
 import {
   withoutReadAftermath
-} from "./chunk-MN2PB6WB.js";
+} from "./chunk-HLQH3AXB.js";
 import {
   CliError,
   LocalFileNotFoundError,
@@ -123,10 +123,10 @@ import {
   success,
   warn,
   withoutUrls
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-XNZURZ7T.js";
 import {
   envNamesRead
-} from "./chunk-OPG4DYX2.js";
+} from "./chunk-JSEVKRVJ.js";
 import {
   safeNames
 } from "./chunk-GSGDWJB5.js";
@@ -135,7 +135,7 @@ import {
 } from "./chunk-GPI3OWRE.js";
 import {
   sdkKindName2 as sdkKindName
-} from "./chunk-OOGXZL7Z.js";
+} from "./chunk-OKNE3TWU.js";
 import {
   shellQuote
 } from "./chunk-5ZSO4T2G.js";
@@ -292,7 +292,7 @@ async function verifyLanding(auth, opts) {
   } catch (err) {
     return unverified(shortReason(err));
   }
-  const { compareToLive, declaredLabels } = await import("./live-diff-2S7E3SBZ.js");
+  const { compareToLive, declaredLabels } = await import("./live-diff-IM4W3ELT.js");
   let result;
   try {
     result = compareToLive(declared, landedBundle, void 0, { sample: "all" });
@@ -407,7 +407,7 @@ async function seedRowRemedies(release, tables, flags, named) {
   const resettable = seededHere === void 0 ? [] : tables.filter((t) => seededHere.has(t.name) && t.guid !== void 0);
   const r = shellWord(release.name);
   const before = [
-    `The release's rows land with a deploy of the release: \`xanosdk deploy release:${r}${flags}\` on this project's ephemeral, or \`xanosdk tenant deploy <tenant> ${r}${flags}\` on a tenant.`
+    `The release's rows land with a deploy of the release: \`xanosdk deploy release:${r} --ephemeral${flags}\` on this project's ephemeral, or \`xanosdk tenant deploy <tenant> ${r}${flags}\` on a tenant.`
   ];
   if (resettable.length === 0) return { before };
   const one = resettable.length === 1;
@@ -464,7 +464,7 @@ async function runPromoteCommand(args) {
   discloseWriteTarget(destination);
   const lockPath = landingLockPath(args, args.entryPath === void 0 ? {} : { entryFile: args.entryPath });
   if (lockPath === void 0 && args.noLock !== true) {
-    const { nestedBackendEntries } = await import("./tracked-backend-AJLHRGLF.js");
+    const { nestedBackendEntries } = await import("./tracked-backend-B4HTME4S.js");
     const nested = nestedBackendEntries(process.cwd());
     if (nested.length > 0) {
       warn(
@@ -911,7 +911,7 @@ Nothing was switched. Serve it deliberately with \`xanosdk workspace branch set-
   }
 }
 async function unansweredBranchRead(err, args, what) {
-  const { LookupFailedError, isServerError, isTransportFailure, unansweredCause } = await import("./source-resolve-NTI3JFO6.js");
+  const { LookupFailedError, isServerError, isTransportFailure, unansweredCause } = await import("./source-resolve-OWD3MIEO.js");
   const transport = isTransportFailure(err);
   if (!transport && !isServerError(err)) return err;
   const first = what !== void 0 ? `could not read ${what}` : ((err instanceof Error ? err.message : String(err)).trim().split("\n")[0] ?? "").replace(/[.:]$/, "");
@@ -937,4 +937,4 @@ export {
   reportNotRun,
   runPromoteCommand
 };
-//# sourceMappingURL=chunk-A4KBHTMK.js.map
+//# sourceMappingURL=chunk-57B56I4B.js.map

package/dist/{chunk-OPHB5ORL.js → chunk-57HMNJGB.js}

@@ -2,7 +2,7 @@ import {
   decodeMarkerWith,
   iconLibraryOf,
   reactPreset
-} from "./chunk-UCQ2VUTG.js";
+} from "./chunk-M6ZFSTIZ.js";
 import {
   composeBlock,
   gitattributesSpec,
@@ -56,32 +56,36 @@ function renderPackageJson({ appName, sdkVersion }, preset, choice = defaultThem
       // Scaffolds written before the default flipped still pass `--lock`, and
       // it stays accepted for exactly that reason.
       "xano:export": `npm run xano:routes && ${check} && xanosdk export ./xano/index.ts --out workspace.json`,
-      // Runs `build` rather than `check` directly: `--static ./frontend/dist`
-      // needs that directory to EXIST, and only `vite build` writes it. Pointing
-      // the flag at a directory the script never produced meant a fresh clone
-      // running the one documented command had no `dist` to ship.
-      // `build` already prefixes the same typecheck, so this is one check, not
-      // two.
-      "xano:deploy": `npm run build && xanosdk deploy ./xano/index.ts --static ./frontend/dist`,
-      // The tight loop: redeploy the backend to an engine on this machine.
+      // The default deploy, and the tight loop: redeploy the backend to the
+      // Xano Engine on this machine. It needs no Xano account, so a fresh
+      // scaffold runs it before anyone signs in.
       //
       // No `--static` and no `npm run build`, and both omissions are the point
       // rather than an economy: there is no frontend to ship here. The dev
       // server is still serving it, and the deploy points that server at the
       // engine on its way past, so the loop is backend-only by design.
-      // (`--static` does work on a local engine, for a built frontend the
+      // (`--static` does work on a Xano Engine, for a built frontend the
       // engine itself should serve; this loop has none.)
       //
-      // The flag is bare deliberately. The engine's download URL is passed by
-      // hand once and cached for every run after; baking one into a scaffolded
-      // project would ship a coordinate that is not this project's to carry.
+      // No `--local`: the Xano Engine is where a bare deploy goes, and the
+      // project's pinned version is what it runs. Baking an engine version or
+      // URL into a scaffolded project would ship a coordinate that is not this
+      // project's to carry.
       //
       // `--keep-data`, because the engine is the developer's own backend and
       // this loop runs once per code change: each run merges into what the last
       // one left, so rows entered through the app survive the edit. The first
       // run, and the first after the engine restarts, replaces and seeds.
       // `--reset` on the command line still gives a clean slate.
-      "xano:deploy:local-engine": `npm run xano:routes && ${check} && xanosdk deploy ./xano/index.ts --local-engine --keep-data`,
+      "xano:deploy": `npm run xano:routes && ${check} && xanosdk deploy ./xano/index.ts --keep-data`,
+      // The cloud deploy: backend and built frontend to an ephemeral.
+      // Runs `build` rather than `check` directly: `--static ./frontend/dist`
+      // needs that directory to EXIST, and only `vite build` writes it. Pointing
+      // the flag at a directory the script never produced meant a fresh clone
+      // running the documented command had no `dist` to ship.
+      // `build` already prefixes the same typecheck, so this is one check, not
+      // two.
+      "xano:deploy:ephemeral": `npm run build && xanosdk deploy ./xano/index.ts --ephemeral --static ./frontend/dist`,
       // The frontend-only loop: rebuild and republish to the environment this
       // project last deployed to, without recompiling or re-importing the
       // backend. `build` runs first because publish ships only what is on disk.
@@ -190,9 +194,9 @@ function renderViteConfig(preset) {
   const header = root === null ? `// Vite's root is the project root. The framework resolves its own file
 // locations from the plugin config below \u2014 this file is the ONLY place that
 // config lives \u2014 and routes the build through its adapter, which writes
-// frontend/dist, the directory \`npm run xano:deploy\` ships as the frontend.` : `// Vite's root is the ${root}/ folder, so index.html and the app live there
+// frontend/dist, the directory \`npm run xano:deploy:ephemeral\` ships as the frontend.` : `// Vite's root is the ${root}/ folder, so index.html and the app live there
 // while the Xano SDK backend sits in xano/ as a peer. The build lands in
-// ${root}/dist, which \`npm run xano:deploy\` ships as the static frontend.`;
+// ${root}/dist, which \`npm run xano:deploy:ephemeral\` ships as the static frontend.`;
   const rootBlock = root === null ? "" : `  root: ${JSON.stringify(root)},
   // Vite resolves \`.env\` files against \`root\`, which is ${root}/ here \u2014 but
   // \`.env.example\` sits at the project root, so that is where anyone will
@@ -401,69 +405,99 @@ ${version === void 0 ? "" : `        with:
 }
 function renderEnvExample() {
   return `# Point the frontend at a deployed Xano backend. Leave unset to run the UI
-# with no backend. When you \`npm run xano:deploy\`, the backend URL is injected
-# as window.XANO_HOST at runtime instead \u2014 no rebuild needed.
+# with no backend. \`npm run xano:deploy\` writes the Xano Engine's URL to
+# .env.local for you. After \`npm run xano:deploy:ephemeral\`, the backend URL is
+# injected as window.XANO_HOST at runtime instead \u2014 no rebuild needed.
 VITE_XANO_HOST=https://your-instance.xano.io
 `;
 }
+var XANO_BADGE = "[![Built on Xano](https://img.shields.io/badge/built_on-Xano-0055FF)](https://xano.com)";
+function renderReadmeLearnMore() {
+  return `## Learn more
+
+- [Xano SDK guides](https://github.com/xano-sdk/sdk/blob/main/guides/README.md) \u2014 signing in
+  and deploying, releasing to production, the typed frontend, every CLI command.
+- [Xano](https://xano.com) is the platform this app deploys to: the database, APIs, auth,
+  background tasks, realtime, file storage and AI agents behind \`xano/\`, with
+  [docs](https://docs.xano.com) and a [community](https://community.xano.com).`;
+}
 function renderReadme({ appName, install }, preset, choice = defaultThemeChoice()) {
   return `# ${appName}
 
-A [Xano SDK](https://www.npmjs.com/package/@xano/sdk) project: a Xano
-backend authored in TypeScript under [\`xano/\`](xano/), and a ${preset.label}
-frontend under [\`frontend/\`](frontend/) that derives its request paths and
-types from the backend defs \u2014 so the two can't drift.
+${XANO_BADGE}
+
+A full-stack app on [Xano](https://xano.com). The backend is TypeScript under
+[\`xano/\`](xano/), authored with the [Xano SDK](https://github.com/xano-sdk/sdk). It runs on
+your machine on the **Xano Engine**, and one command deploys it to Xano's cloud. The
+${preset.label} frontend under [\`frontend/\`](frontend/) takes its request paths and types
+from the backend defs, so the two can't drift.
 
 ## Quick start
 
 \`\`\`bash
 ${install?.manager ?? "npm"} install${install?.ignoreWorkspace === true ? " --ignore-workspace" : ""}
-npm run dev          # run the frontend (no backend needed yet)
+npm run xano:deploy   # run the backend on the Xano Engine, on this machine
+npm run dev           # run the frontend, already pointed at it
 \`\`\`
 
-Then author your backend in [\`xano/index.ts\`](xano/index.ts) \u2014 start with the
-walkthrough in [\`xano/EXAMPLE.md\`](xano/EXAMPLE.md).
-
-## Deploy
+No Xano account needed. Then author your backend in [\`xano/index.ts\`](xano/index.ts),
+starting with the walkthrough in [\`xano/EXAMPLE.md\`](xano/EXAMPLE.md), and rerun
+\`npm run xano:deploy\` after each change.
+
+## Run it on your machine
+
+The Xano Engine is Xano running on your machine. \`npm run xano:deploy\` typechecks the
+backend and deploys it to the engine: no sign-in, and no network round-trip.
+It prints the backend URL, a link that opens Xano's visual builder on the engine, and
+points \`npm run dev\` at it through \`.env.local\` (restart the dev server if it was already
+running).
+
+- **It works on a fresh machine with nothing set.** The first run downloads the latest
+  engine once per machine and pins its version in \`package.json\`. Commit that change, so
+  everyone on the project runs the same engine.
+- **It keeps your table rows across redeploys** (\`--keep-data\`). The first run seeds and
+  later runs merge your changes in without re-seeding. Rows survive only in tables and columns that keep
+  their names (a rename drops the old one with its rows), and only while the engine runs. An
+  engine update or restart starts it empty and the next run seeds again.
+  \`npm run xano:deploy -- --reset\` gives a clean, re-seeded slate.
+- **Updates are yours to take.** When a newer engine ships, a deploy offers it and never
+  applies it without a yes. \`npx xanosdk local update\` moves the pin on purpose,
+  and \`npx xanosdk local cache clear\` reclaims the disk space. To try another engine
+  without moving the pin, export \`XANOSDK_ENGINE_OVERRIDE\` with a version (\`v0.1.5\`)
+  or an engine archive path.
+- **The rest of the CLI follows.** After a local deploy, \`npm run xano:test\`,
+  \`npx xanosdk tables\` and \`npx xanosdk status\` reach the engine with no flag.
+  \`npx xanosdk local stop <name>\` shuts it down.
+
+## Deploy to Xano's cloud
 
 \`\`\`bash
-npx xanosdk login        # once, to authenticate against your Xano account
-npm run xano:deploy     # build the frontend, then ship it with the backend
+npx xanosdk login               # once, to authenticate against your Xano account
+npm run xano:deploy:ephemeral   # build the frontend, then ship it with the backend
 \`\`\`
 
-- \`npm run xano:deploy:local-engine\` redeploys just the backend to a local engine,
-  for a tight loop with no network round-trip. Keep \`npm run dev\` running \u2014 the
-  deploy points it at the engine. It works on a fresh machine with nothing set: the
-  first run downloads the latest engine once per machine and pins its version in
-  \`package.json\` (commit that change, so everyone on the project runs the same
-  engine). When a newer engine ships, a deploy offers it and never applies it without
-  a yes; \`npx xanosdk local-engine update\` moves the pin on purpose, and
-  \`npx xanosdk local-engine cache clear\` reclaims the disk space. To try another engine
-  without moving the pin, export \`XANOSDK_LOCAL_ENGINE_OVERRIDE\` with a version
-  (\`v0.1.5\`) or an engine archive path. It keeps the engine's
-  table rows across redeploys (\`--keep-data\`): the first run seeds, later runs merge
-  your changes in without re-seeding. Rows survive only in tables and columns that
-  keep their names \u2014 a rename drops the old one with its rows \u2014 and only while the
-  engine runs; an engine update or restart starts it empty and the next run seeds
-  again. \`npm run xano:deploy:local-engine -- --reset\` gives a clean, re-seeded slate.
+That deploys the backend and the built frontend to a live **ephemeral** environment on
+Xano and prints its URL. Run it again to refresh the same environment; if it expired, a
+fresh one is created and the new URL is called out. \`npx xanosdk status\` says who you
+are signed in as, which workspace you are bound to, and which environment this project
+last deployed to \u2014 its URL, and when it expires \u2014 so you never have to remember the
+environment's name. Your **workspace** is reached through a release (\`deploy --ephemeral --test\`,
+\`release create\`, \`promote\`); see the
+[deploying guide](https://github.com/xano-sdk/sdk/blob/main/guides/deploying.md).
+
+The other scripts:
+
 - \`npm run xano:deploy:frontend\` rebuilds the frontend and republishes it to the
   environment this project last deployed to \u2014 no backend compile or import, so it
-  is the quick loop for UI-only changes. \`publish\` does not reach a local engine, so after
-  a local-engine deploy run it as \`npm run xano:deploy:frontend -- --to ephemeral\`, or
-  have the engine serve a build with \`--static ./frontend/dist\` on the local deploy.
-  \`npx xanosdk publish ./frontend/dist --to workspace\` puts the same build in front of
-  your real workspace instead.
-- \`npm run xano:export\` compiles the backend to \`workspace.json\` (don't commit it).
-- \`npm run xano:deploy\` deploys the backend and the built frontend to a live
-  **ephemeral** environment and prints its URL. Run it again to refresh the same
-  environment; if it expired, a fresh one is created and the new URL is called out.
-- \`npx xanosdk status\` says who you are signed in as, which workspace you are bound to, and
-  which environment this project last deployed to \u2014 its URL, and when it expires. You
-  never have to remember the environment's name.
+  is the quick loop for UI-only changes. After \`npm run xano:deploy\` the engine serves
+  it; \`npm run xano:deploy:frontend -- --to ephemeral\` sends it to an ephemeral instead,
+  and \`npx xanosdk publish ./frontend/dist --to workspace\` puts the same build in front
+  of your real workspace.
 - \`npm run xano:test\` runs the tests the DEPLOYED environment carries \u2014 the \`tests\`
   on a query/function/middleware and any \`workflowTest()\`. It compiles nothing, so
   deploy first. A failing suite exits 5, distinct from a crash. \`npx xanosdk deploy
   ./xano/index.ts --test\` does both in one step.
+- \`npm run xano:export\` compiles the backend to \`workspace.json\` (don't commit it).
 
 ## \`xano.lock\` \u2014 commit it
 
@@ -537,6 +571,8 @@ Xano SDK is composable with other \`@xano-sdk/*\` packages:
 
 None of these ship with the scaffold. Install one only when you need it \u2014 an
 add-on you never register is weight in \`package.json\` for nothing.
+
+${renderReadmeLearnMore()}
 `;
 }
 function renderXanoIndex({ appName }) {
@@ -659,7 +695,7 @@ xano/
    \`workflowTest({ name, stack })\` when the behavior spans several objects.
    They live beside the code they cover and ship with it. See "Testing" below.
 6. **Compile** with \`npm run xano:export\`, and **deploy** with
-   \`npm run xano:deploy\` (after \`npx xanosdk login\`). The first of either writes
+   \`npm run xano:deploy\` (it runs on the Xano Engine; no account needed). The first of either writes
    \`xano/xano.lock\` \u2014 **commit it**. It pins every object's identity, so a later
    rename renames the object instead of deleting and recreating it. See
    "\`xano.lock\` \u2014 commit it" in the project README.
@@ -720,8 +756,8 @@ function describeOrigin(o) {
       return `workspace ${o.origin}`;
     case "ephemeral":
       return `ephemeral "${o.origin}"`;
-    case "local-engine":
-      return `local engine "${o.origin}"`;
+    case "local":
+      return `Xano Engine "${o.origin}"`;
     case "tenant":
       return `tenant "${o.origin}"`;
     case "release":
@@ -776,16 +812,21 @@ cleartext, which is why it is gitignored too.
 `;
   return `# ${appName}
 
-A [Xano SDK](https://www.npmjs.com/package/@xano/sdk) project pulled from
-${describeCommittedOrigin(origin)}. The Xano backend lives in [\`xano/\`](xano/) as readable
-TypeScript; the ${preset.label} frontend under [\`frontend/\`](frontend/) is a starter \u2014
-the pull carries a backend, not a UI.
+${XANO_BADGE}
+
+A full-stack app on [Xano](https://xano.com), pulled from
+${describeCommittedOrigin(origin)} with the [Xano SDK](https://github.com/xano-sdk/sdk). The Xano
+backend lives in [\`xano/\`](xano/) as readable TypeScript; the ${preset.label} frontend
+under [\`frontend/\`](frontend/) is a starter \u2014 the pull carries a backend, not a UI.
 
-## Deploy it
+## Run it
 
 \`\`\`bash
-npx xanosdk login        # once, to authenticate against your Xano account
-npm run xano:deploy     # typecheck, build the frontend, ship both
+npm run xano:deploy                # on the Xano Engine, on this machine (no account needed)
+npm run dev                        # the starter frontend, pointed at it
+
+npx xanosdk login                  # once, to authenticate against your Xano account
+npm run xano:deploy:ephemeral      # typecheck, build the frontend, ship both to an ephemeral
 \`\`\`
 
 ## Read this before deploying
@@ -793,10 +834,11 @@ npm run xano:deploy     # typecheck, build the frontend, ship both
 - **\`xano/\` is your source now** \u2014 edit it and commit it. \`npx xanosdk pull\` (or re-running
   \`npx xanosdk 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 \u2014 commit first.
-- **\`npx xanosdk deploy\` is a full replace** of an **ephemeral** environment or a local engine
-  (\`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 --to workspace\`, which merge and leave table rows alone.
+- **\`npx xanosdk deploy\` is a full replace** of a Xano Engine or an **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 \`npx xanosdk deploy --to workspace\`, which merge
+  and leave table rows alone.
 - **This is schema only.** Table rows are not carried, and neither are payload sections
   this SDK models no kind for. A deploy recreates the structure, not the data.
 
@@ -814,6 +856,8 @@ npm run xano:routes    # regenerate xano/routes.gen.ts, the frontend's paths
 
 [\`frontend/src/lib/api.ts\`](frontend/src/lib/api.ts) shows the one contract: paths
 from \`routePath()\` in \`xano/routes.gen.ts\`, types from the query defs in \`xano/\`.
+
+${renderReadmeLearnMore()}
 `;
 }
 function renderReadmeThemingSection(choice) {
@@ -877,7 +921,7 @@ function initLanding({ appName }) {
         { text: ")." }
       ],
       [{ text: "Wire it into the UI from " }, { code: "frontend/src/lib/api.ts" }, { text: "." }],
-      [{ text: "Ship it: " }, { code: "npm run xano:deploy" }, { text: "." }]
+      [{ text: "Run it on the Xano Engine: " }, { code: "npm run xano:deploy" }, { text: "." }]
     ],
     cta: UI_DOCS_CTA
   };
@@ -904,9 +948,9 @@ function codegenLanding({ appName }, origin) {
         { text: "." }
       ],
       [
-        { text: "Ship it: " },
+        { text: "Run it on the Xano Engine: " },
         { code: "npm run xano:deploy" },
-        { text: " (a full replace of an ephemeral env)." }
+        { text: " (a full replace of the Xano Engine)." }
       ]
     ],
     cta: UI_DOCS_CTA
@@ -1328,7 +1372,7 @@ export {};
 }
 function renderLayoutTs() {
   return `// There is no server. The backend is Xano, reached through $lib/api.ts,
-// and \`npm run xano:deploy\` ships this app to a static host with no runtime.
+// and \`npm run xano:deploy:ephemeral\` ships this app to a static host with no runtime.
 //
 // prerender: true \u2014 every route is rendered to its own HTML file AT BUILD TIME
 // and served as a real document. That is what makes each page load as itself
@@ -1788,7 +1832,7 @@ becomes its own HTML document at build time, so a page loads as itself rather
 than as a shell that fills in afterwards, and an unmatched path returns a real
 404 from [\`+error.svelte\`](frontend/src/routes/+error.svelte).
 
-> **There is no server.** \`npm run xano:deploy\` ships this app to a static host
+> **There is no server.** \`npm run xano:deploy:ephemeral\` ships this app to a static host
 > with no runtime of its own; Xano is the backend, reached through
 > [\`frontend/src/lib/api.ts\`](frontend/src/lib/api.ts). So \`+page.server.ts\`,
 > form actions, and server \`load\` have nothing to run on \u2014 and **nothing warns
@@ -1987,4 +2031,4 @@ export {
   allFrontendPresets,
   resolveFrameworkFlag
 };
-//# sourceMappingURL=chunk-OPHB5ORL.js.map
+//# sourceMappingURL=chunk-57HMNJGB.js.map

package/dist/{chunk-JTM5D7CT.js → chunk-5D6DGF3W.js}

@@ -1,27 +1,27 @@
 import {
   BranchHttpError,
   BranchTakenError
-} from "./chunk-E65QIWOO.js";
+} from "./chunk-5RLAF6RL.js";
 import {
   SourceError
-} from "./chunk-46TUUNM3.js";
+} from "./chunk-JXKO6JT7.js";
 import {
   ReleaseHttpError
-} from "./chunk-A6QTTJUI.js";
+} from "./chunk-3BJYQGAZ.js";
 import {
   ImportHttpError
-} from "./chunk-MEE5RZ6G.js";
+} from "./chunk-5XVBT6CQ.js";
 import {
   TenantHttpError
-} from "./chunk-KCAL4QYP.js";
+} from "./chunk-4GDEEY2U.js";
 import {
   TLS_CERTIFICATE_CODES,
   isTimeoutError,
   writeRefusedBy
-} from "./chunk-MN2PB6WB.js";
+} from "./chunk-HLQH3AXB.js";
 import {
   UsageError
-} from "./chunk-SBR2WZXG.js";
+} from "./chunk-XNZURZ7T.js";
 
 // src/emit/operation-outcome.ts
 var SettledWriteFailure = class extends Error {
@@ -82,4 +82,4 @@ export {
   SettledWriteFailure,
   classifyFailure
 };
-//# sourceMappingURL=chunk-JTM5D7CT.js.map
+//# sourceMappingURL=chunk-5D6DGF3W.js.map

package/dist/{chunk-E65QIWOO.js → chunk-5RLAF6RL.js}

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

package/dist/{chunk-MEE5RZ6G.js → chunk-5XVBT6CQ.js}

@@ -1,6 +1,6 @@
 import {
   httpFailure
-} from "./chunk-MN2PB6WB.js";
+} from "./chunk-HLQH3AXB.js";
 
 // src/deploy/import.ts
 var ImportHttpError = class extends Error {
@@ -23,4 +23,4 @@ export {
   ImportHttpError,
   isSignatureRefusal
 };
-//# sourceMappingURL=chunk-MEE5RZ6G.js.map
+//# sourceMappingURL=chunk-5XVBT6CQ.js.map

package/dist/{chunk-RX3EMQGN.js → chunk-5YBNXNKU.js}

@@ -1,7 +1,7 @@
 import {
   LOCK_PAYLOAD_KEYS,
   lockKey
-} from "./chunk-OOGXZL7Z.js";
+} from "./chunk-OKNE3TWU.js";
 
 // src/lock/landed.ts
 function destinationKey(instance, dest) {
@@ -153,4 +153,4 @@ export {
   withoutLanding,
   landedOn
 };
-//# sourceMappingURL=chunk-RX3EMQGN.js.map
+//# sourceMappingURL=chunk-5YBNXNKU.js.map

package/dist/{chunk-NA3PXMEF.js → chunk-64WWE3EF.js}

@@ -7,4 +7,4 @@ function sha256Hex(bytes) {
 export {
   sha256Hex
 };
-//# sourceMappingURL=chunk-NA3PXMEF.js.map
+//# sourceMappingURL=chunk-64WWE3EF.js.map