@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,71 @@
1
+ ---
2
+ description: 'Look up public imports, signatures, and return types. The guides cover setup and examples.'
3
+ outline: deep
4
+ ---
5
+
6
+ <script setup>
7
+ import LegacyDocRedirect from "../.vitepress/theme/LegacyDocRedirect.vue";
8
+ import links from "../.vitepress/redirects/reference-api.json";
9
+ </script>
10
+
11
+ <LegacyDocRedirect page="reference/api.md" :links="links" />
12
+
13
+ # API Reference {#api-reference}
14
+
15
+ Use this reference to find public imports, signatures, and return types. For setup and examples, start with the [guides](../guide/index.md).
16
+
17
+ ## API Topics
18
+
19
+ | Topic | Use it for |
20
+ | -------------------------------------------------- | ---------------------------------------------------- |
21
+ | [Plugin and configuration](./api/plugin.md) | Add bwf to Vite and configure your app. |
22
+ | [Handlers and middleware](./api/handlers.md) | HTTP routes, validation, scheduled jobs, and queues. |
23
+ | [Rewrites](./api/rewrites.md) | Serve another route while keeping the requested URL. |
24
+ | [Authentication](./api/auth.md) | Sessions, users, and the auth client. |
25
+ | [Fetch client](./api/client.md) | Typed requests and errors. |
26
+ | [Durable State and WebSockets](./api/durable.md) | Persistent objects and typed connections. |
27
+ | [Database and seeding](./api/database.md) | Queries, operators, and seed scripts. |
28
+ | [KV, storage, AI, and logging](./api/resources.md) | Resource clients and logs. |
29
+ | [Deployment artifacts](./api/deploy.md) | Package built apps for managed deployment. |
30
+ | [Types](./api/types.md) | Typed URLs, route types, and handler context. |
31
+ | [Environment variables](./api/env.md) | Validated environment values and binding types. |
32
+
33
+ ## User-Facing Imports {#user-facing-imports}
34
+
35
+ Import bwf's app-facing APIs from these paths:
36
+
37
+ | Import path | Contents |
38
+ | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
39
+ | `bwf` | `bwfPlugin`, handler/type re-exports |
40
+ | `@builtbyfriends/bwf/handler` | `defineHandler`, `defineMiddleware`, `basicAuth`, `defineScheduled`, `defineQueue`, types |
41
+ | `@builtbyfriends/bwf/auth` | `defineAuth`, `getUser`, `getSession`, `requireAuth`, `AuthUser`, `AuthSession`, `AuthState` |
42
+ | `@builtbyfriends/bwf/client` | `fetch`, `fetchStream`, `FetchError`, `auth`, `createAuthClient`, `AuthUser`, `AuthSession`, `AuthState` |
43
+ | `@builtbyfriends/bwf/client/react` | Same as `@builtbyfriends/bwf/client`, with the React Better Auth client |
44
+ | `@builtbyfriends/bwf/ws` | `defineRoom`, `defineWebSocket`, `connect`, WebSocket context and connection types |
45
+ | `@builtbyfriends/bwf/durable` | `defineDurableState`, `defineDurableObject`, typed state/RPC/context/migration types |
46
+ | `@builtbyfriends/bwf/sse` | `eventStream`, `formatSse`, `formatSseText`, `getLastEventId`, `SseStreamClosedError`, SSE message and stream types |
47
+ | `@builtbyfriends/bwf/sse/client` | `connectEventStream`, browser `EventSource` wrapper types |
48
+ | `@builtbyfriends/bwf/live` | `defineLiveStream`, SSE topic fanout runtime types. Server-only. |
49
+ | `@builtbyfriends/bwf/live/client` | `connectLiveStream`, browser helper for one SSE connection plus POST subscribe/unsubscribe control. |
50
+ | `@builtbyfriends/bwf/response` | `convertReturnValue` |
51
+ | `@builtbyfriends/bwf/validator` | `runValidation`, `ValidatorSlots`, `HandlerInput` |
52
+ | `@builtbyfriends/bwf/drizzle-zod` | Re-exports [`drizzle-zod`](https://orm.drizzle.team/docs/zod) for schema-derived Zod validators for Drizzle tables |
53
+ | `@builtbyfriends/bwf/drizzle-valibot` | Re-exports [`drizzle-valibot`](https://orm.drizzle.team/docs/valibot) for schema-derived Valibot validators for Drizzle tables |
54
+ | `@builtbyfriends/bwf/drizzle-arktype` | Re-exports [`drizzle-arktype`](https://orm.drizzle.team/docs/arktype) for schema-derived ArkType validators for Drizzle tables |
55
+ | `@builtbyfriends/bwf/schema-d1` | Re-exports [`drizzle-orm/sqlite-core`](https://orm.drizzle.team/docs/column-types/sqlite) for D1 table and column builders |
56
+ | `@builtbyfriends/bwf/schema-pg` | Re-exports [`drizzle-orm/pg-core`](https://orm.drizzle.team/docs/column-types/pg) for PostgreSQL table and column builders |
57
+ | `@builtbyfriends/bwf/schema-mysql` | Re-exports `drizzle-orm/mysql-core` for MySQL table and column builders |
58
+ | `@builtbyfriends/bwf/database-provider` | `defineDatabaseProvider` and adapter types for `bwf db connect --provider` |
59
+ | `@builtbyfriends/bwf/db` | `db` (Drizzle D1, PostgreSQL, or MySQL instance for the active dialect), `createDb`, query operators (`eq`, `and`, `or`, `desc`, `like`, `inArray`, etc.) |
60
+ | `@builtbyfriends/bwf/seed` | `defineSeed`, `SeedContext`, `SeedFn` for programmatic `bwf db seed` modules |
61
+ | `@builtbyfriends/bwf/kv` | `kv`, `createKV`, typed KV client/map types |
62
+ | `@builtbyfriends/bwf/storage` | `storage`, `createStorage` for the inferred R2 binding or a specific `R2Bucket` |
63
+ | `@builtbyfriends/bwf/ai` | `ai`, `BwfAi`, model input and response types |
64
+ | `@builtbyfriends/bwf/limits` | `UsageLimit`, `UsageLimitData`, and `readUsageLimit`. AI and Sandbox limits reject with `UsageLimit`; uncaught limits in bwf routes return structured HTTP 429 responses. |
65
+ | `@builtbyfriends/bwf/log` | `logger` structured logging helper |
66
+ | `@builtbyfriends/bwf/routes` | [`routeUrl()`](./api/types.md#routeurl-path-options), `RouteDestination`, `RoutePath`, `RouteOptions`, `RouteUrl`, `Href`, `RouteUrlInput`, and generated route maps |
67
+ | `@builtbyfriends/bwf/queues` | `queues` proxy for sending messages to typed queues |
68
+ | `@builtbyfriends/bwf/email` | `sendEmail`, `createEmail`, `defineEmail`, `parseEmail`, `replyEmail`, `MimeError`, `ParseEmailError`, and address, attachment, result, and handler types. See [Email](../guide/email.md). |
69
+ | `@builtbyfriends/bwf/email/testing` | `createEmailTestHarness` and `createInboundTestHarness` to capture sends and deliver test messages to `email/` handlers. |
70
+ | `@builtbyfriends/bwf/sandbox` | `getSandbox`, `sandbox`, `SandboxLimitError`, `SandboxUnavailableError`, and the SDK 1.0 file, backup, and mount helpers. `getSandbox(id)` resolves a client. Commands, files, port requests, and process completion return promises; limits reject with `SandboxLimitError`, which extends `UsageLimit`. Container state lasts until inactivity (default ten minutes), a crash, or a restart. See [Sandboxes](../guide/sandboxes.md) for the API and deployment requirements. |
71
+ | `@builtbyfriends/bwf/env` | `defineEnv`, `env`, schema helpers (`string`, `number`, `boolean`, `url`, `email`, `oneOf`, `json`), and global Cloudflare env types |
@@ -0,0 +1,87 @@
1
+ ---
2
+ description: 'Connect the CLI to Cloudflare or a bwf platform, and sign in to the account that receives deploys.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Connections and Authentication {#connect}
7
+
8
+ ```sh
9
+ bwf connect
10
+ bwf connect platform.example.com
11
+ bwf connect --platform cloudflare
12
+ bwf connect --platform void
13
+ ```
14
+
15
+ Connect a project to its deployment destination. With no arguments, choose Cloudflare or a bwf platform interactively. A URL selects a bwf platform directly. `--platform void` offers saved platforms and an option to enter another URL.
16
+
17
+ You can use a hostname: `bwf connect platform.example.com` connects over HTTPS. Loopback hosts (`localhost`, `127.0.0.1`, and `[::1]`) default to HTTP, so use `bwf connect localhost:8787` for a local platform. This also works in the interactive prompt. Include a scheme to override the default, for example `bwf connect https://localhost:8787`.
18
+
19
+ For Cloudflare, bwf signs in through the browser when needed, selects an accessible account, and saves `cloudflare.account_id` in `bwf.config.ts` or resolved state in `bwf.lock.json`. It shares this setup with `bwf init`. An existing account selection is preserved; conflicting or inaccessible account settings must be resolved before continuing.
20
+
21
+ For a bwf platform, bwf checks the connection and signs you in through your browser when needed. It saves credentials in your system keychain separately for each platform.
22
+
23
+ The deployment preference is saved in `.bwf/project.json`. Connecting to another bwf platform preserves an existing project link; the CLI explains when that link or an environment override still selects a different destination. Use `bwf project link` to explicitly choose a project. Cloudflare selection also retains existing bwf project metadata so you can switch back later.
24
+
25
+ In a non-interactive shell, supply a URL or explicit target. Cloudflare requires usable credentials and an unambiguous account (`CLOUDFLARE_ACCOUNT_ID` when needed). For a bwf platform, provide `BWF_TOKEN` with a matching `BWF_API_URL`, or reuse a valid origin-scoped keychain session. Use `bwf connect <url> --no-login` to save the verified connection without authenticating; this option is only available for bwf platforms.
26
+
27
+ ## Authentication {#authentication}
28
+
29
+ `bwf auth login`, `bwf auth status`, and `bwf auth logout` use the destination
30
+ saved for the current project by `bwf init` or `bwf connect`. If no destination
31
+ is saved, interactive commands let you choose Cloudflare or a connected bwf
32
+ platform. In a non-interactive shell, pass `--platform cloudflare|void` or use
33
+ the explicit `bwf cloudflare` and `bwf account` commands. Choosing a destination
34
+ for authentication does not change the project's deploy target.
35
+
36
+ ## bwf platform account {#nosam-platform-account}
37
+
38
+ ### `bwf account login` {#nosam-account-login}
39
+
40
+ Browser login through one of the platform's currently enabled methods. The token is saved in the operating-system keychain, scoped to the platform origin. Login fails closed when no keychain is available instead of writing the token to a plaintext file; headless environments use `BWF_TOKEN` from their secret manager.
41
+
42
+ Connect to a platform with `bwf connect <url>` before logging in. If an older project link has no platform URL, connect and run `bwf project link` to select its project again.
43
+
44
+ Set `BWF_API_URL` alongside `BWF_TOKEN` to identify the platform that issued it.
45
+ Both the URL and token are required for environment-based authentication, and the
46
+ URL must already be connected. In a fresh CI environment, run
47
+ `bwf connect "$BWF_API_URL" --no-login` before deploying. To use a platform's
48
+ saved login instead, unset `BWF_TOKEN`.
49
+
50
+ This is optional if you already completed auth during `bwf connect` or the interactive `bwf init` flow.
51
+
52
+ ### `bwf account link [connection-id]` {#nosam-account-link-connection-id}
53
+
54
+ Link another enabled login method to your current account. Sign in again if your
55
+ session is no longer recent, complete the additional provider's browser login,
56
+ and confirm the displayed identity. With no connection ID, choose an enabled
57
+ method interactively. The optional dashboard exposes the same flow in **Account**.
58
+
59
+ ### `bwf account logout` {#nosam-account-logout}
60
+
61
+ Removes saved credentials.
62
+
63
+ ### `bwf account whoami` {#nosam-account-whoami}
64
+
65
+ Prints your current login.
66
+
67
+ ### `bwf account token` {#nosam-account-token}
68
+
69
+ Copies your human auth token to the system clipboard. It is intended for
70
+ interactive troubleshooting and remains subject to login-method revocation. Do
71
+ not combine it with a Cloudflare Access service token for CI; machine Access
72
+ proof cannot turn a human bwf token into an automation identity. Create a
73
+ project-scoped credential with `bwf project token create` instead.
74
+
75
+ ## Cloudflare authentication {#cloudflare-authentication}
76
+
77
+ Use bwf's Cloudflare commands to sign in and manage credentials. No separate Cloudflare CLI is needed. Browser credentials are encrypted and protected by your system keychain.
78
+
79
+ - `bwf cloudflare login` — sign in through your browser or switch Cloudflare users.
80
+ - `bwf cloudflare status` — show your identity, credential source, accessible accounts, and deployment account.
81
+ - `bwf cloudflare logout` — remove the local browser session.
82
+
83
+ Interactive `bwf connect --platform cloudflare`, `bwf init`, and `bwf deploy --platform cloudflare` invoke the same login flow automatically when necessary. Non-interactive CI must set `CLOUDFLARE_API_TOKEN`.
84
+
85
+ Signing in changes the browser session, not `account_id` in the project configuration. Check `bwf cloudflare status` after switching users; if the new user cannot access the pinned account, resolve the project target separately before deploying.
86
+
87
+ An API token or global API key pair in the environment takes precedence over browser credentials. Explicit browser login stops with the names of these overrides; remove them from that shell before signing in. `status` reports the active credential source, and `logout` warns if environment credentials remain active. Explicit browser login requires an interactive terminal; automatic deployment checks continue to reuse valid sessions.
@@ -0,0 +1,159 @@
1
+ ---
2
+ description: 'Generate migrations, apply them, and update the local database from your Drizzle schema.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Database {#database}
7
+
8
+ ## `bwf db push` {#nosam-db-push}
9
+
10
+ Apply your Drizzle schema directly to the development database without creating migration files. D1 updates the local database; PostgreSQL and MySQL use `DATABASE_URL` from `.env`.
11
+
12
+ Use this for quick schema iteration while prototyping. Before deploying, generate and review migration files with `bwf db generate`.
13
+
14
+ ## `bwf db generate` {#nosam-db-generate}
15
+
16
+ Generate SQL migration files from schema changes.
17
+
18
+ Compares your schema with the last Drizzle snapshot and writes migrations under `db/migrations/`. It includes Nosam-managed auth tables and configured auth plugins, even without an application schema. Review and commit the generated files before deploying.
19
+
20
+ For SQLite, bwf checks that the migration history applies to a fresh database. If generation fails this check, the previous SQL, snapshots, and journal are restored. If an existing migration fails, repair that unapplied migration first: rerunning generation compares snapshots and does not repair existing SQL. This check does not verify that a migration preserves existing data; review table rebuilds and foreign-key actions carefully.
21
+
22
+ ## `bwf db status` {#nosam-db-status}
23
+
24
+ Show applied and pending migrations locally and on the saved deployment target. Direct Cloudflare PostgreSQL and MySQL projects use `DATABASE_URL` from the current shell for remote status.
25
+
26
+ ## `bwf db reset` {#nosam-db-reset}
27
+
28
+ ```
29
+ bwf db reset [--yes]
30
+ ```
31
+
32
+ Reset the development database and re-apply all migrations. D1 resets local data. PostgreSQL clears tables, views, sequences, and custom types from the `public` schema while preserving extensions; dependencies from other schemas must be resolved first. MySQL drops all tables and views. PostgreSQL and MySQL use `DATABASE_URL` from `.env`.
33
+
34
+ When that `DATABASE_URL` points to a host other than `localhost`, bwf names the database and asks before dropping its tables. Pass `--yes` to skip the prompt in scripts and CI; without a terminal, the command stops unless `--yes` is set. If `.env` uses the same URL as your deployment (for example after `bwf db connect`), reset drops the deployed tables.
35
+
36
+ ## `bwf db seed` {#nosam-db-seed}
37
+
38
+ ```
39
+ bwf db seed [--file <path>] [--yes]
40
+ ```
41
+
42
+ Reset the local database, re-apply all migrations, then execute a seed file. The reset works like `bwf db reset`, including the prompt and `--yes`.
43
+
44
+ If `--file` is omitted, bwf looks for default seed files in this order: `db/seed.ts`, `db/seed.mts`, `db/seed.js`, `db/seed.mjs`, `db/seed.sql`.
45
+
46
+ If more than one default seed file exists, the CLI stops and asks you to pass `--file <path>`.
47
+
48
+ Programmatic seed modules must export either a default function or a named `seed` function.
49
+
50
+ ## `bwf db execute` {#nosam-db-execute}
51
+
52
+ ```
53
+ bwf db execute <sql>
54
+ bwf db execute --file <path>
55
+ bwf db execute --remote <sql>
56
+ ```
57
+
58
+ Run ad-hoc SQL against the database. Provide SQL inline or from a file. SELECT queries display results as a formatted table; other statements execute silently.
59
+
60
+ By default, targets the local database. Pass `--remote` to run against the deployed database selected in `.bwf/project.json`:
61
+
62
+ - **bwf platform D1 projects**: routes the query through the selected platform's registered proxy using your auth token.
63
+ - **Direct Cloudflare D1 projects**: invokes Cloudflare against the pinned D1 binding from `bwf.config.ts` or `bwf.lock.json`.
64
+ - **Hosted PostgreSQL and MySQL projects**: fetches the stored connection string from the platform and connects directly.
65
+ - **Direct Cloudflare PostgreSQL and MySQL projects**: uses `DATABASE_URL` from the current shell; Cloudflare cannot return the password from Hyperdrive.
66
+
67
+ For destructive statements (`DELETE`, `UPDATE`, `DROP`, etc.) when running in a TTY, you will be prompted to confirm before the query is sent to the deployed database. Non-TTY environments (CI) skip the prompt.
68
+
69
+ ## `bwf db migrate` {#nosam-db-migrate}
70
+
71
+ ```
72
+ bwf db migrate [--remote]
73
+ ```
74
+
75
+ Apply pending migrations to the local database without resetting. Unlike `bwf db reset`, this preserves existing data and only runs migrations that haven't been applied yet.
76
+
77
+ Pass `--remote` to apply pending migrations to the saved target. Hosted projects require a bwf login and link. Direct Cloudflare D1 projects use the binding's configured migration directory, table, and pattern. The D1 binding must set `migrations_dir`. Direct PostgreSQL and MySQL projects use the shell `DATABASE_URL`.
78
+
79
+ ## `bwf db studio` {#nosam-db-studio}
80
+
81
+ ```
82
+ bwf db studio [--remote]
83
+ ```
84
+
85
+ Open [Drizzle Studio](https://orm.drizzle.team/docs/drizzle-kit-studio) for the database. Launches a web-based GUI for browsing and editing your data.
86
+
87
+ By default, targets the local database. Pass `--remote` to open Studio against the deployed database:
88
+
89
+ - **Hosted PostgreSQL and MySQL projects**: fetch the stored connection string from the platform and open Studio against it. If the URL isn't stored yet, run `bwf db set-url` first.
90
+ - **Direct Cloudflare PostgreSQL and MySQL projects**: use `DATABASE_URL` from the current shell.
91
+ - **D1 projects**: use `bwf db execute --remote` to query the deployed database.
92
+
93
+ ## `bwf db restore` {#nosam-db-restore}
94
+
95
+ ```
96
+ bwf db restore --bookmark <bookmark> [--platform cloudflare] [--yes]
97
+ bwf db restore --timestamp <iso-time> [--platform cloudflare] [--yes]
98
+ ```
99
+
100
+ Restore a directly deployed Cloudflare D1 database using [Time Travel](https://developers.cloudflare.com/d1/reference/time-travel/). Use the bookmark printed before deployment migrations, or an ISO 8601 timestamp with a timezone, such as `2026-10-16T09:30:00Z`.
101
+
102
+ Time Travel keeps 7 days of history on Workers Free and 30 days on Workers Paid. Reverse older migrations with a new migration.
103
+
104
+ Restoring discards every write made after the selected point. bwf asks for confirmation and prints a command to undo the restore afterward. Pass `--yes` for scripts and CI.
105
+
106
+ To recover from a bad migration:
107
+
108
+ 1. Roll back the code with [`bwf project rollback`](./project.md#nosam-project-rollback-deployid) if the live version needs the newer schema.
109
+ 2. Restore the database using the printed bookmark.
110
+ 3. Fix or remove the failed migration before deploying again. The restore also rewinds migration history, so the next deploy reapplies pending files.
111
+
112
+ For a one-off Cloudflare deployment, add `--platform cloudflare` to restore, rollback, and deploy commands.
113
+
114
+ ## `bwf db rename-migrations` {#nosam-db-rename-migrations}
115
+
116
+ For linked bwf platform projects, rename migrations from numeric prefixes (`0001_name.sql`) to timestamps (`20260410161500_name.sql`) and update local and remote migration records. Sign in and run `bwf project link` first.
117
+
118
+ For direct Cloudflare deployments, keep existing filenames. New migrations use timestamps and run after them.
119
+
120
+ ## `bwf db connect` {#nosam-db-connect}
121
+
122
+ Connect an existing PostgreSQL/MySQL database or provision one through an adapter:
123
+
124
+ ```sh
125
+ bwf db connect 'postgresql://user:password@host/database'
126
+ NEON_API_KEY=... bwf db connect --provider neon --name my-app
127
+ bwf db connect --provider @acme/nosam-db-provider --region region-id
128
+ ```
129
+
130
+ The command saves `DATABASE_URL` in `.env`. When authenticated with a linked bwf project, it also updates the encrypted deployment URL; pass `--local-only` to skip that sync. `neon` is built in. Other adapters are project dependencies or local modules exporting a `DatabaseProviderAdapter` from `@builtbyfriends/bwf/database-provider`.
131
+
132
+ Provider-created credentials are never printed. For direct Cloudflare deploys, configure the same URL as a protected `DATABASE_URL` in the shell or CI environment that runs deploy.
133
+
134
+ For an existing PostgreSQL database migrated by Drizzle, [adopt its applied migration history](../../guide/database.md#adopt-existing-drizzle) before the first bwf deployment.
135
+
136
+ ## `bwf db set-url` {#nosam-db-set-url}
137
+
138
+ Update the PostgreSQL or MySQL connection string for deployment. Available for projects with `"database": "pg"` or `"database": "mysql"`.
139
+
140
+ Prompts for a connection string and sends it to the platform API to create or update the Hyperdrive configuration.
141
+
142
+ ## `bwf db export` {#nosam-db-export}
143
+
144
+ ```
145
+ bwf db export [--output <path>] [--no-data] [--no-schema] [--table <name>]
146
+ ```
147
+
148
+ Dump the local database as SQL. Outputs to stdout by default (pipeable), or to a file with `--output`.
149
+
150
+ Data exports preserve SQLite AUTOINCREMENT and PostgreSQL SERIAL and identity counters, including IDs consumed by deleted rows. SQLite schema exports include indexes, views, and triggers. PostgreSQL schema exports preserve column types, generated columns, identity definitions, serial sequences, constraints, and indexes. `--no-schema` restores counter values into an existing schema; `--no-data` starts counters at their schema-defined starting values.
151
+
152
+ For PostgreSQL schemas with views, triggers, custom types, functions, or standalone sequences, use `pg_dump` for a complete backup. `bwf db export` reports these objects before writing a schema dump.
153
+
154
+ | Flag | Purpose |
155
+ | ----------------- | ---------------------------------- |
156
+ | `--output <path>` | Write to a file instead of stdout |
157
+ | `--no-data` | Schema only (no INSERT statements) |
158
+ | `--no-schema` | Data only (no CREATE TABLE) |
159
+ | `--table <name>` | Export a single table |
@@ -0,0 +1,117 @@
1
+ ---
2
+ description: 'Build an app, provision its resources, apply migrations, and publish it.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Deployment {#deploy}
7
+
8
+ ## `bwf deploy` {#nosam-deploy}
9
+
10
+ ```
11
+ bwf deploy [--project <name>] [--dir <path>] [--spa] [--skip-build] [--skip-migrations] [--debug]
12
+ bwf deploy [--platform <cloudflare|void>] [--require-email]
13
+ bwf deploy --platform cloudflare --atomic
14
+ bwf deploy --platform cloudflare --provision
15
+ ```
16
+
17
+ Auto-detects your project type and chooses the right pipeline. See [Supported App Types](../../guide/app-types.md) and [Deployment](../../guide/deployment.md) for details.
18
+
19
+ Deploying to a bwf platform requires an explicit connection with `bwf connect <url>`.
20
+ A saved project URL or `BWF_API_URL` alone does not establish a connection.
21
+ In fresh CI environments, run `bwf connect "$BWF_API_URL" --no-login` first.
22
+
23
+ On a bwf platform, an accepted deployment continues if the CLI disconnects. The CLI automatically reconnects to its progress. Pressing Ctrl+C stops observation; use `bwf project cancel` to request cancellation and `bwf project status` to inspect the result. If interrupted execution requires recovery, wait for its result before deploying again.
24
+
25
+ The CLI reports stalled progress and automatic recovery, and waits up to 30 minutes after acceptance. If it times out, the deployment can continue; check `bwf project status` before trying another deployment.
26
+
27
+ For an existing bwf Worker, `bwf deploy` can link the Worker and migrate its root Cloudflare config. Keep the first deployment focused on the existing app. See [Deploy an existing Worker](../../integrations/cloudflare.md#deploy-an-existing-worker) for requirements.
28
+
29
+ For Drizzle projects, deploy performs a read-only schema drift check. If a new migration would be generated, deploy stops and tells you to run `bwf db generate`, review the migration, commit it yourself, and rerun `bwf deploy`.
30
+
31
+ | Flag | Purpose |
32
+ | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
33
+ | `--platform <cloudflare\|void>` | Override the platform stored in `.bwf/project.json` |
34
+ | `--project <name>` | Target a specific bwf project by slug; not supported with `--platform cloudflare` |
35
+ | `--dir <path>` | Deploy a pre-built static directory (skips build) |
36
+ | `--spa` | Use SPA mode instead of SSG for static deploys |
37
+ | `--skip-build` | Skip the build step; on Cloudflare this is supported for static/SPA/SSG deploys only |
38
+ | `--skip-migrations` | Deploy without applying application or authentication SQL migrations; supported on Cloudflare and bwf platforms |
39
+ | `--require-email` | Fail when email cannot be set up instead of deploying without it; requires `--platform cloudflare` |
40
+ | `--provision` | Run resource provisioning again even when every resource exists, for example to enable D1 read replication on an existing database; requires `--platform cloudflare` |
41
+ | `--atomic` | Publish an existing Durable Object Worker directly; readiness is checked after traffic changes |
42
+ | `--debug` | Mirror the structured deploy log to stderr (also written to `~/.bwf/logs/`) |
43
+
44
+ `--atomic` applies to one deployment. For an existing Durable Object Worker that consistently cannot stage, set `deploy: { cloudflare: { mode: 'atomic' } }` in `bwf.config.ts` so plain `bwf deploy` uses atomic publication. The default is `staged`.
45
+
46
+ Use `--skip-migrations` when you run migrations separately or share a database with a preview. The code must work with the database's current schema. The next deploy without this flag applies pending migrations.
47
+
48
+ Keep migration files and schema validation in place. This option skips application and authentication SQL; Durable Object class migrations still run when publishing code. If a bwf platform doesn't support the flag, upgrade it first.
49
+
50
+ Every deploy writes a JSONL log to `~/.bwf/logs/`. Failures print the log path and relevant details. Use `--debug` or `BWF_DEPLOY_DEBUG=1` to mirror it to stderr.
51
+
52
+ Keep credentials out of build commands and register them as CI secrets so your CI provider can mask them in logs.
53
+
54
+ Platform resolution precedence:
55
+
56
+ 1. `--platform <cloudflare|void>`
57
+ 2. `platform` in `.bwf/project.json`
58
+ 3. bwf for projects initialized by an older SDK without a saved platform
59
+
60
+ Selecting Skip deployment setup stores `"platform": "none"`; a later `bwf deploy` stops with guidance until a platform override is provided.
61
+
62
+ For the bwf platform, project resolution precedence is:
63
+
64
+ 1. `--project <name>`
65
+ 2. `BWF_PROJECT`
66
+ 3. linked project in `.bwf/project.json`
67
+
68
+ If no project is linked and no override is provided, CLI prompts to link or create one. In CI (non-TTY), `bwf deploy` errors out instead — set `BWF_PROJECT` or pass `--project <slug>`.
69
+
70
+ To deploy to another connected bwf platform for one invocation:
71
+
72
+ ```sh
73
+ bwf connect second.example.com
74
+ BWF_API_URL=https://second.example.com bwf deploy --platform void --project my-app
75
+ ```
76
+
77
+ `BWF_API_URL` selects the platform and `--project` selects its project. You must
78
+ name the project when overriding a different platform's saved link. Existing
79
+ project links and deployment preferences remain unchanged, even when the target
80
+ project is created. The same applies to `BWF_PROJECT` and to another project on
81
+ the current platform. A first deployment still links the project when no destination
82
+ is configured. See [Deploy to another bwf platform](../../guide/deployment.md#deploy-to-another-nosam-platform).
83
+
84
+ ## `bwf deploy --platform cloudflare` {#nosam-deploy-platform-cloudflare}
85
+
86
+ Build and deploy to your Cloudflare account using `bwf.config.ts`:
87
+
88
+ ```sh
89
+ bwf deploy --platform cloudflare
90
+ bwf deploy --platform cloudflare --require-email # fail instead of deploying without email
91
+ ```
92
+
93
+ bwf signs you in through your browser when needed and saves the selected account. In CI, set `CLOUDFLARE_API_TOKEN` and, if the token can access several accounts, `CLOUDFLARE_ACCOUNT_ID`.
94
+
95
+ | Option or setting | Cloudflare behavior |
96
+ | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
97
+ | `--dir`, `--spa` | Deploy static output through a small Worker and Workers Assets |
98
+ | `--skip-build` | Reuse existing static, SPA, or SSG output; unavailable for Worker apps |
99
+ | `--skip-migrations` | Skip database migrations; existing PostgreSQL/MySQL Hyperdrive bindings do not require `DATABASE_URL` just to skip SQL |
100
+ | `--project` | Unavailable; the Worker and account come from `bwf.config.ts` and `bwf.lock.json` |
101
+ | Named environments | Unavailable; use the top-level `cloudflare` config |
102
+ | `CLOUDFLARE_WORKERS_SUBDOMAIN` | Needed in fresh CI when a workers.dev Worker has no preview URL; cached locally after a deploy. It does not apply when `workers_dev` is false |
103
+ | `CF_ACCESS_READINESS_ORIGIN` | Lets Access credentials reach the readiness check on a route or Custom Domain, for example `https://app.example.com` |
104
+ | `--require-email` | Fail instead of deploying without email when the email step cannot run, as in CI |
105
+ | `DATABASE_URL` | Required in the deploy environment for PostgreSQL or MySQL provisioning and migrations |
106
+
107
+ After `--skip-migrations`, direct Cloudflare deployment history shows the applied migration state as unknown. Rolling back code doesn't reverse database changes.
108
+
109
+ The token needs Workers Scripts: Edit, read access to bound resources, and edit access to products bwf provisions. Commit `bwf.lock.json` after the first deploy before using other machines or CI.
110
+
111
+ Use `bwf secret put <NAME>` for production server values. Local `.env` values are never deployed. Run `bwf db generate` and commit schema changes before deploying.
112
+
113
+ Sandbox requires [Workers Paid](https://dash.cloudflare.com/?to=/:account/workers/plans), Docker, and Containers access. API tokens need Account / Containers: Edit and Account / Cloudchamber: Edit.
114
+
115
+ For email, set `email.from` and run `bwf email setup --platform cloudflare` locally. Commit the lock file and pass `--require-email` in CI. See [Email setup](../../guide/email/domains.md#your-own-cloudflare-account).
116
+
117
+ For Access credentials, Hyperdrive permissions, readiness, and rollback, see [Cloudflare deployment](../../integrations/cloudflare.md#deploy-to-your-own-cloudflare-account).
@@ -0,0 +1,42 @@
1
+ ---
2
+ description: 'Add, remove, and check custom domains for a hosted project or a direct Cloudflare deploy.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Custom Domains {#custom-domains}
7
+
8
+ ## `bwf domain add` {#nosam-domain-add}
9
+
10
+ ```
11
+ bwf domain add <hostname> [--project <name>]
12
+ ```
13
+
14
+ Add a custom domain to the saved target. Hosted bwf projects print the DNS records needed for SaaS hostname validation. Direct Cloudflare projects add a `custom_domain` route and immediately synchronize only the route configuration, leaving cron, queue, and workflow triggers unchanged; Cloudflare manages the DNS record and TLS certificate in a zone on the pinned account. Convert a legacy singular `route` field to a `routes` array first so adding the domain cannot shadow the existing route.
15
+
16
+ > Wildcard custom hostnames (`*.example.com`) are not supported — register each subdomain individually.
17
+
18
+ ## `bwf domain delete` {#nosam-domain-delete}
19
+
20
+ ```
21
+ bwf domain delete <hostname> [--project <name>]
22
+ ```
23
+
24
+ Direct Cloudflare projects apply the change immediately. Deleting the final custom domain uses your browser session from `bwf cloudflare login` or an API token with Workers Scripts: Edit permission. If Cloudflare rejects the change, bwf attempts to restore the previous domain configuration and reports whether recovery succeeded.
25
+
26
+ ## `bwf domain list` {#nosam-domain-list}
27
+
28
+ ```
29
+ bwf domain list [--project <name>]
30
+ ```
31
+
32
+ List all custom domains. Hosted projects show active/pending state from the platform; direct Cloudflare projects list the custom-domain routes currently configured in `bwf.config.ts`.
33
+
34
+ ## `bwf domain status` {#nosam-domain-status}
35
+
36
+ ```
37
+ bwf domain status <hostname> [--project <name>] [--verbose]
38
+ ```
39
+
40
+ Show domain verification and TLS certificate status, including DNS records to configure and any required action. Domains activate automatically once verification and certificate issuance finish.
41
+
42
+ For direct Cloudflare projects, status reports whether the route is present in the bwf Cloudflare config. It does not claim to inspect remote certificate issuance; Cloudflare owns that state and exposes it in the dashboard. `--project` is hosted-only.