@builtbyfriends/bwf 0.0.0-stage → 1.9.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (448) hide show
  1. package/AGENTS_TEMPLATE.md +4 -0
  2. package/LICENSE +22 -0
  3. package/README.md +48 -2
  4. package/dist/account-cmd-Ddt8lGeL.mjs +45 -0
  5. package/dist/agents-BLiMq9E1.mjs +113 -0
  6. package/dist/application-analysis-C9Ck2Yeg.mjs +1498 -0
  7. package/dist/application-routing-DbR-W5lG.mjs +25 -0
  8. package/dist/atomic-write-DA6eD1Kp.mjs +17 -0
  9. package/dist/auth-BKsUmWbT.d.mts +77 -0
  10. package/dist/auth-DkvoW5hB.mjs +33 -0
  11. package/dist/auth-aKyIWkdS.mjs +1 -0
  12. package/dist/auth-client-6-Ft9i9T.d.mts +5 -0
  13. package/dist/auth-client-DwCdwKbw.mjs +5 -0
  14. package/dist/auth-client-react-CJdeErvM.mjs +5 -0
  15. package/dist/auth-client-react-DvQLe5Zb.d.mts +5 -0
  16. package/dist/auth-link-CCl-hJol.mjs +26 -0
  17. package/dist/auth-migrations-DDeifS3v.mjs +206 -0
  18. package/dist/auth-router-BG74WFUf.mjs +66 -0
  19. package/dist/auth-xnkmpZUl.mjs +311 -0
  20. package/dist/base64-ikl9yBy3.mjs +15 -0
  21. package/dist/better-auth-shared-Br6TNaYJ.mjs +473 -0
  22. package/dist/better-auth-shared-CsBNvPOU.d.mts +56 -0
  23. package/dist/build-cmd-BnZezraT.mjs +153 -0
  24. package/dist/build-output-dir-Clj_unKN.mjs +402 -0
  25. package/dist/cancel-deploy-DKAj5U1Z.mjs +57 -0
  26. package/dist/cf-access-Bhz9wX6p.mjs +131 -0
  27. package/dist/cf-access-CUP5L08W.mjs +67 -0
  28. package/dist/cf-build-output-DA6uJomQ.mjs +1 -0
  29. package/dist/cf-build-output-DNQTwMNU.mjs +438 -0
  30. package/dist/cf-command-values-2kOtxMo1.mjs +26 -0
  31. package/dist/cf-config-migrate-COOCi4Ge.mjs +330 -0
  32. package/dist/cf-worker-settings-CIh4t_yG.mjs +41 -0
  33. package/dist/cli/cli.d.mts +1 -0
  34. package/dist/cli/cli.mjs +88 -0
  35. package/dist/cli/cloudflare-operation-process.d.mts +1 -0
  36. package/dist/cli/cloudflare-operation-process.mjs +1284 -0
  37. package/dist/cli/env-schema-probe.d.mts +43 -0
  38. package/dist/cli/env-schema-probe.mjs +165 -0
  39. package/dist/cli-main-BfYf6fnB.mjs +1846 -0
  40. package/dist/client-D3D5RM5h.mjs +940 -0
  41. package/dist/client-VF2Nzc7Z.mjs +1 -0
  42. package/dist/cloudflare-auth-DzkU9H6r.mjs +152 -0
  43. package/dist/cloudflare-cmd-Bm6UhzAQ.mjs +59 -0
  44. package/dist/cloudflare-config-i8yanry0.mjs +186 -0
  45. package/dist/cloudflare-connect-B4ItSbJi.mjs +55 -0
  46. package/dist/cloudflare-operations-BcK849ue.mjs +1 -0
  47. package/dist/cloudflare-operations-DGF7xH7O.mjs +627 -0
  48. package/dist/cloudflare-process-tThIjEB2.mjs +309 -0
  49. package/dist/cloudflare-user-output-CqONaAbP.mjs +19 -0
  50. package/dist/collect-8i0wU63d.mjs +1 -0
  51. package/dist/collect-C6Blu9yw.mjs +48 -0
  52. package/dist/config-CN_RFRkS.mjs +86 -0
  53. package/dist/config-D5G-Tx6o.mjs +1 -0
  54. package/dist/config-DOaFIK3w.mjs +88 -0
  55. package/dist/config-entry.d.mts +202 -0
  56. package/dist/config-entry.mjs +6 -0
  57. package/dist/config-tNx0HlFv.mjs +516 -0
  58. package/dist/connect-CSNWKLzB.mjs +84 -0
  59. package/dist/create-project-B35ux-LA.mjs +126 -0
  60. package/dist/create-project-tJ1KwNss.mjs +1 -0
  61. package/dist/database-provider-DkZo4VwN.mjs +5 -0
  62. package/dist/database-provider.d.mts +25 -0
  63. package/dist/database-provider.mjs +1 -0
  64. package/dist/db-SOv4E9wr.mjs +1735 -0
  65. package/dist/delete-BSKI7V23.mjs +65 -0
  66. package/dist/deploy-BCSQoKC0.mjs +2 -0
  67. package/dist/deploy-CWJ3JJs_.mjs +6512 -0
  68. package/dist/deploy.d.mts +31 -0
  69. package/dist/deploy.mjs +118 -0
  70. package/dist/dev-inbox-I0nqTCdf.mjs +216 -0
  71. package/dist/discover-DJPmQcL5.mjs +36 -0
  72. package/dist/discover-EVuydEoM.mjs +1 -0
  73. package/dist/dist-B6eN80gc.mjs +1612 -0
  74. package/dist/dist-Cp4b1_T9.mjs +1 -0
  75. package/dist/dist-DMYe8CZJ.mjs +48 -0
  76. package/dist/dist-STQXl8ck.mjs +1878 -0
  77. package/dist/domain-BJaAbxuQ.mjs +149 -0
  78. package/dist/dotenv-4NdUCXbB.mjs +156 -0
  79. package/dist/drizzle-DqVFXtlc.mjs +306 -0
  80. package/dist/drizzle-Ds5P0n-S.mjs +1 -0
  81. package/dist/edge.d.mts +2 -0
  82. package/dist/edge.mjs +1 -0
  83. package/dist/email-C_ATvNIG.mjs +2865 -0
  84. package/dist/email-cloudflare-oXk2G1G3.mjs +854 -0
  85. package/dist/email-protocol-CZ0bAkI8.mjs +81 -0
  86. package/dist/email-rIfZgVAB.mjs +742 -0
  87. package/dist/env-BGTu3KWZ.mjs +73 -0
  88. package/dist/env-DUyTzroe.mjs +88 -0
  89. package/dist/env-Dl4Wggec.mjs +71 -0
  90. package/dist/env-helpers-BX0APszT.mjs +135 -0
  91. package/dist/env-helpers-U56xuFgL.d.mts +20 -0
  92. package/dist/env-mask-BsHxq3R8.mjs +46 -0
  93. package/dist/env-public-Cw_xPi1D.d.mts +119 -0
  94. package/dist/env-raw-Bo6TtrHU.mjs +41 -0
  95. package/dist/env-types-Bg-dTh8u.mjs +56 -0
  96. package/dist/env-validation-BlXzGgLZ.mjs +1 -0
  97. package/dist/env-validation-DeqFUSKg.mjs +488 -0
  98. package/dist/fetch-CBgyyhzm.d.mts +87 -0
  99. package/dist/fetch-error-DmlRM6e4.mjs +264 -0
  100. package/dist/fetch-stream-2GUN3YN1.mjs +102 -0
  101. package/dist/fetch-stream-bUXynOyZ.d.mts +32 -0
  102. package/dist/fetch-tpPiSK10.mjs +25 -0
  103. package/dist/gen-dc13IRXh.mjs +509 -0
  104. package/dist/gen-kQqhFyOP.mjs +1 -0
  105. package/dist/generate-BgtlYpKg.mjs +1 -0
  106. package/dist/generate-Da9mWKzU.mjs +80 -0
  107. package/dist/generated-wrangler-config-CoDaaFsA.mjs +17 -0
  108. package/dist/git-metadata-Cukp5kV5.mjs +82 -0
  109. package/dist/github-cmd-DT5Onu6E.mjs +690 -0
  110. package/dist/handler-B_ocHStk.d.mts +279 -0
  111. package/dist/handler-CNq7aSs1.mjs +161 -0
  112. package/dist/help-BK35YcRa.mjs +1946 -0
  113. package/dist/help-DaRezBj7.mjs +1 -0
  114. package/dist/inbound-CqubE-9T.d.mts +311 -0
  115. package/dist/inbound-lHugZPuK.mjs +509 -0
  116. package/dist/index.d.mts +64 -0
  117. package/dist/index.mjs +4163 -0
  118. package/dist/info-CLQoCenb.mjs +109 -0
  119. package/dist/init-CXanf5ck.mjs +2486 -0
  120. package/dist/limits-CMmYT2l8.d.mts +16 -0
  121. package/dist/limits-D27Lp6FP.mjs +46 -0
  122. package/dist/link-DinwJnon.mjs +52 -0
  123. package/dist/list-B1WAE9Wt.mjs +130 -0
  124. package/dist/live-KkEeda1Z.d.mts +105 -0
  125. package/dist/live-saC8barp.mjs +410 -0
  126. package/dist/load-user-env-g0ahkZcj.mjs +34 -0
  127. package/dist/local-d1-bUoAtFUe.mjs +103 -0
  128. package/dist/log-JDnPc0cF.mjs +23 -0
  129. package/dist/login-BUzyiyHV.mjs +1 -0
  130. package/dist/login-Dbv_T3Ru.mjs +87 -0
  131. package/dist/logs-BjMJooJQ.mjs +129 -0
  132. package/dist/migrate-DjW9_-sS.mjs +1 -0
  133. package/dist/migrate-DtcfKqPW.mjs +125 -0
  134. package/dist/migration-handler-22qiuWPq.mjs +469 -0
  135. package/dist/migration-handler-Bb2BJh6g.d.mts +38 -0
  136. package/dist/mime-BMUN_QKG.mjs +1004 -0
  137. package/dist/mysql-migration-sql-CNuBSqdx.mjs +239 -0
  138. package/dist/neon-CJzQSycr.mjs +52 -0
  139. package/dist/node-tfv-3v0V.mjs +64 -0
  140. package/dist/operator-ai-logging-Ay7M4KWw.mjs +121 -0
  141. package/dist/operator-args-BiGmSlZx.mjs +722 -0
  142. package/dist/operator-auth-DdYZYEkO.mjs +47 -0
  143. package/dist/operator-client-DBujdELO.mjs +82 -0
  144. package/dist/operator-cmd-BsHKYJYt.mjs +1 -0
  145. package/dist/operator-cmd-DTIkOAnP.mjs +443 -0
  146. package/dist/output-Bb34lF0w.mjs +173 -0
  147. package/dist/output-CVolXKC1.mjs +1 -0
  148. package/dist/package-BX_giUBX.mjs +1444 -0
  149. package/dist/package-json-DvS6IFRv.mjs +43 -0
  150. package/dist/pg-DoyPxa_X.mjs +15 -0
  151. package/dist/picocolors-D1NxSLw-.mjs +71 -0
  152. package/dist/plan-BHNt1QhK.mjs +1 -0
  153. package/dist/plan-DX4_-OM5.mjs +58 -0
  154. package/dist/platform-args-C-DyuCNX.mjs +1 -0
  155. package/dist/platform-args-CyeQWaZ7.mjs +538 -0
  156. package/dist/platform-auth-config-BfXqKSyZ.mjs +371 -0
  157. package/dist/platform-auth-protection-5FR6qoP_.mjs +231 -0
  158. package/dist/platform-auth-recovery-B5ZlqA8K.mjs +309 -0
  159. package/dist/platform-cmd-CcFDxtrl.mjs +1 -0
  160. package/dist/platform-cmd-ChXeBrRH.mjs +193 -0
  161. package/dist/platform-discovery-Bxg9aZXU.mjs +40 -0
  162. package/dist/platform-domain-CwatS3cz.mjs +256 -0
  163. package/dist/platform-lifecycle-0cXTmMsh.mjs +8928 -0
  164. package/dist/platform-lifecycle-BcoBAMux.mjs +1 -0
  165. package/dist/platform-management-6Wbdbob5.mjs +1607 -0
  166. package/dist/platform-management-hhnczOzr.mjs +1 -0
  167. package/dist/platform-plans-config-CkbUKFpm.mjs +447 -0
  168. package/dist/platform-recovery-DgIwlqB-.mjs +96 -0
  169. package/dist/platform-registry-x1m9HBxf.mjs +450 -0
  170. package/dist/platform-runtime-logs-kkoiYFpF.mjs +72 -0
  171. package/dist/platform-setup-DX8y_6Kh.mjs +306 -0
  172. package/dist/prepare-B9mB47T5.mjs +84 -0
  173. package/dist/prepare-DNIq07so.mjs +13 -0
  174. package/dist/prepare-LHkyJqxi.mjs +1 -0
  175. package/dist/project-CC7eN00D.mjs +141 -0
  176. package/dist/project-DcSd4BeI.mjs +1 -0
  177. package/dist/project-cmd-BydRwr-x.mjs +109 -0
  178. package/dist/project-paths-iXHKRTTQ.mjs +159 -0
  179. package/dist/project-slug-BUy0lmyR.mjs +1 -0
  180. package/dist/project-slug-CO6ci9XG.mjs +7 -0
  181. package/dist/project-team-CvdLhDF2.mjs +129 -0
  182. package/dist/project-token-CwZdUEGu.mjs +70 -0
  183. package/dist/project-tsconfig-P9X952KG.mjs +98 -0
  184. package/dist/project-zero-trust-CKDoPdN1.mjs +64 -0
  185. package/dist/providers-Cd3c7wi0.mjs +64 -0
  186. package/dist/providers-Df69hb_X.d.mts +5 -0
  187. package/dist/provision-BA59NCPO.mjs +1 -0
  188. package/dist/provision-C90fULHJ.mjs +1814 -0
  189. package/dist/queues-Bc3FsBQT.d.mts +5 -0
  190. package/dist/r2-conditions-DSLmkiR5.mjs +60 -0
  191. package/dist/requests-DNhfyF3l.mjs +52 -0
  192. package/dist/resolve-project-BCsAMDRA.mjs +47 -0
  193. package/dist/resolve-project-DhU9_lIo.mjs +1 -0
  194. package/dist/resource-name-DlJ9QXzg.mjs +10 -0
  195. package/dist/response-HmNjB30w.mjs +29 -0
  196. package/dist/rollback-wi6WK5T6.mjs +150 -0
  197. package/dist/rolldown-runtime-uD8oG6U2.mjs +24 -0
  198. package/dist/route-types-CRWhr93D.mjs +592 -0
  199. package/dist/route-url-BIDZT78M.mjs +58 -0
  200. package/dist/route-url-Bla3Upsy.d.mts +42 -0
  201. package/dist/routes-stub.d.mts +24 -0
  202. package/dist/routes-stub.mjs +1 -0
  203. package/dist/routing-assets-CSheDWWM.mjs +54 -0
  204. package/dist/rpc-DcByS_q0.d.mts +39 -0
  205. package/dist/rpc-DtxIN9Tv.mjs +19 -0
  206. package/dist/runner-CPerdjIl.mjs +163 -0
  207. package/dist/runner-CUNtS5x7.mjs +1 -0
  208. package/dist/runner-mysql-BjSoQ-mW.mjs +1 -0
  209. package/dist/runner-mysql-BmTI2EiF.mjs +145 -0
  210. package/dist/runner-pg-2pjltt0t.mjs +1 -0
  211. package/dist/runner-pg-mYc75KfH.mjs +61 -0
  212. package/dist/runtime/ai.d.mts +50 -0
  213. package/dist/runtime/ai.mjs +455 -0
  214. package/dist/runtime/auth-client-react.d.mts +2 -0
  215. package/dist/runtime/auth-client-react.mjs +1 -0
  216. package/dist/runtime/auth-client.d.mts +2 -0
  217. package/dist/runtime/auth-client.mjs +1 -0
  218. package/dist/runtime/auth.d.mts +2 -0
  219. package/dist/runtime/auth.mjs +1 -0
  220. package/dist/runtime/better-auth-mysql.d.mts +5 -0
  221. package/dist/runtime/better-auth-mysql.mjs +21 -0
  222. package/dist/runtime/better-auth-pg.d.mts +5 -0
  223. package/dist/runtime/better-auth-pg.mjs +21 -0
  224. package/dist/runtime/better-auth.d.mts +6 -0
  225. package/dist/runtime/better-auth.mjs +22 -0
  226. package/dist/runtime/client-react.d.mts +5 -0
  227. package/dist/runtime/client-react.mjs +5 -0
  228. package/dist/runtime/client.d.mts +5 -0
  229. package/dist/runtime/client.mjs +5 -0
  230. package/dist/runtime/db-mysql.d.mts +2 -0
  231. package/dist/runtime/db-mysql.mjs +1 -0
  232. package/dist/runtime/db-pg.d.mts +2 -0
  233. package/dist/runtime/db-pg.mjs +1 -0
  234. package/dist/runtime/db.d.mts +17 -0
  235. package/dist/runtime/db.mjs +36 -0
  236. package/dist/runtime/drizzle-arktype.d.mts +1 -0
  237. package/dist/runtime/drizzle-arktype.mjs +2 -0
  238. package/dist/runtime/drizzle-valibot.d.mts +1 -0
  239. package/dist/runtime/drizzle-valibot.mjs +2 -0
  240. package/dist/runtime/drizzle-zod.d.mts +1 -0
  241. package/dist/runtime/drizzle-zod.mjs +2 -0
  242. package/dist/runtime/durable.d.mts +64 -0
  243. package/dist/runtime/durable.mjs +165 -0
  244. package/dist/runtime/email/testing.d.mts +108 -0
  245. package/dist/runtime/email/testing.mjs +268 -0
  246. package/dist/runtime/email-protocol.d.mts +25 -0
  247. package/dist/runtime/email-protocol.mjs +1 -0
  248. package/dist/runtime/email.d.mts +26 -0
  249. package/dist/runtime/email.mjs +524 -0
  250. package/dist/runtime/env-public-client.d.mts +19 -0
  251. package/dist/runtime/env-public-client.mjs +55 -0
  252. package/dist/runtime/env-public.d.mts +4 -0
  253. package/dist/runtime/env-public.mjs +277 -0
  254. package/dist/runtime/env.d.mts +12 -0
  255. package/dist/runtime/env.mjs +1 -0
  256. package/dist/runtime/fetch-server.d.mts +6 -0
  257. package/dist/runtime/fetch-server.mjs +29 -0
  258. package/dist/runtime/fetch-stream.d.mts +3 -0
  259. package/dist/runtime/fetch-stream.mjs +3 -0
  260. package/dist/runtime/fetch.d.mts +2 -0
  261. package/dist/runtime/fetch.mjs +3 -0
  262. package/dist/runtime/handler.d.mts +3 -0
  263. package/dist/runtime/handler.mjs +1 -0
  264. package/dist/runtime/kv.d.mts +45 -0
  265. package/dist/runtime/kv.mjs +103 -0
  266. package/dist/runtime/limits.d.mts +2 -0
  267. package/dist/runtime/limits.mjs +1 -0
  268. package/dist/runtime/live-client.d.mts +40 -0
  269. package/dist/runtime/live-client.mjs +282 -0
  270. package/dist/runtime/live-server.d.mts +11 -0
  271. package/dist/runtime/live-server.mjs +419 -0
  272. package/dist/runtime/live.d.mts +3 -0
  273. package/dist/runtime/live.mjs +1 -0
  274. package/dist/runtime/log.d.mts +24 -0
  275. package/dist/runtime/log.mjs +57 -0
  276. package/dist/runtime/migration-handler-mysql.d.mts +2 -0
  277. package/dist/runtime/migration-handler-mysql.mjs +111 -0
  278. package/dist/runtime/migration-handler-pg.d.mts +2 -0
  279. package/dist/runtime/migration-handler-pg.mjs +94 -0
  280. package/dist/runtime/migration-handler.d.mts +2 -0
  281. package/dist/runtime/migration-handler.mjs +1 -0
  282. package/dist/runtime/procedure.d.mts +27 -0
  283. package/dist/runtime/procedure.mjs +36 -0
  284. package/dist/runtime/procedures.d.mts +24 -0
  285. package/dist/runtime/procedures.mjs +56 -0
  286. package/dist/runtime/queues.d.mts +2 -0
  287. package/dist/runtime/queues.mjs +8 -0
  288. package/dist/runtime/remote/binding-handler.d.mts +11 -0
  289. package/dist/runtime/remote/binding-handler.mjs +227 -0
  290. package/dist/runtime/remote/index.d.mts +12 -0
  291. package/dist/runtime/remote/index.mjs +467 -0
  292. package/dist/runtime/response.d.mts +11 -0
  293. package/dist/runtime/response.mjs +1 -0
  294. package/dist/runtime/route-url.d.mts +2 -0
  295. package/dist/runtime/route-url.mjs +1 -0
  296. package/dist/runtime/routing.d.mts +53 -0
  297. package/dist/runtime/routing.mjs +425 -0
  298. package/dist/runtime/rpc-react.d.mts +16 -0
  299. package/dist/runtime/rpc-react.mjs +50 -0
  300. package/dist/runtime/rpc.d.mts +2 -0
  301. package/dist/runtime/rpc.mjs +1 -0
  302. package/dist/runtime/sandbox-container.d.mts +3 -0
  303. package/dist/runtime/sandbox-container.mjs +1 -0
  304. package/dist/runtime/sandbox.d.mts +5 -0
  305. package/dist/runtime/sandbox.mjs +196 -0
  306. package/dist/runtime/schema-d1.d.mts +1 -0
  307. package/dist/runtime/schema-d1.mjs +2 -0
  308. package/dist/runtime/schema-mysql.d.mts +1 -0
  309. package/dist/runtime/schema-mysql.mjs +2 -0
  310. package/dist/runtime/schema-pg.d.mts +1 -0
  311. package/dist/runtime/schema-pg.mjs +2 -0
  312. package/dist/runtime/seed.d.mts +34 -0
  313. package/dist/runtime/seed.mjs +5 -0
  314. package/dist/runtime/sse-client.d.mts +31 -0
  315. package/dist/runtime/sse-client.mjs +42 -0
  316. package/dist/runtime/sse.d.mts +32 -0
  317. package/dist/runtime/sse.mjs +1 -0
  318. package/dist/runtime/storage.d.mts +4 -0
  319. package/dist/runtime/storage.mjs +13 -0
  320. package/dist/runtime/validator.d.mts +2 -0
  321. package/dist/runtime/validator.mjs +1 -0
  322. package/dist/runtime/ws-server.d.mts +26 -0
  323. package/dist/runtime/ws-server.mjs +297 -0
  324. package/dist/runtime/ws.d.mts +2 -0
  325. package/dist/runtime/ws.mjs +108 -0
  326. package/dist/sandbox-CWDjoEG2.d.mts +50 -0
  327. package/dist/sandbox-container-BqamdFCx.d.mts +73 -0
  328. package/dist/sandbox-container-d1AHLpgn.mjs +291 -0
  329. package/dist/secret-D5XrWshs.mjs +146 -0
  330. package/dist/skills-Dr3AjuBF.mjs +63 -0
  331. package/dist/sqlite-validation-CLJXXN93.mjs +24 -0
  332. package/dist/sse-CxR30yMF.mjs +174 -0
  333. package/dist/standard-schema-CuDawHOC.d.mts +40 -0
  334. package/dist/static-asset-marker-mWMX2dLa.mjs +38 -0
  335. package/dist/subcommand-prompt-B9yUo--u.mjs +370 -0
  336. package/dist/terminal-log-text-DNsWJREL.mjs +31 -0
  337. package/dist/types-D7-4tBu7.d.mts +1 -0
  338. package/dist/untrusted-env-lL7RkYiC.mjs +50 -0
  339. package/dist/validate-B-zsjhiz.mjs +162 -0
  340. package/dist/validate-DbqGdPPY.mjs +1 -0
  341. package/dist/validator-8-NZs2Xr.mjs +168 -0
  342. package/dist/version-metadata-DPhqnpaa.mjs +23 -0
  343. package/dist/wrangler-C3uyPadQ.mjs +1 -0
  344. package/dist/wrangler-TqTvJFWS.mjs +1452 -0
  345. package/dist/ws-DZRiIpYw.d.mts +137 -0
  346. package/dist/yarn-pnp-DgWbE7z5.mjs +91 -0
  347. package/docs/guide/ai.md +273 -0
  348. package/docs/guide/app-types.md +101 -0
  349. package/docs/guide/auth.md +255 -0
  350. package/docs/guide/database/d1.md +86 -0
  351. package/docs/guide/database/mysql.md +72 -0
  352. package/docs/guide/database/postgresql.md +94 -0
  353. package/docs/guide/database.md +454 -0
  354. package/docs/guide/deployment.md +124 -0
  355. package/docs/guide/durable-state.md +192 -0
  356. package/docs/guide/edge/headers.md +47 -0
  357. package/docs/guide/edge/redirects.md +85 -0
  358. package/docs/guide/edge/rewrites.md +119 -0
  359. package/docs/guide/edge/static-assets.md +94 -0
  360. package/docs/guide/email/domains.md +119 -0
  361. package/docs/guide/email/receiving.md +142 -0
  362. package/docs/guide/email/sending.md +262 -0
  363. package/docs/guide/email.md +23 -0
  364. package/docs/guide/env-vars.md +115 -0
  365. package/docs/guide/index.md +37 -0
  366. package/docs/guide/jobs.md +80 -0
  367. package/docs/guide/kv.md +100 -0
  368. package/docs/guide/live.md +181 -0
  369. package/docs/guide/platform/administration/access.md +165 -0
  370. package/docs/guide/platform/administration/connected-apps.md +84 -0
  371. package/docs/guide/platform/administration/email.md +169 -0
  372. package/docs/guide/platform/administration/operations.md +100 -0
  373. package/docs/guide/platform/administration/plans.md +156 -0
  374. package/docs/guide/platform/administration/projects.md +74 -0
  375. package/docs/guide/platform/administration/zero-trust.md +205 -0
  376. package/docs/guide/platform/development/local.md +122 -0
  377. package/docs/guide/platform/development/runtime.md +115 -0
  378. package/docs/guide/platform/development/schema-ci.md +44 -0
  379. package/docs/guide/platform/installation/ci.md +62 -0
  380. package/docs/guide/platform/installation/credentials.md +140 -0
  381. package/docs/guide/platform/installation/domains.md +120 -0
  382. package/docs/guide/platform/installation/first-deployment.md +95 -0
  383. package/docs/guide/platform/installation/maintenance.md +250 -0
  384. package/docs/guide/platform/installation/prerequisites.md +176 -0
  385. package/docs/guide/platform/installation/setup.md +300 -0
  386. package/docs/guide/platform/installation/uninstall.md +110 -0
  387. package/docs/guide/platform-administration.md +19 -0
  388. package/docs/guide/platform-development.md +16 -0
  389. package/docs/guide/procedures.md +48 -0
  390. package/docs/guide/project-collaboration.md +99 -0
  391. package/docs/guide/queues.md +149 -0
  392. package/docs/guide/quickstart.md +129 -0
  393. package/docs/guide/remote-dev.md +67 -0
  394. package/docs/guide/sandboxes.md +134 -0
  395. package/docs/guide/self-hosted-platform.md +45 -0
  396. package/docs/guide/server-routing.md +283 -0
  397. package/docs/guide/sse.md +174 -0
  398. package/docs/guide/storage.md +82 -0
  399. package/docs/guide/testing.md +64 -0
  400. package/docs/guide/type-safety.md +270 -0
  401. package/docs/guide/typed-fetch.md +98 -0
  402. package/docs/guide/websockets.md +230 -0
  403. package/docs/index.md +102 -0
  404. package/docs/integrations/agents.md +38 -0
  405. package/docs/integrations/cloudflare.md +241 -0
  406. package/docs/integrations/hono.md +127 -0
  407. package/docs/reference/api/auth.md +195 -0
  408. package/docs/reference/api/client.md +90 -0
  409. package/docs/reference/api/database.md +118 -0
  410. package/docs/reference/api/deploy.md +63 -0
  411. package/docs/reference/api/durable.md +47 -0
  412. package/docs/reference/api/env.md +51 -0
  413. package/docs/reference/api/handlers.md +189 -0
  414. package/docs/reference/api/plugin.md +40 -0
  415. package/docs/reference/api/resources.md +116 -0
  416. package/docs/reference/api/rewrites.md +111 -0
  417. package/docs/reference/api/types.md +126 -0
  418. package/docs/reference/api.md +71 -0
  419. package/docs/reference/cli/auth.md +87 -0
  420. package/docs/reference/cli/database.md +159 -0
  421. package/docs/reference/cli/deploy.md +117 -0
  422. package/docs/reference/cli/domains.md +42 -0
  423. package/docs/reference/cli/email.md +145 -0
  424. package/docs/reference/cli/generate.md +113 -0
  425. package/docs/reference/cli/github.md +181 -0
  426. package/docs/reference/cli/platform-config.md +93 -0
  427. package/docs/reference/cli/platform-email.md +81 -0
  428. package/docs/reference/cli/platform-installation.md +166 -0
  429. package/docs/reference/cli/platform-operations.md +90 -0
  430. package/docs/reference/cli/platform-users.md +159 -0
  431. package/docs/reference/cli/platform-zero-trust.md +60 -0
  432. package/docs/reference/cli/platform.md +78 -0
  433. package/docs/reference/cli/project.md +208 -0
  434. package/docs/reference/cli/secrets.md +79 -0
  435. package/docs/reference/cli/setup.md +88 -0
  436. package/docs/reference/cli.md +115 -0
  437. package/docs/reference/config.md +478 -0
  438. package/docs/reference/resource-inference.md +72 -0
  439. package/docs/reference/structure.md +138 -0
  440. package/package.json +389 -3
  441. package/sandbox.Dockerfile +4 -0
  442. package/schema.json +353 -0
  443. package/skills/bwf/SKILL.md +100 -0
  444. package/skills/migrate-vite-cloudflare-to-bwf/SKILL.md +53 -0
  445. package/templates/assets/bwf.svg +5 -0
  446. package/templates/assets/icons.svg +49 -0
  447. package/templates/assets/react.svg +1 -0
  448. package/templates/assets/stack.svg +35 -0
package/docs/index.md ADDED
@@ -0,0 +1,102 @@
1
+ ---
2
+ description: 'Build with Vite and deploy with bwf: a CLI, platform, and full-stack SDK for apps on Cloudflare.'
3
+ layout: home
4
+ theme: dark
5
+
6
+ hero:
7
+ name: bwf
8
+ text: Build with Vite. Deploy with bwf.
9
+ tagline: bwf is a CLI, platform, and full-stack SDK that unifies building & deploying apps.
10
+ actions:
11
+ - theme: brand
12
+ text: Get Started
13
+ link: ./guide/
14
+ - theme: alt
15
+ text: View on GitHub
16
+ link: https://github.com/voidzero-dev/void
17
+ - theme: alt
18
+ text: Read the Announcement
19
+ link: https://blog.cloudflare.com/deploy-with-nosam
20
+ features:
21
+ - iconify: lucide:layers
22
+ visual: stack
23
+ title: Full-Stack, Inferred
24
+ details: Import what you need. bwf provides local resources and provisions them on deploy.
25
+ highlights:
26
+ - Server routes and authentication
27
+ - Databases, storage, and AI
28
+ - Queues and scheduled jobs
29
+ guide:
30
+ text: Explore the SDK
31
+ link: /guide/
32
+ - iconify: lucide:wand-sparkles
33
+ visual: resources
34
+ title: Typed from Database to UI
35
+ details: Share types across your database, API routes, and React components.
36
+ highlights:
37
+ - Types from your database schema
38
+ - Typed API routes and fetch client
39
+ - Server code stays on the server
40
+ guide:
41
+ text: Explore Type Safety
42
+ link: /guide/type-safety
43
+ - iconify: lucide:blocks
44
+ visual: frameworks
45
+ title: React SPAs with a Backend
46
+ details: Build a React single-page app and add server routes when you need them.
47
+ highlights:
48
+ - React SPA built and served by Vite
49
+ - Optional API routes, middleware, and jobs
50
+ - Deploy static SPAs and static sites too
51
+ guide:
52
+ text: Explore App Types
53
+ link: /guide/app-types
54
+ platform_features:
55
+ - id: platform-ai-coding
56
+ iconify: lucide:bot
57
+ title: Secure Vibe Coding for Your Team
58
+ details: Let your team build and deploy with coding agents while admins retain control of Cloudflare access.
59
+ highlights:
60
+ - Enable non-technical teammates to build their own apps
61
+ - Keep Cloudflare credentials with your admin team
62
+ - Deploy prototypes fast and share apps for feedback
63
+ guide:
64
+ text: Explore team deployments
65
+ link: /guide/self-hosted-platform
66
+ visual: rive
67
+ image_alt: Animated illustration of apps being built for a team
68
+ - id: platform-control-plane
69
+ iconify: lucide:panels-top-left
70
+ visual: resources
71
+ title: Control Plane for Managing Apps
72
+ details: Manage users, projects, deployments, and platform health from the admin UI or CLI.
73
+ highlights:
74
+ - Manage users and project access & resources
75
+ - Inspect deployments, logs, and rollbacks
76
+ - Monitor platform health and usage
77
+ guide:
78
+ text: Platform administration
79
+ link: /guide/platform-administration
80
+ image_alt: List of bwf platform commands for access, builds, invitations, and administration
81
+ - id: platform-security
82
+ iconify: lucide:shield-check
83
+ title: Bring your Own Security
84
+ details: Fork and customize your own bwf platform based on your team's security standards.
85
+ highlights:
86
+ - Manage access through Cloudflare Access, Google, GitHub, or OIDC
87
+ - Control who can sign in and deploy
88
+ - Protect projects with your access policies
89
+ guide:
90
+ text: Configure platform access
91
+ link: /guide/platform/administration/access
92
+ visual: rive
93
+ image_alt: Animated illustration of self-hosted platform security
94
+ footer_heading: Build with Vite. Deploy with bwf.
95
+ footer_subheading: Server code, resources, and deployment in one workflow.
96
+ ---
97
+
98
+ <script setup>
99
+ import Home from './.vitepress/theme/Home.vue'
100
+ </script>
101
+
102
+ <Home />
@@ -0,0 +1,38 @@
1
+ ---
2
+ description: "Set up coding agents with bwf init, including project instructions and links to bwf's docs and skills."
3
+ outline: deep
4
+ ---
5
+
6
+ # Using bwf with Coding Agents
7
+
8
+ `bwf init` sets up coding agents as part of project initialization:
9
+
10
+ ```sh
11
+ npx bwf init
12
+ ```
13
+
14
+ New projects get a minimal `AGENTS.md` explaining bwf and where to read its docs.
15
+ In an existing project, bwf asks before creating, appending to, or updating
16
+ `AGENTS.md`. It preserves your instructions outside the bwf section. Declining
17
+ keeps the file unchanged; CI and non-interactive runs skip changes to existing
18
+ projects' instructions.
19
+
20
+ The complete Markdown docs ship at `node_modules/@builtbyfriends/bwf/docs/`. Start with
21
+ `guide/quickstart.md` for setup and `reference/cli.md` for commands. Agents can
22
+ read them directly, even without a linked skill.
23
+
24
+ ## Skills
25
+
26
+ Skills point your agent to the commands and docs it needs for the task. They link to the installed `bwf` package, so the guidance matches the version your app uses.
27
+
28
+ bwf ships two skills:
29
+
30
+ - **`bwf`:** commands and docs for app development.
31
+ - **`migrate-vite-cloudflare-to-nosam`:** migration skill for converting existing `@cloudflare/vite-plugin` apps to bwf.
32
+
33
+ Skills are linked automatically by `bwf init` when it detects a supported
34
+ agent's configuration. For example, Claude Code uses `.claude/skills/` and Codex
35
+ uses `.agents/skills/`. The skills use the app's installed docs so their guidance
36
+ matches its bwf version. Globally installed skills can use the docs in their
37
+ bwf package when there is no local installation. If no agent is detected, the
38
+ instructions still point directly to the bundled docs.
@@ -0,0 +1,241 @@
1
+ ---
2
+ description: 'Deploy to Cloudflare Workers. bwf detects the resources your app uses, creates bindings, and publishes the Worker.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Cloudflare
7
+
8
+ bwf runs on Cloudflare Workers. It detects the resources your app uses, creates bindings, and deploys to your account.
9
+
10
+ ## Bindings
11
+
12
+ In bwf routes and middleware, use `c.env`:
13
+
14
+ ```ts
15
+ // routes/api/users.ts
16
+ import { defineHandler } from '@builtbyfriends/bwf';
17
+
18
+ export const GET = defineHandler(async (c) => {
19
+ const { results } = await c.env.DB.prepare('SELECT * FROM users').all();
20
+ return c.json({ users: results });
21
+ });
22
+ ```
23
+
24
+ Server code outside a handler can also import bindings from `cloudflare:workers`:
25
+
26
+ ```ts
27
+ import { env } from 'cloudflare:workers';
28
+
29
+ const { results } = await env.DB.prepare('SELECT * FROM users').all();
30
+ ```
31
+
32
+ ### TypeScript setup
33
+
34
+ Add `@builtbyfriends/bwf/env` to your TypeScript types:
35
+
36
+ ```json
37
+ {
38
+ "compilerOptions": {
39
+ "types": ["@builtbyfriends/bwf/env"]
40
+ }
41
+ }
42
+ ```
43
+
44
+ This provides binding and Workers runtime types. For custom bindings in `bwf.config.ts`, run `bwf prepare` or start the dev server or build to type them on `c.env`. See [Custom Binding Types](../guide/type-safety.md#custom-binding-types) for RPC methods on service and Durable Object bindings.
45
+
46
+ ### Available bindings
47
+
48
+ | Binding | Resource | Use in your app |
49
+ | ---------------- | --------------- | ----------------------------------------- |
50
+ | `DB` | D1 | `c.env.DB` or `@builtbyfriends/bwf/db` |
51
+ | `KV` | KV | `c.env.KV` or `@builtbyfriends/bwf/kv` |
52
+ | `STORAGE` | R2 | `c.env.STORAGE` or `@builtbyfriends/bwf/storage` |
53
+ | `AI` | Workers AI | `c.env.AI` or `@builtbyfriends/bwf/ai` |
54
+ | `ASSETS` | Static assets | `c.env.ASSETS.fetch(request)` |
55
+ | `QUEUE_*` | Queues | `defineQueue()` or `@builtbyfriends/bwf/queues` |
56
+ | Filename-derived | Durable Objects | A module in `durable-objects/` |
57
+
58
+ Use [binding configuration](../reference/resource-inference.md#explicit-binding-overrides) when you need to enable, disable, or rename an inferred binding.
59
+
60
+ ## Cloudflare Configuration
61
+
62
+ Define Worker settings in `bwf.config.ts`:
63
+
64
+ ```ts
65
+ import { defineConfig } from '@builtbyfriends/bwf/config';
66
+
67
+ export default defineConfig({
68
+ worker: {
69
+ compatibility_date: '2026-02-24',
70
+ compatibility_flags: ['nodejs_compat'],
71
+ },
72
+ cloudflare: {
73
+ name: 'my-app',
74
+ services: [{ binding: 'API', service: 'my-api-worker' }],
75
+ },
76
+ });
77
+ ```
78
+
79
+ Put binding arrays, resource IDs, routes, and service bindings under `cloudflare`. bwf preserves your configured bindings and adds missing inferred resources. The `worker` field takes precedence for compatibility settings and variables. See [Configuration](../reference/config.md).
80
+
81
+ Commit `bwf.lock.json` when bwf records resource IDs or Durable Object migrations. Keep generated Cloudflare config out of Git.
82
+
83
+ Declare environment variables in `env.ts`, put local values in `.env`, and set production server values with `bwf secret put`. See [Environment Variables](../guide/env-vars.md).
84
+
85
+ ## Deploy to your own Cloudflare account
86
+
87
+ Choose Cloudflare during `bwf init`, then deploy:
88
+
89
+ ```sh
90
+ bwf deploy
91
+ ```
92
+
93
+ bwf opens your browser to sign in and asks which account to use when you have several. If the browser doesn't open, follow the link and confirm the code printed in the terminal.
94
+
95
+ To set up deployment later, run `bwf connect --platform cloudflare`. To select Cloudflare for one deploy, run:
96
+
97
+ ```sh
98
+ bwf deploy --platform cloudflare
99
+ ```
100
+
101
+ Use `bwf cloudflare login`, `status`, and `logout` to manage your session.
102
+
103
+ ### Deploy an existing Worker
104
+
105
+ For an existing bwf app deployed directly to Cloudflare, keep its root `wrangler.jsonc` or `wrangler.json` and run:
106
+
107
+ ```sh
108
+ bwf deploy
109
+ ```
110
+
111
+ If no destination is selected, bwf offers to link the existing Worker. Accept to sign in and deploy. bwf migrates the configuration to `bwf.config.ts` and `bwf.lock.json`, preserving bindings, variables, secrets, routes, and schedules. Commit both files.
112
+
113
+ Keep the first deployment focused on the existing app. Add resources, auth, migrations, or other runtime features after linking. If the Worker has a newer inactive upload, activate or remove it in Cloudflare before retrying.
114
+
115
+ Readiness checks need either an existing [version metadata binding](https://developers.cloudflare.com/workers/runtime-apis/bindings/version-metadata/) or access to [Version URLs](https://developers.cloudflare.com/workers/versions-and-deployments/version-urls/). bwf stops before activation if neither is available.
116
+
117
+ If linking reports a missing binding, use the existing Worker's binding name and resource ID in `cloudflare` and `inference.bindings`. Keep `.bwf/cloudflare-link.json` when retrying.
118
+
119
+ Before changing dashboard-managed triggers or visibility later, add the current `routes`, `workers_dev`, and `preview_urls` to your config. Convert `wrangler.toml` to JSON/JSONC before linking. Named environments need separate bwf project configs.
120
+
121
+ ### What happens during deploy
122
+
123
+ bwf creates missing resources, builds the app, checks secrets and migrations, uploads the Worker, verifies readiness, and updates traffic and triggers. Resource IDs are saved in `bwf.lock.json`.
124
+
125
+ A failed build or validation can leave provisioned resources in your account. Run the first deploy from one machine at a time, then commit the lock file before deploying from other machines or CI.
126
+
127
+ Apps using email need `email.from` in `bwf.config.ts`. bwf reviews the domain's setup before building and asks before changing it. See [Email](../guide/email/domains.md#your-own-cloudflare-account).
128
+
129
+ ### Deploying from CI
130
+
131
+ Set these CI secrets and variables as needed:
132
+
133
+ | Name | When needed |
134
+ | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
135
+ | `CLOUDFLARE_API_TOKEN` | Required. Workers Scripts: Edit, read access to bound resources, and edit access to products bwf provisions. |
136
+ | `CLOUDFLARE_ACCOUNT_ID` | When the token can access several accounts. |
137
+ | `DATABASE_URL` | PostgreSQL and MySQL provisioning and migrations. |
138
+ | `CLOUDFLARE_WORKERS_SUBDOMAIN` | When workers.dev is enabled and the version has no preview URL. Use `my-team` or `my-team.workers.dev`. An account subdomain does not create a readiness URL when `workers_dev` is false. |
139
+ | `CF_ACCESS_CLIENT_ID`, `CF_ACCESS_CLIENT_SECRET` | When Cloudflare Access protects the readiness URL. |
140
+ | `CF_ACCESS_READINESS_ORIGIN` | When Access protects a route or Custom Domain and `workers_dev` is `false`. See [Cloudflare Access](#cloudflare-access). |
141
+
142
+ For email, run `bwf email setup --platform cloudflare` locally, commit `bwf.lock.json`, and pass `--require-email` in CI. The token also needs Email Routing Edit and Email Sending Edit.
143
+
144
+ #### Cloudflare Access
145
+
146
+ For local deployment to an Access-protected Worker, you can use a short-lived user session:
147
+
148
+ ```sh
149
+ export CF_ACCESS_TOKEN="$(cloudflared access token --app=https://<worker>.<account>.workers.dev)"
150
+ ```
151
+
152
+ bwf uses Access credentials for readiness checks without saving them. If checks are denied, the deployment fails. A first-deploy bootstrap can already be active behind Access when this happens.
153
+
154
+ By default, bwf sends Access credentials only to `workers.dev` URLs. If `workers_dev` is `false`, bwf can check readiness through your first route or Custom Domain. To send the credentials there, set `CF_ACCESS_READINESS_ORIGIN` to that hostname's origin:
155
+
156
+ ```sh
157
+ export CF_ACCESS_READINESS_ORIGIN="https://app.example.com"
158
+ ```
159
+
160
+ Set this variable in the shell or CI environment running `bwf deploy`. Use an exact HTTPS origin for a hostname you control that serves this Worker; bwf sends your Access credentials there.
161
+
162
+ ### Databases and secrets
163
+
164
+ For PostgreSQL and MySQL, supply `DATABASE_URL` to the deploy process. bwf uses it for Hyperdrive and migrations without writing it to config. MySQL schema changes can partially apply before an error; see [failed MySQL migrations](../guide/database/mysql.md#failed-migrations).
165
+
166
+ Creating Hyperdrive requires an API token with Hyperdrive edit permission. Alternatively, create it in Cloudflare and add its ID to `cloudflare.hyperdrive`; an existing binding works with browser login.
167
+
168
+ Run `bwf db generate` and commit migrations before deploying schema changes. This includes Better Auth tables. Custom D1 migration directories, tables, and patterns are supported; deploy stops if the files to apply differ from the validated history.
169
+
170
+ Set production server values with `bwf secret put <NAME>`. bwf preserves existing remote secrets and creates `BETTER_AUTH_SECRET` when an auth app needs one. Local `.env` values are never deployed.
171
+
172
+ ### Readiness and rollback
173
+
174
+ bwf checks an uploaded version before sending it traffic. If the Worker has no public URL, because workers.dev is off and no route or Custom Domain is configured, bwf activates it without a readiness check.
175
+
176
+ If readiness or trigger updates fail, bwf restores the previous deployment. If trigger updates fail and the previous triggers can't be restored, such as after another tool's deployment or from an empty draft, the new version stays live. The error names the version serving traffic.
177
+
178
+ Finish or cancel gradual rollouts in Cloudflare before deploying through bwf.
179
+
180
+ For an existing Durable Object Worker that Cloudflare cannot stage, review the changes and use:
181
+
182
+ ```sh
183
+ bwf deploy --platform cloudflare --atomic
184
+ ```
185
+
186
+ To use this on every deploy, set `deploy: { cloudflare: { mode: 'atomic' } }`. Atomic deployment sends traffic to the new version before its readiness check. Durable Object class migrations cannot be rolled back across their migration boundary.
187
+
188
+ A new Worker may need an active first deployment before readiness can be checked. Keep `.bwf/cloudflare-candidate.json` if a staged upload fails so you can retry from the same checkout.
189
+
190
+ Inspect or restore versions with:
191
+
192
+ ```sh
193
+ bwf project status
194
+ bwf project rollback [version]
195
+ ```
196
+
197
+ bwf restores recorded triggers along with the code. Versions without a complete trigger snapshot keep current routes and schedules. Database recovery is separate: use [`bwf db restore`](../reference/cli/database.md#nosam-db-restore) to undo D1 migrations.
198
+
199
+ #### Scope and limitations
200
+
201
+ bwf deploys bwf apps (a React SPA with an optional backend), static SPAs, static sites, and supported SSGs.
202
+
203
+ - bwf apps support bwf routing rules for redirects, rewrites, fallbacks, and headers.
204
+ - `--skip-build` works for existing static output. Worker apps require a fresh build.
205
+ - Named Cloudflare environments aren't supported. Use a separate bwf project config for each target.
206
+ - Sandbox requires Workers Paid and Docker. See [Sandbox requirements](../guide/sandboxes.md#deployment) for plan and token permissions.
207
+ - Email to arbitrary recipients requires Workers Paid; verified recipients and inbound mail work on Workers Free. See [Email](../guide/email/domains.md#your-own-cloudflare-account).
208
+
209
+ Commit Durable Object migration history in `bwf.lock.json`. Do not delete or reorder deployed steps.
210
+
211
+ ### Managing the deployed app
212
+
213
+ `bwf secret`, `bwf domain`, `bwf project status|list|logs|rollback`, and remote `bwf db` commands use the selected account and Worker. Logs are a live tail.
214
+
215
+ Custom domain commands update routes immediately. If a first deployment times out while DNS or TLS is propagating, check the domain in Cloudflare and retry once `/__nosam/ready` is reachable.
216
+
217
+ `bwf project delete` does not remove Cloudflare resources. Review ownership and remove them in Cloudflare.
218
+
219
+ ### Local development
220
+
221
+ Local D1, KV, and R2 bindings use local data. Your production resource IDs are used during deployment.
222
+
223
+ Workers AI runs remotely after you connect to Cloudflare, so development calls consume your account's allowance. Remote bindings in development and preview use your `bwf cloudflare login` session, or `CLOUDFLARE_API_TOKEN` when it is set.
224
+
225
+ ### AI on your Cloudflare account {#ai-self-host}
226
+
227
+ `ai.run()`, `ai.stream()`, and `ai.image()` use your Workers AI binding. For provider models, configure your AI Gateway and store the provider key as a Worker secret:
228
+
229
+ ```ts
230
+ import { defineConfig } from '@builtbyfriends/bwf/config';
231
+
232
+ export default defineConfig({
233
+ ai: { gateway: 'my-gateway' },
234
+ });
235
+ ```
236
+
237
+ ```sh
238
+ bwf secret put OPENAI_API_KEY
239
+ ```
240
+
241
+ `ai.provider('openai').fetch(...)` then uses that gateway and key. See the [AI guide](../guide/ai.md) for examples. Use [AI Gateway analytics](https://developers.cloudflare.com/ai-gateway/) to inspect account usage.
@@ -0,0 +1,127 @@
1
+ ---
2
+ description: 'bwf route handlers run on Hono. Add hono to your app when your code imports from it directly.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Hono
7
+
8
+ bwf handlers run on [Hono](https://hono.dev). bwf depends on Hono internally, but if your app imports from `hono/*` directly, add `hono` to your app's dependencies first.
9
+
10
+ ```bash
11
+ npm install hono
12
+ ```
13
+
14
+ Once `hono` is installed in your app, you can use built-in middleware, helpers, and third-party Hono packages directly.
15
+
16
+ ## Built-in Middleware
17
+
18
+ Use Hono's built-in middleware in your global middleware files or per-route:
19
+
20
+ ```ts
21
+ import { defineMiddleware } from '@builtbyfriends/bwf';
22
+ // middleware/01.cors.ts
23
+ import { cors } from 'hono/cors';
24
+
25
+ export default defineMiddleware(cors({ origin: 'https://example.com' }));
26
+ ```
27
+
28
+ ```ts
29
+ import { defineHandler } from '@builtbyfriends/bwf';
30
+ // routes/api/products.ts (per-route cache)
31
+ import { cache } from 'hono/cache';
32
+ import { listProducts } from '../../lib/products';
33
+
34
+ export const GET = defineHandler(
35
+ cache({ cacheName: 'products', cacheControl: 'max-age=3600' }),
36
+ async () => ({ products: await listProducts() }),
37
+ );
38
+ ```
39
+
40
+ ::: warning
41
+ `cache()` stores one response per URL and returns it to every visitor. It skips requests with an `Authorization` header, but not cookies. Use it only on routes whose response is the same for everyone, never on a route that reads the signed-in user.
42
+ :::
43
+
44
+ ```ts
45
+ import { defineHandler } from '@builtbyfriends/bwf';
46
+ // routes/api/webhooks/stripe.ts (per-route usage)
47
+ import { bearerAuth } from 'hono/bearer-auth';
48
+
49
+ export const POST = defineHandler(bearerAuth({ token: 'webhook-secret' }), async (c) => {
50
+ const body = await c.req.json();
51
+ return { received: true };
52
+ });
53
+ ```
54
+
55
+ ## Response Helpers
56
+
57
+ Hono's context helpers are available on `c` in every handler:
58
+
59
+ ```ts
60
+ import { defineHandler } from '@builtbyfriends/bwf';
61
+ // routes/api/download.ts
62
+ import { stream } from 'hono/streaming';
63
+
64
+ export const GET = defineHandler((c) => {
65
+ return stream(c, async (stream) => {
66
+ await stream.write('chunk 1');
67
+ await stream.write('chunk 2');
68
+ });
69
+ });
70
+ ```
71
+
72
+ ```ts
73
+ // routes/api/data.ts
74
+ import { defineHandler } from '@builtbyfriends/bwf';
75
+
76
+ export const GET = defineHandler((c) => {
77
+ c.header('X-Custom', 'value');
78
+ c.status(201);
79
+ return c.json({ created: true });
80
+ });
81
+ ```
82
+
83
+ ## Third-party Middleware
84
+
85
+ Any `hono/*` or `@hono/*` package works. Install the package in your app, then use it directly:
86
+
87
+ ```ts
88
+ import { defineMiddleware } from '@builtbyfriends/bwf';
89
+ // middleware/01.rate-limit.ts
90
+ import { rateLimiter } from 'hono-rate-limiter';
91
+
92
+ export default defineMiddleware(rateLimiter({ windowMs: 60_000, limit: 100 }));
93
+ ```
94
+
95
+ ## Utilities
96
+
97
+ Hono's standalone helpers work anywhere:
98
+
99
+ ```ts
100
+ import { HTTPException } from 'hono/http-exception';
101
+
102
+ // Throw typed HTTP errors
103
+ throw new HTTPException(404, { message: 'User not found' });
104
+ ```
105
+
106
+ For the full list of built-in middleware, see the [Hono documentation](https://hono.dev/docs/middleware/builtin).
107
+
108
+ ### Redirects
109
+
110
+ Return `c.redirect()` from a handler to redirect. From a shared helper, throw an `HTTPException` with the redirect response in `res`. This works in handlers and middleware:
111
+
112
+ ```ts
113
+ import type { CloudContext } from '@builtbyfriends/bwf';
114
+ import { getUser } from '@builtbyfriends/bwf/auth';
115
+ // lib/require-page-user.ts
116
+ import { HTTPException } from 'hono/http-exception';
117
+
118
+ export function requirePageUser(c: CloudContext) {
119
+ const user = getUser();
120
+ if (!user) {
121
+ throw new HTTPException(302, { res: c.redirect('/login') });
122
+ }
123
+ return user;
124
+ }
125
+ ```
126
+
127
+ After a mutation, use `303` for both the exception and `c.redirect('/login', 303)` so the browser follows with a GET.