@builtbyfriends/bwf 0.0.0-stage → 1.9.1

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 (448) hide show
  1. package/AGENTS_TEMPLATE.md +4 -0
  2. package/LICENSE +22 -0
  3. package/README.md +48 -2
  4. package/dist/account-cmd-Cj0I2_bJ.mjs +45 -0
  5. package/dist/agents-BLiMq9E1.mjs +113 -0
  6. package/dist/application-analysis-C9Ck2Yeg.mjs +1498 -0
  7. package/dist/application-routing-DbR-W5lG.mjs +25 -0
  8. package/dist/atomic-write-DA6eD1Kp.mjs +17 -0
  9. package/dist/auth-BKsUmWbT.d.mts +77 -0
  10. package/dist/auth-DkvoW5hB.mjs +33 -0
  11. package/dist/auth-aKyIWkdS.mjs +1 -0
  12. package/dist/auth-client-6-Ft9i9T.d.mts +5 -0
  13. package/dist/auth-client-DwCdwKbw.mjs +5 -0
  14. package/dist/auth-client-react-CJdeErvM.mjs +5 -0
  15. package/dist/auth-client-react-DvQLe5Zb.d.mts +5 -0
  16. package/dist/auth-link-D-DddkCQ.mjs +26 -0
  17. package/dist/auth-migrations-DDeifS3v.mjs +206 -0
  18. package/dist/auth-router-tWzIwf8f.mjs +66 -0
  19. package/dist/auth-xnkmpZUl.mjs +311 -0
  20. package/dist/base64-ikl9yBy3.mjs +15 -0
  21. package/dist/better-auth-shared-Br6TNaYJ.mjs +473 -0
  22. package/dist/better-auth-shared-CsBNvPOU.d.mts +56 -0
  23. package/dist/build-cmd-BnZezraT.mjs +153 -0
  24. package/dist/build-output-dir-Clj_unKN.mjs +402 -0
  25. package/dist/cancel-deploy-DKAj5U1Z.mjs +57 -0
  26. package/dist/cf-access-Bhz9wX6p.mjs +131 -0
  27. package/dist/cf-access-CUP5L08W.mjs +67 -0
  28. package/dist/cf-build-output-DA6uJomQ.mjs +1 -0
  29. package/dist/cf-build-output-DNQTwMNU.mjs +438 -0
  30. package/dist/cf-command-values-2kOtxMo1.mjs +26 -0
  31. package/dist/cf-config-migrate-COOCi4Ge.mjs +330 -0
  32. package/dist/cf-worker-settings-CIh4t_yG.mjs +41 -0
  33. package/dist/cli/cli.d.mts +1 -0
  34. package/dist/cli/cli.mjs +88 -0
  35. package/dist/cli/cloudflare-operation-process.d.mts +1 -0
  36. package/dist/cli/cloudflare-operation-process.mjs +1284 -0
  37. package/dist/cli/env-schema-probe.d.mts +43 -0
  38. package/dist/cli/env-schema-probe.mjs +165 -0
  39. package/dist/cli-main-HeXRQml6.mjs +1846 -0
  40. package/dist/client-D3D5RM5h.mjs +940 -0
  41. package/dist/client-VF2Nzc7Z.mjs +1 -0
  42. package/dist/cloudflare-auth-jb-1e43r.mjs +152 -0
  43. package/dist/cloudflare-cmd-B62t8Fm-.mjs +59 -0
  44. package/dist/cloudflare-config-i8yanry0.mjs +186 -0
  45. package/dist/cloudflare-connect-x7IsYghw.mjs +55 -0
  46. package/dist/cloudflare-operations-BeK7bhnP.mjs +627 -0
  47. package/dist/cloudflare-operations-C3Uu0Emj.mjs +1 -0
  48. package/dist/cloudflare-process-Cc6oiJqk.mjs +309 -0
  49. package/dist/cloudflare-user-output-CqONaAbP.mjs +19 -0
  50. package/dist/collect-8i0wU63d.mjs +1 -0
  51. package/dist/collect-C6Blu9yw.mjs +48 -0
  52. package/dist/config-CN_RFRkS.mjs +86 -0
  53. package/dist/config-D5G-Tx6o.mjs +1 -0
  54. package/dist/config-DOaFIK3w.mjs +88 -0
  55. package/dist/config-entry.d.mts +202 -0
  56. package/dist/config-entry.mjs +6 -0
  57. package/dist/config-tNx0HlFv.mjs +516 -0
  58. package/dist/connect-hLPNppu3.mjs +84 -0
  59. package/dist/create-project-B35ux-LA.mjs +126 -0
  60. package/dist/create-project-tJ1KwNss.mjs +1 -0
  61. package/dist/database-provider-DkZo4VwN.mjs +5 -0
  62. package/dist/database-provider.d.mts +25 -0
  63. package/dist/database-provider.mjs +1 -0
  64. package/dist/db-BH_md90k.mjs +1735 -0
  65. package/dist/delete-BSKI7V23.mjs +65 -0
  66. package/dist/deploy-C8KHBNsh.mjs +6512 -0
  67. package/dist/deploy-DCZBr7Ey.mjs +2 -0
  68. package/dist/deploy.d.mts +31 -0
  69. package/dist/deploy.mjs +118 -0
  70. package/dist/dev-inbox-I0nqTCdf.mjs +216 -0
  71. package/dist/discover-DJPmQcL5.mjs +36 -0
  72. package/dist/discover-EVuydEoM.mjs +1 -0
  73. package/dist/dist-B6eN80gc.mjs +1612 -0
  74. package/dist/dist-Cp4b1_T9.mjs +1 -0
  75. package/dist/dist-DMYe8CZJ.mjs +48 -0
  76. package/dist/dist-STQXl8ck.mjs +1878 -0
  77. package/dist/domain-C4ZhEiFG.mjs +149 -0
  78. package/dist/dotenv-4NdUCXbB.mjs +156 -0
  79. package/dist/drizzle-DqVFXtlc.mjs +306 -0
  80. package/dist/drizzle-Ds5P0n-S.mjs +1 -0
  81. package/dist/edge.d.mts +2 -0
  82. package/dist/edge.mjs +1 -0
  83. package/dist/email-B3TWga7x.mjs +742 -0
  84. package/dist/email-C_ATvNIG.mjs +2865 -0
  85. package/dist/email-cloudflare-DuAc9zny.mjs +854 -0
  86. package/dist/email-protocol-CZ0bAkI8.mjs +81 -0
  87. package/dist/env-CTAo8ifZ.mjs +73 -0
  88. package/dist/env-DUyTzroe.mjs +88 -0
  89. package/dist/env-Dl4Wggec.mjs +71 -0
  90. package/dist/env-helpers-BX0APszT.mjs +135 -0
  91. package/dist/env-helpers-U56xuFgL.d.mts +20 -0
  92. package/dist/env-mask-BsHxq3R8.mjs +46 -0
  93. package/dist/env-public-Cw_xPi1D.d.mts +119 -0
  94. package/dist/env-raw-Bo6TtrHU.mjs +41 -0
  95. package/dist/env-types-Bg-dTh8u.mjs +56 -0
  96. package/dist/env-validation-BufZConV.mjs +488 -0
  97. package/dist/env-validation-DPqDo4DU.mjs +1 -0
  98. package/dist/fetch-CBgyyhzm.d.mts +87 -0
  99. package/dist/fetch-error-DmlRM6e4.mjs +264 -0
  100. package/dist/fetch-stream-2GUN3YN1.mjs +102 -0
  101. package/dist/fetch-stream-bUXynOyZ.d.mts +32 -0
  102. package/dist/fetch-tpPiSK10.mjs +25 -0
  103. package/dist/gen-dc13IRXh.mjs +509 -0
  104. package/dist/gen-kQqhFyOP.mjs +1 -0
  105. package/dist/generate-BgtlYpKg.mjs +1 -0
  106. package/dist/generate-Da9mWKzU.mjs +80 -0
  107. package/dist/generated-wrangler-config-CoDaaFsA.mjs +17 -0
  108. package/dist/git-metadata-Cukp5kV5.mjs +82 -0
  109. package/dist/github-cmd-DT5Onu6E.mjs +690 -0
  110. package/dist/handler-CJ7DiiRF.mjs +161 -0
  111. package/dist/handler-CVsIfRv7.d.mts +279 -0
  112. package/dist/help-Bpv6Qeqn.mjs +1946 -0
  113. package/dist/help-CfZ4Bsw5.mjs +1 -0
  114. package/dist/inbound-CqubE-9T.d.mts +311 -0
  115. package/dist/inbound-lHugZPuK.mjs +509 -0
  116. package/dist/index.d.mts +64 -0
  117. package/dist/index.mjs +4163 -0
  118. package/dist/info-CLQoCenb.mjs +109 -0
  119. package/dist/init-DRUR0j8C.mjs +2486 -0
  120. package/dist/limits-CMmYT2l8.d.mts +16 -0
  121. package/dist/limits-D27Lp6FP.mjs +46 -0
  122. package/dist/link-DinwJnon.mjs +52 -0
  123. package/dist/list-B84t4BhW.mjs +130 -0
  124. package/dist/live-Dui0-aj_.d.mts +105 -0
  125. package/dist/live-saC8barp.mjs +410 -0
  126. package/dist/load-user-env-g0ahkZcj.mjs +34 -0
  127. package/dist/local-d1-C3EeOV7-.mjs +103 -0
  128. package/dist/log-JDnPc0cF.mjs +23 -0
  129. package/dist/login-Bl5lH8nH.mjs +87 -0
  130. package/dist/login-DoI7AsbY.mjs +1 -0
  131. package/dist/logs-CaT2N2f7.mjs +129 -0
  132. package/dist/migrate-CbGscX-V.mjs +125 -0
  133. package/dist/migrate-Ce3JKLVs.mjs +1 -0
  134. package/dist/migration-handler-22qiuWPq.mjs +469 -0
  135. package/dist/migration-handler-Bb2BJh6g.d.mts +38 -0
  136. package/dist/mime-BMUN_QKG.mjs +1004 -0
  137. package/dist/mysql-migration-sql-CNuBSqdx.mjs +239 -0
  138. package/dist/neon-CJzQSycr.mjs +52 -0
  139. package/dist/node-tfv-3v0V.mjs +64 -0
  140. package/dist/operator-ai-logging-Ay7M4KWw.mjs +121 -0
  141. package/dist/operator-args-BFg32YyY.mjs +722 -0
  142. package/dist/operator-auth-DdYZYEkO.mjs +47 -0
  143. package/dist/operator-client-DBujdELO.mjs +82 -0
  144. package/dist/operator-cmd-C73WWJBl.mjs +443 -0
  145. package/dist/operator-cmd-CdZytuAF.mjs +1 -0
  146. package/dist/output-Bb34lF0w.mjs +173 -0
  147. package/dist/output-CVolXKC1.mjs +1 -0
  148. package/dist/package-DO4d3Qz5.mjs +1444 -0
  149. package/dist/package-json-DvS6IFRv.mjs +43 -0
  150. package/dist/pg-DoyPxa_X.mjs +15 -0
  151. package/dist/picocolors-D1NxSLw-.mjs +71 -0
  152. package/dist/plan-BHNt1QhK.mjs +1 -0
  153. package/dist/plan-DX4_-OM5.mjs +58 -0
  154. package/dist/platform-args-NI_vfWvD.mjs +538 -0
  155. package/dist/platform-args-ZC1-A1N9.mjs +1 -0
  156. package/dist/platform-auth-config-d-lY5-aY.mjs +371 -0
  157. package/dist/platform-auth-protection-Dhw7lUCk.mjs +231 -0
  158. package/dist/platform-auth-recovery-DaCc0tlx.mjs +309 -0
  159. package/dist/platform-cmd-5Ry-C9im.mjs +193 -0
  160. package/dist/platform-cmd-5oZq91lI.mjs +1 -0
  161. package/dist/platform-discovery-Bxg9aZXU.mjs +40 -0
  162. package/dist/platform-domain-DLVdGvGG.mjs +256 -0
  163. package/dist/platform-lifecycle-CUgjipXO.mjs +1 -0
  164. package/dist/platform-lifecycle-fRt5VMls.mjs +8928 -0
  165. package/dist/platform-management-5hEsRfR2.mjs +1 -0
  166. package/dist/platform-management-Djh1hzLP.mjs +1607 -0
  167. package/dist/platform-plans-config-CkbUKFpm.mjs +447 -0
  168. package/dist/platform-recovery-Cghx7FCR.mjs +96 -0
  169. package/dist/platform-registry-x1m9HBxf.mjs +450 -0
  170. package/dist/platform-runtime-logs-kkoiYFpF.mjs +72 -0
  171. package/dist/platform-setup-SfwCwnZg.mjs +306 -0
  172. package/dist/prepare-B9mB47T5.mjs +84 -0
  173. package/dist/prepare-DNIq07so.mjs +13 -0
  174. package/dist/prepare-LHkyJqxi.mjs +1 -0
  175. package/dist/project-CC7eN00D.mjs +141 -0
  176. package/dist/project-DcSd4BeI.mjs +1 -0
  177. package/dist/project-cmd-DTF19-fC.mjs +109 -0
  178. package/dist/project-paths-iXHKRTTQ.mjs +159 -0
  179. package/dist/project-slug-BUy0lmyR.mjs +1 -0
  180. package/dist/project-slug-CO6ci9XG.mjs +7 -0
  181. package/dist/project-team-CvdLhDF2.mjs +129 -0
  182. package/dist/project-token-CwZdUEGu.mjs +70 -0
  183. package/dist/project-tsconfig-P9X952KG.mjs +98 -0
  184. package/dist/project-zero-trust-CKDoPdN1.mjs +64 -0
  185. package/dist/providers-Cd3c7wi0.mjs +64 -0
  186. package/dist/providers-Df69hb_X.d.mts +5 -0
  187. package/dist/provision-DGlFJ3T9.mjs +1 -0
  188. package/dist/provision-mYVLuQiy.mjs +1814 -0
  189. package/dist/queues-Bc3FsBQT.d.mts +5 -0
  190. package/dist/r2-conditions-DSLmkiR5.mjs +60 -0
  191. package/dist/requests-DNhfyF3l.mjs +52 -0
  192. package/dist/resolve-project-BCsAMDRA.mjs +47 -0
  193. package/dist/resolve-project-DhU9_lIo.mjs +1 -0
  194. package/dist/resource-name-DlJ9QXzg.mjs +10 -0
  195. package/dist/response-HmNjB30w.mjs +29 -0
  196. package/dist/rollback-BvCHol52.mjs +150 -0
  197. package/dist/rolldown-runtime-uD8oG6U2.mjs +24 -0
  198. package/dist/route-types-CRWhr93D.mjs +592 -0
  199. package/dist/route-url-BIDZT78M.mjs +58 -0
  200. package/dist/route-url-Bla3Upsy.d.mts +42 -0
  201. package/dist/routes-stub.d.mts +24 -0
  202. package/dist/routes-stub.mjs +1 -0
  203. package/dist/routing-assets-CSheDWWM.mjs +54 -0
  204. package/dist/rpc-DcByS_q0.d.mts +39 -0
  205. package/dist/rpc-DtxIN9Tv.mjs +19 -0
  206. package/dist/runner-CPerdjIl.mjs +163 -0
  207. package/dist/runner-CUNtS5x7.mjs +1 -0
  208. package/dist/runner-mysql-7aA5hGoM.mjs +145 -0
  209. package/dist/runner-mysql-DrMKw203.mjs +1 -0
  210. package/dist/runner-pg-2pjltt0t.mjs +1 -0
  211. package/dist/runner-pg-mYc75KfH.mjs +61 -0
  212. package/dist/runtime/ai.d.mts +50 -0
  213. package/dist/runtime/ai.mjs +455 -0
  214. package/dist/runtime/auth-client-react.d.mts +2 -0
  215. package/dist/runtime/auth-client-react.mjs +1 -0
  216. package/dist/runtime/auth-client.d.mts +2 -0
  217. package/dist/runtime/auth-client.mjs +1 -0
  218. package/dist/runtime/auth.d.mts +2 -0
  219. package/dist/runtime/auth.mjs +1 -0
  220. package/dist/runtime/better-auth-mysql.d.mts +5 -0
  221. package/dist/runtime/better-auth-mysql.mjs +21 -0
  222. package/dist/runtime/better-auth-pg.d.mts +5 -0
  223. package/dist/runtime/better-auth-pg.mjs +21 -0
  224. package/dist/runtime/better-auth.d.mts +6 -0
  225. package/dist/runtime/better-auth.mjs +22 -0
  226. package/dist/runtime/client-react.d.mts +5 -0
  227. package/dist/runtime/client-react.mjs +5 -0
  228. package/dist/runtime/client.d.mts +5 -0
  229. package/dist/runtime/client.mjs +5 -0
  230. package/dist/runtime/db-mysql.d.mts +2 -0
  231. package/dist/runtime/db-mysql.mjs +1 -0
  232. package/dist/runtime/db-pg.d.mts +2 -0
  233. package/dist/runtime/db-pg.mjs +1 -0
  234. package/dist/runtime/db.d.mts +17 -0
  235. package/dist/runtime/db.mjs +36 -0
  236. package/dist/runtime/drizzle-arktype.d.mts +1 -0
  237. package/dist/runtime/drizzle-arktype.mjs +2 -0
  238. package/dist/runtime/drizzle-valibot.d.mts +1 -0
  239. package/dist/runtime/drizzle-valibot.mjs +2 -0
  240. package/dist/runtime/drizzle-zod.d.mts +1 -0
  241. package/dist/runtime/drizzle-zod.mjs +2 -0
  242. package/dist/runtime/durable.d.mts +64 -0
  243. package/dist/runtime/durable.mjs +165 -0
  244. package/dist/runtime/email/testing.d.mts +108 -0
  245. package/dist/runtime/email/testing.mjs +268 -0
  246. package/dist/runtime/email-protocol.d.mts +25 -0
  247. package/dist/runtime/email-protocol.mjs +1 -0
  248. package/dist/runtime/email.d.mts +26 -0
  249. package/dist/runtime/email.mjs +524 -0
  250. package/dist/runtime/env-public-client.d.mts +19 -0
  251. package/dist/runtime/env-public-client.mjs +55 -0
  252. package/dist/runtime/env-public.d.mts +4 -0
  253. package/dist/runtime/env-public.mjs +277 -0
  254. package/dist/runtime/env.d.mts +12 -0
  255. package/dist/runtime/env.mjs +1 -0
  256. package/dist/runtime/fetch-server.d.mts +6 -0
  257. package/dist/runtime/fetch-server.mjs +29 -0
  258. package/dist/runtime/fetch-stream.d.mts +3 -0
  259. package/dist/runtime/fetch-stream.mjs +3 -0
  260. package/dist/runtime/fetch.d.mts +2 -0
  261. package/dist/runtime/fetch.mjs +3 -0
  262. package/dist/runtime/handler.d.mts +3 -0
  263. package/dist/runtime/handler.mjs +1 -0
  264. package/dist/runtime/kv.d.mts +45 -0
  265. package/dist/runtime/kv.mjs +103 -0
  266. package/dist/runtime/limits.d.mts +2 -0
  267. package/dist/runtime/limits.mjs +1 -0
  268. package/dist/runtime/live-client.d.mts +40 -0
  269. package/dist/runtime/live-client.mjs +282 -0
  270. package/dist/runtime/live-server.d.mts +11 -0
  271. package/dist/runtime/live-server.mjs +419 -0
  272. package/dist/runtime/live.d.mts +3 -0
  273. package/dist/runtime/live.mjs +1 -0
  274. package/dist/runtime/log.d.mts +24 -0
  275. package/dist/runtime/log.mjs +57 -0
  276. package/dist/runtime/migration-handler-mysql.d.mts +2 -0
  277. package/dist/runtime/migration-handler-mysql.mjs +111 -0
  278. package/dist/runtime/migration-handler-pg.d.mts +2 -0
  279. package/dist/runtime/migration-handler-pg.mjs +94 -0
  280. package/dist/runtime/migration-handler.d.mts +2 -0
  281. package/dist/runtime/migration-handler.mjs +1 -0
  282. package/dist/runtime/procedure.d.mts +27 -0
  283. package/dist/runtime/procedure.mjs +36 -0
  284. package/dist/runtime/procedures.d.mts +24 -0
  285. package/dist/runtime/procedures.mjs +56 -0
  286. package/dist/runtime/queues.d.mts +2 -0
  287. package/dist/runtime/queues.mjs +8 -0
  288. package/dist/runtime/remote/binding-handler.d.mts +11 -0
  289. package/dist/runtime/remote/binding-handler.mjs +227 -0
  290. package/dist/runtime/remote/index.d.mts +12 -0
  291. package/dist/runtime/remote/index.mjs +467 -0
  292. package/dist/runtime/response.d.mts +11 -0
  293. package/dist/runtime/response.mjs +1 -0
  294. package/dist/runtime/route-url.d.mts +2 -0
  295. package/dist/runtime/route-url.mjs +1 -0
  296. package/dist/runtime/routing.d.mts +53 -0
  297. package/dist/runtime/routing.mjs +425 -0
  298. package/dist/runtime/rpc-react.d.mts +16 -0
  299. package/dist/runtime/rpc-react.mjs +50 -0
  300. package/dist/runtime/rpc.d.mts +2 -0
  301. package/dist/runtime/rpc.mjs +1 -0
  302. package/dist/runtime/sandbox-container.d.mts +3 -0
  303. package/dist/runtime/sandbox-container.mjs +1 -0
  304. package/dist/runtime/sandbox.d.mts +5 -0
  305. package/dist/runtime/sandbox.mjs +196 -0
  306. package/dist/runtime/schema-d1.d.mts +1 -0
  307. package/dist/runtime/schema-d1.mjs +2 -0
  308. package/dist/runtime/schema-mysql.d.mts +1 -0
  309. package/dist/runtime/schema-mysql.mjs +2 -0
  310. package/dist/runtime/schema-pg.d.mts +1 -0
  311. package/dist/runtime/schema-pg.mjs +2 -0
  312. package/dist/runtime/seed.d.mts +34 -0
  313. package/dist/runtime/seed.mjs +5 -0
  314. package/dist/runtime/sse-client.d.mts +31 -0
  315. package/dist/runtime/sse-client.mjs +42 -0
  316. package/dist/runtime/sse.d.mts +32 -0
  317. package/dist/runtime/sse.mjs +1 -0
  318. package/dist/runtime/storage.d.mts +4 -0
  319. package/dist/runtime/storage.mjs +13 -0
  320. package/dist/runtime/validator.d.mts +2 -0
  321. package/dist/runtime/validator.mjs +1 -0
  322. package/dist/runtime/ws-server.d.mts +26 -0
  323. package/dist/runtime/ws-server.mjs +297 -0
  324. package/dist/runtime/ws.d.mts +2 -0
  325. package/dist/runtime/ws.mjs +108 -0
  326. package/dist/sandbox-CWDjoEG2.d.mts +50 -0
  327. package/dist/sandbox-container-BqamdFCx.d.mts +73 -0
  328. package/dist/sandbox-container-d1AHLpgn.mjs +291 -0
  329. package/dist/secret-DCF9RXTc.mjs +146 -0
  330. package/dist/skills-Dr3AjuBF.mjs +63 -0
  331. package/dist/sqlite-validation-CLJXXN93.mjs +24 -0
  332. package/dist/sse-CxR30yMF.mjs +174 -0
  333. package/dist/standard-schema-CuDawHOC.d.mts +40 -0
  334. package/dist/static-asset-marker-mWMX2dLa.mjs +38 -0
  335. package/dist/subcommand-prompt-B9yUo--u.mjs +370 -0
  336. package/dist/terminal-log-text-DNsWJREL.mjs +31 -0
  337. package/dist/types-D7-4tBu7.d.mts +1 -0
  338. package/dist/untrusted-env-lL7RkYiC.mjs +50 -0
  339. package/dist/validate-B-zsjhiz.mjs +162 -0
  340. package/dist/validate-DbqGdPPY.mjs +1 -0
  341. package/dist/validator-8-NZs2Xr.mjs +168 -0
  342. package/dist/version-metadata-DsSoNsKJ.mjs +23 -0
  343. package/dist/wrangler-DU784Dkf.mjs +1452 -0
  344. package/dist/wrangler-Rr9_76DQ.mjs +1 -0
  345. package/dist/ws-Q_osq9VK.d.mts +137 -0
  346. package/dist/yarn-pnp-DgWbE7z5.mjs +91 -0
  347. package/docs/guide/ai.md +273 -0
  348. package/docs/guide/app-types.md +101 -0
  349. package/docs/guide/auth.md +255 -0
  350. package/docs/guide/database/d1.md +86 -0
  351. package/docs/guide/database/mysql.md +72 -0
  352. package/docs/guide/database/postgresql.md +94 -0
  353. package/docs/guide/database.md +454 -0
  354. package/docs/guide/deployment.md +124 -0
  355. package/docs/guide/durable-state.md +192 -0
  356. package/docs/guide/edge/headers.md +47 -0
  357. package/docs/guide/edge/redirects.md +85 -0
  358. package/docs/guide/edge/rewrites.md +119 -0
  359. package/docs/guide/edge/static-assets.md +94 -0
  360. package/docs/guide/email/domains.md +119 -0
  361. package/docs/guide/email/receiving.md +142 -0
  362. package/docs/guide/email/sending.md +262 -0
  363. package/docs/guide/email.md +23 -0
  364. package/docs/guide/env-vars.md +115 -0
  365. package/docs/guide/index.md +37 -0
  366. package/docs/guide/jobs.md +80 -0
  367. package/docs/guide/kv.md +100 -0
  368. package/docs/guide/live.md +181 -0
  369. package/docs/guide/platform/administration/access.md +165 -0
  370. package/docs/guide/platform/administration/connected-apps.md +84 -0
  371. package/docs/guide/platform/administration/email.md +169 -0
  372. package/docs/guide/platform/administration/operations.md +100 -0
  373. package/docs/guide/platform/administration/plans.md +156 -0
  374. package/docs/guide/platform/administration/projects.md +74 -0
  375. package/docs/guide/platform/administration/zero-trust.md +205 -0
  376. package/docs/guide/platform/development/local.md +122 -0
  377. package/docs/guide/platform/development/runtime.md +115 -0
  378. package/docs/guide/platform/development/schema-ci.md +44 -0
  379. package/docs/guide/platform/installation/ci.md +62 -0
  380. package/docs/guide/platform/installation/credentials.md +140 -0
  381. package/docs/guide/platform/installation/domains.md +120 -0
  382. package/docs/guide/platform/installation/first-deployment.md +95 -0
  383. package/docs/guide/platform/installation/maintenance.md +250 -0
  384. package/docs/guide/platform/installation/prerequisites.md +176 -0
  385. package/docs/guide/platform/installation/setup.md +300 -0
  386. package/docs/guide/platform/installation/uninstall.md +110 -0
  387. package/docs/guide/platform-administration.md +19 -0
  388. package/docs/guide/platform-development.md +16 -0
  389. package/docs/guide/procedures.md +48 -0
  390. package/docs/guide/project-collaboration.md +99 -0
  391. package/docs/guide/queues.md +149 -0
  392. package/docs/guide/quickstart.md +129 -0
  393. package/docs/guide/remote-dev.md +67 -0
  394. package/docs/guide/sandboxes.md +134 -0
  395. package/docs/guide/self-hosted-platform.md +45 -0
  396. package/docs/guide/server-routing.md +283 -0
  397. package/docs/guide/sse.md +174 -0
  398. package/docs/guide/storage.md +82 -0
  399. package/docs/guide/testing.md +64 -0
  400. package/docs/guide/type-safety.md +270 -0
  401. package/docs/guide/typed-fetch.md +98 -0
  402. package/docs/guide/websockets.md +230 -0
  403. package/docs/index.md +102 -0
  404. package/docs/integrations/agents.md +38 -0
  405. package/docs/integrations/cloudflare.md +241 -0
  406. package/docs/integrations/hono.md +127 -0
  407. package/docs/reference/api/auth.md +195 -0
  408. package/docs/reference/api/client.md +90 -0
  409. package/docs/reference/api/database.md +118 -0
  410. package/docs/reference/api/deploy.md +63 -0
  411. package/docs/reference/api/durable.md +47 -0
  412. package/docs/reference/api/env.md +51 -0
  413. package/docs/reference/api/handlers.md +189 -0
  414. package/docs/reference/api/plugin.md +40 -0
  415. package/docs/reference/api/resources.md +116 -0
  416. package/docs/reference/api/rewrites.md +111 -0
  417. package/docs/reference/api/types.md +126 -0
  418. package/docs/reference/api.md +71 -0
  419. package/docs/reference/cli/auth.md +87 -0
  420. package/docs/reference/cli/database.md +159 -0
  421. package/docs/reference/cli/deploy.md +117 -0
  422. package/docs/reference/cli/domains.md +42 -0
  423. package/docs/reference/cli/email.md +145 -0
  424. package/docs/reference/cli/generate.md +113 -0
  425. package/docs/reference/cli/github.md +181 -0
  426. package/docs/reference/cli/platform-config.md +93 -0
  427. package/docs/reference/cli/platform-email.md +81 -0
  428. package/docs/reference/cli/platform-installation.md +166 -0
  429. package/docs/reference/cli/platform-operations.md +90 -0
  430. package/docs/reference/cli/platform-users.md +159 -0
  431. package/docs/reference/cli/platform-zero-trust.md +60 -0
  432. package/docs/reference/cli/platform.md +78 -0
  433. package/docs/reference/cli/project.md +208 -0
  434. package/docs/reference/cli/secrets.md +79 -0
  435. package/docs/reference/cli/setup.md +88 -0
  436. package/docs/reference/cli.md +115 -0
  437. package/docs/reference/config.md +478 -0
  438. package/docs/reference/resource-inference.md +72 -0
  439. package/docs/reference/structure.md +138 -0
  440. package/package.json +389 -3
  441. package/sandbox.Dockerfile +4 -0
  442. package/schema.json +353 -0
  443. package/skills/bwf/SKILL.md +100 -0
  444. package/skills/migrate-vite-cloudflare-to-bwf/SKILL.md +53 -0
  445. package/templates/assets/bwf.svg +5 -0
  446. package/templates/assets/icons.svg +49 -0
  447. package/templates/assets/react.svg +1 -0
  448. package/templates/assets/stack.svg +35 -0
@@ -0,0 +1,42 @@
1
+ import { EncodedRoutePathMap, RoutePathMap, RouteTypesConfig } from "@builtbyfriends/bwf/routes";
2
+ /** Expand complete route tokens without changing query strings or fragments. */
3
+ declare function interpolateRouteParams(path: string, params?: Record<string, string>, requireParams?: boolean): string;
4
+ /** Known page, HTTP and WebSocket route patterns. */
5
+ type RoutePath = keyof RoutePathMap & string;
6
+ type RouteUrlSegment<S extends string> = S extends `:${string}` | `[${string}]` | "*" ? string : S;
7
+ type RouteSegmentsUrl<P extends string> = P extends `${infer Segment}/${infer Rest}` ? `${RouteUrlSegment<Segment>}/${RouteSegmentsUrl<Rest>}` : RouteUrlSegment<P>;
8
+ type RoutePatternUrl<P extends string> = P extends `${infer Prefix}/${"*" | "[...]"}/` ? `${RouteSegmentsUrl<Prefix>}/` | `${RouteSegmentsUrl<Prefix>}/${string}/` : P extends `${infer Prefix}/${"*" | "[...]"}` ? (Prefix extends "" ? "/" : RouteSegmentsUrl<Prefix>) | `${RouteSegmentsUrl<Prefix>}/${string}` : RouteSegmentsUrl<P>;
9
+ type EncodedRoutePath = EncodedRoutePathMap[keyof EncodedRoutePathMap] & string;
10
+ type RoutePathUrl = RoutePatternUrl<RoutePath | EncodedRoutePath>;
11
+ /** Whether `routing.typedRoutes` is on in the generated route types. */
12
+ type TypedRoutes = RouteTypesConfig extends {
13
+ typedRoutes: true;
14
+ } ? true : false;
15
+ /** The URL of one of the app's routes. A plain string unless `routing.typedRoutes` is on. */
16
+ type RouteUrl$1 = TypedRoutes extends true ? RoutePathUrl | `${RoutePathUrl}${"?" | "#"}${string}` : string;
17
+ /** Anything a link can point to: a route URL, a same-page query or hash, or an external URL. */
18
+ type Href = TypedRoutes extends true ? RouteUrl$1 | `${"?" | "#"}${string}` | `${"http://" | "https://" | "mailto:" | "tel:"}${string}` : string;
19
+ /**
20
+ * A URL an HTTP request can target: one of the app's routes or an absolute
21
+ * `http://`/`https://` URL. A plain string unless `routing.typedRoutes` is on.
22
+ */
23
+ type RequestUrl = TypedRoutes extends true ? RouteUrl$1 | `${"http://" | "https://"}${string}` : string;
24
+ type RouteQueryValue = string | number | boolean | null | undefined;
25
+ type RouteQuery = Record<string, RouteQueryValue | ReadonlyArray<RouteQueryValue>>;
26
+ type RouteOptions<P extends RoutePath> = {
27
+ query?: RouteQuery;
28
+ hash?: string;
29
+ } & ([RoutePathMap[P]] extends [never] ? {
30
+ params?: never;
31
+ } : {
32
+ params: { [K in RoutePathMap[P] & string]: string | number; };
33
+ });
34
+ type RouteDestination$1<P extends RoutePath = RoutePath> = P extends RoutePath ? {
35
+ pathname: P;
36
+ } & RouteOptions<P> : never;
37
+ type RouteUrlInput$1 = Href | URL | RouteDestination$1;
38
+ /** Build a relative URL from a known route pattern. */
39
+ declare function routeUrl<P extends RoutePath>(path: P, ...args: [RoutePathMap[NoInfer<P>]] extends [never] ? [options?: RouteOptions<P>] : [options: RouteOptions<P>]): RouteUrl$1;
40
+ /** @internal Convert navigation inputs to URL strings without requiring an origin. */
41
+ declare function toUrlString(value: RouteUrlInput$1): string;
42
+ export { RoutePath as a, RouteUrl$1 as c, interpolateRouteParams as d, routeUrl as f, RouteOptions as i, RouteUrlInput$1 as l, RequestUrl as n, RouteQuery as o, toUrlString as p, RouteDestination$1 as r, RouteQueryValue as s, Href as t, TypedRoutes as u };
@@ -0,0 +1,24 @@
1
+ import { a as RoutePath, c as RouteUrl, f as routeUrl, i as RouteOptions, l as RouteUrlInput, o as RouteQuery, r as RouteDestination, s as RouteQueryValue, t as Href } from "./route-url-Bla3Upsy.mjs";
2
+ /** Known URL patterns and their parameter names, augmented by .bwf/routes.d.ts. */
3
+ export interface RoutePathMap {}
4
+ /** Percent-encoded spellings of patterns with encoded fixed segments, augmented by .bwf/routes.d.ts. */
5
+ export interface EncodedRoutePathMap {}
6
+ /** Route type options, augmented by .bwf/routes.d.ts when `routing.typedRoutes` is on. */
7
+ export interface RouteTypesConfig {}
8
+ /** Stub interface augmented by the generated .bwf/routes.d.ts */
9
+ export interface RouteMap {}
10
+ /** Stub interface augmented by the generated .bwf/routes.d.ts */
11
+ export interface WebSocketRouteMap {}
12
+ /** Union of known route patterns (keys of the generated RouteMap). */
13
+ export type RouteName = keyof RouteMap;
14
+ /**
15
+ * Destination type for rewrites / fallbacks / c.rewrite().
16
+ *
17
+ * The `string & {}` branch keeps IDE autocomplete of known routes while
18
+ * still accepting arbitrary strings (needed for dynamic paths like
19
+ * `/users/${id}`). When no routes are generated yet, `RouteName` is
20
+ * `never` and this degenerates to `string & {}`, which is assignable
21
+ * from any string.
22
+ */
23
+ export type RewriteDestination = RouteName | (string & {});
24
+ export { type Href, type RouteDestination, type RouteOptions, type RoutePath, type RouteQuery, type RouteQueryValue, type RouteUrl, type RouteUrlInput, routeUrl };
@@ -0,0 +1 @@
1
+ export { n as routeUrl } from "./route-url-BIDZT78M.mjs";
@@ -0,0 +1,54 @@
1
+ // src/runtime/routing-assets.ts
2
+ const ASSET_EXTENSIONS = [
3
+ "png",
4
+ "jpg",
5
+ "jpeg",
6
+ "gif",
7
+ "webp",
8
+ "avif",
9
+ "svg",
10
+ "ico",
11
+ "css",
12
+ "js",
13
+ "mjs",
14
+ "cjs",
15
+ "woff",
16
+ "woff2",
17
+ "ttf",
18
+ "otf",
19
+ "eot",
20
+ "mp4",
21
+ "webm",
22
+ "mp3",
23
+ "wav",
24
+ "pdf",
25
+ "txt",
26
+ "xml",
27
+ "json",
28
+ "wasm",
29
+ "map"
30
+ ];
31
+ function createManifestLoader() {
32
+ let cached = null;
33
+ let pending = null;
34
+ return async (request, env) => {
35
+ if (cached) return cached;
36
+ const injected = globalThis.__VITE_MANIFEST__;
37
+ if (typeof injected === "object" && injected) {
38
+ cached = injected;
39
+ return cached;
40
+ }
41
+ const assets = env?.ASSETS;
42
+ if (!assets || typeof assets.fetch !== "function") return null;
43
+ pending ??= (async () => {
44
+ const response = await assets.fetch(new Request(new URL("/.vite/manifest.json", request.url).toString()));
45
+ if (!response.ok) return null;
46
+ cached = await response.json();
47
+ return cached;
48
+ })().finally(() => {
49
+ pending = null;
50
+ });
51
+ return pending;
52
+ };
53
+ }
54
+ export { createManifestLoader as n, ASSET_EXTENSIONS as t };
@@ -0,0 +1,39 @@
1
+ import { ErrorsOf, InputOf, OutputOf } from "@builtbyfriends/realtime";
2
+ import { RpcError } from "@builtbyfriends/realtime-http/client";
3
+ /**
4
+ * Every procedure in `procedures/`, by name. The generated `.bwf/procedures.d.ts` fills this
5
+ * in, so `rpc.contacts.get(...)` is typed from the procedure itself and no server code
6
+ * reaches the browser.
7
+ */
8
+ interface ProcedureMap {}
9
+ /**
10
+ * The procedures a module exports, named from its file: `procedures/billing/invoices.ts`
11
+ * exporting `list` is `billing.invoices.list`, and a default export takes the file's name.
12
+ * Generated code uses this; apps don't.
13
+ */
14
+ type ModuleProcedures<Module, Prefix extends string> = { [Key in keyof Module & string as Module[Key] extends {
15
+ "~realtime": "procedure";
16
+ } ? Key extends "default" ? Prefix : Prefix extends "" ? Key : `${Prefix}.${Key}` : never]: Module[Key]; };
17
+ /** One procedure as a function: pass its input, get its output, or a thrown `RpcError`. */
18
+ type RpcCall<Procedure> = undefined extends InputOf<Procedure> ? (input?: InputOf<Procedure>) => Promise<OutputOf<Procedure>> : (input: InputOf<Procedure>) => Promise<OutputOf<Procedure>>;
19
+ /** The error codes a procedure declares, for narrowing a caught `RpcError`. */
20
+ type RpcErrorCode<Procedure> = ErrorsOf<Procedure>;
21
+ type Nest<Name extends string, Leaf> = Name extends `${infer Head}.${infer Rest}` ? { [Key in Head]: Nest<Rest, Leaf>; } : { [Key in Name]: Leaf; };
22
+ type Intersect<Union> = (Union extends unknown ? (value: Union) => void : never) extends ((value: infer All) => void) ? All : never;
23
+ /** `rpc.contacts.get`, `rpc.billing.invoices.list`: the procedure names as nested calls. */
24
+ type RpcClient<Procedures = ProcedureMap> = [keyof Procedures] extends [never] ? Record<string, unknown> : Intersect<{ [Name in keyof Procedures & string]: Nest<Name, RpcCall<Procedures[Name]>>; }[keyof Procedures & string]>;
25
+ type RpcOptions = {
26
+ /** Where the app is served from. Leave out in the browser to call the same origin. */
27
+ baseUrl?: string;
28
+ /** Sent as `Authorization: Bearer ...`, for the CLI, agents and scripts. */
29
+ token?: string | (() => string | undefined);
30
+ headers?: Record<string, string>;
31
+ fetch?: typeof fetch;
32
+ };
33
+ /** The procedure name a call from `rpc` stands for, or undefined for anything else. */
34
+ declare function rpcName(call: unknown): string | undefined;
35
+ /** A client for another origin or runtime. Browsers can use the ready-made `rpc`. */
36
+ declare function createRpc(options?: RpcOptions): RpcClient;
37
+ /** Calls the app's procedures over `POST /rpc/<name>` on the page's own origin. */
38
+ declare const rpc: RpcClient;
39
+ export { RpcError as a, createRpc as c, RpcClient as i, rpc as l, ProcedureMap as n, RpcErrorCode as o, RpcCall as r, RpcOptions as s, ModuleProcedures as t, rpcName as u };
@@ -0,0 +1,19 @@
1
+ import { RpcError, createClient } from "@builtbyfriends/realtime-http/client";
2
+ // src/runtime/rpc.ts
3
+ const NAME = Symbol.for("bwf.rpc.name");
4
+ /** The procedure name a call from `rpc` stands for, or undefined for anything else. */
5
+ function rpcName(call) {
6
+ return call?.[NAME];
7
+ }
8
+ /** A client for another origin or runtime. Browsers can use the ready-made `rpc`. */
9
+ function createRpc(options = {}) {
10
+ const call = createClient(options.baseUrl ?? "", options).call;
11
+ const proxy = (path) => new Proxy(() => {}, {
12
+ get: (_target, key) => key === NAME ? path.join(".") : typeof key === "string" ? proxy([...path, key]) : void 0,
13
+ apply: (_target, _this, args) => call(path.join("."), args[0])
14
+ });
15
+ return proxy([]);
16
+ }
17
+ /** Calls the app's procedures over `POST /rpc/<name>` on the page's own origin. */
18
+ const rpc = createRpc();
19
+ export { rpcName as i, createRpc as n, rpc as r, RpcError as t };
@@ -0,0 +1,163 @@
1
+ import { a as join, n as dirname } from "./dist-DMYe8CZJ.mjs";
2
+ import { n as hasPackageDependency, r as readNearestPackageJson } from "./package-json-DvS6IFRv.mjs";
3
+ import { t as collectMigrations } from "./collect-C6Blu9yw.mjs";
4
+ import { r as classifyMigration } from "./plan-DX4_-OM5.mjs";
5
+ import { existsSync, mkdirSync } from "node:fs";
6
+ import { createHash, createHmac } from "node:crypto";
7
+ // src/migrations/runner.ts
8
+ const SQLITE_INTERNAL_TABLES = /* @__PURE__ */ new Set([
9
+ "_cf_METADATA",
10
+ "_migrations",
11
+ "_void_migrations",
12
+ "__drizzle_migrations"
13
+ ]);
14
+ function projectUsesVitePlus(startDir = process.cwd()) {
15
+ const nearest = readNearestPackageJson(startDir);
16
+ return nearest ? hasPackageDependency(nearest.packageJson, "vite-plus") : false;
17
+ }
18
+ function toBetterSqlite3Error(error, cwd = process.cwd()) {
19
+ const message = error instanceof Error ? error.message : String(error);
20
+ const isMissingBinding = message.includes("Could not locate the bindings file");
21
+ const isNodeVersionMismatch = message.includes("was compiled against a different Node.js version") || message.includes("NODE_MODULE_VERSION");
22
+ if (!isMissingBinding && !isNodeVersionMismatch) return error instanceof Error ? error : new Error(message);
23
+ const usesVitePlus = projectUsesVitePlus(cwd);
24
+ return /* @__PURE__ */ new Error(`db: better-sqlite3 is installed but its native binding was not built. Set \`allowBuilds.better-sqlite3\` to \`true\` in pnpm-workspace.yaml and run \`${usesVitePlus ? "vp rebuild" : "pnpm rebuild better-sqlite3"}\`. ${usesVitePlus ? "Vite+ uses its managed Node.js runtime for `vp dev`; rebuild native modules with `vp rebuild` and run bwf CLI commands through Vite+ as `vp exec bwf <command>`." : "Plain Vite projects use your system Node.js runtime, so `pnpm rebuild better-sqlite3` rebuilds the matching native module."} See https://pnpm.io/settings#allowbuilds`);
25
+ }
26
+ async function openSqliteDatabase(dbPath, options) {
27
+ try {
28
+ const Database = (await import("better-sqlite3")).default;
29
+ return new Database(dbPath, options);
30
+ } catch (error) {
31
+ throw toBetterSqlite3Error(error);
32
+ }
33
+ }
34
+ /**
35
+ * Read the list of applied migrations from the local SQLite database.
36
+ * Returns [] if the DB file or tracking table doesn't exist.
37
+ */
38
+ async function getAppliedMigrations(dbPath) {
39
+ if (!existsSync(dbPath)) return [];
40
+ const db = await openSqliteDatabase(dbPath, { readonly: true });
41
+ try {
42
+ let tableName = null;
43
+ for (const candidate of ["_void_migrations", "_migrations"]) if (db.prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='${candidate}'`).get()) {
44
+ tableName = candidate;
45
+ break;
46
+ }
47
+ if (!tableName) return [];
48
+ return db.prepare(`SELECT name, applied_at FROM ${tableName} ORDER BY name`).all();
49
+ } finally {
50
+ db.close();
51
+ }
52
+ }
53
+ /**
54
+ * Compute the miniflare D1 SQLite database path.
55
+ * Miniflare uses a deterministic hash based on the database_id
56
+ * to store local D1 data.
57
+ */
58
+ function getMiniflareDatabasePath(persistRoot, databaseId) {
59
+ const uniqueKey = "miniflare-D1DatabaseObject";
60
+ const key = createHash("sha256").update(uniqueKey).digest();
61
+ const nameHmac = createHmac("sha256", key).update(databaseId).digest().subarray(0, 16);
62
+ const hmac = createHmac("sha256", key).update(nameHmac).digest().subarray(0, 16);
63
+ const hash = Buffer.concat([nameHmac, hmac]).toString("hex");
64
+ return join(persistRoot, "v3", "d1", uniqueKey, `${hash}.sqlite`);
65
+ }
66
+ /**
67
+ * Move the legacy `_migrations` rows into `_void_migrations`. The check runs inside an
68
+ * IMMEDIATE transaction so two local runners cannot both copy and drop the old table.
69
+ */
70
+ function upgradeTrackingTable(db) {
71
+ db.transaction(() => {
72
+ if (!db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='_migrations'").get()) return;
73
+ db.exec(`
74
+ CREATE TABLE IF NOT EXISTS _void_migrations (
75
+ name TEXT PRIMARY KEY,
76
+ applied_at TEXT DEFAULT (datetime('now'))
77
+ )
78
+ `);
79
+ db.exec(`INSERT OR IGNORE INTO _void_migrations (name, applied_at) SELECT name, applied_at FROM _migrations`);
80
+ db.exec(`DROP TABLE IF EXISTS _migrations`);
81
+ }).immediate();
82
+ }
83
+ function getApplicationTableNames(db) {
84
+ return db.prepare("SELECT name FROM sqlite_master WHERE type='table' ORDER BY name").all().map((row) => row.name).filter((name) => !name.startsWith("sqlite_") && !SQLITE_INTERNAL_TABLES.has(name));
85
+ }
86
+ async function getApplicationTables(dbPath) {
87
+ if (!existsSync(dbPath)) return [];
88
+ const db = await openSqliteDatabase(dbPath, { readonly: true });
89
+ try {
90
+ return getApplicationTableNames(db);
91
+ } finally {
92
+ db.close();
93
+ }
94
+ }
95
+ function assertLocalMigrationState(migrations, appliedNames, applicationTables, dir) {
96
+ const migrationNames = new Set(migrations.map((migration) => migration.name));
97
+ const missingFiles = [...appliedNames].filter((name) => !migrationNames.has(name)).sort();
98
+ if (missingFiles.length > 0) throw new Error([
99
+ `Local database migration history does not match ${dir}/.`,
100
+ "",
101
+ "These migrations are recorded as applied locally but no longer exist on disk:",
102
+ ...missingFiles.map((name) => ` - ${name}`),
103
+ "",
104
+ "If the migration files were renamed, restore their old names.",
105
+ "If the migration history was intentionally rewritten, run `bwf db reset` to recreate the local database from the current files."
106
+ ].join("\n"));
107
+ if (appliedNames.size === 0 && migrations.length > 0 && applicationTables.length > 0) throw new Error([
108
+ "Local database already has application tables but no bwf migration history.",
109
+ "",
110
+ `Existing tables: ${applicationTables.join(", ")}`,
111
+ "",
112
+ "This usually means the schema was applied with `bwf db push` or the local database was created before migration tracking existed.",
113
+ `Run \`bwf db reset\` to recreate the local database from ${dir}/, or delete the local D1 state if you do not need its data.`
114
+ ].join("\n"));
115
+ }
116
+ /**
117
+ * Apply pending SQL migrations and record them in `_void_migrations`.
118
+ * Each file runs through one `exec` so SQLite parses multi-statement SQL itself.
119
+ * `sourceRelative` (`ProjectPaths.sourceRelative`) adds the configured `sourceDir` to the
120
+ * migrations folder that errors name.
121
+ */
122
+ async function runMigrations(migrationsDir, dbPath, sourceRelative = (path) => path) {
123
+ const allMigrations = collectMigrations(migrationsDir);
124
+ if (allMigrations.length === 0) return [];
125
+ mkdirSync(dirname(dbPath), { recursive: true });
126
+ const db = await openSqliteDatabase(dbPath);
127
+ try {
128
+ upgradeTrackingTable(db);
129
+ db.exec(`
130
+ CREATE TABLE IF NOT EXISTS _void_migrations (
131
+ name TEXT PRIMARY KEY,
132
+ applied_at TEXT DEFAULT (datetime('now'))
133
+ )
134
+ `);
135
+ const appliedSet = new Set(db.prepare("SELECT name FROM _void_migrations").all().map((r) => r.name));
136
+ assertLocalMigrationState(allMigrations, appliedSet, getApplicationTableNames(db), sourceRelative("db/migrations"));
137
+ const pending = allMigrations.filter((m) => !appliedSet.has(m.name));
138
+ if (pending.length === 0) return [];
139
+ for (const migration of pending) classifyMigration(migration);
140
+ const insertStmt = db.prepare("INSERT INTO _void_migrations (name) VALUES (?)");
141
+ const checkStmt = db.prepare("SELECT 1 FROM _void_migrations WHERE name = ?");
142
+ const appliedNames = [];
143
+ for (const migration of pending) {
144
+ const tx = db.transaction(() => {
145
+ if (checkStmt.get(migration.name)) return false;
146
+ db.exec(migration.sql);
147
+ insertStmt.run(migration.name);
148
+ return true;
149
+ });
150
+ let applied;
151
+ try {
152
+ applied = tx.immediate();
153
+ } catch (err) {
154
+ throw new Error(`migration ${migration.name} failed: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
155
+ }
156
+ if (applied) appliedNames.push(migration.name);
157
+ }
158
+ return appliedNames;
159
+ } finally {
160
+ db.close();
161
+ }
162
+ }
163
+ export { runMigrations as a, openSqliteDatabase as i, getAppliedMigrations as n, toBetterSqlite3Error as o, getMiniflareDatabasePath as r, getApplicationTables as t };
@@ -0,0 +1 @@
1
+ export { t as getApplicationTables, n as getAppliedMigrations, r as getMiniflareDatabasePath, i as openSqliteDatabase, a as runMigrations } from "./runner-CPerdjIl.mjs";
@@ -0,0 +1,145 @@
1
+ import { a as mySqlMigrationLockError, o as mySqlMigrationLockName, s as readMySqlMigrationLease, t as splitMySqlMigrationSql } from "./mysql-migration-sql-CNuBSqdx.mjs";
2
+ import { t as collectMigrations } from "./collect-C6Blu9yw.mjs";
3
+ // src/migrations/runner-mysql.ts
4
+ async function readMySqlAppliedMigrations(client) {
5
+ try {
6
+ return (await client.query("SELECT `name` FROM `_void_migrations`")).map((row) => String(row.name));
7
+ } catch (error) {
8
+ const value = typeof error === "object" && error !== null ? error : void 0;
9
+ if (value?.code === "ER_NO_SUCH_TABLE" || value?.errno === 1146) return [];
10
+ throw error;
11
+ }
12
+ }
13
+ function toMySqlClient(connection) {
14
+ return { async query(sql, params) {
15
+ const [rows] = await connection.query(sql, params);
16
+ return Array.isArray(rows) ? rows : [];
17
+ } };
18
+ }
19
+ async function getMySqlAppliedMigrations(url) {
20
+ const { createConnection } = await import("mysql2/promise");
21
+ const connection = await createConnection(url);
22
+ try {
23
+ return await readMySqlAppliedMigrations(toMySqlClient(connection));
24
+ } finally {
25
+ await connection.end();
26
+ }
27
+ }
28
+ const MIGRATION_LOCK_TIMEOUT_SECONDS = 10;
29
+ /**
30
+ * Take a named lock so two runs on one database cannot both apply a pending file. The lock
31
+ * survives the commits MySQL makes for DDL and ends with the session. A deploy cannot hold a
32
+ * session lock and writes a lease row instead, so this also waits for that lease.
33
+ */
34
+ async function acquireMySqlMigrationLock(client) {
35
+ const [row] = await client.query("SELECT DATABASE() AS db");
36
+ const database = row?.db ?? "";
37
+ const name = mySqlMigrationLockName(database);
38
+ const [lock] = await client.query("SELECT GET_LOCK(?, ?) AS acquired", [name, MIGRATION_LOCK_TIMEOUT_SECONDS]);
39
+ if (Number(Object.values(lock ?? {})[0]) !== 1) throw mySqlMigrationLockError(database, "run the command again");
40
+ const readLease = () => readMySqlMigrationLease((sql, params) => client.query(sql, params));
41
+ const deadline = Date.now() + MIGRATION_LOCK_TIMEOUT_SECONDS * 1e3;
42
+ let remaining = await readLease();
43
+ while (remaining !== void 0 && Date.now() < deadline) {
44
+ await new Promise((resolve) => setTimeout(resolve, 1e3));
45
+ remaining = await readLease();
46
+ }
47
+ if (remaining !== void 0) {
48
+ await client.query("SELECT RELEASE_LOCK(?)", [name]).catch(() => {});
49
+ throw new Error(`A deploy is applying migrations to MySQL database "${database}". Wait for it to finish, then run the command again. If that deploy stopped, its lock expires in ${remaining} seconds.`);
50
+ }
51
+ return name;
52
+ }
53
+ /**
54
+ * A DDL statement makes MySQL commit and close the open transaction. A savepoint can only be
55
+ * rolled back to inside a transaction, so this tells whether the file's changes can still be undone.
56
+ */
57
+ async function isTransactionOpen(client) {
58
+ try {
59
+ await client.query("SAVEPOINT `nosam_migration`");
60
+ await client.query("ROLLBACK TO SAVEPOINT `nosam_migration`");
61
+ return true;
62
+ } catch {
63
+ return false;
64
+ }
65
+ }
66
+ const ROLLED_BACK_BY_SERVER_ERRNOS = /* @__PURE__ */ new Set([1213, 3101]);
67
+ function isRolledBackByServer(error) {
68
+ const errno = typeof error === "object" && error !== null ? error.errno : void 0;
69
+ return typeof errno === "number" && ROLLED_BACK_BY_SERVER_ERRNOS.has(errno);
70
+ }
71
+ function mySqlMigrationError(name, error, committed) {
72
+ const lines = [`migration ${name} failed: ${error instanceof Error ? error.message : String(error)}`];
73
+ if (committed) lines.push(`MySQL commits schema changes immediately, so earlier statements in ${name} may already be applied. Undo them, fix the file, then run the command again.`, "See https://void.cloud/guide/database/mysql#failed-migrations");
74
+ return new Error(lines.join("\n"), { cause: error });
75
+ }
76
+ /**
77
+ * Runs `work` while this session holds the database's migration lock, so no other migration run,
78
+ * deploy or reset changes the schema meanwhile.
79
+ */
80
+ async function withMySqlMigrationLock(client, work) {
81
+ const lock = await acquireMySqlMigrationLock(client);
82
+ try {
83
+ return await work();
84
+ } finally {
85
+ await client.query("SELECT RELEASE_LOCK(?)", [lock]).catch(() => {});
86
+ }
87
+ }
88
+ async function applyMySqlMigrations(client, migrations) {
89
+ if (migrations.length === 0) return [];
90
+ return withMySqlMigrationLock(client, () => applyPendingMySqlMigrations(client, migrations));
91
+ }
92
+ /** Applies the files not yet recorded. The caller holds the migration lock. */
93
+ async function applyPendingMySqlMigrations(client, migrations) {
94
+ if (migrations.length === 0) return [];
95
+ await client.query("CREATE TABLE IF NOT EXISTS `_void_migrations` (`name` VARCHAR(255) PRIMARY KEY, `applied_at` VARCHAR(64) NOT NULL)");
96
+ const existing = await client.query("SELECT `name` FROM `_void_migrations`");
97
+ const appliedSet = new Set(existing.map((row) => String(row.name)));
98
+ const pending = migrations.filter((migration) => !appliedSet.has(migration.name));
99
+ for (const migration of pending) {
100
+ let ran = 0;
101
+ await client.query("BEGIN");
102
+ try {
103
+ for (const statement of splitMySqlMigrationSql(migration.sql)) {
104
+ await client.query(statement);
105
+ ran++;
106
+ }
107
+ await client.query("INSERT INTO `_void_migrations` (`name`, `applied_at`) VALUES (?, ?)", [migration.name, (/* @__PURE__ */ new Date()).toISOString()]);
108
+ await client.query("COMMIT");
109
+ } catch (error) {
110
+ const committed = ran > 0 && !isRolledBackByServer(error) && !await isTransactionOpen(client);
111
+ await client.query("ROLLBACK").catch(() => {});
112
+ throw mySqlMigrationError(migration.name, error, committed);
113
+ }
114
+ }
115
+ return pending.map((migration) => migration.name);
116
+ }
117
+ /** Connects to `url` and runs `work` while holding that database's migration lock. */
118
+ async function withMySqlMigrationLockAt(url, work) {
119
+ const { createConnection } = await import("mysql2/promise");
120
+ const connection = await createConnection({
121
+ uri: url,
122
+ multipleStatements: true
123
+ });
124
+ try {
125
+ const client = toMySqlClient(connection);
126
+ return await withMySqlMigrationLock(client, () => work(client));
127
+ } finally {
128
+ await connection.end();
129
+ }
130
+ }
131
+ /**
132
+ * Applies the pending files in `migrationsDir`. `afterApply` gets the applied names and runs before
133
+ * the lock is released, so the schema changes it makes (Better Auth's tables) do not overlap
134
+ * another run either.
135
+ */
136
+ async function runMySqlMigrations(migrationsDir, url, afterApply) {
137
+ const migrations = collectMigrations(migrationsDir);
138
+ if (migrations.length === 0 && !afterApply) return [];
139
+ return withMySqlMigrationLockAt(url, async (client) => {
140
+ const applied = await applyPendingMySqlMigrations(client, migrations);
141
+ await afterApply?.(applied);
142
+ return applied;
143
+ });
144
+ }
145
+ export { runMySqlMigrations as a, withMySqlMigrationLockAt as c, readMySqlAppliedMigrations as i, applyPendingMySqlMigrations as n, toMySqlClient as o, getMySqlAppliedMigrations as r, withMySqlMigrationLock as s, applyMySqlMigrations as t };
@@ -0,0 +1 @@
1
+ export { t as applyMySqlMigrations, n as applyPendingMySqlMigrations, r as getMySqlAppliedMigrations, i as readMySqlAppliedMigrations, a as runMySqlMigrations, o as toMySqlClient, s as withMySqlMigrationLock, c as withMySqlMigrationLockAt } from "./runner-mysql-7aA5hGoM.mjs";
@@ -0,0 +1 @@
1
+ export { t as applyPgMigrations, n as getPgAppliedMigrations, r as readPgAppliedMigrations, i as runPgMigrations } from "./runner-pg-mYc75KfH.mjs";
@@ -0,0 +1,61 @@
1
+ import { t as collectMigrations } from "./collect-C6Blu9yw.mjs";
2
+ // src/migrations/runner-pg.ts
3
+ async function readPgAppliedMigrations(client) {
4
+ try {
5
+ return (await client.query("SELECT name FROM _void_migrations")).rows.map((row) => String(row.name));
6
+ } catch (error) {
7
+ if (typeof error === "object" && error !== null && error.code === "42P01") return [];
8
+ throw error;
9
+ }
10
+ }
11
+ async function getPgAppliedMigrations(url) {
12
+ const { Client } = await import("pg");
13
+ const client = new Client({ connectionString: url });
14
+ await client.connect();
15
+ try {
16
+ return await readPgAppliedMigrations(client);
17
+ } finally {
18
+ await client.end();
19
+ }
20
+ }
21
+ /**
22
+ * Apply unapplied SQL migrations via a connected PostgreSQL client.
23
+ * Each migration runs in its own transaction (BEGIN/COMMIT).
24
+ */
25
+ async function applyPgMigrations(client, migrations) {
26
+ if (migrations.length === 0) return [];
27
+ await client.query(`CREATE TABLE IF NOT EXISTS _void_migrations (name TEXT PRIMARY KEY, applied_at TEXT NOT NULL)`);
28
+ const existing = await client.query("SELECT name FROM _void_migrations");
29
+ const appliedSet = new Set(existing.rows.map((row) => String(row.name)));
30
+ const pending = migrations.filter((m) => !appliedSet.has(m.name));
31
+ if (pending.length === 0) return [];
32
+ for (const m of pending) {
33
+ await client.query("BEGIN");
34
+ try {
35
+ await client.query(m.sql);
36
+ await client.query("INSERT INTO _void_migrations (name, applied_at) VALUES ($1, $2)", [m.name, (/* @__PURE__ */ new Date()).toISOString()]);
37
+ await client.query("COMMIT");
38
+ } catch (err) {
39
+ await client.query("ROLLBACK").catch(() => {});
40
+ throw new Error(`migration ${m.name} failed: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
41
+ }
42
+ }
43
+ return pending.map((m) => m.name);
44
+ }
45
+ /**
46
+ * Apply unapplied SQL migrations to a PostgreSQL database.
47
+ * Each migration runs in its own transaction (BEGIN/COMMIT).
48
+ */
49
+ async function runPgMigrations(migrationsDir, url) {
50
+ const allMigrations = collectMigrations(migrationsDir);
51
+ if (allMigrations.length === 0) return [];
52
+ const { Client } = await import("pg");
53
+ const client = new Client({ connectionString: url });
54
+ await client.connect();
55
+ try {
56
+ return await applyPgMigrations(client, allMigrations);
57
+ } finally {
58
+ await client.end();
59
+ }
60
+ }
61
+ export { runPgMigrations as i, getPgAppliedMigrations as n, readPgAppliedMigrations as r, applyPgMigrations as t };
@@ -0,0 +1,50 @@
1
+ type AiProviderName = "openai" | "anthropic" | "google-ai-studio" | "groq" | "mistral" | "grok" | "deepseek" | "openrouter" | "perplexity" | "cohere" | "cerebras" | "huggingface" | "replicate" | "baseten" | "cartesia" | "deepgram" | "elevenlabs" | "fal" | "ideogram" | "parallel";
2
+ type AiProvider = AiProviderName | (string & {});
3
+ /**
4
+ * @deprecated No bwf API accepts this type. To send a file with `ai.provider().fetch()`,
5
+ * put it in `FormData`. Removed in the next major version.
6
+ */
7
+ type ImageFileInput = Blob | ArrayBuffer | ArrayBufferView | {
8
+ data: string;
9
+ name?: string;
10
+ type?: string;
11
+ };
12
+ type AiProviderOptions = {
13
+ apiKeyEnv?: string;
14
+ apiKeyHeader?: string;
15
+ apiKeyPrefix?: string;
16
+ };
17
+ type AiProviderFetchInit = {
18
+ method?: string;
19
+ headers?: HeadersInit;
20
+ body?: unknown;
21
+ };
22
+ /**
23
+ * Extended AI type with a convenience `stream()` method.
24
+ *
25
+ * `stream()` calls `ai.run()` with `stream: true` and wraps the result
26
+ * in a `Response` with SSE headers — ready to return from a route handler.
27
+ */
28
+ export type BwfAi = {
29
+ models(...args: Parameters<Ai["models"]>): Promise<Awaited<ReturnType<Ai["models"]>>>;
30
+ toMarkdown(files: Array<Parameters<Ai["toMarkdown"]>[0]>, options?: Parameters<Ai["toMarkdown"]>[1]): Promise<Array<Awaited<ReturnType<Ai["toMarkdown"]>>>>;
31
+ toMarkdown(...args: Parameters<Ai["toMarkdown"]>): Promise<Awaited<ReturnType<Ai["toMarkdown"]>>>;
32
+ /** Workers AI inference. */
33
+ run<Name extends keyof AiModels>(model: Name, inputs: AiModels[Name]["inputs"], options?: AiOptions): Promise<AiModels[Name]["postProcessedOutputs"]>;
34
+ /** Cloudflare AI Gateway model inference. Accepts Cloudflare model IDs unchanged. */
35
+ run(model: string, inputs: unknown, options?: AiOptions): Promise<unknown>;
36
+ /** Image generation. Returns the proxy response so callers can return or parse it. */
37
+ image<Name extends keyof AiModels>(model: Name, inputs: AiModels[Name]["inputs"], options?: AiOptions): Promise<Response>;
38
+ /** Cloudflare AI Gateway model inference returned as a Response. */
39
+ image(model: string, inputs: unknown, options?: AiOptions): Promise<Response>;
40
+ /** Provider-native AI Gateway requests using a project secret for the provider API key. */
41
+ provider(provider: AiProvider, options?: AiProviderOptions): {
42
+ fetch(path: string, init?: AiProviderFetchInit): Promise<Response>;
43
+ };
44
+ /** Stream Workers AI response as SSE */
45
+ stream<Name extends keyof AiModels>(model: Name, inputs: Omit<AiModels[Name]["inputs"], "stream">, options?: AiOptions): Promise<Response>;
46
+ /** Stream any Cloudflare AI Gateway model response as SSE */
47
+ stream(model: string, inputs: Record<string, unknown>, options?: AiOptions): Promise<Response>;
48
+ };
49
+ export declare const ai: BwfAi;
50
+ export type { AiProvider, AiProviderFetchInit, AiProviderName, AiProviderOptions, ImageFileInput };