@xano/sdk 1.0.4 → 1.0.5

package/dist/{workspace-command-T7Z2BDHD.js → workspace-command-GTUNVN7K.js}

@@ -1,102 +1,102 @@
 import {
   fetchWorkspaceBundle
-} from "./chunk-ESZ2FF57.js";
-import "./chunk-D5ZEAF4G.js";
-import "./chunk-TTVAHCWP.js";
+} from "./chunk-LZDA6SVD.js";
+import "./chunk-CV54PASI.js";
+import "./chunk-TM5LRSBB.js";
 import {
   printMicroserviceSection,
   readMicroservices
-} from "./chunk-EWCDPFW5.js";
+} from "./chunk-U6DR6464.js";
 import {
   confirm
-} from "./chunk-4APOHK7Y.js";
+} from "./chunk-AESE434J.js";
 import "./chunk-WOGJB2F6.js";
 import {
   listTables
-} from "./chunk-MNVDVR3M.js";
-import "./chunk-VRVKNY4A.js";
-import "./chunk-QV3GXQRE.js";
+} from "./chunk-GMVW6ZZK.js";
+import "./chunk-PIPIA7K7.js";
+import "./chunk-XIABDKFQ.js";
 import "./chunk-3DRXWLJ5.js";
 import "./chunk-X4DVXBFY.js";
 import {
   listBranches
-} from "./chunk-E65QIWOO.js";
+} from "./chunk-5RLAF6RL.js";
 import {
   reachableWorkspaces,
   refuseUnreachableWorkspace,
   unreachableWorkspaceMessage
-} from "./chunk-QAEQGT5I.js";
-import "./chunk-MLPDSGJQ.js";
-import "./chunk-KUTFFHUM.js";
+} from "./chunk-UIEFE6FU.js";
+import "./chunk-DEVGLLNZ.js";
+import "./chunk-OVV2HXJ6.js";
 import "./chunk-2TFRR6JV.js";
 import {
   resolveOutputTarget,
   secretsPhrase,
   writeExportFile
-} from "./chunk-FJWZ5OVV.js";
+} from "./chunk-N6BWB35H.js";
 import {
   secretsCarriedBy
-} from "./chunk-HMLGM2MW.js";
-import "./chunk-XXZZGXW2.js";
-import "./chunk-Y2ZLKBM6.js";
+} from "./chunk-SF2B7MZK.js";
+import "./chunk-MEIJDRHU.js";
+import "./chunk-3WHWOKU4.js";
 import {
   assertBundleFile,
   assertBundleInput,
   assertEntryFile,
   assertValueFiles,
   loadBundleText
-} from "./chunk-WYEQFD6A.js";
-import "./chunk-DIG3NITC.js";
-import "./chunk-664LSWE5.js";
-import "./chunk-LIVN53UV.js";
-import "./chunk-HSEQYBDO.js";
-import "./chunk-T4DUFQ2S.js";
-import "./chunk-2AUV6NXK.js";
-import "./chunk-A6QTTJUI.js";
-import "./chunk-MEE5RZ6G.js";
+} from "./chunk-S5KQIFKJ.js";
+import "./chunk-A4NNCI4O.js";
+import "./chunk-LLS2WO2K.js";
+import "./chunk-KUU7T4ZE.js";
+import "./chunk-HOOOOJJP.js";
+import "./chunk-NGAODDLX.js";
+import "./chunk-JXKO6JT7.js";
+import "./chunk-3BJYQGAZ.js";
+import "./chunk-5XVBT6CQ.js";
 import {
   getAccessToken
-} from "./chunk-LUTMOHOW.js";
-import "./chunk-3P3HXN76.js";
-import "./chunk-W5ONYLOP.js";
-import "./chunk-KCAL4QYP.js";
+} from "./chunk-CJ76PSJT.js";
+import "./chunk-V4IBHDIY.js";
+import "./chunk-KQLACS4Q.js";
+import "./chunk-4GDEEY2U.js";
 import "./chunk-2MNLRIOX.js";
-import "./chunk-WL2DSNJV.js";
-import "./chunk-AM4FKL4J.js";
-import "./chunk-JP7M7OU7.js";
-import "./chunk-UDE5C2XN.js";
-import "./chunk-MLGI2SRQ.js";
-import "./chunk-UKUIUS3E.js";
+import "./chunk-Q22BMRPF.js";
+import "./chunk-PL7AIAWS.js";
+import "./chunk-TUEFTRC2.js";
+import "./chunk-F3557PVM.js";
+import "./chunk-AMBEITWL.js";
+import "./chunk-4QBGE3EO.js";
 import "./chunk-ZYJP6BOO.js";
 import "./chunk-QO6BVGS5.js";
-import "./chunk-3H3EPMFY.js";
-import "./chunk-BUECLQXK.js";
-import "./chunk-CFSFBKHP.js";
+import "./chunk-UJ6ZZJDD.js";
+import "./chunk-QZTJ2556.js";
+import "./chunk-TEBS7FE6.js";
 import {
   yesRerun
-} from "./chunk-FMOEVAGT.js";
+} from "./chunk-Z4VN347O.js";
 import "./chunk-622HUCZT.js";
 import {
   contextFlags
-} from "./chunk-SEUCZZCP.js";
-import "./chunk-E6H5ZEV3.js";
-import "./chunk-HUSH7LRI.js";
-import "./chunk-ZG7E72VI.js";
-import "./chunk-S7E2AHV3.js";
+} from "./chunk-G57RYMKB.js";
+import "./chunk-AGD7F7YI.js";
+import "./chunk-F6IKWAIU.js";
+import "./chunk-OGUMHW2X.js";
+import "./chunk-3VX7VAQT.js";
 import "./chunk-ZFDZKNGG.js";
 import "./chunk-FWD7AL6N.js";
-import "./chunk-3FN2BIGB.js";
-import "./chunk-JTUKLCXS.js";
+import "./chunk-MYLPOVX6.js";
+import "./chunk-DXUICABI.js";
 import {
   describeWrite
 } from "./chunk-4KHEMC32.js";
-import "./chunk-37AHZ7JX.js";
+import "./chunk-Y76ERHLK.js";
 import "./chunk-ROY4YAEQ.js";
-import "./chunk-VD32O6KZ.js";
-import "./chunk-RX3EMQGN.js";
+import "./chunk-SQPIECXD.js";
+import "./chunk-5YBNXNKU.js";
 import "./chunk-WRBKLYSJ.js";
-import "./chunk-DYG5D3FD.js";
-import "./chunk-I2BGYNHD.js";
+import "./chunk-M7GJ6YUF.js";
+import "./chunk-OJPZEUPH.js";
 import {
   writeData
 } from "./chunk-AWQ7BQTQ.js";
@@ -106,19 +106,19 @@ import {
   fetchOrExplain,
   httpFailure,
   parseJsonAnswer
-} from "./chunk-MN2PB6WB.js";
-import "./chunk-FPBGAT5D.js";
+} from "./chunk-HLQH3AXB.js";
+import "./chunk-JZWUAEMO.js";
 import "./chunk-LLNZGEFK.js";
-import "./chunk-QXTKSOFI.js";
+import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
-import "./chunk-CBYQ2ZN3.js";
+import "./chunk-S5TEJIGP.js";
 import "./chunk-XMDDBEEM.js";
-import "./chunk-OPHB5ORL.js";
-import "./chunk-UCQ2VUTG.js";
+import "./chunk-57HMNJGB.js";
+import "./chunk-M6ZFSTIZ.js";
 import "./chunk-DGWHAVRG.js";
 import "./chunk-7THDHQ4R.js";
 import "./chunk-3YW23UFH.js";
-import "./chunk-6R7S775T.js";
+import "./chunk-K6CB5TKM.js";
 import {
   UsageError,
   blank,
@@ -138,20 +138,20 @@ import {
   warn,
   writeJson,
   writeTargetPayload
-} from "./chunk-SBR2WZXG.js";
-import "./chunk-II747OWE.js";
-import "./chunk-5W7DOMIU.js";
+} from "./chunk-XNZURZ7T.js";
+import "./chunk-FV55SRQU.js";
+import "./chunk-3IYVHVM6.js";
 import "./chunk-6JAEMMZ7.js";
-import "./chunk-5YL5OC2G.js";
+import "./chunk-SRX6B544.js";
 import "./chunk-45ZUMF4E.js";
 import "./chunk-7KPKDHHI.js";
-import "./chunk-EESV6NU2.js";
-import "./chunk-OPG4DYX2.js";
+import "./chunk-XJU6UAFV.js";
+import "./chunk-JSEVKRVJ.js";
 import "./chunk-ICK36EGF.js";
 import "./chunk-BEXZ4XRV.js";
 import "./chunk-ETAZIGNT.js";
 import "./chunk-GSGDWJB5.js";
-import "./chunk-4PQHO74B.js";
+import "./chunk-VZ22VUAS.js";
 import "./chunk-ERVIASGL.js";
 import "./chunk-VTMTIBKP.js";
 import "./chunk-H2V3N23D.js";
@@ -159,11 +159,11 @@ import "./chunk-3JDU4VRL.js";
 import "./chunk-WTPZRR4I.js";
 import "./chunk-GPI3OWRE.js";
 import "./chunk-UTI5G6OJ.js";
-import "./chunk-OOGXZL7Z.js";
+import "./chunk-OKNE3TWU.js";
 import "./chunk-5ZSO4T2G.js";
 import {
   HOSTED_ROW_PATH_PREFIX
-} from "./chunk-XNCP4KYO.js";
+} from "./chunk-VQPDATQT.js";
 import "./chunk-UDZX2ZL4.js";
 import "./chunk-ZY55DO5P.js";
 import "./chunk-A2AOUBJS.js";
@@ -197,7 +197,7 @@ async function runWorkspaceCommand(args) {
     case "reset-tables":
       return runResetTables(args);
     case "branch": {
-      const { runBranchCommand } = await import("./branch-commands-ZT2MJIRS.js");
+      const { runBranchCommand } = await import("./branch-commands-HXXTCSOO.js");
       return runBranchCommand(args);
     }
     default:
@@ -226,7 +226,7 @@ async function runDetails(args) {
   const auth = await getAccessToken(args);
   const workspaceId = auth.workspaceId;
   const all = await fetchWorkspaces(auth).catch(async (err) => {
-    const { unansweredRead } = await import("./source-resolve-DMDZVPMM.js");
+    const { unansweredRead } = await import("./source-resolve-OWD3MIEO.js");
     throw unansweredRead(err, "read the workspace list", "workspace");
   });
   const match = all.find((w) => w.id === workspaceId);
@@ -286,7 +286,7 @@ async function runExport(args) {
 var EXIT_DIFF_MISMATCH = 2;
 async function runDiff(args) {
   if (args.file === void 0 && args.bundle === void 0) {
-    const { resolveProjectEntry } = await import("./deploy-source-5CET3A5D.js");
+    const { resolveProjectEntry } = await import("./deploy-source-5COWTBOC.js");
     const entry = resolveProjectEntry(process.cwd());
     if (entry !== void 0) args = { ...args, file: entry };
   }
@@ -299,11 +299,11 @@ async function runDiff(args) {
   try {
     live = await fetchWorkspaceBundle(auth, args.branch);
   } catch (err) {
-    const { unansweredRead } = await import("./source-resolve-DMDZVPMM.js");
+    const { unansweredRead } = await import("./source-resolve-OWD3MIEO.js");
     throw unansweredRead(err, "read the workspace to compare", "workspace");
   }
-  const { compareToLive, SETTINGS_LABEL } = await import("./live-diff-2S7E3SBZ.js");
-  const { codePinnedCanonicals, releaseCanonicalLock } = await import("./release-command-2OTNVMIL.js");
+  const { compareToLive, SETTINGS_LABEL } = await import("./live-diff-IM4W3ELT.js");
+  const { codePinnedCanonicals, releaseCanonicalLock } = await import("./release-command-WOVQAMUY.js");
   const pinned = codePinnedCanonicals(local.bundle, releaseCanonicalLock(args), args.file !== void 0);
   const result = compareToLive(
     JSON.parse(local.bundle),
@@ -407,7 +407,7 @@ Pass the entry file: \`xanosdk workspace reset-tables ./index.ts --table <guid>
   const local = await loadBundleText(args.write === true && !willRefuse ? args : { ...args, lockReadOnly: true }, target, {
     withSeed: true
   });
-  const { seedRowsByTableGuid } = await import("./seed-GJHJSEUE.js");
+  const { seedRowsByTableGuid } = await import("./seed-24DTEY5S.js");
   const seeds = seedRowsByTableGuid(local.content);
   const declared = projectTables(local.bundle);
   const unknown = guids.filter((guid) => !declared.some((t) => t.guid === guid));
@@ -444,7 +444,7 @@ ${declared.map((t) => `  ${t.guid}  ${t.name}${seeds.has(t.guid) ? "  (seeded)"
     );
   }
   const destination = credentialWriteTarget(auth);
-  const { countTableRows } = await import("./table-ZBDPKMNH.js");
+  const { countTableRows } = await import("./table-MQFVYA4K.js");
   const planned = await Promise.all(
     guids.map(async (guid) => {
       const table = byGuid.get(guid);
@@ -483,7 +483,7 @@ ${declared.map((t) => `  ${t.guid}  ${t.name}${seeds.has(t.guid) ? "  (seeded)"
       return;
     }
   }
-  const { truncateTable, insertTableRows } = await import("./table-ZBDPKMNH.js");
+  const { truncateTable, insertTableRows } = await import("./table-MQFVYA4K.js");
   const done = [];
   for (const t of planned) {
     step(`Resetting ${t.name}`);
@@ -533,4 +533,4 @@ export {
   EXIT_DIFF_MISMATCH,
   runWorkspaceCommand
 };
-//# sourceMappingURL=workspace-command-T7Z2BDHD.js.map
+//# sourceMappingURL=workspace-command-GTUNVN7K.js.map

package/dist/{workspace-env-VA7XN3UX.js → workspace-env-467C5KHM.js}

@@ -14,28 +14,28 @@ import {
   renderWorkspaceEnvFile,
   valueProblem,
   workspaceEnvPathIn
-} from "./chunk-664LSWE5.js";
-import "./chunk-E6H5ZEV3.js";
-import "./chunk-HUSH7LRI.js";
-import "./chunk-ZG7E72VI.js";
-import "./chunk-S7E2AHV3.js";
+} from "./chunk-LLS2WO2K.js";
+import "./chunk-AGD7F7YI.js";
+import "./chunk-F6IKWAIU.js";
+import "./chunk-OGUMHW2X.js";
+import "./chunk-3VX7VAQT.js";
 import "./chunk-ZFDZKNGG.js";
 import "./chunk-FWD7AL6N.js";
-import "./chunk-3FN2BIGB.js";
-import "./chunk-JTUKLCXS.js";
+import "./chunk-MYLPOVX6.js";
+import "./chunk-DXUICABI.js";
 import "./chunk-4KHEMC32.js";
 import {
   projectRootFrom
 } from "./chunk-ROY4YAEQ.js";
 import "./chunk-WRBKLYSJ.js";
-import "./chunk-DYG5D3FD.js";
-import "./chunk-MN2PB6WB.js";
+import "./chunk-M7GJ6YUF.js";
+import "./chunk-HLQH3AXB.js";
 import "./chunk-LLNZGEFK.js";
-import "./chunk-QXTKSOFI.js";
+import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
-import "./chunk-UCQ2VUTG.js";
+import "./chunk-M6ZFSTIZ.js";
 import "./chunk-DGWHAVRG.js";
-import "./chunk-SBR2WZXG.js";
+import "./chunk-XNZURZ7T.js";
 import {
   isRepresentableName,
   safeNames
@@ -67,4 +67,4 @@ export {
   valueProblem,
   workspaceEnvPathIn
 };
-//# sourceMappingURL=workspace-env-VA7XN3UX.js.map
+//# sourceMappingURL=workspace-env-467C5KHM.js.map

package/dist/{workspace-export-AIGM6LC7.js → workspace-export-3XTVGQVM.js}

@@ -1,13 +1,13 @@
 import {
   assertBranchReadSupported,
   exportWorkspaceBundle
-} from "./chunk-QV3GXQRE.js";
+} from "./chunk-XIABDKFQ.js";
 import "./chunk-3DRXWLJ5.js";
 import "./chunk-X4DVXBFY.js";
-import "./chunk-MN2PB6WB.js";
-import "./chunk-QXTKSOFI.js";
+import "./chunk-HLQH3AXB.js";
+import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
-import "./chunk-SBR2WZXG.js";
+import "./chunk-XNZURZ7T.js";
 import "./chunk-GPI3OWRE.js";
 import "./chunk-UTI5G6OJ.js";
 import "./chunk-5ZSO4T2G.js";
@@ -18,4 +18,4 @@ export {
   assertBranchReadSupported,
   exportWorkspaceBundle
 };
-//# sourceMappingURL=workspace-export-AIGM6LC7.js.map
+//# sourceMappingURL=workspace-export-3XTVGQVM.js.map

package/dist/{writable-FYJBTJOU.js → writable-7SSWUQJ3.js}

@@ -5,9 +5,9 @@ import {
   unreadableError,
   unwritableBlocker,
   unwritableError
-} from "./chunk-3H3EPMFY.js";
+} from "./chunk-UJ6ZZJDD.js";
 import "./chunk-FWD7AL6N.js";
-import "./chunk-SBR2WZXG.js";
+import "./chunk-XNZURZ7T.js";
 import "./chunk-GPI3OWRE.js";
 import "./chunk-UTI5G6OJ.js";
 import "./chunk-5ZSO4T2G.js";
@@ -22,4 +22,4 @@ export {
   unwritableBlocker,
   unwritableError
 };
-//# sourceMappingURL=writable-FYJBTJOU.js.map
+//# sourceMappingURL=writable-7SSWUQJ3.js.map

package/dist/{xano-BSHYVFSE.js → xano-6RS5XQZE.js}

@@ -3,16 +3,16 @@ import {
   Xano,
   standaloneDefKind,
   workspace
-} from "./chunk-5YL5OC2G.js";
+} from "./chunk-SRX6B544.js";
 import "./chunk-45ZUMF4E.js";
 import "./chunk-7KPKDHHI.js";
-import "./chunk-EESV6NU2.js";
-import "./chunk-OPG4DYX2.js";
+import "./chunk-XJU6UAFV.js";
+import "./chunk-JSEVKRVJ.js";
 import "./chunk-ICK36EGF.js";
 import "./chunk-BEXZ4XRV.js";
 import "./chunk-ETAZIGNT.js";
 import "./chunk-GSGDWJB5.js";
-import "./chunk-4PQHO74B.js";
+import "./chunk-VZ22VUAS.js";
 import "./chunk-ERVIASGL.js";
 import "./chunk-VTMTIBKP.js";
 import "./chunk-H2V3N23D.js";
@@ -20,9 +20,9 @@ import "./chunk-3JDU4VRL.js";
 import "./chunk-WTPZRR4I.js";
 import "./chunk-GPI3OWRE.js";
 import "./chunk-UTI5G6OJ.js";
-import "./chunk-OOGXZL7Z.js";
+import "./chunk-OKNE3TWU.js";
 import "./chunk-5ZSO4T2G.js";
-import "./chunk-XNCP4KYO.js";
+import "./chunk-VQPDATQT.js";
 import "./chunk-ZY55DO5P.js";
 import "./chunk-A2AOUBJS.js";
 import "./chunk-UVF45BVU.js";
@@ -40,4 +40,4 @@ export {
   standaloneDefKind,
   workspace
 };
-//# sourceMappingURL=xano-BSHYVFSE.js.map
+//# sourceMappingURL=xano-6RS5XQZE.js.map

package/dist/{xanosdk-import-J6SRBZHW.js → xanosdk-import-E3WSIYUE.js}

@@ -13,23 +13,23 @@ import {
   resetXanoSdkImportDetection,
   withDefaultBranchPointer,
   xanosdkImport
-} from "./chunk-IJ3SXSZM.js";
+} from "./chunk-QOLOQ35F.js";
 import "./chunk-3DRXWLJ5.js";
 import "./chunk-X4DVXBFY.js";
-import "./chunk-MEE5RZ6G.js";
+import "./chunk-5XVBT6CQ.js";
 import "./chunk-4KHEMC32.js";
-import "./chunk-MN2PB6WB.js";
-import "./chunk-QXTKSOFI.js";
+import "./chunk-HLQH3AXB.js";
+import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
-import "./chunk-SBR2WZXG.js";
-import "./chunk-EESV6NU2.js";
+import "./chunk-XNZURZ7T.js";
+import "./chunk-XJU6UAFV.js";
 import "./chunk-H2V3N23D.js";
 import "./chunk-3JDU4VRL.js";
 import "./chunk-GPI3OWRE.js";
 import "./chunk-UTI5G6OJ.js";
-import "./chunk-OOGXZL7Z.js";
+import "./chunk-OKNE3TWU.js";
 import "./chunk-5ZSO4T2G.js";
-import "./chunk-XNCP4KYO.js";
+import "./chunk-VQPDATQT.js";
 import "./chunk-TFFGOFVZ.js";
 import "./chunk-LL6ED5IB.js";
 import "./chunk-4BW2SG2N.js";
@@ -53,4 +53,4 @@ export {
   withDefaultBranchPointer,
   xanosdkImport
 };
-//# sourceMappingURL=xanosdk-import-J6SRBZHW.js.map
+//# sourceMappingURL=xanosdk-import-E3WSIYUE.js.map

package/dist/{xanosdk-project-6KTCO47O.js → xanosdk-project-KH5TZ2KI.js}

@@ -3,28 +3,28 @@ import {
   enterProjectRoot,
   isProjectDir,
   projectDirFrom
-} from "./chunk-T4DUFQ2S.js";
-import "./chunk-E6H5ZEV3.js";
-import "./chunk-HUSH7LRI.js";
-import "./chunk-ZG7E72VI.js";
-import "./chunk-S7E2AHV3.js";
+} from "./chunk-NGAODDLX.js";
+import "./chunk-AGD7F7YI.js";
+import "./chunk-F6IKWAIU.js";
+import "./chunk-OGUMHW2X.js";
+import "./chunk-3VX7VAQT.js";
 import "./chunk-ZFDZKNGG.js";
 import "./chunk-FWD7AL6N.js";
-import "./chunk-3FN2BIGB.js";
-import "./chunk-JTUKLCXS.js";
+import "./chunk-MYLPOVX6.js";
+import "./chunk-DXUICABI.js";
 import "./chunk-4KHEMC32.js";
 import "./chunk-ROY4YAEQ.js";
 import "./chunk-WRBKLYSJ.js";
-import "./chunk-DYG5D3FD.js";
+import "./chunk-M7GJ6YUF.js";
 import "./chunk-EUUUMY7J.js";
-import "./chunk-MN2PB6WB.js";
-import "./chunk-FPBGAT5D.js";
+import "./chunk-HLQH3AXB.js";
+import "./chunk-JZWUAEMO.js";
 import "./chunk-LLNZGEFK.js";
-import "./chunk-QXTKSOFI.js";
+import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
-import "./chunk-UCQ2VUTG.js";
+import "./chunk-M6ZFSTIZ.js";
 import "./chunk-DGWHAVRG.js";
-import "./chunk-SBR2WZXG.js";
+import "./chunk-XNZURZ7T.js";
 import "./chunk-GPI3OWRE.js";
 import "./chunk-UTI5G6OJ.js";
 import "./chunk-5ZSO4T2G.js";
@@ -38,4 +38,4 @@ export {
   isProjectDir,
   projectDirFrom
 };
-//# sourceMappingURL=xanosdk-project-6KTCO47O.js.map
+//# sourceMappingURL=xanosdk-project-KH5TZ2KI.js.map

package/guides/README.md

@@ -18,6 +18,7 @@ typed, so your editor's autocomplete is usually the faster lookup — tab-comple
 | [Environment & identity](environment.md) | Every environment variable, and how `xano.lock` pins identity |
 | [The typed frontend surface](typed-frontend.md) | Path resolution, input/response inference, bundle cost, the route manifest |
 | [Pulling an existing workspace](codegen.md) | What `xanosdk init --from` writes, how faithful it is, and how to read its report |
+| [Reading a compiled bundle](bundle.md) | `@xano/sdk/bundle`: walking, hashing and diffing compiled JSON from your own tools |
 | [Coverage & agent grounding](coverage.md) | What's covered, what's out of scope, and the files agents read |
 
 ## The agent-facing surface

package/guides/authoring.md

@@ -327,8 +327,7 @@ sources.
   increment statement exists. A genuinely safe counter needs the arithmetic in the database
   via `s.db.direct_query`, which in turn needs the table's *physical* Postgres name; that
   name is assigned at import and is not knowable from a `table()` def, so it has to be
-  hardcoded after inspecting the deployed table. A typed path requires an engine change
-  ([issue #35](https://github.com/xanots/sdk/issues/35)).
+  hardcoded after inspecting the deployed table. A typed path requires an engine change.
 - **A JavaScript body is written as a function, not a `c.text` string.** The lambda
   statement (`s.lambda`) and eight filters (`fl.map`/`filter`/`some`/`every`/`find`/
   `findIndex`/`reduce`/`lambda`) run JavaScript against a small, closed set of injected
@@ -402,13 +401,12 @@ sources.
     with a **literal specifier is not portable**: some instances bundle the body before
     running it and resolve every literal specifier ahead of time, so `await
     import("node:crypto")` comes back as the text `Could not resolve "node:crypto"` with
-    HTTP 200; others resolve it at run time and it works
-    ([issue #265](https://github.com/xanots/sdk/issues/265)).
+    HTTP 200; others resolve it at run time and it works.
   - `console` output goes to the **request log**, not stdout.
 
   A plain `c.text(...)` body is still accepted and gets the same build-time check — the
   guard sits at the call site, not inside `lam.*` — so an unknown `$identifier` fails
-  whichever way you write it ([issue #221](https://github.com/xanots/sdk/issues/221)).
+  whichever way you write it.
 - **`c.expression("…")` is carried through verbatim and NOT validated.** Xano SDK does not
   parse it or type-check it; nothing inside participates in `InferResponse`, so a var named
   there is invisible to a rename that updates every typed `ref()`. A malformed expression

package/guides/bundle.md

@@ -0,0 +1,45 @@
+# Reading a compiled bundle
+
+`@xano/sdk` writes a bundle; `@xano/sdk/bundle` reads one back. It is the surface for
+tools that take compiled JSON as input — a graph view, a diff, a linter, a docs generator —
+so none of them has to reverse-engineer the storage shape and then go quietly wrong when the
+engine grows a new one.
+
+A bundle is what `export` writes:
+
+```bash
+npx xanosdk export ./xano/index.ts --out workspace.json
+```
+
+```ts
+import { readFile } from "node:fs/promises";
+import { statementCatalog, walk } from "@xano/sdk/bundle";
+
+const bundle = JSON.parse(await readFile("bundle.json", "utf8"));
+const catalog = statementCatalog();
+
+for (const { raw, path, depth } of walk(bundle.payload.query[0].run)) {
+  console.log(`${"  ".repeat(depth)}${path}  ${catalog.get(raw.name)?.sPath ?? raw.name}`);
+}
+// 0       db.query
+// 1       conditional
+// 1.if.0  db.add
+```
+
+- **`walk(run)`** → every statement in the tree, each with a `path` and a `depth`. The path
+  format (`2.if.0`) is the shared address: a lint finding, a review comment and a runtime
+  error written by three different tools all name the same node.
+- **`subStacks(raw)`** → the nested stacks a statement carries, keyed by where they are
+  stored and labelled by what they mean — a try/catch and a conditional share the same three
+  storage keys. Found by shape, so a nesting form added later is still walked.
+- **`statementCatalog()`** → the stored `mvp:*` name to its authoring path, minus the
+  namespace (`mvp:dbo_view` → `db.query`, the `sPath` you write after `s.`) — which is
+  the point: the stored name is often not the one you'd guess.
+- **`structuralHash(raw)`** → a diff key for a statement and everything under it, with
+  engine-filled operands excluded — so adding a column to a table leaves `db.edit` /
+  `db.add_or_edit` unchanged. A `db.add` writes every column, so its hash does change.
+- **`tableRefOf(column)` / `linkedTableOf(column)`** → the table a column points at.
+- **`normalize(value)`** → the normalizer `xanosdk preflight` compares with, for diffing a
+  stored workspace against a compiled one.
+
+Everything on the entry is pure — no filesystem, network, or Node built-ins — so it runs anywhere.