@builtbyfriends/bwf 0.0.0-stage → 1.9.2

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-Ddt8lGeL.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-CCl-hJol.mjs +26 -0
  17. package/dist/auth-migrations-DDeifS3v.mjs +206 -0
  18. package/dist/auth-router-BG74WFUf.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-BfYf6fnB.mjs +1846 -0
  40. package/dist/client-D3D5RM5h.mjs +940 -0
  41. package/dist/client-VF2Nzc7Z.mjs +1 -0
  42. package/dist/cloudflare-auth-DzkU9H6r.mjs +152 -0
  43. package/dist/cloudflare-cmd-Bm6UhzAQ.mjs +59 -0
  44. package/dist/cloudflare-config-i8yanry0.mjs +186 -0
  45. package/dist/cloudflare-connect-B4ItSbJi.mjs +55 -0
  46. package/dist/cloudflare-operations-BcK849ue.mjs +1 -0
  47. package/dist/cloudflare-operations-DGF7xH7O.mjs +627 -0
  48. package/dist/cloudflare-process-tThIjEB2.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-CSNWKLzB.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-SOv4E9wr.mjs +1735 -0
  65. package/dist/delete-BSKI7V23.mjs +65 -0
  66. package/dist/deploy-BCSQoKC0.mjs +2 -0
  67. package/dist/deploy-CWJ3JJs_.mjs +6512 -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-BJaAbxuQ.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-C_ATvNIG.mjs +2865 -0
  84. package/dist/email-cloudflare-oXk2G1G3.mjs +854 -0
  85. package/dist/email-protocol-CZ0bAkI8.mjs +81 -0
  86. package/dist/email-rIfZgVAB.mjs +742 -0
  87. package/dist/env-BGTu3KWZ.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-BlXzGgLZ.mjs +1 -0
  97. package/dist/env-validation-DeqFUSKg.mjs +488 -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-B_ocHStk.d.mts +279 -0
  111. package/dist/handler-CNq7aSs1.mjs +161 -0
  112. package/dist/help-BK35YcRa.mjs +1946 -0
  113. package/dist/help-DaRezBj7.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-CXanf5ck.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-B1WAE9Wt.mjs +130 -0
  124. package/dist/live-KkEeda1Z.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-bUoAtFUe.mjs +103 -0
  128. package/dist/log-JDnPc0cF.mjs +23 -0
  129. package/dist/login-BUzyiyHV.mjs +1 -0
  130. package/dist/login-Dbv_T3Ru.mjs +87 -0
  131. package/dist/logs-BjMJooJQ.mjs +129 -0
  132. package/dist/migrate-DjW9_-sS.mjs +1 -0
  133. package/dist/migrate-DtcfKqPW.mjs +125 -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-BiGmSlZx.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-BsHKYJYt.mjs +1 -0
  145. package/dist/operator-cmd-DTIkOAnP.mjs +443 -0
  146. package/dist/output-Bb34lF0w.mjs +173 -0
  147. package/dist/output-CVolXKC1.mjs +1 -0
  148. package/dist/package-BX_giUBX.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-C-DyuCNX.mjs +1 -0
  155. package/dist/platform-args-CyeQWaZ7.mjs +538 -0
  156. package/dist/platform-auth-config-BfXqKSyZ.mjs +371 -0
  157. package/dist/platform-auth-protection-5FR6qoP_.mjs +231 -0
  158. package/dist/platform-auth-recovery-B5ZlqA8K.mjs +309 -0
  159. package/dist/platform-cmd-CcFDxtrl.mjs +1 -0
  160. package/dist/platform-cmd-ChXeBrRH.mjs +193 -0
  161. package/dist/platform-discovery-Bxg9aZXU.mjs +40 -0
  162. package/dist/platform-domain-CwatS3cz.mjs +256 -0
  163. package/dist/platform-lifecycle-0cXTmMsh.mjs +8928 -0
  164. package/dist/platform-lifecycle-BcoBAMux.mjs +1 -0
  165. package/dist/platform-management-6Wbdbob5.mjs +1607 -0
  166. package/dist/platform-management-hhnczOzr.mjs +1 -0
  167. package/dist/platform-plans-config-CkbUKFpm.mjs +447 -0
  168. package/dist/platform-recovery-DgIwlqB-.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-DX8y_6Kh.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-BydRwr-x.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-BA59NCPO.mjs +1 -0
  188. package/dist/provision-C90fULHJ.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-wi6WK5T6.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-BjSoQ-mW.mjs +1 -0
  209. package/dist/runner-mysql-BmTI2EiF.mjs +145 -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-D5XrWshs.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-DPhqnpaa.mjs +23 -0
  343. package/dist/wrangler-C3uyPadQ.mjs +1 -0
  344. package/dist/wrangler-TqTvJFWS.mjs +1452 -0
  345. package/dist/ws-DZRiIpYw.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,255 @@
1
+ ---
2
+ description: 'Add Better Auth to your app, including its database, API routes, and client. Start with email and password or a social provider.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Authentication
7
+
8
+ ::: warning ⚠️ bwf Apps Only
9
+ Platform-managed auth requires a bwf app with a backend. For a static SPA without `routes/`, use Better Auth directly.
10
+ :::
11
+
12
+ bwf configures [Better Auth](https://www.better-auth.com/) for your app, including its database connection, API routes, and client. Start with email and password, or add a social login provider.
13
+
14
+ ## Quick Start
15
+
16
+ ### 1. Enable auth
17
+
18
+ Import `auth` from `@builtbyfriends/bwf/client` to enable email/password auth automatically. Use [configuration](#config) to add social providers.
19
+
20
+ ### 2. Sign up and sign in
21
+
22
+ Use the preconfigured auth client from `@builtbyfriends/bwf/client`:
23
+
24
+ ```tsx
25
+ import { auth } from '@builtbyfriends/bwf/client';
26
+
27
+ // sign up
28
+ await auth.signUp.email({
29
+ email: 'alice@example.com',
30
+ password: 'example-password-123',
31
+ name: 'Alice',
32
+ });
33
+
34
+ // sign in
35
+ await auth.signIn.email({
36
+ email: 'alice@example.com',
37
+ password: 'example-password-123',
38
+ });
39
+ ```
40
+
41
+ ### 3. Protect a server route {#protect-a-server-route}
42
+
43
+ Call `requireAuth` in a route handler or action to get the signed-in user or reject unauthenticated requests with `401`:
44
+
45
+ ```ts
46
+ // routes/api/profile.ts
47
+ import { defineHandler } from '@builtbyfriends/bwf';
48
+ import { requireAuth } from '@builtbyfriends/bwf/auth';
49
+
50
+ export const GET = defineHandler((c) => {
51
+ const user = requireAuth(c);
52
+ return { email: user.email };
53
+ });
54
+ ```
55
+
56
+ Pass `throwRedirect` to send unauthenticated visitors to your login page instead of a plain-text `401`:
57
+
58
+ ```ts
59
+ // routes/account/export.ts
60
+ import { defineHandler } from '@builtbyfriends/bwf';
61
+ import { requireAuth } from '@builtbyfriends/bwf/auth';
62
+
63
+ export const GET = defineHandler((c) => {
64
+ const user = requireAuth(c, {
65
+ throwRedirect: '/login',
66
+ });
67
+ return { email: user.email };
68
+ });
69
+ ```
70
+
71
+ The same option works in middleware. It throws a redirect, stopping execution: `302` for GET/HEAD requests and `303` for other methods.
72
+
73
+ To allow unauthenticated access, use `getUser()` and return the nullable user. For custom guards, you can also [throw a redirect](../integrations/hono.md#redirects) from a helper.
74
+
75
+ ### 4. Sign out
76
+
77
+ ```tsx
78
+ await auth.signOut();
79
+ ```
80
+
81
+ ## Config
82
+
83
+ Auth turns on automatically when you:
84
+
85
+ - import anything from `@builtbyfriends/bwf/auth`
86
+ - import `auth` from `@builtbyfriends/bwf/client`
87
+ - add `auth` to `bwf.config.ts`
88
+ - add a root-level `auth.ts` file
89
+
90
+ Email/password is enabled by default. To add social providers:
91
+
92
+ ```json
93
+ {
94
+ "auth": {
95
+ "providers": ["email", "google", "github"]
96
+ }
97
+ }
98
+ ```
99
+
100
+ Provider credentials come from `AUTH_<PROVIDER>_CLIENT_ID` and `AUTH_<PROVIDER>_CLIENT_SECRET`. `cognito` also needs a domain, region, and user pool ID: set `AUTH_COGNITO_DOMAIN`, `AUTH_COGNITO_REGION`, and `AUTH_COGNITO_USER_POOL_ID`, or set them in `auth.ts`.
101
+
102
+ See the full provider list in the [config reference](../reference/config.md#auth).
103
+
104
+ For example, `github` uses:
105
+
106
+ - `AUTH_GITHUB_CLIENT_ID`
107
+ - `AUTH_GITHUB_CLIENT_SECRET`
108
+
109
+ ## Client Usage
110
+
111
+ The `auth` client uses [Better Auth's client API](https://www.better-auth.com/docs/concepts/client) at `/api/auth`. bwf selects the client for your framework automatically.
112
+
113
+ For a custom client, import `createAuthClient` from `@builtbyfriends/bwf/client`.
114
+
115
+ ## Server Usage
116
+
117
+ `@builtbyfriends/bwf/auth` provides the server-side helpers:
118
+
119
+ ```ts
120
+ import { getSession, getUser, requireAuth } from '@builtbyfriends/bwf/auth';
121
+ ```
122
+
123
+ - `getUser()` returns the current `AuthUser | null`
124
+ - `getSession()` returns `{ user, session } | null`
125
+ - `requireAuth(c)` returns the authenticated user or throws `401`
126
+ - `requireAuth(c, { throwRedirect: '/login' })` returns the user or throws a login redirect
127
+ - [`getAuth(c)`](../reference/api/auth.md#getauth-c) returns the request's Better Auth instance, with plugin APIs inferred from `auth.ts`, for use with Better Auth helpers.
128
+
129
+ Cookies set by `getAuth(c).api` calls are sent with the response, so the browser picks up changes such as a renamed user or a sign-out on its next request. An endpoint that signs someone in, like `signUpEmail`, signs the current browser in as that user; to create accounts for other people, use the admin plugin's `createUser`. `getUser()` and `getSession()` still return the user from the start of the request, so redirect after an action that changes the signed-in user to render the new data.
130
+
131
+ Import `AuthUser` and `AuthSession` from `@builtbyfriends/bwf/auth` for type annotations. They include the fields your Better Auth plugins and `user.additionalFields` add, such as `role` from `admin()`. See their fields in the [API reference](../reference/api/auth.md#authuser).
132
+
133
+ ## Querying Authentication Tables
134
+
135
+ To query users or reference them from your own tables, import bwf's generated authentication schema. It exports `userTable`, `sessionTable`, `accountTable`, `verificationTable`, and any tables added by your Better Auth plugins.
136
+
137
+ Add an alias to your root `tsconfig.json`:
138
+
139
+ ```json
140
+ {
141
+ "compilerOptions": {
142
+ "paths": {
143
+ "@auth-schema": ["./.bwf/better-auth-schema.ts"]
144
+ }
145
+ }
146
+ }
147
+ ```
148
+
149
+ Keep your other path aliases, including any you use from `.bwf/tsconfig.json`, such as `@schema`.
150
+
151
+ You can now query users with Drizzle:
152
+
153
+ ```ts
154
+ import { userTable } from '@auth-schema';
155
+ import { db, desc } from '@builtbyfriends/bwf/db';
156
+
157
+ export function listUsers() {
158
+ return db.select().from(userTable).orderBy(desc(userTable.createdAt));
159
+ }
160
+ ```
161
+
162
+ To associate a post with its author, reference `userTable.id`:
163
+
164
+ ```ts
165
+ import { userTable } from '@auth-schema';
166
+ import { sqliteTable, text } from '@builtbyfriends/bwf/schema-d1';
167
+
168
+ export const postTable = sqliteTable('post', {
169
+ id: text('id').primaryKey(),
170
+ userId: text('user_id')
171
+ .notNull()
172
+ .references(() => userTable.id, { onDelete: 'cascade' }),
173
+ });
174
+ ```
175
+
176
+ This example uses D1 and the default text IDs. For PostgreSQL or MySQL, use `@builtbyfriends/bwf/schema-pg` or `@builtbyfriends/bwf/schema-mysql`. With `advanced.database.generateId: 'serial'`, use an integer foreign key.
177
+
178
+ bwf regenerates `.bwf/better-auth-schema.ts`. Configure authentication in `auth.ts` rather than editing the generated file.
179
+
180
+ ## Behavior
181
+
182
+ Auth sessions use the same database as your app. bwf creates `BETTER_AUTH_SECRET` on deploy if it is missing and reuses it on later deploys.
183
+
184
+ Local development needs no secret setup. To preview a production build locally, provide `BETTER_AUTH_SECRET`.
185
+
186
+ Responses to signed-in requests get `Cache-Control: no-store`, so neither the browser cache nor a shared cache keeps a user's data. A route keeps its own policy when it sets `no-store`, or `private` together with `no-cache`. To answer repeat requests with `304`, use `private, no-cache` with Hono's [`etag()`](https://hono.dev/docs/middleware/builtin/etag) middleware. If you set the `ETag` yourself, make it differ per user, so the `304` doesn't reuse another account's page. The browser cache keeps a copy of a `private, no-cache` page, so the Back button can show it again after the user signs out. Keep the default `no-store` for pages that must not stay in the browser cache.
187
+
188
+ Static files from your build and `public/` keep their own cache policy for signed-in requests, so the browser reuses cached JavaScript and CSS. When your app handles the request, the policy is marked `private`, and a request that refreshes the session cookie gets `no-store`.
189
+
190
+ `POST`, `PUT`, `PATCH` and `DELETE` requests and WebSocket connections from another origin don't use the signed-in session unless that origin is in `trustedOrigins`. If a separate frontend calls your app, add its origin there (see [Customization](#customization)). If your routes use their own cookies, check the request `Origin` yourself, for example with Hono's [`csrf()`](https://hono.dev/docs/middleware/builtin/csrf) middleware.
191
+
192
+ Deployed apps on Cloudflare limit auth requests per client IP with Better Auth's defaults, for example 3 sign-in attempts per 10 seconds. Each Worker instance keeps its own count. Change or turn off the limits with `rateLimit` in `auth.ts`. To share one count across instances, set `rateLimit: { storage: 'database' }`, then run `bwf db generate` for a direct Cloudflare deploy.
193
+
194
+ ### Proxies and end-to-end tests
195
+
196
+ All requests from one IP share one count. Two common setups reach the limits:
197
+
198
+ - A server calls your auth endpoints for your users, such as a backend-for-frontend, a rewrite from Vercel or nginx, or another Worker's `fetch`. All of those users share that server's IP.
199
+ - End-to-end tests sign up or sign in many times against a deployed app.
200
+
201
+ Don't read the client IP from `x-forwarded-for` instead: any client can send that header. Give the trusted caller a secret header, and skip the limits only for requests that carry it:
202
+
203
+ ```ts
204
+ import { defineAuth } from '@builtbyfriends/bwf/auth';
205
+
206
+ export default defineAuth(({ defaults, env }) => ({
207
+ ...defaults,
208
+ rateLimit: {
209
+ customRules: {
210
+ '/**': (request, rule) =>
211
+ env.AUTH_TRUSTED_KEY && request.headers.get('x-auth-trusted-key') === env.AUTH_TRUSTED_KEY
212
+ ? false
213
+ : rule,
214
+ },
215
+ },
216
+ }));
217
+ ```
218
+
219
+ `'/**'` matches every auth endpoint. Returning `false` skips the limit, and returning `rule` keeps the default limit for everyone else. Declare `AUTH_TRUSTED_KEY: string().optional()` in `env.ts` and set it with `bwf secret put AUTH_TRUSTED_KEY` (see [Environment variables](./env-vars.md#production-server-values)).
220
+
221
+ Your app no longer limits requests that carry the key, so:
222
+
223
+ - A proxy that sends it must limit every auth request it forwards for each of its users, including sign-up, password reset and verification emails.
224
+ - A test runner should send it only to your app. Never put the key in code that runs in your users' browsers.
225
+
226
+ ## Customization
227
+
228
+ For advanced configuration, create `auth.ts` at the project root and export `defineAuth(...)`:
229
+
230
+ ```ts
231
+ import { defineAuth } from '@builtbyfriends/bwf/auth';
232
+
233
+ export default defineAuth(({ defaults }) => ({
234
+ ...defaults,
235
+ trustedOrigins: ['https://example.com'],
236
+ }));
237
+ ```
238
+
239
+ `defaults` already includes bwf's conventions. Extend it explicitly instead of expecting a deep merge.
240
+
241
+ In `auth.ts`, load helpers that import `@auth-schema` inside the hook that uses them, with `await import('./server/users')`. This lets `bwf prepare` generate the authentication schema on a fresh clone. The same applies when a helper imports your app's database schema and that schema references authentication tables.
242
+
243
+ For the full set of available options, see the official [Better Auth options reference](https://www.better-auth.com/docs/reference/options).
244
+
245
+ ## Database and Migrations
246
+
247
+ Auth tables live alongside your app's tables. During local development, bwf creates them automatically. While the dev server runs, saving `auth.ts`, or a local file it imports, updates the auth schema bwf generates for your app. New auth tables and columns are created in the local database the next time the dev server starts.
248
+
249
+ bwf platforms create auth tables automatically. For a direct Cloudflare deploy, include them in your checked-in migrations:
250
+
251
+ ```sh
252
+ bwf db generate
253
+ ```
254
+
255
+ Review and commit the SQL before deploying. bwf includes your auth configuration and plugin tables; you don't need to duplicate them in `db/schema.ts` or run the Better Auth CLI.
@@ -0,0 +1,86 @@
1
+ ---
2
+ description: "Use Cloudflare D1, bwf's default SQLite database. bwf runs it locally and provisions it when you deploy."
3
+ outline: deep
4
+ ---
5
+
6
+ # D1 (SQLite)
7
+
8
+ [Cloudflare D1](https://developers.cloudflare.com/d1/) is bwf's default SQLite database. Start with a [schema](../database.md#schema-definition); bwf manages the database locally and when you deploy.
9
+
10
+ ## Local Database
11
+
12
+ The dev server and local `bwf db` commands share the same database. If `cloudflare.d1_databases` in `bwf.config.ts` declares the D1 binding, bwf uses its ID. A `preview_database_id` takes precedence during local development.
13
+
14
+ To store local data outside `.bwf`, set `bwfPlugin({ persistTo: 'local-state' })` in your Vite config. Start the dev server once to record that directory before running database commands. After changing the Vite config, start it again to refresh it. Frameworks that manage their own Cloudflare runtime use `.wrangler/state`.
15
+
16
+ ## Migrations & Prototyping
17
+
18
+ Use `bwf db push` to apply schema changes locally without creating migration files. Before deploying, generate and commit migrations:
19
+
20
+ ```sh
21
+ bwf db generate
22
+ bwf db migrate # apply locally
23
+ bwf deploy # apply remotely and deploy
24
+ ```
25
+
26
+ See [Database commands](../../reference/cli/database.md#database) for the full workflow.
27
+
28
+ ## Batch Operations
29
+
30
+ D1 supports batching multiple statements into a single round-trip:
31
+
32
+ ```ts
33
+ import { db, eq } from '@builtbyfriends/bwf/db';
34
+ import { users, posts } from '@schema';
35
+
36
+ await db.batch([
37
+ db.delete(posts).where(eq(posts.userId, userId)),
38
+ db.delete(users).where(eq(users.id, userId)),
39
+ ]);
40
+ ```
41
+
42
+ ## Read replication
43
+
44
+ bwf enables [D1 read replication](https://developers.cloudflare.com/d1/best-practices/read-replication/) when it provisions a database. To enable it on an existing database, run `bwf deploy --platform cloudflare --provision`. Queries through `db` from `@builtbyfriends/bwf/db` use a D1 session for each bwf request, so reads can run near the request and later queries in that request see at least the same data. Framework handlers without bwf's request scope start each database operation on the primary. `createDb` starts a replica-capable session for the binding you pass it.
45
+
46
+ Replicas can lag between requests. Authentication checks use the primary so a lagging replica can't accept a revoked session. For other reads that need the latest primary data, create a client inside the request:
47
+
48
+ ```ts
49
+ import { defineHandler } from '@builtbyfriends/bwf';
50
+ import { createDb } from '@builtbyfriends/bwf/db';
51
+ import { users } from '@schema';
52
+ import { env } from 'cloudflare:workers';
53
+
54
+ export const GET = defineHandler(async () => {
55
+ const primaryDb = createDb(env.DB, { session: 'first-primary' });
56
+ return primaryDb.select().from(users).all();
57
+ });
58
+ ```
59
+
60
+ With `session: 'first-primary'`, the first query reads from the primary and later queries see at least the same data. The default, `'first-unconstrained'`, allows the first query to use a replica.
61
+
62
+ For raw D1 calls or another query library, use `withSession()` to read from replicas. A bare D1 binding reads from the primary.
63
+
64
+ ## Alternative Query Layers
65
+
66
+ Use `env.DB` from `cloudflare:workers` with another query library or the raw D1 API:
67
+
68
+ ### Kysely
69
+
70
+ ```ts
71
+ import { env } from 'cloudflare:workers';
72
+ import { Kysely } from 'kysely';
73
+ import { D1Dialect } from 'kysely-d1';
74
+
75
+ const db = new Kysely<Database>({ dialect: new D1Dialect({ database: env.DB }) });
76
+ ```
77
+
78
+ ### Raw D1
79
+
80
+ ```ts
81
+ import { env } from 'cloudflare:workers';
82
+
83
+ const { results } = await env.DB.prepare('SELECT * FROM users WHERE id = ?').bind(userId).all();
84
+ ```
85
+
86
+ bwf still handles binding inference and deployment regardless of which query layer you use.
@@ -0,0 +1,72 @@
1
+ ---
2
+ description: 'Connect MySQL through Cloudflare Hyperdrive, then query it with Drizzle. bwf applies your migrations on deploy.'
3
+ outline: deep
4
+ ---
5
+
6
+ # MySQL
7
+
8
+ Connect your MySQL database through [Cloudflare Hyperdrive](https://developers.cloudflare.com/hyperdrive/), then define tables and query them with Drizzle. bwf configures the connection and applies your migrations when you deploy.
9
+
10
+ ## Configure
11
+
12
+ Set the dialect in `bwf.config.ts`:
13
+
14
+ ```json
15
+ {
16
+ "database": "mysql"
17
+ }
18
+ ```
19
+
20
+ Add a direct connection for local development:
21
+
22
+ ```dotenv
23
+ DATABASE_URL=mysql://user:password@host:3306/app
24
+ ```
25
+
26
+ bwf reads `.env` for the dev server and `bwf db` commands. In production, the Worker connects through the inferred `HYPERDRIVE` binding.
27
+
28
+ ## Define a schema
29
+
30
+ ```ts
31
+ // db/schema.ts
32
+ import { int, mysqlTable, text, timestamp } from '@builtbyfriends/bwf/schema-mysql';
33
+
34
+ export const messages = mysqlTable('messages', {
35
+ id: int('id').autoincrement().primaryKey(),
36
+ text: text('text').notNull(),
37
+ createdAt: timestamp('created_at').notNull().defaultNow(),
38
+ });
39
+ ```
40
+
41
+ `bwf gen model` generates MySQL builders automatically when the project uses the MySQL dialect.
42
+
43
+ ## Migrations
44
+
45
+ Use the normal workflow:
46
+
47
+ ```sh
48
+ bwf db generate
49
+ bwf db migrate
50
+ bwf deploy
51
+ ```
52
+
53
+ For direct Cloudflare deploys, export the production `DATABASE_URL` in the shell running `bwf deploy --platform cloudflare`. bwf uses it to provision Hyperdrive and apply pending checked-in migrations before uploading the Worker; it is not written to the Worker config.
54
+
55
+ Only one migration run changes a database at a time, whether it comes from `bwf db migrate`, `bwf db reset`, the reset that `bwf db seed` does before it loads data, `bwf deploy --platform cloudflare`, or a `bwf deploy` of any project that uses the database. Better Auth's table changes run inside the same run. Another run waits for it, up to about 20 seconds for a command that connects with `DATABASE_URL` and about 2 minutes for a `bwf deploy` to the bwf platform, then stops with an error that asks you to try again.
56
+
57
+ ### Failed migrations {#failed-migrations}
58
+
59
+ Each migration file runs in a transaction, so a failed file that only changes data leaves the database unchanged. On a sharded Vitess keyspace, such as a sharded PlanetScale database, a commit that fails on one shard does not undo the shards that already committed. MySQL commits schema changes such as `CREATE TABLE` and `ALTER TABLE` immediately, so when a file with schema changes fails partway through, its earlier statements stay applied. The error names the file that failed.
60
+
61
+ To recover, undo the applied statements, fix the file, then run `bwf db migrate` or `bwf deploy` again:
62
+
63
+ ```sh
64
+ bwf db execute "DROP TABLE comments"
65
+ bwf db execute --remote "DROP TABLE comments" # deployed database
66
+ ```
67
+
68
+ MySQL rejects `IF NOT EXISTS` on `ADD COLUMN` and `CREATE INDEX`, so undoing a statement is usually simpler than making it safe to rerun. Small migrations leave less to undo.
69
+
70
+ ## Database commands
71
+
72
+ `bwf db push`, `generate`, `migrate`, `status`, `reset`, `seed`, `execute`, `studio`, `export`, `rename-migrations`, and `set-url` all understand MySQL. Local commands use `DATABASE_URL` from `.env`; `--remote` execution and Studio use the encrypted URL stored for a linked bwf project.
@@ -0,0 +1,94 @@
1
+ ---
2
+ description: 'Connect PostgreSQL through Cloudflare Hyperdrive and query it with the same Drizzle workflow as D1.'
3
+ outline: deep
4
+ ---
5
+
6
+ # PostgreSQL
7
+
8
+ Connect your PostgreSQL database through [Cloudflare Hyperdrive](https://developers.cloudflare.com/hyperdrive/), then use the same Drizzle schema and query workflow as D1.
9
+
10
+ ## What is Hyperdrive?
11
+
12
+ Hyperdrive pools connections between your Worker and PostgreSQL. Requests reuse an existing connection instead of opening a new TCP and TLS connection each time.
13
+
14
+ bwf can provision the Hyperdrive configuration from your connection string. Direct Cloudflare deploys also need an API token for first-time provisioning; see the [Cloudflare guide](../../integrations/cloudflare.md#databases-and-secrets).
15
+
16
+ ## Configuration
17
+
18
+ ### 1. Set the database
19
+
20
+ Add to your `bwf.config.ts`:
21
+
22
+ ```json
23
+ {
24
+ "database": "pg"
25
+ }
26
+ ```
27
+
28
+ ### 2. Add your connection string
29
+
30
+ For local development, add `DATABASE_URL` to `.env`:
31
+
32
+ ```dotenv
33
+ DATABASE_URL=postgresql://user:password@host:5432/mydb?sslmode=require
34
+ ```
35
+
36
+ This connects directly to your Postgres database during local Vite development.
37
+
38
+ ### 3. Deploy
39
+
40
+ For a bwf platform, deploy prompts for the connection string if needed. You can also set it with `bwf db set-url`. For direct Cloudflare deploys, export the production `DATABASE_URL` in your shell.
41
+
42
+ bwf provisions Hyperdrive without saving the connection string in project config. Both `postgres://` and `postgresql://` URLs are supported, including provider query strings such as `?sslmode=require`.
43
+
44
+ The Hyperdrive that bwf creates connects with TLS in Cloudflare's default `require` mode. Hyperdrive does not use the `sslmode=verify-ca`, `sslmode=verify-full`, or `sslrootcert` settings from your connection string. To have Hyperdrive verify your database against a specific certificate authority on a direct Cloudflare deploy, [create the Hyperdrive in Cloudflare with that certificate](https://developers.cloudflare.com/hyperdrive/configuration/tls-ssl-certificates-for-hyperdrive/) and add its ID to [`cloudflare.hyperdrive`](../../integrations/cloudflare.md#databases-and-secrets).
45
+
46
+ ## Schema Definition
47
+
48
+ Import schema helpers from `@builtbyfriends/bwf/schema-pg`:
49
+
50
+ ```ts
51
+ // db/schema.ts
52
+ import { pgTable, serial, text, timestamp, boolean } from '@builtbyfriends/bwf/schema-pg';
53
+
54
+ export const users = pgTable('users', {
55
+ id: serial('id').primaryKey(),
56
+ name: text('name').notNull(),
57
+ email: text('email').notNull().unique(),
58
+ role: text('role').notNull().default('user'),
59
+ active: boolean('active').notNull().default(true),
60
+ createdAt: timestamp('created_at').notNull().defaultNow(),
61
+ updatedAt: timestamp('updated_at').notNull().defaultNow(),
62
+ });
63
+ ```
64
+
65
+ `bwf gen model` generates PostgreSQL-appropriate code when `database` is set to `"pg"`.
66
+
67
+ ## Migrations
68
+
69
+ The migration workflow is the same as D1:
70
+
71
+ ```bash
72
+ # Generate migration files from schema changes
73
+ bwf db generate
74
+
75
+ # Apply pending migrations locally
76
+ bwf db migrate
77
+
78
+ # Check migration status
79
+ bwf db status
80
+ ```
81
+
82
+ The main difference is that PostgreSQL supports **transactional DDL**. Each migration is wrapped in `BEGIN` and `COMMIT`, so a failure rolls back the whole migration instead of leaving the database half-updated.
83
+
84
+ `bwf deploy` applies pending migrations before making the new version live. See [Deployment](../deployment.md).
85
+
86
+ ## Updating the Connection String
87
+
88
+ To update a linked bwf project's connection, for example after moving the database to another host:
89
+
90
+ ```bash
91
+ bwf db set-url
92
+ ```
93
+
94
+ This prompts for the new connection string and updates the Hyperdrive configuration.