@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.
- package/CHANGELOG.md +14 -0
- package/README.md +33 -37
- package/dist/.build-fingerprint +1 -1
- package/dist/{agent-file-refresh-ZRGNOA6Q.js → agent-file-refresh-DBHTEFYM.js} +12 -12
- package/dist/{agent-skill-command-DV26SDA2.js → agent-skill-command-LHNTU7MH.js} +74 -73
- package/dist/{answer-shape-AVZSKBR6.js → answer-shape-ZRQS7ZC4.js} +5 -5
- package/dist/{backend-dir-NTMXWE5R.js → backend-dir-AXR43HNV.js} +11 -11
- package/dist/{backend-slot-DZAUHLTS.js → backend-slot-7BATLL3X.js} +4 -4
- package/dist/bin.js +64 -63
- package/dist/{branch-IJTBZZFO.js → branch-SJKKUCMZ.js} +9 -9
- package/dist/branch-commands-KGR52SZU.js +80 -0
- package/dist/bundle.d.ts +2 -2
- package/dist/bundle.js +15 -69
- package/dist/{capture-GW5KNKMB.js → capture-RYBJE25P.js} +5 -5
- package/dist/{chunk-66ZU2CD5.js → chunk-23GEFHRX.js} +236 -17
- package/dist/{chunk-3H7R4ISR.js → chunk-2DUYJR5N.js} +2 -2
- package/dist/{chunk-MFWF2NZJ.js → chunk-2H5BQRHF.js} +2 -2
- package/dist/{chunk-O44MJTLR.js → chunk-35SI4GBM.js} +3 -3
- package/dist/{chunk-ZYECXDVV.js → chunk-3ZV23FVR.js} +5 -5
- package/dist/{chunk-N72XNQNJ.js → chunk-47XIVDJ6.js} +14 -14
- package/dist/{chunk-ICK36EGF.js → chunk-4EVDCSEY.js} +2 -2
- package/dist/{chunk-AXMUYBWQ.js → chunk-4XGZ325S.js} +3 -3
- package/dist/{chunk-P7GKTV7N.js → chunk-4XYXUK5H.js} +75 -32
- package/dist/{chunk-AE5CRAKS.js → chunk-4ZBXS7YN.js} +8 -8
- package/dist/{chunk-JWASCOHO.js → chunk-52QAENY6.js} +14 -14
- package/dist/{chunk-2LF734YB.js → chunk-54CJ74BH.js} +4 -4
- package/dist/{chunk-TT6LN55R.js → chunk-57PGTPT3.js} +8 -8
- package/dist/{chunk-IKXXTRMN.js → chunk-64UVVLDT.js} +4 -4
- package/dist/{chunk-EQXHUWUO.js → chunk-6FCAFWD5.js} +2 -2
- package/dist/{chunk-4MX5LMPQ.js → chunk-6ODQ5GDZ.js} +2 -2
- package/dist/{chunk-G4WRZU5T.js → chunk-74YCPI4G.js} +7 -7
- package/dist/{chunk-Y5XAPLZS.js → chunk-7UQZ7C4W.js} +4 -4
- package/dist/{chunk-CJDPSCMX.js → chunk-7ZVQIKNL.js} +3 -3
- package/dist/{chunk-RVAEPPRH.js → chunk-AICWDCLJ.js} +2 -2
- package/dist/{chunk-WS4BA75E.js → chunk-AJBOGO5U.js} +4 -4
- package/dist/{chunk-FOBVJ2UR.js → chunk-AJQFUJEQ.js} +8 -8
- package/dist/{chunk-DH6O5NQU.js → chunk-C7AYP4H6.js} +29 -20
- package/dist/{chunk-SXMZNSQ6.js → chunk-DJMGDCVX.js} +8 -8
- package/dist/{chunk-K6SWZ6H4.js → chunk-DLD4FVRP.js} +54 -54
- package/dist/{chunk-Q7DGTQ5G.js → chunk-E34VGSCI.js} +2 -1
- package/dist/{chunk-YR3MNGWZ.js → chunk-E5M5P23K.js} +8 -8
- package/dist/{chunk-HJZUI2ZU.js → chunk-EAZTRU75.js} +2 -2
- package/dist/{chunk-V7WCTXEH.js → chunk-EINZSVEU.js} +5 -5
- package/dist/{chunk-KMKUH2IO.js → chunk-EPB6FAR5.js} +5 -5
- package/dist/chunk-EUAU4QKI.js +67 -0
- package/dist/{chunk-IDOVZLPK.js → chunk-EXJ4Q5F6.js} +2 -2
- package/dist/{chunk-FKQX6KU7.js → chunk-F3JK5RIY.js} +2 -2
- package/dist/{chunk-W2QFR3ZJ.js → chunk-FIOC7RSU.js} +2 -2
- package/dist/{chunk-YEH5OIPF.js → chunk-FMXPV5JI.js} +39 -11
- package/dist/{chunk-GVHWIDEJ.js → chunk-FRJB3NTE.js} +10 -5
- package/dist/{chunk-VIRFG3WG.js → chunk-FTFAPKCW.js} +23 -7
- package/dist/{chunk-LL6ED5IB.js → chunk-FTS42N37.js} +2 -2
- package/dist/{chunk-MIS6F4HM.js → chunk-G2XSDIYS.js} +4 -4
- package/dist/{chunk-ZY55DO5P.js → chunk-G6BEJ3NA.js} +2 -2
- package/dist/{chunk-RYWNNJK5.js → chunk-GA6HTO3O.js} +2 -2
- package/dist/{chunk-JIKGT7DO.js → chunk-GE3JV5SI.js} +1 -1
- package/dist/{chunk-GCINMMFL.js → chunk-GJZMKMWO.js} +2 -2
- package/dist/{chunk-VXHXSGPU.js → chunk-GRZ62LLU.js} +8 -8
- package/dist/{chunk-6X73VFCX.js → chunk-GT7PZCTK.js} +2 -2
- package/dist/{chunk-SH4RY6QX.js → chunk-HXPQXCOZ.js} +1536 -413
- package/dist/{chunk-ECQXASG3.js → chunk-IFHFJR5O.js} +2 -2
- package/dist/{chunk-7ZQ73AHJ.js → chunk-IOWNQEMW.js} +31 -31
- package/dist/{chunk-YCKKL5PD.js → chunk-ISIZFK5Q.js} +53 -47
- package/dist/{chunk-HCNIB3EC.js → chunk-IUJDUFT7.js} +4 -4
- package/dist/{chunk-74OPNM2Z.js → chunk-JHAZK4RY.js} +3 -3
- package/dist/{chunk-OZWAITII.js → chunk-KGHJ74HF.js} +6 -6
- package/dist/{chunk-XLP4CNSF.js → chunk-L2O5KG5Q.js} +6 -6
- package/dist/{chunk-NNI5R6V6.js → chunk-L3Q2QYIQ.js} +72 -72
- package/dist/{chunk-UNFQN3TT.js → chunk-LLBEPJBO.js} +3 -3
- package/dist/{chunk-VUWR5YLE.js → chunk-LWBGPPI5.js} +13 -13
- package/dist/{chunk-RBTZEHXF.js → chunk-MBSHONP3.js} +3 -3
- package/dist/{chunk-GKQTXUOW.js → chunk-MOVRSULZ.js} +2 -2
- package/dist/{chunk-QAEBBTYR.js → chunk-MSYMEP7Y.js} +7 -7
- package/dist/{chunk-Y453TW6J.js → chunk-NCERS5QH.js} +2 -2
- package/dist/{chunk-HXFLHA5K.js → chunk-NH5Z2NOD.js} +2 -2
- package/dist/{chunk-T3HNISBN.js → chunk-NJVY3GAX.js} +3 -3
- package/dist/{chunk-ZF2CBXT5.js → chunk-NQPPUNWP.js} +3 -3
- package/dist/{chunk-5SKWGCAJ.js → chunk-O7Z3LF44.js} +5 -5
- package/dist/{chunk-ASQX477B.js → chunk-OLXYZQR7.js} +7 -7
- package/dist/{chunk-5SJQAJLF.js → chunk-OQNYZ2OM.js} +3 -3
- package/dist/{chunk-DBDTQR23.js → chunk-OTQF4B37.js} +4 -4
- package/dist/{chunk-GBSHHNSD.js → chunk-PRSNMSVG.js} +3 -3
- package/dist/{chunk-DGYXCIBV.js → chunk-Q6AKSLD2.js} +2 -2
- package/dist/{chunk-WXKSB2N3.js → chunk-Q7KXMIR3.js} +3 -3
- package/dist/{chunk-B6AFJVG4.js → chunk-QCVH32T2.js} +5 -5
- package/dist/{chunk-7FIMUFBP.js → chunk-QDPY7RN3.js} +3 -3
- package/dist/{chunk-MGG4CHO4.js → chunk-QIT2GGNB.js} +3 -3
- package/dist/{chunk-QW7NGUYW.js → chunk-QSJH5AFU.js} +244 -173
- package/dist/{chunk-3GZMP7II.js → chunk-R7DS2TRZ.js} +38 -22
- package/dist/{chunk-BEKEOXNG.js → chunk-RGPHFHJU.js} +2 -2
- package/dist/{chunk-5FJ4M4HB.js → chunk-RHH6SCB4.js} +17 -32
- package/dist/{chunk-M7O3T7IM.js → chunk-RIT3WBBX.js} +4 -4
- package/dist/{chunk-45K2QZBR.js → chunk-RKNCISPM.js} +3 -3
- package/dist/{chunk-NPYYDTXS.js → chunk-RKTVXFBV.js} +5 -5
- package/dist/{chunk-AXNX4NWN.js → chunk-RLQX6LHW.js} +37 -37
- package/dist/{chunk-FIERONKM.js → chunk-ROWYW3JF.js} +2 -2
- package/dist/{chunk-LSJ3SQEU.js → chunk-RVWWNNZQ.js} +4 -4
- package/dist/{chunk-A2N2C2WD.js → chunk-S7MVI4W7.js} +7 -7
- package/dist/{chunk-4MIV244X.js → chunk-SGEOXJIH.js} +9 -2
- package/dist/{chunk-QRMKQYCB.js → chunk-SINL5WMI.js} +2 -2
- package/dist/{chunk-Z6N5N4MN.js → chunk-SIW2HT2H.js} +21 -5
- package/dist/{chunk-IEDQT4Z3.js → chunk-SOAZIMWL.js} +12 -12
- package/dist/{chunk-R3GPRNBT.js → chunk-SVQMDVND.js} +87 -16
- package/dist/{chunk-45ZUMF4E.js → chunk-TPUAXIPR.js} +2 -2
- package/dist/{chunk-SL55XKVL.js → chunk-TXU34ELY.js} +25 -25
- package/dist/{chunk-GDJCWQIK.js → chunk-U4UAWGIT.js} +12 -8
- package/dist/{chunk-76SBT7KS.js → chunk-U56HK2RG.js} +7 -5
- package/dist/{chunk-RXNMZM6H.js → chunk-UDW2KAVF.js} +6 -6
- package/dist/{chunk-NDV6CBR7.js → chunk-UH5VQGNR.js} +2 -2
- package/dist/{chunk-75QC66XI.js → chunk-V2MIBJZU.js} +2 -2
- package/dist/{chunk-ZDVVIJPU.js → chunk-VAQPQXOI.js} +4 -4
- package/dist/{chunk-XPSDDTUZ.js → chunk-VCFRALU7.js} +3 -3
- package/dist/{chunk-5KJBWIDZ.js → chunk-VQDVEHDB.js} +2 -2
- package/dist/{chunk-6EFXPTHT.js → chunk-WAP5362D.js} +5 -5
- package/dist/{chunk-XY4OBD26.js → chunk-WGKKDGSA.js} +4 -4
- package/dist/{chunk-TXFOQZUQ.js → chunk-WVVUE7LU.js} +14 -7
- package/dist/{chunk-JAYHFXWH.js → chunk-WXQ7BHVQ.js} +7 -7
- package/dist/{chunk-7REDHC4N.js → chunk-X5NF3ZXW.js} +69 -14
- package/dist/{chunk-5W7S2SCA.js → chunk-XAE4NIZ2.js} +4 -4
- package/dist/{chunk-SPLRKCFV.js → chunk-XDGLYIB2.js} +2 -2
- package/dist/{chunk-7AKH4QDJ.js → chunk-XKMZYU5B.js} +96 -65
- package/dist/{chunk-UVHSMANV.js → chunk-Y3RH35KM.js} +47 -47
- package/dist/{chunk-GIQIMWTK.js → chunk-YHT7TDSH.js} +14 -14
- package/dist/{chunk-FXZEZAV2.js → chunk-YJXJOMXW.js} +3 -3
- package/dist/{chunk-ZPJXWMHK.js → chunk-YPLHVRMS.js} +4 -4
- package/dist/{chunk-WS2X5BB2.js → chunk-YYBBJPCL.js} +5 -5
- package/dist/{chunk-ZOHEHIFS.js → chunk-YYDM4DNP.js} +2 -2
- package/dist/{chunk-ZC6H2ERE.js → chunk-ZF4LCHCT.js} +5 -5
- package/dist/{chunk-GRXX2TOJ.js → chunk-ZHFSIQ6E.js} +2 -2
- package/dist/{chunk-SHHXLI2K.js → chunk-ZJQFKBX7.js} +7 -7
- package/dist/{chunk-ZRXDPCMN.js → chunk-ZYZ7GRX3.js} +2 -2
- package/dist/{chunk-CJGLAQRD.js → chunk-ZZC5VSLP.js} +4 -4
- package/dist/cli.d.ts +3 -3
- package/dist/cli.js +62 -61
- package/dist/codegen-command-NAY6YAOD.js +183 -0
- package/dist/codegen.d.ts +3 -3
- package/dist/codegen.js +5 -5
- package/dist/{commands-5ILSWDSV.js → commands-Z2QZOORB.js} +3 -3
- package/dist/{completion-UNKBVVDT.js → completion-LFXXNQGR.js} +3 -3
- package/dist/{config-NTOASFCA.js → config-7GGINOFY.js} +4 -4
- package/dist/{deploy-command-BYAZZF37.js → deploy-command-PBM3S4ZL.js} +69 -68
- package/dist/{deploy-source-QCPZWNJO.js → deploy-source-JW7DAN75.js} +32 -32
- package/dist/{dev-env-sync-6MHK3UHC.js → dev-env-sync-FHJTFH3V.js} +63 -62
- package/dist/{diagnostics-FNVNRYMB.js → diagnostics-T3RN3372.js} +2 -2
- package/dist/{display-name-hint-MYXCCAOP.js → display-name-hint-5GLJGPQ6.js} +11 -11
- package/dist/{emit-YLt3GfsZ.d.ts → emit-t-gDE1BL.d.ts} +181 -93
- package/dist/env-example-refresh-HHEGMFNH.js +136 -0
- package/dist/{env-pull-command-KUIEKBTM.js → env-pull-command-FFPNRVWD.js} +52 -52
- package/dist/{env-target-Y77RLRS5.js → env-target-XHVRZXHX.js} +14 -14
- package/dist/{env-var-command-BZWJD75C.js → env-var-command-DJS62YRR.js} +41 -41
- package/dist/{ephemeral-VLPRDNEJ.js → ephemeral-2DXWP3VK.js} +9 -9
- package/dist/{ephemeral-command-SYKDPALW.js → ephemeral-command-VLQIQ5TS.js} +52 -52
- package/dist/{ephemeral-state-RUOU2GFS.js → ephemeral-state-56XEDUJW.js} +12 -12
- package/dist/{generate-command-CSQDQZSW.js → generate-command-PSDIIOTU.js} +89 -88
- package/dist/{gitignore-OQGYM7DO.js → gitignore-PMJ6MFNA.js} +15 -15
- package/dist/{guards-JUYBDLZY.js → guards-YICHJKX3.js} +51 -15
- package/dist/{impersonate-command-HSFCZBV6.js → impersonate-command-IKV4KUYA.js} +37 -37
- package/dist/{import-T4ZTOTBT.js → import-VJQGIS33.js} +5 -5
- package/dist/index.d.ts +552 -117
- package/dist/index.js +29 -28
- package/dist/init-command-LEQIE6GC.js +143 -0
- package/dist/{init-modules-BL2SR5RK.js → init-modules-G47Q7ABV.js} +8 -8
- package/dist/{init-web-DYE2FEXL.js → init-web-25QJ4JWB.js} +3 -3
- package/dist/internal.d.ts +55 -8
- package/dist/internal.js +692 -503
- package/dist/{io-PGTCBSIQ.js → io-47TFRYDB.js} +6 -6
- package/dist/{keep-data-merge-SHF75FC7.js → keep-data-merge-XCPCX7BZ.js} +38 -38
- package/dist/{lambda-config-reconcile-VOBVZPWS.js → lambda-config-reconcile-CC5QIP6E.js} +3 -3
- package/dist/{landed-F7PCHGCK.js → landed-VIUFHLCJ.js} +5 -5
- package/dist/{landing-record-7EOLEKH3.js → landing-record-JQ7HZDGI.js} +22 -22
- package/dist/{live-diff-M2OLXKM6.js → live-diff-KJ2TWWWT.js} +14 -14
- package/dist/{local-engine-choice-TOC3UYZZ.js → local-engine-choice-DFAMYOIF.js} +35 -35
- package/dist/{local-engine-command-6KSRDZBR.js → local-engine-command-5RP2J5QZ.js} +40 -40
- package/dist/{local-engine-deploy-4N4NFZ4T.js → local-engine-deploy-XAEDT55W.js} +12 -12
- package/dist/{local-engine-lookup-AQTUGSBT.js → local-engine-lookup-WBYTY2JE.js} +2 -2
- package/dist/{local-engine-mcp-bridge-AMYRH4SY.js → local-engine-mcp-bridge-3H5OXBWQ.js} +5 -5
- package/dist/{local-engine-mcp-command-XTP3EATV.js → local-engine-mcp-command-JSYVVZKK.js} +42 -42
- package/dist/{local-engine-process-OD5OSWDG.js → local-engine-process-35B2KQED.js} +7 -7
- package/dist/{local-engine-update-check-G3YCBXRE.js → local-engine-update-check-VXJZSIJU.js} +5 -5
- package/dist/{lock-HDCHD2ON.js → lock-JBKTDEDO.js} +4 -4
- package/dist/{lock-commands-437P6BHY.js → lock-commands-7VO6YWOV.js} +67 -66
- package/dist/{login-command-BNRDAVFV.js → login-command-WTZUBCW6.js} +27 -27
- package/dist/{logout-command-FCGCHB7Y.js → logout-command-5BJUNK3C.js} +17 -17
- package/dist/{loop-WOAEXMTC.js → loop-HILLODVH.js} +15 -15
- package/dist/{marketplace-command-SUBJZPJV.js → marketplace-command-NMOH4XOV.js} +30 -30
- package/dist/{marketplace-resolve-JR4BBJ6K.js → marketplace-resolve-63QWMQZU.js} +6 -6
- package/dist/{meta-client-AYJS3RQ3.js → meta-client-MRAMWUKV.js} +15 -15
- package/dist/{module-manifest-63I5GRK4.js → module-manifest-NWJWAQLQ.js} +4 -4
- package/dist/node.d.ts +8 -8
- package/dist/node.js +71 -70
- package/dist/{operation-outcome-ORQPVJKB.js → operation-outcome-WK7UW6PJ.js} +24 -24
- package/dist/{output-target-KNHHNDM3.js → output-target-5PYRCCK4.js} +16 -16
- package/dist/{plan-disclosure-4DUFRGCP.js → plan-disclosure-6MG4YYJV.js} +28 -28
- package/dist/{plugin-contributions-YYEP7IWH.js → plugin-contributions-DD6R6RL6.js} +5 -5
- package/dist/{plugin-prompt-GKCQKNYI.js → plugin-prompt-UX2TT5NS.js} +5 -5
- package/dist/{plugin-questions-P7MA3TYI.js → plugin-questions-WE2F4ZC4.js} +4 -4
- package/dist/{preflight-command-32GFVKSN.js → preflight-command-3BX2WW3S.js} +75 -74
- package/dist/{profile-command-U2XTKOMF.js → profile-command-GSUX3UMB.js} +28 -28
- package/dist/{profile-pointer-JJ7K5O2R.js → profile-pointer-RCPHVTJV.js} +4 -4
- package/dist/{project-dependency-X3KCWBK5.js → project-dependency-TPVV3YIX.js} +7 -7
- package/dist/{project-sdk-YHJZRCNB.js → project-sdk-DKZBK5H5.js} +4 -4
- package/dist/promote-command-3LQTXWCD.js +149 -0
- package/dist/{prompt-QNMJIWNI.js → prompt-OYQHQWKI.js} +4 -4
- package/dist/{publish-command-5ZVZ6IYT.js → publish-command-3BQCV4NE.js} +72 -71
- package/dist/pull-command-B7OVWTZD.js +171 -0
- package/dist/{pull-superseded-6HADGGC5.js → pull-superseded-3SSM3JFT.js} +4 -4
- package/dist/{raw-where-gWGr-E4t.d.ts → raw-where-CinW0keO.d.ts} +32 -4
- package/dist/release-command-XSDICMJE.js +153 -0
- package/dist/{release-ns-command-LDN5DOKQ.js → release-ns-command-EVAHK4CU.js} +96 -95
- package/dist/{retry-command-LFZYEVRU.js → retry-command-WP4ZI6CJ.js} +8 -8
- package/dist/{routes-manifest-BMAOL6WN.js → routes-manifest-N73THJB3.js} +16 -16
- package/dist/routes-manifest-file-LDUDIVFJ.js +41 -0
- package/dist/scaffold.js +2 -2
- package/dist/{secrets-file-7QM3ORGX.js → secrets-file-7XWR7HW3.js} +15 -15
- package/dist/{secrets-fill-command-OZ537VOD.js → secrets-fill-command-NKCGC75L.js} +66 -65
- package/dist/{seed-ATGBOEJP.js → seed-YKTZDS2Q.js} +13 -13
- package/dist/{source-resolve-QYSWA3QR.js → source-resolve-CQGDFQQC.js} +22 -22
- package/dist/{static-host-MO4VDHL7.js → static-host-3HPZKVKK.js} +5 -5
- package/dist/{status-command-IEB4K7ME.js → status-command-TBMQ3GJP.js} +38 -38
- package/dist/{store-AJX4MC7Y.js → store-B63BQV6R.js} +6 -6
- package/dist/{store-DspGMsFY.d.ts → store-in7gSpMS.d.ts} +185 -11
- package/dist/sync-baseline-GRS33AB5.js +38 -0
- package/dist/{sync-contributions-DLV5JZUK.js → sync-contributions-RKPLZPPO.js} +9 -9
- package/dist/{sync-record-NE62ERA3.js → sync-record-AWFCSS4D.js} +15 -15
- package/dist/{table-TFD4ZQXA.js → table-ONGT3JGE.js} +12 -12
- package/dist/{tables-command-IMCVPUFY.js → tables-command-UYQ277TJ.js} +41 -41
- package/dist/{tenant-IIYECNWO.js → tenant-IXIW3FOI.js} +10 -10
- package/dist/{tenant-command-77KG76MU.js → tenant-command-7LWZUK2V.js} +104 -103
- package/dist/{test-command-NSPU4RUO.js → test-command-7KTT5EAF.js} +56 -45
- package/dist/{tests-JWQRHFCT.js → tests-N4MMBABH.js} +6 -6
- package/dist/{token-BDHD7GU3.js → token-3TCMW2AP.js} +13 -13
- package/dist/{toolchain-hooks-QHJRDCRW.js → toolchain-hooks-IJWV3ZQS.js} +18 -18
- package/dist/{toolchain-modules-LY7BMYG6.js → toolchain-modules-PBVBCPQJ.js} +5 -5
- package/dist/{toolchain-peers-FQJBTKEB.js → toolchain-peers-EMOYN4U7.js} +8 -8
- package/dist/{tracked-backend-BIR7YJCE.js → tracked-backend-YDUUQZQF.js} +34 -34
- package/dist/update-check-C6KDFGMT.js +141 -0
- package/dist/{upgrade-command-YCADQCIA.js → upgrade-command-ZSBTSMBR.js} +68 -67
- package/dist/{whoami-command-IZCTUPM4.js → whoami-command-L6ERHR5K.js} +16 -16
- package/dist/{workspace-TK52V7WO.js → workspace-5DPSDM4A.js} +5 -5
- package/dist/{workspace-binding-3UT6PP4B.js → workspace-binding-MVOWGNYW.js} +15 -15
- package/dist/{workspace-command-46OCB6XT.js → workspace-command-PKQ5TDR7.js} +100 -99
- package/dist/{workspace-env-PVPOWFNZ.js → workspace-env-UZJZUIYV.js} +18 -12
- package/dist/{workspace-export-PUEXKZNS.js → workspace-export-3KMWNZDD.js} +5 -5
- package/dist/{writable-LMMG4AFZ.js → writable-X7BCN7XE.js} +4 -4
- package/dist/xano-YB6Y2IJS.js +44 -0
- package/dist/{xanosdk-import-XXJT365U.js → xanosdk-import-HHMQDK2I.js} +10 -10
- package/dist/{xanosdk-project-CJKRLQ6U.js → xanosdk-project-CKEUNJU4.js} +13 -13
- package/dist/{xdo-D4OwfF2J.d.ts → xdo-DNGZGO1j.d.ts} +50 -12
- package/guides/authoring.md +1 -0
- package/guides/codes.md +33 -3
- package/guides/coverage.md +2 -2
- package/guides/object-kinds.md +1 -1
- package/guides/typed-frontend.md +9 -0
- package/llms/client.md +54 -36
- package/llms/errors.md +26 -6
- package/llms/fields.md +53 -30
- package/llms/filters.md +55 -46
- package/llms/kinds-agent-mcp.md +10 -9
- package/llms/kinds-core.md +19 -15
- package/llms/kinds-knowledge.md +4 -4
- package/llms/kinds-realtime.md +25 -23
- package/llms/lambda.md +42 -30
- package/llms/legacy.md +6 -7
- package/llms/lock.md +21 -17
- package/llms/object-kinds.md +9 -11
- package/llms/statements-calls.md +41 -20
- package/llms/statements-catalog.md +32 -25
- package/llms/statements-data.md +35 -25
- package/llms/statements-runtime.md +28 -18
- package/llms/tests.md +20 -7
- package/llms/toolchain.md +12 -9
- package/llms/triggers.md +14 -18
- package/llms/values.md +16 -9
- package/llms-full.txt +643 -503
- package/llms.txt +120 -137
- package/manifest.json +147 -95
- package/package.json +1 -1
- package/skills/xano-backend/SKILL.md +10 -12
- package/types/lambda-globals.d.ts +6 -1
- package/dist/branch-commands-4PJEBNRK.js +0 -80
- package/dist/codegen-command-RDD4GL35.js +0 -182
- package/dist/env-example-refresh-MQWHY7ZS.js +0 -135
- package/dist/init-command-6Z7QNVDY.js +0 -142
- package/dist/promote-command-OO56IZBT.js +0 -148
- package/dist/pull-command-LT5PCEIW.js +0 -170
- package/dist/release-command-RBUOXIH7.js +0 -152
- package/dist/routes-manifest-file-MPOVKD6N.js +0 -41
- package/dist/sync-baseline-IB7MABZO.js +0 -38
- package/dist/update-check-JDARCXAX.js +0 -140
- package/dist/xano-EOUVXNQX.js +0 -43
package/llms.txt
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# xanosdk v1.0.
|
|
1
|
+
# xanosdk v1.0.16
|
|
2
2
|
|
|
3
3
|
> TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.
|
|
4
4
|
|
|
@@ -16,21 +16,18 @@ TAGGED value — `ref("x")` a stack variable, `inp("x")` an input, `auth("id")`
|
|
|
16
16
|
caller, `c.*` a constant — resolved at request time; JS operators over them do not
|
|
17
17
|
compute (see Gotchas). Requests share no memory — state persists in tables or redis.
|
|
18
18
|
|
|
19
|
-
Authorable: statement surfaces
|
|
20
|
-
Not authorable here: branch, market_item, realtime_channel, run.job, run.service, tablemap — these cannot be authored and do not survive a pull; reasons in `coverage.objectKinds.unmodeled`.
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
lookup in the shipped `manifest.json` (a program imports it as
|
|
28
|
-
`@xano/sdk/manifest.json`, needing `with { type: "json" }` in Node ESM;
|
|
29
|
-
it is ~70k tokens, so never read it whole). Its top-level keys are `name`, `version`, `description`, `coverage`, `values`, `objectKinds`, `fieldTypes`, `statements`, `filters`, `cli`, `cliGlobalFlags`. `statements` and `filters` are ARRAYS, not maps — SELECT, do not index:
|
|
19
|
+
Authorable: statement surfaces 219/219, filters 246 (246 typed).
|
|
20
|
+
Not authorable here: branch, market_item, realtime_channel (legacy; author realtimeServer + realtimeChannel instead), run.job, run.service, tablemap — these cannot be authored and do not survive a pull; reasons in `coverage.objectKinds.unmodeled`.
|
|
21
|
+
|
|
22
|
+
Per-surface detail is in the topic files below: open the one whose condition matches the task.
|
|
23
|
+
Per-entry detail (a statement's field schema with engine defaults, a filter's full argument
|
|
24
|
+
list, the `storedName` mapping) is in the shipped `manifest.json` — do a TARGETED lookup;
|
|
25
|
+
it is ~70k tokens, so never read it whole. A program imports it as `@xano/sdk/manifest.json`
|
|
26
|
+
(Node ESM needs `with { type: "json" }`). Its top-level keys are `name`, `version`, `description`, `coverage`, `values`, `objectKinds`, `fieldTypes`, `statements`, `filters`, `cli`, `cliGlobalFlags`. `statements` and `filters` are ARRAYS, not maps — SELECT, do not index:
|
|
30
27
|
jq '.statements[] | select(.sPath=="db.get")' manifest.json
|
|
31
28
|
jq '.filters[] | select(.name=="json_decode")' manifest.json
|
|
32
|
-
⚠ `fields` is null on the
|
|
33
|
-
Select a statement on `sPath` (the `s.*` path you write), NOT `surface` (the XanoScript term): 24 of
|
|
29
|
+
⚠ `fields` is null on the 66 `declarative: false` statements (`db.get`, …): typed wrappers whose arguments are the factory's `.d.ts` signature. Null ≠ missing.
|
|
30
|
+
Select a statement on `sPath` (the `s.*` path you write), NOT `surface` (the XanoScript term): 24 of 219 differ — `var`→`set_var`, `break`→`foreach_break`, `foreach.remove`→`foreach_remove`, and every `expect.*`.
|
|
34
31
|
|
|
35
32
|
## Topic files
|
|
36
33
|
|
|
@@ -61,9 +58,6 @@ plain file read resolves them at the version you have.
|
|
|
61
58
|
|
|
62
59
|
## Quickstart
|
|
63
60
|
|
|
64
|
-
Authoring is **declarative def-objects** passed to factories — there is no
|
|
65
|
-
callback/chaining builder.
|
|
66
|
-
|
|
67
61
|
```ts
|
|
68
62
|
import { workspace, apiGroup, query, table, input, f, ref, inp, auth, s } from "@xano/sdk";
|
|
69
63
|
|
|
@@ -72,13 +66,13 @@ const users = table({
|
|
|
72
66
|
auth: true, // backs authentication
|
|
73
67
|
// `id` (int PK) + `created_at` (epochms) are auto-injected — don't declare them.
|
|
74
68
|
schema: {
|
|
75
|
-
email: f.email({ required: true }),
|
|
69
|
+
email: f.email({ required: true, methods: ["trim", "lower"] }), // a unique email index is CASE-SENSITIVE — lowercase it
|
|
76
70
|
name: f.text(),
|
|
77
71
|
},
|
|
78
72
|
// Indexes: { type, fields: [{ name, op? }] }. `"unique"` is shorthand for `"btree|unique"`.
|
|
79
73
|
// A DOTTED name indexes a key inside a column (`xdo.email`); only the part before the
|
|
80
74
|
// first dot is checked against the schema.
|
|
81
|
-
index: [{ type: "unique", fields: [{ name: "email" }] }],
|
|
75
|
+
index: [{ type: "unique", fields: [{ name: "email" }] }],
|
|
82
76
|
});
|
|
83
77
|
|
|
84
78
|
const posts = table({
|
|
@@ -119,30 +113,26 @@ package.json or name the entry `.mts`. `npm init -y` writes `"type": "commonjs"`
|
|
|
119
113
|
which fails with a "must be ES modules" error until you switch it to module.
|
|
120
114
|
|
|
121
115
|
Set `canonical` on every `apiGroup`. The engine mints the URL token server-side, so
|
|
122
|
-
without one
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
but nothing fails on a message no one reads, so in CI and in unattended agent builds
|
|
135
|
-
pass `--strict` (`emitBundle(app, { strict: true })` / `app.export({ strict: true })`):
|
|
136
|
-
every warning becomes a hard failure. Same bundle bytes either way.
|
|
116
|
+
without one `npx @xano/sdk routes` / `getPath()` cannot resolve the group's paths until a
|
|
117
|
+
lock exists (the export itself succeeds).
|
|
118
|
+
⚠ A canonical is unique across the whole INSTANCE, not per workspace; no flag shares one.
|
|
119
|
+
A canonical set in code is a PIN: a merge refuses (exit 2) when another workspace holds it.
|
|
120
|
+
One only the lock minted is not pinned: the instance may replace it with a random token,
|
|
121
|
+
and `--static` is refused when it does.
|
|
122
|
+
|
|
123
|
+
Build warnings: `export()` warns on shapes that deploy but misbehave (a `bulk.update`
|
|
124
|
+
zero-filling omitted columns, an `ignoreEmpty` on an empty operand, a `ref()` nothing
|
|
125
|
+
binds). In CI and agent builds pass `--strict` (`emitBundle(app, { strict: true })` /
|
|
126
|
+
`app.export({ strict: true })`): every warning becomes a hard failure. Same bundle bytes
|
|
127
|
+
either way.
|
|
137
128
|
Before calling the work done: `npm run typecheck`, `npx @xano/sdk export <entry> --strict`,
|
|
138
129
|
`deploy <entry>`, then `test run-all` against what deployed.
|
|
139
130
|
|
|
140
|
-
Identity: object guids derive from `(type, name)`
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
`--frozen-lock` fails instead of changing it).
|
|
131
|
+
Identity: object guids derive from `(type, name)` (a query adds group + verb),
|
|
132
|
+
so renames change identity.
|
|
133
|
+
Every build freezes every guid + api-group/toolset canonical in a lock file beside the entry
|
|
134
|
+
file (`xano/xano.lock` in the standard scaffold, not the project root). Commit it
|
|
135
|
+
(`--no-lock` opts out; CI guard `--frozen-lock` fails instead of changing it).
|
|
146
136
|
To rename an object: rename in code, export (stderr prints the exact fix-up), run
|
|
147
137
|
`npx @xano/sdk lock rename <kind> <old> <new>`, export again — the original guid is emitted
|
|
148
138
|
under the new name, so the engine renames in place instead of delete+create. Taking
|
|
@@ -156,51 +146,58 @@ Commands here run as `npx @xano/sdk <cmd>`: `init` → `deploy` → URL. A deplo
|
|
|
156
146
|
`export` (honoring `xano.lock`), imports the result, and prints the URL.
|
|
157
147
|
⚠ Every deploy is a FULL REPLACE of its destination — objects AND records.
|
|
158
148
|
|
|
159
|
-
**Backends** — one grammar
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
`
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
149
|
+
**Backends** — one grammar for every command that names a backend:
|
|
150
|
+
|
|
151
|
+
- Spellings: `workspace` | `ephemeral[:<name>]` | `local[:<name>]` (no credential) |
|
|
152
|
+
`tenant:<name>` | `release:<name>` | a bundle path where a file fits.
|
|
153
|
+
- Reads `--from`, writes `--to`, `test --on`; positional on `deploy`/`pull`/`generate`/`tables`/
|
|
154
|
+
`impersonate`.
|
|
155
|
+
- Omitted = the ephemeral or Xano Engine this project last deployed to, never
|
|
156
|
+
workspace/tenant. Exceptions: bare `deploy` always targets the Xano Engine (`--ephemeral`: an
|
|
157
|
+
ephemeral); `generate`/`init --from` need one.
|
|
158
|
+
- A backend a command cannot serve is refused, typed or tracked, with the reason and the valid
|
|
159
|
+
spellings (`release create` refuses a Xano Engine).
|
|
160
|
+
- `release create --from` takes a run only: no bundle path, no `release:`, and a
|
|
161
|
+
`tenant:` only if throwaway (`standard`/`run` refused).
|
|
168
162
|
|
|
169
163
|
**Destinations** — the Xano Engine by default, real only when you say so:
|
|
170
164
|
|
|
171
|
-
- `deploy [source]` → the Xano Engine on this machine (no account).
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
165
|
+
- `deploy [source]` → the Xano Engine on this machine (no account).
|
|
166
|
+
- `--ephemeral` → a NAMED, auto-expiring ephemeral (~1h; `--expires-hours` 1–24), tracked in
|
|
167
|
+
`./.xano/ephemeral.json`, so deploying again REFRESHES it at the same URL; if it expired or
|
|
168
|
+
was swept, a fresh one is created and the new URL printed.
|
|
169
|
+
- ⚠ Only the BACKEND URL survives a refresh: the replace clears static hosting, so
|
|
170
|
+
`--static` publishes a NEW host every run and the previous URL stops serving.
|
|
171
|
+
- Under `--keep-data`, which MERGES an env a deploy filled instead of replacing it, the static
|
|
172
|
+
URL survives too: rows kept, no re-seed, removed objects deleted. ⚠ Limits: a rename loses values,
|
|
173
|
+
a RETYPE reads unfit ones as null, env VALUES are not applied, a table trigger refuses it.
|
|
174
|
+
`--reset` replaces and re-seeds.
|
|
175
|
+
- `release create <name>` cuts a release from a running source and LANDS it in your workspace.
|
|
176
|
+
A release records that the source came up; it is the only thing `promote`/`tenant deploy` take.
|
|
177
|
+
- Refused: a taken name, and one that addresses a LOCATION instead of naming (`/`, `\`, `:`,
|
|
178
|
+
or a leading `.`). Every export derives its FILENAME from the name it is given, so
|
|
179
|
+
`release|ephemeral|workspace export` refuse those same shapes unless `--path` names the file.
|
|
180
|
+
- Carries EVERY table's SCHEMA either way; `--seed[=<guids>]` adds ROWS. Guids come from
|
|
181
|
+
`tables <backend>`; a redeploy KEEPS them.
|
|
186
182
|
- `release transfer <name> --to-profile <profile>` copies a release to another
|
|
187
183
|
workspace/instance by CONTENT (tar sha256): identical → reused; same name, other
|
|
188
184
|
bytes → exit 2.
|
|
189
185
|
- `promote <release>` / `tenant deploy <tenant> <release>` land it.
|
|
190
|
-
`promote` adds a branch; ⚠ its TABLE edits hit live
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
`completed` yes|no|unknown; UNKNOWN exits 9 — run
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
186
|
+
- `promote` adds a branch; ⚠ its TABLE edits hit live (`--allow-shared-schema-changes`).
|
|
187
|
+
- `tenant deploy` REPLACES: DROPS tables it lacks, CONVERTS retypes (`--seed`: rows).
|
|
188
|
+
- `promote` refuses a taken name/pinned slug (`SDK_IDENTITY_CONFLICT`), then EXITS NON-ZERO
|
|
189
|
+
if a declared object did not arrive or a pinned slug is not served. `--set-live` switches
|
|
190
|
+
only after that check passes; a failure leaves the previous branch serving. Extra objects
|
|
191
|
+
are reported; a check missing an input reports `unverified`, exit 0.
|
|
192
|
+
- `--expect-live <label>` (with `--set-live`) refuses if live moved; not atomic.
|
|
193
|
+
- `--json` on every release write: `completed` yes|no|unknown; UNKNOWN exits 9 — run
|
|
194
|
+
`resolveWith`, never retry blind.
|
|
195
|
+
- Inspect a staged branch with `workspace export --branch <label>` or
|
|
196
|
+
`workspace diff <entry> --branch <label>`.
|
|
197
|
+
- ⚠ The redis family, `s.lambda`, `s.db.direct_query`, `s.await`, async runs,
|
|
198
|
+
`s.microservice.request`, `s.zip.*`, the raw-file readers, Datadog and Webflow need an
|
|
199
|
+
INSTANCE CAPABILITY: they deploy clean and fail on the first request if the target lacks it.
|
|
200
|
+
`export`/`deploy` list what the bundle needs — compare it to the target yourself.
|
|
204
201
|
- Backend SECRETS stay out of the repo: declare the NAME, value empty, in `workspaceConfig({ env })`
|
|
205
202
|
passed to `registerWorkspace()`; the VALUE lives in `xano/.env` — gitignored, kept across a
|
|
206
203
|
pull, read by every build. `--backend-env-file <path>` replaces that default (CI has
|
|
@@ -233,9 +230,7 @@ and a `tenant:` only if throwaway (`standard`/`run` refused).
|
|
|
233
230
|
- `workspace reset-tables <entry> --table <guid>` puts NAMED tables back to their
|
|
234
231
|
compiled `table({ seed })` rows, touching no other table. Dry run unless `--write`.
|
|
235
232
|
⚠ ROWS BEFORE LOGIC: rows are workspace-shared like schema, so they reach production when
|
|
236
|
-
applied even while the logic reading them is staged
|
|
237
|
-
atomic. Reset rows FIRST, then `promote`: new rows under old logic break only a feature
|
|
238
|
-
being removed; new logic over old rows breaks the one you are shipping.
|
|
233
|
+
applied, even while the logic reading them is staged. Reset rows FIRST, then `promote`.
|
|
239
234
|
- `pull` refreshes THIS project from a backend: rewrites decoded files,
|
|
240
235
|
keeps yours, lists and confirms (`--yes`).
|
|
241
236
|
- `generate <source>`: the decoded tree ONLY, no project.
|
|
@@ -265,11 +260,9 @@ Non-obvious authoring rules:
|
|
|
265
260
|
- **No callback builder.** Flat def-objects + `register*`, not
|
|
266
261
|
`workspace(w => w.table(...))`. `workspace(name)` returns a named `new Xano()`;
|
|
267
262
|
tables are `table({ schema: { col: f.text() } })`.
|
|
268
|
-
- **
|
|
269
|
-
`col` = table column (in `db.query` `where`), `auth("id")` = the caller,
|
|
270
|
-
`c.*` = a constant.
|
|
271
|
-
- **Foreign key is `f.tableRef(table)`, not `ref`.** `ref(name)` references a
|
|
272
|
-
stack variable (a value); `f.tableRef` is the column constructor.
|
|
263
|
+
- **Foreign key is `f.tableRef(table)`, not `ref`.** `ref` = stack var (`as:` output),
|
|
264
|
+
`inp` = input, `col` = table column (in `db.query` `where`), `auth("id")` = the caller,
|
|
265
|
+
`c.*` = a constant; `f.tableRef` is the column constructor.
|
|
273
266
|
- **Tagged values are DATA — a JS template literal cannot compose them.** `${ref(...)}`
|
|
274
267
|
(or `"a" + ref(...)`) stringifies the tag object at BUILD time: ``c.text(`Hi ${ref("u.name")}`)``
|
|
275
268
|
type-checks and encodes the literal text `Hi [object Object]`, served verbatim.
|
|
@@ -283,11 +276,11 @@ Non-obvious authoring rules:
|
|
|
283
276
|
- **`get_input`/`get_raw_input` read the whole payload**, not one named input
|
|
284
277
|
(args are `{ as?, encoding?, excludeMiddleware? }` — no `name`). For a single
|
|
285
278
|
input use `inp("name")`.
|
|
286
|
-
- **
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
279
|
+
- **A `where` is a comparison, never a value.** To match every row, omit `where`. A value
|
|
280
|
+
`where` — `c.bool(true)`, a text clause, or one built at run time (`inp("clause")`,
|
|
281
|
+
`ref("built_where")`) — throws at build: the engine reads a filter only as a comparison
|
|
282
|
+
tree and runs anything else over EVERY row. Bind run-time values as operands instead:
|
|
283
|
+
`expr(col("status"), "=", inp("status"))`.
|
|
291
284
|
|
|
292
285
|
### Tables and columns
|
|
293
286
|
|
|
@@ -305,8 +298,7 @@ Non-obvious authoring rules:
|
|
|
305
298
|
defaults or a 400. HTTP binds it fine. `--strict` fails on it.
|
|
306
299
|
- **Numeric columns lose money quietly.** A normalized table's `f.decimal` reads
|
|
307
300
|
`0.12345678` back as `0.12346`; `f.int` saturates at `9223372036854775807`
|
|
308
|
-
instead of failing
|
|
309
|
-
arithmetic that stops reconciling. Hold money as a count of the smallest unit;
|
|
301
|
+
instead of failing, both at HTTP 200. Hold money as a count of the smallest unit;
|
|
310
302
|
exact bounds: `llms/fields.md`.
|
|
311
303
|
- **Self-referencing tables** need the bare-name form: inside `tweets`'s own
|
|
312
304
|
schema, write `f.tableRef("tweets", { type: "int" })` — the `const tweets`
|
|
@@ -333,22 +325,17 @@ Non-obvious authoring rules:
|
|
|
333
325
|
### Reading and writing rows
|
|
334
326
|
|
|
335
327
|
- **DB reads are field-match, not `where`-expr.** `db.get`/`db.edit`/`db.del`/
|
|
336
|
-
`db.has`/`db.patch` match
|
|
337
|
-
defaults to the PK `id`). Only `db.query` takes a
|
|
338
|
-
`expr(...)`; writes (`db.add`/`db.edit`/`db.add_or_edit`) take a
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
predicate). For a `(a, b)` existence/fetch — e.g. dedupe a `(habit, date)`
|
|
343
|
-
check-in — use `db.query({ where: [expr(col("habit"), "=", ...), expr(col("date"), "=", ...)], as })`
|
|
344
|
-
(a `where` array is ANDed) and branch on the result, rather than pushing the
|
|
345
|
-
check to the client.
|
|
328
|
+
`db.has`/`db.patch` match exactly ONE field: `{ fieldName, fieldValue }` (`fieldName`
|
|
329
|
+
defaults to the PK `id`); there is no composite match. Only `db.query` takes a
|
|
330
|
+
`where`/`additionalWhere` `expr(...)`; writes (`db.add`/`db.edit`/`db.add_or_edit`) take a
|
|
331
|
+
`row`/`data`. For an `(a, b)` existence/fetch (e.g. dedupe a `(habit, date)` check-in), use
|
|
332
|
+
`db.query({ where: [expr(col("habit"), "=", ...), expr(col("date"), "=", ...)], as })`
|
|
333
|
+
(a `where` array is ANDed) and branch on the result. Signatures: `llms/statements-data.md`.
|
|
346
334
|
- **Drilling into a maybe-null `db.get` result 500s — use `ref(path, { safe: true })`.**
|
|
347
335
|
`db.get` binds `null` on a no-match, but a nested `ref("owner.user_id")` raises a runtime
|
|
348
336
|
"Unable to locate var" (HTTP 500) when `owner` is null — an ownership guard throws instead
|
|
349
|
-
of failing cleanly. Two correct shapes:
|
|
350
|
-
- Guard existence first — `
|
|
351
|
-
error_type: "notfound", error: c.text("Not found.") })` — then drill WITHOUT `safe`.
|
|
337
|
+
of failing cleanly (same for a `single` `db.query`; warns `stack.drill-maybe-null`). Two correct shapes:
|
|
338
|
+
- Guard existence first — `guard.found("owner")` (a 404 precondition) — then drill WITHOUT `safe`.
|
|
352
339
|
- Or drill null-safe inside an EXPRESSION or `obj()` operand:
|
|
353
340
|
`expr(ref("owner.user_id", { safe: true }), "=", auth("id"))` yields `null` (the guard
|
|
354
341
|
reads `false`) instead of 500ing. Works inside `obj({...})` too — no `s.set_var` hoist needed.
|
|
@@ -379,12 +366,12 @@ Non-obvious authoring rules:
|
|
|
379
366
|
- **`s.api.call` / `s.task.call` / `s.trigger.call` / `s.workflow_test.call` are
|
|
380
367
|
WORKFLOW-TEST ONLY.** Outside a `workflowTest({...})` stack the engine cannot reach
|
|
381
368
|
the target, so one in a query/function/task deploys clean and then answers the first
|
|
382
|
-
real request with `ERROR_FATAL: <Type> does not exist: <type>:<n
|
|
383
|
-
host kind
|
|
369
|
+
real request with `ERROR_FATAL: <Type> does not exist: <type>:<n>`. The failure is not per
|
|
370
|
+
host kind: the same call inside a function that a query runs fails the same way.
|
|
384
371
|
`export()` refuses them. `s.function.call`, `s.tool.call`, `s.middleware.call` and
|
|
385
|
-
`s.addon.call` run anywhere, as does `s.function.run
|
|
386
|
-
|
|
387
|
-
|
|
372
|
+
`s.addon.call` run anywhere, as does `s.function.run`. To share logic, put it in a
|
|
373
|
+
`defineFunction` and `s.function.run` it — NOT `s.function.call`, which binds a failing
|
|
374
|
+
target's error envelope instead of raising.
|
|
388
375
|
- **`expect.*` is a unit-test assertion; `s.expect.*` is a workflow-test statement.**
|
|
389
376
|
A statement's `mock` is keyed by TEST NAME; an undeclared name throws. See `llms/tests.md`.
|
|
390
377
|
- **A helper returning `Statement[]` widens the stack and kills `InferResponse`.**
|
|
@@ -398,17 +385,15 @@ Non-obvious authoring rules:
|
|
|
398
385
|
The regex filters (`regex_test`/`regex_match`/`regex_replace`/…) are PHP `preg_*`: the
|
|
399
386
|
piped value is the PATTERN and must be delimiter-wrapped, and the ARGUMENT is the subject.
|
|
400
387
|
Correct: `withFilters(c.regex(/^[a-z-]+$/i), fl.regex_test(inp("slug")))`.
|
|
401
|
-
- A bare `c.text("^…$")` is an invalid pattern that matches *nothing* for every input,
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
- Reversed — subject piped, pattern in the argument — reads correctly, type-checks, and
|
|
388
|
+
- A bare `c.text("^…$")` is an invalid pattern that matches *nothing* for every input, so
|
|
389
|
+
a precondition on it rejects all values. `c.regex(body, "i")` (or a JS `RegExp`) wraps + escapes it.
|
|
390
|
+
- Reversed (subject piped, pattern in the argument) type-checks and
|
|
405
391
|
answers false for EVERY input, so an `if (matches) reject` guard admits what it refuses.
|
|
406
|
-
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
- Better still: a native typed input (`input.email`) over hand-rolled validation.
|
|
392
|
+
- `withFilters` throws on both: a bare `c.text` pattern at ANY position in the chain (a
|
|
393
|
+
normalizer in front does not add delimiters) and a pattern in the subject slot.
|
|
394
|
+
`s.expect.to_match` is the same PATTERN slot, refused both ways. A `ref`/`inp` pattern is
|
|
395
|
+
passed through untouched. `export()` warns on a reversed pair in stored bytes.
|
|
396
|
+
- Prefer a native typed input (`input.email`) over hand-rolled validation.
|
|
412
397
|
- **An `auth()`-keyed limiter FAILS the request on any host with no caller identity —**
|
|
413
398
|
**at every tier.** `s.redis.ratelimit({ key: withFilters(c.text("rl:"), fl.concat(auth("id"))), error: c.text("…") })`
|
|
414
399
|
is the per-user form, and a public query, a task, or a function has no caller identity.
|
|
@@ -420,8 +405,8 @@ Non-obvious authoring rules:
|
|
|
420
405
|
### Identity, build, and deploy
|
|
421
406
|
|
|
422
407
|
- **Same-name siblings collide — queries excepted: their identity carries group + verb.**
|
|
423
|
-
|
|
424
|
-
|
|
408
|
+
Two functions (or tables, toolsets, …) sharing a name derive ONE guid and `export()`
|
|
409
|
+
throws — give them DISTINCT names. A QUERY
|
|
425
410
|
derives from `(api group, verb, name)`, the engine's own uniqueness: `GET items` +
|
|
426
411
|
`POST items`, and `items` across two groups, coexist, and the lock keys the same
|
|
427
412
|
composed identity (`query:blog|GET|items`) — changing a query's verb or group
|
|
@@ -455,29 +440,27 @@ Non-obvious authoring rules:
|
|
|
455
440
|
the runner has. An explicit `--profile` against it is a hard error too, not a displacement.
|
|
456
441
|
- On disk: `npx @xano/sdk profile add <name> --instance … --workspace-id <n>` reads the token
|
|
457
442
|
from piped stdin, else PROMPTS (a flag would reach the process list); the instance must accept it.
|
|
458
|
-
`auth.json` holds a map of named profiles, selected by `--profile <name>`.
|
|
459
|
-
`$XANO_REFRESH_TOKEN` + `$XANO_CLIENT_ID`
|
|
460
|
-
- **Event-driven objects
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
443
|
+
`auth.json` holds a map of named profiles, selected by `--profile <name>`.
|
|
444
|
+
`$XANO_REFRESH_TOKEN` + `$XANO_CLIENT_ID` also authenticate, but the refresh token is single-use (it ROTATES).
|
|
445
|
+
- **Event-driven objects run once deployed.** A `task` (scheduled), an `mcpServer`, and
|
|
446
|
+
every trigger — `tableTrigger` included — run on every deploy target, the Xano Engine and
|
|
447
|
+
an ephemeral alike. Test an event-driven design (screen-on-insert, scheduled cleanup, MCP
|
|
448
|
+
tool call) by deploying it and letting it run.
|
|
464
449
|
|
|
465
450
|
## Statements
|
|
466
451
|
|
|
467
452
|
Reachable through the `s` namespace: `s.<path>({...})`. Declarative statements
|
|
468
453
|
take one typed args object (field names match the engine); every surface's field
|
|
469
454
|
signature is in `llms/statements-catalog.md`. Specials (`[special]`) are
|
|
470
|
-
hand-authored: control flow is below,
|
|
471
|
-
topic files this doc's navigation names.
|
|
472
|
-
Wrap an `input`-routed `value` field in `ignored(...)` to store it but SKIP it at
|
|
473
|
-
runtime — the engine records `<name>:ignore` and the parameter falls back to its
|
|
474
|
-
default. Not the same as an empty value, and not the same as omitting the field
|
|
475
|
-
(which stores no entry at all). Mostly seen on a pulled workspace. A field written
|
|
476
|
-
into `context` instead (the `s.math.*`/`s.text.append` mutation family) has no slot
|
|
477
|
-
for the flag and THROWS rather than dropping it.
|
|
455
|
+
hand-authored: control flow is below, the rest are in the `llms/statements-*` topic files.
|
|
478
456
|
Fields marked `value` take a `Value` (`c.*`/`ref`/`inp`); `comparison` takes an
|
|
479
457
|
`expr(...)`. A `→ as: <type>` suffix names what the statement's `as:` output var
|
|
480
458
|
holds (curated, not exhaustive — absence means read the `[output]` flag and prose).
|
|
459
|
+
`ignored(...)` around an `input`-routed `value` field stores it but SKIPS it at runtime: the
|
|
460
|
+
engine records `<name>:ignore` and the parameter takes its default. Distinct from an empty
|
|
461
|
+
value and from omitting the field (no entry stored). Mostly seen on a pulled workspace. On a
|
|
462
|
+
`context`-routed field (the `s.math.*`/`s.text.append` mutation family) `ignored(...)` THROWS:
|
|
463
|
+
there is no slot for the flag.
|
|
481
464
|
|
|
482
465
|
### Specials — authored signatures
|
|
483
466
|
|