@xano/sdk 1.0.15 → 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 +14 -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-DBHTEFYM.js} +12 -12
  5. package/dist/{agent-skill-command-DV26SDA2.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-NTMXWE5R.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-66ZU2CD5.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-ZYECXDVV.js → chunk-3ZV23FVR.js} +5 -5
  20. package/dist/{chunk-N72XNQNJ.js → chunk-47XIVDJ6.js} +14 -14
  21. package/dist/{chunk-ICK36EGF.js → chunk-4EVDCSEY.js} +2 -2
  22. package/dist/{chunk-AXMUYBWQ.js → chunk-4XGZ325S.js} +3 -3
  23. package/dist/{chunk-P7GKTV7N.js → chunk-4XYXUK5H.js} +75 -32
  24. package/dist/{chunk-AE5CRAKS.js → chunk-4ZBXS7YN.js} +8 -8
  25. package/dist/{chunk-JWASCOHO.js → chunk-52QAENY6.js} +14 -14
  26. package/dist/{chunk-2LF734YB.js → chunk-54CJ74BH.js} +4 -4
  27. package/dist/{chunk-TT6LN55R.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-G4WRZU5T.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-FOBVJ2UR.js → chunk-AJQFUJEQ.js} +8 -8
  37. package/dist/{chunk-DH6O5NQU.js → chunk-C7AYP4H6.js} +29 -20
  38. package/dist/{chunk-SXMZNSQ6.js → chunk-DJMGDCVX.js} +8 -8
  39. package/dist/{chunk-K6SWZ6H4.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-V7WCTXEH.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-FKQX6KU7.js → chunk-F3JK5RIY.js} +2 -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-VXHXSGPU.js → chunk-GRZ62LLU.js} +8 -8
  59. package/dist/{chunk-6X73VFCX.js → chunk-GT7PZCTK.js} +2 -2
  60. package/dist/{chunk-SH4RY6QX.js → chunk-HXPQXCOZ.js} +1536 -413
  61. package/dist/{chunk-ECQXASG3.js → chunk-IFHFJR5O.js} +2 -2
  62. package/dist/{chunk-7ZQ73AHJ.js → chunk-IOWNQEMW.js} +31 -31
  63. package/dist/{chunk-YCKKL5PD.js → chunk-ISIZFK5Q.js} +53 -47
  64. package/dist/{chunk-HCNIB3EC.js → chunk-IUJDUFT7.js} +4 -4
  65. package/dist/{chunk-74OPNM2Z.js → chunk-JHAZK4RY.js} +3 -3
  66. package/dist/{chunk-OZWAITII.js → chunk-KGHJ74HF.js} +6 -6
  67. package/dist/{chunk-XLP4CNSF.js → chunk-L2O5KG5Q.js} +6 -6
  68. package/dist/{chunk-NNI5R6V6.js → chunk-L3Q2QYIQ.js} +72 -72
  69. package/dist/{chunk-UNFQN3TT.js → chunk-LLBEPJBO.js} +3 -3
  70. package/dist/{chunk-VUWR5YLE.js → chunk-LWBGPPI5.js} +13 -13
  71. package/dist/{chunk-RBTZEHXF.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-ZF2CBXT5.js → chunk-NQPPUNWP.js} +3 -3
  78. package/dist/{chunk-5SKWGCAJ.js → chunk-O7Z3LF44.js} +5 -5
  79. package/dist/{chunk-ASQX477B.js → chunk-OLXYZQR7.js} +7 -7
  80. package/dist/{chunk-5SJQAJLF.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-WXKSB2N3.js → chunk-Q7KXMIR3.js} +3 -3
  85. package/dist/{chunk-B6AFJVG4.js → chunk-QCVH32T2.js} +5 -5
  86. package/dist/{chunk-7FIMUFBP.js → chunk-QDPY7RN3.js} +3 -3
  87. package/dist/{chunk-MGG4CHO4.js → chunk-QIT2GGNB.js} +3 -3
  88. package/dist/{chunk-QW7NGUYW.js → chunk-QSJH5AFU.js} +244 -173
  89. package/dist/{chunk-3GZMP7II.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-M7O3T7IM.js → chunk-RIT3WBBX.js} +4 -4
  93. package/dist/{chunk-45K2QZBR.js → chunk-RKNCISPM.js} +3 -3
  94. package/dist/{chunk-NPYYDTXS.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-A2N2C2WD.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-R3GPRNBT.js → chunk-SVQMDVND.js} +87 -16
  104. package/dist/{chunk-45ZUMF4E.js → chunk-TPUAXIPR.js} +2 -2
  105. package/dist/{chunk-SL55XKVL.js → chunk-TXU34ELY.js} +25 -25
  106. package/dist/{chunk-GDJCWQIK.js → chunk-U4UAWGIT.js} +12 -8
  107. package/dist/{chunk-76SBT7KS.js → chunk-U56HK2RG.js} +7 -5
  108. package/dist/{chunk-RXNMZM6H.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-ZDVVIJPU.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-6EFXPTHT.js → chunk-WAP5362D.js} +5 -5
  115. package/dist/{chunk-XY4OBD26.js → chunk-WGKKDGSA.js} +4 -4
  116. package/dist/{chunk-TXFOQZUQ.js → chunk-WVVUE7LU.js} +14 -7
  117. package/dist/{chunk-JAYHFXWH.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-7AKH4QDJ.js → chunk-XKMZYU5B.js} +96 -65
  122. package/dist/{chunk-UVHSMANV.js → chunk-Y3RH35KM.js} +47 -47
  123. package/dist/{chunk-GIQIMWTK.js → chunk-YHT7TDSH.js} +14 -14
  124. package/dist/{chunk-FXZEZAV2.js → chunk-YJXJOMXW.js} +3 -3
  125. package/dist/{chunk-ZPJXWMHK.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-ZC6H2ERE.js → chunk-ZF4LCHCT.js} +5 -5
  129. package/dist/{chunk-GRXX2TOJ.js → chunk-ZHFSIQ6E.js} +2 -2
  130. package/dist/{chunk-SHHXLI2K.js → chunk-ZJQFKBX7.js} +7 -7
  131. package/dist/{chunk-ZRXDPCMN.js → chunk-ZYZ7GRX3.js} +2 -2
  132. package/dist/{chunk-CJGLAQRD.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-BYAZZF37.js → deploy-command-PBM3S4ZL.js} +69 -68
  142. package/dist/{deploy-source-QCPZWNJO.js → deploy-source-JW7DAN75.js} +32 -32
  143. package/dist/{dev-env-sync-6MHK3UHC.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-KUIEKBTM.js → env-pull-command-FFPNRVWD.js} +52 -52
  149. package/dist/{env-target-Y77RLRS5.js → env-target-XHVRZXHX.js} +14 -14
  150. package/dist/{env-var-command-BZWJD75C.js → env-var-command-DJS62YRR.js} +41 -41
  151. package/dist/{ephemeral-VLPRDNEJ.js → ephemeral-2DXWP3VK.js} +9 -9
  152. package/dist/{ephemeral-command-SYKDPALW.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-CSQDQZSW.js → generate-command-PSDIIOTU.js} +89 -88
  155. package/dist/{gitignore-OQGYM7DO.js → gitignore-PMJ6MFNA.js} +15 -15
  156. package/dist/{guards-JUYBDLZY.js → guards-YICHJKX3.js} +51 -15
  157. package/dist/{impersonate-command-HSFCZBV6.js → impersonate-command-IKV4KUYA.js} +37 -37
  158. package/dist/{import-T4ZTOTBT.js → import-VJQGIS33.js} +5 -5
  159. package/dist/index.d.ts +552 -117
  160. package/dist/index.js +29 -28
  161. package/dist/init-command-LEQIE6GC.js +143 -0
  162. package/dist/{init-modules-BL2SR5RK.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-SHF75FC7.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-7EOLEKH3.js → landing-record-JQ7HZDGI.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-DFAMYOIF.js} +35 -35
  173. package/dist/{local-engine-command-6KSRDZBR.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-XTP3EATV.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-437P6BHY.js → lock-commands-7VO6YWOV.js} +67 -66
  182. package/dist/{login-command-BNRDAVFV.js → login-command-WTZUBCW6.js} +27 -27
  183. package/dist/{logout-command-FCGCHB7Y.js → logout-command-5BJUNK3C.js} +17 -17
  184. package/dist/{loop-WOAEXMTC.js → loop-HILLODVH.js} +15 -15
  185. package/dist/{marketplace-command-SUBJZPJV.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-AYJS3RQ3.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-ORQPVJKB.js → operation-outcome-WK7UW6PJ.js} +24 -24
  192. package/dist/{output-target-KNHHNDM3.js → output-target-5PYRCCK4.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-3BX2WW3S.js} +75 -74
  198. package/dist/{profile-command-U2XTKOMF.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-5ZVZ6IYT.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-LDN5DOKQ.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-BMAOL6WN.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-7QM3ORGX.js → secrets-file-7XWR7HW3.js} +15 -15
  215. package/dist/{secrets-fill-command-OZ537VOD.js → secrets-fill-command-NKCGC75L.js} +66 -65
  216. package/dist/{seed-ATGBOEJP.js → seed-YKTZDS2Q.js} +13 -13
  217. package/dist/{source-resolve-QYSWA3QR.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-IEB4K7ME.js → status-command-TBMQ3GJP.js} +38 -38
  220. package/dist/{store-AJX4MC7Y.js → store-B63BQV6R.js} +6 -6
  221. package/dist/{store-DspGMsFY.d.ts → store-in7gSpMS.d.ts} +185 -11
  222. package/dist/sync-baseline-GRS33AB5.js +38 -0
  223. package/dist/{sync-contributions-DLV5JZUK.js → sync-contributions-RKPLZPPO.js} +9 -9
  224. package/dist/{sync-record-NE62ERA3.js → sync-record-AWFCSS4D.js} +15 -15
  225. package/dist/{table-TFD4ZQXA.js → table-ONGT3JGE.js} +12 -12
  226. package/dist/{tables-command-IMCVPUFY.js → tables-command-UYQ277TJ.js} +41 -41
  227. package/dist/{tenant-IIYECNWO.js → tenant-IXIW3FOI.js} +10 -10
  228. package/dist/{tenant-command-77KG76MU.js → tenant-command-7LWZUK2V.js} +104 -103
  229. package/dist/{test-command-NSPU4RUO.js → test-command-7KTT5EAF.js} +56 -45
  230. package/dist/{tests-JWQRHFCT.js → tests-N4MMBABH.js} +6 -6
  231. package/dist/{token-BDHD7GU3.js → token-3TCMW2AP.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-PBVBCPQJ.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-YDUUQZQF.js} +34 -34
  236. package/dist/update-check-C6KDFGMT.js +141 -0
  237. package/dist/{upgrade-command-YCADQCIA.js → upgrade-command-ZSBTSMBR.js} +68 -67
  238. package/dist/{whoami-command-IZCTUPM4.js → whoami-command-L6ERHR5K.js} +16 -16
  239. package/dist/{workspace-TK52V7WO.js → workspace-5DPSDM4A.js} +5 -5
  240. package/dist/{workspace-binding-3UT6PP4B.js → workspace-binding-MVOWGNYW.js} +15 -15
  241. package/dist/{workspace-command-46OCB6XT.js → workspace-command-PKQ5TDR7.js} +100 -99
  242. package/dist/{workspace-env-PVPOWFNZ.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-XXJT365U.js → xanosdk-import-HHMQDK2I.js} +10 -10
  247. package/dist/{xanosdk-project-CJKRLQ6U.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 +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 +14 -18
  273. package/llms/values.md +16 -9
  274. package/llms-full.txt +643 -503
  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
package/manifest.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "xanosdk",
3
- "version": "1.0.15",
3
+ "version": "1.0.16",
4
4
  "description": "TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.",
5
5
  "coverage": {
6
6
  "objectKinds": {
@@ -34,8 +34,8 @@
34
34
  ]
35
35
  },
36
36
  "statements": {
37
- "implemented": 218,
38
- "total": 218
37
+ "implemented": 219,
38
+ "total": 219
39
39
  },
40
40
  "filters": {
41
41
  "typed": 246,
@@ -52,7 +52,7 @@
52
52
  {
53
53
  "name": "c.int",
54
54
  "signature": "(n: number | bigint | string) => Value",
55
- "description": "Integer constant → tag \"const:int\". The engine stores integers as STRINGS and has no 53-bit limit, so pass a string or bigint for anything past Number.MAX_SAFE_INTEGER — c.int(\"9223372036854775807\") is exact where the number literal for it is already …808. A number that is not a safe integer THROWS rather than encoding the rounded value. The VALUE encodes at any width, but an `f.int` COLUMN is signed 64-bit and CLAMPS past its ceiling rather than failing — see `llms/fields.md`."
55
+ "description": "Integer constant → tag \"const:int\". The engine stores integers as STRINGS and has no 53-bit limit, so pass a string or bigint for anything past Number.MAX_SAFE_INTEGER — c.int(\"9223372036854775807\") is exact where the number literal for it is already …808. A number that is not a safe integer THROWS rather than encoding the rounded value. For the int64 clamp of an `f.int` column see `llms/fields.md`."
56
56
  },
57
57
  {
58
58
  "name": "c.decimal",
@@ -62,7 +62,7 @@
62
62
  {
63
63
  "name": "c.blank",
64
64
  "signature": "(tag: \"const:<type>\") => Value",
65
- "description": "The editor's UNCONFIGURED value box (stored value \"\"), emitted by codegen for a pulled workspace — do not author it. NOT a zero or an empty collection: the engine reads \"\" and \"0\" differently, so c.blank(\"const:int\") ≠ c.int(0) and neither canonicalizes into the other. Constant tags except const/const:obj, whose blanks are c.text(\"\")/c.obj(null)."
65
+ "description": "The editor's UNCONFIGURED value box (stored value \"\"), emitted by codegen for a pulled workspace — do not author it. NOT a zero or an empty collection: the engine reads \"\" and \"0\" differently, so c.blank(\"const:int\") ≠ c.int(0) and neither canonicalizes into the other. Valid for every constant tag except `const` and `const:obj`; their blanks are `c.text(\"\")` and `c.obj(null)`."
66
66
  },
67
67
  {
68
68
  "name": "c.bool",
@@ -77,7 +77,7 @@
77
77
  {
78
78
  "name": "c.obj",
79
79
  "signature": "(o?: Json | null) => Value",
80
- "description": "Object constant → tag \"const:obj\". A populated one stores an empty {} carrying one `set` filter per key — the editor's form, and the only populated form the engine reads back (a populated JSON string arrives truncated and fails the request with ERROR_FATAL \"Unable to decode.\"). ⚠ a ZERO-BASED numeric key is an INDEX in the engine's data model, so c.obj({\"0\":\"a\"}) evaluates to the list [\"a\"] (a non-zero-based one like {\"2\":…} survives as a key) — that is the platform, not this encoding. Write c.array([...]) for a list, or prefix the keys (\"k0\") for an object; `export()` warns. No argument = the empty object {} — use this one. Explicit null = the legacy blank form the engine evaluates to null, NOT {}; it exists only so a pulled workspace round-trips, do not author it. Plain JSON literals only — a nested tagged value (inp/ref/auth/c.*) is rejected; for a computed object response use a record of values, not c.obj."
80
+ "description": "Object constant → tag \"const:obj\". A populated one stores an empty {} carrying one `set` filter per key (a populated JSON string fails the request with ERROR_FATAL \"Unable to decode.\"). ⚠ A ZERO-BASED numeric key is an INDEX: c.obj({\"0\":\"a\"}) evaluates to the list [\"a\"] ({\"2\":…} stays a key) — write c.array([...]) for a list, or prefix the keys (\"k0\") for an object; `export()` warns. c.obj() is the empty object {}. c.obj(null) is a pulled-workspace blank that evaluates to null; do not author it. Plain JSON literals only — a nested tagged value (inp/ref/auth/c.*) is rejected; for a computed object use a record of values."
81
81
  },
82
82
  {
83
83
  "name": "c.array",
@@ -87,7 +87,7 @@
87
87
  {
88
88
  "name": "c.expression",
89
89
  "signature": "(source: string) => Value",
90
- "description": "Xano Expression Engine source, passed through VERBATIM → tag \"const:expr2\". The string IS the expression: c.expression('\"Hi, \" ~ $input.name'), c.expression(\"$var.price * $var.qty\"). ⚠️ NOT VALIDATED — never parsed or type-checked, invisible to InferResponse, and untouched by a rename that updates every typed ref(); a typo surfaces at runtime or as a wrong answer. Use it ONLY for syntax the typed surfaces cannot express (~ concatenation, inline arithmetic, conditionals) — prefer ref/inp/col, withFilters+fl.*, and obj() (which BUILDS a checked expression). Not the expr() condition builder."
90
+ "description": "Xano Expression Engine source, passed through VERBATIM → tag \"const:expr2\". The string IS the expression: c.expression('\"Hi, \" ~ $input.name'), c.expression(\"$var.price * $var.qty\"). ⚠ Unvalidated: not parsed, typed (invisible to InferResponse), or renamed with refs; a typo surfaces at runtime. Use only for syntax typed surfaces lack (`~`, inline arithmetic, conditionals); otherwise prefer ref/inp/col, withFilters+fl.*, and obj() (which builds a checked expression). Not the expr() condition builder."
91
91
  },
92
92
  {
93
93
  "name": "c.expressionLegacy",
@@ -98,12 +98,12 @@
98
98
  {
99
99
  "name": "c.now",
100
100
  "signature": "() => Value",
101
- "description": "Current time as epoch-ms — the engine-native const:epochms constant (no filter). Valid inline as a where/cmp operand. For cutoff math (cutoff = now - max_age) either compare inline or, for reuse/readability, hoist it into an s.set_var and compare against the var."
101
+ "description": "Current time as epoch-ms — the engine-native const:epochms constant. Valid inline as a where/cmp operand."
102
102
  },
103
103
  {
104
104
  "name": "obj",
105
105
  "signature": "(fields: Record<string, Value | nested>) => ObjValue<typeof fields>",
106
- "description": "Dynamic object value → tag \"const:expr2\" (an object-literal expression string). The dynamic sibling of c.obj: members may be inp/ref/auth values, env()/setting()/sys.*, c.now(), c.* constants, nested records, or arrays — and each member may carry a FILTER CHAIN (withFilters + fl.*), which renders as the expression pipe `$var.row|get:\"a.b\"`. A null-safe ref(path, { safe: true }) works inside an obj() member directly. The member record rides the return type, so InferResponse (through a set_var too) resolves each member like a top-level response key — `response: { user: obj({ id: ref(\"row.id\") }) }` derives `{ user: { id: Col | null } }`, and a raw nested object literal (`response: { user: { id: ref(\"row.id\") } }`, auto-wrapped through this) derives the same. A constant record or list has two spellings that both work and render identically: bare (`{ a: 1 }`, `[]`) or `c.obj(...)`/`c.array([...])` — prefer the bare form. An inner obj() nests, same bytes as a raw record. The legacy blank `c.obj(null)` is refused here (it evaluates to null, not {}) — write c.null() or c.obj(). Still rejected: a filter ARGUMENT that carries its own chain or is a c.now() (a trailing | binds to the whole value, not one argument, and c.now() needs one), a DISABLED filter (an expression string cannot record that), and the output/response/trycatch/toolset/reg tags (a type error) — set_var those first and ref() them."
106
+ "description": "Dynamic object value → tag \"const:expr2\" (an object-literal expression string); the dynamic sibling of c.obj.\n - Members: inp/ref/auth values, env()/setting()/sys.*, c.now(), c.* constants, nested records, or arrays. Each may carry a FILTER CHAIN (withFilters + fl.*), rendered as the expression pipe `$var.row|get:\"a.b\"`. A null-safe ref(path, { safe: true }) works in a member directly. An inner obj() nests, same bytes as a raw record.\n - InferResponse (through a set_var too) resolves each member like a top-level response key: `response: { user: obj({ id: ref(\"row.id\") }) }` derives `{ user: { id: Col } }`, and a raw nested object literal (`response: { user: { id: ref(\"row.id\") } }`, auto-wrapped through this) derives the same.\n - A constant record or list has two spellings that both work and render identically: bare (`{ a: 1 }`, `[]`) or `c.obj(...)`/`c.array([...])` — prefer the bare form.\n - Rejected: the blank `c.obj(null)` is refused here (write c.null() or c.obj()); a filter ARGUMENT that carries its own chain or is a c.now(); a DISABLED filter; the output/response/trycatch/toolset/reg tags (a type error) — set_var those first and ref() them."
107
107
  },
108
108
  {
109
109
  "name": "ref",
@@ -113,7 +113,7 @@
113
113
  {
114
114
  "name": "inp",
115
115
  "signature": "(name: string) => Value",
116
- "description": "Reference a function/endpoint input → tag \"input\". Resolves ONLY against the `input` block of the def it sits in — a value produced earlier in the stack is `ref(\"var.field\")`, not `inp(\"field\")`. A name that is not declared here deploys clean and fails at runtime with ERROR_FATAL \"Unable to locate input: <name>\" on every branch that reads it; `export()` warns, and `--strict` fails the build. Sending the name in the request does NOT rescue it — an undeclared input is never bound, so the call fails identically with the value present. A dotted path drills INTO a declared input (`inp(\"action.amount\")` needs a declared `action`)."
116
+ "description": "Reference a function/endpoint input → tag \"input\". Resolves ONLY against the `input` block of the def it sits in — a value produced earlier in the stack is `ref(\"var.field\")`, not `inp(\"field\")`. A name that is not declared here deploys clean and fails at runtime with ERROR_FATAL \"Unable to locate input: <name>\" on every branch that reads it; `export()` warns, and `--strict` fails the build. Sending the name in the request does NOT rescue it. A dotted path drills INTO a declared input (`inp(\"action.amount\")` needs a declared `action`). ⚠ An omitted/`null` optional input binds its EMPTY value (`\"\"`/`0`/`false`/`[]`/`{}`; `\"\"` for an enum), not null — only a type whose input defaults to `nullable: true` (vector, uuid, date, timestamp, file types; `llms/fields.md`) or one set `nullable: true` binds null. An omitted optional `input.geo.*` is not bound at all."
117
117
  },
118
118
  {
119
119
  "name": "col",
@@ -122,8 +122,8 @@
122
122
  },
123
123
  {
124
124
  "name": "auth",
125
- "signature": "(path?: string) => Value",
126
- "description": "Reference the authenticated identity (auth(\"id\") → $auth.id) → tag \"auth\"."
125
+ "signature": "(path: string) => Value",
126
+ "description": "Reference the authenticated identity (auth(\"id\") → $auth.id) → tag \"auth\". The PATH is required: the engine cannot read a bare auth, so auth(\"\") throws. A token minted with extras exposes its claims at auth(\"extras.<key>\") (auth(\"extras\") is the whole map); a key absent from the token is a 500, not null."
127
127
  },
128
128
  {
129
129
  "name": "caught",
@@ -138,7 +138,7 @@
138
138
  {
139
139
  "name": "env",
140
140
  "signature": "(name: string) => Value",
141
- "description": "Read a WORKSPACE environment variable (set via workspaceConfig({ env }) or the dashboard) → `$env.NAME`. Compiles to tag \"setting\" with the plain name. env(\"remote_ip\") reads a user var named remote_ip, not the caller IP — use sys.remoteIp() for that. A name that does not exist resolves to NULL rather than erroring, so a typo deploys clean and fails downstream of the value: prefer typedEnv(config), which turns the names that config declares into properties (E.STRIPE_KEY), and export() warns stack.env-undeclared on any env() or bare setting() outside the declared set once a config declares env at all."
141
+ "description": "Read a WORKSPACE environment variable (set via workspaceConfig({ env }) or the dashboard) → `$env.NAME`. Compiles to tag \"setting\" with the plain name.\n - Every value is TEXT (or null), edge whitespace trimmed on read: compare a flag against c.text(\"true\"), not c.bool(true) (under loose `=`, FLAG=false equals c.bool(true)); a numeric use needs fl.to_int/fl.to_decimal.\n - env(\"remote_ip\") reads a user var named remote_ip, not the caller IP — use sys.remoteIp().\n - A name that does not exist resolves to NULL rather than erroring, so a typo deploys clean: prefer typedEnv(config), which turns the names that config declares into properties (E.STRIPE_KEY). Once a config declares env, export() warns stack.env-undeclared on any env() or bare setting() outside the declared set."
142
142
  },
143
143
  {
144
144
  "name": "setting",
@@ -239,7 +239,7 @@
239
239
  "authorFactory": "realtimeTrigger",
240
240
  "objType": "workspace_realtime_channel",
241
241
  "legacy": true,
242
- "description": "the SUPERSEDED realtime trigger, against the workspace-global realtime layer — a different object from the current `channel`, despite the similar name. For a join hook use `realtimeChannelTrigger({ actions: { join: true } })`; for message handling use a `realtimeMessage()` handler, which is the current equivalent of its `message` action (a message is an authored unit now, not a trigger action)."
242
+ "description": "the SUPERSEDED realtime trigger, against the workspace-global realtime layer — a different object from the current `channel`, despite the similar name. For a join hook use `realtimeChannelTrigger({ actions: { join: true } })`; for message handling use a `realtimeMessage()` handler, which is the equivalent of its `message` action (a message is its own object, not a trigger action)."
243
243
  },
244
244
  {
245
245
  "authorFactory": "realtimeServerTrigger",
@@ -318,7 +318,7 @@
318
318
  "kind": "task",
319
319
  "payloadKey": "task",
320
320
  "authorFactory": "task",
321
- "description": "A scheduled background job (cron/interval) that runs a stack on a timer.",
321
+ "description": "A scheduled background job that runs a stack on a fixed interval (no cron).",
322
322
  "registerMethod": "registerTasks",
323
323
  "registered": true
324
324
  },
@@ -326,7 +326,7 @@
326
326
  "kind": "workflow_test",
327
327
  "payloadKey": "workflow_test",
328
328
  "authorFactory": "workflowTest",
329
- "description": "An end-to-end test: a named stack with NO input and NO response that invokes other objects (`s.function.call`, `s.task.call`, `s.api.call`) and asserts on what they bind with `s.expect.*`. `datasource` defaults to `\"\"` (an EMPTY datasource, recommended); naming one CLONES it before every run — see `llms/kinds-core.md`.",
329
+ "description": "An end-to-end test: a named stack with NO input and NO response that invokes other objects (`s.function.call`, `s.task.call`, `s.api.call`) and asserts on what they bind with `s.expect.*`. `datasource`: `llms/kinds-core.md`.",
330
330
  "registerMethod": "registerWorkflowTests",
331
331
  "registered": true
332
332
  },
@@ -334,7 +334,7 @@
334
334
  "kind": "middleware",
335
335
  "payloadKey": "middleware",
336
336
  "authorFactory": "middleware",
337
- "description": "A reusable pre/post stack attached to a query/function/task/tool/API group to run before or after its own logic.",
337
+ "description": "A reusable pre/post stack attached to a host (query, function, task, tool, API group, prompt, resource, realtime server/channel/message) to run before or after its own logic.",
338
338
  "registerMethod": "registerMiddleware",
339
339
  "registered": true
340
340
  },
@@ -382,7 +382,7 @@
382
382
  "kind": "knowledge",
383
383
  "payloadKey": "knowledge",
384
384
  "authorFactory": "knowledge",
385
- "description": "Markdown shared by every AI that builds the backend — Xano's own AI (the builder agent, Meta API / MCP readers) and a local coding agent reading the same files — never an `agent()` run: an `agents.md` of standing instructions, a `skill`, or a `doc`. The body is a real markdown FILE via `knowledgeFile(\"./x.md\", import.meta.url)`, and `mode` decides how much of it reaches the agent.",
385
+ "description": "Markdown for the AIs that build the backend (never an `agent()` run): an `agents.md` of standing instructions, a `skill`, or a `doc`. The body is a markdown FILE via `knowledgeFile(\"./x.md\", import.meta.url)`; readers and `mode`: `llms/kinds-knowledge.md`.",
386
386
  "registerMethod": "registerKnowledge",
387
387
  "registered": true
388
388
  },
@@ -2942,11 +2942,7 @@
2942
2942
  "type": "value",
2943
2943
  "optional": false
2944
2944
  }
2945
- ],
2946
- "result": {
2947
- "name": "as",
2948
- "type": "number"
2949
- }
2945
+ ]
2950
2946
  },
2951
2947
  {
2952
2948
  "surface": "math.bitwise.and",
@@ -2966,11 +2962,7 @@
2966
2962
  "type": "value",
2967
2963
  "optional": false
2968
2964
  }
2969
- ],
2970
- "result": {
2971
- "name": "as",
2972
- "type": "number"
2973
- }
2965
+ ]
2974
2966
  },
2975
2967
  {
2976
2968
  "surface": "math.bitwise.or",
@@ -2990,11 +2982,7 @@
2990
2982
  "type": "value",
2991
2983
  "optional": false
2992
2984
  }
2993
- ],
2994
- "result": {
2995
- "name": "as",
2996
- "type": "number"
2997
- }
2985
+ ]
2998
2986
  },
2999
2987
  {
3000
2988
  "surface": "math.bitwise.xor",
@@ -3014,11 +3002,7 @@
3014
3002
  "type": "value",
3015
3003
  "optional": false
3016
3004
  }
3017
- ],
3018
- "result": {
3019
- "name": "as",
3020
- "type": "number"
3021
- }
3005
+ ]
3022
3006
  },
3023
3007
  {
3024
3008
  "surface": "math.div",
@@ -3260,7 +3244,8 @@
3260
3244
  ],
3261
3245
  "result": {
3262
3246
  "name": "as",
3263
- "type": "[string, unknown][]"
3247
+ "type": "{ key: string | number; value: unknown }[]",
3248
+ "note": "each entry is a { key, value } OBJECT, NOT a [key, value] tuple; an integer-like key comes back as a number"
3264
3249
  }
3265
3250
  },
3266
3251
  {
@@ -3284,7 +3269,8 @@
3284
3269
  ],
3285
3270
  "result": {
3286
3271
  "name": "as",
3287
- "type": "string[]"
3272
+ "type": "(string | number)[]",
3273
+ "note": "an integer-like key comes back as a NUMBER (PHP coerces it), not a string"
3288
3274
  }
3289
3275
  },
3290
3276
  {
@@ -3375,6 +3361,13 @@
3375
3361
  "registered": true,
3376
3362
  "declarative": false
3377
3363
  },
3364
+ {
3365
+ "surface": "realtime.kick",
3366
+ "storedName": "mvp:realtime_kick",
3367
+ "sPath": "realtime.kick",
3368
+ "registered": true,
3369
+ "declarative": false
3370
+ },
3378
3371
  {
3379
3372
  "surface": "redis.count",
3380
3373
  "storedName": "mvp:redis_countlist",
@@ -3794,7 +3787,7 @@
3794
3787
  "result": {
3795
3788
  "name": "as",
3796
3789
  "type": "boolean",
3797
- "note": "true when the plaintext matches the stored hash. ⚠ input.password double-hashes — pass input.text() plaintext"
3790
+ "note": "true when the plaintext matches the stored hash. ⚠ not input.password — pass input.text() plaintext. ⚠ THROWS 500 on a non-hash hash_password (Invalid password syntax.)"
3798
3791
  }
3799
3792
  },
3800
3793
  {
@@ -3997,7 +3990,12 @@
3997
3990
  "type": "value",
3998
3991
  "optional": false
3999
3992
  }
4000
- ]
3993
+ ],
3994
+ "result": {
3995
+ "name": "as",
3996
+ "type": "unknown",
3997
+ "note": "the plaintext; takes encrypt's RAW bytes (fl.base64_decode() a stored base64 first). ⚠ THROWS 500 on a wrong key/iv or non-ciphertext — wrap in s.try_catch"
3998
+ }
4001
3999
  },
4002
4000
  {
4003
4001
  "surface": "security.encrypt",
@@ -4104,7 +4102,12 @@
4104
4102
  "type": "value",
4105
4103
  "optional": true
4106
4104
  }
4107
- ]
4105
+ ],
4106
+ "result": {
4107
+ "name": "as",
4108
+ "type": "unknown",
4109
+ "note": "the decoded claims. ⚠ THROWS 500 ERROR_FATAL on ANY failure (bad/expired token, wrong key/algorithm, failed check_claims) — wrap in s.try_catch for a 401 (statements-calls.md)"
4110
+ }
4108
4111
  },
4109
4112
  {
4110
4113
  "surface": "security.jwe_encode",
@@ -4222,7 +4225,12 @@
4222
4225
  "type": "value",
4223
4226
  "optional": true
4224
4227
  }
4225
- ]
4228
+ ],
4229
+ "result": {
4230
+ "name": "as",
4231
+ "type": "unknown",
4232
+ "note": "the decoded claims. ⚠ THROWS 500 ERROR_FATAL on ANY failure (bad/garbage/expired/tampered token, wrong key/signature_algorithm, failed check_claims) — wrap in s.try_catch for a 401 (statements-calls.md)"
4233
+ }
4226
4234
  },
4227
4235
  {
4228
4236
  "surface": "security.jws_encode",
@@ -4296,7 +4304,12 @@
4296
4304
  "type": "value",
4297
4305
  "optional": true
4298
4306
  }
4299
- ]
4307
+ ],
4308
+ "result": {
4309
+ "name": "as",
4310
+ "type": "string",
4311
+ "note": "RAW bytes (encrypt too) — fl.bin2hex()/fl.base64_encode() before returning or storing; raw binary mangles in a JSON/text response"
4312
+ }
4300
4313
  },
4301
4314
  {
4302
4315
  "surface": "security.random_number",
@@ -4693,7 +4706,12 @@
4693
4706
  "type": "value",
4694
4707
  "optional": true
4695
4708
  }
4696
- ]
4709
+ ],
4710
+ "result": {
4711
+ "name": "as",
4712
+ "type": "XanoFileRef",
4713
+ "note": "the stored file VALUE ({ access, path, name, type, size, mime, meta }) — write it into an f.attachment() cell. ⚠ include_meta: true binds the file's internal RECORD instead (id, guid, sig, the storage BUCKET name): never store it as the file value or return it (warns storage.include-meta-returned). type (also optional) coerces the kind when it is image/video/audio"
4714
+ }
4697
4715
  },
4698
4716
  {
4699
4717
  "surface": "storage.create_audio",
@@ -5012,7 +5030,11 @@
5012
5030
  "type": "value",
5013
5031
  "optional": false
5014
5032
  }
5015
- ]
5033
+ ],
5034
+ "result": {
5035
+ "name": "as",
5036
+ "type": "boolean"
5037
+ }
5016
5038
  },
5017
5039
  {
5018
5040
  "surface": "text.ends_with",
@@ -5037,7 +5059,11 @@
5037
5059
  "type": "value",
5038
5060
  "optional": false
5039
5061
  }
5040
- ]
5062
+ ],
5063
+ "result": {
5064
+ "name": "as",
5065
+ "type": "boolean"
5066
+ }
5041
5067
  },
5042
5068
  {
5043
5069
  "surface": "text.icontains",
@@ -5062,7 +5088,11 @@
5062
5088
  "type": "value",
5063
5089
  "optional": false
5064
5090
  }
5065
- ]
5091
+ ],
5092
+ "result": {
5093
+ "name": "as",
5094
+ "type": "boolean"
5095
+ }
5066
5096
  },
5067
5097
  {
5068
5098
  "surface": "text.iends_with",
@@ -5087,7 +5117,11 @@
5087
5117
  "type": "value",
5088
5118
  "optional": false
5089
5119
  }
5090
- ]
5120
+ ],
5121
+ "result": {
5122
+ "name": "as",
5123
+ "type": "boolean"
5124
+ }
5091
5125
  },
5092
5126
  {
5093
5127
  "surface": "text.istarts_with",
@@ -5112,7 +5146,11 @@
5112
5146
  "type": "value",
5113
5147
  "optional": false
5114
5148
  }
5115
- ]
5149
+ ],
5150
+ "result": {
5151
+ "name": "as",
5152
+ "type": "boolean"
5153
+ }
5116
5154
  },
5117
5155
  {
5118
5156
  "surface": "text.ltrim",
@@ -5197,7 +5235,11 @@
5197
5235
  "type": "value",
5198
5236
  "optional": false
5199
5237
  }
5200
- ]
5238
+ ],
5239
+ "result": {
5240
+ "name": "as",
5241
+ "type": "boolean"
5242
+ }
5201
5243
  },
5202
5244
  {
5203
5245
  "surface": "text.trim",
@@ -5237,6 +5279,11 @@
5237
5279
  "name": "value",
5238
5280
  "type": "value",
5239
5281
  "optional": false
5282
+ },
5283
+ {
5284
+ "name": "status",
5285
+ "type": "number",
5286
+ "optional": true
5240
5287
  }
5241
5288
  ]
5242
5289
  },
@@ -5320,7 +5367,7 @@
5320
5367
  "result": {
5321
5368
  "name": "as",
5322
5369
  "type": "unknown",
5323
- "note": "inside an ATTACHED middleware it is a { type, vars } envelope whose vars DIFFERS BY PHASE: pre → the request inputs; post → { status, result } (plus payload on an error), NOT the request — read the request in post with s.util.get_raw_input. See llms/kinds-core.md"
5370
+ "note": "inside an ATTACHED middleware it is a { type, vars } envelope whose vars DIFFERS BY PHASE: pre → the request inputs; post → { status, result }, NOT the request — read the request in post with s.util.get_raw_input. ⚠ status is the STRING \"ok\" | \"exception\" (NOT an HTTP code), so store it in a text column, not f.int(); on \"exception\", result is the { code, message, payload } error and payload is set. See llms/kinds-core.md"
5324
5371
  }
5325
5372
  },
5326
5373
  {
@@ -5337,7 +5384,12 @@
5337
5384
  "optional": true,
5338
5385
  "default": ""
5339
5386
  }
5340
- ]
5387
+ ],
5388
+ "result": {
5389
+ "name": "as",
5390
+ "type": "Record<string, string>",
5391
+ "note": "every workspace env var (declared AND dashboard) as one { NAME: value } object, each value TEXT — so this binds every SECRET; never return it to a client or write it to a row"
5392
+ }
5341
5393
  },
5342
5394
  {
5343
5395
  "surface": "util.get_input",
@@ -5793,7 +5845,7 @@
5793
5845
  ],
5794
5846
  "result": "<T>[]",
5795
5847
  "group": "array",
5796
- "description": "Return the entries from the first array that are not in the second"
5848
+ "description": "Return the entries from the first array that are not in the second array. Only values are used for matching."
5797
5849
  },
5798
5850
  {
5799
5851
  "name": "array_diff_assoc",
@@ -5807,7 +5859,7 @@
5807
5859
  ],
5808
5860
  "result": "<T>[]",
5809
5861
  "group": "array",
5810
- "description": "Return the entries from the first array that are not in the second"
5862
+ "description": "Return the entries from the first array that are not in the second array. Values and keys are used for matching."
5811
5863
  },
5812
5864
  {
5813
5865
  "name": "array_entries",
@@ -5815,7 +5867,7 @@
5815
5867
  "typed": true,
5816
5868
  "result": "any[]",
5817
5869
  "group": "array",
5818
- "description": "Get the property entries of an object/array as a numerically"
5870
+ "description": "Get the property entries of an object/array as a numerically indexed array of key/value pairs."
5819
5871
  },
5820
5872
  {
5821
5873
  "name": "array_fill",
@@ -5908,7 +5960,7 @@
5908
5960
  ],
5909
5961
  "result": "<T>[]",
5910
5962
  "group": "array",
5911
- "description": "Return the entries from the first array that are also present in"
5963
+ "description": "Return the entries from the first array that are also present in the second array. Only values are used for matching."
5912
5964
  },
5913
5965
  {
5914
5966
  "name": "array_intersect_assoc",
@@ -5922,7 +5974,7 @@
5922
5974
  ],
5923
5975
  "result": "<T>[]",
5924
5976
  "group": "array",
5925
- "description": "Return the entries from the first array that are also present in"
5977
+ "description": "Return the entries from the first array that are also present in the second array. Values and keys are used for matching."
5926
5978
  },
5927
5979
  {
5928
5980
  "name": "array_keys",
@@ -5952,7 +6004,7 @@
5952
6004
  ],
5953
6005
  "result": "<T>[]",
5954
6006
  "group": "array",
5955
- "description": "Merge the first level of elements of both arrays together and"
6007
+ "description": "Merge the first level of elements of both arrays together and return the new array"
5956
6008
  },
5957
6009
  {
5958
6010
  "name": "array_merge_recursive",
@@ -5966,7 +6018,7 @@
5966
6018
  ],
5967
6019
  "result": "<T>[]",
5968
6020
  "group": "array",
5969
- "description": "Merge the elements from all levels of both arrays together and"
6021
+ "description": "Merge the elements from all levels of both arrays together and return the new array"
5970
6022
  },
5971
6023
  {
5972
6024
  "name": "array_pop",
@@ -6029,7 +6081,7 @@
6029
6081
  ],
6030
6082
  "result": "<T>[]",
6031
6083
  "group": "array",
6032
- "description": "Remove any elements from the array that match the supplied value"
6084
+ "description": "Remove any elements from the array that match the supplied value and then return the new array"
6033
6085
  },
6034
6086
  {
6035
6087
  "name": "array_replace",
@@ -6132,7 +6184,7 @@
6132
6184
  ],
6133
6185
  "result": "<T>[]",
6134
6186
  "group": "array",
6135
- "description": "Merges `node` INTO every element matching `match` (loose comparison) and returns the array. An update-in-place for a list of records, where `array_replace` swaps the whole element."
6187
+ "description": "Merges `node` into the FIRST element matching `match` (loose comparison) and returns the array; on a MISS it APPENDS `node` as a new element — an UPSERT, not an update-all. To update every match use `fl.map`/`s.array.map`. `array_replace` is also first-match-only but swaps the whole element and THROWS on a miss."
6136
6188
  },
6137
6189
  {
6138
6190
  "name": "array_values",
@@ -6266,8 +6318,8 @@
6266
6318
  "name": "bitwise_not",
6267
6319
  "fl": "fl.bitwise_not",
6268
6320
  "typed": true,
6269
- "result": "bool",
6270
- "group": "comparison",
6321
+ "result": "int",
6322
+ "group": "math",
6271
6323
  "description": "Returns the existing value with its bits flipped"
6272
6324
  },
6273
6325
  {
@@ -6806,7 +6858,7 @@
6806
6858
  ],
6807
6859
  "result": "text",
6808
6860
  "group": "timestamp",
6809
- "description": "Converts a timestamp into a human readable formatted date based on"
6861
+ "description": "Converts a timestamp into a human readable formatted date based on the supplied format"
6810
6862
  },
6811
6863
  {
6812
6864
  "name": "epochms_from_format",
@@ -6842,9 +6894,9 @@
6842
6894
  "optional": true
6843
6895
  }
6844
6896
  ],
6845
- "result": "text",
6897
+ "result": "int",
6846
6898
  "group": "timestamp",
6847
- "description": "Takes a timestamp and applies a relative transformation to it. Ex."
6899
+ "description": "Takes a timestamp and applies a relative transformation to it. Ex. -7 days, last Monday, first day of this month"
6848
6900
  },
6849
6901
  {
6850
6902
  "name": "eq",
@@ -6866,7 +6918,7 @@
6866
6918
  "typed": true,
6867
6919
  "result": "text",
6868
6920
  "group": "text",
6869
- "description": "Converts special characters into their escaped variants. Ex: for tabs and"
6921
+ "description": "JSON-string escaping, NOT HTML escaping: control characters become backslash sequences (newline as \\n, tab as \\t), and \" and / are backslash-escaped. <, >, & and ' pass through unchanged, so the result is not HTML-safe. Deprecated upstream in favor of text_escape."
6870
6922
  },
6871
6923
  {
6872
6924
  "name": "even",
@@ -6891,7 +6943,7 @@
6891
6943
  "optional": true
6892
6944
  }
6893
6945
  ],
6894
- "result": "any[]",
6946
+ "result": "bool",
6895
6947
  "group": "array",
6896
6948
  "description": "Checks if all elements in the array pass the test implemented by the provided function."
6897
6949
  },
@@ -6935,7 +6987,7 @@
6935
6987
  ],
6936
6988
  "result": "<T>[]",
6937
6989
  "group": "array",
6938
- "description": "Returns a new array with only entries that are not empty (\"\", null, 0, \"0\", false, [], {})"
6990
+ "description": "Returns a new array with only entries that are not empty (\"\", null, 0, \"0\", false, [], {}) The only one of the filter_* family that removes all of these; filter_empty_text, filter_null, filter_zero, filter_false, filter_empty_array and filter_empty_object each remove exactly one value, compared strictly."
6939
6991
  },
6940
6992
  {
6941
6993
  "name": "filter_empty_array",
@@ -6980,7 +7032,7 @@
6980
7032
  ],
6981
7033
  "result": "<T>[]",
6982
7034
  "group": "array",
6983
- "description": "Returns a new array with only entries that are not empty (\"\", null, 0, \"0\", false, [], {})"
7035
+ "description": "Returns a new array without the empty-text entries: removes only \"\" (strict). null, 0, \"0\", false, [] and {} are kept; filter_empty removes all of them."
6984
7036
  },
6985
7037
  {
6986
7038
  "name": "filter_false",
@@ -7025,7 +7077,7 @@
7025
7077
  ],
7026
7078
  "result": "<T>[]",
7027
7079
  "group": "array",
7028
- "description": "Returns a new array with only entries that are not zero"
7080
+ "description": "Returns a new array with only entries that are not zero Strict: removes only the integer 0, not \"0\" or 0.0."
7029
7081
  },
7030
7082
  {
7031
7083
  "name": "find",
@@ -7042,7 +7094,7 @@
7042
7094
  "optional": true
7043
7095
  }
7044
7096
  ],
7045
- "result": "any[]",
7097
+ "result": "<T>",
7046
7098
  "group": "array",
7047
7099
  "description": "Finds if all elements in the array pass the test implemented by the provided function."
7048
7100
  },
@@ -7061,7 +7113,7 @@
7061
7113
  "optional": true
7062
7114
  }
7063
7115
  ],
7064
- "result": "any[]",
7116
+ "result": "int",
7065
7117
  "group": "array",
7066
7118
  "description": "Finds the index of the first element in the array that passes the test implemented by the provided function."
7067
7119
  },
@@ -7202,7 +7254,7 @@
7202
7254
  ],
7203
7255
  "result": "bool",
7204
7256
  "group": "comparison",
7205
- "description": "Returns a boolean if the left value is greater than or equal to the"
7257
+ "description": "Returns a boolean if the left value is greater than or equal to the right value"
7206
7258
  },
7207
7259
  {
7208
7260
  "name": "has",
@@ -7751,9 +7803,9 @@
7751
7803
  "name": "null",
7752
7804
  "fl": "fl.null",
7753
7805
  "typed": true,
7754
- "result": "null",
7755
- "group": "misc",
7756
- "description": "Returns a null value."
7806
+ "result": "bool",
7807
+ "group": "comparison",
7808
+ "description": "Returns whether or not the value is null (is_null). Does not produce a null: use c.null() for that."
7757
7809
  },
7758
7810
  {
7759
7811
  "name": "num_max",
@@ -7916,7 +7968,7 @@
7916
7968
  "args": [
7917
7969
  {
7918
7970
  "name": "initial_value",
7919
- "type": "int"
7971
+ "type": "any"
7920
7972
  },
7921
7973
  {
7922
7974
  "name": "code",
@@ -7928,7 +7980,7 @@
7928
7980
  "optional": true
7929
7981
  }
7930
7982
  ],
7931
- "result": "any[]",
7983
+ "result": "any",
7932
7984
  "group": "array",
7933
7985
  "description": "Reduces the array to a single value using the code block to combine each element of the array."
7934
7986
  },
@@ -7944,7 +7996,7 @@
7944
7996
  ],
7945
7997
  "result": "text[]",
7946
7998
  "group": "text",
7947
- "description": "Return the first set of matches performed by a regular expression Direction: the piped value is the regex PATTERN; the `subject` argument is the text tested against it — reversed vs starts_with/contains. Build the pattern with c.regex(...) (delimiter-wrapped); a bare c.text(...) is rejected."
7999
+ "description": "Return the first set of matches performed by a regular expression on the supplied subject text. Direction: the piped value is the regex PATTERN; the `subject` argument is the text tested against it — reversed vs starts_with/contains. Build the pattern with c.regex(...) (delimiter-wrapped); a bare c.text(...) is rejected."
7948
8000
  },
7949
8001
  {
7950
8002
  "name": "regex_match_all",
@@ -7958,7 +8010,7 @@
7958
8010
  ],
7959
8011
  "result": "text[]",
7960
8012
  "group": "text",
7961
- "description": "Return all matches performed by a regular expression on the Direction: the piped value is the regex PATTERN; the `subject` argument is the text tested against it — reversed vs starts_with/contains. Build the pattern with c.regex(...) (delimiter-wrapped); a bare c.text(...) is rejected."
8013
+ "description": "Return all matches performed by a regular expression on the supplied subject text. Direction: the piped value is the regex PATTERN; the `subject` argument is the text tested against it — reversed vs starts_with/contains. Build the pattern with c.regex(...) (delimiter-wrapped); a bare c.text(...) is rejected."
7962
8014
  },
7963
8015
  {
7964
8016
  "name": "regex_quote",
@@ -8256,7 +8308,7 @@
8256
8308
  "optional": true
8257
8309
  }
8258
8310
  ],
8259
- "result": "any[]",
8311
+ "result": "bool",
8260
8312
  "group": "array",
8261
8313
  "description": "Checks if at least one element in the array passes the test implemented by the provided function."
8262
8314
  },
@@ -8402,9 +8454,9 @@
8402
8454
  "type": "text"
8403
8455
  }
8404
8456
  ],
8405
- "result": "int",
8457
+ "result": "int|false",
8406
8458
  "group": "text",
8407
- "description": "Returns the index of the case-insensitive expression or false if it"
8459
+ "description": "Returns the index of the case-insensitive expression or false if it can't be found"
8408
8460
  },
8409
8461
  {
8410
8462
  "name": "strlen",
@@ -8424,9 +8476,9 @@
8424
8476
  "type": "text"
8425
8477
  }
8426
8478
  ],
8427
- "result": "int",
8479
+ "result": "int|false",
8428
8480
  "group": "text",
8429
- "description": "Returns the index of the case-sensitive expression or false if it"
8481
+ "description": "Returns the index of the case-sensitive expression or false if it can't be found"
8430
8482
  },
8431
8483
  {
8432
8484
  "name": "sub",
@@ -8521,7 +8573,7 @@
8521
8573
  ],
8522
8574
  "result": "int",
8523
8575
  "group": "transform",
8524
- "description": "Converts a text expression (now, next friday, Jan 1 2000) to the"
8576
+ "description": "Converts a text expression (now, next friday, Jan 1 2000) to the number of days since the unix epoch."
8525
8577
  },
8526
8578
  {
8527
8579
  "name": "to_epoch_hour",
@@ -8536,7 +8588,7 @@
8536
8588
  ],
8537
8589
  "result": "int",
8538
8590
  "group": "transform",
8539
- "description": "Converts a text expression (now, next friday, Jan 1 2000) to the"
8591
+ "description": "Converts a text expression (now, next friday, Jan 1 2000) to the number of hours since the unix epoch."
8540
8592
  },
8541
8593
  {
8542
8594
  "name": "to_epoch_minute",
@@ -8551,7 +8603,7 @@
8551
8603
  ],
8552
8604
  "result": "int",
8553
8605
  "group": "transform",
8554
- "description": "Converts a text expression (now, next friday, Jan 1 2000) to the"
8606
+ "description": "Converts a text expression (now, next friday, Jan 1 2000) to the number of minutes since the unix epoch."
8555
8607
  },
8556
8608
  {
8557
8609
  "name": "to_epoch_ms",
@@ -8566,7 +8618,7 @@
8566
8618
  ],
8567
8619
  "result": "int",
8568
8620
  "group": "transform",
8569
- "description": "Converts a text expression (now, next friday, Jan 1 2000) to the"
8621
+ "description": "Converts a text expression (now, next friday, Jan 1 2000) to the number of milliseconds since the unix epoch."
8570
8622
  },
8571
8623
  {
8572
8624
  "name": "to_epoch_sec",
@@ -8581,7 +8633,7 @@
8581
8633
  ],
8582
8634
  "result": "int",
8583
8635
  "group": "transform",
8584
- "description": "Converts a text expression (now, next friday, Jan 1 2000) to the"
8636
+ "description": "Converts a text expression (now, next friday, Jan 1 2000) to the number of seconds since the unix epoch."
8585
8637
  },
8586
8638
  {
8587
8639
  "name": "to_epochms",
@@ -8596,7 +8648,7 @@
8596
8648
  ],
8597
8649
  "result": "epochms",
8598
8650
  "group": "transform",
8599
- "description": "Converts a text expression (now, next friday, Jan 1 2000) to"
8651
+ "description": "Converts a text expression (now, next friday, Jan 1 2000) to timestamp comparible format."
8600
8652
  },
8601
8653
  {
8602
8654
  "name": "to_expr",
@@ -8864,7 +8916,7 @@
8864
8916
  "type": "text"
8865
8917
  }
8866
8918
  ],
8867
- "result": "text",
8919
+ "result": "bool",
8868
8920
  "group": "text",
8869
8921
  "description": "Returns the existence of a argument in the URL"
8870
8922
  },