zitejs 0.9.153 → 0.9.154

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