@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/manifest.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "xanosdk",
3
- "version": "1.0.14",
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
  },
@@ -766,14 +766,12 @@
766
766
  {
767
767
  "name": "expr",
768
768
  "type": "value",
769
- "optional": true,
770
- "default": "null"
769
+ "optional": false
771
770
  },
772
771
  {
773
772
  "name": "value",
774
773
  "type": "value",
775
- "optional": true,
776
- "default": "[]"
774
+ "optional": false
777
775
  },
778
776
  {
779
777
  "name": "by",
@@ -794,8 +792,7 @@
794
792
  {
795
793
  "name": "expr",
796
794
  "type": "value",
797
- "optional": true,
798
- "default": "null"
795
+ "optional": false
799
796
  },
800
797
  {
801
798
  "name": "as",
@@ -806,8 +803,7 @@
806
803
  {
807
804
  "name": "if",
808
805
  "type": "comparison",
809
- "optional": true,
810
- "default": "null"
806
+ "optional": false
811
807
  }
812
808
  ],
813
809
  "result": {
@@ -826,8 +822,7 @@
826
822
  {
827
823
  "name": "expr",
828
824
  "type": "value",
829
- "optional": true,
830
- "default": "null"
825
+ "optional": false
831
826
  },
832
827
  {
833
828
  "name": "as",
@@ -838,8 +833,7 @@
838
833
  {
839
834
  "name": "if",
840
835
  "type": "comparison",
841
- "optional": true,
842
- "default": "null"
836
+ "optional": false
843
837
  }
844
838
  ]
845
839
  },
@@ -854,8 +848,7 @@
854
848
  {
855
849
  "name": "expr",
856
850
  "type": "value",
857
- "optional": true,
858
- "default": "null"
851
+ "optional": false
859
852
  },
860
853
  {
861
854
  "name": "as",
@@ -866,8 +859,7 @@
866
859
  {
867
860
  "name": "if",
868
861
  "type": "comparison",
869
- "optional": true,
870
- "default": "null"
862
+ "optional": false
871
863
  }
872
864
  ]
873
865
  },
@@ -882,8 +874,7 @@
882
874
  {
883
875
  "name": "expr",
884
876
  "type": "value",
885
- "optional": true,
886
- "default": "null"
877
+ "optional": false
887
878
  },
888
879
  {
889
880
  "name": "as",
@@ -894,8 +885,7 @@
894
885
  {
895
886
  "name": "if",
896
887
  "type": "comparison",
897
- "optional": true,
898
- "default": "null"
888
+ "optional": false
899
889
  }
900
890
  ]
901
891
  },
@@ -910,8 +900,7 @@
910
900
  {
911
901
  "name": "expr",
912
902
  "type": "value",
913
- "optional": true,
914
- "default": "null"
903
+ "optional": false
915
904
  },
916
905
  {
917
906
  "name": "as",
@@ -922,8 +911,7 @@
922
911
  {
923
912
  "name": "if",
924
913
  "type": "comparison",
925
- "optional": true,
926
- "default": "null"
914
+ "optional": false
927
915
  }
928
916
  ]
929
917
  },
@@ -944,8 +932,7 @@
944
932
  {
945
933
  "name": "expr",
946
934
  "type": "value",
947
- "optional": true,
948
- "default": "null"
935
+ "optional": false
949
936
  },
950
937
  {
951
938
  "name": "by",
@@ -966,8 +953,7 @@
966
953
  {
967
954
  "name": "expr",
968
955
  "type": "value",
969
- "optional": true,
970
- "default": "null"
956
+ "optional": false
971
957
  },
972
958
  {
973
959
  "name": "as",
@@ -978,8 +964,7 @@
978
964
  {
979
965
  "name": "if",
980
966
  "type": "comparison",
981
- "optional": true,
982
- "default": "null"
967
+ "optional": false
983
968
  }
984
969
  ]
985
970
  },
@@ -1000,14 +985,12 @@
1000
985
  {
1001
986
  "name": "expr",
1002
987
  "type": "value",
1003
- "optional": true,
1004
- "default": "null"
988
+ "optional": false
1005
989
  },
1006
990
  {
1007
991
  "name": "value",
1008
992
  "type": "value",
1009
- "optional": true,
1010
- "default": "[]"
993
+ "optional": false
1011
994
  },
1012
995
  {
1013
996
  "name": "by",
@@ -1034,13 +1017,12 @@
1034
1017
  {
1035
1018
  "name": "name",
1036
1019
  "type": "string",
1037
- "optional": true,
1038
- "default": ""
1020
+ "optional": false
1039
1021
  },
1040
1022
  {
1041
1023
  "name": "value",
1042
1024
  "type": "value",
1043
- "optional": true
1025
+ "optional": false
1044
1026
  }
1045
1027
  ]
1046
1028
  },
@@ -1055,8 +1037,7 @@
1055
1037
  {
1056
1038
  "name": "expr",
1057
1039
  "type": "value",
1058
- "optional": true,
1059
- "default": "null"
1040
+ "optional": false
1060
1041
  },
1061
1042
  {
1062
1043
  "name": "as",
@@ -1067,8 +1048,7 @@
1067
1048
  {
1068
1049
  "name": "if",
1069
1050
  "type": "comparison",
1070
- "optional": true,
1071
- "default": "null"
1051
+ "optional": false
1072
1052
  }
1073
1053
  ]
1074
1054
  },
@@ -1083,8 +1063,7 @@
1083
1063
  {
1084
1064
  "name": "name",
1085
1065
  "type": "string",
1086
- "optional": true,
1087
- "default": ""
1066
+ "optional": false
1088
1067
  },
1089
1068
  {
1090
1069
  "name": "as",
@@ -1105,8 +1084,7 @@
1105
1084
  {
1106
1085
  "name": "name",
1107
1086
  "type": "string",
1108
- "optional": true,
1109
- "default": ""
1087
+ "optional": false
1110
1088
  },
1111
1089
  {
1112
1090
  "name": "value",
@@ -1126,8 +1104,7 @@
1126
1104
  {
1127
1105
  "name": "name",
1128
1106
  "type": "string",
1129
- "optional": true,
1130
- "default": ""
1107
+ "optional": false
1131
1108
  },
1132
1109
  {
1133
1110
  "name": "as",
@@ -1155,8 +1132,7 @@
1155
1132
  {
1156
1133
  "name": "name",
1157
1134
  "type": "string",
1158
- "optional": true,
1159
- "default": ""
1135
+ "optional": false
1160
1136
  },
1161
1137
  {
1162
1138
  "name": "value",
@@ -1190,6 +1166,11 @@
1190
1166
  "type": "value",
1191
1167
  "optional": true,
1192
1168
  "default": "10"
1169
+ },
1170
+ {
1171
+ "name": "terminate",
1172
+ "type": "value",
1173
+ "optional": true
1193
1174
  }
1194
1175
  ]
1195
1176
  },
@@ -2954,19 +2935,14 @@
2954
2935
  {
2955
2936
  "name": "name",
2956
2937
  "type": "string",
2957
- "optional": true,
2958
- "default": ""
2938
+ "optional": false
2959
2939
  },
2960
2940
  {
2961
2941
  "name": "value",
2962
2942
  "type": "value",
2963
2943
  "optional": false
2964
2944
  }
2965
- ],
2966
- "result": {
2967
- "name": "as",
2968
- "type": "number"
2969
- }
2945
+ ]
2970
2946
  },
2971
2947
  {
2972
2948
  "surface": "math.bitwise.and",
@@ -2979,19 +2955,14 @@
2979
2955
  {
2980
2956
  "name": "name",
2981
2957
  "type": "string",
2982
- "optional": true,
2983
- "default": ""
2958
+ "optional": false
2984
2959
  },
2985
2960
  {
2986
2961
  "name": "value",
2987
2962
  "type": "value",
2988
2963
  "optional": false
2989
2964
  }
2990
- ],
2991
- "result": {
2992
- "name": "as",
2993
- "type": "number"
2994
- }
2965
+ ]
2995
2966
  },
2996
2967
  {
2997
2968
  "surface": "math.bitwise.or",
@@ -3004,19 +2975,14 @@
3004
2975
  {
3005
2976
  "name": "name",
3006
2977
  "type": "string",
3007
- "optional": true,
3008
- "default": ""
2978
+ "optional": false
3009
2979
  },
3010
2980
  {
3011
2981
  "name": "value",
3012
2982
  "type": "value",
3013
2983
  "optional": false
3014
2984
  }
3015
- ],
3016
- "result": {
3017
- "name": "as",
3018
- "type": "number"
3019
- }
2985
+ ]
3020
2986
  },
3021
2987
  {
3022
2988
  "surface": "math.bitwise.xor",
@@ -3029,19 +2995,14 @@
3029
2995
  {
3030
2996
  "name": "name",
3031
2997
  "type": "string",
3032
- "optional": true,
3033
- "default": ""
2998
+ "optional": false
3034
2999
  },
3035
3000
  {
3036
3001
  "name": "value",
3037
3002
  "type": "value",
3038
3003
  "optional": false
3039
3004
  }
3040
- ],
3041
- "result": {
3042
- "name": "as",
3043
- "type": "number"
3044
- }
3005
+ ]
3045
3006
  },
3046
3007
  {
3047
3008
  "surface": "math.div",
@@ -3054,8 +3015,7 @@
3054
3015
  {
3055
3016
  "name": "name",
3056
3017
  "type": "string",
3057
- "optional": true,
3058
- "default": ""
3018
+ "optional": false
3059
3019
  },
3060
3020
  {
3061
3021
  "name": "value",
@@ -3075,8 +3035,7 @@
3075
3035
  {
3076
3036
  "name": "name",
3077
3037
  "type": "string",
3078
- "optional": true,
3079
- "default": ""
3038
+ "optional": false
3080
3039
  },
3081
3040
  {
3082
3041
  "name": "value",
@@ -3096,8 +3055,7 @@
3096
3055
  {
3097
3056
  "name": "name",
3098
3057
  "type": "string",
3099
- "optional": true,
3100
- "default": ""
3058
+ "optional": false
3101
3059
  },
3102
3060
  {
3103
3061
  "name": "value",
@@ -3117,8 +3075,7 @@
3117
3075
  {
3118
3076
  "name": "name",
3119
3077
  "type": "string",
3120
- "optional": true,
3121
- "default": ""
3078
+ "optional": false
3122
3079
  },
3123
3080
  {
3124
3081
  "name": "value",
@@ -3282,13 +3239,13 @@
3282
3239
  {
3283
3240
  "name": "value",
3284
3241
  "type": "value",
3285
- "optional": true,
3286
- "default": ""
3242
+ "optional": false
3287
3243
  }
3288
3244
  ],
3289
3245
  "result": {
3290
3246
  "name": "as",
3291
- "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"
3292
3249
  }
3293
3250
  },
3294
3251
  {
@@ -3307,13 +3264,13 @@
3307
3264
  {
3308
3265
  "name": "value",
3309
3266
  "type": "value",
3310
- "optional": true,
3311
- "default": ""
3267
+ "optional": false
3312
3268
  }
3313
3269
  ],
3314
3270
  "result": {
3315
3271
  "name": "as",
3316
- "type": "string[]"
3272
+ "type": "(string | number)[]",
3273
+ "note": "an integer-like key comes back as a NUMBER (PHP coerces it), not a string"
3317
3274
  }
3318
3275
  },
3319
3276
  {
@@ -3332,8 +3289,7 @@
3332
3289
  {
3333
3290
  "name": "value",
3334
3291
  "type": "value",
3335
- "optional": true,
3336
- "default": ""
3292
+ "optional": false
3337
3293
  }
3338
3294
  ],
3339
3295
  "result": {
@@ -3352,8 +3308,7 @@
3352
3308
  {
3353
3309
  "name": "expr",
3354
3310
  "type": "comparison",
3355
- "optional": true,
3356
- "default": "null"
3311
+ "optional": false
3357
3312
  },
3358
3313
  {
3359
3314
  "name": "error_type",
@@ -3406,6 +3361,13 @@
3406
3361
  "registered": true,
3407
3362
  "declarative": false
3408
3363
  },
3364
+ {
3365
+ "surface": "realtime.kick",
3366
+ "storedName": "mvp:realtime_kick",
3367
+ "sPath": "realtime.kick",
3368
+ "registered": true,
3369
+ "declarative": false
3370
+ },
3409
3371
  {
3410
3372
  "surface": "redis.count",
3411
3373
  "storedName": "mvp:redis_countlist",
@@ -3825,7 +3787,7 @@
3825
3787
  "result": {
3826
3788
  "name": "as",
3827
3789
  "type": "boolean",
3828
- "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.)"
3829
3791
  }
3830
3792
  },
3831
3793
  {
@@ -4028,7 +3990,12 @@
4028
3990
  "type": "value",
4029
3991
  "optional": false
4030
3992
  }
4031
- ]
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
+ }
4032
3999
  },
4033
4000
  {
4034
4001
  "surface": "security.encrypt",
@@ -4135,7 +4102,12 @@
4135
4102
  "type": "value",
4136
4103
  "optional": true
4137
4104
  }
4138
- ]
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
+ }
4139
4111
  },
4140
4112
  {
4141
4113
  "surface": "security.jwe_encode",
@@ -4253,7 +4225,12 @@
4253
4225
  "type": "value",
4254
4226
  "optional": true
4255
4227
  }
4256
- ]
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
+ }
4257
4234
  },
4258
4235
  {
4259
4236
  "surface": "security.jws_encode",
@@ -4327,7 +4304,12 @@
4327
4304
  "type": "value",
4328
4305
  "optional": true
4329
4306
  }
4330
- ]
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
+ }
4331
4313
  },
4332
4314
  {
4333
4315
  "surface": "security.random_number",
@@ -4365,8 +4347,7 @@
4365
4347
  {
4366
4348
  "name": "expr",
4367
4349
  "type": "value",
4368
- "optional": true,
4369
- "default": ""
4350
+ "optional": false
4370
4351
  }
4371
4352
  ]
4372
4353
  },
@@ -4381,8 +4362,7 @@
4381
4362
  {
4382
4363
  "name": "expr",
4383
4364
  "type": "value",
4384
- "optional": true,
4385
- "default": ""
4365
+ "optional": false
4386
4366
  }
4387
4367
  ]
4388
4368
  },
@@ -4397,8 +4377,7 @@
4397
4377
  {
4398
4378
  "name": "expr",
4399
4379
  "type": "value",
4400
- "optional": true,
4401
- "default": ""
4380
+ "optional": false
4402
4381
  }
4403
4382
  ]
4404
4383
  },
@@ -4413,14 +4392,12 @@
4413
4392
  {
4414
4393
  "name": "expr",
4415
4394
  "type": "value",
4416
- "optional": true,
4417
- "default": ""
4395
+ "optional": false
4418
4396
  },
4419
4397
  {
4420
4398
  "name": "value",
4421
4399
  "type": "value",
4422
- "optional": true,
4423
- "default": ""
4400
+ "optional": false
4424
4401
  }
4425
4402
  ]
4426
4403
  },
@@ -4435,8 +4412,7 @@
4435
4412
  {
4436
4413
  "name": "expr",
4437
4414
  "type": "value",
4438
- "optional": true,
4439
- "default": ""
4415
+ "optional": false
4440
4416
  }
4441
4417
  ]
4442
4418
  },
@@ -4451,8 +4427,7 @@
4451
4427
  {
4452
4428
  "name": "expr",
4453
4429
  "type": "value",
4454
- "optional": true,
4455
- "default": ""
4430
+ "optional": false
4456
4431
  }
4457
4432
  ]
4458
4433
  },
@@ -4467,14 +4442,12 @@
4467
4442
  {
4468
4443
  "name": "expr",
4469
4444
  "type": "value",
4470
- "optional": true,
4471
- "default": ""
4445
+ "optional": false
4472
4446
  },
4473
4447
  {
4474
4448
  "name": "value",
4475
4449
  "type": "value",
4476
- "optional": true,
4477
- "default": ""
4450
+ "optional": false
4478
4451
  }
4479
4452
  ]
4480
4453
  },
@@ -4489,8 +4462,7 @@
4489
4462
  {
4490
4463
  "name": "expr",
4491
4464
  "type": "value",
4492
- "optional": true,
4493
- "default": ""
4465
+ "optional": false
4494
4466
  }
4495
4467
  ]
4496
4468
  },
@@ -4505,8 +4477,7 @@
4505
4477
  {
4506
4478
  "name": "expr",
4507
4479
  "type": "value",
4508
- "optional": true,
4509
- "default": ""
4480
+ "optional": false
4510
4481
  }
4511
4482
  ]
4512
4483
  },
@@ -4521,20 +4492,17 @@
4521
4492
  {
4522
4493
  "name": "expr",
4523
4494
  "type": "value",
4524
- "optional": true,
4525
- "default": ""
4495
+ "optional": false
4526
4496
  },
4527
4497
  {
4528
4498
  "name": "min",
4529
4499
  "type": "value",
4530
- "optional": true,
4531
- "default": ""
4500
+ "optional": false
4532
4501
  },
4533
4502
  {
4534
4503
  "name": "max",
4535
4504
  "type": "value",
4536
- "optional": true,
4537
- "default": ""
4505
+ "optional": false
4538
4506
  }
4539
4507
  ]
4540
4508
  },
@@ -4549,14 +4517,12 @@
4549
4517
  {
4550
4518
  "name": "expr",
4551
4519
  "type": "value",
4552
- "optional": true,
4553
- "default": ""
4520
+ "optional": false
4554
4521
  },
4555
4522
  {
4556
4523
  "name": "value",
4557
4524
  "type": "value",
4558
- "optional": true,
4559
- "default": ""
4525
+ "optional": false
4560
4526
  }
4561
4527
  ]
4562
4528
  },
@@ -4571,14 +4537,12 @@
4571
4537
  {
4572
4538
  "name": "expr",
4573
4539
  "type": "value",
4574
- "optional": true,
4575
- "default": ""
4540
+ "optional": false
4576
4541
  },
4577
4542
  {
4578
4543
  "name": "value",
4579
4544
  "type": "value",
4580
- "optional": true,
4581
- "default": ""
4545
+ "optional": false
4582
4546
  }
4583
4547
  ]
4584
4548
  },
@@ -4593,14 +4557,12 @@
4593
4557
  {
4594
4558
  "name": "expr",
4595
4559
  "type": "value",
4596
- "optional": true,
4597
- "default": ""
4560
+ "optional": false
4598
4561
  },
4599
4562
  {
4600
4563
  "name": "value",
4601
4564
  "type": "value",
4602
- "optional": true,
4603
- "default": ""
4565
+ "optional": false
4604
4566
  }
4605
4567
  ]
4606
4568
  },
@@ -4615,14 +4577,12 @@
4615
4577
  {
4616
4578
  "name": "expr",
4617
4579
  "type": "value",
4618
- "optional": true,
4619
- "default": ""
4580
+ "optional": false
4620
4581
  },
4621
4582
  {
4622
4583
  "name": "value",
4623
4584
  "type": "value",
4624
- "optional": true,
4625
- "default": ""
4585
+ "optional": false
4626
4586
  }
4627
4587
  ]
4628
4588
  },
@@ -4637,8 +4597,7 @@
4637
4597
  {
4638
4598
  "name": "expr",
4639
4599
  "type": "value",
4640
- "optional": true,
4641
- "default": ""
4600
+ "optional": false
4642
4601
  }
4643
4602
  ]
4644
4603
  },
@@ -4653,8 +4612,7 @@
4653
4612
  {
4654
4613
  "name": "expr",
4655
4614
  "type": "value",
4656
- "optional": true,
4657
- "default": ""
4615
+ "optional": false
4658
4616
  }
4659
4617
  ]
4660
4618
  },
@@ -4669,14 +4627,12 @@
4669
4627
  {
4670
4628
  "name": "expr",
4671
4629
  "type": "value",
4672
- "optional": true,
4673
- "default": ""
4630
+ "optional": false
4674
4631
  },
4675
4632
  {
4676
4633
  "name": "value",
4677
4634
  "type": "value",
4678
- "optional": true,
4679
- "default": ""
4635
+ "optional": false
4680
4636
  }
4681
4637
  ]
4682
4638
  },
@@ -4691,14 +4647,12 @@
4691
4647
  {
4692
4648
  "name": "expr",
4693
4649
  "type": "value",
4694
- "optional": true,
4695
- "default": ""
4650
+ "optional": false
4696
4651
  },
4697
4652
  {
4698
4653
  "name": "value",
4699
4654
  "type": "value",
4700
- "optional": true,
4701
- "default": ""
4655
+ "optional": false
4702
4656
  }
4703
4657
  ]
4704
4658
  },
@@ -4752,7 +4706,12 @@
4752
4706
  "type": "value",
4753
4707
  "optional": true
4754
4708
  }
4755
- ]
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
+ }
4756
4715
  },
4757
4716
  {
4758
4717
  "surface": "storage.create_audio",
@@ -5039,8 +4998,7 @@
5039
4998
  {
5040
4999
  "name": "name",
5041
5000
  "type": "string",
5042
- "optional": true,
5043
- "default": ""
5001
+ "optional": false
5044
5002
  },
5045
5003
  {
5046
5004
  "name": "value",
@@ -5060,8 +5018,7 @@
5060
5018
  {
5061
5019
  "name": "name",
5062
5020
  "type": "string",
5063
- "optional": true,
5064
- "default": ""
5021
+ "optional": false
5065
5022
  },
5066
5023
  {
5067
5024
  "name": "as",
@@ -5073,7 +5030,11 @@
5073
5030
  "type": "value",
5074
5031
  "optional": false
5075
5032
  }
5076
- ]
5033
+ ],
5034
+ "result": {
5035
+ "name": "as",
5036
+ "type": "boolean"
5037
+ }
5077
5038
  },
5078
5039
  {
5079
5040
  "surface": "text.ends_with",
@@ -5086,8 +5047,7 @@
5086
5047
  {
5087
5048
  "name": "name",
5088
5049
  "type": "string",
5089
- "optional": true,
5090
- "default": ""
5050
+ "optional": false
5091
5051
  },
5092
5052
  {
5093
5053
  "name": "as",
@@ -5099,7 +5059,11 @@
5099
5059
  "type": "value",
5100
5060
  "optional": false
5101
5061
  }
5102
- ]
5062
+ ],
5063
+ "result": {
5064
+ "name": "as",
5065
+ "type": "boolean"
5066
+ }
5103
5067
  },
5104
5068
  {
5105
5069
  "surface": "text.icontains",
@@ -5112,8 +5076,7 @@
5112
5076
  {
5113
5077
  "name": "name",
5114
5078
  "type": "string",
5115
- "optional": true,
5116
- "default": ""
5079
+ "optional": false
5117
5080
  },
5118
5081
  {
5119
5082
  "name": "as",
@@ -5125,7 +5088,11 @@
5125
5088
  "type": "value",
5126
5089
  "optional": false
5127
5090
  }
5128
- ]
5091
+ ],
5092
+ "result": {
5093
+ "name": "as",
5094
+ "type": "boolean"
5095
+ }
5129
5096
  },
5130
5097
  {
5131
5098
  "surface": "text.iends_with",
@@ -5138,8 +5105,7 @@
5138
5105
  {
5139
5106
  "name": "name",
5140
5107
  "type": "string",
5141
- "optional": true,
5142
- "default": ""
5108
+ "optional": false
5143
5109
  },
5144
5110
  {
5145
5111
  "name": "as",
@@ -5151,7 +5117,11 @@
5151
5117
  "type": "value",
5152
5118
  "optional": false
5153
5119
  }
5154
- ]
5120
+ ],
5121
+ "result": {
5122
+ "name": "as",
5123
+ "type": "boolean"
5124
+ }
5155
5125
  },
5156
5126
  {
5157
5127
  "surface": "text.istarts_with",
@@ -5164,8 +5134,7 @@
5164
5134
  {
5165
5135
  "name": "name",
5166
5136
  "type": "string",
5167
- "optional": true,
5168
- "default": ""
5137
+ "optional": false
5169
5138
  },
5170
5139
  {
5171
5140
  "name": "as",
@@ -5177,7 +5146,11 @@
5177
5146
  "type": "value",
5178
5147
  "optional": false
5179
5148
  }
5180
- ]
5149
+ ],
5150
+ "result": {
5151
+ "name": "as",
5152
+ "type": "boolean"
5153
+ }
5181
5154
  },
5182
5155
  {
5183
5156
  "surface": "text.ltrim",
@@ -5190,8 +5163,7 @@
5190
5163
  {
5191
5164
  "name": "name",
5192
5165
  "type": "string",
5193
- "optional": true,
5194
- "default": ""
5166
+ "optional": false
5195
5167
  },
5196
5168
  {
5197
5169
  "name": "value",
@@ -5211,8 +5183,7 @@
5211
5183
  {
5212
5184
  "name": "name",
5213
5185
  "type": "string",
5214
- "optional": true,
5215
- "default": ""
5186
+ "optional": false
5216
5187
  },
5217
5188
  {
5218
5189
  "name": "value",
@@ -5232,8 +5203,7 @@
5232
5203
  {
5233
5204
  "name": "name",
5234
5205
  "type": "string",
5235
- "optional": true,
5236
- "default": ""
5206
+ "optional": false
5237
5207
  },
5238
5208
  {
5239
5209
  "name": "value",
@@ -5253,8 +5223,7 @@
5253
5223
  {
5254
5224
  "name": "name",
5255
5225
  "type": "string",
5256
- "optional": true,
5257
- "default": ""
5226
+ "optional": false
5258
5227
  },
5259
5228
  {
5260
5229
  "name": "as",
@@ -5266,7 +5235,11 @@
5266
5235
  "type": "value",
5267
5236
  "optional": false
5268
5237
  }
5269
- ]
5238
+ ],
5239
+ "result": {
5240
+ "name": "as",
5241
+ "type": "boolean"
5242
+ }
5270
5243
  },
5271
5244
  {
5272
5245
  "surface": "text.trim",
@@ -5279,8 +5252,7 @@
5279
5252
  {
5280
5253
  "name": "name",
5281
5254
  "type": "string",
5282
- "optional": true,
5283
- "default": ""
5255
+ "optional": false
5284
5256
  },
5285
5257
  {
5286
5258
  "name": "value",
@@ -5307,6 +5279,11 @@
5307
5279
  "name": "value",
5308
5280
  "type": "value",
5309
5281
  "optional": false
5282
+ },
5283
+ {
5284
+ "name": "status",
5285
+ "type": "number",
5286
+ "optional": true
5310
5287
  }
5311
5288
  ]
5312
5289
  },
@@ -5390,7 +5367,7 @@
5390
5367
  "result": {
5391
5368
  "name": "as",
5392
5369
  "type": "unknown",
5393
- "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"
5394
5371
  }
5395
5372
  },
5396
5373
  {
@@ -5407,7 +5384,12 @@
5407
5384
  "optional": true,
5408
5385
  "default": ""
5409
5386
  }
5410
- ]
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
+ }
5411
5393
  },
5412
5394
  {
5413
5395
  "surface": "util.get_input",
@@ -5863,7 +5845,7 @@
5863
5845
  ],
5864
5846
  "result": "<T>[]",
5865
5847
  "group": "array",
5866
- "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."
5867
5849
  },
5868
5850
  {
5869
5851
  "name": "array_diff_assoc",
@@ -5877,7 +5859,7 @@
5877
5859
  ],
5878
5860
  "result": "<T>[]",
5879
5861
  "group": "array",
5880
- "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."
5881
5863
  },
5882
5864
  {
5883
5865
  "name": "array_entries",
@@ -5885,7 +5867,7 @@
5885
5867
  "typed": true,
5886
5868
  "result": "any[]",
5887
5869
  "group": "array",
5888
- "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."
5889
5871
  },
5890
5872
  {
5891
5873
  "name": "array_fill",
@@ -5978,7 +5960,7 @@
5978
5960
  ],
5979
5961
  "result": "<T>[]",
5980
5962
  "group": "array",
5981
- "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."
5982
5964
  },
5983
5965
  {
5984
5966
  "name": "array_intersect_assoc",
@@ -5992,7 +5974,7 @@
5992
5974
  ],
5993
5975
  "result": "<T>[]",
5994
5976
  "group": "array",
5995
- "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."
5996
5978
  },
5997
5979
  {
5998
5980
  "name": "array_keys",
@@ -6022,7 +6004,7 @@
6022
6004
  ],
6023
6005
  "result": "<T>[]",
6024
6006
  "group": "array",
6025
- "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"
6026
6008
  },
6027
6009
  {
6028
6010
  "name": "array_merge_recursive",
@@ -6036,7 +6018,7 @@
6036
6018
  ],
6037
6019
  "result": "<T>[]",
6038
6020
  "group": "array",
6039
- "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"
6040
6022
  },
6041
6023
  {
6042
6024
  "name": "array_pop",
@@ -6099,7 +6081,7 @@
6099
6081
  ],
6100
6082
  "result": "<T>[]",
6101
6083
  "group": "array",
6102
- "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"
6103
6085
  },
6104
6086
  {
6105
6087
  "name": "array_replace",
@@ -6202,7 +6184,7 @@
6202
6184
  ],
6203
6185
  "result": "<T>[]",
6204
6186
  "group": "array",
6205
- "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."
6206
6188
  },
6207
6189
  {
6208
6190
  "name": "array_values",
@@ -6336,8 +6318,8 @@
6336
6318
  "name": "bitwise_not",
6337
6319
  "fl": "fl.bitwise_not",
6338
6320
  "typed": true,
6339
- "result": "bool",
6340
- "group": "comparison",
6321
+ "result": "int",
6322
+ "group": "math",
6341
6323
  "description": "Returns the existing value with its bits flipped"
6342
6324
  },
6343
6325
  {
@@ -6876,7 +6858,7 @@
6876
6858
  ],
6877
6859
  "result": "text",
6878
6860
  "group": "timestamp",
6879
- "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"
6880
6862
  },
6881
6863
  {
6882
6864
  "name": "epochms_from_format",
@@ -6912,9 +6894,9 @@
6912
6894
  "optional": true
6913
6895
  }
6914
6896
  ],
6915
- "result": "text",
6897
+ "result": "int",
6916
6898
  "group": "timestamp",
6917
- "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"
6918
6900
  },
6919
6901
  {
6920
6902
  "name": "eq",
@@ -6936,7 +6918,7 @@
6936
6918
  "typed": true,
6937
6919
  "result": "text",
6938
6920
  "group": "text",
6939
- "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."
6940
6922
  },
6941
6923
  {
6942
6924
  "name": "even",
@@ -6961,7 +6943,7 @@
6961
6943
  "optional": true
6962
6944
  }
6963
6945
  ],
6964
- "result": "any[]",
6946
+ "result": "bool",
6965
6947
  "group": "array",
6966
6948
  "description": "Checks if all elements in the array pass the test implemented by the provided function."
6967
6949
  },
@@ -7005,7 +6987,7 @@
7005
6987
  ],
7006
6988
  "result": "<T>[]",
7007
6989
  "group": "array",
7008
- "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."
7009
6991
  },
7010
6992
  {
7011
6993
  "name": "filter_empty_array",
@@ -7050,7 +7032,7 @@
7050
7032
  ],
7051
7033
  "result": "<T>[]",
7052
7034
  "group": "array",
7053
- "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."
7054
7036
  },
7055
7037
  {
7056
7038
  "name": "filter_false",
@@ -7095,7 +7077,7 @@
7095
7077
  ],
7096
7078
  "result": "<T>[]",
7097
7079
  "group": "array",
7098
- "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."
7099
7081
  },
7100
7082
  {
7101
7083
  "name": "find",
@@ -7112,7 +7094,7 @@
7112
7094
  "optional": true
7113
7095
  }
7114
7096
  ],
7115
- "result": "any[]",
7097
+ "result": "<T>",
7116
7098
  "group": "array",
7117
7099
  "description": "Finds if all elements in the array pass the test implemented by the provided function."
7118
7100
  },
@@ -7131,7 +7113,7 @@
7131
7113
  "optional": true
7132
7114
  }
7133
7115
  ],
7134
- "result": "any[]",
7116
+ "result": "int",
7135
7117
  "group": "array",
7136
7118
  "description": "Finds the index of the first element in the array that passes the test implemented by the provided function."
7137
7119
  },
@@ -7272,7 +7254,7 @@
7272
7254
  ],
7273
7255
  "result": "bool",
7274
7256
  "group": "comparison",
7275
- "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"
7276
7258
  },
7277
7259
  {
7278
7260
  "name": "has",
@@ -7821,9 +7803,9 @@
7821
7803
  "name": "null",
7822
7804
  "fl": "fl.null",
7823
7805
  "typed": true,
7824
- "result": "null",
7825
- "group": "misc",
7826
- "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."
7827
7809
  },
7828
7810
  {
7829
7811
  "name": "num_max",
@@ -7986,7 +7968,7 @@
7986
7968
  "args": [
7987
7969
  {
7988
7970
  "name": "initial_value",
7989
- "type": "int"
7971
+ "type": "any"
7990
7972
  },
7991
7973
  {
7992
7974
  "name": "code",
@@ -7998,7 +7980,7 @@
7998
7980
  "optional": true
7999
7981
  }
8000
7982
  ],
8001
- "result": "any[]",
7983
+ "result": "any",
8002
7984
  "group": "array",
8003
7985
  "description": "Reduces the array to a single value using the code block to combine each element of the array."
8004
7986
  },
@@ -8014,7 +7996,7 @@
8014
7996
  ],
8015
7997
  "result": "text[]",
8016
7998
  "group": "text",
8017
- "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."
8018
8000
  },
8019
8001
  {
8020
8002
  "name": "regex_match_all",
@@ -8028,7 +8010,7 @@
8028
8010
  ],
8029
8011
  "result": "text[]",
8030
8012
  "group": "text",
8031
- "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."
8032
8014
  },
8033
8015
  {
8034
8016
  "name": "regex_quote",
@@ -8326,7 +8308,7 @@
8326
8308
  "optional": true
8327
8309
  }
8328
8310
  ],
8329
- "result": "any[]",
8311
+ "result": "bool",
8330
8312
  "group": "array",
8331
8313
  "description": "Checks if at least one element in the array passes the test implemented by the provided function."
8332
8314
  },
@@ -8472,9 +8454,9 @@
8472
8454
  "type": "text"
8473
8455
  }
8474
8456
  ],
8475
- "result": "int",
8457
+ "result": "int|false",
8476
8458
  "group": "text",
8477
- "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"
8478
8460
  },
8479
8461
  {
8480
8462
  "name": "strlen",
@@ -8494,9 +8476,9 @@
8494
8476
  "type": "text"
8495
8477
  }
8496
8478
  ],
8497
- "result": "int",
8479
+ "result": "int|false",
8498
8480
  "group": "text",
8499
- "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"
8500
8482
  },
8501
8483
  {
8502
8484
  "name": "sub",
@@ -8591,7 +8573,7 @@
8591
8573
  ],
8592
8574
  "result": "int",
8593
8575
  "group": "transform",
8594
- "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."
8595
8577
  },
8596
8578
  {
8597
8579
  "name": "to_epoch_hour",
@@ -8606,7 +8588,7 @@
8606
8588
  ],
8607
8589
  "result": "int",
8608
8590
  "group": "transform",
8609
- "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."
8610
8592
  },
8611
8593
  {
8612
8594
  "name": "to_epoch_minute",
@@ -8621,7 +8603,7 @@
8621
8603
  ],
8622
8604
  "result": "int",
8623
8605
  "group": "transform",
8624
- "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."
8625
8607
  },
8626
8608
  {
8627
8609
  "name": "to_epoch_ms",
@@ -8636,7 +8618,7 @@
8636
8618
  ],
8637
8619
  "result": "int",
8638
8620
  "group": "transform",
8639
- "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."
8640
8622
  },
8641
8623
  {
8642
8624
  "name": "to_epoch_sec",
@@ -8651,7 +8633,7 @@
8651
8633
  ],
8652
8634
  "result": "int",
8653
8635
  "group": "transform",
8654
- "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."
8655
8637
  },
8656
8638
  {
8657
8639
  "name": "to_epochms",
@@ -8666,7 +8648,7 @@
8666
8648
  ],
8667
8649
  "result": "epochms",
8668
8650
  "group": "transform",
8669
- "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."
8670
8652
  },
8671
8653
  {
8672
8654
  "name": "to_expr",
@@ -8934,7 +8916,7 @@
8934
8916
  "type": "text"
8935
8917
  }
8936
8918
  ],
8937
- "result": "text",
8919
+ "result": "bool",
8938
8920
  "group": "text",
8939
8921
  "description": "Returns the existence of a argument in the URL"
8940
8922
  },