@xanots/sdk 0.0.4 → 0.0.6

package/CHANGELOG.md

@@ -11,19 +11,30 @@ listed here.
 
 ---
 
-## 0.0.4 — Agents get their instructions
+## 0.0.5 — Sign in without a loopback
 
-_2026-08-25_ · [release notes](https://github.com/xanots/sdk/releases/tag/v0.0.4)
+_2026-08-26_ · [release notes](https://github.com/xanots/sdk/releases/tag/v0.0.5)
 
-`knowledge()` lands: the markdown a Xano workspace's AI agents read before they act, authored as real `.md` files in your repo instead of typed into a console. Standing instructions, skills, and reference docs are now workspace source — reviewed in a diff, versioned with the code they describe, and redeployed with it. Nothing changes for a workspace that declares none.
+`xanots login` only ever worked when the browser finishing consent could reach your machine's `127.0.0.1`. On a remote shell, a container, or a Codespace it can't — the redirect lands nowhere and login sits there for five minutes before timing out. `xanots login --paste` fixes that: it binds nothing, prints the URL for you to open anywhere, and you paste the redirect back. This release also corrects two documented promises that were wrong, one of which was actively misleading for exactly this case.
 
-- `knowledge()` authors the instructions your agents follow
-- The body is a real markdown file, never a string in a def
-- `refs` ships a whole folder the agent searches on demand
-- `type` and `mode` decide what the agent actually receives
-- Authoring mistakes that used to deploy silently are now build errors
-- `xanots codegen` writes the markdown back out as files
-- Repeated releases update knowledge instead of duplicating it
+- `xanots login --paste` signs you in where the loopback can't be reached
+- `XANO_NO_BROWSER` never covered remote shells, despite saying it did
+- `--port` documented a default it did not have
+
+---
+
+## 0.0.4 — The markdown your agents read
+
+_2026-08-26_ · [release notes](https://github.com/xanots/sdk/releases/tag/v0.0.4)
+
+Knowledge is now workspace source: the markdown your Xano agents read before they act is authored as real `.md` files, reviewed in a diff, and deployed with the code it describes. Two commands join the CLI — `xanots onboard` puts the scaffold's choices in a browser, and `xanots upgrade` answers the version question on purpose rather than nudging. Windows users should take this one regardless: every npm call in the package was failing before it reached npm.
+
+- `knowledge()` — author the markdown your Xano agents read
+- `xanots onboard` — pick the scaffold's look in a browser
+- `xanots upgrade` — the version question asked on purpose
+- Every npm call failed on a current Node for Windows
+- The guides ship in the tarball
+- `CHANGELOG.md` ships, generated from the releases
 
 ---
 

package/README.md

@@ -93,6 +93,10 @@ for you, and the target instance comes from your token rather than a flag.
 npx @xanots/sdk login
 ```
 
+> On a remote shell, container, or Codespace — anywhere your browser can't reach this
+> machine's `127.0.0.1` — add `--paste`. It prints the URL for you to open anywhere, and you
+> paste the redirect back. See [Signing in & deploying](https://github.com/xanots/sdk/blob/main/guides/deploying.md).
+
 **2. Scaffold.** `init` writes a complete project: a Vite frontend under `frontend/` (React
 19 + shadcn/ui by default, or SvelteKit with `--framework svelte`), a XanoTS backend under
 `xano/`, and the `xano:export` / `xano:deploy` scripts already wired.
@@ -102,9 +106,9 @@ npx @xanots/sdk init my-app && cd my-app
 npm run dev                       # the frontend runs immediately
 ```
 
-In a terminal it asks three questions — framework, theme, AI instruction files — each with a
-default. The theme is shadcn's own: a base color plus an optional accent, rendered into the
-token stylesheet, with a complete dark palette either way.
+In a terminal it asks two questions — framework and AI instruction files — each with a
+default. The theme is a flag, not a question: it is shadcn's own, a base color plus an
+optional accent, rendered into the token stylesheet with a complete dark palette either way.
 
 ```bash
 npx @xanots/sdk init my-app --theme zinc-blue --dark toggle

package/dist/.build-fingerprint

@@ -0,0 +1 @@
+2ea4560ab5068ad3f41aaaccf9f6084502c807310086df6cd6a011bb8ab31aec

package/dist/{agent-file-refresh-IJ7GN2FJ.js → agent-file-refresh-6XT23SLU.js}

@@ -3,10 +3,10 @@ import {
   codingAgentDetected,
   isCI,
   refreshAgentFiles
-} from "./chunk-D6OGU2AI.js";
-import "./chunk-7SISR3CS.js";
+} from "./chunk-P5OAM3G2.js";
+import "./chunk-2SUCC4DV.js";
 import "./chunk-ZSYZTGJH.js";
-import "./chunk-6DHJVLYP.js";
+import "./chunk-Q77KNEUL.js";
 import "./chunk-EZG76F7R.js";
 export {
   CI_ENV_VARS,
@@ -14,4 +14,4 @@ export {
   isCI,
   refreshAgentFiles
 };
-//# sourceMappingURL=agent-file-refresh-IJ7GN2FJ.js.map
+//# sourceMappingURL=agent-file-refresh-6XT23SLU.js.map

package/dist/bin.js

@@ -1,27 +1,27 @@
 #!/usr/bin/env node
 import {
   maybeNotifyUpdate
-} from "./chunk-T6N3VMMO.js";
+} from "./chunk-Y7BARS25.js";
 import {
   readVersion,
   run
-} from "./chunk-DUC3PXDG.js";
+} from "./chunk-SOCYCBYG.js";
 import {
   exitCodeOf,
   reportFailure
-} from "./chunk-KGNJM4LN.js";
-import "./chunk-MFIHIS6B.js";
+} from "./chunk-JQLR64UC.js";
+import "./chunk-OLQLJY5T.js";
 import "./chunk-GNPVYOPB.js";
 import {
   clearProgress,
   error
 } from "./chunk-EZG76F7R.js";
-import "./chunk-BPEEGJJA.js";
-import "./chunk-YYSJAAJM.js";
-import "./chunk-YUPQOLFX.js";
+import "./chunk-3FQD3QME.js";
+import "./chunk-OKNSR7MT.js";
+import "./chunk-CQBJNFDK.js";
 import "./chunk-WHOJWOSV.js";
 import "./chunk-5XZ744TS.js";
-import "./chunk-YUBJLB6G.js";
+import "./chunk-EFH4NFPY.js";
 
 // src/emit/interrupt.ts
 var EXIT_SIGINT = 130;

package/dist/branch-commands-R4FR75UW.js

@@ -0,0 +1,134 @@
+import {
+  deleteBranch,
+  listBranches,
+  requireBranch,
+  setLiveBranch
+} from "./chunk-EQW3YT5U.js";
+import {
+  confirm
+} from "./chunk-4PTSTDIG.js";
+import {
+  getAccessToken
+} from "./chunk-SG4UBJ47.js";
+import "./chunk-LLWK6H77.js";
+import {
+  isMachineOutput,
+  writeJson
+} from "./chunk-NUQCEOKA.js";
+import "./chunk-3IGNIP6R.js";
+import {
+  UsageError
+} from "./chunk-JQLR64UC.js";
+import "./chunk-GNPVYOPB.js";
+import {
+  blank,
+  detail,
+  info,
+  step,
+  success,
+  warn
+} from "./chunk-EZG76F7R.js";
+import "./chunk-OKNSR7MT.js";
+
+// src/emit/branch-commands.ts
+var VERBS = ["list", "set-live", "delete"];
+function assertVerb(verb) {
+  if (verb !== void 0 && VERBS.includes(verb)) return verb;
+  throw new UsageError(
+    verb === void 0 ? `\`xanots workspace branch\` needs a verb: ${VERBS.join(", ")}.` : `\`xanots workspace branch ${verb}\` is not a verb. Expected one of: ${VERBS.join(", ")}.`,
+    { helpFor: { command: "workspace", subcommand: "branch" } }
+  );
+}
+function requireLabel(label, verb) {
+  if (label !== void 0 && label.trim() !== "") return label;
+  throw new UsageError(`\`xanots workspace branch ${verb}\` needs a branch label.`, {
+    helpFor: { command: "workspace", subcommand: "branch" }
+  });
+}
+function renderList(branches, workspaceId) {
+  blank();
+  step(`Branches in workspace #${workspaceId}`);
+  if (branches.length === 0) {
+    detail("none reported");
+    return;
+  }
+  for (const b of branches) {
+    const tags = [b.live ? "live" : "", b.backup ? "backup" : ""].filter(Boolean).join(", ");
+    detail(`${b.label}${tags === "" ? "" : `  (${tags})`}`);
+  }
+  blank();
+  detail("Branches scope logic. Tables and microservices are shared by every branch.");
+}
+async function runBranchCommand(args) {
+  const verb = assertVerb(args.positionals[0]);
+  const auth = await getAccessToken(args);
+  const workspaceId = auth.workspaceId;
+  const target = { baseUrl: auth.instance, workspaceId };
+  const branches = await listBranches(auth, target);
+  if (verb === "list") {
+    if (isMachineOutput(args)) {
+      writeJson({ workspaceId, instance: auth.instance, branches });
+      return;
+    }
+    renderList(branches, workspaceId);
+    return;
+  }
+  const label = requireLabel(args.positionals[1], verb);
+  const branch = requireBranch(branches, label);
+  if (verb === "set-live") {
+    if (branch.live) {
+      success(`Branch "${label}" is already live in workspace #${workspaceId} \u2014 nothing to do.`);
+      if (isMachineOutput(args)) writeJson({ workspaceId, branch: label, setLive: false, alreadyLive: true });
+      return;
+    }
+    const outgoing = branches.find((b) => b.live)?.label;
+    blank();
+    warn(`This is a production cutover for workspace #${workspaceId}.`);
+    if (outgoing !== void 0) detail(`The runtime stops serving "${outgoing}" and starts serving "${label}".`);
+    detail("Table data is unaffected \u2014 it is shared by every branch either way.");
+    blank();
+    if (!args.yes && !args.force) {
+      const ok = await confirm(`Make "${label}" the live branch?`, {
+        flag: "--yes",
+        helpFor: { command: "workspace", subcommand: "branch" }
+      });
+      if (!ok) {
+        info("Cancelled \u2014 the live branch is unchanged.");
+        return;
+      }
+    }
+    await setLiveBranch(auth, { ...target, label });
+    success(`Branch "${label}" is now live in workspace #${workspaceId}.`);
+    if (outgoing !== void 0) {
+      detail(`Roll back with \`xanots workspace branch set-live ${outgoing}\`.`);
+    }
+    if (isMachineOutput(args)) {
+      writeJson({ workspaceId, branch: label, setLive: true, previousBranch: outgoing });
+    }
+    return;
+  }
+  if (branch.live) {
+    throw new UsageError(
+      `Branch "${label}" is the LIVE branch of workspace #${workspaceId} and cannot be deleted.
+Promote another branch first (\`xanots workspace branch set-live <other>\`), then delete this one.`,
+      { helpFor: { command: "workspace", subcommand: "branch" } }
+    );
+  }
+  if (!args.yes && !args.force) {
+    const ok = await confirm(`Delete branch "${label}" from workspace #${workspaceId}?`, {
+      flag: "--yes",
+      helpFor: { command: "workspace", subcommand: "branch" }
+    });
+    if (!ok) {
+      info("Cancelled \u2014 nothing was deleted.");
+      return;
+    }
+  }
+  await deleteBranch(auth, { ...target, label });
+  success(`Deleted branch "${label}" from workspace #${workspaceId}.`);
+  if (isMachineOutput(args)) writeJson({ workspaceId, branch: label, deleted: true });
+}
+export {
+  runBranchCommand
+};
+//# sourceMappingURL=branch-commands-R4FR75UW.js.map

package/dist/{chunk-7SISR3CS.js → chunk-2SUCC4DV.js}

@@ -5,7 +5,7 @@ import {
   defaultThemeChoice,
   reactPreset,
   themeGuidanceSection
-} from "./chunk-6DHJVLYP.js";
+} from "./chunk-Q77KNEUL.js";
 import {
   detail,
   step,
@@ -442,4 +442,4 @@ export {
   resolveAiPresets,
   scaffoldProject
 };
-//# sourceMappingURL=chunk-7SISR3CS.js.map
+//# sourceMappingURL=chunk-2SUCC4DV.js.map

package/dist/{chunk-BPEEGJJA.js → chunk-3FQD3QME.js}

@@ -12,7 +12,7 @@ import {
   middlewareEntryGuid,
   stackReferencesAuth,
   tableColumns
-} from "./chunk-YUPQOLFX.js";
+} from "./chunk-CQBJNFDK.js";
 import {
   CANONICAL_PAYLOAD_KEYS,
   REFERENCEABLE_KINDS,
@@ -23,7 +23,7 @@ import {
   mintCanonical,
   recordObserved,
   resolveRef
-} from "./chunk-YUBJLB6G.js";
+} from "./chunk-EFH4NFPY.js";
 
 // src/workspace/seed-coerce.ts
 function coerceScalarValue(label, column, type, value, values) {
@@ -1652,4 +1652,4 @@ export {
   Xano,
   workspace
 };
-//# sourceMappingURL=chunk-BPEEGJJA.js.map
+//# sourceMappingURL=chunk-3FQD3QME.js.map

package/dist/{chunk-EAIR6VUL.js → chunk-4HDOP7LH.js}

@@ -2,7 +2,7 @@ import {
   presetFilePath,
   resolveAiPresets,
   scaffoldProject
-} from "./chunk-7SISR3CS.js";
+} from "./chunk-2SUCC4DV.js";
 import {
   runNpmCapturingStderr
 } from "./chunk-ZSYZTGJH.js";
@@ -11,7 +11,7 @@ import {
   allFrontendPresets,
   findFrontendPreset,
   resolveFrameworkFlag
-} from "./chunk-WGDAOOXG.js";
+} from "./chunk-MU3O43L2.js";
 import {
   initLanding,
   renderApiTs,
@@ -27,11 +27,9 @@ import {
   renderViteConfig,
   renderXanoExampleMd,
   renderXanoIndex
-} from "./chunk-QUUB7HYK.js";
+} from "./chunk-P5C2YKAM.js";
 import {
   DEFAULT_DARK_MODE,
-  curatedThemes,
-  defaultTheme,
   defaultThemeChoice,
   normalizeRadius,
   resolveDarkModeFlag,
@@ -39,15 +37,14 @@ import {
   resolveIconsFlag,
   resolveThemeFlag,
   themeFromRegistryItem,
-  themeSwatch,
   withRadius
-} from "./chunk-6DHJVLYP.js";
+} from "./chunk-Q77KNEUL.js";
 import {
   readVersion
-} from "./chunk-DUC3PXDG.js";
+} from "./chunk-SOCYCBYG.js";
 import {
   UsageError
-} from "./chunk-KGNJM4LN.js";
+} from "./chunk-JQLR64UC.js";
 import {
   blank,
   detail,
@@ -291,7 +288,6 @@ async function resolveFrontendPreset(flag) {
 }
 
 // src/emit/theme-resolve.ts
-import { createInterface as createInterface2 } from "readline/promises";
 import { readFileSync as readFileSync2 } from "fs";
 import { resolve as resolvePath } from "path";
 function isRegistryRef(value) {
@@ -332,54 +328,6 @@ function parseJson(text, source) {
 async function themeFromFlag(raw) {
   return isRegistryRef(raw.trim()) ? loadRegistryTheme(raw.trim()) : resolveThemeFlag(raw);
 }
-function swatch(theme, color) {
-  if (!color) return "";
-  const blocks = themeSwatch(theme).map(({ r, g, b }) => `\x1B[38;2;${r};${g};${b}m\u2588\x1B[0m`).join("");
-  return blocks === "" ? "" : `${blocks} `;
-}
-function colorEnabled() {
-  if (process.env.FORCE_COLOR) return process.env.FORCE_COLOR !== "0";
-  return !process.env.NO_COLOR && process.stderr.isTTY === true;
-}
-async function promptTheme() {
-  const themes = curatedThemes();
-  const color = colorEnabled();
-  const rl = createInterface2({ input: process.stdin, output: process.stderr });
-  try {
-    process.stderr.write(
-      `
-Which theme? (shadcn/ui color tokens \u2014 everything else is identical)
-` + themes.map((t, i) => `  ${i + 1}) ${swatch(t, color)}${t.label}${i === 0 ? " (default)" : ""}`).join("\n") + `
-${style.dim(
-        `  \u2026or any <base>-<accent> pair, or a registry theme URL. See \`xanots init --help\`.`
-      )}
-`
-    );
-    for (; ; ) {
-      const answer = (await rl.question(`Enter a number, a theme, or leave blank for the default: `)).trim();
-      if (answer === "") return defaultTheme();
-      const byIndex = Number.parseInt(answer, 10);
-      if (Number.isInteger(byIndex) && byIndex >= 1 && byIndex <= themes.length) {
-        return themes[byIndex - 1];
-      }
-      if (!isRegistryRef(answer)) {
-        try {
-          return resolveThemeFlag(answer);
-        } catch {
-          return defaultTheme();
-        }
-      }
-      try {
-        return await loadRegistryTheme(answer);
-      } catch (err) {
-        process.stderr.write(`${style.yellow("!")} ${err instanceof Error ? err.message : String(err)}
-`);
-      }
-    }
-  } finally {
-    rl.close();
-  }
-}
 async function resolveThemeChoice(args) {
   const dark = args.dark === void 0 || args.dark === "" ? DEFAULT_DARK_MODE : resolveDarkModeFlag(args.dark);
   const fonts = {
@@ -388,14 +336,7 @@ async function resolveThemeChoice(args) {
     ...args.fontHeading !== void 0 && args.fontHeading !== "" ? { heading: resolveFontFlag(args.fontHeading, "heading") } : {}
   };
   const icons = args.icons === void 0 || args.icons === "" ? void 0 : resolveIconsFlag(args.icons).id;
-  let theme;
-  if (args.theme !== void 0 && args.theme !== "") {
-    theme = await themeFromFlag(args.theme);
-  } else if (process.stdin.isTTY && process.stderr.isTTY) {
-    theme = await promptTheme();
-  } else {
-    theme = defaultThemeChoice().theme;
-  }
+  let theme = args.theme !== void 0 && args.theme !== "" ? await themeFromFlag(args.theme) : defaultThemeChoice().theme;
   if (args.radius !== void 0 && args.radius !== "") {
     theme = withRadius(theme, normalizeRadius(args.radius));
   }
@@ -529,4 +470,4 @@ export {
   projectShellFiles,
   runInitCommand
 };
-//# sourceMappingURL=chunk-EAIR6VUL.js.map
+//# sourceMappingURL=chunk-4HDOP7LH.js.map

package/dist/chunk-4PTSTDIG.js

@@ -0,0 +1,59 @@
+import {
+  UsageError
+} from "./chunk-JQLR64UC.js";
+import {
+  style
+} from "./chunk-EZG76F7R.js";
+
+// src/emit/prompt.ts
+import { createInterface } from "readline";
+async function confirm(message, opts) {
+  if (process.stdin.isTTY !== true) {
+    throw new UsageError(
+      `Cannot ask for confirmation: stdin is not a terminal. Re-run with ${opts.flag} to confirm without being asked.`,
+      { helpFor: opts.helpFor }
+    );
+  }
+  const rl = createInterface({ input: process.stdin, output: process.stderr });
+  try {
+    const answer = await new Promise((res) => rl.question(`${style.yellow("?")} ${message} (y/N) `, res));
+    return /^y(es)?$/i.test(answer.trim());
+  } finally {
+    rl.close();
+  }
+}
+var MAX_EMPTY_ANSWERS = 3;
+async function promptLine(message, opts) {
+  if (process.stdin.isTTY !== true) {
+    throw new UsageError(
+      `Cannot prompt: stdin is not a terminal. ${opts.noTtyHint}`,
+      { helpFor: opts.helpFor }
+    );
+  }
+  const rl = createInterface({ input: process.stdin, output: process.stderr });
+  try {
+    for (let attempt = 0; attempt < MAX_EMPTY_ANSWERS; attempt++) {
+      const onClose = () => settle(null);
+      let settle;
+      const answer = await new Promise((resolve) => {
+        settle = resolve;
+        rl.once("close", onClose);
+        rl.question(`${style.yellow("?")} ${message} `, resolve);
+      }).finally(() => rl.off("close", onClose));
+      if (answer === null) throw new UsageError(`Input ended before an answer arrived. ${opts.noTtyHint}`);
+      const trimmed = answer.trim();
+      if (trimmed !== "") return trimmed;
+      process.stderr.write(`${style.yellow("!")} A value is required.
+`);
+    }
+    throw new UsageError(`No value entered. ${opts.noTtyHint}`, { helpFor: opts.helpFor });
+  } finally {
+    rl.close();
+  }
+}
+
+export {
+  confirm,
+  promptLine
+};
+//# sourceMappingURL=chunk-4PTSTDIG.js.map

package/dist/{live-diff-FP4SFNT4.js → chunk-5HCDZ2XN.js}

@@ -11,10 +11,19 @@ function rows(bundle, key) {
   return Array.isArray(value) ? value.filter((r) => r !== null && typeof r === "object") : [];
 }
 function columnsOf(table) {
+  return new Set(typedColumnsOf(table).keys());
+}
+function typedColumnsOf(table) {
+  const out = /* @__PURE__ */ new Map();
   const schema = table.schema;
-  if (!Array.isArray(schema)) return /* @__PURE__ */ new Set();
-  const names = schema.map((c) => c !== null && typeof c === "object" ? c.name : void 0).filter((n) => typeof n === "string" && n !== "");
-  return new Set(names);
+  if (!Array.isArray(schema)) return out;
+  for (const entry of schema) {
+    if (entry === null || typeof entry !== "object") continue;
+    const { name, type } = entry;
+    if (typeof name !== "string" || name === "") continue;
+    out.set(name, typeof type === "string" ? type : "");
+  }
+  return out;
 }
 function identify(table) {
   const guid = table.guid;
@@ -69,6 +78,56 @@ function diffAgainstLive(outgoing, live, opts) {
   }
   return { droppedColumns, unchangedEnv };
 }
+function sharedSchemaChanges(outgoing, live, opts = {}) {
+  if (live === void 0) return void 0;
+  const changes = [];
+  for (const kind of ["dbo", "microservice"]) {
+    const liveRows = new Map(rows(live, kind).map((r) => [identify(r), r]));
+    const outgoingRows = new Map(rows(outgoing, kind).map((r) => [identify(r), r]));
+    for (const [key, out] of outgoingRows) {
+      const current = liveRows.get(key);
+      const name = nameOf(out);
+      if (current === void 0) {
+        changes.push({ kind, name, action: "create" });
+        continue;
+      }
+      const details = kind === "dbo" ? tableDelta(current, out) : objectDelta(current, out);
+      if (details.length > 0) changes.push({ kind, name, action: "alter", details });
+    }
+    if (opts.prune === true) {
+      for (const [key, current] of liveRows) {
+        if (!outgoingRows.has(key)) changes.push({ kind, name: nameOf(current), action: "remove" });
+      }
+    }
+  }
+  return changes;
+}
+function tableDelta(live, outgoing) {
+  const details = [];
+  const before = typedColumnsOf(live);
+  const after = typedColumnsOf(outgoing);
+  const liveName = nameOf(live);
+  const outgoingName = nameOf(outgoing);
+  if (liveName !== outgoingName) details.push(`renamed from "${liveName}" to "${outgoingName}"`);
+  for (const [column, type] of after) {
+    const current = before.get(column);
+    if (current === void 0) {
+      details.push(`add column "${column}"`);
+    } else if (current !== type) {
+      details.push(`retype column "${column}" (${current} \u2192 ${type})`);
+    }
+  }
+  for (const column of before.keys()) {
+    if (!after.has(column)) details.push(`drop column "${column}"`);
+  }
+  return details;
+}
+function objectDelta(live, outgoing) {
+  const liveName = nameOf(live);
+  const outgoingName = nameOf(outgoing);
+  if (liveName !== outgoingName) return [`renamed from "${liveName}" to "${outgoingName}"`];
+  return deepEqual(normalize(live), normalize(outgoing)) ? [] : ["configuration differs"];
+}
 var WORKSPACE_KEY = "workspace";
 var ENV_KEY = "env";
 var SETTINGS_KEYS_COMPARED_ELSEWHERE = /* @__PURE__ */ new Set([WORKSPACE_KEY, ENV_KEY, "canonical"]);
@@ -189,8 +248,10 @@ function compareToLive(outgoing, live) {
   }
   return { converged: compared > 0 && differingCount === 0, compared, differing, differingCount, liveOnly };
 }
+
 export {
-  compareToLive,
-  diffAgainstLive
+  diffAgainstLive,
+  sharedSchemaChanges,
+  compareToLive
 };
-//# sourceMappingURL=live-diff-FP4SFNT4.js.map
+//# sourceMappingURL=chunk-5HCDZ2XN.js.map

package/dist/{chunk-5WGEURVI.js → chunk-6AAT2AYQ.js}

@@ -7,12 +7,20 @@ import {
 // src/deploy/import.ts
 var IMPORT_TIMEOUT_MS = 12e4;
 var PROBE_TIMEOUT_MS = 15e3;
+function plannedBranch(parsed) {
+  const summary = parsed.summary !== null && typeof parsed.summary === "object" && !Array.isArray(parsed.summary) ? parsed.summary : {};
+  for (const candidate of [parsed.branch, parsed.branch_label, summary.branch, summary.branch_label]) {
+    if (typeof candidate === "string" && candidate !== "") return candidate;
+  }
+  return void 0;
+}
 function query(opts) {
   const params = new URLSearchParams();
   if (opts.mode !== void 0) params.set("mode", opts.mode);
   if (opts.prune !== void 0) params.set("delete", String(opts.prune));
   if (opts.records !== void 0) params.set("records", String(opts.records));
   if (opts.truncate !== void 0) params.set("truncate", String(opts.truncate));
+  if (opts.branch !== void 0) params.set("branch", opts.branch);
   const qs = params.toString();
   return qs === "" ? "" : `?${qs}`;
 }
@@ -66,6 +74,16 @@ async function assertMergeSupported(auth, opts) {
 ${text}`
   );
 }
+function assertBranchTargetHonored(plan, requested, baseUrl) {
+  if (plan.branch === requested) return;
+  const observed = plan.branch === void 0 ? `it did not say which branch the plan targets` : `it planned against "${plan.branch}"`;
+  throw new Error(
+    `Refusing to release to branch "${requested}": ${observed}.
+  instance: ${baseUrl}
+An instance that predates branch support IGNORES the branch parameter, imports into whichever branch is LIVE, and still answers 200 \u2014 so a release that looked staged would have overwritten production. That is not recoverable, so it is not attempted on an instance that has not confirmed the target.
+Update the instance, or drop \`--branch\` to release to the live branch deliberately.`
+  );
+}
 function body(archive) {
   const form = new FormData();
   form.append("file", new Blob([archive], { type: "application/gzip" }), "workspace.gz");
@@ -145,12 +163,14 @@ ${text}`);
     hasRecords: parsed.has_records === true,
     hasEnv: parsed.has_env === true,
     operations,
+    branch: plannedBranch(parsed),
     raw: text
   };
 }
 
 export {
+  assertBranchTargetHonored,
   importWorkspaceArchive,
   planWorkspaceImport
 };
-//# sourceMappingURL=chunk-5WGEURVI.js.map
+//# sourceMappingURL=chunk-6AAT2AYQ.js.map

package/dist/{chunk-AJ7JQ4OU.js → chunk-AAFBSOSD.js}

@@ -1,9 +1,9 @@
 import {
   sandboxBaseUrl
-} from "./chunk-ACQCK4DT.js";
+} from "./chunk-OR43PDCW.js";
 import {
   getAccessToken
-} from "./chunk-C56BC2FY.js";
+} from "./chunk-SG4UBJ47.js";
 import {
   exportWorkspaceBundle
 } from "./chunk-QTNO2WD6.js";
@@ -115,4 +115,4 @@ export {
   fetchSandboxBundle,
   runSandboxExportCommand
 };
-//# sourceMappingURL=chunk-AJ7JQ4OU.js.map
+//# sourceMappingURL=chunk-AAFBSOSD.js.map