@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,189 @@
1
+ ---
2
+ description: 'Define HTTP handlers, middleware, validation, scheduled jobs, queues, and rendering.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Handlers and Middleware {#handlers}
7
+
8
+ Imported from `"nosam"` or `"@builtbyfriends/bwf/handler"`.
9
+
10
+ ## `defineHandler(handler)` {#definehandler-handler}
11
+
12
+ Wraps a route handler function. The handler receives a [`CloudContext`](./types.md#cloudcontext) and can return a plain value (auto-converted to a Response) or use the Hono `c.json()` / `c.text()` APIs directly.
13
+
14
+ ```ts
15
+ import { defineHandler } from '@builtbyfriends/bwf';
16
+
17
+ export const GET = defineHandler((c) => {
18
+ return { message: 'hello' };
19
+ });
20
+ ```
21
+
22
+ **Signature:**
23
+
24
+ ```ts
25
+ function defineHandler<R>(handler: (c: CloudContext) => R): TypedHandler<{}, R>;
26
+ ```
27
+
28
+ ## `defineHandler(middleware..., handler)` {#definehandler-middleware-handler}
29
+
30
+ Composes up to 5 per-route middleware with a final handler. Middleware runs in order before the handler.
31
+
32
+ ```ts
33
+ export const GET = defineHandler(authMiddleware, rateLimiter, (c) => {
34
+ return { ok: true };
35
+ });
36
+ ```
37
+
38
+ ## `defineHandler.withValidator(validators)` {#definehandler-withvalidator-validators}
39
+
40
+ Creates a handler with input validation using any [Standard Schema](https://github.com/standard-schema/standard-schema) compatible library (zod, valibot, arktype, etc.). Returns a curried function that accepts the handler.
41
+
42
+ Validated input is passed as the second argument to the handler.
43
+
44
+ ```ts
45
+ import { defineHandler } from '@builtbyfriends/bwf';
46
+ import * as v from 'valibot';
47
+
48
+ export const POST = defineHandler.withValidator({
49
+ body: v.object({
50
+ name: v.pipe(v.string(), v.minLength(1)),
51
+ email: v.pipe(v.string(), v.email()),
52
+ }),
53
+ })((c, { body }) => {
54
+ return { received: body.name };
55
+ });
56
+ ```
57
+
58
+ **Signature:**
59
+
60
+ ```ts
61
+ function withValidator<V extends ValidatorSlots>(
62
+ validators: V,
63
+ ): <R>(handler: (c: CloudContext, input: HandlerInput<V>) => R) => TypedHandler<V, R>;
64
+ ```
65
+
66
+ **Type: `ValidatorSlots`**
67
+
68
+ ```ts
69
+ interface ValidatorSlots {
70
+ body?: StandardSchemaV1;
71
+ query?: StandardSchemaV1;
72
+ params?: StandardSchemaV1;
73
+ }
74
+ ```
75
+
76
+ **Type: `HandlerInput<V>`**
77
+
78
+ The inferred output types of each validator slot. For a `ValidatorSlots` with `body` and `query`, the input object has `{ body: ..., query: ... }` with types inferred from the schema output.
79
+
80
+ ## `defineMiddleware(handler)` {#definemiddleware-handler}
81
+
82
+ Type-safe wrapper for Hono middleware.
83
+
84
+ ```ts
85
+ import { defineMiddleware } from '@builtbyfriends/bwf';
86
+
87
+ export default defineMiddleware(async (c, next) => {
88
+ console.log(`${c.req.method} ${c.req.path}`);
89
+ await next();
90
+ });
91
+ ```
92
+
93
+ **Signature:**
94
+
95
+ ```ts
96
+ function defineMiddleware(handler: MiddlewareHandler<CloudEnv>): MiddlewareHandler<CloudEnv>;
97
+ ```
98
+
99
+ ## `basicAuth(options)` {#basicauth-options}
100
+
101
+ Built-in Basic authentication middleware for temporary site gates and pre-launch protection. Use it from `middleware/` with credentials from `@builtbyfriends/bwf/env` to protect the whole app, or pass it to `defineHandler()` for a single route.
102
+
103
+ bwf’s reserved `/__nosam` endpoints use their own authentication and are excluded from Basic auth.
104
+
105
+ When credentials come from `@builtbyfriends/bwf/env`, wrap the reads in functions so they are resolved per request after bwf has bound the runtime env.
106
+
107
+ If `password` resolves to an empty value, requests fail with a server error instead of passing the gate.
108
+
109
+ For app-specific bypasses such as health checks or public webhooks, compose that logic in your own middleware before calling `basicAuth()`.
110
+
111
+ ```ts
112
+ // env.ts
113
+ import { defineEnv, string } from '@builtbyfriends/bwf/env';
114
+
115
+ export default defineEnv({
116
+ BASIC_AUTH_USERNAME: string(),
117
+ BASIC_AUTH_PASSWORD: string(),
118
+ });
119
+ ```
120
+
121
+ ```ts
122
+ // middleware/01.basic-auth.ts
123
+ import { basicAuth } from '@builtbyfriends/bwf';
124
+ import { env } from '@builtbyfriends/bwf/env';
125
+
126
+ export default basicAuth({
127
+ username: () => env.BASIC_AUTH_USERNAME,
128
+ password: () => env.BASIC_AUTH_PASSWORD,
129
+ realm: 'Preview',
130
+ });
131
+ ```
132
+
133
+ **Signature:**
134
+
135
+ ```ts
136
+ function basicAuth(options: {
137
+ username: string | (() => string);
138
+ password: string | (() => string);
139
+ realm?: string | (() => string);
140
+ message?: string | (() => string);
141
+ }): MiddlewareHandler<CloudEnv>;
142
+ ```
143
+
144
+ ## `defineScheduled(handler)` {#definescheduled-handler}
145
+
146
+ Wraps a Cloudflare [Scheduled handler](https://developers.cloudflare.com/workers/runtime-apis/handlers/scheduled/) with type inference.
147
+
148
+ ```ts
149
+ import { defineScheduled } from '@builtbyfriends/bwf';
150
+
151
+ export default defineScheduled(async (controller, env, ctx) => {
152
+ const { results } = await env.DB.prepare('SELECT * FROM stale').all();
153
+ // ...
154
+ });
155
+ ```
156
+
157
+ **Signature:**
158
+
159
+ ```ts
160
+ function defineScheduled(
161
+ handler: (
162
+ controller: ScheduledController,
163
+ env: CloudEnv['Bindings'],
164
+ ctx: ExecutionContext,
165
+ ) => unknown | Promise<unknown>,
166
+ ): ScheduledFn;
167
+ ```
168
+
169
+ ## `defineQueue<T>(handler)` {#definequeue-t-handler}
170
+
171
+ Wraps a [queue](../../guide/queues.md) consumer handler with typed message bodies. The generic `<T>` defines the message body type, which flows through to the typed `queues` proxy for `send()` calls.
172
+
173
+ ```ts
174
+ import { defineQueue } from '@builtbyfriends/bwf';
175
+
176
+ export default defineQueue<{ to: string; subject: string }>(async (batch, env) => {
177
+ for (const msg of batch.messages) {
178
+ console.log(`Send to ${msg.body.to}: ${msg.body.subject}`);
179
+ }
180
+ });
181
+ ```
182
+
183
+ **Signature:**
184
+
185
+ ```ts
186
+ function defineQueue<T>(
187
+ handler: (batch: QueueBatch<T>, env: CloudEnv['Bindings']) => void | Promise<void>,
188
+ ): TypedQueueHandler<T>;
189
+ ```
@@ -0,0 +1,40 @@
1
+ ---
2
+ description: 'Add bwf to Vite. The plugin sets up routing, migrations, and the Cloudflare Workers runtime.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Plugin and Configuration {#plugin}
7
+
8
+ ## `bwfPlugin(options?)` {#voidplugin-options}
9
+
10
+ Named export from `"nosam"`. Returns an array of Vite plugins that set up file-based routing, migration support, and the Cloudflare Workers runtime. Application-level configuration is read from [`bwf.config.ts`](../config.md); the optional `options` object controls Vite/Cloudflare plugin behavior.
11
+
12
+ ```ts
13
+ import { bwfPlugin } from '@builtbyfriends/bwf';
14
+
15
+ export default defineConfig({
16
+ plugins: [bwfPlugin()],
17
+ });
18
+ ```
19
+
20
+ | Option | Type | Description |
21
+ | ------------------ | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
22
+ | `persistTo` | `string` | Directory path for persisting local dev state (D1, KV, R2). Defaults to `.bwf/` in the project root. |
23
+ | `auxiliaryWorkers` | `AuxiliaryWorkerConfig[]` | Additional Workers to run alongside your app, such as a separate API Worker and dashboard that share bindings. Each entry accepts `configPath` (JSON, JSONC, or TOML), `config` (settings or a callback), `viteEnvironment`, and `devOnly`. |
24
+
25
+ ## Project configuration {#project-configuration}
26
+
27
+ ### `defineConfig(config)` {#defineconfig-config}
28
+
29
+ Import from `@builtbyfriends/bwf/config` in the root `bwf.config.ts`. It returns the config with editor completion and TypeScript checking. bwf validates the result when loading it, including values computed at runtime.
30
+
31
+ ```ts
32
+ import { defineConfig } from '@builtbyfriends/bwf/config';
33
+
34
+ export default defineConfig({
35
+ cloudflare: { name: 'my-app' },
36
+ routing: { typedRoutes: true },
37
+ });
38
+ ```
39
+
40
+ See the [config reference](../config.md) for all fields.
@@ -0,0 +1,116 @@
1
+ ---
2
+ description: 'Clients for KV, object storage, AI, and logs.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Resource Clients
7
+
8
+ ## KV {#kv}
9
+
10
+ Imported from `"@builtbyfriends/bwf/kv"`.
11
+
12
+ ### `kv` {#kv-1}
13
+
14
+ Typed JSON-aware client for the inferred `KV` binding.
15
+
16
+ ```ts
17
+ import { kv } from '@builtbyfriends/bwf/kv';
18
+
19
+ await kv.put('settings', { theme: 'dark' });
20
+ const settings = await kv.get<{ theme: string }>('settings');
21
+ ```
22
+
23
+ **Key exports:** `kv`, `createKV(namespace)`, `KVClient`, `KVMap`, `PutOptions`, `ListOptions`.
24
+
25
+ `kv.map(prefix)` creates a typed namespaced view where every key is stored under `prefix:`.
26
+
27
+ ## Storage {#storage}
28
+
29
+ Imported from `"@builtbyfriends/bwf/storage"`.
30
+
31
+ ### `storage` {#storage-1}
32
+
33
+ Default [R2 bucket](https://developers.cloudflare.com/r2/) proxy for the inferred `STORAGE` binding.
34
+
35
+ ```ts
36
+ import { storage } from '@builtbyfriends/bwf/storage';
37
+
38
+ await storage.put('avatars/alice.png', file);
39
+ const object = await storage.get('avatars/alice.png');
40
+ ```
41
+
42
+ **Key exports:** `storage`, `createStorage(bucket)`.
43
+
44
+ ## AI {#ai}
45
+
46
+ Imported from `"@builtbyfriends/bwf/ai"`.
47
+
48
+ ### `ai` {#ai-1}
49
+
50
+ Typed AI client for Cloudflare AI models and provider-native AI Gateway requests.
51
+
52
+ ```ts
53
+ import { ai } from '@builtbyfriends/bwf/ai';
54
+
55
+ const result = await ai.run('@cf/meta/llama-3.3-70b-instruct-fp8-fast', {
56
+ messages: [{ role: 'user', content: 'Summarize this release note.' }],
57
+ });
58
+
59
+ const response = await ai.provider('openai').fetch('/chat/completions', {
60
+ body: {
61
+ model: 'gpt-4o',
62
+ messages: [{ role: 'user', content: 'Summarize this release note.' }],
63
+ },
64
+ });
65
+ ```
66
+
67
+ **Key exports:** `ai`, `BwfAi`, provider request types. See [AI](../../guide/ai.md) for provider setup and streaming examples.
68
+
69
+ AI methods return promises and reject usage limits with `UsageLimit` from `@builtbyfriends/bwf/limits`. bwf routes and Pages actions return a structured HTTP 429 for uncaught limits. See [usage limits](../../guide/ai.md#usage-limits) for optional `instanceof UsageLimit` handling.
70
+
71
+ ### Provider keys
72
+
73
+ Default secret names for `ai.provider()`. Use `apiKeyEnv` to choose another name.
74
+
75
+ | Provider prefix | Env var |
76
+ | ------------------ | --------------------- |
77
+ | `openai` | `OPENAI_API_KEY` |
78
+ | `anthropic` | `ANTHROPIC_API_KEY` |
79
+ | `google-ai-studio` | `GOOGLE_API_KEY` |
80
+ | `deepseek` | `DEEPSEEK_API_KEY` |
81
+ | `groq` | `GROQ_API_KEY` |
82
+ | `mistral` | `MISTRAL_API_KEY` |
83
+ | `grok` | `GROK_API_KEY` |
84
+ | `openrouter` | `OPENROUTER_API_KEY` |
85
+ | `perplexity` | `PERPLEXITY_API_KEY` |
86
+ | `cohere` | `COHERE_API_KEY` |
87
+ | `cerebras` | `CEREBRAS_API_KEY` |
88
+ | `huggingface` | `HUGGINGFACE_API_KEY` |
89
+ | `replicate` | `REPLICATE_API_KEY` |
90
+ | `baseten` | `BASETEN_API_KEY` |
91
+ | `cartesia` | `CARTESIA_API_KEY` |
92
+ | `deepgram` | `DEEPGRAM_API_KEY` |
93
+ | `elevenlabs` | `ELEVENLABS_API_KEY` |
94
+ | `fal` | `FAL_API_KEY` |
95
+ | `ideogram` | `IDEOGRAM_API_KEY` |
96
+ | `parallel` | `PARALLEL_API_KEY` |
97
+
98
+ ## Logging {#logging}
99
+
100
+ Imported from `"@builtbyfriends/bwf/log"`.
101
+
102
+ ### `logger` {#logger}
103
+
104
+ Structured logger that emits one JSON line per call so deployed logs can be filtered by message and fields.
105
+
106
+ ```ts
107
+ import { logger } from '@builtbyfriends/bwf/log';
108
+
109
+ logger.info('checkout completed', { orderId, userId });
110
+ logger.error('webhook failed', { provider: 'stripe', attempt: 3 });
111
+
112
+ const log = logger.child({ component: 'queue', queue: 'tasks' });
113
+ log.info('task.started', { taskId });
114
+ ```
115
+
116
+ **Methods:** `logger.error(message, fields?)`, `logger.warn(message, fields?)`, `logger.info(message, fields?)`, `logger.child(fields)`.
@@ -0,0 +1,111 @@
1
+ ---
2
+ description: 'Serve another route without changing the browser URL, and read the URL that was originally requested.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Rewrites {#rewrites}
7
+
8
+ URL rewrites re-dispatch a request at a different internal path without changing the browser's URL. `c.rewrite()`, `c.originalUrl()`, and `c.isRewritten()` are available on every Hono `Context` the bwf runtime hands you. See the [Rewrites guide](../../guide/edge/rewrites.md) for the full overview, including static `routing.rewrites` / `routing.fallbacks` in [`bwf.config.ts`](../config.md#routing).
9
+
10
+ ## `c.rewrite(destination)` {#c-rewrite-destination}
11
+
12
+ Re-dispatches the current request at `destination` and returns the resulting `Response`. The browser URL does not change — this is a server-side hop. If `destination` has no query string, the original request query is preserved. If `destination` includes a query string, it replaces the original query. `destination` must start with `/`; known generated routes autocomplete via [`RewriteDestination`](#rewritedestination), while arbitrary strings remain accepted for dynamic paths.
13
+
14
+ Pass a [`RouteDestination`](./types.md#route-types) object to check the route pattern and its parameters:
15
+
16
+ ```ts
17
+ return c.rewrite({
18
+ pathname: '/users/[id]',
19
+ params: { id: 42 },
20
+ query: { tab: 'activity' },
21
+ });
22
+ ```
23
+
24
+ With [`routing.typedRoutes`](../config.md#routing-typedroutes), a string destination must be a [`RouteUrl`](./types.md#route-types): a URL that matches one of your routes. Cast a path built at runtime, such as ``c.rewrite(`/${locale}${path}` as RouteUrl)``.
25
+
26
+ With [`routing.typedRoutes`](../config.md#routing-typedroutes), `c.redirect()` checks strings like a link: route URLs, same-page queries and hashes, and `http://`, `https://`, `mailto:`, or `tel:` URLs. It also accepts a `URL` or typed destination object.
27
+
28
+ For a string TypeScript can't check, such as a payment provider's checkout URL, use `as Href`:
29
+
30
+ ```ts
31
+ import { routeUrl, type Href } from '@builtbyfriends/bwf/routes';
32
+
33
+ declare const checkoutUrl: string;
34
+
35
+ return c.redirect(routeUrl('/users/[id]', { params: { id: 42 } }));
36
+ return c.redirect({ pathname: '/users/[id]', params: { id: 42 } });
37
+ return c.redirect('https://example.com/login');
38
+ return c.redirect(checkoutUrl as Href);
39
+ ```
40
+
41
+ A cast skips the type check; bwf doesn't validate redirect destinations at runtime. For request values such as `?redirectTo=`, check the origin before redirecting:
42
+
43
+ ```ts
44
+ const requested = new URL(c.req.query('redirectTo') ?? '/', c.req.url);
45
+ return c.redirect(requested.origin === new URL(c.req.url).origin ? requested : '/');
46
+ ```
47
+
48
+ `c.redirect()` sends the location you provide without adding the request query. From `/sign-in?redirectTo=/notes`, `c.redirect('/notes')` goes to `/notes`. Configured [`routing.redirects`](../../guide/edge/redirects.md) merge query parameters instead.
49
+
50
+ ```ts
51
+ import { defineHandler } from '@builtbyfriends/bwf';
52
+
53
+ export const GET = defineHandler((c) => {
54
+ const locale = c.req.header('accept-language')?.startsWith('de') ? 'de' : 'en';
55
+ return c.rewrite(`/${locale}${new URL(c.req.url).pathname}`);
56
+ });
57
+ ```
58
+
59
+ **Signature:**
60
+
61
+ ```ts
62
+ interface CloudContext {
63
+ // RouteUrl instead of RewriteDestination with routing.typedRoutes
64
+ rewrite(destination: RewriteDestination | RouteDestination): Promise<Response>;
65
+ }
66
+ ```
67
+
68
+ **Caveats:**
69
+
70
+ - `destination` must start with a single `/` and point at an internal path. External URLs, protocol-relative destinations (`//host/...`), and anything non-path-absolute throw immediately — use `fetch()` for cross-origin calls.
71
+ - Destinations whose final path segment ends in a known static-asset extension (e.g. `/hero.png`, `/app.css`, `/data.json`) throw `BwfAssetRewriteError` (exported from `"nosam"`) before the re-dispatch. Runtime rewrites cannot reach assets — use a static `routing.rewrites` rule or a `_redirects` `200!` entry. `.html` is deliberately excluded from this guard because `.html` paths may be legitimate route handlers. See [Rewrites](../../guide/edge/rewrites.md#runtime-rewrites-cannot-reach-static-assets).
72
+ - Middleware re-runs on every rewrite hop. Guard side-effects with [`c.isRewritten()`](#c-originalurl-c-isrewritten).
73
+ - Client-side SPA navigation does not trigger server rewrites; only full HTTP requests do.
74
+
75
+ ## `c.originalUrl()` / `c.isRewritten()` {#c-originalurl-c-isrewritten}
76
+
77
+ Context methods for inspecting rewrite state. `c.originalUrl()` returns the pre-rewrite URL as a `URL` object, or `null` on the first, non-rewritten hop. `c.isRewritten()` returns `true` on any re-dispatched context and `false` on the original. Use them for both static and middleware rewrites.
78
+
79
+ ```ts
80
+ import { defineMiddleware } from '@builtbyfriends/bwf';
81
+
82
+ export default defineMiddleware(async (c, next) => {
83
+ if (!c.isRewritten()) {
84
+ // Only log the user-visible request, not internal rewrite hops.
85
+ console.log(`${c.req.method} ${c.req.path}`);
86
+ }
87
+ await next();
88
+ });
89
+ ```
90
+
91
+ **Signature:**
92
+
93
+ ```ts
94
+ interface CloudContext {
95
+ originalUrl(): URL | null;
96
+ isRewritten(): boolean;
97
+ }
98
+ ```
99
+
100
+ ## `RewriteDestination` {#rewritedestination}
101
+
102
+ ```ts
103
+ import type { RewriteDestination } from '@builtbyfriends/bwf/routes';
104
+ ```
105
+
106
+ Suggests known route patterns in your editor while also accepting dynamic strings. Used as:
107
+
108
+ - The parameter type of [`c.rewrite()`](#c-rewrite-destination), unless `routing.typedRoutes` is on.
109
+ - The type of `destination` entries in `routing.rewrites` and `routing.fallbacks` in [`bwf.config.ts`](../config.md#routing).
110
+
111
+ Like [`RouteMap`](./types.md#routemap), `RewriteDestination` lives in the virtual `@builtbyfriends/bwf/routes` module and is refreshed whenever routes change.
@@ -0,0 +1,126 @@
1
+ ---
2
+ description: 'Shared types for handler context, routes, URLs, and head metadata.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Types {#types}
7
+
8
+ ## `CloudContext` {#cloudcontext}
9
+
10
+ Hono `Context` pre-typed with [`CloudEnv`](#cloudenv). This is the type of the `c` parameter in all route handlers and middleware.
11
+
12
+ ```ts
13
+ import type { CloudContext } from '@builtbyfriends/bwf';
14
+ ```
15
+
16
+ ## `CloudEnv` {#cloudenv}
17
+
18
+ Hono environment type for bwf workers. Extends Hono's `Env` with Cloudflare bindings and context variables.
19
+
20
+ ```ts
21
+ interface CloudEnv extends Env {
22
+ Bindings: {
23
+ DB: D1Database;
24
+ KV: KVNamespace;
25
+ STORAGE: R2Bucket;
26
+ AI: Ai;
27
+ SANDBOX: DurableObjectNamespace<import('@builtbyfriends/bwf/sandbox').BwfPlatformSandbox>;
28
+ ASSETS: { fetch(request: Request): Promise<Response> };
29
+ [key: string]: unknown;
30
+ };
31
+ Variables: CloudContextVariables;
32
+ }
33
+ ```
34
+
35
+ ## `CloudContextVariables` {#cloudcontextvariables}
36
+
37
+ The context variables type used by `c.set()` / `c.get()`. Augment this interface to add typed variables that flow through all middleware and handlers:
38
+
39
+ ```ts
40
+ interface CloudContextVariables {
41
+ user: AuthUser | null;
42
+ session: AuthSession | null;
43
+ [key: string]: unknown;
44
+ }
45
+ ```
46
+
47
+ **Augmentation example:**
48
+
49
+ ```ts
50
+ declare module '@builtbyfriends/bwf' {
51
+ interface CloudContextVariables {
52
+ requestId: string;
53
+ }
54
+ }
55
+
56
+ // c.get("requestId") → string
57
+ ```
58
+
59
+ See [Type Safety](../../guide/type-safety.md#context-variables) for details.
60
+
61
+ ## `TypedHandler<V, R>` {#typedhandler-v-r}
62
+
63
+ The return type of `defineHandler`, with validator types (`V`) and the handler’s return type (`R`).
64
+
65
+ ```ts
66
+ interface TypedHandler<V extends ValidatorSlots = {}, R = unknown> {
67
+ (c: CloudContext): Promise<Response> | Response | unknown;
68
+ readonly __validators: V; // type-level only
69
+ readonly __output: R; // type-level only
70
+ }
71
+ ```
72
+
73
+ ## `RouteMap` {#routemap}
74
+
75
+ Generated route types used by the typed `fetch` client. Contains each route’s methods, inputs, and outputs.
76
+
77
+ Keys use route patterns such as `/api/users/[id]` and `/docs/[...slug]`.
78
+
79
+ ```ts
80
+ import type { RouteMap } from '@builtbyfriends/bwf/routes';
81
+ ```
82
+
83
+ ## `@builtbyfriends/bwf/routes` {#nosam-routes}
84
+
85
+ ### `routeUrl(path, options?)` {#routeurl-path-options}
86
+
87
+ Build a relative URL string from a known page, HTTP, or WebSocket route pattern:
88
+
89
+ ```ts
90
+ import { routeUrl } from '@builtbyfriends/bwf/routes';
91
+
92
+ routeUrl('/users/[id]', {
93
+ params: { id: 42 },
94
+ query: { tab: 'activity' },
95
+ hash: 'details',
96
+ });
97
+ // /users/42?tab=activity#details
98
+ ```
99
+
100
+ | Option | Type | Description |
101
+ | -------- | -------------- | ---------------------------------------------------------------------------------- |
102
+ | `params` | Route-specific | Required for dynamic routes. Each parameter accepts a `string` or `number`. |
103
+ | `query` | `RouteQuery` | Query parameters. Arrays become repeated keys; `null` and `undefined` are omitted. |
104
+ | `hash` | `string` | URL fragment, such as `'details'` or `'#details'`. |
105
+
106
+ Static routes accept optional `query` and `hash` options. Pass raw parameter values for URL encoding. Catch-all parameters preserve `/` separators between segments. Invalid or missing path parameters throw a `TypeError`.
107
+
108
+ Use the returned [`RouteUrl`](#route-types) with `fetch()`, `<a>`, and `c.redirect()`. See [Typed URLs and Navigation](../../guide/type-safety.md#typed-urls-and-navigation) for setup and examples.
109
+
110
+ ### Route types {#route-types}
111
+
112
+ Import these types from `@builtbyfriends/bwf/routes`:
113
+
114
+ | Type | Description |
115
+ | --------------------- | ------------------------------------------------------------------------------------------------- |
116
+ | `RoutePathMap` | Generated map of HTTP and WebSocket route patterns to their parameter names. |
117
+ | `RoutePath` | Union of the known route patterns in `RoutePathMap`. |
118
+ | `RouteOptions<P>` | Options for a route pattern `P`, including its required `params`, optional `query`, and `hash`. |
119
+ | `RouteDestination<P>` | `{ pathname: P }` with `RouteOptions<P>`. Defaults to all known routes when `P` is omitted. |
120
+ | `RouteUrl` | The URL of one of your routes, returned by `routeUrl()`. `string` unless `typedRoutes` is on. |
121
+ | `Href` | A `RouteUrl`, a same-page query or hash, or an external URL. `string` unless `typedRoutes` is on. |
122
+ | `RouteUrlInput` | `Href`, `URL`, or `RouteDestination`; accepted by `c.redirect()`. |
123
+ | `RouteQuery` | Query keys mapped to `RouteQueryValue` or readonly arrays of those values. |
124
+ | `RouteQueryValue` | `string`, `number`, `boolean`, `null`, or `undefined`. |
125
+
126
+ `typedRoutes` is [`routing.typedRoutes`](../config.md#routing-typedroutes). See [Checked URL strings](../../guide/type-safety.md#checked-url-strings).