zitejs 0.9.153 → 0.9.155

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 (393) hide show
  1. package/dist/cjs/auth/actions.d.ts +28 -0
  2. package/dist/cjs/auth/actions.js +93 -0
  3. package/dist/cjs/auth/client.d.ts +357 -0
  4. package/dist/cjs/auth/client.js +66 -0
  5. package/dist/cjs/auth/config.js +9 -3
  6. package/dist/cjs/auth/index.d.ts +2 -249
  7. package/dist/cjs/auth/index.js +11 -108
  8. package/dist/cjs/auth/index.test.js +60 -0
  9. package/dist/cjs/auth/previewClaim.d.ts +7 -0
  10. package/dist/cjs/auth/previewClaim.js +16 -0
  11. package/dist/cjs/auth/profileUpdates.d.ts +9 -0
  12. package/dist/cjs/auth/profileUpdates.js +11 -0
  13. package/dist/cjs/backend/index.d.ts +6 -6
  14. package/dist/cjs/backend/index.js +13 -13
  15. package/dist/cjs/backend/index.test.js +102 -102
  16. package/dist/cjs/bundle/index.js +29 -16
  17. package/dist/cjs/caller/index.js +43 -43
  18. package/dist/cjs/check/index.d.ts +44 -1
  19. package/dist/cjs/check/index.js +198 -61
  20. package/dist/cjs/check/start/routeTree.d.ts +8 -0
  21. package/dist/cjs/check/start/routeTree.js +118 -0
  22. package/dist/cjs/check/start/tsgo.d.ts +2 -0
  23. package/dist/cjs/check/start/tsgo.js +35 -0
  24. package/dist/cjs/cli.js +19 -6
  25. package/dist/cjs/client/index.d.ts +2 -2
  26. package/dist/cjs/client/index.js +25 -25
  27. package/dist/cjs/dev/index.js +81 -53
  28. package/dist/cjs/dev/signin.d.ts +16 -0
  29. package/dist/cjs/dev/signin.js +84 -0
  30. package/dist/cjs/index.d.ts +5 -5
  31. package/dist/cjs/integrations/client.d.ts +3 -3
  32. package/dist/cjs/integrations/client.js +5 -4
  33. package/dist/cjs/integrations/client.test-d.js +15 -15
  34. package/dist/cjs/integrations/index.d.ts +2 -2
  35. package/dist/cjs/integrations/rules.js +42 -42
  36. package/dist/cjs/integrations/rules.test.js +60 -55
  37. package/dist/cjs/internal/appMode.d.ts +14 -0
  38. package/dist/cjs/internal/appMode.js +19 -0
  39. package/dist/cjs/internal/env.js +3 -2
  40. package/dist/cjs/internal/platformFetch.d.ts +2 -0
  41. package/dist/cjs/internal/platformFetch.js +14 -0
  42. package/dist/cjs/internal/reservedIds.d.ts +8 -0
  43. package/dist/cjs/internal/reservedIds.js +14 -0
  44. package/dist/cjs/internal/serviceUrls.d.ts +5 -0
  45. package/dist/cjs/internal/serviceUrls.js +14 -0
  46. package/dist/cjs/pdf/index.js +2 -1
  47. package/dist/cjs/runtime/filterConditionTypes.test-d.js +11 -11
  48. package/dist/cjs/runtime/index.d.ts +22 -22
  49. package/dist/cjs/runtime/index.js +28 -28
  50. package/dist/cjs/runtime/index.test.js +34 -34
  51. package/dist/cjs/runtime/sendEmailParamsTypes.test-d.js +29 -29
  52. package/dist/cjs/runtime/writeResultTypes.test-d.js +8 -8
  53. package/dist/cjs/sourceRoots.js +15 -15
  54. package/dist/cjs/sourceRoots.test.js +29 -27
  55. package/dist/cjs/start/build/entries.d.ts +25 -0
  56. package/dist/cjs/start/build/entries.js +121 -0
  57. package/dist/cjs/start/build/placeholders/devApp.d.ts +1 -0
  58. package/dist/cjs/start/build/placeholders/devApp.js +6 -0
  59. package/dist/cjs/start/describe/describeBuilt.d.ts +5 -0
  60. package/dist/cjs/start/describe/describeBuilt.js +144 -0
  61. package/dist/cjs/start/platform/aiUsage.d.ts +29 -0
  62. package/dist/cjs/start/platform/aiUsage.js +215 -0
  63. package/dist/cjs/start/platform/airtable/cache.d.ts +17 -0
  64. package/dist/cjs/start/platform/airtable/cache.js +93 -0
  65. package/dist/cjs/start/protocol.d.ts +19 -0
  66. package/dist/cjs/start/protocol.js +33 -0
  67. package/dist/cjs/start/serve/local/provider.d.ts +25 -0
  68. package/dist/cjs/start/serve/local/provider.js +196 -0
  69. package/dist/cjs/start/serve/provider.d.ts +19 -0
  70. package/dist/cjs/start/serve/provider.js +86 -0
  71. package/dist/cjs/start/types.d.ts +373 -0
  72. package/dist/cjs/start/types.js +2 -0
  73. package/dist/cjs/steps/index.d.ts +8 -8
  74. package/dist/cjs/steps/index.js +53 -53
  75. package/dist/cjs/steps/index.test.js +218 -218
  76. package/dist/cjs/sync/index.d.ts +1 -1
  77. package/dist/cjs/sync/index.js +28 -27
  78. package/dist/cjs/sync/lib.d.ts +15 -8
  79. package/dist/cjs/sync/lib.js +651 -665
  80. package/dist/cjs/sync/lib.test.js +81 -14
  81. package/dist/cjs/sync/sdkNames.d.ts +67 -9
  82. package/dist/cjs/sync/sdkNames.js +97 -31
  83. package/dist/cjs/sync/sdkNames.test.js +189 -113
  84. package/dist/cjs/types/fields.d.ts +1 -1
  85. package/dist/cjs/types/fields.js +105 -97
  86. package/dist/cjs/types/index.d.ts +2 -2
  87. package/dist/cjs/types/tables.d.ts +1 -1
  88. package/dist/cjs/upload/index.js +89 -24
  89. package/dist/cjs/upload/index.test.js +104 -1
  90. package/dist/cjs/vite/domTagNames.js +252 -252
  91. package/dist/cjs/vite/index.d.ts +1 -1
  92. package/dist/cjs/vite/index.js +51 -42
  93. package/dist/cjs/vite/index.test.js +10 -2
  94. package/dist/esm/auth/actions.d.ts +28 -0
  95. package/dist/esm/auth/actions.js +55 -0
  96. package/dist/esm/auth/client.d.ts +357 -0
  97. package/dist/esm/auth/client.js +62 -0
  98. package/dist/esm/auth/config.js +9 -3
  99. package/dist/esm/auth/index.d.ts +2 -249
  100. package/dist/esm/auth/index.js +2 -103
  101. package/dist/esm/auth/index.test.js +60 -0
  102. package/dist/esm/auth/previewClaim.d.ts +7 -0
  103. package/dist/esm/auth/previewClaim.js +12 -0
  104. package/dist/esm/auth/profileUpdates.d.ts +9 -0
  105. package/dist/esm/auth/profileUpdates.js +6 -0
  106. package/dist/esm/backend/index.d.ts +6 -6
  107. package/dist/esm/backend/index.js +13 -13
  108. package/dist/esm/backend/index.test.js +106 -106
  109. package/dist/esm/bundle/index.js +29 -16
  110. package/dist/esm/caller/index.js +44 -44
  111. package/dist/esm/check/index.d.ts +44 -1
  112. package/dist/esm/check/index.js +194 -61
  113. package/dist/esm/check/start/routeTree.d.ts +8 -0
  114. package/dist/esm/check/start/routeTree.js +77 -0
  115. package/dist/esm/check/start/tsgo.d.ts +2 -0
  116. package/dist/esm/check/start/tsgo.js +29 -0
  117. package/dist/esm/cli.js +19 -6
  118. package/dist/esm/client/index.d.ts +2 -2
  119. package/dist/esm/client/index.js +25 -25
  120. package/dist/esm/dev/index.js +88 -60
  121. package/dist/esm/dev/signin.d.ts +16 -0
  122. package/dist/esm/dev/signin.js +80 -0
  123. package/dist/esm/index.d.ts +5 -5
  124. package/dist/esm/index.js +3 -3
  125. package/dist/esm/integrations/client.d.ts +3 -3
  126. package/dist/esm/integrations/client.js +6 -5
  127. package/dist/esm/integrations/client.test-d.js +19 -19
  128. package/dist/esm/integrations/index.d.ts +2 -2
  129. package/dist/esm/integrations/index.js +1 -1
  130. package/dist/esm/integrations/rules.js +42 -42
  131. package/dist/esm/integrations/rules.test.js +62 -57
  132. package/dist/esm/internal/appMode.d.ts +14 -0
  133. package/dist/esm/internal/appMode.js +13 -0
  134. package/dist/esm/internal/env.js +3 -2
  135. package/dist/esm/internal/platformFetch.d.ts +2 -0
  136. package/dist/esm/internal/platformFetch.js +9 -0
  137. package/dist/esm/internal/reservedIds.d.ts +8 -0
  138. package/dist/esm/internal/reservedIds.js +10 -0
  139. package/dist/esm/internal/serviceUrls.d.ts +5 -0
  140. package/dist/esm/internal/serviceUrls.js +10 -0
  141. package/dist/esm/pdf/index.js +2 -1
  142. package/dist/esm/runtime/filterConditionTypes.test-d.js +12 -12
  143. package/dist/esm/runtime/index.d.ts +22 -22
  144. package/dist/esm/runtime/index.js +31 -31
  145. package/dist/esm/runtime/index.test.js +36 -36
  146. package/dist/esm/runtime/sendEmailParamsTypes.test-d.js +30 -30
  147. package/dist/esm/runtime/writeResultTypes.test-d.js +9 -9
  148. package/dist/esm/signin/conformance.d.ts +100 -0
  149. package/dist/esm/signin/conformance.js +616 -0
  150. package/dist/esm/signin/cookies.d.ts +28 -0
  151. package/dist/esm/signin/cookies.js +67 -0
  152. package/dist/esm/signin/encoding.d.ts +1 -0
  153. package/dist/esm/signin/encoding.js +12 -0
  154. package/dist/esm/signin/endpoints.d.ts +12 -0
  155. package/dist/esm/signin/endpoints.js +32 -0
  156. package/dist/esm/signin/http.d.ts +25 -0
  157. package/dist/esm/signin/http.js +106 -0
  158. package/dist/esm/signin/index.d.ts +8 -0
  159. package/dist/esm/signin/index.js +9 -0
  160. package/dist/esm/signin/keys.d.ts +35 -0
  161. package/dist/esm/signin/keys.js +230 -0
  162. package/dist/esm/signin/paths.d.ts +2 -0
  163. package/dist/esm/signin/paths.js +5 -0
  164. package/dist/esm/signin/seal.d.ts +19 -0
  165. package/dist/esm/signin/seal.js +47 -0
  166. package/dist/esm/signin/signin.d.ts +60 -0
  167. package/dist/esm/signin/signin.js +447 -0
  168. package/dist/esm/signin/transport.d.ts +112 -0
  169. package/dist/esm/signin/transport.js +1 -0
  170. package/dist/esm/signin/verifier.d.ts +2 -0
  171. package/dist/esm/signin/verifier.js +4 -0
  172. package/dist/esm/signin/verify.d.ts +83 -0
  173. package/dist/esm/signin/verify.js +142 -0
  174. package/dist/esm/sourceRoots.js +17 -17
  175. package/dist/esm/sourceRoots.test.js +34 -32
  176. package/dist/esm/start/access.d.ts +19 -0
  177. package/dist/esm/start/access.js +43 -0
  178. package/dist/esm/start/auth.d.ts +28 -0
  179. package/dist/esm/start/auth.js +33 -0
  180. package/dist/esm/start/automations/quiet.d.ts +2 -0
  181. package/dist/esm/start/automations/quiet.js +36 -0
  182. package/dist/esm/start/automations/registration.d.ts +13 -0
  183. package/dist/esm/start/automations/registration.js +25 -0
  184. package/dist/esm/start/automations/steps.d.ts +29 -0
  185. package/dist/esm/start/automations/steps.js +95 -0
  186. package/dist/esm/start/automations/workflow.d.ts +83 -0
  187. package/dist/esm/start/automations/workflow.js +36 -0
  188. package/dist/esm/start/automations/workflow.test-d.d.ts +1 -0
  189. package/dist/esm/start/automations/workflow.test-d.js +130 -0
  190. package/dist/esm/start/automations/workflowRun.d.ts +130 -0
  191. package/dist/esm/start/automations/workflowRun.js +185 -0
  192. package/dist/esm/start/barrel.test-d.d.ts +10 -0
  193. package/dist/esm/start/barrel.test-d.js +6 -0
  194. package/dist/esm/start/build/entries.d.ts +25 -0
  195. package/dist/esm/start/build/entries.js +109 -0
  196. package/dist/esm/start/build/placeholders/authHooksModule.d.ts +1 -0
  197. package/dist/esm/start/build/placeholders/authHooksModule.js +3 -0
  198. package/dist/esm/start/build/placeholders/devApp.d.ts +1 -0
  199. package/dist/esm/start/build/placeholders/devApp.js +3 -0
  200. package/dist/esm/start/build/placeholders/devSignIn.d.ts +1 -0
  201. package/dist/esm/start/build/placeholders/devSignIn.js +3 -0
  202. package/dist/esm/start/build/placeholders/siteHead.d.ts +2 -0
  203. package/dist/esm/start/build/placeholders/siteHead.js +3 -0
  204. package/dist/esm/start/build/placeholders/workflowModules.d.ts +1 -0
  205. package/dist/esm/start/build/placeholders/workflowModules.js +3 -0
  206. package/dist/esm/start/build/placeholders/workspaceSchema.d.ts +2 -0
  207. package/dist/esm/start/build/placeholders/workspaceSchema.js +3 -0
  208. package/dist/esm/start/build/registrationHash.d.ts +11 -0
  209. package/dist/esm/start/build/registrationHash.js +88 -0
  210. package/dist/esm/start/build/sdk/axios.d.ts +76 -0
  211. package/dist/esm/start/build/sdk/axios.js +253 -0
  212. package/dist/esm/start/build/sdk/nodeFetch.d.ts +41 -0
  213. package/dist/esm/start/build/sdk/nodeFetch.js +35 -0
  214. package/dist/esm/start/build/sdk/undici.d.ts +34 -0
  215. package/dist/esm/start/build/sdk/undici.js +18 -0
  216. package/dist/esm/start/build/sdkPatches.d.ts +22 -0
  217. package/dist/esm/start/build/sdkPatches.js +430 -0
  218. package/dist/esm/start/build/siteHead.d.ts +26 -0
  219. package/dist/esm/start/build/siteHead.js +88 -0
  220. package/dist/esm/start/build/vite.d.ts +50 -0
  221. package/dist/esm/start/build/vite.js +487 -0
  222. package/dist/esm/start/classicOnly.d.ts +1 -0
  223. package/dist/esm/start/classicOnly.js +4 -0
  224. package/dist/esm/start/clientErrorMessage.test.d.ts +1 -0
  225. package/dist/esm/start/clientErrorMessage.test.js +105 -0
  226. package/dist/esm/start/describe/describe.d.ts +120 -0
  227. package/dist/esm/start/describe/describe.js +372 -0
  228. package/dist/esm/start/describe/describeBuilt.d.ts +5 -0
  229. package/dist/esm/start/describe/describeBuilt.js +102 -0
  230. package/dist/esm/start/describe/descriptions.d.ts +4 -0
  231. package/dist/esm/start/describe/descriptions.js +54 -0
  232. package/dist/esm/start/errors.d.ts +62 -0
  233. package/dist/esm/start/errors.js +163 -0
  234. package/dist/esm/start/errors.test.d.ts +1 -0
  235. package/dist/esm/start/errors.test.js +54 -0
  236. package/dist/esm/start/factories.d.ts +14 -0
  237. package/dist/esm/start/factories.js +23 -0
  238. package/dist/esm/start/factories.test-d.d.ts +2 -0
  239. package/dist/esm/start/factories.test-d.js +60 -0
  240. package/dist/esm/start/failures.d.ts +7 -0
  241. package/dist/esm/start/failures.js +62 -0
  242. package/dist/esm/start/fnFactory.d.ts +16 -0
  243. package/dist/esm/start/fnFactory.js +1 -0
  244. package/dist/esm/start/host.d.ts +3 -0
  245. package/dist/esm/start/host.js +4 -0
  246. package/dist/esm/start/index.d.ts +10 -0
  247. package/dist/esm/start/index.js +7 -0
  248. package/dist/esm/start/login.d.ts +5 -0
  249. package/dist/esm/start/login.js +29 -0
  250. package/dist/esm/start/middlewareKind.d.ts +13 -0
  251. package/dist/esm/start/middlewareKind.js +9 -0
  252. package/dist/esm/start/platform/aiUsage.d.ts +29 -0
  253. package/dist/esm/start/platform/aiUsage.js +210 -0
  254. package/dist/esm/start/platform/airtable/arrayFields.d.ts +10 -0
  255. package/dist/esm/start/platform/airtable/arrayFields.js +30 -0
  256. package/dist/esm/start/platform/airtable/built.d.ts +2 -0
  257. package/dist/esm/start/platform/airtable/built.js +3 -0
  258. package/dist/esm/start/platform/airtable/cache.d.ts +17 -0
  259. package/dist/esm/start/platform/airtable/cache.js +89 -0
  260. package/dist/esm/start/platform/airtable/dispatch.d.ts +57 -0
  261. package/dist/esm/start/platform/airtable/dispatch.js +541 -0
  262. package/dist/esm/start/platform/airtable/formulas.d.ts +70 -0
  263. package/dist/esm/start/platform/airtable/formulas.js +261 -0
  264. package/dist/esm/start/platform/airtable/index.d.ts +6 -0
  265. package/dist/esm/start/platform/airtable/index.js +51 -0
  266. package/dist/esm/start/platform/airtable/settings.d.ts +37 -0
  267. package/dist/esm/start/platform/airtable/settings.js +138 -0
  268. package/dist/esm/start/platform/analytics.d.ts +3 -0
  269. package/dist/esm/start/platform/analytics.js +59 -0
  270. package/dist/esm/start/platform/calls.d.ts +5 -0
  271. package/dist/esm/start/platform/calls.js +104 -0
  272. package/dist/esm/start/platform/caps.d.ts +9 -0
  273. package/dist/esm/start/platform/caps.js +35 -0
  274. package/dist/esm/start/platform/connections.d.ts +25 -0
  275. package/dist/esm/start/platform/connections.js +198 -0
  276. package/dist/esm/start/platform/data/baseRunner.d.ts +97 -0
  277. package/dist/esm/start/platform/data/baseRunner.js +117 -0
  278. package/dist/esm/start/platform/data/dispatch.d.ts +17 -0
  279. package/dist/esm/start/platform/data/dispatch.js +216 -0
  280. package/dist/esm/start/platform/data/fetch.d.ts +7 -0
  281. package/dist/esm/start/platform/data/fetch.js +9 -0
  282. package/dist/esm/start/platform/data/index.d.ts +27 -0
  283. package/dist/esm/start/platform/data/index.js +75 -0
  284. package/dist/esm/start/platform/data/names.d.ts +7 -0
  285. package/dist/esm/start/platform/data/names.js +18 -0
  286. package/dist/esm/start/platform/data/sqlNameMappings.d.ts +58 -0
  287. package/dist/esm/start/platform/data/sqlNameMappings.js +92 -0
  288. package/dist/esm/start/platform/data/transformations.d.ts +97 -0
  289. package/dist/esm/start/platform/data/transformations.js +262 -0
  290. package/dist/esm/start/platform/data/types.d.ts +94 -0
  291. package/dist/esm/start/platform/data/types.js +14 -0
  292. package/dist/esm/start/platform/local.d.ts +6 -0
  293. package/dist/esm/start/platform/local.js +18 -0
  294. package/dist/esm/start/platform/meta.d.ts +3 -0
  295. package/dist/esm/start/platform/meta.js +33 -0
  296. package/dist/esm/start/platform/outbound.d.ts +17 -0
  297. package/dist/esm/start/platform/outbound.js +510 -0
  298. package/dist/esm/start/platform/redactSecrets.d.ts +13 -0
  299. package/dist/esm/start/platform/redactSecrets.js +156 -0
  300. package/dist/esm/start/platform/redactSecrets.test.d.ts +1 -0
  301. package/dist/esm/start/platform/redactSecrets.test.js +151 -0
  302. package/dist/esm/start/platform/requestSecrets.d.ts +15 -0
  303. package/dist/esm/start/platform/requestSecrets.js +41 -0
  304. package/dist/esm/start/platform/runLog.d.ts +40 -0
  305. package/dist/esm/start/platform/runLog.js +149 -0
  306. package/dist/esm/start/platform/services.d.ts +7 -0
  307. package/dist/esm/start/platform/services.js +46 -0
  308. package/dist/esm/start/platform/steps.d.ts +9 -0
  309. package/dist/esm/start/platform/steps.js +60 -0
  310. package/dist/esm/start/platform/telemetry.d.ts +13 -0
  311. package/dist/esm/start/platform/telemetry.js +71 -0
  312. package/dist/esm/start/platform/transport.d.ts +28 -0
  313. package/dist/esm/start/platform/transport.js +59 -0
  314. package/dist/esm/start/platformHead.d.ts +23 -0
  315. package/dist/esm/start/platformHead.js +133 -0
  316. package/dist/esm/start/previewClaim.d.ts +6 -0
  317. package/dist/esm/start/previewClaim.js +24 -0
  318. package/dist/esm/start/protocol.d.ts +19 -0
  319. package/dist/esm/start/protocol.js +27 -0
  320. package/dist/esm/start/roles.d.ts +12 -0
  321. package/dist/esm/start/roles.js +27 -0
  322. package/dist/esm/start/router.d.ts +44 -0
  323. package/dist/esm/start/router.js +280 -0
  324. package/dist/esm/start/serve/authHooks.d.ts +7 -0
  325. package/dist/esm/start/serve/authHooks.js +18 -0
  326. package/dist/esm/start/serve/demo.d.ts +9 -0
  327. package/dist/esm/start/serve/demo.js +24 -0
  328. package/dist/esm/start/serve/fetch.d.ts +1 -0
  329. package/dist/esm/start/serve/fetch.js +6 -0
  330. package/dist/esm/start/serve/instance.d.ts +12 -0
  331. package/dist/esm/start/serve/instance.js +134 -0
  332. package/dist/esm/start/serve/invoke.d.ts +13 -0
  333. package/dist/esm/start/serve/invoke.js +126 -0
  334. package/dist/esm/start/serve/local/load.d.ts +8 -0
  335. package/dist/esm/start/serve/local/load.js +44 -0
  336. package/dist/esm/start/serve/local/provider.d.ts +25 -0
  337. package/dist/esm/start/serve/local/provider.js +188 -0
  338. package/dist/esm/start/serve/local/signIn.d.ts +28 -0
  339. package/dist/esm/start/serve/local/signIn.js +123 -0
  340. package/dist/esm/start/serve/pageHead.d.ts +20 -0
  341. package/dist/esm/start/serve/pageHead.js +34 -0
  342. package/dist/esm/start/serve/provider.d.ts +19 -0
  343. package/dist/esm/start/serve/provider.js +78 -0
  344. package/dist/esm/start/serve/requestEnv.d.ts +2 -0
  345. package/dist/esm/start/serve/requestEnv.js +84 -0
  346. package/dist/esm/start/serve/scope.d.ts +18 -0
  347. package/dist/esm/start/serve/scope.js +67 -0
  348. package/dist/esm/start/serve/server.d.ts +56 -0
  349. package/dist/esm/start/serve/server.js +297 -0
  350. package/dist/esm/start/serve/uploads.d.ts +2 -0
  351. package/dist/esm/start/serve/uploads.js +49 -0
  352. package/dist/esm/start/serve/worker.d.ts +6 -0
  353. package/dist/esm/start/serve/worker.js +12 -0
  354. package/dist/esm/start/types.d.ts +373 -0
  355. package/dist/esm/start/types.js +1 -0
  356. package/dist/esm/start/version.d.ts +1 -0
  357. package/dist/esm/start/version.js +2 -0
  358. package/dist/esm/steps/index.d.ts +8 -8
  359. package/dist/esm/steps/index.js +54 -54
  360. package/dist/esm/steps/index.test.js +220 -220
  361. package/dist/esm/sync/index.d.ts +1 -1
  362. package/dist/esm/sync/index.js +32 -31
  363. package/dist/esm/sync/lib.d.ts +15 -8
  364. package/dist/esm/sync/lib.js +655 -669
  365. package/dist/esm/sync/lib.test.js +81 -14
  366. package/dist/esm/sync/sdkNames.d.ts +67 -9
  367. package/dist/esm/sync/sdkNames.js +94 -30
  368. package/dist/esm/sync/sdkNames.test.js +192 -116
  369. package/dist/esm/types/fields.d.ts +1 -1
  370. package/dist/esm/types/fields.js +106 -98
  371. package/dist/esm/types/index.d.ts +2 -2
  372. package/dist/esm/types/index.js +2 -2
  373. package/dist/esm/types/tables.d.ts +1 -1
  374. package/dist/esm/types/tables.js +2 -2
  375. package/dist/esm/upload/index.js +89 -24
  376. package/dist/esm/upload/index.test.js +104 -1
  377. package/dist/esm/vite/domTagNames.js +252 -252
  378. package/dist/esm/vite/index.d.ts +1 -1
  379. package/dist/esm/vite/index.js +56 -47
  380. package/dist/esm/vite/index.test.js +10 -2
  381. package/package.json +129 -16
  382. package/dist/cjs/auth-server/index.d.ts +0 -369
  383. package/dist/cjs/auth-server/index.js +0 -119
  384. package/dist/cjs/meta/index.d.ts +0 -14
  385. package/dist/cjs/meta/index.js +0 -12
  386. package/dist/cjs/notifications/index.d.ts +0 -25
  387. package/dist/cjs/notifications/index.js +0 -12
  388. package/dist/esm/auth-server/index.d.ts +0 -369
  389. package/dist/esm/auth-server/index.js +0 -116
  390. package/dist/esm/meta/index.d.ts +0 -14
  391. package/dist/esm/meta/index.js +0 -8
  392. package/dist/esm/notifications/index.d.ts +0 -25
  393. package/dist/esm/notifications/index.js +0 -8
@@ -13,7 +13,6 @@ exports.generateIntegrationsIndex = generateIntegrationsIndex;
13
13
  const parser_1 = require("@babel/parser");
14
14
  const sdkNames_js_1 = require("./sdkNames.js");
15
15
  const rules_js_1 = require("../integrations/rules.js");
16
- const AUTH_USERS_TABLE_ID = "zite_user";
17
16
  /**
18
17
  * What a field's value looks like when a record is READ back.
19
18
  *
@@ -44,65 +43,65 @@ const AUTH_USERS_TABLE_ID = "zite_user";
44
43
  */
45
44
  const FIELD_TYPE_MAP = {
46
45
  // Text: NULL is rewritten to '' on read, so these are never even absent.
47
- single_line_text: "string",
48
- long_text: "string",
49
- rich_text: "string",
50
- email: "string",
51
- url: "string",
52
- phone_number: "string",
53
- number: "number",
54
- currency: "number",
55
- percent: "number",
56
- rating: "number",
46
+ single_line_text: 'string',
47
+ long_text: 'string',
48
+ rich_text: 'string',
49
+ email: 'string',
50
+ url: 'string',
51
+ phone_number: 'string',
52
+ number: 'number',
53
+ currency: 'number',
54
+ percent: 'number',
55
+ rating: 'number',
57
56
  // DECIMAL seconds, unlike Airtable's, which is formatted to "HH:mm:ss".
58
57
  // 1.0 typed this `string`, which was simply wrong — base-runner groups it
59
58
  // with the numeric types — so it stays a number rather than reverting.
60
- duration: "number",
61
- checkbox: "boolean",
62
- single_select: "string",
63
- multiple_select: "string[]",
64
- date: "string",
65
- datetime: "string",
66
- attachments: "ZiteAttachment[]",
59
+ duration: 'number',
60
+ checkbox: 'boolean',
61
+ single_select: 'string',
62
+ multiple_select: 'string[]',
63
+ date: 'string',
64
+ datetime: 'string',
65
+ attachments: 'ZiteAttachment[]',
67
66
  // `string | string[]`, matching the pre-monorepo type. base-runner does force
68
67
  // an array on read today, but 1.0 code is written with `typeof x === 'string'`
69
68
  // guards — narrowing to `string[]` turns those branches into `never` and
70
69
  // fails the app's typecheck for no gain.
71
- linked_record: "string | string[]",
72
- user: "string | string[]",
70
+ linked_record: 'string | string[]',
71
+ user: 'string | string[]',
73
72
  // `any`, not `unknown`, and deliberately: these are values the platform
74
73
  // cannot type — a lookup is whatever the far side holds. 1.0 said `any`, and
75
74
  // `unknown` buys nothing because there is no narrowing an app could have
76
75
  // written in advance: `sum + (x || 0)` is a TS2365 on `unknown`, and the
77
76
  // guarded spellings already narrowed fine under `any`.
78
- lookup: "any",
79
- rollup: "any",
80
- autonumber: "number",
77
+ lookup: 'any',
78
+ rollup: 'any',
79
+ autonumber: 'number',
81
80
  // JSONB change metadata (`{ type: "PublicAPI", apiKeyId: 3 }`), not a string.
82
- source: "any",
83
- formula: "any",
84
- created_at: "string",
85
- updated_at: "string",
86
- created_by: "string",
87
- updated_by: "string",
81
+ source: 'any',
82
+ formula: 'any',
83
+ created_at: 'string',
84
+ updated_at: 'string',
85
+ created_by: 'string',
86
+ updated_by: 'string',
88
87
  };
89
88
  /**
90
89
  * Field types whose WRITE shape differs from their read shape — the API accepts
91
90
  * looser input than it stores.
92
91
  */
93
92
  const FIELD_INPUT_TYPE_MAP = {
94
- attachments: "ZiteAttachmentInput[] | ZiteAttachmentInput",
95
- linked_record: "string | string[]",
96
- user: "string | string[]",
97
- multiple_select: "string | string[]",
98
- date: "string | Date",
99
- datetime: "string | Date",
100
- number: "string | number",
101
- currency: "string | number",
102
- percent: "string | number",
103
- rating: "string | number",
104
- duration: "string | number",
105
- checkbox: "string | boolean",
93
+ attachments: 'ZiteAttachmentInput[] | ZiteAttachmentInput',
94
+ linked_record: 'string | string[]',
95
+ user: 'string | string[]',
96
+ multiple_select: 'string | string[]',
97
+ date: 'string | Date',
98
+ datetime: 'string | Date',
99
+ number: 'string | number',
100
+ currency: 'string | number',
101
+ percent: 'string | number',
102
+ rating: 'string | number',
103
+ duration: 'string | number',
104
+ checkbox: 'string | boolean',
106
105
  };
107
106
  /**
108
107
  * Computed and system-managed fields, omitted from the generated input type
@@ -116,15 +115,15 @@ const FIELD_INPUT_TYPE_MAP = {
116
115
  * leave typed as writable.
117
116
  */
118
117
  const READ_ONLY_FIELD_TYPES = new Set([
119
- "lookup",
120
- "rollup",
121
- "source",
122
- "formula",
123
- "autonumber",
124
- "created_by",
125
- "updated_by",
126
- "created_at",
127
- "updated_at",
118
+ 'lookup',
119
+ 'rollup',
120
+ 'source',
121
+ 'formula',
122
+ 'autonumber',
123
+ 'created_by',
124
+ 'updated_by',
125
+ 'created_at',
126
+ 'updated_at',
128
127
  ]);
129
128
  /**
130
129
  * Emitted once per `db.ts`. The old inline `{ url: string; name?: string }` was
@@ -132,28 +131,28 @@ const READ_ONLY_FIELD_TYPES = new Set([
132
131
  * `filename` / `originalName`), and the other six read properties were missing.
133
132
  */
134
133
  const ATTACHMENT_TYPES = [
135
- "/** An attachment as returned when reading a record. */",
136
- "export type ZiteAttachment = {",
137
- " /** Original filename as uploaded. */",
138
- " filename: string;",
139
- " /** Display name — may differ from `filename`. */",
140
- " originalName: string;",
141
- " /** File size in bytes. */",
142
- " size: number;",
143
- " mimeType: string;",
144
- " /** Publicly accessible URL. */",
145
- " url: string;",
146
- " /** ISO timestamp of the upload. */",
147
- " uploadedAt: string;",
148
- " metadata?: Record<string, unknown>;",
149
- "};",
150
- "",
151
- "/** What you may write to an attachments field: a URL, a URL with a name, or an attachment you read earlier. */",
152
- "export type ZiteAttachmentInput =",
153
- " | string",
154
- " | { url: string; filename?: string }",
155
- " | ZiteAttachment;",
156
- "",
134
+ '/** An attachment as returned when reading a record. */',
135
+ 'export type ZiteAttachment = {',
136
+ ' /** Original filename as uploaded. */',
137
+ ' filename: string;',
138
+ ' /** Display name — may differ from `filename`. */',
139
+ ' originalName: string;',
140
+ ' /** File size in bytes. */',
141
+ ' size: number;',
142
+ ' mimeType: string;',
143
+ ' /** Publicly accessible URL. */',
144
+ ' url: string;',
145
+ ' /** ISO timestamp of the upload. */',
146
+ ' uploadedAt: string;',
147
+ ' metadata?: Record<string, unknown>;',
148
+ '};',
149
+ '',
150
+ '/** What you may write to an attachments field: a URL, a URL with a name, or an attachment you read earlier. */',
151
+ 'export type ZiteAttachmentInput =',
152
+ ' | string',
153
+ ' | { url: string; filename?: string }',
154
+ ' | ZiteAttachment;',
155
+ '',
157
156
  ];
158
157
  const MAX_SELECT_OPTIONS = 100;
159
158
  /**
@@ -180,30 +179,30 @@ const tsSingleQuoted = (value) => `'${JSON.stringify(value).slice(1, -1).replace
180
179
  * Applied where the comment is written rather than at each contributor, so
181
180
  * anything added to one later is covered by default.
182
181
  */
183
- const commentSafe = (value) => value.replace(/\*\//g, "* /").replace(/\s+/g, " ").trim();
182
+ const commentSafe = (value) => value.replace(/\*\//g, '* /').replace(/\s+/g, ' ').trim();
184
183
  const NUMBER_FORMAT_EXAMPLES = {
185
- local: "1,000,000.50",
186
- comma_period: "1,000,000.50",
187
- period_comma: "1.000.000,50",
188
- space_comma: "1 000 000,50",
189
- space_period: "1 000 000.50",
190
- no_separator: "1000000.50",
184
+ local: '1,000,000.50',
185
+ comma_period: '1,000,000.50',
186
+ period_comma: '1.000.000,50',
187
+ space_comma: '1 000 000,50',
188
+ space_period: '1 000 000.50',
189
+ no_separator: '1000000.50',
191
190
  };
192
191
  const DURATION_FORMAT_EXAMPLES = {
193
- "h:mm": "1:23",
194
- "h:mm:ss": "1:23:03",
195
- "h:mm:ss.s": "1:23:03.0",
196
- "h:mm:ss.ss": "1:23:03.00",
197
- "h:mm:ss.sss": "1:23:03.000",
192
+ 'h:mm': '1:23',
193
+ 'h:mm:ss': '1:23:03',
194
+ 'h:mm:ss.s': '1:23:03.0',
195
+ 'h:mm:ss.ss': '1:23:03.00',
196
+ 'h:mm:ss.sss': '1:23:03.000',
198
197
  };
199
198
  // Naming the format alone ("display as `european` format") doesn't say what to
200
199
  // render — these mirror the pickers in the database UI, which is what the user
201
200
  // chose from. `local` is the viewer's system locale, so it has no fixed example.
202
201
  const DATE_FORMAT_EXAMPLES = {
203
- long: "January 15, 2024",
204
- us: "1/15/2024",
205
- european: "15/01/2024",
206
- iso: "2024-01-15",
202
+ long: 'January 15, 2024',
203
+ us: '1/15/2024',
204
+ european: '15/01/2024',
205
+ iso: '2024-01-15',
207
206
  };
208
207
  const withDateFormatExample = (format) => {
209
208
  const example = DATE_FORMAT_EXAMPLES[format];
@@ -223,29 +222,29 @@ Object.defineProperty(exports, "toSdkName", { enumerable: true, get: function ()
223
222
  * `allowExplicitNull`. A write type without it makes the documented way to
224
223
  * empty a field a compile error.
225
224
  */
226
- const withNull = (type) => type.includes("null") ? type : `${type} | null`;
227
- function tsTypeForSchemaField(def, variant = "read") {
228
- if (def.type === "single_select" || def.type === "multiple_select") {
225
+ const withNull = (type) => type.includes('null') ? type : `${type} | null`;
226
+ function tsTypeForSchemaField(def, variant = 'read') {
227
+ if (def.type === 'single_select' || def.type === 'multiple_select') {
229
228
  const options = def.template
230
229
  ?.options;
231
230
  if (options && options.length > 0) {
232
231
  const literals = options
233
232
  .slice(0, MAX_SELECT_OPTIONS)
234
- .map((o) => tsStringLiteral(o.label))
235
- .join(" | ");
233
+ .map(o => tsStringLiteral(o.label))
234
+ .join(' | ');
236
235
  const union = `${literals} | string`;
237
236
  // No `| null` on the read side — see FIELD_TYPE_MAP. The write side keeps
238
237
  // it below, since null is how a select cell is cleared.
239
- const read = def.type === "multiple_select" ? `(${union})[]` : union;
240
- if (variant === "write") {
241
- return def.type === "multiple_select"
238
+ const read = def.type === 'multiple_select' ? `(${union})[]` : union;
239
+ if (variant === 'write') {
240
+ return def.type === 'multiple_select'
242
241
  ? `${union} | (${union})[] | null`
243
242
  : `${union} | null`;
244
243
  }
245
244
  return read;
246
245
  }
247
246
  }
248
- if (variant === "write") {
247
+ if (variant === 'write') {
249
248
  const write = FIELD_INPUT_TYPE_MAP[def.type] ?? FIELD_TYPE_MAP[def.type];
250
249
  if (write)
251
250
  return withNull(write);
@@ -255,43 +254,38 @@ function tsTypeForSchemaField(def, variant = "read") {
255
254
  // Not `string`. A field type this generator doesn't know about is not a
256
255
  // string just because most of them are — asserting one lets `record.value`
257
256
  // silently pass as `string` everywhere it flows.
258
- return "unknown";
257
+ return 'unknown';
259
258
  }
260
259
  function fieldJsdoc(schemaField, table, schema) {
261
260
  const def = schemaField.definition;
262
261
  const parts = [];
263
262
  if (table.primaryFieldId === schemaField.id)
264
- parts.push("Primary field");
265
- if (def.type === "created_at" ||
266
- def.type === "updated_at" ||
267
- def.type === "lookup" ||
268
- def.type === "formula" ||
269
- def.type === "autonumber") {
270
- parts.push("Read-only");
271
- }
272
- if (def.type === "linked_record") {
263
+ parts.push('Primary field');
264
+ if (READ_ONLY_FIELD_TYPES.has(def.type))
265
+ parts.push('Read-only');
266
+ if (def.type === 'linked_record') {
273
267
  const tpl = def.template;
274
268
  if (tpl.tableId) {
275
269
  // The SDK name, not the raw `tbl...` id — the id appears nowhere the
276
270
  // reader can act on, while the SDK name is the property on `zite`. Its
277
271
  // display name rides along, since after a rename the two differ.
278
- const linked = schema?.tables.find((t) => t.id === tpl.tableId);
272
+ const linked = schema?.tables.find(t => t.id === tpl.tableId);
279
273
  parts.push(linked
280
- ? `Links to ${linked.sdkName}${linked.name ? ` ("${linked.name}")` : ""}`
274
+ ? `Links to ${linked.sdkName}${linked.name ? ` ("${linked.name}")` : ''}`
281
275
  : `Links to ${tpl.tableId}`);
282
276
  }
283
277
  if (tpl.allowMultiple === false)
284
- parts.push("Single record only");
278
+ parts.push('Single record only');
285
279
  }
286
280
  parts.push(`"${def.name}"`);
287
- if (def.type === "date") {
281
+ if (def.type === 'date') {
288
282
  const tpl = def.template;
289
283
  if (tpl.dateFormat)
290
284
  parts.push(`Date-only field (YYYY-MM-DD string), null when unset, display as ${withDateFormatExample(tpl.dateFormat)}`);
291
285
  }
292
- if (def.type === "datetime") {
286
+ if (def.type === 'datetime') {
293
287
  const tpl = def.template;
294
- const timeParts = ["Date+time field (ISO 8601 timestamp), null when unset"];
288
+ const timeParts = ['Date+time field (ISO 8601 timestamp), null when unset'];
295
289
  if (tpl.dateFormat)
296
290
  timeParts.push(`date: ${withDateFormatExample(tpl.dateFormat)}`);
297
291
  if (tpl.timeFormat)
@@ -299,45 +293,45 @@ function fieldJsdoc(schemaField, table, schema) {
299
293
  if (tpl.timezone)
300
294
  timeParts.push(`tz: ${tpl.timezone}`);
301
295
  if (tpl.displayTimeZone)
302
- timeParts.push("timezone displayed to user");
303
- parts.push(timeParts.join(", "));
296
+ timeParts.push('timezone displayed to user');
297
+ parts.push(timeParts.join(', '));
304
298
  }
305
- if (def.type === "currency") {
299
+ if (def.type === 'currency') {
306
300
  const tpl = def.template;
307
301
  if (tpl.currencySymbol) {
308
- const formatHint = NUMBER_FORMAT_EXAMPLES[tpl.numberFormat ?? "local"] ?? "";
309
- parts.push(`Value is a raw number; display as currency with symbol "${tpl.currencySymbol}", ${tpl.decimalPlaces ?? 2} decimal places, format: ${tpl.numberFormat ?? "local"} (e.g. ${formatHint})`);
302
+ const formatHint = NUMBER_FORMAT_EXAMPLES[tpl.numberFormat ?? 'local'] ?? '';
303
+ parts.push(`Value is a raw number; display as currency with symbol "${tpl.currencySymbol}", ${tpl.decimalPlaces ?? 2} decimal places, format: ${tpl.numberFormat ?? 'local'} (e.g. ${formatHint})`);
310
304
  }
311
305
  }
312
- if (def.type === "number") {
306
+ if (def.type === 'number') {
313
307
  const tpl = def.template;
314
- const formatHint = NUMBER_FORMAT_EXAMPLES[tpl.numberFormat ?? "local"] ?? "";
315
- parts.push(`${tpl.decimalPlaces ?? 0} decimal places, format: ${tpl.numberFormat ?? "local"} (e.g. ${formatHint})`);
308
+ const formatHint = NUMBER_FORMAT_EXAMPLES[tpl.numberFormat ?? 'local'] ?? '';
309
+ parts.push(`${tpl.decimalPlaces ?? 0} decimal places, format: ${tpl.numberFormat ?? 'local'} (e.g. ${formatHint})`);
316
310
  }
317
- if (def.type === "percent") {
311
+ if (def.type === 'percent') {
318
312
  const tpl = def.template;
319
313
  if (tpl.decimalPlaces !== undefined)
320
314
  parts.push(`${tpl.decimalPlaces} decimal places`);
321
315
  }
322
- if (def.type === "duration") {
316
+ if (def.type === 'duration') {
323
317
  const tpl = def.template;
324
318
  if (tpl.format) {
325
- const example = DURATION_FORMAT_EXAMPLES[tpl.format] ?? "";
319
+ const example = DURATION_FORMAT_EXAMPLES[tpl.format] ?? '';
326
320
  parts.push(`Value is in seconds; display in "${tpl.format}" format (${example})`);
327
321
  }
328
322
  }
329
- if (def.type === "rating") {
323
+ if (def.type === 'rating') {
330
324
  const tpl = def.template;
331
325
  if (tpl.maxRating)
332
326
  parts.push(`Max rating: ${tpl.maxRating}`);
333
327
  }
334
- if (def.type === "created_at") {
335
- parts.push("Auto-set when record was created (ISO 8601)");
328
+ if (def.type === 'created_at') {
329
+ parts.push('Auto-set when record was created (ISO 8601)');
336
330
  }
337
- if (def.type === "updated_at") {
338
- parts.push("Auto-set when record was last modified (ISO 8601)");
331
+ if (def.type === 'updated_at') {
332
+ parts.push('Auto-set when record was last modified (ISO 8601)');
339
333
  }
340
- if ((def.type === "single_select" || def.type === "multiple_select") &&
334
+ if ((def.type === 'single_select' || def.type === 'multiple_select') &&
341
335
  def.template?.options) {
342
336
  const count = (def.template.options ?? [])
343
337
  .length;
@@ -347,7 +341,7 @@ function fieldJsdoc(schemaField, table, schema) {
347
341
  }
348
342
  if (parts.length <= 1)
349
343
  return undefined;
350
- return parts.join(". ");
344
+ return parts.join('. ');
351
345
  }
352
346
  /**
353
347
  * Build a ZiteSchema from a Database API response.
@@ -358,75 +352,49 @@ function fieldJsdoc(schemaField, table, schema) {
358
352
  * name stability across schema changes.
359
353
  */
360
354
  function generateSchema(database, existingSchema) {
361
- const existingTableById = new Map();
362
- for (const t of existingSchema?.tables ?? []) {
363
- existingTableById.set(t.id, t);
364
- }
365
- const drafts = [];
366
- for (const table of database.tables) {
367
- if (table.id === AUTH_USERS_TABLE_ID)
368
- continue;
369
- const existingTable = existingTableById.get(table.id);
370
- const existingFieldById = new Map();
371
- for (const f of existingTable?.fields ?? []) {
372
- existingFieldById.set(f.id, f);
355
+ // A name from the existing schema is locked: it is what the app is compiling
356
+ // against, and only moves if it is reserved or collides.
357
+ const { names, renames } = (0, sdkNames_js_1.allocateLiveNames)(database.tables, existingSchema);
358
+ if (renames.length > 0) {
359
+ // Never silent: a rename means the accessor a developer would reach for is
360
+ // not the one that got emitted.
361
+ for (const line of (0, sdkNames_js_1.describeRenames)(renames)) {
362
+ console.warn(`[zitejs] SDK name collision resolved: ${line}`);
373
363
  }
374
- // `sdkName` is filled in by `allocateSchemaNames` below; the draft carries
375
- // what each name would like to be and whether user code already depends on
376
- // it. A name from the existing schema is locked — it is what the app is
377
- // compiling against — and only moves if it is reserved or collides.
378
- const fields = table.fields.map((field) => {
379
- const existing = (0, sdkNames_js_1.keepValidSdkName)(existingFieldById.get(field.id)?.sdkName);
380
- const { id: _id, order: _order, ...definition } = field;
364
+ }
365
+ const liveTables = new Map(database.tables.map(table => [table.id, table]));
366
+ return {
367
+ tables: names.tables.map(named => {
368
+ const table = liveTables.get(named.id);
369
+ const liveFields = new Map(table.fields.map(field => [field.id, field]));
381
370
  return {
382
- field: { id: field.id, sdkName: "", definition },
383
- draft: {
384
- preferred: existing ?? (0, sdkNames_js_1.toSdkName)(field.name),
385
- locked: existing !== undefined,
386
- },
387
- };
388
- });
389
- const existingName = (0, sdkNames_js_1.keepValidSdkName)(existingTable?.sdkName);
390
- drafts.push({
391
- table: {
392
371
  id: table.id,
393
- sdkName: "",
372
+ sdkName: named.sdkName,
394
373
  // Always the live name — never `existingTable?.name`. Locking it the way
395
374
  // `sdkName` is locked would freeze it at the first name the table ever
396
375
  // had, which is the one thing this is here to avoid.
397
376
  name: table.name,
398
377
  primaryFieldId: table.primaryFieldId,
399
- fields: [],
400
- },
401
- draft: {
402
- preferred: existingName ?? (0, sdkNames_js_1.toSdkName)(table.name),
403
- locked: existingName !== undefined,
404
- },
405
- fields,
406
- });
407
- }
408
- const { tables, renames } = (0, sdkNames_js_1.allocateSchemaNames)(drafts);
409
- if (renames.length > 0) {
410
- // Never silent: a rename means the accessor a developer would reach for is
411
- // not the one that got emitted.
412
- for (const line of (0, sdkNames_js_1.describeRenames)(renames)) {
413
- console.warn(`[zitejs] SDK name collision resolved: ${line}`);
414
- }
415
- }
416
- return { tables };
378
+ fields: named.fields.map(namedField => {
379
+ const { id, order: _order, ...definition } = liveFields.get(namedField.id);
380
+ return { id, sdkName: namedField.sdkName, definition };
381
+ }),
382
+ };
383
+ }),
384
+ };
417
385
  }
418
386
  function generateSentinelSdkTypes() {
419
387
  return [
420
388
  // Must match `AuthUser` in zitejs/runtime and `User` in zitejs/auth.
421
- "export interface ZiteAuthUser {",
422
- " id: string;",
423
- " name: string;",
424
- " email: string;",
425
- " firstName?: string;",
426
- " lastName?: string;",
427
- " image: string | null;",
428
- "}",
429
- "",
389
+ 'export interface ZiteAuthUser {',
390
+ ' id: string;',
391
+ ' name: string;',
392
+ ' email: string;',
393
+ ' firstName?: string;',
394
+ ' lastName?: string;',
395
+ ' image: string | null;',
396
+ '}',
397
+ '',
430
398
  ];
431
399
  }
432
400
  function buildLinkTableComments(schema) {
@@ -444,7 +412,7 @@ function buildLinkTableComments(schema) {
444
412
  const entries = [];
445
413
  for (const table of schema.tables) {
446
414
  for (const field of table.fields) {
447
- if (field.definition.type !== "linked_record")
415
+ if (field.definition.type !== 'linked_record')
448
416
  continue;
449
417
  const tpl = field.definition.template;
450
418
  if (tpl.isInverse)
@@ -483,12 +451,12 @@ function buildLinkTableComments(schema) {
483
451
  if (entries.length === 0)
484
452
  return [];
485
453
  const lines = [
486
- "//",
487
- "// Link tables for zite.sql() JOINs (use these exact names):",
454
+ '//',
455
+ '// Link tables for zite.sql() JOINs (use these exact names):',
488
456
  ];
489
457
  for (const e of entries) {
490
458
  lines.push(`// "${commentSafe(e.name)}" — columns: "${commentSafe(e.cols[0])}", "${commentSafe(e.cols[1])}"` +
491
- (e.gloss ? ` (${commentSafe(e.gloss)})` : ""));
459
+ (e.gloss ? ` (${commentSafe(e.gloss)})` : ''));
492
460
  }
493
461
  return lines;
494
462
  }
@@ -496,7 +464,12 @@ function buildLinkTableComments(schema) {
496
464
  * Generate .zite/db.ts purely from ZiteSchema.
497
465
  * Pure function — no external data needed beyond what's in the schema file.
498
466
  */
499
- function generateDbTs(inputSchema) {
467
+ /**
468
+ * `hasStartApps` rewords the usage notes for a workspace where the code using
469
+ * the client isn't only classic endpoints. A classic-only workspace keeps the
470
+ * old wording, so its committed db.ts doesn't change.
471
+ */
472
+ function generateDbTs(inputSchema, { hasStartApps = false } = {}) {
500
473
  const lines = [];
501
474
  // Defensive, and idempotent: a schema whose names are already unique and
502
475
  // unreserved normalizes to itself. It matters for a `zite.schema.json`
@@ -510,68 +483,77 @@ function generateDbTs(inputSchema) {
510
483
  console.warn(`[zitejs] Repaired SDK name in zite.schema.json: ${line}`);
511
484
  }
512
485
  }
513
- const tables = schema.tables.filter((table) => table.id !== AUTH_USERS_TABLE_ID);
514
- lines.push("// Auto-generated by zitejs generate. Do not edit manually.");
515
- lines.push("//");
516
- lines.push("// Usage in endpoint files (src/api/*.ts):");
486
+ const tables = schema.tables.filter(table => table.id !== sdkNames_js_1.AUTH_USERS_TABLE_ID);
487
+ lines.push('// Auto-generated by zitejs generate. Do not edit manually.');
488
+ lines.push('//');
489
+ if (hasStartApps) {
490
+ lines.push("// Usage in server code: a classic app's endpoints (src/api/*.ts), or a Start");
491
+ lines.push("// app's server functions and *.server.ts files:");
492
+ }
493
+ else {
494
+ lines.push('// Usage in endpoint files (src/api/*.ts):');
495
+ }
517
496
  lines.push('// import { zite } from "zitejs/db";');
518
- lines.push("//");
497
+ lines.push('//');
519
498
  lines.push('// Always use "zitejs/db" — never use relative paths like "../../.zite/db".');
520
- lines.push("// The tsconfig aliases resolve zitejs/* imports to the correct .zite/ files.");
521
- lines.push("//");
522
- lines.push("// Table client methods (all take a single params object):");
523
- lines.push("// .findAll({ filters?, sort?, offset?, limit?, fields? }) → { records: T[], hasMore: boolean }");
524
- lines.push("// filters: { fieldName: value } for equality, or { fieldName: { <op>: value } }");
525
- lines.push("// operators: contains, not, in, notIn, lt, lte, gt, gte");
526
- lines.push('// `not: null` means "is set". An empty `in: []` matches nothing; an', "// empty `notIn: []` applies no filter.");
499
+ lines.push('// The tsconfig aliases resolve zitejs/* imports to the correct .zite/ files.');
500
+ lines.push('//');
501
+ lines.push('// Table client methods (all take a single params object):');
502
+ lines.push('// .findAll({ filters?, sort?, offset?, limit?, fields? }) → { records: T[], hasMore: boolean }');
503
+ lines.push('// filters: { fieldName: value } for equality, or { fieldName: { <op>: value } }');
504
+ lines.push('// operators: contains, not, in, notIn, lt, lte, gt, gte');
505
+ lines.push('// `not: null` means "is set". An empty `in: []` matches nothing; an', '// empty `notIn: []` applies no filter.');
527
506
  lines.push('// sort: [{ field: "fieldName", direction: "asc" | "desc" }]');
528
- lines.push("// limit defaults to 500, max 2000; offset is a row count (a number)");
529
- lines.push("// a filter value of `undefined` is REJECTED (it would query unfiltered", "// and match an arbitrary record). Check the value first.");
530
- lines.push("// .findOne({ id?, filters?, fields? }) → T | undefined");
531
- lines.push("// .create({ record }) → T");
532
- lines.push("// .update({ id, record }) → { id: string, fields: Partial<T> }");
533
- lines.push("// .delete({ id }) → { success: true, id: string }");
534
- lines.push("// .bulkCreate({ records, matchOn? }) → { success: boolean, records: T[] }");
535
- lines.push("// up to 100 records per call; matchOn upserts on those fields");
536
- lines.push("//");
537
- lines.push("// Reading these types:");
538
- lines.push("// SDK names are stable identifiers — they do NOT change when a table or field is");
507
+ lines.push('// limit defaults to 500, max 2000; offset is a row count (a number)');
508
+ lines.push("// a filter value of `undefined` drops that filter and reads as if it weren't", '// there. Check the value first: `{ owner: user?.id }` signed out reads every row.');
509
+ lines.push('// .findOne({ id?, filters?, fields? }) → T | undefined');
510
+ lines.push('// a filter value of `undefined`, or an `undefined` id with no filters, matches', '// no record and returns undefined');
511
+ lines.push('// .create({ record }) → T');
512
+ lines.push('// .update({ id, record }) → { id: string, fields: Partial<T> }');
513
+ lines.push('// .delete({ id }) → { success: true, id: string }');
514
+ lines.push('// .bulkCreate({ records, matchOn? }) → { success: boolean, records: T[] }');
515
+ lines.push('// up to 100 records per call; matchOn upserts on those fields');
516
+ lines.push('//');
517
+ lines.push('// Reading these types:');
518
+ lines.push('// SDK names are stable identifiers — they do NOT change when a table or field is');
539
519
  lines.push('// renamed. Each carries its current user-facing name in quotes (// "Task Name").');
540
- lines.push("// Where the two differ the field was renamed, and the quoted name is what it means");
541
- lines.push("// now — treat it as the source of truth.");
542
- lines.push("// Values are RAW: dates are ISO strings, durations are seconds. Format them for");
520
+ lines.push('// Where the two differ the field was renamed, and the quoted name is what it means');
521
+ lines.push('// now — treat it as the source of truth.');
522
+ lines.push('// Values are RAW: dates are ISO strings, durations are seconds. Format them for');
543
523
  lines.push("// display yourself, following the display config in each field's comment.");
544
- lines.push("// PERCENT fields are stored as decimals — 0.5 is 50%, 1.0 is 100%.");
545
- lines.push("// LINKED RECORD fields hold UUID record ids from findOne/findAll — never invent one.");
546
- lines.push("// Computed and system-managed fields (formula, rollup, lookup, autonumber,");
547
- lines.push("// created/updated timestamps and more) are absent from the *Input types —");
548
- lines.push("// a write to one is rejected or silently dropped.");
549
- lines.push("//");
550
- lines.push("// Zite auth users:");
551
- lines.push("// zite.auth.findAllUsers({ appIds?, filter?, filters?, sort?, limit?, offset? })");
552
- lines.push("// Supports the same filter, sort, and pagination options as table .findAll()");
553
- lines.push("// appIds restricts results to users belonging to any listed app");
554
- lines.push("// zite.auth.updateUserProfile(userId, { firstName?, lastName?, image? })");
555
- lines.push("// User email addresses cannot be updated through this API");
556
- lines.push("//");
557
- lines.push("// Raw SQL (read-only SELECTs for aggregates, joins, multi-table queries):");
524
+ lines.push('// PERCENT fields are stored as decimals — 0.5 is 50%, 1.0 is 100%.');
525
+ lines.push('// LINKED RECORD fields hold UUID record ids from findOne/findAll — never invent one.');
526
+ lines.push('// Computed and system-managed fields (formula, rollup, lookup, autonumber,');
527
+ lines.push('// created/updated timestamps and more) are absent from the *Input types —');
528
+ lines.push('// a write to one is rejected or silently dropped.');
529
+ lines.push('//');
530
+ lines.push('// Zite auth users:');
531
+ lines.push('// zite.auth.findAllUsers({ appIds?, filter?, filters?, sort?, limit?, offset? })');
532
+ lines.push('// Supports the same filter, sort, and pagination options as table .findAll()');
533
+ lines.push('// appIds restricts results to users belonging to any listed app');
534
+ lines.push('// zite.auth.updateUserProfile(userId, { firstName?, lastName?, image? })');
535
+ lines.push('// User email addresses cannot be updated through this API');
536
+ lines.push('//');
537
+ lines.push('// Raw SQL (read-only SELECTs for aggregates, joins, multi-table queries):');
558
538
  lines.push('// zite.sql({ query: "SELECT ...", params?: [...] })');
559
- lines.push("// → { rows: Record<string, unknown>[], columns, rowCount, truncated }");
560
- lines.push("// Capped at 2000 rows — `truncated: true` means there were more, so paginate in");
561
- lines.push("// SQL rather than assuming you got everything. Queries time out after 10s.");
562
- lines.push("// columns[].name is the SDK name; columns[].originalName is the underlying", "// database column (or your own SQL alias).");
563
- lines.push("//");
564
- lines.push("// SQL guidelines:");
565
- lines.push("// - Use SDK names for tables (PascalCase) and fields (camelCase)");
539
+ lines.push('// → { rows: Record<string, unknown>[], columns, rowCount, truncated }');
540
+ lines.push('// Capped at 2000 rows — `truncated: true` means there were more, so paginate in');
541
+ lines.push('// SQL rather than assuming you got everything. Queries time out after 10s.');
542
+ lines.push('// columns[].name is the SDK name; columns[].originalName is the underlying', '// database column (or your own SQL alias).');
543
+ lines.push('//');
544
+ lines.push('// SQL guidelines:');
545
+ lines.push('// - Use SDK names for tables (PascalCase) and fields (camelCase)');
566
546
  lines.push('// - ALWAYS double-quote every identifier: FROM "Orders", WHERE "status" = $1');
567
- lines.push("// - Use params array for user input ($1, $2, ...): never interpolate into SQL");
547
+ lines.push('// - Use params array for user input ($1, $2, ...): never interpolate into SQL');
568
548
  lines.push('// - Auth users are available as "ziteUsers" with id, name, email, firstName, lastName, and image');
569
- lines.push("// - Soft-deleted rows are excluded automatically — no WHERE deleted_at IS NULL");
570
- lines.push("// - SELECT only — use .create/.update/.delete for writes");
571
- lines.push('// - Load the "zite:sql" skill for full SQL reference (formulas, lookups, etc.)');
549
+ lines.push('// - Soft-deleted rows are excluded automatically — no WHERE deleted_at IS NULL');
550
+ lines.push('// - SELECT only — use .create/.update/.delete for writes');
551
+ lines.push(hasStartApps
552
+ ? '// - In the Zite editor, the "zite:sql" skill is the full SQL reference (formulas, lookups, etc.)'
553
+ : '// - Load the "zite:sql" skill for full SQL reference (formulas, lookups, etc.)');
572
554
  lines.push(...buildLinkTableComments(schema));
573
555
  lines.push("import { createTableClient, createSqlClient, createAuthClient } from 'zitejs/runtime';");
574
- lines.push("");
556
+ lines.push('');
575
557
  lines.push(...ATTACHMENT_TYPES);
576
558
  for (const table of tables) {
577
559
  const className = (0, sdkNames_js_1.toPascalCase)(table.sdkName);
@@ -583,9 +565,9 @@ function generateDbTs(inputSchema) {
583
565
  ? `/** A record in the "${commentSafe(table.name)}" table, as it is read back. */`
584
566
  : `/** A ${table.sdkName} record as it is read back. */`);
585
567
  lines.push(`export type ${recordType} = {`);
586
- lines.push(" id: string;");
568
+ lines.push(' id: string;');
587
569
  for (const field of table.fields) {
588
- if (field.sdkName === "id")
570
+ if (field.sdkName === 'id')
589
571
  continue;
590
572
  const tsType = tsTypeForSchemaField(field.definition);
591
573
  const jsdoc = fieldJsdoc(field, table, schema);
@@ -598,35 +580,35 @@ function generateDbTs(inputSchema) {
598
580
  // be absent on a read.
599
581
  lines.push(` ${field.sdkName}?: ${tsType};`);
600
582
  }
601
- lines.push("};");
602
- lines.push("");
583
+ lines.push('};');
584
+ lines.push('');
603
585
  // The write shape is a separate type, not `Partial<RecordType>`: computed
604
586
  // fields can't be written at all, and several field types accept looser
605
587
  // input than they store (an attachments field takes a URL string; a linked
606
588
  // record takes one id or many).
607
- const writableFields = table.fields.filter((f) => f.sdkName !== "id" && !READ_ONLY_FIELD_TYPES.has(f.definition.type));
589
+ const writableFields = table.fields.filter(f => f.sdkName !== 'id' && !READ_ONLY_FIELD_TYPES.has(f.definition.type));
608
590
  lines.push(table.name
609
591
  ? `/** What you may write when creating or updating a record in the "${commentSafe(table.name)}" table. */`
610
592
  : `/** What you may write when creating or updating a ${table.sdkName}. */`);
611
593
  lines.push(`export type ${className}RecordInput = {`);
612
594
  for (const field of writableFields) {
613
- lines.push(` ${field.sdkName}: ${tsTypeForSchemaField(field.definition, "write")};`);
595
+ lines.push(` ${field.sdkName}: ${tsTypeForSchemaField(field.definition, 'write')};`);
614
596
  }
615
- lines.push("};");
616
- lines.push("");
597
+ lines.push('};');
598
+ lines.push('');
617
599
  }
618
600
  lines.push(...generateSentinelSdkTypes());
619
- lines.push("export const zite = {");
601
+ lines.push('export const zite = {');
620
602
  for (const table of tables) {
621
603
  const className = (0, sdkNames_js_1.toPascalCase)(table.sdkName);
622
604
  lines.push(` ${table.sdkName}: createTableClient<${className}RecordType, ${className}RecordInput>('${className}'),` +
623
- (table.name ? ` // "${commentSafe(table.name)}"` : ""));
605
+ (table.name ? ` // "${commentSafe(table.name)}"` : ''));
624
606
  }
625
607
  lines.push(` sql: createSqlClient(),`);
626
608
  lines.push(` auth: createAuthClient<ZiteAuthUser>(),`);
627
- lines.push("};");
628
- lines.push("");
629
- return lines.join("\n");
609
+ lines.push('};');
610
+ lines.push('');
611
+ return lines.join('\n');
630
612
  }
631
613
  const NOT_AN_ENDPOINT = {
632
614
  isEndpoint: false,
@@ -635,23 +617,23 @@ const NOT_AN_ENDPOINT = {
635
617
  };
636
618
  /** `createEndpoint(...)` anywhere in the expression, through wrappers. */
637
619
  function callsCreateEndpoint(node) {
638
- if (!node || typeof node !== "object")
620
+ if (!node || typeof node !== 'object')
639
621
  return false;
640
622
  const n = node;
641
- if (n.type === "CallExpression" &&
623
+ if (n.type === 'CallExpression' &&
642
624
  n.callee?.name ===
643
- "createEndpoint") {
625
+ 'createEndpoint') {
644
626
  return true;
645
627
  }
646
- return Object.values(n).some((v) => Array.isArray(v) ? v.some(callsCreateEndpoint) : callsCreateEndpoint(v));
628
+ return Object.values(n).some(v => Array.isArray(v) ? v.some(callsCreateEndpoint) : callsCreateEndpoint(v));
647
629
  }
648
630
  /** Unwrap `x satisfies T` / `x as const` to the expression underneath. */
649
631
  function unwrapExpression(node) {
650
632
  let current = node;
651
- while ((current?.type === "TSAsExpression" ||
652
- current?.type === "TSSatisfiesExpression" ||
653
- current?.type === "TSNonNullExpression" ||
654
- current?.type === "ParenthesizedExpression") &&
633
+ while ((current?.type === 'TSAsExpression' ||
634
+ current?.type === 'TSSatisfiesExpression' ||
635
+ current?.type === 'TSNonNullExpression' ||
636
+ current?.type === 'ParenthesizedExpression') &&
655
637
  current.expression) {
656
638
  current = current.expression;
657
639
  }
@@ -660,7 +642,7 @@ function unwrapExpression(node) {
660
642
  function inspectEndpointFile(source) {
661
643
  let ast;
662
644
  try {
663
- ast = (0, parser_1.parse)(source, { sourceType: "module", plugins: ["typescript"] });
645
+ ast = (0, parser_1.parse)(source, { sourceType: 'module', plugins: ['typescript'] });
664
646
  }
665
647
  catch {
666
648
  // Unparseable with a TS-only plugin set — most likely TSX, which is still
@@ -669,31 +651,31 @@ function inspectEndpointFile(source) {
669
651
  return { isEndpoint: true, hasDefaultExport: true, stream: false };
670
652
  }
671
653
  const body = ast.program.body;
672
- const hasDefaultExport = body.some((n) => n.type === "ExportDefaultDeclaration" ||
673
- (n.type === "ExportNamedDeclaration" &&
674
- n.specifiers?.some((spec) => spec.type === "ExportSpecifier" &&
675
- (spec.exported.type === "Identifier"
654
+ const hasDefaultExport = body.some(n => n.type === 'ExportDefaultDeclaration' ||
655
+ (n.type === 'ExportNamedDeclaration' &&
656
+ n.specifiers?.some(spec => spec.type === 'ExportSpecifier' &&
657
+ (spec.exported.type === 'Identifier'
676
658
  ? spec.exported.name
677
- : spec.exported.value) === "default")));
659
+ : spec.exported.value) === 'default')));
678
660
  const isEndpoint = hasDefaultExport || body.some(callsCreateEndpoint);
679
661
  if (!isEndpoint)
680
662
  return NOT_AN_ENDPOINT;
681
663
  // Stream detection is best-effort on the literal config: it is the only
682
664
  // shape we can read `stream: true` out of statically.
683
- const defaultExport = body.find((n) => n.type === "ExportDefaultDeclaration");
665
+ const defaultExport = body.find(n => n.type === 'ExportDefaultDeclaration');
684
666
  const call = defaultExport
685
667
  ? unwrapExpression(defaultExport.declaration)
686
668
  : undefined;
687
- const arg = call?.type === "CallExpression"
669
+ const arg = call?.type === 'CallExpression'
688
670
  ? unwrapExpression(call.arguments?.[0] ?? {})
689
671
  : undefined;
690
- if (arg?.type !== "ObjectExpression") {
672
+ if (arg?.type !== 'ObjectExpression') {
691
673
  return { isEndpoint, hasDefaultExport, stream: false };
692
674
  }
693
- const streamProp = arg.properties.find((prop) => prop.type === "ObjectProperty" &&
694
- ((prop.key?.type === "Identifier" && prop.key.name === "stream") ||
695
- (prop.key?.type === "StringLiteral" && prop.key.value === "stream")));
696
- const stream = streamProp?.value?.type === "BooleanLiteral" &&
675
+ const streamProp = arg.properties.find(prop => prop.type === 'ObjectProperty' &&
676
+ ((prop.key?.type === 'Identifier' && prop.key.name === 'stream') ||
677
+ (prop.key?.type === 'StringLiteral' && prop.key.value === 'stream')));
678
+ const stream = streamProp?.value?.type === 'BooleanLiteral' &&
697
679
  streamProp.value.value === true;
698
680
  return { isEndpoint, hasDefaultExport, stream };
699
681
  }
@@ -704,52 +686,52 @@ function inspectEndpointFile(source) {
704
686
  * words are legal object keys.
705
687
  */
706
688
  const RESERVED_IDENTIFIERS = new Set([
707
- "await",
708
- "break",
709
- "case",
710
- "catch",
711
- "class",
712
- "const",
713
- "continue",
714
- "debugger",
715
- "default",
716
- "delete",
717
- "do",
718
- "else",
719
- "enum",
720
- "export",
721
- "extends",
722
- "false",
723
- "finally",
724
- "for",
725
- "function",
726
- "if",
727
- "implements",
728
- "import",
729
- "in",
730
- "instanceof",
731
- "interface",
732
- "let",
733
- "new",
734
- "null",
735
- "package",
736
- "private",
737
- "protected",
738
- "public",
739
- "return",
740
- "static",
741
- "super",
742
- "switch",
743
- "this",
744
- "throw",
745
- "true",
746
- "try",
747
- "typeof",
748
- "var",
749
- "void",
750
- "while",
751
- "with",
752
- "yield",
689
+ 'await',
690
+ 'break',
691
+ 'case',
692
+ 'catch',
693
+ 'class',
694
+ 'const',
695
+ 'continue',
696
+ 'debugger',
697
+ 'default',
698
+ 'delete',
699
+ 'do',
700
+ 'else',
701
+ 'enum',
702
+ 'export',
703
+ 'extends',
704
+ 'false',
705
+ 'finally',
706
+ 'for',
707
+ 'function',
708
+ 'if',
709
+ 'implements',
710
+ 'import',
711
+ 'in',
712
+ 'instanceof',
713
+ 'interface',
714
+ 'let',
715
+ 'new',
716
+ 'null',
717
+ 'package',
718
+ 'private',
719
+ 'protected',
720
+ 'public',
721
+ 'return',
722
+ 'static',
723
+ 'super',
724
+ 'switch',
725
+ 'this',
726
+ 'throw',
727
+ 'true',
728
+ 'try',
729
+ 'typeof',
730
+ 'var',
731
+ 'void',
732
+ 'while',
733
+ 'with',
734
+ 'yield',
753
735
  ]);
754
736
  const toSafeIdentifier = (camelName) => RESERVED_IDENTIFIERS.has(camelName) ? `_${camelName}` : camelName;
755
737
  function generateApiTs(endpointFiles) {
@@ -759,11 +741,11 @@ function generateApiTs(endpointFiles) {
759
741
  const seenIdents = new Set();
760
742
  const skipped = [];
761
743
  for (const file of endpointFiles) {
762
- const fileName = typeof file === "string" ? file : file.fileName;
763
- const content = typeof file === "string" ? undefined : file.content;
744
+ const fileName = typeof file === 'string' ? file : file.fileName;
745
+ const content = typeof file === 'string' ? undefined : file.content;
764
746
  // `foo.d.ts` -> baseName `foo.d`, which imports nothing and camelCases to
765
747
  // `fooD`. Declaration files are never endpoints.
766
- if (fileName.endsWith(".d.ts"))
748
+ if (fileName.endsWith('.d.ts'))
767
749
  continue;
768
750
  // Callers that pass bare filenames can't be filtered — every in-tree caller
769
751
  // passes content, and so does the backend's migration assembler.
@@ -772,7 +754,7 @@ function generateApiTs(endpointFiles) {
772
754
  skipped.push(fileName);
773
755
  continue;
774
756
  }
775
- const baseName = fileName.replace(/\.(ts|js)$/, "");
757
+ const baseName = fileName.replace(/\.(ts|js)$/, '');
776
758
  const key = (0, sdkNames_js_1.toCamelCase)(baseName);
777
759
  const ident = toSafeIdentifier(key);
778
760
  // Distinct files can collide on one identifier (`send-email.ts` and
@@ -798,27 +780,27 @@ function generateApiTs(endpointFiles) {
798
780
  }
799
781
  if (endpoints.length === 0)
800
782
  return null;
801
- const hasStreaming = endpoints.some((e) => e.stream);
783
+ const hasStreaming = endpoints.some(e => e.stream);
802
784
  const lines = [
803
- "// Auto-generated by zitejs generate. Do not edit manually.",
804
- "",
785
+ '// Auto-generated by zitejs generate. Do not edit manually.',
786
+ '',
805
787
  hasStreaming
806
788
  ? "import { createCaller, createStreamingCaller } from 'zitejs/caller';"
807
789
  : "import { createCaller } from 'zitejs/caller';",
808
- "",
790
+ '',
809
791
  ];
810
792
  if (skipped.length > 0) {
811
- lines.push("// Not endpoints, so no callers were generated for them:");
793
+ lines.push('// Not endpoints, so no callers were generated for them:');
812
794
  for (const name of skipped)
813
795
  lines.push(`// ${commentSafe(name)}`);
814
- lines.push("");
796
+ lines.push('');
815
797
  }
816
798
  for (const { pascal, baseName, typed } of endpoints) {
817
799
  if (!typed)
818
800
  continue;
819
801
  lines.push(`import type { default as _${pascal}Ep } from ${tsSingleQuoted(`../src/api/${baseName}`)};`);
820
802
  }
821
- lines.push("");
803
+ lines.push('');
822
804
  for (const { baseName, ident, pascal, stream, typed } of endpoints) {
823
805
  if (!typed) {
824
806
  // Declared with `export const x = createEndpoint(...)` — the 1.0 shape.
@@ -827,8 +809,8 @@ function generateApiTs(endpointFiles) {
827
809
  lines.push(`// ${commentSafe(`'${baseName}'`)} has no default export, so its input/output are untyped.`);
828
810
  lines.push(`export type ${pascal}InputType = unknown;`);
829
811
  lines.push(`export type ${pascal}OutputType = unknown;`);
830
- lines.push(`export const ${ident} = ${stream ? "createStreamingCaller" : "createCaller"}<${pascal}InputType, ${pascal}OutputType>(${tsSingleQuoted(baseName)});`);
831
- lines.push("");
812
+ lines.push(`export const ${ident} = ${stream ? 'createStreamingCaller' : 'createCaller'}<${pascal}InputType, ${pascal}OutputType>(${tsSingleQuoted(baseName)});`);
813
+ lines.push('');
832
814
  continue;
833
815
  }
834
816
  lines.push(`type _${pascal}Cfg = typeof _${pascal}Ep;`);
@@ -845,65 +827,65 @@ function generateApiTs(endpointFiles) {
845
827
  // against those keys, so `send-email.ts` is reachable at `/api/send-email`.
846
828
  // Calling it `sendEmail` here made every hyphenated or snake_cased endpoint
847
829
  // a 404.
848
- const caller = stream ? "createStreamingCaller" : "createCaller";
830
+ const caller = stream ? 'createStreamingCaller' : 'createCaller';
849
831
  lines.push(`export const ${ident} = ${caller}<${pascal}InputType, ${pascal}OutputType>(${tsSingleQuoted(baseName)});`);
850
- lines.push("");
832
+ lines.push('');
851
833
  }
852
- lines.push("");
853
- lines.push("export const api = {");
834
+ lines.push('');
835
+ lines.push('export const api = {');
854
836
  for (const { key, ident } of endpoints) {
855
837
  lines.push(key === ident ? ` ${ident},` : ` ${key}: ${ident},`);
856
838
  }
857
- lines.push("};");
858
- lines.push("");
859
- return lines.join("\n");
839
+ lines.push('};');
840
+ lines.push('');
841
+ return lines.join('\n');
860
842
  }
861
843
  function tsTypeForField(field) {
862
844
  if (FIELD_TYPE_MAP[field.type])
863
845
  return FIELD_TYPE_MAP[field.type];
864
- return "string";
846
+ return 'string';
865
847
  }
866
848
  const AIRTABLE_FIELD_TYPE_MAP = {
867
849
  // Writable fields
868
- singleLineText: "string",
869
- multilineText: "string",
870
- richText: "string",
871
- email: "string",
872
- url: "string",
873
- phoneNumber: "string",
874
- barcode: "string",
875
- number: "number",
876
- currency: "number",
877
- percent: "number",
878
- rating: "number",
850
+ singleLineText: 'string',
851
+ multilineText: 'string',
852
+ richText: 'string',
853
+ email: 'string',
854
+ url: 'string',
855
+ phoneNumber: 'string',
856
+ barcode: 'string',
857
+ number: 'number',
858
+ currency: 'number',
859
+ percent: 'number',
860
+ rating: 'number',
879
861
  // Formatted to "HH:mm:ss" before it reaches the app — `formatAirtableDuration`
880
862
  // in BOTH dispatches. Unlike the Zite DB's, which is DECIMAL seconds.
881
- duration: "string",
882
- checkbox: "boolean",
883
- date: "string",
884
- dateTime: "string",
885
- singleSelect: "string",
886
- multipleSelects: "string[]",
887
- multipleAttachments: "AirtableAttachment[]",
863
+ duration: 'string',
864
+ checkbox: 'boolean',
865
+ date: 'string',
866
+ dateTime: 'string',
867
+ singleSelect: 'string',
868
+ multipleSelects: 'string[]',
869
+ multipleAttachments: 'AirtableAttachment[]',
888
870
  // `string | string[]`, matching the pre-monorepo type — see the note on the
889
871
  // Zite DB's `linked_record`.
890
- multipleRecordLinks: "string | string[]",
891
- singleCollaborator: "{ id: string; email: string; name?: string }",
892
- multipleCollaborators: "Array<{ id: string; email: string; name?: string }>",
872
+ multipleRecordLinks: 'string | string[]',
873
+ singleCollaborator: '{ id: string; email: string; name?: string }',
874
+ multipleCollaborators: 'Array<{ id: string; email: string; name?: string }>',
893
875
  // Read-only fields
894
- autoNumber: "number",
895
- count: "number",
896
- formula: "unknown",
897
- rollup: "unknown",
898
- multipleLookupValues: "unknown",
899
- createdTime: "string",
900
- lastModifiedTime: "string",
901
- createdBy: "{ id: string; email: string; name?: string }",
902
- lastModifiedBy: "{ id: string; email: string; name?: string }",
876
+ autoNumber: 'number',
877
+ count: 'number',
878
+ formula: 'unknown',
879
+ rollup: 'unknown',
880
+ multipleLookupValues: 'unknown',
881
+ createdTime: 'string',
882
+ lastModifiedTime: 'string',
883
+ createdBy: '{ id: string; email: string; name?: string }',
884
+ lastModifiedBy: '{ id: string; email: string; name?: string }',
903
885
  // Both dispatches extract the URL string off the button object.
904
- button: "string",
905
- externalSyncSource: "unknown",
906
- aiText: "string",
886
+ button: 'string',
887
+ externalSyncSource: 'unknown',
888
+ aiText: 'string',
907
889
  };
908
890
  /**
909
891
  * Field types whose WRITE shape is looser than what Airtable returns.
@@ -911,10 +893,10 @@ const AIRTABLE_FIELD_TYPE_MAP = {
911
893
  * `{ url, filename? }`; a link field returns an array but accepts one id.
912
894
  */
913
895
  const AIRTABLE_FIELD_INPUT_TYPE_MAP = {
914
- multipleAttachments: "Array<{ url: string; filename?: string }>",
915
- multipleRecordLinks: "string | string[]",
916
- singleCollaborator: "{ id: string } | { email: string }",
917
- multipleCollaborators: "Array<{ id: string } | { email: string }>",
896
+ multipleAttachments: 'Array<{ url: string; filename?: string }>',
897
+ multipleRecordLinks: 'string | string[]',
898
+ singleCollaborator: '{ id: string } | { email: string }',
899
+ multipleCollaborators: 'Array<{ id: string } | { email: string }>',
918
900
  };
919
901
  /**
920
902
  * Airtable's attachment object as the REST API really returns it.
@@ -925,34 +907,34 @@ const AIRTABLE_FIELD_INPUT_TYPE_MAP = {
925
907
  * migration type error. Optional, because a non-image attachment has neither.
926
908
  */
927
909
  const AIRTABLE_ATTACHMENT_TYPE = [
928
- "export type AirtableAttachment = {",
929
- " id: string;",
930
- " url: string;",
931
- " filename: string;",
932
- " /** Size in bytes. */",
933
- " size: number;",
934
- " /** MIME type. */",
935
- " type: string;",
936
- " /** Pixel width — images only. */",
937
- " width?: number;",
938
- " /** Pixel height — images only. */",
939
- " height?: number;",
940
- " thumbnails?: {",
941
- " small: { url: string; width: number; height: number };",
942
- " large: { url: string; width: number; height: number };",
943
- " full: { url: string; width: number; height: number };",
944
- " };",
945
- "};",
946
- "",
910
+ 'export type AirtableAttachment = {',
911
+ ' id: string;',
912
+ ' url: string;',
913
+ ' filename: string;',
914
+ ' /** Size in bytes. */',
915
+ ' size: number;',
916
+ ' /** MIME type. */',
917
+ ' type: string;',
918
+ ' /** Pixel width — images only. */',
919
+ ' width?: number;',
920
+ ' /** Pixel height — images only. */',
921
+ ' height?: number;',
922
+ ' thumbnails?: {',
923
+ ' small: { url: string; width: number; height: number };',
924
+ ' large: { url: string; width: number; height: number };',
925
+ ' full: { url: string; width: number; height: number };',
926
+ ' };',
927
+ '};',
928
+ '',
947
929
  ];
948
- function airtableTsType(field, lock, depth, variant = "read") {
949
- if (variant === "write" && AIRTABLE_FIELD_INPUT_TYPE_MAP[field.type]) {
930
+ function airtableTsType(field, lock, depth, variant = 'read') {
931
+ if (variant === 'write' && AIRTABLE_FIELD_INPUT_TYPE_MAP[field.type]) {
950
932
  return AIRTABLE_FIELD_INPUT_TYPE_MAP[field.type];
951
933
  }
952
934
  // A formula or rollup's cell type is whatever its expression produces, and
953
935
  // Airtable reports that in the field's `result`. Reading it turns `unknown`
954
936
  // — which forces a cast at every use — into the actual type.
955
- if ((field.type === "formula" || field.type === "rollup") &&
937
+ if ((field.type === 'formula' || field.type === 'rollup') &&
956
938
  (depth ?? 0) < 5) {
957
939
  const result = field.config?.result;
958
940
  if (result?.type && result.type !== field.type) {
@@ -960,28 +942,28 @@ function airtableTsType(field, lock, depth, variant = "read") {
960
942
  }
961
943
  }
962
944
  const choices = field.config?.choices;
963
- if ((field.type === "singleSelect" || field.type === "multipleSelects") &&
945
+ if ((field.type === 'singleSelect' || field.type === 'multipleSelects') &&
964
946
  choices &&
965
947
  choices.length > 0) {
966
948
  const literals = choices
967
949
  .slice(0, MAX_SELECT_OPTIONS)
968
- .map((o) => tsStringLiteral(o))
969
- .join(" | ");
950
+ .map(o => tsStringLiteral(o))
951
+ .join(' | ');
970
952
  const union = `${literals} | string`;
971
- if (field.type === "multipleSelects")
953
+ if (field.type === 'multipleSelects')
972
954
  return `(${union})[]`;
973
955
  return union;
974
956
  }
975
- if (field.type === "multipleLookupValues" && lock && (depth ?? 0) < 5) {
957
+ if (field.type === 'multipleLookupValues' && lock && (depth ?? 0) < 5) {
976
958
  const linkFieldId = field.config?.recordLinkFieldId;
977
959
  const targetFieldId = field.config?.fieldIdInLinkedTable;
978
960
  if (linkFieldId && targetFieldId) {
979
- const table = lock.tables.find((t) => t.fields.some((f) => f.id === linkFieldId));
980
- const linkField = table?.fields.find((f) => f.id === linkFieldId);
961
+ const table = lock.tables.find(t => t.fields.some(f => f.id === linkFieldId));
962
+ const linkField = table?.fields.find(f => f.id === linkFieldId);
981
963
  const linkedTableId = linkField?.config?.linkedTableId;
982
964
  if (linkedTableId) {
983
- const linkedTable = lock.tables.find((t) => t.id === linkedTableId);
984
- const targetField = linkedTable?.fields.find((f) => f.id === targetFieldId);
965
+ const linkedTable = lock.tables.find(t => t.id === linkedTableId);
966
+ const targetField = linkedTable?.fields.find(f => f.id === targetFieldId);
985
967
  if (targetField) {
986
968
  const resolved = airtableTsType(targetField, lock, (depth ?? 0) + 1);
987
969
  return `${resolved}[] | undefined`;
@@ -989,90 +971,90 @@ function airtableTsType(field, lock, depth, variant = "read") {
989
971
  }
990
972
  }
991
973
  }
992
- return AIRTABLE_FIELD_TYPE_MAP[field.type] ?? "unknown";
974
+ return AIRTABLE_FIELD_TYPE_MAP[field.type] ?? 'unknown';
993
975
  }
994
976
  const READ_ONLY_AIRTABLE_FIELDS = new Set([
995
- "autoNumber",
996
- "count",
997
- "formula",
998
- "rollup",
999
- "multipleLookupValues",
1000
- "createdTime",
1001
- "lastModifiedTime",
1002
- "createdBy",
1003
- "lastModifiedBy",
1004
- "button",
1005
- "externalSyncSource",
1006
- "aiText",
977
+ 'autoNumber',
978
+ 'count',
979
+ 'formula',
980
+ 'rollup',
981
+ 'multipleLookupValues',
982
+ 'createdTime',
983
+ 'lastModifiedTime',
984
+ 'createdBy',
985
+ 'lastModifiedBy',
986
+ 'button',
987
+ 'externalSyncSource',
988
+ 'aiText',
1007
989
  ]);
1008
990
  function airtableFieldJsdoc(field, table, lock) {
1009
991
  const parts = [];
1010
992
  if (table.primaryFieldId === field.id)
1011
- parts.push("Primary field");
993
+ parts.push('Primary field');
1012
994
  if (READ_ONLY_AIRTABLE_FIELDS.has(field.type))
1013
- parts.push("Read-only; do not write");
1014
- if (field.type === "multipleRecordLinks") {
995
+ parts.push('Read-only; do not write');
996
+ if (field.type === 'multipleRecordLinks') {
1015
997
  const linkedTableId = field.config?.linkedTableId;
1016
998
  if (linkedTableId) {
1017
- const linked = lock?.tables.find((t) => t.id === linkedTableId);
999
+ const linked = lock?.tables.find(t => t.id === linkedTableId);
1018
1000
  parts.push(linked
1019
- ? `Links to ${linked.sdkName}${linked.name ? ` ("${linked.name}")` : ""}`
1001
+ ? `Links to ${linked.sdkName}${linked.name ? ` ("${linked.name}")` : ''}`
1020
1002
  : `Links to ${linkedTableId}`);
1021
1003
  }
1022
1004
  if (field.config?.prefersSingleRecordLink)
1023
- parts.push("Single record only");
1005
+ parts.push('Single record only');
1024
1006
  }
1025
- if (field.type === "multipleLookupValues")
1026
- parts.push("Lookup: value is an array — index or aggregate when displaying");
1027
- if (field.type === "percent")
1028
- parts.push("Raw decimal — multiply by 100 for display percentage");
1007
+ if (field.type === 'multipleLookupValues')
1008
+ parts.push('Lookup: value is an array — index or aggregate when displaying');
1009
+ if (field.type === 'percent')
1010
+ parts.push('Raw decimal — multiply by 100 for display percentage');
1029
1011
  parts.push(`"${field.name}"`);
1030
- if (field.type === "currency") {
1012
+ if (field.type === 'currency') {
1031
1013
  const symbol = field.config?.symbol;
1032
1014
  const precision = field.config?.precision;
1033
1015
  if (symbol)
1034
1016
  parts.push(`Display as currency with "${symbol}", ${precision ?? 2} decimals`);
1035
1017
  }
1036
- if (field.type === "date") {
1018
+ if (field.type === 'date') {
1037
1019
  const fmt = field.config?.dateFormat;
1038
1020
  if (fmt)
1039
1021
  parts.push(`Date-only (ISO string), display as "${fmt}"`);
1040
1022
  }
1041
- if (field.type === "dateTime") {
1023
+ if (field.type === 'dateTime') {
1042
1024
  const dateFmt = field.config?.dateFormat;
1043
1025
  const timeFmt = field.config?.timeFormat;
1044
1026
  const tz = field.config?.timeZone;
1045
- const fmtParts = ["Date+time (ISO string)"];
1027
+ const fmtParts = ['Date+time (ISO string)'];
1046
1028
  if (dateFmt)
1047
1029
  fmtParts.push(`date: ${dateFmt}`);
1048
1030
  if (timeFmt)
1049
1031
  fmtParts.push(`time: ${timeFmt}`);
1050
1032
  if (tz)
1051
1033
  fmtParts.push(`tz: ${tz}`);
1052
- parts.push(fmtParts.join(", "));
1034
+ parts.push(fmtParts.join(', '));
1053
1035
  }
1054
- if (field.type === "rating") {
1036
+ if (field.type === 'rating') {
1055
1037
  const max = field.config?.max;
1056
1038
  if (max)
1057
1039
  parts.push(`Max: ${max}`);
1058
1040
  }
1059
- if (field.type === "duration") {
1041
+ if (field.type === 'duration') {
1060
1042
  const fmt = field.config?.format;
1061
1043
  if (fmt)
1062
1044
  parts.push(`Value in seconds, display as "${fmt}"`);
1063
1045
  }
1064
- if (field.type === "number" || field.type === "percent") {
1046
+ if (field.type === 'number' || field.type === 'percent') {
1065
1047
  const precision = field.config?.precision;
1066
1048
  if (precision != null)
1067
1049
  parts.push(`${precision} decimal places`);
1068
1050
  }
1069
1051
  if (parts.length <= 1)
1070
1052
  return undefined;
1071
- return parts.join(". ");
1053
+ return parts.join('. ');
1072
1054
  }
1073
1055
  // A table client is a `const`, so only value-space bindings can collide with
1074
1056
  // one. `AirtableAttachment` is a type, and types and consts coexist.
1075
- const RESERVED_AIRTABLE_NAMES = ["createAirtableClient"];
1057
+ const RESERVED_AIRTABLE_NAMES = ['createAirtableClient'];
1076
1058
  /**
1077
1059
  * Make every table sdkName in the lock unique, so a duplicated lock can't emit
1078
1060
  * a file that cannot compile (TS2300/TS2451) and that no app can edit or
@@ -1108,7 +1090,7 @@ function normalizeAirtableLockNames(lock) {
1108
1090
  });
1109
1091
  // Sole owners claim their names before any contender is suffixed, so a
1110
1092
  // contender can never displace a table legitimately named `GroupCalls2`.
1111
- const kept = lock.tables.map((table) => owners.get(table.sdkName) === 1 && tableNames.available(table.sdkName)
1093
+ const kept = lock.tables.map(table => owners.get(table.sdkName) === 1 && tableNames.available(table.sdkName)
1112
1094
  ? tableNames.allocate(table.sdkName)
1113
1095
  : undefined);
1114
1096
  const renames = [];
@@ -1116,7 +1098,7 @@ function normalizeAirtableLockNames(lock) {
1116
1098
  const sdkName = kept[i] ?? tableNames.allocate(table.sdkName);
1117
1099
  if (sdkName !== table.sdkName) {
1118
1100
  renames.push({
1119
- kind: "table",
1101
+ kind: 'table',
1120
1102
  tableId: table.id,
1121
1103
  from: table.sdkName,
1122
1104
  to: sdkName,
@@ -1126,7 +1108,11 @@ function normalizeAirtableLockNames(lock) {
1126
1108
  });
1127
1109
  return { lock: { ...lock, tables }, renames };
1128
1110
  }
1129
- function generateAirtableTs(inputLock) {
1111
+ /** Where an app keeps the server code a generated client is used from. */
1112
+ const serverCodeIn = (runtime) => runtime === 'start'
1113
+ ? 'server functions and *.server.ts files'
1114
+ : 'endpoint files (src/api/*.ts)';
1115
+ function generateAirtableTs(inputLock, runtime = 'classic') {
1130
1116
  if (inputLock.tables.length === 0)
1131
1117
  return null;
1132
1118
  const { lock, renames } = normalizeAirtableLockNames(inputLock);
@@ -1136,48 +1122,48 @@ function generateAirtableTs(inputLock) {
1136
1122
  }
1137
1123
  }
1138
1124
  const lines = [
1139
- "// Auto-generated by zitejs generate from zite.lock. Do not edit manually.",
1140
- "// Airtable SDK — uses createAirtableClient from zitejs/runtime.",
1141
- "//",
1142
- "// Usage in endpoint files (src/api/*.ts) — one client is exported per table:",
1143
- `// import { ${lock.tables[0]?.sdkName ?? "TableName"} } from 'zitejs/integrations';`,
1144
- "//",
1125
+ '// Auto-generated by zitejs generate from zite.lock. Do not edit manually.',
1126
+ '// Airtable SDK — uses createAirtableClient from zitejs/runtime.',
1127
+ '//',
1128
+ `// Usage in ${serverCodeIn(runtime)} — one client is exported per table:`,
1129
+ `// import { ${lock.tables[0]?.sdkName ?? 'TableName'} } from 'zitejs/integrations';`,
1130
+ '//',
1145
1131
  "// Always use 'zitejs/integrations' — never a relative path like",
1146
1132
  "// '../../.zite/integrations/airtable'. The tsconfig aliases resolve zitejs/*",
1147
- "// imports to the correct .zite/ files.",
1148
- "//",
1149
- "// Each exported table client has these methods (all take a single params object):",
1150
- "// findAll({ offset?, limit?, filters? }) => { records: T[], offset: string | undefined, hasMore: boolean }",
1151
- "// findOne({ id?, filters? }) => T | undefined",
1152
- "// create({ record }) => T | undefined",
1153
- "// bulkCreate({ records }) => T[]",
1154
- "// update({ id, record }) => { id: string, fields: T } | undefined",
1155
- "// delete({ id }) => { id: string }",
1156
- "//",
1157
- "// Reading these types:",
1158
- "// Every field is OPTIONAL. Airtable omits an empty cell from the response",
1159
- "// entirely rather than sending null, so any field can be undefined on any row.",
1160
- "// SDK names are stable identifiers and do not change when a field is renamed —",
1133
+ '// imports to the correct .zite/ files.',
1134
+ '//',
1135
+ '// Each exported table client has these methods (all take a single params object):',
1136
+ '// findAll({ offset?, limit?, filters? }) => { records: T[], offset: string | undefined, hasMore: boolean }',
1137
+ '// findOne({ id?, filters? }) => T | undefined',
1138
+ '// create({ record }) => T | undefined',
1139
+ '// bulkCreate({ records }) => T[]',
1140
+ '// update({ id, record }) => { id: string, fields: T } | undefined',
1141
+ '// delete({ id }) => { id: string }',
1142
+ '//',
1143
+ '// Reading these types:',
1144
+ '// Every field is OPTIONAL. Airtable omits an empty cell from the response',
1145
+ '// entirely rather than sending null, so any field can be undefined on any row.',
1146
+ '// SDK names are stable identifiers and do not change when a field is renamed —',
1161
1147
  '// each carries its current user-facing name in quotes (// "Task Name"), which is',
1162
- "// the source of truth for what it means.",
1148
+ '// the source of truth for what it means.',
1163
1149
  "// Values are RAW; format them for display using each field's comment.",
1164
1150
  '// Fields marked "Links to X" hold Airtable record ids (rec...) from',
1165
- "// findOne/findAll — never invent one.",
1166
- "// Read-only fields are absent from the *RecordInput types: Airtable rejects a",
1167
- "// write to a computed one (formula, rollup, lookup, autonumber, the created/",
1168
- "// modified metadata, button, aiText) with a 422.",
1169
- "//",
1170
- "// Usage tips:",
1171
- "// - Airtable has a strict rate limit of 5 requests/second per base",
1172
- "// - Use bulkCreate() instead of calling create() in a loop, but chunk it",
1173
- "// yourself: Airtable rejects more than 10 records in one create request",
1174
- "// with a 422, and not every runtime path batches for you",
1175
- "// - findAll() offsets are opaque cursor strings from a previous call, NOT row",
1176
- "// counts (unlike zite.<table>.findAll, whose offset IS a number)",
1177
- "// - Always destructure record properties individually in create/update calls",
1178
- "",
1151
+ '// findOne/findAll — never invent one.',
1152
+ '// Read-only fields are absent from the *RecordInput types: Airtable rejects a',
1153
+ '// write to a computed one (formula, rollup, lookup, autonumber, the created/',
1154
+ '// modified metadata, button, aiText) with a 422.',
1155
+ '//',
1156
+ '// Usage tips:',
1157
+ '// - Airtable has a strict rate limit of 5 requests/second per base',
1158
+ '// - Use bulkCreate() instead of calling create() in a loop, but chunk it',
1159
+ '// yourself: Airtable rejects more than 10 records in one create request',
1160
+ '// with a 422, and not every runtime path batches for you',
1161
+ '// - findAll() offsets are opaque cursor strings from a previous call, NOT row',
1162
+ '// counts (unlike zite.<table>.findAll, whose offset IS a number)',
1163
+ '// - Always destructure record properties individually in create/update calls',
1164
+ '',
1179
1165
  "import { createAirtableClient } from 'zitejs/runtime';",
1180
- "",
1166
+ '',
1181
1167
  ];
1182
1168
  lines.push(...AIRTABLE_ATTACHMENT_TYPE);
1183
1169
  for (const table of lock.tables) {
@@ -1186,9 +1172,9 @@ function generateAirtableTs(inputLock) {
1186
1172
  ? `/** A record in the "${commentSafe(table.name)}" table, as it is read back. */`
1187
1173
  : `/** A ${commentSafe(table.sdkName)} record as it is read back. */`);
1188
1174
  lines.push(`export type ${recordType} = {`);
1189
- lines.push(" id: string;");
1175
+ lines.push(' id: string;');
1190
1176
  for (const field of table.fields) {
1191
- if (field.sdkName === "id")
1177
+ if (field.sdkName === 'id')
1192
1178
  continue;
1193
1179
  const jsdoc = airtableFieldJsdoc(field, table, lock);
1194
1180
  if (jsdoc) {
@@ -1201,172 +1187,172 @@ function generateAirtableTs(inputLock) {
1201
1187
  // typed `string` is `undefined` at runtime on the first blank row.
1202
1188
  lines.push(` ${field.sdkName}?: ${tsType};`);
1203
1189
  }
1204
- lines.push("};");
1205
- lines.push("");
1190
+ lines.push('};');
1191
+ lines.push('');
1206
1192
  // Read-only fields are omitted rather than typed: Airtable rejects a write
1207
1193
  // to a formula, rollup, lookup or autonumber with a 422.
1208
- const writableFields = table.fields.filter((f) => f.sdkName !== "id" && !READ_ONLY_AIRTABLE_FIELDS.has(f.type));
1194
+ const writableFields = table.fields.filter(f => f.sdkName !== 'id' && !READ_ONLY_AIRTABLE_FIELDS.has(f.type));
1209
1195
  lines.push(table.name
1210
1196
  ? `/** What you may write when creating or updating a record in the "${commentSafe(table.name)}" table. */`
1211
1197
  : `/** What you may write when creating or updating a ${commentSafe(table.sdkName)}. */`);
1212
1198
  lines.push(`export type ${table.sdkName}RecordInput = {`);
1213
1199
  for (const field of writableFields) {
1214
- lines.push(` ${field.sdkName}: ${airtableTsType(field, lock, 0, "write")};`);
1200
+ lines.push(` ${field.sdkName}: ${airtableTsType(field, lock, 0, 'write')};`);
1215
1201
  }
1216
- lines.push("};");
1217
- lines.push("");
1202
+ lines.push('};');
1203
+ lines.push('');
1218
1204
  lines.push(`export const ${table.sdkName} = createAirtableClient<${recordType}, ${table.sdkName}RecordInput>(`);
1219
1205
  lines.push(` '${lock.integrationId}',`);
1220
1206
  lines.push(` '${table.sdkName}',`);
1221
1207
  lines.push(` { tableId: '${table.id}' },` +
1222
- (table.name ? ` // "${commentSafe(table.name)}"` : ""));
1208
+ (table.name ? ` // "${commentSafe(table.name)}"` : ''));
1223
1209
  lines.push(`);`);
1224
- lines.push("");
1210
+ lines.push('');
1225
1211
  }
1226
- return lines.join("\n");
1212
+ return lines.join('\n');
1227
1213
  }
1228
1214
  function generateBackendWrapperTs(envVarNames = []) {
1229
1215
  const names = [
1230
- "ZITE_APP_URL",
1231
- ...envVarNames.filter((n) => n !== "ZITE_APP_URL"),
1216
+ 'ZITE_APP_URL',
1217
+ ...envVarNames.filter(n => n !== 'ZITE_APP_URL'),
1232
1218
  ];
1233
1219
  return [
1234
- "// Auto-generated type-narrowing wrapper. Do not edit manually.",
1235
- "// Re-exports createEndpoint with context.user typed to the app User.",
1236
- "",
1220
+ '// Auto-generated type-narrowing wrapper. Do not edit manually.',
1221
+ '// Re-exports createEndpoint with context.user typed to the app User.',
1222
+ '',
1237
1223
  "import type { ZiteRequestContext as _ZiteRequestContext, ZiteScheduledContext, ZiteErrorCode, ZiteSchedule, ZiteStep, ZiteStreamInterface, ZiteTrigger, ZiteTriggerContext, ZiteEndpointInput, ZiteWebhook } from 'zitejs/backend/base';",
1238
1224
  "import type { User } from 'zitejs/auth';",
1239
- "",
1240
- "export type { ZiteErrorCode, ZiteSchedule, ZiteScheduledContext, ZiteStep, ZiteStreamInterface, ZiteTrigger, ZiteWebhook };",
1225
+ '',
1226
+ 'export type { ZiteErrorCode, ZiteSchedule, ZiteScheduledContext, ZiteStep, ZiteStreamInterface, ZiteTrigger, ZiteWebhook };',
1241
1227
  // A trigger's registration exports are typed against these, and they
1242
1228
  // only reach app code through this file.
1243
1229
  "export type { ZiteDatabaseTriggerEvent, ZiteDatabaseTriggerInput, ZiteFormTriggerInput, ZiteTriggerContext, ZiteTriggerDeliveryInfo, ZiteTriggerDeliveryRun, ZiteTriggerRun, ZiteTriggerSubscribe, ZiteTriggerSubscribeInput, ZiteTriggerSubscribeResult, ZiteTriggerUnsubscribe, ZiteTriggerUnsubscribeInput } from 'zitejs/backend/base';",
1244
1230
  // The pre-monorepo SDK put this in scope for every endpoint, so migrated
1245
1231
  // code can name it. `createEndpoint` infers the same thing without it.
1246
- "export type InferSchemaType<T> = T extends { _output: infer U } ? U : T;",
1247
- "",
1248
- "export class ZiteError extends Error {",
1249
- " code: ZiteErrorCode;",
1250
- " /** Short, non-technical message suitable for showing to an end user. */",
1251
- " userFacingMessage?: string;",
1232
+ 'export type InferSchemaType<T> = T extends { _output: infer U } ? U : T;',
1233
+ '',
1234
+ 'export class ZiteError extends Error {',
1235
+ ' code: ZiteErrorCode;',
1236
+ ' /** Short, non-technical message suitable for showing to an end user. */',
1237
+ ' userFacingMessage?: string;',
1252
1238
  " // Both shapes, mirroring the worker's own class: object form preferred,",
1253
- " // positional form is what pre-monorepo app code was written against.",
1254
- " constructor(options: { code: ZiteErrorCode; message: string; userFacingMessage?: string });",
1255
- " constructor(message: string, code?: ZiteErrorCode);",
1256
- " constructor(",
1257
- " optionsOrMessage: { code: ZiteErrorCode; message: string; userFacingMessage?: string } | string,",
1258
- " legacyCode?: ZiteErrorCode,",
1259
- " ) {",
1239
+ ' // positional form is what pre-monorepo app code was written against.',
1240
+ ' constructor(options: { code: ZiteErrorCode; message: string; userFacingMessage?: string });',
1241
+ ' constructor(message: string, code?: ZiteErrorCode);',
1242
+ ' constructor(',
1243
+ ' optionsOrMessage: { code: ZiteErrorCode; message: string; userFacingMessage?: string } | string,',
1244
+ ' legacyCode?: ZiteErrorCode,',
1245
+ ' ) {',
1260
1246
  " if (typeof optionsOrMessage === 'string') {",
1261
- " super(optionsOrMessage);",
1247
+ ' super(optionsOrMessage);',
1262
1248
  " this.code = legacyCode ?? 'INTERNAL_ERROR';",
1263
- " } else {",
1264
- " super(optionsOrMessage.message);",
1265
- " this.code = optionsOrMessage.code;",
1266
- " this.userFacingMessage = optionsOrMessage.userFacingMessage;",
1267
- " }",
1249
+ ' } else {',
1250
+ ' super(optionsOrMessage.message);',
1251
+ ' this.code = optionsOrMessage.code;',
1252
+ ' this.userFacingMessage = optionsOrMessage.userFacingMessage;',
1253
+ ' }',
1268
1254
  " this.name = 'ZiteError';",
1269
- " }",
1270
- "}",
1271
- "",
1255
+ ' }',
1256
+ '}',
1257
+ '',
1272
1258
  // Narrows `user` to this app's generated User. ZiteScheduledContext is
1273
1259
  // re-exported unchanged — a scheduled fire has no user at all, so there is
1274
1260
  // nothing to narrow.
1275
- "/**",
1276
- " * The user an endpoint sees. NOT the full `User` from zitejs/auth — that is",
1261
+ '/**',
1262
+ ' * The user an endpoint sees. NOT the full `User` from zitejs/auth — that is',
1277
1263
  " * the browser's better-auth session, and the runtime never sends its",
1278
- " * `name`, `emailVerified`, `image`, `createdAt` or `updatedAt` to an",
1279
- " * endpoint. Typing those here let `context.user.createdAt.getFullYear()`",
1280
- " * compile and throw. `Omit` keeps any index signature merged in by",
1281
- " * `.zite/user-extensions.d.ts`, so a migrated user-sync app still reads its",
1282
- " * synced columns off this.",
1283
- " *",
1284
- " * The `Pick` intersection is not redundant. On an app that DOES merge in",
1285
- " * `[key: string]: any`, `keyof User` widens to `string`, `Exclude` then",
1286
- " * removes nothing, and the `Omit` collapses to a bare index signature —",
1287
- " * which would silently degrade `user.id` from `string` to `any`. The `Pick`",
1288
- " * names those members explicitly, so they survive the collapse.",
1289
- " *",
1290
- " * Only `id` and `email` are pinned that way, deliberately. On a user-sync",
1291
- " * app `context.user` IS the synced row (`buildUserContext` returns it",
1292
- " * whole), and only those two are guaranteed by the runtime: the id is the",
1293
- " * record id and the email is merged in explicitly. `firstName`/`lastName`",
1294
- " * come from whatever the app mapped those columns to, so pinning them to",
1295
- " * `string` would reject a legitimate read on a table that types them",
1296
- " * differently. Non-widened apps get both from the `Omit` regardless.",
1297
- " *",
1298
- " * On such an app `user.createdAt` still compiles, as `any`. That is",
1299
- " * deliberate: a synced user table may legitimately have its own",
1300
- " * `createdAt` column, and typing it `never` to close the hole would break",
1301
- " * exactly the legacy apps `user-extensions.d.ts` exists to keep compiling.",
1302
- " */",
1303
- "export type ZiteEndpointUser = Omit<",
1304
- " User,",
1264
+ ' * `name`, `emailVerified`, `image`, `createdAt` or `updatedAt` to an',
1265
+ ' * endpoint. Typing those here let `context.user.createdAt.getFullYear()`',
1266
+ ' * compile and throw. `Omit` keeps any index signature merged in by',
1267
+ ' * `.zite/user-extensions.d.ts`, so a migrated user-sync app still reads its',
1268
+ ' * synced columns off this.',
1269
+ ' *',
1270
+ ' * The `Pick` intersection is not redundant. On an app that DOES merge in',
1271
+ ' * `[key: string]: any`, `keyof User` widens to `string`, `Exclude` then',
1272
+ ' * removes nothing, and the `Omit` collapses to a bare index signature —',
1273
+ ' * which would silently degrade `user.id` from `string` to `any`. The `Pick`',
1274
+ ' * names those members explicitly, so they survive the collapse.',
1275
+ ' *',
1276
+ ' * Only `id` and `email` are pinned that way, deliberately. On a user-sync',
1277
+ ' * app `context.user` IS the synced row (`buildUserContext` returns it',
1278
+ ' * whole), and only those two are guaranteed by the runtime: the id is the',
1279
+ ' * record id and the email is merged in explicitly. `firstName`/`lastName`',
1280
+ ' * come from whatever the app mapped those columns to, so pinning them to',
1281
+ ' * `string` would reject a legitimate read on a table that types them',
1282
+ ' * differently. Non-widened apps get both from the `Omit` regardless.',
1283
+ ' *',
1284
+ ' * On such an app `user.createdAt` still compiles, as `any`. That is',
1285
+ ' * deliberate: a synced user table may legitimately have its own',
1286
+ ' * `createdAt` column, and typing it `never` to close the hole would break',
1287
+ ' * exactly the legacy apps `user-extensions.d.ts` exists to keep compiling.',
1288
+ ' */',
1289
+ 'export type ZiteEndpointUser = Omit<',
1290
+ ' User,',
1305
1291
  " 'name' | 'emailVerified' | 'image' | 'createdAt' | 'updatedAt'",
1306
- "> &",
1292
+ '> &',
1307
1293
  " Pick<User, 'id' | 'email'> &",
1308
1294
  " Pick<_ZiteRequestContext['user'], 'roles'>;",
1309
- "",
1295
+ '',
1310
1296
  'export interface ZiteRequestContext extends Omit<_ZiteRequestContext, "user"> {',
1311
- " user: ZiteEndpointUser;",
1312
- "}",
1313
- "",
1314
- "type SchemaLike<TOut, TIn = TOut> = { _output: TOut; _input: TIn; parse: (data: unknown) => TOut };",
1315
- "",
1297
+ ' user: ZiteEndpointUser;',
1298
+ '}',
1299
+ '',
1300
+ 'type SchemaLike<TOut, TIn = TOut> = { _output: TOut; _input: TIn; parse: (data: unknown) => TOut };',
1301
+ '',
1316
1302
  // TStream mirrors zitejs/backend/base. Without it `stream: true` endpoints
1317
1303
  // get no `stream` argument here — and this wrapper, not the base module, is
1318
1304
  // what `zitejs/backend` resolves to in every app.
1319
- "export interface EndpointConfig<TInput = unknown, TOutput = unknown, TStream extends boolean = false, TSchedule extends ZiteSchedule | undefined = undefined, TWebhook extends ZiteWebhook | undefined = undefined, TRawInput = TInput, TTrigger extends ZiteTrigger | undefined = undefined> {",
1320
- " description?: string;",
1321
- " inputSchema?: SchemaLike<TInput, TRawInput>;",
1305
+ 'export interface EndpointConfig<TInput = unknown, TOutput = unknown, TStream extends boolean = false, TSchedule extends ZiteSchedule | undefined = undefined, TWebhook extends ZiteWebhook | undefined = undefined, TRawInput = TInput, TTrigger extends ZiteTrigger | undefined = undefined> {',
1306
+ ' description?: string;',
1307
+ ' inputSchema?: SchemaLike<TInput, TRawInput>;',
1322
1308
  // Apps compile against this copy, not the base module's.
1323
- " /** Documentation only. Never validated, and not an inference site for TOutput. */",
1324
- " outputSchema?: SchemaLike<unknown>;",
1325
- " stream?: TStream;",
1326
- " authenticated?: boolean;",
1327
- " /** When set, the endpoint also fires on this cron schedule. It stays request-callable — declaring one widens `context`, so `context.user` must be null-checked. */",
1328
- " schedule?: TSchedule;",
1329
- " /** When set, an inbound webhook can also trigger this endpoint. Like `schedule`, it widens `context` — a webhook fire has no session. */",
1330
- " webhook?: TWebhook;",
1309
+ ' /** Documentation only. Never validated, and not an inference site for TOutput. */',
1310
+ ' outputSchema?: SchemaLike<unknown>;',
1311
+ ' stream?: TStream;',
1312
+ ' authenticated?: boolean;',
1313
+ ' /** When set, the endpoint also fires on this cron schedule. It stays request-callable — declaring one widens `context`, so `context.user` must be null-checked. */',
1314
+ ' schedule?: TSchedule;',
1315
+ ' /** When set, an inbound webhook can also trigger this endpoint. Like `schedule`, it widens `context` — a webhook fire has no session. */',
1316
+ ' webhook?: TWebhook;',
1331
1317
  " /** When set, a connection's events (registered by this file's own `subscribe` export), a poll (`every`), a change to one of the project's tables (`table`) or a submission to one of its forms (`form`) also fire this endpoint. Like `webhook`, it widens `context` — a trigger fire has no session. */",
1332
- " trigger?: TTrigger;",
1333
- " execute: (",
1334
- " params: {",
1335
- " input: ZiteEndpointInput<TInput, TTrigger>;",
1318
+ ' trigger?: TTrigger;',
1319
+ ' execute: (',
1320
+ ' params: {',
1321
+ ' input: ZiteEndpointInput<TInput, TTrigger>;',
1336
1322
  ' /** Durable steps: step.run(name, fn) runs fn once per logical run — its result is saved before anything after it executes, and a resumed run replays completed steps from their saved results. In a run fired by a schedule, webhook or trigger, step.sleep(name, "2d") pauses the run and a failed step is tried again. Provided by the platform; never define a local stand-in. */',
1337
- " step: ZiteStep;",
1338
- " context: TSchedule extends ZiteSchedule ? ZiteRequestContext | ZiteScheduledContext : TWebhook extends ZiteWebhook ? ZiteRequestContext | ZiteScheduledContext : TTrigger extends ZiteTrigger ? ZiteRequestContext | ZiteScheduledContext : ZiteRequestContext;",
1323
+ ' step: ZiteStep;',
1324
+ ' context: TSchedule extends ZiteSchedule ? ZiteRequestContext | ZiteScheduledContext : TWebhook extends ZiteWebhook ? ZiteRequestContext | ZiteScheduledContext : TTrigger extends ZiteTrigger ? ZiteRequestContext | ZiteScheduledContext : ZiteRequestContext;',
1339
1325
  // Mirrors the base module: a trigger's run gets `trigger`.
1340
- " } & (TStream extends true ? { stream: ZiteStreamInterface } : {}) & (TTrigger extends ZiteTrigger ? { trigger?: ZiteTriggerContext<TTrigger> } : {}),",
1341
- " ) => Promise<TOutput> | TOutput;",
1342
- "}",
1343
- "",
1344
- "export function createEndpoint<TInput = unknown, TOutput = unknown, TStream extends boolean = false, TSchedule extends ZiteSchedule | undefined = undefined, TWebhook extends ZiteWebhook | undefined = undefined, TRawInput = TInput, TTrigger extends ZiteTrigger | undefined = undefined>(",
1345
- " config: EndpointConfig<TInput, TOutput, TStream, TSchedule, TWebhook, TRawInput, TTrigger>,",
1346
- "): EndpointConfig<TInput, TOutput, TStream, TSchedule, TWebhook, TRawInput, TTrigger> {",
1347
- " return config;",
1348
- "}",
1349
- "",
1350
- "/**",
1351
- " * Checks if a user has a specific role. Returns true if the user has the role, false",
1352
- " * otherwise. If the user is not logged in, returns false.",
1353
- " */",
1354
- "export const hasRole = (context: ZiteRequestContext, roleId: string) => {",
1355
- " return context.user?.roles?.some((r) => r.id === roleId);",
1356
- "};",
1357
- "",
1326
+ ' } & (TStream extends true ? { stream: ZiteStreamInterface } : {}) & (TTrigger extends ZiteTrigger ? { trigger?: ZiteTriggerContext<TTrigger> } : {}),',
1327
+ ' ) => Promise<TOutput> | TOutput;',
1328
+ '}',
1329
+ '',
1330
+ 'export function createEndpoint<TInput = unknown, TOutput = unknown, TStream extends boolean = false, TSchedule extends ZiteSchedule | undefined = undefined, TWebhook extends ZiteWebhook | undefined = undefined, TRawInput = TInput, TTrigger extends ZiteTrigger | undefined = undefined>(',
1331
+ ' config: EndpointConfig<TInput, TOutput, TStream, TSchedule, TWebhook, TRawInput, TTrigger>,',
1332
+ '): EndpointConfig<TInput, TOutput, TStream, TSchedule, TWebhook, TRawInput, TTrigger> {',
1333
+ ' return config;',
1334
+ '}',
1335
+ '',
1336
+ '/**',
1337
+ ' * Checks if a user has a specific role. Returns true if the user has the role, false',
1338
+ ' * otherwise. If the user is not logged in, returns false.',
1339
+ ' */',
1340
+ 'export const hasRole = (context: ZiteRequestContext, roleId: string) => {',
1341
+ ' return context.user?.roles?.some((r) => r.id === roleId);',
1342
+ '};',
1343
+ '',
1358
1344
  // Declared in the wrapper (not a standalone .d.ts) so the merge is
1359
1345
  // guaranteed to be in the program — every endpoint imports this file,
1360
1346
  // while tsconfig `include` does not reliably pick up dot-directories.
1361
- "declare global {",
1362
- " namespace NodeJS {",
1363
- " interface ProcessEnv {",
1364
- ...names.map((name) => ` ${JSON.stringify(name)}: string;`),
1365
- " }",
1366
- " }",
1367
- "}",
1368
- "",
1369
- ].join("\n");
1347
+ 'declare global {',
1348
+ ' namespace NodeJS {',
1349
+ ' interface ProcessEnv {',
1350
+ ...names.map(name => ` ${JSON.stringify(name)}: string;`),
1351
+ ' }',
1352
+ ' }',
1353
+ '}',
1354
+ '',
1355
+ ].join('\n');
1370
1356
  }
1371
1357
  /**
1372
1358
  * The key of the email integration an app sends through, which is the
@@ -1376,9 +1362,9 @@ function generateBackendWrapperTs(envVarNames = []) {
1376
1362
  function findEmailIntegrationId(appConfig, workspaceConfig) {
1377
1363
  const app = (appConfig ?? {});
1378
1364
  const workspace = (workspaceConfig ?? {});
1379
- const isEmail = (config, id) => config.integrations?.[id]?.type === "email";
1380
- return (Object.keys(app.integrations ?? {}).find((id) => isEmail(app, id)) ??
1381
- Object.keys(app.integrationSettings ?? {}).find((id) => isEmail(workspace, id)));
1365
+ const isEmail = (config, id) => config.integrations?.[id]?.type === 'email';
1366
+ return (Object.keys(app.integrations ?? {}).find(id => isEmail(app, id)) ??
1367
+ Object.keys(app.integrationSettings ?? {}).find(id => isEmail(workspace, id)));
1382
1368
  }
1383
1369
  /**
1384
1370
  * Generate `.zite/integrations/email.ts` — the `Email` client for an app with
@@ -1387,52 +1373,52 @@ function findEmailIntegrationId(appConfig, workspaceConfig) {
1387
1373
  * SDK bridge, resolved via the `zitejs/email` alias. `integrationId` is the
1388
1374
  * connected integration's key.
1389
1375
  */
1390
- function generateEmailSdk(integrationId) {
1376
+ function generateEmailSdk(integrationId, runtime = 'classic') {
1391
1377
  return [
1392
- "// Auto-generated by zitejs generate from zite.config.json. Do not edit manually.",
1393
- "// Email SDK — sends through the Zite email gateway via the runtime bridge.",
1394
- "//",
1395
- "// Usage in endpoint files (src/api/*.ts):",
1378
+ '// Auto-generated by zitejs generate from zite.config.json. Do not edit manually.',
1379
+ '// Email SDK — sends through the Zite email gateway via the runtime bridge.',
1380
+ '//',
1381
+ `// Usage in ${serverCodeIn(runtime)}:`,
1396
1382
  "// import { Email } from 'zitejs/email';",
1397
- "//",
1383
+ '//',
1398
1384
  "// Always use 'zitejs/email' — never a relative path like '../../.zite/integrations/email'.",
1399
- "// The tsconfig aliases resolve zitejs/* imports to the correct .zite/ files.",
1400
- "//",
1385
+ '// The tsconfig aliases resolve zitejs/* imports to the correct .zite/ files.',
1386
+ '//',
1401
1387
  "// await Email.send({ to, subject, html: '<p>...</p>' })",
1402
- "// => { success: boolean; messageId: string; warnings?: string[] }",
1403
- "//",
1404
- "// Emails written before html support pass `body` (blocks) instead; they",
1405
- "// keep working.",
1406
- "//",
1388
+ '// => { success: boolean; messageId: string; warnings?: string[] }',
1389
+ '//',
1390
+ '// Emails written before html support pass `body` (blocks) instead; they',
1391
+ '// keep working.',
1392
+ '//',
1407
1393
  "// RTL languages (Hebrew, Arabic): pass direction: 'rtl'.",
1408
- "//",
1409
- "// await Email.sendBatch([...]) // up to 100, results in order",
1394
+ '//',
1395
+ '// await Email.sendBatch([...]) // up to 100, results in order',
1410
1396
  "// await Email.get(messageId) // delivery status (Zite's sender only)",
1411
- "",
1397
+ '',
1412
1398
  "import { createEmailClient } from 'zitejs/runtime';",
1413
- "",
1414
- "export type {",
1415
- " EmailBlock,",
1416
- " EmailStatus,",
1417
- " SendBatchResult,",
1418
- " SendBlocksEmailParams,",
1419
- " SendEmailParams,",
1420
- " SendEmailResult,",
1421
- " SendHtmlEmailParams,",
1399
+ '',
1400
+ 'export type {',
1401
+ ' EmailBlock,',
1402
+ ' EmailStatus,',
1403
+ ' SendBatchResult,',
1404
+ ' SendBlocksEmailParams,',
1405
+ ' SendEmailParams,',
1406
+ ' SendEmailResult,',
1407
+ ' SendHtmlEmailParams,',
1422
1408
  "} from 'zitejs/runtime';",
1423
- "",
1409
+ '',
1424
1410
  `export const Email = createEmailClient(${tsSingleQuoted(integrationId)});`,
1425
- "",
1426
- ].join("\n");
1411
+ '',
1412
+ ].join('\n');
1427
1413
  }
1428
1414
  const connectedTypeFor = (serviceType) => {
1429
1415
  const extraLabels = rules_js_1.CREDENTIAL_FIELDS[serviceType].slice(1);
1430
1416
  const optional = rules_js_1.OPTIONAL_CREDENTIAL_FIELDS[serviceType] ?? [];
1431
1417
  return extraLabels.length === 0
1432
- ? "Connected"
1418
+ ? 'Connected'
1433
1419
  : `Connected<{ ${extraLabels
1434
- .map((label) => `${label}${optional.includes(label) ? "?" : ""}: string`)
1435
- .join("; ")} }>`;
1420
+ .map(label => `${label}${optional.includes(label) ? '?' : ''}: string`)
1421
+ .join('; ')} }>`;
1436
1422
  };
1437
1423
  /**
1438
1424
  * `.zite/integrations/index.ts`: `zitejs/integrations` for one source dir. The
@@ -1442,42 +1428,42 @@ const connectedTypeFor = (serviceType) => {
1442
1428
  function generateIntegrationsIndex(entries, opts) {
1443
1429
  const sorted = [...entries].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
1444
1430
  const nameUnion = sorted.length === 0
1445
- ? "never"
1446
- : sorted.map(({ name }) => tsSingleQuoted(name)).join(" | ");
1431
+ ? 'never'
1432
+ : sorted.map(({ name }) => tsSingleQuoted(name)).join(' | ');
1447
1433
  const byName = sorted.length === 0
1448
- ? ["export type IntegrationByName = {};"]
1434
+ ? ['export type IntegrationByName = {};']
1449
1435
  : [
1450
- "export type IntegrationByName = {",
1451
- ...sorted.map(({ name, serviceType, perUser }) => ` ${tsSingleQuoted(name)}: ${connectedTypeFor(serviceType)}${perUser ? " | NeedsConnect" : ""};`),
1452
- "};",
1436
+ 'export type IntegrationByName = {',
1437
+ ...sorted.map(({ name, serviceType, perUser }) => ` ${tsSingleQuoted(name)}: ${connectedTypeFor(serviceType)}${perUser ? ' | NeedsConnect' : ''};`),
1438
+ '};',
1453
1439
  ];
1454
1440
  return [
1455
- "// Auto-generated by zitejs generate from zite.config.json. Do not edit manually.",
1441
+ '// Auto-generated by zitejs generate from zite.config.json. Do not edit manually.',
1456
1442
  "// zitejs/integrations — an integration's credentials by its zite.config.json entry name.",
1457
- "//",
1458
- "// Usage in endpoints (src/api/*.ts) and automations (src/index.ts):",
1443
+ '//',
1444
+ '// Usage in endpoints (src/api/*.ts) and automations (src/index.ts):',
1459
1445
  "// import { integrations } from 'zitejs/integrations';",
1460
- "//",
1446
+ '//',
1461
1447
  "// const { accessToken } = await integrations.get('<entry name>');",
1462
- "//",
1448
+ '//',
1463
1449
  "// A workspace connection that isn't connected throws a ZiteError. A per-user",
1464
- "// entry answers `missing`/`expired` with a connectUrl for the signed-in user.",
1465
- "//",
1466
- "// Call get where the value is used, not once at module scope: a token refreshed",
1467
- "// mid-run is what the next call returns.",
1468
- "",
1450
+ '// entry answers `missing`/`expired` with a connectUrl for the signed-in user.',
1451
+ '//',
1452
+ '// Call get where the value is used, not once at module scope: a token refreshed',
1453
+ '// mid-run is what the next call returns.',
1454
+ '',
1469
1455
  // Not 'zitejs/integrations': apps alias that specifier to this very file.
1470
1456
  "import { createIntegrationsClient } from 'zitejs/runtime';",
1471
1457
  "import type { Connected, NeedsConnect } from 'zitejs/runtime';",
1472
- "",
1473
- ...(opts.reexportAirtable ? ["export * from './airtable';", ""] : []),
1474
- "export type { Connected, NeedsConnect };",
1475
- "",
1458
+ '',
1459
+ ...(opts.reexportAirtable ? ["export * from './airtable';", ''] : []),
1460
+ 'export type { Connected, NeedsConnect };',
1461
+ '',
1476
1462
  `export type IntegrationName = ${nameUnion};`,
1477
- "",
1463
+ '',
1478
1464
  ...byName,
1479
- "",
1480
- "export const integrations = createIntegrationsClient<IntegrationByName>();",
1481
- "",
1482
- ].join("\n");
1465
+ '',
1466
+ 'export const integrations = createIntegrationsClient<IntegrationByName>();',
1467
+ '',
1468
+ ].join('\n');
1483
1469
  }