@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,478 @@
1
+ ---
2
+ description: 'Configure routing, inference, resources, and deployment in bwf.config.ts.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Config
7
+
8
+ ## Config File Format
9
+
10
+ Use `bwf.config.ts` to configure your app. For a guided introduction, start with [What is bwf?](../guide/).
11
+
12
+ Put `bwf.config.ts` at the project root and import `defineConfig` from `@builtbyfriends/bwf/config`. All fields are optional. `bwf init`, `bwf deploy`, and `bwf migrate` can convert older bwf and Cloudflare JSON config files, saving backups under `.bwf/config-migration/`. Commit `bwf.config.ts` and `bwf.lock.json` when bwf creates the lock; it records resource IDs and migration history.
13
+
14
+ ```ts
15
+ // bwf.config.ts
16
+ import { defineConfig } from '@builtbyfriends/bwf/config';
17
+
18
+ export default defineConfig({
19
+ sourceDir: 'src',
20
+ auth: { providers: ['email', 'github', 'google'] },
21
+ routing: {
22
+ headers: {
23
+ '/assets/*': ['Cache-Control: public, max-age=31536000, immutable'],
24
+ '/*': ['X-Frame-Options: DENY', 'X-Content-Type-Options: nosniff'],
25
+ },
26
+ },
27
+ inference: {
28
+ bindings: { db: true, kv: false },
29
+ appType: 'spa',
30
+ outputDir: 'dist',
31
+ },
32
+ worker: {
33
+ compatibility_date: '2025-12-01',
34
+ compatibility_flags: ['nodejs_compat'],
35
+ },
36
+ cloudflare: {
37
+ name: 'my-app',
38
+ account_id: 'your-account-id',
39
+ },
40
+ });
41
+ ```
42
+
43
+ TypeScript provides editor completion and checks. bwf validates the config again when it runs, including values computed at runtime.
44
+
45
+ Use relative imports or package names inside `bwf.config.ts`. TypeScript path aliases such as `@/lib/theme` are not supported.
46
+
47
+ The shorter JSON fragments below show individual fields to place inside `defineConfig({ ... })`.
48
+
49
+ ## Fields
50
+
51
+ ### `sourceDir`
52
+
53
+ Directory containing bwf source conventions, relative to the project root.
54
+
55
+ When omitted, bwf uses the existing project-root conventions: `routes/`, `middleware/`, `crons/`, `queues/`, `db/`, `auth.ts`, and `env.ts`.
56
+
57
+ When set, those conventions move under the configured directory:
58
+
59
+ ```json
60
+ { "sourceDir": "src" }
61
+ ```
62
+
63
+ With that config, bwf reads `src/routes`, `src/db/schema.ts`, `src/db/migrations`, `src/auth.ts`, and `src/env.ts`. Project files such as `bwf.config.ts`, `vite.config.ts`, `package.json`, `tsconfig.json`, `public/`, and the local-only `.env` stay at the project root. bwf does not scan both locations; if source conventions exist in both places during dev/build, remove one copy so the active source tree is unambiguous.
64
+
65
+ ### `ai`
66
+
67
+ Set `ai.gateway` to the Cloudflare AI Gateway used by `ai.provider().fetch()` on your own Cloudflare account. `ai.run()`, `ai.stream()`, and `ai.image()` use the Workers AI binding. On a bwf platform, the platform selects the gateway.
68
+
69
+ ```json
70
+ { "ai": { "gateway": "my-gateway" } }
71
+ ```
72
+
73
+ See [AI on your Cloudflare account](../integrations/cloudflare.md#ai-self-host).
74
+
75
+ ### `auth`
76
+
77
+ High-level Better Auth configuration.
78
+
79
+ Use `auth.providers` to select which built-in auth providers bwf should enable by default. Include `"email"` for email/password auth. Social providers read credentials 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`.
80
+
81
+ ```json
82
+ {
83
+ "auth": {
84
+ "providers": ["email", "github", "google", "discord"]
85
+ }
86
+ }
87
+ ```
88
+
89
+ If `auth` is omitted but auth is active via imports, bwf enables email/password only. For provider-specific options, scopes, plugins, or custom OAuth flows, use a root `auth.ts` with `defineAuth(...)`.
90
+
91
+ Supported values for `auth.providers`:
92
+
93
+ - `email`
94
+ - `apple`
95
+ - `atlassian`
96
+ - `cognito`
97
+ - `discord`
98
+ - `dropbox`
99
+ - `facebook`
100
+ - `figma`
101
+ - `github`
102
+ - `gitlab`
103
+ - `google`
104
+ - `huggingface`
105
+ - `kakao`
106
+ - `kick`
107
+ - `line`
108
+ - `linear`
109
+ - `linkedin`
110
+ - `microsoft`
111
+ - `naver`
112
+ - `notion`
113
+ - `paybin`
114
+ - `paypal`
115
+ - `polar`
116
+ - `railway`
117
+ - `reddit`
118
+ - `roblox`
119
+ - `salesforce`
120
+ - `slack`
121
+ - `spotify`
122
+ - `tiktok`
123
+ - `twitch`
124
+ - `twitter`
125
+ - `vercel`
126
+ - `vk`
127
+ - `zoom`
128
+
129
+ ### `database`
130
+
131
+ Database backend. Omit for D1/SQLite (default). Set to `"pg"` or `"mysql"` for an external database through Hyperdrive.
132
+
133
+ ```json
134
+ {
135
+ "database": "pg"
136
+ }
137
+ ```
138
+
139
+ | Value | Description |
140
+ | ----------- | ------------------------------------------------------ |
141
+ | _(omitted)_ | D1 (SQLite), fully managed by bwf with no extra config |
142
+ | `"pg"` | PostgreSQL via Hyperdrive; bring your own database |
143
+ | `"mysql"` | MySQL via Hyperdrive; bring your own database |
144
+
145
+ Use an object to also set how Drizzle names columns declared without a name:
146
+
147
+ ```json
148
+ {
149
+ "database": { "dialect": "pg", "casing": "snake_case" }
150
+ }
151
+ ```
152
+
153
+ | Key | Values | Description |
154
+ | --------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
155
+ | `dialect` | `"sqlite"` (default), `"pg"`, `"mysql"` | Database backend. `"sqlite"` is D1 |
156
+ | `casing` | `"snake_case"`, `"camelCase"` | [Drizzle casing](https://orm.drizzle.team/docs/sql-schema-declaration#camel-and-snake-casing) for `@builtbyfriends/bwf/db` queries and `bwf db` commands. Omit to use each key as its column name |
157
+
158
+ When using an external database:
159
+
160
+ - Add `DATABASE_URL` to `.env` for local development
161
+ - Import schema helpers from `@builtbyfriends/bwf/schema-pg` or `@builtbyfriends/bwf/schema-mysql`
162
+ - `@builtbyfriends/bwf/db` connects via Hyperdrive in production, direct connection locally
163
+ - `bwf gen model` generates dialect-appropriate table and column builders
164
+
165
+ ### `email`
166
+
167
+ Configuration for the [email integration](../guide/email.md).
168
+
169
+ ```json
170
+ {
171
+ "email": {
172
+ "from": "Acme <noreply@mail.acme.com>"
173
+ }
174
+ }
175
+ ```
176
+
177
+ | Field | Type | Description |
178
+ | ------ | -------- | -------------------------------------------------------------------------------------------------------------- |
179
+ | `from` | `string` | Default sender for `sendEmail()`: one address, optionally with a display name (`Acme <noreply@mail.acme.com>`) |
180
+
181
+ During development, `email.from` is the default sender in the local inbox. On a bwf platform, use your project's shared sender or registered domain.
182
+
183
+ For direct Cloudflare deployment, this address selects the mail domain and default sender. Use a zone or subdomain in your account; an existing mail provider's MX records are preserved. Without `email.from`, bwf skips automatic setup and preserves authored `cloudflare.send_email` bindings and `cloudflare.addresses`; check their readiness yourself. `--require-email` still refuses deployment when automatic setup cannot be verified. See [Email setup](../guide/email/domains.md#your-own-cloudflare-account).
184
+
185
+ ### `remote`
186
+
187
+ Use a deployed bwf project's D1, KV, and R2 resources during local development. Writes affect real data. See [Remote Development](../guide/remote-dev.md).
188
+
189
+ ```json
190
+ { "remote": true }
191
+ ```
192
+
193
+ **Requirements:**
194
+
195
+ - Must be logged in (`bwf account login`)
196
+ - Must have a linked project (`bwf project link`)
197
+ - Only affects D1 (`DB`), KV (`KV`), and R2 (`STORAGE`) bindings
198
+
199
+ You can also enable remote mode via the `BWF_REMOTE=1` environment variable without modifying `bwf.config.ts`:
200
+
201
+ ```bash
202
+ BWF_REMOTE=1 pnpm dev
203
+ ```
204
+
205
+ ### `sandbox`
206
+
207
+ Enable and configure Cloudflare Sandboxes. Importing from `@builtbyfriends/bwf/sandbox` enables this automatically.
208
+
209
+ ```json
210
+ {
211
+ "sandbox": {
212
+ "image": "./Dockerfile.sandbox",
213
+ "platformImage": "registry.cloudflare.com/<account-id>/sandbox@sha256:<digest>",
214
+ "instanceType": "standard-1"
215
+ }
216
+ }
217
+ ```
218
+
219
+ | Field | Type | Default |
220
+ | ------------------- | -------- | --------------------------- |
221
+ | `durableObject` | `string` | None |
222
+ | `binding` | `string` | `SANDBOX` |
223
+ | `className` | `string` | `SandboxV1` |
224
+ | `containerName` | `string` | `void-sandbox-v1` |
225
+ | `image` | `string` | Packaged Node.js Dockerfile |
226
+ | `imageBuildContext` | `string` | Directory of `image` |
227
+ | `platformImage` | `string` | `cloudflare/debian-trixie` |
228
+ | `instanceType` | `string` | `lite` |
229
+
230
+ Supported sizes are `lite` and `standard-1` through `standard-4`. Native deploys build Dockerfiles with Docker; registry images must be digest-pinned references from the Cloudflare managed registry. Custom images must include the matching Sandbox SDK helper. For a local Dockerfile, supply `platformImage` when deploying to a managed platform. See [Sandboxes](../guide/sandboxes.md) for image setup and runtime examples.
231
+
232
+ Set `durableObject` to a file name in `durable-objects/` (for example `"bot"`) to attach the container image to that class instead of bwf's `SandboxV1`. The class must use `this.ctx.container`; its binding and class come from the file, so `binding` and `className` must be omitted. It needs a native Cloudflare deploy: managed platforms run containers in their own controller, so use `getSandbox` from `@builtbyfriends/bwf/sandbox` there.
233
+
234
+ Sandbox requires [Workers Paid](https://dash.cloudflare.com/?to=/:account/workers/plans) and Containers access. Managed runtime tokens need Account / Containers: Edit and Account / Cloudchamber: Edit. See [Sandbox deployment](../guide/sandboxes.md#deployment).
235
+
236
+ ### `storage.locationHint`
237
+
238
+ Choose a preferred region when bwf creates your app's R2 bucket, on either a bwf platform or a direct Cloudflare deployment:
239
+
240
+ ```json
241
+ { "storage": { "locationHint": "apac" } }
242
+ ```
243
+
244
+ Supported hints are `apac` (Asia Pacific), `eeur` (Eastern Europe), `enam` (Eastern North America), `weur` (Western Europe), `wnam` (Western North America), and `oc` (Oceania). Cloudflare treats these as [best-effort location hints](https://developers.cloudflare.com/r2/reference/data-location/), not data residency guarantees.
245
+
246
+ The project setting overrides the platform's default. Without either, Cloudflare chooses automatically. This only affects new buckets: changing the hint never moves or replaces an existing bucket. Apps that do not use R2 create no bucket.
247
+
248
+ ### `worker`
249
+
250
+ Cloudflare Workers settings, including the `compatibility_date` pinned by `bwf init`. Put binding arrays such as `d1_databases`, `kv_namespaces`, and `r2_buckets` in [`cloudflare`](#cloudflare).
251
+
252
+ | Field | Type | Description |
253
+ | --------------------- | ---------- | -------------------------------------- |
254
+ | `compatibility_date` | `string` | Cloudflare Workers compatibility date |
255
+ | `compatibility_flags` | `string[]` | Cloudflare Workers compatibility flags |
256
+ | `vars` | `object` | Plain-text worker variables |
257
+ | `limits` | `object` | Worker resource limit overrides |
258
+
259
+ ```json
260
+ {
261
+ "worker": {
262
+ "compatibility_date": "2025-12-01",
263
+ "compatibility_flags": ["nodejs_compat"],
264
+ "vars": {
265
+ "PUBLIC_API_BASE": "https://api.example.com"
266
+ }
267
+ }
268
+ }
269
+ ```
270
+
271
+ `worker.vars` values must be strings. Root `.env` values override them during local development only. Production builds do not load `.env`, and reject any `worker.vars` name declared as a server key in `env.ts`. Use `bwf secret put` for production server values.
272
+
273
+ Managed deployments include `worker.vars` as plain-text bindings. A remote secret with the same name takes precedence. To use the configured variable instead, remove that remote secret and deploy again. Secret deletion changes the running Worker immediately, so plan this migration during a maintenance window.
274
+
275
+ `worker.limits.cpu_ms` sets the CPU time limit per request, from 1 to 300000 ms. On a bwf platform, deploy fails if the limit exceeds the account plan; lower it in `bwf.config.ts` before retrying. Rollback instead caps the old limit at the current plan ceiling. On direct deploys, [Cloudflare enforces the value](https://developers.cloudflare.com/workers/platform/limits/#cpu-time): Workers Free allows up to 10 ms and Workers Paid up to 300000 ms per request.
276
+
277
+ ```json
278
+ {
279
+ "worker": {
280
+ "limits": {
281
+ "cpu_ms": 30000
282
+ }
283
+ }
284
+ }
285
+ ```
286
+
287
+ ### `cloudflare`
288
+
289
+ The complete Cloudflare Worker configuration for direct Cloudflare builds and deployment. Put custom bindings, `name`, `account_id`, routes, services, vars, migrations, and any other Cloudflare fields here. bwf passes these fields through to the generated Cloudflare build configuration. Settings you edit here take precedence over values bwf previously recorded in `bwf.lock.json`.
290
+
291
+ ```ts
292
+ // Inside defineConfig({ ... })
293
+ cloudflare: {
294
+ name: 'my-app',
295
+ d1_databases: [{ binding: 'ANALYTICS', database_name: 'analytics', database_id: '...' }],
296
+ vars: { PUBLIC_API_BASE: 'https://api.example.com' },
297
+ },
298
+ ```
299
+
300
+ bwf writes a generated Cloudflare config for its tooling and records provisioned resource IDs and append-only migration history in `bwf.lock.json`. Commit the lock when it changes. Root `wrangler.jsonc` and `wrangler.json` are migrated on `bwf init` or `bwf deploy`; bwf keeps backup copies under `.bwf/config-migration/`.
301
+
302
+ Bindings declared here are typed on `c.env` after `bwf prepare` or starting a dev server or build. See [Custom Binding Types](../guide/type-safety.md#custom-binding-types) for an example and RPC type overrides.
303
+
304
+ If you need to remove a value that bwf previously generated, remove it from the `resolved` object in `bwf.lock.json`. bwf refreshes the generated Cloudflare file on the next command. Put ongoing custom settings in `cloudflare` in `bwf.config.ts`.
305
+
306
+ ### `deploy.cloudflare.mode`
307
+
308
+ Direct Cloudflare deploys use `staged` by default: bwf checks the new Worker before sending it production traffic. If Cloudflare cannot stage an existing Durable Object Worker, choose `atomic` after reviewing the pending Worker and database changes:
309
+
310
+ ```ts
311
+ // Inside defineConfig({ ... })
312
+ deploy: { cloudflare: { mode: 'atomic' } },
313
+ ```
314
+
315
+ This choice applies to subsequent `bwf deploy` runs. Atomic deployment sends traffic to the new Worker before bwf checks readiness; a Durable Object class migration cannot be rolled back across its migration boundary. Use `--atomic` for a single deployment instead. `deploy` is a bwf setting and is not passed to Cloudflare's Worker config.
316
+
317
+ ### `routing`
318
+
319
+ Routing and edge configuration for headers, redirects, rewrites, and fallbacks.
320
+
321
+ #### `routing.alwaysUseHttps`
322
+
323
+ Redirect HTTP requests to HTTPS with a permanent `308` redirect. Omitted or `false` means off. Requires the Cloudflare target. `localhost` stays on HTTP. See [HTTP to HTTPS](../guide/edge/redirects#http-to-https) for where it works.
324
+
325
+ ```ts
326
+ routing: {
327
+ alwaysUseHttps: true,
328
+ }
329
+ ```
330
+
331
+ #### `routing.typedRoutes`
332
+
333
+ Check URL strings against your app's routes in redirects, rewrites, and stream clients. This changes TypeScript checks only; navigation at runtime stays the same.
334
+
335
+ ```ts
336
+ routing: {
337
+ typedRoutes: true,
338
+ }
339
+ ```
340
+
341
+ The default is `false`; `bwf init` enables it for new apps. See [Checked URL strings](../guide/type-safety#checked-url-strings) for accepted URLs and casts for values you validate at runtime.
342
+
343
+ #### `routing.headers`
344
+
345
+ Custom response headers. Keys are URL patterns, values are arrays of `"Name: value"` strings. See [Custom Headers](../guide/edge/headers) for details.
346
+
347
+ ```json
348
+ {
349
+ "routing": {
350
+ "headers": {
351
+ "/assets/*": ["Cache-Control: public, max-age=31536000, immutable"],
352
+ "/*": ["X-Frame-Options: DENY", "X-Content-Type-Options: nosniff"]
353
+ }
354
+ }
355
+ }
356
+ ```
357
+
358
+ #### `routing.redirects`
359
+
360
+ URL redirects. Keys are source URL patterns, values are destination strings (302 default) or objects with `to` and optional `status` (`301`, `302`, `303`, `307`, `308`). See [Redirects](../guide/edge/redirects) for details.
361
+
362
+ ```json
363
+ {
364
+ "routing": {
365
+ "redirects": {
366
+ "/old": "/new",
367
+ "/blog/*": { "to": "/posts/:splat", "status": 301 }
368
+ }
369
+ }
370
+ }
371
+ ```
372
+
373
+ #### `routing.rewrites`
374
+
375
+ URL rewrites. Keys are source URL patterns, values are destination paths. Serves content from the destination without changing the browser URL. See [Rewrites](../guide/edge/rewrites) for details.
376
+
377
+ ```json
378
+ {
379
+ "routing": {
380
+ "rewrites": {
381
+ "/": "/en",
382
+ "/docs/*": "/en/docs/:splat"
383
+ }
384
+ }
385
+ }
386
+ ```
387
+
388
+ Destinations use the `RewriteDestination` shape — typed route patterns plus `string`, so known routes autocomplete while dynamic paths remain accepted. See [Programmatic rewrites](../guide/edge/rewrites#programmatic-rewrites-in-middleware).
389
+
390
+ #### `routing.fallbacks`
391
+
392
+ Fallback rewrites. Same shape as `rewrites`, but rules only fire when no static asset or route matched the request (i.e. the request would otherwise 404). Useful for SPA shells or default-locale catch-alls that shouldn't pre-empt real routes. See [Rewrites → Fallbacks](../guide/edge/rewrites#fallbacks) for details.
393
+
394
+ ```json
395
+ {
396
+ "routing": {
397
+ "fallbacks": {
398
+ "/*": "/index.html"
399
+ }
400
+ }
401
+ }
402
+ ```
403
+
404
+ #### `routing.notFound`
405
+
406
+ Override how the asset layer answers a request that matched no asset and no worker route. One of `"single-page-application"`, `"404-page"`, or `"none"`. If omitted, bwf infers it — see [Static Assets](../guide/edge/static-assets.md#navigation-and-middleware).
407
+
408
+ ```json
409
+ {
410
+ "routing": {
411
+ "notFound": "404-page"
412
+ }
413
+ }
414
+ ```
415
+
416
+ Use `"404-page"` for a generated static site with a `404.html`, `"single-page-application"` for a client router, or `"none"` to keep the Worker's own 404. API and middleware routing remain unchanged.
417
+
418
+ ### `inference`
419
+
420
+ Configuration for build-time inference, including how bwf detects your app type, bindings, and build process.
421
+
422
+ #### `inference.bindings`
423
+
424
+ Explicitly control inferred Cloudflare bindings. If omitted, bindings are [automatically inferred](./resource-inference.md) by scanning your source files for binding usage. Explicit values override the named bindings; omitted bindings are still inferred. Auth and checked-in migrations still require a database even when `db` is `false`.
425
+
426
+ Each binding accepts `true` (use default name), `false` (disable), or a string (custom binding name):
427
+
428
+ ```json
429
+ { "inference": { "bindings": { "db": true, "kv": false, "storage": "MY_BUCKET", "ai": "MY_AI" } } }
430
+ ```
431
+
432
+ | Key | Default Binding | Type | Custom Name |
433
+ | --------- | --------------- | ------------- | ------------------------ |
434
+ | `db` | `DB` | `D1Database` | `"db": "MY_DB"` |
435
+ | `kv` | `KV` | `KVNamespace` | `"kv": "MY_KV"` |
436
+ | `storage` | `STORAGE` | `R2Bucket` | `"storage": "MY_BUCKET"` |
437
+ | `ai` | `AI` | `Ai` | `"ai": "MY_AI"` |
438
+ | `email` | — | — | Boolean only |
439
+
440
+ Custom binding names work with `@builtbyfriends/bwf/db`, `@builtbyfriends/bwf/kv`, and `@builtbyfriends/bwf/storage` during development and deployment. Custom AI names also work with `@builtbyfriends/bwf/ai` on direct Cloudflare deploys; managed Workers AI uses the platform's proxy.
441
+
442
+ `email` is a boolean feature switch. Set it to `true` to enable [email](../guide/email.md) and the local email inbox without an import from `@builtbyfriends/bwf/email`, or `false` to disable them. On a bwf platform, sending uses the platform proxy. Direct Cloudflare setup records a `SEND_EMAIL` binding in `bwf.lock.json`; see [`email.from`](#email).
443
+
444
+ #### `inference.build`
445
+
446
+ Override the build command. Useful for static apps with custom build scripts. If omitted, the CLI uses the detected default build command for the current app type. It applies to every app type, including `"nosam"` (where the default is `vite build`).
447
+
448
+ ```json
449
+ { "inference": { "build": "vitepress build" } }
450
+ ```
451
+
452
+ The command is run through a shell from the project root, with the project's own `node_modules/.bin` on `PATH`, so bare binaries and `&&` chains work:
453
+
454
+ ```json
455
+ { "inference": { "build": "vitepress build && vite build" } }
456
+ ```
457
+
458
+ That chain is how a static site generator and a bwf backend ship together — see [Adding a backend to a static site](../guide/app-types.md#adding-a-backend-to-a-static-site).
459
+
460
+ #### `inference.scanDirs`
461
+
462
+ Override which directories are scanned for [binding inference](./resource-inference.md). Paths are relative to the project root. Replaces the default directories for the current mode.
463
+
464
+ ```json
465
+ { "inference": { "scanDirs": ["src", "lib", "workers"] } }
466
+ ```
467
+
468
+ #### `inference.appType`
469
+
470
+ App type. If omitted, auto-detected on first deploy. See [Supported App Types](../guide/app-types.md).
471
+
472
+ - `"nosam"`: React SPA assets plus a Worker for API routes, middleware, and jobs
473
+ - `"static"`: fully rendered HTML files from VitePress, plain HTML, or external tools. Non-matching paths return `404.html` or a 404 response.
474
+ - `"spa"`: static output with SPA fallback. Non-file paths fall back to `index.html` with a `200` status so client-side routing works out of the box.
475
+
476
+ #### `inference.outputDir`
477
+
478
+ Output directory for static deploys, relative to the project root. Only relevant when `inference.appType` is `"spa"` or `"static"`. Defaults to `"dist"`.
@@ -0,0 +1,72 @@
1
+ ---
2
+ description: 'bwf detects the Cloudflare resources your code uses and provisions the matching bindings. Manual configuration is optional.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Resource Inference
7
+
8
+ bwf automatically detects which Cloudflare resources your project uses by scanning source files at startup. In most cases, there is no manual configuration. Use a resource in code, and bwf provisions the matching binding for local development.
9
+
10
+ ## Detected Bindings
11
+
12
+ | Binding | Type | Detected by import | Detected by env access |
13
+ | ---------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
14
+ | `DB` | `D1Database` | `import { db } from "@builtbyfriends/bwf/db"` | `env.DB` or `c.env.DB` |
15
+ | `KV` | `KVNamespace` | `import { kv } from "@builtbyfriends/bwf/kv"` | `env.KV` or `c.env.KV` |
16
+ | `STORAGE` | `R2Bucket` | `import { storage } from "@builtbyfriends/bwf/storage"` | `env.STORAGE` or `c.env.STORAGE` |
17
+ | `AI` | `Ai` | `import { ai } from "@builtbyfriends/bwf/ai"` | `env.AI` or `c.env.AI` |
18
+ | `SANDBOX` | Managed Sandbox capability | `import { getSandbox } from "@builtbyfriends/bwf/sandbox"` | `getSandbox()`; native Cloudflare also exposes `env.SANDBOX` / `c.env.SANDBOX` |
19
+ | Auth | none | `import { ... } from "@builtbyfriends/bwf/auth"` or `import { auth } from "@builtbyfriends/bwf/client"` / `@builtbyfriends/bwf/client/react` | none |
20
+ | `QUEUE_*` | `Queue` | `import { queues } from "@builtbyfriends/bwf/queues"` | `env.QUEUE_*` |
21
+ | `BWF_LIVE` | `DurableObjectNamespace` | `import { defineLiveStream } from "@builtbyfriends/bwf/live"` | n/a |
22
+ | filename-derived | `DurableObjectNamespace` | A default-exported `defineDurableState()` module in `durable-objects/` | n/a |
23
+
24
+ Auth detection also triggers when importing the `auth` specifier from `@builtbyfriends/bwf/client` or a framework-specific client subpath such as `@builtbyfriends/bwf/client/react` (but not when importing only `fetch`).
25
+
26
+ Static bracket access such as `c.env['KV']` and destructured properties such as
27
+ `const { DB, KV: cache } = c.env` are also detected. For keys chosen at runtime,
28
+ use [explicit binding overrides](#explicit-binding-overrides).
29
+
30
+ Durable state is inferred from files in `durable-objects/`. For example, `durable-objects/shopping-cart.ts` creates the `SHOPPING_CART` binding, exports `ShoppingCartDurableObject`, and records its migration. See [Durable State](../guide/durable-state.md).
31
+
32
+ ## Scanned Directories
33
+
34
+ bwf apps scan these directories by default. With [`sourceDir`](./config.md#sourcedir) configured, bwf scans that source tree instead:
35
+
36
+ | Directory | Contains |
37
+ | ------------- | ---------------------- |
38
+ | `routes/` | API route handlers |
39
+ | `middleware/` | Hono middleware |
40
+ | `queues/` | Queue consumers |
41
+ | `crons/` | Scheduled job handlers |
42
+ | `email/` | Inbound email handlers |
43
+ | `src/` | Application source |
44
+
45
+ ### Always scanned
46
+
47
+ Regardless of mode, these are always checked:
48
+
49
+ - **Application source** in `src/` or your configured `sourceDir`, including resource and auth imports
50
+ - **`durable-objects/`**, which is scanned for typed Durable Object state modules in native bwf apps
51
+
52
+ ## Custom Scan Directories
53
+
54
+ If your project organizes code in non-standard directories, you can override which directories are scanned:
55
+
56
+ ```json
57
+ {
58
+ "inference": {
59
+ "scanDirs": ["src", "lib", "workers"]
60
+ }
61
+ }
62
+ ```
63
+
64
+ Paths are relative to the project root. When `inference.scanDirs` is set, it replaces the default directories entirely. The application source scan still applies.
65
+
66
+ ## Explicit Binding Overrides
67
+
68
+ Use [`inference.bindings`](./config.md#inference-bindings) to enable, disable, or rename a binding when inference does not match your setup. It overrides only the bindings you name; the rest are still inferred.
69
+
70
+ ## File Types
71
+
72
+ Inference scans `.ts`, `.tsx`, `.mts`, `.js`, `.jsx`, and `.mjs` files.