@xano/sdk 1.0.15 → 1.0.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (290) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/README.md +33 -37
  3. package/dist/.build-fingerprint +1 -1
  4. package/dist/{agent-file-refresh-ZRGNOA6Q.js → agent-file-refresh-QTFMNYPY.js} +12 -12
  5. package/dist/{agent-skill-command-DV26SDA2.js → agent-skill-command-XZVBG34H.js} +74 -73
  6. package/dist/{answer-shape-AVZSKBR6.js → answer-shape-ZRQS7ZC4.js} +5 -5
  7. package/dist/{backend-dir-NTMXWE5R.js → backend-dir-DCT3T6HP.js} +11 -11
  8. package/dist/{backend-slot-DZAUHLTS.js → backend-slot-7BATLL3X.js} +4 -4
  9. package/dist/bin.js +64 -63
  10. package/dist/{branch-IJTBZZFO.js → branch-SJKKUCMZ.js} +9 -9
  11. package/dist/branch-commands-OEMOFAKC.js +80 -0
  12. package/dist/bundle.d.ts +2 -2
  13. package/dist/bundle.js +15 -69
  14. package/dist/{capture-GW5KNKMB.js → capture-RYBJE25P.js} +5 -5
  15. package/dist/{chunk-3H7R4ISR.js → chunk-2DUYJR5N.js} +2 -2
  16. package/dist/{chunk-MFWF2NZJ.js → chunk-2H5BQRHF.js} +2 -2
  17. package/dist/{chunk-GDJCWQIK.js → chunk-2IC3K22K.js} +12 -8
  18. package/dist/{chunk-O44MJTLR.js → chunk-35SI4GBM.js} +3 -3
  19. package/dist/{chunk-VUWR5YLE.js → chunk-3QQFP3AD.js} +13 -13
  20. package/dist/{chunk-ICK36EGF.js → chunk-4EVDCSEY.js} +2 -2
  21. package/dist/{chunk-GIQIMWTK.js → chunk-4LT5AVHF.js} +14 -14
  22. package/dist/{chunk-AXMUYBWQ.js → chunk-4XGZ325S.js} +3 -3
  23. package/dist/{chunk-JWASCOHO.js → chunk-52QAENY6.js} +14 -14
  24. package/dist/{chunk-2LF734YB.js → chunk-54CJ74BH.js} +4 -4
  25. package/dist/{chunk-ASQX477B.js → chunk-573RRKNT.js} +7 -7
  26. package/dist/{chunk-3GZMP7II.js → chunk-5AVFVC22.js} +38 -22
  27. package/dist/{chunk-IKXXTRMN.js → chunk-64UVVLDT.js} +4 -4
  28. package/dist/{chunk-RBTZEHXF.js → chunk-6DSA6W4O.js} +3 -3
  29. package/dist/{chunk-EQXHUWUO.js → chunk-6FCAFWD5.js} +2 -2
  30. package/dist/{chunk-4MX5LMPQ.js → chunk-6ODQ5GDZ.js} +2 -2
  31. package/dist/{chunk-ZF2CBXT5.js → chunk-7NKC4MBT.js} +3 -3
  32. package/dist/{chunk-Y5XAPLZS.js → chunk-7UQZ7C4W.js} +4 -4
  33. package/dist/{chunk-CJDPSCMX.js → chunk-7ZVQIKNL.js} +3 -3
  34. package/dist/{chunk-FOBVJ2UR.js → chunk-ACFBRMCS.js} +8 -8
  35. package/dist/{chunk-RVAEPPRH.js → chunk-AICWDCLJ.js} +2 -2
  36. package/dist/{chunk-WS4BA75E.js → chunk-AJBOGO5U.js} +4 -4
  37. package/dist/{chunk-AE5CRAKS.js → chunk-ANUBTY3C.js} +8 -8
  38. package/dist/{chunk-UVHSMANV.js → chunk-C6RBLPFY.js} +47 -47
  39. package/dist/{chunk-SHHXLI2K.js → chunk-CNNGNK46.js} +7 -7
  40. package/dist/{chunk-7ZQ73AHJ.js → chunk-CWC6HE66.js} +31 -31
  41. package/dist/{chunk-A2N2C2WD.js → chunk-DNUU4IEM.js} +7 -7
  42. package/dist/{chunk-Q7DGTQ5G.js → chunk-E34VGSCI.js} +2 -1
  43. package/dist/{chunk-YR3MNGWZ.js → chunk-E5M5P23K.js} +8 -8
  44. package/dist/{chunk-HJZUI2ZU.js → chunk-EAZTRU75.js} +2 -2
  45. package/dist/{chunk-KMKUH2IO.js → chunk-EPB6FAR5.js} +5 -5
  46. package/dist/{chunk-B6AFJVG4.js → chunk-ES6FBPLY.js} +5 -5
  47. package/dist/chunk-EUAU4QKI.js +67 -0
  48. package/dist/{chunk-IDOVZLPK.js → chunk-EXJ4Q5F6.js} +2 -2
  49. package/dist/{chunk-FKQX6KU7.js → chunk-F3JK5RIY.js} +2 -2
  50. package/dist/{chunk-W2QFR3ZJ.js → chunk-FIOC7RSU.js} +2 -2
  51. package/dist/{chunk-YEH5OIPF.js → chunk-FMXPV5JI.js} +39 -11
  52. package/dist/{chunk-GVHWIDEJ.js → chunk-FRJB3NTE.js} +10 -5
  53. package/dist/{chunk-TXFOQZUQ.js → chunk-FSHW3GQU.js} +14 -7
  54. package/dist/{chunk-VIRFG3WG.js → chunk-FTFAPKCW.js} +23 -7
  55. package/dist/{chunk-LL6ED5IB.js → chunk-FTS42N37.js} +2 -2
  56. package/dist/{chunk-HCNIB3EC.js → chunk-FYPTWYCU.js} +4 -4
  57. package/dist/{chunk-MIS6F4HM.js → chunk-G2XSDIYS.js} +4 -4
  58. package/dist/{chunk-ZY55DO5P.js → chunk-G6BEJ3NA.js} +2 -2
  59. package/dist/{chunk-RYWNNJK5.js → chunk-GA6HTO3O.js} +2 -2
  60. package/dist/{chunk-ZYECXDVV.js → chunk-GBPIFCWL.js} +5 -5
  61. package/dist/{chunk-JIKGT7DO.js → chunk-GE3JV5SI.js} +1 -1
  62. package/dist/{chunk-GCINMMFL.js → chunk-GJZMKMWO.js} +2 -2
  63. package/dist/{chunk-6X73VFCX.js → chunk-GT7PZCTK.js} +2 -2
  64. package/dist/{chunk-TT6LN55R.js → chunk-GUC73LRA.js} +8 -8
  65. package/dist/{chunk-ZC6H2ERE.js → chunk-GYM22X2X.js} +5 -5
  66. package/dist/{chunk-V7WCTXEH.js → chunk-H3R4PAOI.js} +5 -5
  67. package/dist/{chunk-QW7NGUYW.js → chunk-H5OM5G3O.js} +244 -173
  68. package/dist/{chunk-WXKSB2N3.js → chunk-HM5X73PY.js} +3 -3
  69. package/dist/{chunk-K6SWZ6H4.js → chunk-HMV2VGTU.js} +54 -54
  70. package/dist/{chunk-G4WRZU5T.js → chunk-HXFUCPZO.js} +7 -7
  71. package/dist/{chunk-ECQXASG3.js → chunk-IFHFJR5O.js} +2 -2
  72. package/dist/{chunk-7AKH4QDJ.js → chunk-J2KY2VNC.js} +96 -65
  73. package/dist/{chunk-74OPNM2Z.js → chunk-JHAZK4RY.js} +3 -3
  74. package/dist/{chunk-JAYHFXWH.js → chunk-LWGCUB2A.js} +7 -7
  75. package/dist/{chunk-CJGLAQRD.js → chunk-LXJ72GY2.js} +4 -4
  76. package/dist/{chunk-OZWAITII.js → chunk-M2IB6N4V.js} +6 -6
  77. package/dist/{chunk-GKQTXUOW.js → chunk-MOVRSULZ.js} +2 -2
  78. package/dist/{chunk-QAEBBTYR.js → chunk-MSYMEP7Y.js} +7 -7
  79. package/dist/{chunk-Y453TW6J.js → chunk-NCERS5QH.js} +2 -2
  80. package/dist/{chunk-T3HNISBN.js → chunk-NDRIMFSH.js} +3 -3
  81. package/dist/{chunk-HXFLHA5K.js → chunk-NH5Z2NOD.js} +2 -2
  82. package/dist/{chunk-FXZEZAV2.js → chunk-NLWYNVJV.js} +3 -3
  83. package/dist/{chunk-66ZU2CD5.js → chunk-O2BLNQEC.js} +236 -17
  84. package/dist/{chunk-5SKWGCAJ.js → chunk-O7Z3LF44.js} +5 -5
  85. package/dist/{chunk-DBDTQR23.js → chunk-OTQF4B37.js} +4 -4
  86. package/dist/{chunk-SL55XKVL.js → chunk-PCY4IPXK.js} +25 -25
  87. package/dist/{chunk-ZDVVIJPU.js → chunk-PODT53SQ.js} +4 -4
  88. package/dist/{chunk-GBSHHNSD.js → chunk-PRSNMSVG.js} +3 -3
  89. package/dist/{chunk-UNFQN3TT.js → chunk-Q3CBDXKL.js} +3 -3
  90. package/dist/{chunk-P7GKTV7N.js → chunk-Q4LJCCH5.js} +75 -32
  91. package/dist/{chunk-DGYXCIBV.js → chunk-Q6AKSLD2.js} +2 -2
  92. package/dist/{chunk-7FIMUFBP.js → chunk-QDPY7RN3.js} +3 -3
  93. package/dist/{chunk-MGG4CHO4.js → chunk-QIT2GGNB.js} +3 -3
  94. package/dist/{chunk-VXHXSGPU.js → chunk-QTOW6YXL.js} +8 -8
  95. package/dist/{chunk-5SJQAJLF.js → chunk-QYZSNN35.js} +3 -3
  96. package/dist/{chunk-NNI5R6V6.js → chunk-R7Y6S7FF.js} +72 -72
  97. package/dist/{chunk-BEKEOXNG.js → chunk-RGPHFHJU.js} +2 -2
  98. package/dist/{chunk-YCKKL5PD.js → chunk-RH3NQTGQ.js} +53 -47
  99. package/dist/{chunk-5FJ4M4HB.js → chunk-RHH6SCB4.js} +17 -32
  100. package/dist/{chunk-M7O3T7IM.js → chunk-RIT3WBBX.js} +4 -4
  101. package/dist/{chunk-45K2QZBR.js → chunk-RKNCISPM.js} +3 -3
  102. package/dist/{chunk-NPYYDTXS.js → chunk-RKTVXFBV.js} +5 -5
  103. package/dist/{chunk-AXNX4NWN.js → chunk-RLQX6LHW.js} +37 -37
  104. package/dist/{chunk-FIERONKM.js → chunk-ROWYW3JF.js} +2 -2
  105. package/dist/{chunk-LSJ3SQEU.js → chunk-RVWWNNZQ.js} +4 -4
  106. package/dist/{chunk-4MIV244X.js → chunk-SGEOXJIH.js} +9 -2
  107. package/dist/{chunk-QRMKQYCB.js → chunk-SINL5WMI.js} +2 -2
  108. package/dist/{chunk-Z6N5N4MN.js → chunk-SIW2HT2H.js} +21 -5
  109. package/dist/{chunk-IEDQT4Z3.js → chunk-SOAZIMWL.js} +12 -12
  110. package/dist/{chunk-R3GPRNBT.js → chunk-SVQMDVND.js} +87 -16
  111. package/dist/{chunk-45ZUMF4E.js → chunk-TPUAXIPR.js} +2 -2
  112. package/dist/{chunk-76SBT7KS.js → chunk-U56HK2RG.js} +7 -5
  113. package/dist/{chunk-RXNMZM6H.js → chunk-UDW2KAVF.js} +6 -6
  114. package/dist/{chunk-NDV6CBR7.js → chunk-UH5VQGNR.js} +2 -2
  115. package/dist/{chunk-75QC66XI.js → chunk-V2MIBJZU.js} +2 -2
  116. package/dist/{chunk-N72XNQNJ.js → chunk-V4466NNS.js} +14 -14
  117. package/dist/{chunk-XPSDDTUZ.js → chunk-VCFRALU7.js} +3 -3
  118. package/dist/{chunk-5KJBWIDZ.js → chunk-VQDVEHDB.js} +2 -2
  119. package/dist/{chunk-6EFXPTHT.js → chunk-WAP5362D.js} +5 -5
  120. package/dist/{chunk-DH6O5NQU.js → chunk-WDN4QIJ4.js} +29 -20
  121. package/dist/{chunk-XLP4CNSF.js → chunk-WGGATSIP.js} +6 -6
  122. package/dist/{chunk-XY4OBD26.js → chunk-WGKKDGSA.js} +4 -4
  123. package/dist/{chunk-ZPJXWMHK.js → chunk-WLZSKD7E.js} +4 -4
  124. package/dist/{chunk-7REDHC4N.js → chunk-X5NF3ZXW.js} +69 -14
  125. package/dist/{chunk-5W7S2SCA.js → chunk-XAE4NIZ2.js} +4 -4
  126. package/dist/{chunk-SPLRKCFV.js → chunk-XDGLYIB2.js} +2 -2
  127. package/dist/{chunk-WS2X5BB2.js → chunk-YYBBJPCL.js} +5 -5
  128. package/dist/{chunk-ZOHEHIFS.js → chunk-YYDM4DNP.js} +2 -2
  129. package/dist/{chunk-SH4RY6QX.js → chunk-Z73I7Q2H.js} +1536 -413
  130. package/dist/{chunk-GRXX2TOJ.js → chunk-ZHFSIQ6E.js} +2 -2
  131. package/dist/{chunk-SXMZNSQ6.js → chunk-ZQUBCGGR.js} +8 -8
  132. package/dist/{chunk-ZRXDPCMN.js → chunk-ZYZ7GRX3.js} +2 -2
  133. package/dist/cli.d.ts +3 -3
  134. package/dist/cli.js +62 -61
  135. package/dist/codegen-command-HCHTNHDF.js +183 -0
  136. package/dist/codegen.d.ts +3 -3
  137. package/dist/codegen.js +5 -5
  138. package/dist/{commands-5ILSWDSV.js → commands-Z2QZOORB.js} +3 -3
  139. package/dist/{completion-UNKBVVDT.js → completion-LFXXNQGR.js} +3 -3
  140. package/dist/{config-NTOASFCA.js → config-7GGINOFY.js} +4 -4
  141. package/dist/{deploy-command-BYAZZF37.js → deploy-command-LYZ76OBA.js} +69 -68
  142. package/dist/{deploy-source-QCPZWNJO.js → deploy-source-AJESF6J2.js} +32 -32
  143. package/dist/{dev-env-sync-6MHK3UHC.js → dev-env-sync-PZEIRCFC.js} +63 -62
  144. package/dist/{diagnostics-FNVNRYMB.js → diagnostics-T3RN3372.js} +2 -2
  145. package/dist/{display-name-hint-MYXCCAOP.js → display-name-hint-5GLJGPQ6.js} +11 -11
  146. package/dist/{emit-YLt3GfsZ.d.ts → emit-DlOKIJER.d.ts} +185 -96
  147. package/dist/env-example-refresh-HLE2HRV4.js +136 -0
  148. package/dist/{env-pull-command-KUIEKBTM.js → env-pull-command-OTTZHTLK.js} +52 -52
  149. package/dist/{env-target-Y77RLRS5.js → env-target-VXOMKCMO.js} +14 -14
  150. package/dist/{env-var-command-BZWJD75C.js → env-var-command-TDVSO3JY.js} +41 -41
  151. package/dist/{ephemeral-VLPRDNEJ.js → ephemeral-2DXWP3VK.js} +9 -9
  152. package/dist/{ephemeral-command-SYKDPALW.js → ephemeral-command-AX5TRR23.js} +52 -52
  153. package/dist/{ephemeral-state-RUOU2GFS.js → ephemeral-state-56XEDUJW.js} +12 -12
  154. package/dist/{generate-command-CSQDQZSW.js → generate-command-LMSKMR4J.js} +89 -88
  155. package/dist/{gitignore-OQGYM7DO.js → gitignore-GKM5G2DJ.js} +15 -15
  156. package/dist/{guards-JUYBDLZY.js → guards-LQ7PSXOL.js} +51 -15
  157. package/dist/{impersonate-command-HSFCZBV6.js → impersonate-command-QTEOBL5N.js} +37 -37
  158. package/dist/{import-T4ZTOTBT.js → import-VJQGIS33.js} +5 -5
  159. package/dist/index.d.ts +597 -118
  160. package/dist/index.js +29 -28
  161. package/dist/init-command-OMZVE54Z.js +143 -0
  162. package/dist/{init-modules-BL2SR5RK.js → init-modules-OTISW6LL.js} +8 -8
  163. package/dist/{init-web-DYE2FEXL.js → init-web-25QJ4JWB.js} +3 -3
  164. package/dist/internal.d.ts +55 -8
  165. package/dist/internal.js +696 -506
  166. package/dist/{io-PGTCBSIQ.js → io-47TFRYDB.js} +6 -6
  167. package/dist/{keep-data-merge-SHF75FC7.js → keep-data-merge-ECLY5DYP.js} +38 -38
  168. package/dist/{lambda-config-reconcile-VOBVZPWS.js → lambda-config-reconcile-CC5QIP6E.js} +3 -3
  169. package/dist/{landed-F7PCHGCK.js → landed-VIUFHLCJ.js} +5 -5
  170. package/dist/{landing-record-7EOLEKH3.js → landing-record-RVE5WLFS.js} +22 -22
  171. package/dist/{live-diff-M2OLXKM6.js → live-diff-KJ2TWWWT.js} +14 -14
  172. package/dist/{local-engine-choice-TOC3UYZZ.js → local-engine-choice-CMG5V7RL.js} +35 -35
  173. package/dist/{local-engine-command-6KSRDZBR.js → local-engine-command-UMY37AZL.js} +40 -40
  174. package/dist/{local-engine-deploy-4N4NFZ4T.js → local-engine-deploy-XAEDT55W.js} +12 -12
  175. package/dist/{local-engine-lookup-AQTUGSBT.js → local-engine-lookup-WBYTY2JE.js} +2 -2
  176. package/dist/{local-engine-mcp-bridge-AMYRH4SY.js → local-engine-mcp-bridge-3H5OXBWQ.js} +5 -5
  177. package/dist/{local-engine-mcp-command-XTP3EATV.js → local-engine-mcp-command-AV2T3U4B.js} +42 -42
  178. package/dist/{local-engine-process-OD5OSWDG.js → local-engine-process-35B2KQED.js} +7 -7
  179. package/dist/{local-engine-update-check-G3YCBXRE.js → local-engine-update-check-VXJZSIJU.js} +5 -5
  180. package/dist/{lock-HDCHD2ON.js → lock-JBKTDEDO.js} +4 -4
  181. package/dist/{lock-commands-437P6BHY.js → lock-commands-PSKHBOKS.js} +67 -66
  182. package/dist/{login-command-BNRDAVFV.js → login-command-M7RKU3DR.js} +27 -27
  183. package/dist/{logout-command-FCGCHB7Y.js → logout-command-DAC3XKLT.js} +17 -17
  184. package/dist/{loop-WOAEXMTC.js → loop-HILLODVH.js} +15 -15
  185. package/dist/{marketplace-command-SUBJZPJV.js → marketplace-command-2M33OTSN.js} +30 -30
  186. package/dist/{marketplace-resolve-JR4BBJ6K.js → marketplace-resolve-63QWMQZU.js} +6 -6
  187. package/dist/{meta-client-AYJS3RQ3.js → meta-client-FC4DWPAC.js} +15 -15
  188. package/dist/{module-manifest-63I5GRK4.js → module-manifest-NWJWAQLQ.js} +4 -4
  189. package/dist/node.d.ts +8 -8
  190. package/dist/node.js +71 -70
  191. package/dist/{operation-outcome-ORQPVJKB.js → operation-outcome-3V4G7QD3.js} +24 -24
  192. package/dist/{output-target-KNHHNDM3.js → output-target-LTU4L3IA.js} +16 -16
  193. package/dist/{plan-disclosure-4DUFRGCP.js → plan-disclosure-6MG4YYJV.js} +28 -28
  194. package/dist/{plugin-contributions-YYEP7IWH.js → plugin-contributions-DD6R6RL6.js} +5 -5
  195. package/dist/{plugin-prompt-GKCQKNYI.js → plugin-prompt-UX2TT5NS.js} +5 -5
  196. package/dist/{plugin-questions-P7MA3TYI.js → plugin-questions-WE2F4ZC4.js} +4 -4
  197. package/dist/{preflight-command-32GFVKSN.js → preflight-command-724B7Y73.js} +75 -74
  198. package/dist/{profile-command-U2XTKOMF.js → profile-command-REIJ4F3Y.js} +28 -28
  199. package/dist/{profile-pointer-JJ7K5O2R.js → profile-pointer-RCPHVTJV.js} +4 -4
  200. package/dist/{project-dependency-X3KCWBK5.js → project-dependency-TPVV3YIX.js} +7 -7
  201. package/dist/{project-sdk-YHJZRCNB.js → project-sdk-DKZBK5H5.js} +4 -4
  202. package/dist/promote-command-5FK2NFHG.js +149 -0
  203. package/dist/{prompt-QNMJIWNI.js → prompt-OYQHQWKI.js} +4 -4
  204. package/dist/{publish-command-5ZVZ6IYT.js → publish-command-VEDUWLVB.js} +72 -71
  205. package/dist/pull-command-UXNEJSDI.js +171 -0
  206. package/dist/{pull-superseded-6HADGGC5.js → pull-superseded-3SSM3JFT.js} +4 -4
  207. package/dist/{raw-where-gWGr-E4t.d.ts → raw-where-CinW0keO.d.ts} +32 -4
  208. package/dist/release-command-BCKJ4BUN.js +153 -0
  209. package/dist/{release-ns-command-LDN5DOKQ.js → release-ns-command-VFI4PPSX.js} +96 -95
  210. package/dist/{retry-command-LFZYEVRU.js → retry-command-WP4ZI6CJ.js} +8 -8
  211. package/dist/{routes-manifest-BMAOL6WN.js → routes-manifest-N73THJB3.js} +16 -16
  212. package/dist/routes-manifest-file-R3JLJ5CA.js +41 -0
  213. package/dist/scaffold.js +2 -2
  214. package/dist/{secrets-file-7QM3ORGX.js → secrets-file-GF46TDY7.js} +15 -15
  215. package/dist/{secrets-fill-command-OZ537VOD.js → secrets-fill-command-HKNROT6W.js} +66 -65
  216. package/dist/{seed-ATGBOEJP.js → seed-W5FNE6IB.js} +13 -13
  217. package/dist/{source-resolve-QYSWA3QR.js → source-resolve-QYSVNJMY.js} +22 -22
  218. package/dist/{static-host-MO4VDHL7.js → static-host-3HPZKVKK.js} +5 -5
  219. package/dist/{status-command-IEB4K7ME.js → status-command-RLXDDCZA.js} +38 -38
  220. package/dist/{store-AJX4MC7Y.js → store-B63BQV6R.js} +6 -6
  221. package/dist/{store-DspGMsFY.d.ts → store-Dg9FLJkx.d.ts} +185 -11
  222. package/dist/sync-baseline-GRS33AB5.js +38 -0
  223. package/dist/{sync-contributions-DLV5JZUK.js → sync-contributions-BV7DFWBZ.js} +9 -9
  224. package/dist/{sync-record-NE62ERA3.js → sync-record-AWFCSS4D.js} +15 -15
  225. package/dist/{table-TFD4ZQXA.js → table-WJ7YDJ6Q.js} +12 -12
  226. package/dist/{tables-command-IMCVPUFY.js → tables-command-EXHXLLN6.js} +41 -41
  227. package/dist/{tenant-IIYECNWO.js → tenant-IXIW3FOI.js} +10 -10
  228. package/dist/{tenant-command-77KG76MU.js → tenant-command-D5H7MR3C.js} +104 -103
  229. package/dist/{test-command-NSPU4RUO.js → test-command-ORMWZXC3.js} +56 -45
  230. package/dist/{tests-JWQRHFCT.js → tests-N4MMBABH.js} +6 -6
  231. package/dist/{token-BDHD7GU3.js → token-EFSD6WSQ.js} +13 -13
  232. package/dist/{toolchain-hooks-QHJRDCRW.js → toolchain-hooks-IJWV3ZQS.js} +18 -18
  233. package/dist/{toolchain-modules-LY7BMYG6.js → toolchain-modules-BC37MYYD.js} +5 -5
  234. package/dist/{toolchain-peers-FQJBTKEB.js → toolchain-peers-EMOYN4U7.js} +8 -8
  235. package/dist/{tracked-backend-BIR7YJCE.js → tracked-backend-IPEGNGNI.js} +34 -34
  236. package/dist/update-check-4YTFF7NB.js +141 -0
  237. package/dist/{upgrade-command-YCADQCIA.js → upgrade-command-J4CPYEGO.js} +68 -67
  238. package/dist/{whoami-command-IZCTUPM4.js → whoami-command-XGVTKQSL.js} +16 -16
  239. package/dist/{workspace-TK52V7WO.js → workspace-JGUNVFRE.js} +5 -5
  240. package/dist/{workspace-binding-3UT6PP4B.js → workspace-binding-MQ2QIWOJ.js} +15 -15
  241. package/dist/{workspace-command-46OCB6XT.js → workspace-command-LSEG62RA.js} +100 -99
  242. package/dist/{workspace-env-PVPOWFNZ.js → workspace-env-7U7OLRUO.js} +18 -12
  243. package/dist/{workspace-export-PUEXKZNS.js → workspace-export-3KMWNZDD.js} +5 -5
  244. package/dist/{writable-LMMG4AFZ.js → writable-X7BCN7XE.js} +4 -4
  245. package/dist/xano-RLSNDM7O.js +44 -0
  246. package/dist/{xanosdk-import-XXJT365U.js → xanosdk-import-Y5SBF4LP.js} +10 -10
  247. package/dist/{xanosdk-project-CJKRLQ6U.js → xanosdk-project-5XARMFZ7.js} +13 -13
  248. package/dist/{xdo-D4OwfF2J.d.ts → xdo-DNGZGO1j.d.ts} +50 -12
  249. package/guides/authoring.md +1 -0
  250. package/guides/codes.md +33 -3
  251. package/guides/coverage.md +2 -2
  252. package/guides/object-kinds.md +1 -1
  253. package/guides/typed-frontend.md +9 -0
  254. package/llms/client.md +54 -36
  255. package/llms/errors.md +26 -6
  256. package/llms/fields.md +56 -32
  257. package/llms/filters.md +55 -46
  258. package/llms/kinds-agent-mcp.md +10 -9
  259. package/llms/kinds-core.md +19 -15
  260. package/llms/kinds-knowledge.md +4 -4
  261. package/llms/kinds-realtime.md +25 -23
  262. package/llms/lambda.md +42 -30
  263. package/llms/legacy.md +6 -7
  264. package/llms/lock.md +21 -17
  265. package/llms/object-kinds.md +9 -11
  266. package/llms/statements-calls.md +41 -20
  267. package/llms/statements-catalog.md +32 -25
  268. package/llms/statements-data.md +35 -25
  269. package/llms/statements-runtime.md +28 -18
  270. package/llms/tests.md +20 -7
  271. package/llms/toolchain.md +12 -9
  272. package/llms/triggers.md +15 -19
  273. package/llms/values.md +16 -9
  274. package/llms-full.txt +647 -506
  275. package/llms.txt +120 -137
  276. package/manifest.json +147 -95
  277. package/package.json +1 -1
  278. package/skills/xano-backend/SKILL.md +10 -12
  279. package/types/lambda-globals.d.ts +6 -1
  280. package/dist/branch-commands-4PJEBNRK.js +0 -80
  281. package/dist/codegen-command-RDD4GL35.js +0 -182
  282. package/dist/env-example-refresh-MQWHY7ZS.js +0 -135
  283. package/dist/init-command-6Z7QNVDY.js +0 -142
  284. package/dist/promote-command-OO56IZBT.js +0 -148
  285. package/dist/pull-command-LT5PCEIW.js +0 -170
  286. package/dist/release-command-RBUOXIH7.js +0 -152
  287. package/dist/routes-manifest-file-MPOVKD6N.js +0 -41
  288. package/dist/sync-baseline-IB7MABZO.js +0 -38
  289. package/dist/update-check-JDARCXAX.js +0 -140
  290. package/dist/xano-EOUVXNQX.js +0 -43
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  classifyNpmFailure
3
- } from "./chunk-OZWAITII.js";
3
+ } from "./chunk-M2IB6N4V.js";
4
4
  import {
5
5
  condenseNpmError,
6
6
  runNpmQuiet,
@@ -15,7 +15,7 @@ import {
15
15
  isSorted,
16
16
  reactPreset,
17
17
  sortedKeys
18
- } from "./chunk-5FJ4M4HB.js";
18
+ } from "./chunk-RHH6SCB4.js";
19
19
  import {
20
20
  blockVersion,
21
21
  composeBlock,
@@ -38,7 +38,7 @@ import {
38
38
  success,
39
39
  warn,
40
40
  withSpinner
41
- } from "./chunk-GRXX2TOJ.js";
41
+ } from "./chunk-ZHFSIQ6E.js";
42
42
  import {
43
43
  defaultThemeChoice,
44
44
  themeGuidanceSection
@@ -59,9 +59,8 @@ server-side logic (\`defineFunction()\` and statement stacks), scheduled tasks (
59
59
  triggers and webhooks, realtime channels, file storage, and AI agents and MCP servers. Only
60
60
  the kinds registered in \`xano/index.ts\` exist in this project \u2014 check before assuming. The
61
61
  frontend calls the deployed backend over HTTP and holds no business logic.`;
62
- var LEARN_FROM_THE_LIBRARY = `**${GUIDANCE_SENTINEL}.** You have almost certainly not seen this SDK.
63
- What you know about driving Xano comes from interfaces with different shapes, and
64
- carrying it over produces code that reads well, type-checks, and is wrong. Read before
62
+ var LEARN_FROM_THE_LIBRARY = `**${GUIDANCE_SENTINEL}.** This SDK is not in your training data;
63
+ patterns carried over from other Xano interfaces type-check and are wrong. Read before
65
64
  writing:
66
65
 
67
66
  1. \`node_modules/@xano/sdk/llms.txt\` \u2014 the router, and the whole always-read
@@ -133,8 +132,9 @@ npm run dev # the frontend, pointed at the engine through .env.local
133
132
  - \`npm run xano:export\` \u2014 compile the backend to \`workspace.json\` (never commit it).
134
133
  - \`npm run xano:test\` \u2014 run the DEPLOYED environment's unit + workflow tests (exits 5 on a
135
134
  failure). Deploy first. See "Testing" below.
136
- - \`npm run xano:check\` \u2014 the CI gate: a strict export, a stale \`routes.gen.ts\`, lock drift.
137
- It writes nothing and needs no secrets. Run it before calling the work done.
135
+ - \`npm run xano:check\` \u2014 the CI gate: \`routes --strict\` (a missing or stale \`routes.gen.ts\`),
136
+ the typecheck, and a strict \`export --check\` (any build warning, lock drift). It writes
137
+ nothing and needs no secrets. Run it before calling the work done, and again after any merge.
138
138
  - \`npx @xano/sdk login\` then \`npm run xano:deploy:ephemeral\` \u2014 ship the backend + static
139
139
  frontend to a disposable **ephemeral** environment on Xano's cloud;
140
140
  \`npm run xano:deploy:frontend\` republishes only the frontend.
@@ -172,7 +172,7 @@ then land it with \`npx @xano/sdk promote <name>\` (\`npx @xano/sdk tenant deplo
172
172
  for a customer tenant). A promote lands on a branch that serves nothing until it is live
173
173
  (\`--set-live\`, or \`npx @xano/sdk workspace branch set-live <label>\` later).
174
174
  \`npx @xano/sdk deploy --to workspace\` skips the release and merges the local build straight
175
- in, leaving nothing to roll back to. Run any of these only when asked.`;
175
+ in, leaving nothing to roll back to.`;
176
176
  function backendWorkflow(mode) {
177
177
  return `### Development workflow
178
178
 
@@ -195,8 +195,9 @@ npm run xano:deploy # typecheck, then deploy the backend to the Xano Engine o
195
195
  - \`npm run xano:export\` \u2014 compile the backend to \`workspace.json\` (never commit it).
196
196
  - \`npm run xano:test\` \u2014 run the DEPLOYED environment's unit + workflow tests (exits 5 on a
197
197
  failure). Deploy first. See "Testing" below.
198
- - \`npm run xano:check\` \u2014 the CI gate: a strict export, a stale \`routes.gen.ts\`, lock drift.
199
- It writes nothing and needs no secrets. Run it before calling the work done.
198
+ - \`npm run xano:check\` \u2014 the CI gate: \`routes --strict\` (a missing or stale \`routes.gen.ts\`),
199
+ the typecheck, and a strict \`export --check\` (any build warning, lock drift). It writes
200
+ nothing and needs no secrets. Run it before calling the work done, and again after any merge.
200
201
  - \`npx @xano/sdk login\` then \`npm run xano:deploy:ephemeral\` \u2014 ship the backend to a
201
202
  disposable **ephemeral** environment on Xano's cloud.
202
203
  - Not signed in? Ask the user whether they have a Xano account; don't guess from context.
@@ -259,8 +260,7 @@ function xanoSdk(frontend) {
259
260
 
260
261
  ${frontend ? FRONTEND_CONTRACT : CLIENT_CONTRACT}`;
261
262
  }
262
- function backendChanges(frontend) {
263
- const typecheck = frontend ? "typecheck" : "xano:typecheck";
263
+ function backendChanges() {
264
264
  return `### Backend changes
265
265
 
266
266
  - Match the naming already in \`xano/\`: snake_case object names, uppercase verbs, the
@@ -273,7 +273,7 @@ function backendChanges(frontend) {
273
273
  the frontend.
274
274
  - Add \`tests: [...]\` to new queries and functions (a \`workflowTest()\` where the behavior
275
275
  spans objects), then \`npm run xano:deploy\` and \`npm run xano:test\`.
276
- - Finish with \`npm run xano:routes\`, \`npm run ${typecheck}\` and \`npm run xano:check\`, and
276
+ - Finish with \`npm run xano:routes\` and \`npm run xano:check\`, and
277
277
  commit \`xano/routes.gen.ts\` and \`xano/xano.lock\` with the change.`;
278
278
  }
279
279
  var AGENT_RULE_BACKENDS = [
@@ -302,9 +302,9 @@ function agentGuidance(frontend) {
302
302
  - Do not invent Xano APIs, statements, or SDK methods; when unsure, read the installed
303
303
  docs and types named under "Source of truth".
304
304
  ${frontend ? `${FRONTEND_DATA_LAYER_RULE}
305
- ` : ""}- Do not run \`npx @xano/sdk pull\`, \`promote\`, \`deploy --to workspace\`, \`tenant deploy\`, or
306
- \`local update\` unless asked: \`pull\` overwrites \`xano/\`, and the others change shared
307
- environments or the pinned engine.
305
+ ` : ""}- Do not run \`npx @xano/sdk pull\`, \`release create\`, \`promote\`, \`deploy --to workspace\`,
306
+ \`tenant deploy\`, \`workspace branch set-live\`, or \`local update\` unless asked: \`pull\`
307
+ overwrites \`xano/\`, and the others change shared environments or the pinned engine.
308
308
  - Never commit \`xano/.env\`, \`xano/.secrets.json\`, \`workspace.json\`, \`.env.local\`, or
309
309
  \`.xano/\`. Never ignore \`xano/\` wholesale, and never ignore \`xano/xano.lock\`.`;
310
310
  }
@@ -321,11 +321,14 @@ warns of an orphaned entry, run the \`lock rename\` it prints (\`npx @xano/sdk l
321
321
  \`guid:\` carries the identity, and export says so. Every \`lock\` subcommand finds
322
322
  \`xano/xano.lock\` from the project entry, as \`export\` does \u2014 \`--entry=<file>\` names
323
323
  another entry, \`--lock=<path>\` the lock itself.
324
- \`npm run xano:check\` (\`npx @xano/sdk export ./xano/index.ts --check --strict\`: writes nothing, needs no secrets, fails on any build warning) fails if
325
- \`xano/routes.gen.ts\` is missing or stale (after adding or renaming an endpoint, run \`npm run xano:routes\`
326
- and commit the file), if an export would change the lock, or if the lock still carries an entry no object matches (finish the rename with \`lock rename\`, or drop it
327
- with \`lock prune\` when the object really was deleted) \u2014 run it before you call the work
328
- done, and again after any merge: two branches that change different objects merge with no
324
+
325
+ \`npm run xano:check\` fails on the lock when:
326
+
327
+ - an export would change it, or
328
+ - it still carries an entry no object matches: finish the rename with \`lock rename\`, or
329
+ drop it with \`lock prune\` when the object really was deleted.
330
+
331
+ Rerun it after any merge: two branches that change different objects merge with no
329
332
  conflict while one side's derived state still predates the other's source change.`;
330
333
  var ENV_GUIDANCE = `\`workspaceConfig({ env })\`, passed to \`registerWorkspace()\`, declares the NAMES the
331
334
  backend reads with \`env("NAME")\`; the VALUES live in \`xano/.env\`, which is gitignored and survives a
@@ -333,20 +336,26 @@ backend reads with \`env("NAME")\`; the VALUES live in \`xano/.env\`, which is g
333
336
 
334
337
  - Fill it in by hand (\`cp xano/.env.example xano/.env\`), or run \`npx @xano/sdk env pull\`
335
338
  to fetch the values from a backend that is running. That is the ONLY command that
336
- writes \`xano/.env\`, and it confirms before replacing one. A compiled bundle also carries the
339
+ writes \`xano/.env\`; it creates the file 0600 (Windows has no ACL equivalent, the same
340
+ exposure \`.xano/auth.json\` carries) and confirms before replacing one. A compiled bundle also carries the
337
341
  resolved values in cleartext, so keep an \`export --out\` artifact out of git.
338
342
  - Every command that compiles a bundle reads \`xano/.env\` with no flag. In CI, which
339
343
  does not have it, mount a file and pass \`--backend-env-file <path>\`, or supply names with
340
344
  \`--env-var KEY=VALUE\`.
341
- - A deploy REPLACES the backend's env set, so a declared name with no value anywhere
342
- REFUSES the deploy rather than clearing the live value. Fill the name in \u2014 do not
345
+ - \`npm run xano:deploy\` passes \`--keep-data\`, which MERGES: it keeps rows AND live env
346
+ values. A name the backend already holds keeps its live value after you edit
347
+ \`xano/.env\` (the deploy warns \`plan.env-kept\`), and a newly declared name is added,
348
+ empty if it has no value. To apply an edited value, run
349
+ \`printf %s "$VALUE" | npx @xano/sdk env set NAME\`, or \`npm run xano:deploy -- --reset\`,
350
+ which also replaces every table's rows with its seed rows.
351
+ - A deploy that REPLACES the env set (no \`--keep-data\`, or a backend the merge cannot
352
+ vouch for, such as a fresh one) REFUSES the deploy when a declared name has no value
353
+ anywhere, or a \`NAME=\` line with nothing after the \`=\`, rather than clearing the
354
+ live value. Write \`NAME=""\` to send one empty on purpose. Fill the name in \u2014 do not
343
355
  put the value back into \`xano/index.ts\`, and do not reach for
344
356
  \`--allow-empty-env=NAME\` unless clearing that name is what you actually want.
345
357
  - \`xano/\` is committed in full except its two secret files, \`xano/.env\` and
346
- \`xano/.secrets.json\` (both gitignored). Never ignore \`xano/\` wholesale \u2014 the
347
- source is the review surface.
348
- - On Windows there is no ACL equivalent to the 0600 the file is created with, the
349
- same exposure \`.xano/auth.json\` already carries.`;
358
+ \`xano/.secrets.json\` (both gitignored).`;
350
359
  var TESTING_GUIDANCE = `Two kinds, both authored in \`xano/\`, both run against a DEPLOYED environment:
351
360
 
352
361
  - **Unit test** \u2014 a \`tests: [...]\` entry on a \`query\`, \`defineFunction\`, or
@@ -374,14 +383,14 @@ composing them from a module outside \`xano/\`.`;
374
383
  }
375
384
  return `### Add-ons & Marketplace
376
385
 
377
- Other \`@xano-sdk/*\` packages register onto the same workspace. None are required, and beyond any chosen at \`init\` (\`--marketplace\`), none ship with the scaffold \u2014 install one only when the task actually calls for it; do not add one speculatively. Before building a domain capability from scratch (authentication, AI chatbots, vector embeddings / RAG, payment integrations), check the marketplace \u2014 a live catalogue of typed add-ons that register onto the workspace. **Query it dynamically**:
386
+ Other \`@xano-sdk/*\` packages register onto the same workspace. None are required, and beyond any chosen at \`init\` (\`--marketplace\`), none ship with the scaffold. Install one only when the task calls for it; do not add one speculatively. Before building authentication, an AI chatbot, vector embeddings / RAG, or a payment integration from scratch, check the marketplace:
378
387
 
379
- 1. **Search:** \`npx @xano/sdk marketplace search <keywords>\` (e.g. \`auth\`, \`chat\`, \`vector\`, \`stripe\`) \u2014 matches title, package, tagline, and description.
380
- 2. **Inspect & Prompt:** \`npx @xano/sdk marketplace details <package> --prompt\` \u2014 emits the publisher's exact wiring steps, required env vars, and \`xano/index.ts\` registration snippet.
381
- 3. **Install:** \`npx @xano/sdk marketplace install <package>\` \u2014 verifies project directory, adds the package, and configures it in this project (a toolchain module is asked its questions here, not by a plain \`npm install\`).
382
- 4. **List all:** \`npx @xano/sdk marketplace list\` \u2014 browse all published modules. The read verbs (\`list\`, \`search\`, \`details\`) need no sign-in, but they query the online catalogue \u2014 there is no offline copy.
388
+ 1. \`npx @xano/sdk marketplace search <keywords>\` (e.g. \`auth\`, \`chat\`, \`vector\`, \`stripe\`) \u2014 matches title, package, tagline, and description.
389
+ 2. \`npx @xano/sdk marketplace details <package> --prompt\` \u2014 prints the publisher's wiring steps, required env vars, and \`xano/index.ts\` registration snippet.
390
+ 3. \`npx @xano/sdk marketplace install <package>\` \u2014 adds the package and configures it in this project (a toolchain module is asked its questions here, not by a plain \`npm install\`).
391
+ 4. \`npx @xano/sdk marketplace list\` \u2014 every published module. The read verbs (\`list\`, \`search\`, \`details\`) need no sign-in but query the online catalogue; there is no offline copy.
383
392
 
384
- #### Common First-Party Modules:
393
+ #### First-party modules
385
394
 
386
395
  - \`@xano-sdk/auth\` \u2014 turnkey authentication (\`signup\`/\`login\`/\`me\` endpoints + \`user\`/\`account\`/\`event_log\` tables): \`registerAuth(ws, { canonical: "authn" })\`. **Authentication only \u2014 not authorization.** Its tokens carry no role claim, so enforce roles off the caller's row: spread \`...guard.role(userTable, "admin")\` into the stack of a query whose \`auth\` is \`userTable\`.
387
396
  - \`@xano-sdk/chatbot\` \u2014 conversational AI assistant (thread/message tables + Xano AI agent + chat endpoints): \`registerChatbot(ws, { authTable: userTable, llm: { type: "xano-free", systemPrompt: "..." } })\`.
@@ -392,7 +401,7 @@ Other \`@xano-sdk/*\` packages register onto the same workspace. None are requir
392
401
  var FRONTEND_REACH = `- **The frontend cannot reach the backend.** \`npx @xano/sdk status\` prints the URL this
393
402
  project last deployed to. In dev the host is \`VITE_XANO_HOST\` from \`.env.local\` at the
394
403
  project root, written by \`npm run xano:deploy\`; restart \`npm run dev\` after it changes. A
395
- deployed site gets it injected as \`window["XANO_HOST"]\` (grep the bare \`XANO_HOST\` token).
404
+ deployed site gets it injected as \`window["XANO_HOST"]\`, so grep a deploy for the bare \`XANO_HOST\` token.
396
405
  An empty \`XANO_HOST\` sends every call to the dev server, which 404s.
397
406
  `;
398
407
  var FRONTEND_ENV_LOCAL = " `.env.local`: `npm run xano:deploy` writes it.";
@@ -405,8 +414,8 @@ test failed, 8 = the named backend is gone, stopped, or unreachable).
405
414
 
406
415
  - **The Xano Engine fails to start.** \`npx @xano/sdk local list\` shows the engines on this
407
416
  machine; \`npx @xano/sdk local stop --all\` then \`npm run xano:deploy\` restarts cleanly. Each
408
- start writes a log under \`~/.xanosdk/local-engine/engine/\` (\`Library/Caches\` on macOS,
409
- \`.cache\` on Linux) and a failed start names its file. A damaged cache: clear it with
417
+ start writes a log in a \`logs/\` directory under \`~/.xanosdk/local-engine/engine/Library/Caches/\`
418
+ on macOS (\`~/.xanosdk/local-engine/engine/.cache/\` on Linux); a failed start names its file. A damaged cache: clear it with
410
419
  \`npx @xano/sdk local cache clear\` and redeploy. \`XANOSDK_ENGINE_OVERRIDE\` in the shell
411
420
  means a non-pinned engine is running.
412
421
  ${frontend ? FRONTEND_REACH : ""}- **An API call fails.** Confirm the verb and path with \`npx @xano/sdk routes ./xano/index.ts\`,
@@ -418,9 +427,8 @@ ${frontend ? FRONTEND_REACH : ""}- **An API call fails.** Confirm the verb and p
418
427
  - **The schema appears out of sync.** \`npx @xano/sdk tables\` lists what the deployed backend
419
428
  has; \`npm run xano:deploy\` merges your defs in, \`npm run xano:deploy -- --reset\` replaces
420
429
  and re-seeds, and an engine restart or update starts empty (the next deploy seeds).
421
- \`npm run xano:check\` reports lock drift: finish a rename with
422
- \`npx @xano/sdk lock rename <kind> <old> <new>\`, or drop a deleted object's entry with
423
- \`npx @xano/sdk lock prune\`. Against the real workspace,
430
+ Lock drift from \`npm run xano:check\`: \`npx @xano/sdk lock rename <kind> <old> <new>\` finishes a
431
+ rename, \`npx @xano/sdk lock prune\` drops a deleted object's entry. Against the real workspace,
424
432
  \`npx @xano/sdk workspace diff ./xano/index.ts\` exits 2 when anything differs.
425
433
  - **Generated files are missing.** \`xano/routes.gen.ts\`: \`npm run xano:routes\` (it writes
426
434
  nothing until the workspace has an endpoint). \`xano/xano.lock\`: any export or deploy
@@ -441,8 +449,7 @@ function intro(mode, frontend) {
441
449
  return `This is a [Xano SDK](https://www.npmjs.com/package/@xano/sdk) project whose
442
450
  Xano backend under \`xano/\` was **pulled from a live workspace** and written as
443
451
  TypeScript by \`xanosdk init --from\`.${frontend === null ? "" : ` The ${frontend.label} frontend under \`frontend/\`
444
- is a starter.`} Xano SDK is Xano's official TypeScript SDK \u2014 the supported way to
445
- drive a Xano workspace from code.
452
+ is a starter.`}
446
453
 
447
454
  ### Two rules before you edit anything
448
455
 
@@ -461,8 +468,7 @@ round-trip on the pull, and it is the only place a decode gap is written down.`;
461
468
  }
462
469
  return `This is a [Xano SDK](https://www.npmjs.com/package/@xano/sdk) project. The
463
470
  Xano backend is authored in TypeScript under \`xano/\`${frontend === null ? "." : `; the ${frontend.label} frontend
464
- lives under \`frontend/\`.`} Xano SDK is Xano's official TypeScript SDK \u2014 the
465
- supported way to drive a Xano workspace from code.`;
471
+ lives under \`frontend/\`.`}`;
466
472
  }
467
473
  function guidanceBody(mode = "authored", frontend = DEFAULT_FRONTEND_GUIDANCE) {
468
474
  const hasFrontend = frontend !== null;
@@ -478,7 +484,7 @@ ${developmentWorkflow(mode, hasFrontend)}
478
484
 
479
485
  ${xanoSdk(hasFrontend)}
480
486
 
481
- ${backendChanges(hasFrontend)}
487
+ ${backendChanges()}
482
488
 
483
489
  ${agentGuidance(hasFrontend)}
484
490
 
@@ -1000,4 +1006,4 @@ export {
1000
1006
  changedOnDisk,
1001
1007
  scaffoldProject
1002
1008
  };
1003
- //# sourceMappingURL=chunk-YCKKL5PD.js.map
1009
+ //# sourceMappingURL=chunk-RH3NQTGQ.js.map
@@ -995,14 +995,11 @@ The backend lives in [\`index.ts\`](index.ts) and is a single default-exported
995
995
 
996
996
  ## Learn the library from the library
997
997
 
998
- Everything you need is in the package itself:
999
-
1000
- - \`node_modules/@xano/sdk/llms.txt\` \u2014 the router: the mental model, the deploy contract, every gotcha, and control flow. Read it in full first; it ends with a list of topic files and the condition for opening each.
1001
- - \`node_modules/@xano/sdk/llms/*.md\` \u2014 one file per surface. Open the one or two whose condition matches the task; skip the rest.
1002
- - The published TypeScript types and JSDoc (\`node_modules/@xano/sdk/**/*.d.ts\`).
1003
- - \`node_modules/@xano/sdk/manifest.json\` \u2014 the exhaustive reference; grep or \`jq\` the one entry you need rather than reading it whole.
1004
-
1005
- Author against those signatures \u2014 don't invent an API that isn't there.
998
+ Read \`node_modules/@xano/sdk/llms.txt\` in full first; it ends with the topic files
999
+ (\`node_modules/@xano/sdk/llms/*.md\`) and the condition for opening each. Author against
1000
+ the published types (\`node_modules/@xano/sdk/**/*.d.ts\`), and grep
1001
+ \`node_modules/@xano/sdk/manifest.json\` for one entry's full detail. Don't invent an API
1002
+ that isn't there.
1006
1003
 
1007
1004
  ## The shape
1008
1005
 
@@ -1043,35 +1040,21 @@ xano/
1043
1040
 
1044
1041
  ## Testing
1045
1042
 
1046
- Two kinds of test are authored in \`xano/\` alongside the objects they cover, and
1047
- both run against a DEPLOYED environment:
1048
-
1049
- - **Unit test** \u2014 \`tests: [...]\` on a \`query\`, \`defineFunction\`, or
1050
- \`middleware\`. Each entry is a named set of inputs run against that object, with
1051
- \`expect.*\` assertions on its response. A statement's \`mock\` (keyed by test
1052
- NAME) makes one step return a value instead of doing its work, but only while
1053
- that test runs.
1054
- - **Workflow test** \u2014 \`workflowTest({ name, stack })\`, a standalone object whose
1055
- stack calls others (\`s.function.call\`, \`s.api.call\`) and asserts with
1056
- \`s.expect.*\`. Use it for behavior that spans objects.
1057
-
1058
- \`expect.*\` and \`s.expect.*\` are different builders \u2014 an assertion record versus
1059
- a workflow-test statement \u2014 and are not interchangeable.
1043
+ Unit tests (\`tests: [...]\` on a query, function or middleware, asserting with \`expect.*\`)
1044
+ and workflow tests (\`workflowTest({ name, stack })\`, asserting with \`s.expect.*\`) both
1045
+ run against what is DEPLOYED:
1060
1046
 
1061
1047
  \`\`\`bash
1062
- npm run xano:deploy # tests run against what is deployed, so deploy first
1048
+ npm run xano:deploy # deploy first
1063
1049
  npm run xano:test # runs both kinds; exits 5 if any fail
1064
1050
  \`\`\`
1065
1051
 
1066
- \`npx @xano/sdk deploy ./xano/index.ts --test\` does both in one step, and
1067
- \`npx @xano/sdk test list\` shows what a deployed environment carries without running
1068
- anything. Read \`node_modules/@xano/sdk/llms/tests.md\` before authoring either
1069
- kind.
1052
+ Read \`node_modules/@xano/sdk/llms/tests.md\` before authoring either kind.
1070
1053
 
1071
1054
  ### Event-driven objects
1072
1055
 
1073
- A scheduled \`task\`, an \`mcpServer\`, and every trigger **fire normally on an
1074
- ephemeral** \u2014 where \`deploy\` sends them \u2014 so test them by deploying and letting
1056
+ A scheduled \`task\`, an \`mcpServer\`, and every trigger **run once deployed**,
1057
+ on the Xano Engine and an ephemeral alike \u2014 test them by deploying and letting
1075
1058
  them run.
1076
1059
 
1077
1060
  ## Wire the frontend
@@ -1147,8 +1130,10 @@ Every command that compiles a bundle reads \`xano/.env\` with no flag. It and
1147
1130
  the two files under \`xano/\` that are not committed. The source beside them is meant to
1148
1131
  be reviewed, so never ignore \`xano/\` wholesale.
1149
1132
 
1150
- A deploy REPLACES the backend's env set, so a declared name with no value refuses the
1151
- deploy rather than clearing the live value. In CI, which does not have this file, mount
1133
+ \`npm run xano:deploy\` keeps rows AND live env values (\`--keep-data\`): after editing a
1134
+ value, apply it with \`printf %s "$VALUE" | npx @xano/sdk env set NAME\`. A deploy that
1135
+ REPLACES the env set (no \`--keep-data\`, or a backend the merge cannot vouch for) refuses a
1136
+ declared name with no value rather than clearing the live value. In CI, which does not have this file, mount
1152
1137
  one and pass \`--backend-env-file <path>\`, or supply names with \`--env-var KEY=VALUE\`.
1153
1138
 
1154
1139
  \`workspace.json\` is a different matter: a compiled bundle carries these values in
@@ -2002,4 +1987,4 @@ export {
2002
1987
  renderCnUtil,
2003
1988
  renderApiTs
2004
1989
  };
2005
- //# sourceMappingURL=chunk-5FJ4M4HB.js.map
1990
+ //# sourceMappingURL=chunk-RHH6SCB4.js.map
@@ -3,12 +3,12 @@ import {
3
3
  DEFAULT_PREFERENCES,
4
4
  DEFAULT_SETTINGS,
5
5
  LEGACY_REALTIME
6
- } from "./chunk-NPYYDTXS.js";
6
+ } from "./chunk-RKTVXFBV.js";
7
7
  import {
8
8
  identityNamesByGuid,
9
9
  lockNameForObject,
10
10
  sdkKindName
11
- } from "./chunk-5KJBWIDZ.js";
11
+ } from "./chunk-VQDVEHDB.js";
12
12
  import {
13
13
  HOSTED_ICON_KINDS,
14
14
  isPrivateLibraryRow
@@ -16,7 +16,7 @@ import {
16
16
  import {
17
17
  deepEqual,
18
18
  normalize
19
- } from "./chunk-W2QFR3ZJ.js";
19
+ } from "./chunk-FIOC7RSU.js";
20
20
 
21
21
  // src/codegen/omissions.ts
22
22
  function omissionSeverity(reason) {
@@ -1087,4 +1087,4 @@ export {
1087
1087
  canonicalRow,
1088
1088
  compareToLive
1089
1089
  };
1090
- //# sourceMappingURL=chunk-M7O3T7IM.js.map
1090
+ //# sourceMappingURL=chunk-RIT3WBBX.js.map
@@ -5,14 +5,14 @@ import {
5
5
  hostLabel,
6
6
  questionSets,
7
7
  resolvePluginAnswers
8
- } from "./chunk-FIERONKM.js";
8
+ } from "./chunk-ROWYW3JF.js";
9
9
  import {
10
10
  gitattributesSpec
11
11
  } from "./chunk-LJM5CIY4.js";
12
12
  import {
13
13
  UsageError,
14
14
  warn
15
- } from "./chunk-GRXX2TOJ.js";
15
+ } from "./chunk-ZHFSIQ6E.js";
16
16
  import {
17
17
  withArticle
18
18
  } from "./chunk-36JUQZVQ.js";
@@ -221,4 +221,4 @@ export {
221
221
  contributionOutcomes,
222
222
  resolveContributions
223
223
  };
224
- //# sourceMappingURL=chunk-45K2QZBR.js.map
224
+ //# sourceMappingURL=chunk-RKNCISPM.js.map
@@ -2,23 +2,23 @@ import {
2
2
  assertCanonical,
3
3
  buildWorkspaceHistory,
4
4
  encodeMiddlewareList
5
- } from "./chunk-6EFXPTHT.js";
5
+ } from "./chunk-WAP5362D.js";
6
6
  import {
7
7
  brandDef
8
8
  } from "./chunk-ERVIASGL.js";
9
9
  import {
10
10
  registerKind
11
- } from "./chunk-74OPNM2Z.js";
11
+ } from "./chunk-JHAZK4RY.js";
12
12
  import {
13
13
  findNonJson,
14
14
  nonJsonMessage
15
15
  } from "./chunk-H2V3N23D.js";
16
16
  import {
17
17
  env
18
- } from "./chunk-Z6N5N4MN.js";
18
+ } from "./chunk-SIW2HT2H.js";
19
19
  import {
20
20
  describeEntry
21
- } from "./chunk-4MIV244X.js";
21
+ } from "./chunk-SGEOXJIH.js";
22
22
 
23
23
  // src/kinds/workspace-config.ts
24
24
  var LEGACY_REALTIME = {
@@ -174,4 +174,4 @@ export {
174
174
  workspaceConfig,
175
175
  typedEnv
176
176
  };
177
- //# sourceMappingURL=chunk-NPYYDTXS.js.map
177
+ //# sourceMappingURL=chunk-RKTVXFBV.js.map