@xano/sdk 1.0.14 → 1.0.16

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 +27 -0
  2. package/README.md +33 -37
  3. package/dist/.build-fingerprint +1 -1
  4. package/dist/{agent-file-refresh-3J6YRVFL.js → agent-file-refresh-DBHTEFYM.js} +12 -12
  5. package/dist/{agent-skill-command-VWDMQWCT.js → agent-skill-command-LHNTU7MH.js} +74 -73
  6. package/dist/{answer-shape-AVZSKBR6.js → answer-shape-ZRQS7ZC4.js} +5 -5
  7. package/dist/{backend-dir-ISP7RVF2.js → backend-dir-AXR43HNV.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-KGR52SZU.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-Z3DQ7ULY.js → chunk-23GEFHRX.js} +236 -17
  16. package/dist/{chunk-3H7R4ISR.js → chunk-2DUYJR5N.js} +2 -2
  17. package/dist/{chunk-MFWF2NZJ.js → chunk-2H5BQRHF.js} +2 -2
  18. package/dist/{chunk-O44MJTLR.js → chunk-35SI4GBM.js} +3 -3
  19. package/dist/{chunk-QKHNJ7LE.js → chunk-3ZV23FVR.js} +5 -5
  20. package/dist/{chunk-HKI5Y5KW.js → chunk-47XIVDJ6.js} +14 -14
  21. package/dist/{chunk-ICK36EGF.js → chunk-4EVDCSEY.js} +2 -2
  22. package/dist/{chunk-FBSGFPZ4.js → chunk-4XGZ325S.js} +3 -3
  23. package/dist/{chunk-EYVIUX2T.js → chunk-4XYXUK5H.js} +76 -33
  24. package/dist/{chunk-MAXDJZQR.js → chunk-4ZBXS7YN.js} +8 -8
  25. package/dist/{chunk-ZMJRAMLA.js → chunk-52QAENY6.js} +14 -14
  26. package/dist/{chunk-2LF734YB.js → chunk-54CJ74BH.js} +4 -4
  27. package/dist/{chunk-3SZ7QRYA.js → chunk-57PGTPT3.js} +8 -8
  28. package/dist/{chunk-IKXXTRMN.js → chunk-64UVVLDT.js} +4 -4
  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-HK554MDD.js → chunk-74YCPI4G.js} +7 -7
  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-RVAEPPRH.js → chunk-AICWDCLJ.js} +2 -2
  35. package/dist/{chunk-WS4BA75E.js → chunk-AJBOGO5U.js} +4 -4
  36. package/dist/{chunk-2FDHIBEU.js → chunk-AJQFUJEQ.js} +8 -8
  37. package/dist/{chunk-2KOB4QPW.js → chunk-C7AYP4H6.js} +29 -20
  38. package/dist/{chunk-XCFQLP6G.js → chunk-DJMGDCVX.js} +8 -8
  39. package/dist/{chunk-VBSCWV5H.js → chunk-DLD4FVRP.js} +54 -54
  40. package/dist/{chunk-Q7DGTQ5G.js → chunk-E34VGSCI.js} +2 -1
  41. package/dist/{chunk-YR3MNGWZ.js → chunk-E5M5P23K.js} +8 -8
  42. package/dist/{chunk-HJZUI2ZU.js → chunk-EAZTRU75.js} +2 -2
  43. package/dist/{chunk-QX5XQEYB.js → chunk-EINZSVEU.js} +5 -5
  44. package/dist/{chunk-KMKUH2IO.js → chunk-EPB6FAR5.js} +5 -5
  45. package/dist/chunk-EUAU4QKI.js +67 -0
  46. package/dist/{chunk-IDOVZLPK.js → chunk-EXJ4Q5F6.js} +2 -2
  47. package/dist/{chunk-IHL2O7VY.js → chunk-F3JK5RIY.js} +3 -2
  48. package/dist/{chunk-W2QFR3ZJ.js → chunk-FIOC7RSU.js} +2 -2
  49. package/dist/{chunk-YEH5OIPF.js → chunk-FMXPV5JI.js} +39 -11
  50. package/dist/{chunk-GVHWIDEJ.js → chunk-FRJB3NTE.js} +10 -5
  51. package/dist/{chunk-VIRFG3WG.js → chunk-FTFAPKCW.js} +23 -7
  52. package/dist/{chunk-LL6ED5IB.js → chunk-FTS42N37.js} +2 -2
  53. package/dist/{chunk-MIS6F4HM.js → chunk-G2XSDIYS.js} +4 -4
  54. package/dist/{chunk-ZY55DO5P.js → chunk-G6BEJ3NA.js} +2 -2
  55. package/dist/{chunk-RYWNNJK5.js → chunk-GA6HTO3O.js} +2 -2
  56. package/dist/{chunk-JIKGT7DO.js → chunk-GE3JV5SI.js} +1 -1
  57. package/dist/{chunk-GCINMMFL.js → chunk-GJZMKMWO.js} +2 -2
  58. package/dist/{chunk-LW7TOIS7.js → chunk-GRZ62LLU.js} +8 -8
  59. package/dist/{chunk-6X73VFCX.js → chunk-GT7PZCTK.js} +2 -2
  60. package/dist/{chunk-HINRE3UM.js → chunk-HXPQXCOZ.js} +1821 -506
  61. package/dist/{chunk-ECQXASG3.js → chunk-IFHFJR5O.js} +2 -2
  62. package/dist/{chunk-P4OWRYE7.js → chunk-IOWNQEMW.js} +31 -31
  63. package/dist/{chunk-SUKO4SZG.js → chunk-ISIZFK5Q.js} +53 -47
  64. package/dist/{chunk-QJ25N4W6.js → chunk-IUJDUFT7.js} +4 -4
  65. package/dist/{chunk-L34DM6QB.js → chunk-JHAZK4RY.js} +3 -3
  66. package/dist/{chunk-YL3WVBR5.js → chunk-KGHJ74HF.js} +6 -6
  67. package/dist/{chunk-NUZXSIEA.js → chunk-L2O5KG5Q.js} +6 -6
  68. package/dist/{chunk-L4WG4BKJ.js → chunk-L3Q2QYIQ.js} +72 -72
  69. package/dist/{chunk-SAEIVQLP.js → chunk-LLBEPJBO.js} +3 -3
  70. package/dist/{chunk-NOW522B4.js → chunk-LWBGPPI5.js} +13 -13
  71. package/dist/{chunk-GOKRKTCX.js → chunk-MBSHONP3.js} +3 -3
  72. package/dist/{chunk-GKQTXUOW.js → chunk-MOVRSULZ.js} +2 -2
  73. package/dist/{chunk-QAEBBTYR.js → chunk-MSYMEP7Y.js} +7 -7
  74. package/dist/{chunk-Y453TW6J.js → chunk-NCERS5QH.js} +2 -2
  75. package/dist/{chunk-HXFLHA5K.js → chunk-NH5Z2NOD.js} +2 -2
  76. package/dist/{chunk-T3HNISBN.js → chunk-NJVY3GAX.js} +3 -3
  77. package/dist/{chunk-J62TYONQ.js → chunk-NQPPUNWP.js} +3 -3
  78. package/dist/{chunk-LJZIBT75.js → chunk-O7Z3LF44.js} +5 -5
  79. package/dist/{chunk-B7CPSWQX.js → chunk-OLXYZQR7.js} +7 -7
  80. package/dist/{chunk-7F3V6CFP.js → chunk-OQNYZ2OM.js} +3 -3
  81. package/dist/{chunk-DBDTQR23.js → chunk-OTQF4B37.js} +4 -4
  82. package/dist/{chunk-GBSHHNSD.js → chunk-PRSNMSVG.js} +3 -3
  83. package/dist/{chunk-DGYXCIBV.js → chunk-Q6AKSLD2.js} +2 -2
  84. package/dist/{chunk-YTQYP7UJ.js → chunk-Q7KXMIR3.js} +3 -3
  85. package/dist/{chunk-IWJ6GFST.js → chunk-QCVH32T2.js} +5 -5
  86. package/dist/{chunk-7FIMUFBP.js → chunk-QDPY7RN3.js} +3 -3
  87. package/dist/{chunk-DLDYQNGP.js → chunk-QIT2GGNB.js} +3 -3
  88. package/dist/{chunk-J3XLCYTQ.js → chunk-QSJH5AFU.js} +244 -173
  89. package/dist/{chunk-DERQSEB5.js → chunk-R7DS2TRZ.js} +38 -22
  90. package/dist/{chunk-BEKEOXNG.js → chunk-RGPHFHJU.js} +2 -2
  91. package/dist/{chunk-5FJ4M4HB.js → chunk-RHH6SCB4.js} +17 -32
  92. package/dist/{chunk-Z4BQPABS.js → chunk-RIT3WBBX.js} +4 -4
  93. package/dist/{chunk-45K2QZBR.js → chunk-RKNCISPM.js} +3 -3
  94. package/dist/{chunk-6LJS4M6P.js → chunk-RKTVXFBV.js} +5 -5
  95. package/dist/{chunk-AXNX4NWN.js → chunk-RLQX6LHW.js} +37 -37
  96. package/dist/{chunk-FIERONKM.js → chunk-ROWYW3JF.js} +2 -2
  97. package/dist/{chunk-LSJ3SQEU.js → chunk-RVWWNNZQ.js} +4 -4
  98. package/dist/{chunk-LPQZICYN.js → chunk-S7MVI4W7.js} +7 -7
  99. package/dist/{chunk-4MIV244X.js → chunk-SGEOXJIH.js} +9 -2
  100. package/dist/{chunk-QRMKQYCB.js → chunk-SINL5WMI.js} +2 -2
  101. package/dist/{chunk-Z6N5N4MN.js → chunk-SIW2HT2H.js} +21 -5
  102. package/dist/{chunk-IEDQT4Z3.js → chunk-SOAZIMWL.js} +12 -12
  103. package/dist/{chunk-RPBB7P4Q.js → chunk-SVQMDVND.js} +87 -16
  104. package/dist/{chunk-45ZUMF4E.js → chunk-TPUAXIPR.js} +2 -2
  105. package/dist/{chunk-HMYJOQXT.js → chunk-TXU34ELY.js} +25 -25
  106. package/dist/{chunk-MTBKTGZT.js → chunk-U4UAWGIT.js} +12 -8
  107. package/dist/{chunk-76SBT7KS.js → chunk-U56HK2RG.js} +7 -5
  108. package/dist/{chunk-RV2BDU7V.js → chunk-UDW2KAVF.js} +6 -6
  109. package/dist/{chunk-NDV6CBR7.js → chunk-UH5VQGNR.js} +2 -2
  110. package/dist/{chunk-75QC66XI.js → chunk-V2MIBJZU.js} +2 -2
  111. package/dist/{chunk-RDZBXTZ3.js → chunk-VAQPQXOI.js} +4 -4
  112. package/dist/{chunk-XPSDDTUZ.js → chunk-VCFRALU7.js} +3 -3
  113. package/dist/{chunk-5KJBWIDZ.js → chunk-VQDVEHDB.js} +2 -2
  114. package/dist/{chunk-6ILHYSLR.js → chunk-WAP5362D.js} +5 -5
  115. package/dist/{chunk-XY4OBD26.js → chunk-WGKKDGSA.js} +4 -4
  116. package/dist/{chunk-UQ2OD7D4.js → chunk-WVVUE7LU.js} +14 -7
  117. package/dist/{chunk-LB76VK6D.js → chunk-WXQ7BHVQ.js} +7 -7
  118. package/dist/{chunk-7REDHC4N.js → chunk-X5NF3ZXW.js} +69 -14
  119. package/dist/{chunk-5W7S2SCA.js → chunk-XAE4NIZ2.js} +4 -4
  120. package/dist/{chunk-SPLRKCFV.js → chunk-XDGLYIB2.js} +2 -2
  121. package/dist/{chunk-BSGU4HS6.js → chunk-XKMZYU5B.js} +96 -65
  122. package/dist/{chunk-OLQN4Z5R.js → chunk-Y3RH35KM.js} +47 -47
  123. package/dist/{chunk-YFQCDLCQ.js → chunk-YHT7TDSH.js} +14 -14
  124. package/dist/{chunk-KDEU5FUJ.js → chunk-YJXJOMXW.js} +3 -3
  125. package/dist/{chunk-N6LGLNAC.js → chunk-YPLHVRMS.js} +4 -4
  126. package/dist/{chunk-WS2X5BB2.js → chunk-YYBBJPCL.js} +5 -5
  127. package/dist/{chunk-ZOHEHIFS.js → chunk-YYDM4DNP.js} +2 -2
  128. package/dist/{chunk-MYIIBV6A.js → chunk-ZF4LCHCT.js} +5 -5
  129. package/dist/{chunk-GRXX2TOJ.js → chunk-ZHFSIQ6E.js} +2 -2
  130. package/dist/{chunk-CB67GIR3.js → chunk-ZJQFKBX7.js} +7 -7
  131. package/dist/{chunk-ZRXDPCMN.js → chunk-ZYZ7GRX3.js} +2 -2
  132. package/dist/{chunk-5TWLVFYB.js → chunk-ZZC5VSLP.js} +4 -4
  133. package/dist/cli.d.ts +3 -3
  134. package/dist/cli.js +62 -61
  135. package/dist/codegen-command-NAY6YAOD.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-WESYWFJN.js → deploy-command-PBM3S4ZL.js} +69 -68
  142. package/dist/{deploy-source-ZQQNMDFX.js → deploy-source-JW7DAN75.js} +32 -32
  143. package/dist/{dev-env-sync-4XJT7WOT.js → dev-env-sync-FHJTFH3V.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-t-gDE1BL.d.ts} +181 -93
  147. package/dist/env-example-refresh-HHEGMFNH.js +136 -0
  148. package/dist/{env-pull-command-SK5FS477.js → env-pull-command-FFPNRVWD.js} +52 -52
  149. package/dist/{env-target-TEFSYACA.js → env-target-XHVRZXHX.js} +14 -14
  150. package/dist/{env-var-command-IJHKA2WJ.js → env-var-command-DJS62YRR.js} +41 -41
  151. package/dist/{ephemeral-VLPRDNEJ.js → ephemeral-2DXWP3VK.js} +9 -9
  152. package/dist/{ephemeral-command-WCO5J4SN.js → ephemeral-command-VLQIQ5TS.js} +52 -52
  153. package/dist/{ephemeral-state-RUOU2GFS.js → ephemeral-state-56XEDUJW.js} +12 -12
  154. package/dist/{generate-command-3WCOUOEQ.js → generate-command-PSDIIOTU.js} +89 -88
  155. package/dist/{gitignore-WYS3GMOX.js → gitignore-PMJ6MFNA.js} +15 -15
  156. package/dist/{guards-PPIBIMFZ.js → guards-YICHJKX3.js} +51 -15
  157. package/dist/{impersonate-command-UMYVQTCG.js → impersonate-command-IKV4KUYA.js} +37 -37
  158. package/dist/{import-T4ZTOTBT.js → import-VJQGIS33.js} +5 -5
  159. package/dist/index.d.ts +653 -222
  160. package/dist/index.js +29 -28
  161. package/dist/init-command-LEQIE6GC.js +143 -0
  162. package/dist/{init-modules-7KALFI5C.js → init-modules-G47Q7ABV.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 +692 -503
  166. package/dist/{io-PGTCBSIQ.js → io-47TFRYDB.js} +6 -6
  167. package/dist/{keep-data-merge-OVHCIEBG.js → keep-data-merge-XCPCX7BZ.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-AIHNW4AZ.js → landing-record-JQ7HZDGI.js} +22 -22
  171. package/dist/{live-diff-UMSOGPX3.js → live-diff-KJ2TWWWT.js} +14 -14
  172. package/dist/{local-engine-choice-XDGTATKJ.js → local-engine-choice-DFAMYOIF.js} +35 -35
  173. package/dist/{local-engine-command-VQWNQ7UK.js → local-engine-command-5RP2J5QZ.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-AIMNMXQG.js → local-engine-mcp-command-JSYVVZKK.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-H3YV2D6M.js → lock-commands-7VO6YWOV.js} +67 -66
  182. package/dist/{login-command-NMM3JNDZ.js → login-command-WTZUBCW6.js} +27 -27
  183. package/dist/{logout-command-7DYC6G32.js → logout-command-5BJUNK3C.js} +17 -17
  184. package/dist/{loop-DJNIHC7O.js → loop-HILLODVH.js} +15 -15
  185. package/dist/{marketplace-command-UCSHDZGO.js → marketplace-command-NMOH4XOV.js} +30 -30
  186. package/dist/{marketplace-resolve-JR4BBJ6K.js → marketplace-resolve-63QWMQZU.js} +6 -6
  187. package/dist/{meta-client-CD3TXQP6.js → meta-client-MRAMWUKV.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-2ONIIDRU.js → operation-outcome-WK7UW6PJ.js} +24 -24
  192. package/dist/{output-target-67LHZKCO.js → output-target-5PYRCCK4.js} +16 -16
  193. package/dist/{plan-disclosure-T7DF4SRJ.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-TJ7FURXB.js → preflight-command-3BX2WW3S.js} +75 -74
  198. package/dist/{profile-command-LDPLTJEJ.js → profile-command-GSUX3UMB.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-3LQTXWCD.js +149 -0
  203. package/dist/{prompt-QNMJIWNI.js → prompt-OYQHQWKI.js} +4 -4
  204. package/dist/{publish-command-IIRN6NWN.js → publish-command-3BQCV4NE.js} +72 -71
  205. package/dist/pull-command-B7OVWTZD.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-XSDICMJE.js +153 -0
  209. package/dist/{release-ns-command-YLCQPVH3.js → release-ns-command-EVAHK4CU.js} +96 -95
  210. package/dist/{retry-command-LFZYEVRU.js → retry-command-WP4ZI6CJ.js} +8 -8
  211. package/dist/{routes-manifest-R3TQRB24.js → routes-manifest-N73THJB3.js} +16 -16
  212. package/dist/routes-manifest-file-LDUDIVFJ.js +41 -0
  213. package/dist/scaffold.js +2 -2
  214. package/dist/{secrets-file-PCNAFXNV.js → secrets-file-7XWR7HW3.js} +15 -15
  215. package/dist/{secrets-fill-command-G7NQMRXU.js → secrets-fill-command-NKCGC75L.js} +66 -65
  216. package/dist/{seed-4CD55LB4.js → seed-YKTZDS2Q.js} +13 -13
  217. package/dist/{source-resolve-U4SJR7ZA.js → source-resolve-CQGDFQQC.js} +22 -22
  218. package/dist/{static-host-MO4VDHL7.js → static-host-3HPZKVKK.js} +5 -5
  219. package/dist/{status-command-CD72PXIT.js → status-command-TBMQ3GJP.js} +38 -38
  220. package/dist/{store-AJX4MC7Y.js → store-B63BQV6R.js} +6 -6
  221. package/dist/{store-BM7SQcUt.d.ts → store-in7gSpMS.d.ts} +297 -129
  222. package/dist/sync-baseline-GRS33AB5.js +38 -0
  223. package/dist/{sync-contributions-XK6LHISZ.js → sync-contributions-RKPLZPPO.js} +9 -9
  224. package/dist/{sync-record-NE62ERA3.js → sync-record-AWFCSS4D.js} +15 -15
  225. package/dist/{table-WPRAM4VW.js → table-ONGT3JGE.js} +12 -12
  226. package/dist/{tables-command-NMTKR52H.js → tables-command-UYQ277TJ.js} +41 -41
  227. package/dist/{tenant-IIYECNWO.js → tenant-IXIW3FOI.js} +10 -10
  228. package/dist/{tenant-command-XQAWT46C.js → tenant-command-7LWZUK2V.js} +104 -103
  229. package/dist/{test-command-W4AD4KT4.js → test-command-7KTT5EAF.js} +56 -45
  230. package/dist/{tests-JWQRHFCT.js → tests-N4MMBABH.js} +6 -6
  231. package/dist/{token-P3VQ6ITJ.js → token-3TCMW2AP.js} +13 -13
  232. package/dist/{toolchain-hooks-UAJBPSTC.js → toolchain-hooks-IJWV3ZQS.js} +18 -18
  233. package/dist/{toolchain-modules-S3MPHCUI.js → toolchain-modules-PBVBCPQJ.js} +5 -5
  234. package/dist/{toolchain-peers-FQJBTKEB.js → toolchain-peers-EMOYN4U7.js} +8 -8
  235. package/dist/{tracked-backend-WWEPNUD5.js → tracked-backend-YDUUQZQF.js} +34 -34
  236. package/dist/update-check-C6KDFGMT.js +141 -0
  237. package/dist/{upgrade-command-J6LRNHYF.js → upgrade-command-ZSBTSMBR.js} +68 -67
  238. package/dist/{whoami-command-KWRP2CII.js → whoami-command-L6ERHR5K.js} +16 -16
  239. package/dist/{workspace-3YNK4XO4.js → workspace-5DPSDM4A.js} +5 -5
  240. package/dist/{workspace-binding-TTDNXHO5.js → workspace-binding-MVOWGNYW.js} +15 -15
  241. package/dist/{workspace-command-W4ANGLCZ.js → workspace-command-PKQ5TDR7.js} +100 -99
  242. package/dist/{workspace-env-6LJGCTZA.js → workspace-env-UZJZUIYV.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-YB6Y2IJS.js +44 -0
  246. package/dist/{xanosdk-import-PNNMZ4SF.js → xanosdk-import-HHMQDK2I.js} +10 -10
  247. package/dist/{xanosdk-project-YW3BQY2E.js → xanosdk-project-CKEUNJU4.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 +53 -30
  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 +78 -71
  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 +14 -18
  273. package/llms/values.md +16 -9
  274. package/llms-full.txt +689 -549
  275. package/llms.txt +120 -137
  276. package/manifest.json +228 -246
  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-75IYFTBS.js +0 -80
  281. package/dist/codegen-command-JWOW6HE5.js +0 -182
  282. package/dist/env-example-refresh-4V2OCDJE.js +0 -135
  283. package/dist/init-command-UR5MSXIH.js +0 -142
  284. package/dist/promote-command-RURHOLNR.js +0 -148
  285. package/dist/pull-command-ITO76ENU.js +0 -170
  286. package/dist/release-command-CVGIUD4M.js +0 -152
  287. package/dist/routes-manifest-file-GYNYFKAH.js +0 -41
  288. package/dist/sync-baseline-BJDKG4F2.js +0 -38
  289. package/dist/update-check-O7QC5TBB.js +0 -140
  290. package/dist/xano-Z3SRHYOR.js +0 -43
package/llms.txt CHANGED
@@ -1,4 +1,4 @@
1
- # xanosdk v1.0.14
1
+ # xanosdk v1.0.16
2
2
 
3
3
  > TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.
4
4
 
@@ -16,21 +16,18 @@ TAGGED value — `ref("x")` a stack variable, `inp("x")` an input, `auth("id")`
16
16
  caller, `c.*` a constant — resolved at request time; JS operators over them do not
17
17
  compute (see Gotchas). Requests share no memory — state persists in tables or redis.
18
18
 
19
- Authorable: statement surfaces 218/218, filters 246 (246 typed).
20
- Not authorable here: branch, market_item, realtime_channel, run.job, run.service, tablemap — these cannot be authored and do not survive a pull; reasons in `coverage.objectKinds.unmodeled`.
21
-
22
- This file is the whole always-read surface: the mental model, the deploy contract,
23
- every cross-cutting gotcha, and control flow. Per-surface detail lives in the topic files listed
24
- below — open the one whose condition matches the task, skip the rest. For
25
- exhaustive per-entry detail in NEITHER — a statement's field schema with engine
26
- defaults, a filter's full argument list, the `storedName` mapping — do a TARGETED
27
- lookup in the shipped `manifest.json` (a program imports it as
28
- `@xano/sdk/manifest.json`, needing `with { type: "json" }` in Node ESM;
29
- it is ~70k tokens, so never read it whole). Its top-level keys are `name`, `version`, `description`, `coverage`, `values`, `objectKinds`, `fieldTypes`, `statements`, `filters`, `cli`, `cliGlobalFlags`. `statements` and `filters` are ARRAYS, not maps — SELECT, do not index:
19
+ Authorable: statement surfaces 219/219, filters 246 (246 typed).
20
+ Not authorable here: branch, market_item, realtime_channel (legacy; author realtimeServer + realtimeChannel instead), run.job, run.service, tablemap — these cannot be authored and do not survive a pull; reasons in `coverage.objectKinds.unmodeled`.
21
+
22
+ Per-surface detail is in the topic files below: open the one whose condition matches the task.
23
+ Per-entry detail (a statement's field schema with engine defaults, a filter's full argument
24
+ list, the `storedName` mapping) is in the shipped `manifest.json` — do a TARGETED lookup;
25
+ it is ~70k tokens, so never read it whole. A program imports it as `@xano/sdk/manifest.json`
26
+ (Node ESM needs `with { type: "json" }`). Its top-level keys are `name`, `version`, `description`, `coverage`, `values`, `objectKinds`, `fieldTypes`, `statements`, `filters`, `cli`, `cliGlobalFlags`. `statements` and `filters` are ARRAYS, not maps — SELECT, do not index:
30
27
  jq '.statements[] | select(.sPath=="db.get")' manifest.json
31
28
  jq '.filters[] | select(.name=="json_decode")' manifest.json
32
- ⚠ `fields` is null on the 65 `declarative: false` statements (`db.get`, …): typed wrappers whose arguments are the factory's `.d.ts` signature. Null ≠ missing.
33
- Select a statement on `sPath` (the `s.*` path you write), NOT `surface` (the XanoScript term): 24 of 218 differ — `var`→`set_var`, `break`→`foreach_break`, `foreach.remove`→`foreach_remove`, and every `expect.*`.
29
+ ⚠ `fields` is null on the 66 `declarative: false` statements (`db.get`, …): typed wrappers whose arguments are the factory's `.d.ts` signature. Null ≠ missing.
30
+ Select a statement on `sPath` (the `s.*` path you write), NOT `surface` (the XanoScript term): 24 of 219 differ — `var`→`set_var`, `break`→`foreach_break`, `foreach.remove`→`foreach_remove`, and every `expect.*`.
34
31
 
35
32
  ## Topic files
36
33
 
@@ -61,9 +58,6 @@ plain file read resolves them at the version you have.
61
58
 
62
59
  ## Quickstart
63
60
 
64
- Authoring is **declarative def-objects** passed to factories — there is no
65
- callback/chaining builder.
66
-
67
61
  ```ts
68
62
  import { workspace, apiGroup, query, table, input, f, ref, inp, auth, s } from "@xano/sdk";
69
63
 
@@ -72,13 +66,13 @@ const users = table({
72
66
  auth: true, // backs authentication
73
67
  // `id` (int PK) + `created_at` (epochms) are auto-injected — don't declare them.
74
68
  schema: {
75
- email: f.email({ required: true }),
69
+ email: f.email({ required: true, methods: ["trim", "lower"] }), // a unique email index is CASE-SENSITIVE — lowercase it
76
70
  name: f.text(),
77
71
  },
78
72
  // Indexes: { type, fields: [{ name, op? }] }. `"unique"` is shorthand for `"btree|unique"`.
79
73
  // A DOTTED name indexes a key inside a column (`xdo.email`); only the part before the
80
74
  // first dot is checked against the schema.
81
- index: [{ type: "unique", fields: [{ name: "email" }] }], // also: btree, hash, gin, search, gist, vector
75
+ index: [{ type: "unique", fields: [{ name: "email" }] }],
82
76
  });
83
77
 
84
78
  const posts = table({
@@ -119,30 +113,26 @@ package.json or name the entry `.mts`. `npm init -y` writes `"type": "commonjs"`
119
113
  which fails with a "must be ES modules" error until you switch it to module.
120
114
 
121
115
  Set `canonical` on every `apiGroup`. The engine mints the URL token server-side, so
122
- without one a group's client paths are unresolvable until a lock exists: the bundle
123
- exports fine and `npx @xano/sdk routes` / `getPath()` then fail on the very queries it just
124
- built. An explicit `canonical` resolves them from the source alone.
125
- ⚠ A canonical is unique across the whole INSTANCE, not per workspace — two
126
- workspaces cannot serve the same one, and no flag shares it. One set in code is a PIN:
127
- a merge refuses (exit 2) when another workspace holds it. One the lock minted is a
128
- preference the instance may keep or replace with a random token, and `--static` is
129
- refused when it does.
130
-
131
- Build warnings: `export()` prints the shapes that deploy clean and then do the wrong
132
- thing (a `bulk.update` zero-filling omitted columns, an `ignoreEmpty` on an empty
133
- operand, a `ref()` nothing binds). Each has a legitimate use, so each only warns —
134
- but nothing fails on a message no one reads, so in CI and in unattended agent builds
135
- pass `--strict` (`emitBundle(app, { strict: true })` / `app.export({ strict: true })`):
136
- every warning becomes a hard failure. Same bundle bytes either way.
116
+ without one `npx @xano/sdk routes` / `getPath()` cannot resolve the group's paths until a
117
+ lock exists (the export itself succeeds).
118
+ ⚠ A canonical is unique across the whole INSTANCE, not per workspace; no flag shares one.
119
+ A canonical set in code is a PIN: a merge refuses (exit 2) when another workspace holds it.
120
+ One only the lock minted is not pinned: the instance may replace it with a random token,
121
+ and `--static` is refused when it does.
122
+
123
+ Build warnings: `export()` warns on shapes that deploy but misbehave (a `bulk.update`
124
+ zero-filling omitted columns, an `ignoreEmpty` on an empty operand, a `ref()` nothing
125
+ binds). In CI and agent builds pass `--strict` (`emitBundle(app, { strict: true })` /
126
+ `app.export({ strict: true })`): every warning becomes a hard failure. Same bundle bytes
127
+ either way.
137
128
  Before calling the work done: `npm run typecheck`, `npx @xano/sdk export <entry> --strict`,
138
129
  `deploy <entry>`, then `test run-all` against what deployed.
139
130
 
140
- Identity: object guids derive from `(type, name)` — a query's from `(api group,
141
- verb, name)` — so renames change identity.
142
- EVERY build freezes every guid + api-group/toolset canonical in a lock file
143
- BESIDE THE ENTRY FILE — `xano/xano.lock` for the standard scaffold,
144
- NOT the project root — which you COMMIT (`--no-lock` opts out; CI guard
145
- `--frozen-lock` fails instead of changing it).
131
+ Identity: object guids derive from `(type, name)` (a query adds group + verb),
132
+ so renames change identity.
133
+ Every build freezes every guid + api-group/toolset canonical in a lock file beside the entry
134
+ file (`xano/xano.lock` in the standard scaffold, not the project root). Commit it
135
+ (`--no-lock` opts out; CI guard `--frozen-lock` fails instead of changing it).
146
136
  To rename an object: rename in code, export (stderr prints the exact fix-up), run
147
137
  `npx @xano/sdk lock rename <kind> <old> <new>`, export again — the original guid is emitted
148
138
  under the new name, so the engine renames in place instead of delete+create. Taking
@@ -156,51 +146,58 @@ Commands here run as `npx @xano/sdk <cmd>`: `init` → `deploy` → URL. A deplo
156
146
  `export` (honoring `xano.lock`), imports the result, and prints the URL.
157
147
  ⚠ Every deploy is a FULL REPLACE of its destination — objects AND records.
158
148
 
159
- **Backends** — one grammar: `workspace` | `ephemeral[:<name>]` | `local[:<name>]`
160
- (no credential) | `tenant:<name>` | `release:<name>` | a bundle path where a file fits. Reads
161
- `--from`, writes `--to`, `test --on`; positional on `deploy`/`pull`/`generate`/`tables`/
162
- `impersonate`. Omitted = the ephemeral or Xano Engine this project last deployed to, never
163
- workspace/tenant; bare `deploy` compiles onto the Xano Engine instead (`--ephemeral`: an
164
- ephemeral), and `generate`/`init --from` need one. A refusal, typed or tracked,
165
- names the reason and the spellings (`release create` refuses a Xano Engine).
166
- `release create --from` records a run: no bundle path, no `release:`,
167
- and a `tenant:` only if throwaway (`standard`/`run` refused).
149
+ **Backends** — one grammar for every command that names a backend:
150
+
151
+ - Spellings: `workspace` | `ephemeral[:<name>]` | `local[:<name>]` (no credential) |
152
+ `tenant:<name>` | `release:<name>` | a bundle path where a file fits.
153
+ - Reads `--from`, writes `--to`, `test --on`; positional on `deploy`/`pull`/`generate`/`tables`/
154
+ `impersonate`.
155
+ - Omitted = the ephemeral or Xano Engine this project last deployed to, never
156
+ workspace/tenant. Exceptions: bare `deploy` always targets the Xano Engine (`--ephemeral`: an
157
+ ephemeral); `generate`/`init --from` need one.
158
+ - A backend a command cannot serve is refused, typed or tracked, with the reason and the valid
159
+ spellings (`release create` refuses a Xano Engine).
160
+ - `release create --from` takes a run only: no bundle path, no `release:`, and a
161
+ `tenant:` only if throwaway (`standard`/`run` refused).
168
162
 
169
163
  **Destinations** — the Xano Engine by default, real only when you say so:
170
164
 
171
- - `deploy [source]` → the Xano Engine on this machine (no account). `--ephemeral` → a NAMED, auto-expiring ephemeral (~1h; `--expires-hours`
172
- 1–24), tracked in `./.xano/ephemeral.json`, so deploying again REFRESHES it at the same
173
- URL; if it expired or was swept, a fresh one is created and the new URL called out.
174
- ⚠ Only the BACKEND URL survives a refresh — the replace clears static hosting, so
175
- `--static` publishes a NEW host every run and the previous URL stops serving
176
- (not under `--keep-data`, which MERGES an env a deploy filled: rows kept, no re-seed,
177
- removed objects deleted; ⚠ a rename loses values, a RETYPE reads unfit ones as null, env
178
- VALUES are not applied, a table trigger refuses it — `--reset` replaces and re-seeds).
179
- - `release create <name>` cuts from a running source and LANDS in your workspace
180
- — the record that it came up, and the only thing `promote`/`tenant deploy` take. A
181
- taken name is refused, and so is one that addresses a LOCATION instead of naming: `/`,
182
- `\`, `:`, or a leading `.`. Every export derives its FILENAME from the name it is given,
183
- so `release|ephemeral|workspace export` refuse those same shapes unless `--path` names
184
- the file. Carries EVERY table's SCHEMA either way; `--seed[=<guids>]` adds
185
- ROWS — guids from `tables <backend>`; a redeploy KEEPS them.
165
+ - `deploy [source]` → the Xano Engine on this machine (no account).
166
+ - `--ephemeral` → a NAMED, auto-expiring ephemeral (~1h; `--expires-hours` 1–24), tracked in
167
+ `./.xano/ephemeral.json`, so deploying again REFRESHES it at the same URL; if it expired or
168
+ was swept, a fresh one is created and the new URL printed.
169
+ - ⚠ Only the BACKEND URL survives a refresh: the replace clears static hosting, so
170
+ `--static` publishes a NEW host every run and the previous URL stops serving.
171
+ - Under `--keep-data`, which MERGES an env a deploy filled instead of replacing it, the static
172
+ URL survives too: rows kept, no re-seed, removed objects deleted. ⚠ Limits: a rename loses values,
173
+ a RETYPE reads unfit ones as null, env VALUES are not applied, a table trigger refuses it.
174
+ `--reset` replaces and re-seeds.
175
+ - `release create <name>` cuts a release from a running source and LANDS it in your workspace.
176
+ A release records that the source came up; it is the only thing `promote`/`tenant deploy` take.
177
+ - Refused: a taken name, and one that addresses a LOCATION instead of naming (`/`, `\`, `:`,
178
+ or a leading `.`). Every export derives its FILENAME from the name it is given, so
179
+ `release|ephemeral|workspace export` refuse those same shapes unless `--path` names the file.
180
+ - Carries EVERY table's SCHEMA either way; `--seed[=<guids>]` adds ROWS. Guids come from
181
+ `tables <backend>`; a redeploy KEEPS them.
186
182
  - `release transfer <name> --to-profile <profile>` copies a release to another
187
183
  workspace/instance by CONTENT (tar sha256): identical → reused; same name, other
188
184
  bytes → exit 2.
189
185
  - `promote <release>` / `tenant deploy <tenant> <release>` land it.
190
- `promote` adds a branch; ⚠ its TABLE edits hit live
191
- (`--allow-shared-schema-changes`). `tenant deploy` REPLACES: DROPS tables it lacks,
192
- CONVERTS retypes (`--seed`: rows).
193
- `promote` refuses a taken name/pinned slug (`SDK_IDENTITY_CONFLICT`), then
194
- EXITS NON-ZERO if a declared object did not arrive or a pinned slug is not served;
195
- `--set-live` waits on that (previous branch serving). Extra objects: reported;
196
- a check missing an input reports `unverified`, exit 0. `--json` on every release write:
197
- `completed` yes|no|unknown; UNKNOWN exits 9 — run `resolveWith`, never retry blind.
198
- `--expect-live <label>` (with `--set-live`) refuses if live moved; not atomic. Inspect a staged branch with
199
- `workspace export --branch <label>` or `workspace diff <entry> --branch <label>`.
200
- ⚠ The redis family, `s.lambda`, `s.db.direct_query`, `s.await`, `s.microservice.request`,
201
- `s.zip.*`, the raw-file readers, Datadog and Webflow need an INSTANCE CAPABILITY: they
202
- deploy clean and fail on the first request if the target lacks it. `export`/`deploy` list
203
- what the bundle needs — compare it to the target yourself.
186
+ - `promote` adds a branch; ⚠ its TABLE edits hit live (`--allow-shared-schema-changes`).
187
+ - `tenant deploy` REPLACES: DROPS tables it lacks, CONVERTS retypes (`--seed`: rows).
188
+ - `promote` refuses a taken name/pinned slug (`SDK_IDENTITY_CONFLICT`), then EXITS NON-ZERO
189
+ if a declared object did not arrive or a pinned slug is not served. `--set-live` switches
190
+ only after that check passes; a failure leaves the previous branch serving. Extra objects
191
+ are reported; a check missing an input reports `unverified`, exit 0.
192
+ - `--expect-live <label>` (with `--set-live`) refuses if live moved; not atomic.
193
+ - `--json` on every release write: `completed` yes|no|unknown; UNKNOWN exits 9 — run
194
+ `resolveWith`, never retry blind.
195
+ - Inspect a staged branch with `workspace export --branch <label>` or
196
+ `workspace diff <entry> --branch <label>`.
197
+ - ⚠ The redis family, `s.lambda`, `s.db.direct_query`, `s.await`, async runs,
198
+ `s.microservice.request`, `s.zip.*`, the raw-file readers, Datadog and Webflow need an
199
+ INSTANCE CAPABILITY: they deploy clean and fail on the first request if the target lacks it.
200
+ `export`/`deploy` list what the bundle needs — compare it to the target yourself.
204
201
  - Backend SECRETS stay out of the repo: declare the NAME, value empty, in `workspaceConfig({ env })`
205
202
  passed to `registerWorkspace()`; the VALUE lives in `xano/.env` — gitignored, kept across a
206
203
  pull, read by every build. `--backend-env-file <path>` replaces that default (CI has
@@ -233,9 +230,7 @@ and a `tenant:` only if throwaway (`standard`/`run` refused).
233
230
  - `workspace reset-tables <entry> --table <guid>` puts NAMED tables back to their
234
231
  compiled `table({ seed })` rows, touching no other table. Dry run unless `--write`.
235
232
  ⚠ ROWS BEFORE LOGIC: rows are workspace-shared like schema, so they reach production when
236
- applied even while the logic reading them is staged — no ordering makes a half-data change
237
- atomic. Reset rows FIRST, then `promote`: new rows under old logic break only a feature
238
- being removed; new logic over old rows breaks the one you are shipping.
233
+ applied, even while the logic reading them is staged. Reset rows FIRST, then `promote`.
239
234
  - `pull` refreshes THIS project from a backend: rewrites decoded files,
240
235
  keeps yours, lists and confirms (`--yes`).
241
236
  - `generate <source>`: the decoded tree ONLY, no project.
@@ -265,11 +260,9 @@ Non-obvious authoring rules:
265
260
  - **No callback builder.** Flat def-objects + `register*`, not
266
261
  `workspace(w => w.table(...))`. `workspace(name)` returns a named `new Xano()`;
267
262
  tables are `table({ schema: { col: f.text() } })`.
268
- - **Reference-helper picker:** `ref` = stack var (`as:` output), `inp` = input,
269
- `col` = table column (in `db.query` `where`), `auth("id")` = the caller,
270
- `c.*` = a constant. Pick by what you're pointing at.
271
- - **Foreign key is `f.tableRef(table)`, not `ref`.** `ref(name)` references a
272
- stack variable (a value); `f.tableRef` is the column constructor.
263
+ - **Foreign key is `f.tableRef(table)`, not `ref`.** `ref` = stack var (`as:` output),
264
+ `inp` = input, `col` = table column (in `db.query` `where`), `auth("id")` = the caller,
265
+ `c.*` = a constant; `f.tableRef` is the column constructor.
273
266
  - **Tagged values are DATA — a JS template literal cannot compose them.** `${ref(...)}`
274
267
  (or `"a" + ref(...)`) stringifies the tag object at BUILD time: ``c.text(`Hi ${ref("u.name")}`)``
275
268
  type-checks and encodes the literal text `Hi [object Object]`, served verbatim.
@@ -283,11 +276,11 @@ Non-obvious authoring rules:
283
276
  - **`get_input`/`get_raw_input` read the whole payload**, not one named input
284
277
  (args are `{ as?, encoding?, excludeMiddleware? }` — no `name`). For a single
285
278
  input use `inp("name")`.
286
- - **To match every row, omit `where` — never pass a constant.** `where: c.bool(true)` is
287
- not "no filter": a bare scalar literal states no condition and the engine reads the
288
- resulting `context.search` as garbage, so it throws. An absent `where` is how "every
289
- row" is spelled. A raw `Value` `where` stays the escape hatch for a clause built
290
- elsewhere — `inp("clause")`, `ref("built_where")`, or `c.text("id > 0")`.
279
+ - **A `where` is a comparison, never a value.** To match every row, omit `where`. A value
280
+ `where` — `c.bool(true)`, a text clause, or one built at run time (`inp("clause")`,
281
+ `ref("built_where")`) — throws at build: the engine reads a filter only as a comparison
282
+ tree and runs anything else over EVERY row. Bind run-time values as operands instead:
283
+ `expr(col("status"), "=", inp("status"))`.
291
284
 
292
285
  ### Tables and columns
293
286
 
@@ -305,8 +298,7 @@ Non-obvious authoring rules:
305
298
  defaults or a 400. HTTP binds it fine. `--strict` fails on it.
306
299
  - **Numeric columns lose money quietly.** A normalized table's `f.decimal` reads
307
300
  `0.12345678` back as `0.12346`; `f.int` saturates at `9223372036854775807`
308
- instead of failing. Both at HTTP 200 and plausible on read, so it surfaces as
309
- arithmetic that stops reconciling. Hold money as a count of the smallest unit;
301
+ instead of failing, both at HTTP 200. Hold money as a count of the smallest unit;
310
302
  exact bounds: `llms/fields.md`.
311
303
  - **Self-referencing tables** need the bare-name form: inside `tweets`'s own
312
304
  schema, write `f.tableRef("tweets", { type: "int" })` — the `const tweets`
@@ -333,22 +325,17 @@ Non-obvious authoring rules:
333
325
  ### Reading and writing rows
334
326
 
335
327
  - **DB reads are field-match, not `where`-expr.** `db.get`/`db.edit`/`db.del`/
336
- `db.has`/`db.patch` match one field: `{ fieldName, fieldValue }` (`fieldName`
337
- defaults to the PK `id`). Only `db.query` takes a `where`/`additionalWhere`
338
- `expr(...)`; writes (`db.add`/`db.edit`/`db.add_or_edit`) take a `row`/`data`.
339
- Signatures: `llms/statements-data.md`.
340
- - **Single-field only — no composite match.** These ops match exactly ONE field;
341
- there is no two-field form (the engine's by-field lookup takes a single
342
- predicate). For a `(a, b)` existence/fetch — e.g. dedupe a `(habit, date)`
343
- check-in — use `db.query({ where: [expr(col("habit"), "=", ...), expr(col("date"), "=", ...)], as })`
344
- (a `where` array is ANDed) and branch on the result, rather than pushing the
345
- check to the client.
328
+ `db.has`/`db.patch` match exactly ONE field: `{ fieldName, fieldValue }` (`fieldName`
329
+ defaults to the PK `id`); there is no composite match. Only `db.query` takes a
330
+ `where`/`additionalWhere` `expr(...)`; writes (`db.add`/`db.edit`/`db.add_or_edit`) take a
331
+ `row`/`data`. For an `(a, b)` existence/fetch (e.g. dedupe a `(habit, date)` check-in), use
332
+ `db.query({ where: [expr(col("habit"), "=", ...), expr(col("date"), "=", ...)], as })`
333
+ (a `where` array is ANDed) and branch on the result. Signatures: `llms/statements-data.md`.
346
334
  - **Drilling into a maybe-null `db.get` result 500s — use `ref(path, { safe: true })`.**
347
335
  `db.get` binds `null` on a no-match, but a nested `ref("owner.user_id")` raises a runtime
348
336
  "Unable to locate var" (HTTP 500) when `owner` is null — an ownership guard throws instead
349
- of failing cleanly. Two correct shapes:
350
- - Guard existence first — `s.precondition({ expr: expr(ref("owner"), "!=", c.null()),
351
- error_type: "notfound", error: c.text("Not found.") })` — then drill WITHOUT `safe`.
337
+ of failing cleanly (same for a `single` `db.query`; warns `stack.drill-maybe-null`). Two correct shapes:
338
+ - Guard existence first — `guard.found("owner")` (a 404 precondition) — then drill WITHOUT `safe`.
352
339
  - Or drill null-safe inside an EXPRESSION or `obj()` operand:
353
340
  `expr(ref("owner.user_id", { safe: true }), "=", auth("id"))` yields `null` (the guard
354
341
  reads `false`) instead of 500ing. Works inside `obj({...})` too — no `s.set_var` hoist needed.
@@ -379,12 +366,12 @@ Non-obvious authoring rules:
379
366
  - **`s.api.call` / `s.task.call` / `s.trigger.call` / `s.workflow_test.call` are
380
367
  WORKFLOW-TEST ONLY.** Outside a `workflowTest({...})` stack the engine cannot reach
381
368
  the target, so one in a query/function/task deploys clean and then answers the first
382
- real request with `ERROR_FATAL: <Type> does not exist: <type>:<n>` — and not per
383
- host kind, the same call fails identically from a function a query runs.
369
+ real request with `ERROR_FATAL: <Type> does not exist: <type>:<n>`. The failure is not per
370
+ host kind: the same call inside a function that a query runs fails the same way.
384
371
  `export()` refuses them. `s.function.call`, `s.tool.call`, `s.middleware.call` and
385
- `s.addon.call` run anywhere, as does `s.function.run` (the ordinary function
386
- invocation). To share logic between endpoints, put it in a `defineFunction` and
387
- `s.function.run` it from both.
372
+ `s.addon.call` run anywhere, as does `s.function.run`. To share logic, put it in a
373
+ `defineFunction` and `s.function.run` it — NOT `s.function.call`, which binds a failing
374
+ target's error envelope instead of raising.
388
375
  - **`expect.*` is a unit-test assertion; `s.expect.*` is a workflow-test statement.**
389
376
  A statement's `mock` is keyed by TEST NAME; an undeclared name throws. See `llms/tests.md`.
390
377
  - **A helper returning `Statement[]` widens the stack and kills `InferResponse`.**
@@ -398,17 +385,15 @@ Non-obvious authoring rules:
398
385
  The regex filters (`regex_test`/`regex_match`/`regex_replace`/…) are PHP `preg_*`: the
399
386
  piped value is the PATTERN and must be delimiter-wrapped, and the ARGUMENT is the subject.
400
387
  Correct: `withFilters(c.regex(/^[a-z-]+$/i), fl.regex_test(inp("slug")))`.
401
- - A bare `c.text("^…$")` is an invalid pattern that matches *nothing* for every input,
402
- so a precondition on it silently rejects all values. `c.regex(body, "i")` wraps +
403
- escapes it for you (a JS `RegExp` too: `c.regex(/^…$/i)`).
404
- - Reversed — subject piped, pattern in the argument — reads correctly, type-checks, and
388
+ - A bare `c.text("^…$")` is an invalid pattern that matches *nothing* for every input, so
389
+ a precondition on it rejects all values. `c.regex(body, "i")` (or a JS `RegExp`) wraps + escapes it.
390
+ - Reversed (subject piped, pattern in the argument) type-checks and
405
391
  answers false for EVERY input, so an `if (matches) reject` guard admits what it refuses.
406
- - Build time refuses both: `withFilters` throws on a bare `c.text` pattern from ANY position
407
- in the chain (a normalizer in front of the regex filter is refused too; nothing upstream
408
- adds the delimiters) and on a pattern found in the subject slot; `s.expect.to_match` is the
409
- same PATTERN slot, refused both ways; a `ref`/`inp` pattern is passed through untouched.
410
- `export()` warns on a reversed pair in stored bytes.
411
- - Better still: a native typed input (`input.email`) over hand-rolled validation.
392
+ - `withFilters` throws on both: a bare `c.text` pattern at ANY position in the chain (a
393
+ normalizer in front does not add delimiters) and a pattern in the subject slot.
394
+ `s.expect.to_match` is the same PATTERN slot, refused both ways. A `ref`/`inp` pattern is
395
+ passed through untouched. `export()` warns on a reversed pair in stored bytes.
396
+ - Prefer a native typed input (`input.email`) over hand-rolled validation.
412
397
  - **An `auth()`-keyed limiter FAILS the request on any host with no caller identity —**
413
398
  **at every tier.** `s.redis.ratelimit({ key: withFilters(c.text("rl:"), fl.concat(auth("id"))), error: c.text("…") })`
414
399
  is the per-user form, and a public query, a task, or a function has no caller identity.
@@ -420,8 +405,8 @@ Non-obvious authoring rules:
420
405
  ### Identity, build, and deploy
421
406
 
422
407
  - **Same-name siblings collide — queries excepted: their identity carries group + verb.**
423
- Guids derive from `(type, name)`, so two functions (or tables, toolsets, …) sharing
424
- a name derive ONE guid and `export()` throws — give them DISTINCT names. A QUERY
408
+ Two functions (or tables, toolsets, …) sharing a name derive ONE guid and `export()`
409
+ throws — give them DISTINCT names. A QUERY
425
410
  derives from `(api group, verb, name)`, the engine's own uniqueness: `GET items` +
426
411
  `POST items`, and `items` across two groups, coexist, and the lock keys the same
427
412
  composed identity (`query:blog|GET|items`) — changing a query's verb or group
@@ -455,29 +440,27 @@ Non-obvious authoring rules:
455
440
  the runner has. An explicit `--profile` against it is a hard error too, not a displacement.
456
441
  - On disk: `npx @xano/sdk profile add <name> --instance … --workspace-id <n>` reads the token
457
442
  from piped stdin, else PROMPTS (a flag would reach the process list); the instance must accept it.
458
- `auth.json` holds a map of named profiles, selected by `--profile <name>`. The older
459
- `$XANO_REFRESH_TOKEN` + `$XANO_CLIENT_ID` pair still works but ROTATES: single-use.
460
- - **Event-driven objects fire on an EPHEMERAL.** A `task` (scheduled), an `mcpServer`,
461
- and every trigger — `tableTrigger` included — run normally on an ephemeral env, which
462
- is where `deploy` sends them. So test an event-driven design (screen-on-insert, cron
463
- cleanup, MCP tool call) by deploying it and letting it run.
443
+ `auth.json` holds a map of named profiles, selected by `--profile <name>`.
444
+ `$XANO_REFRESH_TOKEN` + `$XANO_CLIENT_ID` also authenticate, but the refresh token is single-use (it ROTATES).
445
+ - **Event-driven objects run once deployed.** A `task` (scheduled), an `mcpServer`, and
446
+ every trigger — `tableTrigger` included — run on every deploy target, the Xano Engine and
447
+ an ephemeral alike. Test an event-driven design (screen-on-insert, scheduled cleanup, MCP
448
+ tool call) by deploying it and letting it run.
464
449
 
465
450
  ## Statements
466
451
 
467
452
  Reachable through the `s` namespace: `s.<path>({...})`. Declarative statements
468
453
  take one typed args object (field names match the engine); every surface's field
469
454
  signature is in `llms/statements-catalog.md`. Specials (`[special]`) are
470
- hand-authored: control flow is below, and the rest are in the `llms/statements-*`
471
- topic files this doc's navigation names.
472
- Wrap an `input`-routed `value` field in `ignored(...)` to store it but SKIP it at
473
- runtime — the engine records `<name>:ignore` and the parameter falls back to its
474
- default. Not the same as an empty value, and not the same as omitting the field
475
- (which stores no entry at all). Mostly seen on a pulled workspace. A field written
476
- into `context` instead (the `s.math.*`/`s.text.append` mutation family) has no slot
477
- for the flag and THROWS rather than dropping it.
455
+ hand-authored: control flow is below, the rest are in the `llms/statements-*` topic files.
478
456
  Fields marked `value` take a `Value` (`c.*`/`ref`/`inp`); `comparison` takes an
479
457
  `expr(...)`. A `→ as: <type>` suffix names what the statement's `as:` output var
480
458
  holds (curated, not exhaustive — absence means read the `[output]` flag and prose).
459
+ `ignored(...)` around an `input`-routed `value` field stores it but SKIPS it at runtime: the
460
+ engine records `<name>:ignore` and the parameter takes its default. Distinct from an empty
461
+ value and from omitting the field (no entry stored). Mostly seen on a pulled workspace. On a
462
+ `context`-routed field (the `s.math.*`/`s.text.append` mutation family) `ignored(...)` THROWS:
463
+ there is no slot for the flag.
481
464
 
482
465
  ### Specials — authored signatures
483
466