@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,195 @@
1
+ ---
2
+ description: 'Sessions, users, and auth clients from bwf/auth, plus the browser helpers in bwf/client.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Authentication {#auth}
7
+
8
+ Imported from `"@builtbyfriends/bwf/auth"`. Client-side helpers imported from `"@builtbyfriends/bwf/client"`.
9
+
10
+ ## `defineAuth(config)` {#defineauth-config}
11
+
12
+ Advanced escape hatch for customizing bwf's Better Auth config.
13
+
14
+ ```ts
15
+ import { defineAuth } from '@builtbyfriends/bwf/auth';
16
+
17
+ export default defineAuth(({ defaults }) => ({
18
+ ...defaults,
19
+ trustedOrigins: ['https://example.com'],
20
+ }));
21
+ ```
22
+
23
+ **Signature:**
24
+
25
+ ```ts
26
+ function defineAuth(config: BwfAuthConfig): BwfAuthConfig;
27
+ ```
28
+
29
+ ## `getUser()` {#getuser}
30
+
31
+ Returns the current authenticated user, or `null` when no user is present.
32
+
33
+ ```ts
34
+ import { getUser } from '@builtbyfriends/bwf/auth';
35
+
36
+ const user = getUser();
37
+ ```
38
+
39
+ **Signature:**
40
+
41
+ ```ts
42
+ function getUser(): AuthUser | null;
43
+ ```
44
+
45
+ ## `getSession()` {#getsession}
46
+
47
+ Returns the current Better Auth request state, or `null`.
48
+
49
+ ```ts
50
+ import { getSession } from '@builtbyfriends/bwf/auth';
51
+
52
+ const state = getSession();
53
+ ```
54
+
55
+ **Signature:**
56
+
57
+ ```ts
58
+ function getSession(): AuthState | null;
59
+ ```
60
+
61
+ ## `getAuth(c)` {#getauth-c}
62
+
63
+ Returns the Better Auth instance for the current request, including plugin APIs inferred from `auth.ts`. Use it with Better Auth plugin helpers or to forward requests to `auth.handler`.
64
+
65
+ ```ts
66
+ import { defineHandler } from '@builtbyfriends/bwf';
67
+ import { getAuth } from '@builtbyfriends/bwf/auth';
68
+
69
+ export const GET = defineHandler((c) => getAuth(c).handler(c.req.raw));
70
+ ```
71
+
72
+ Enable [authentication](../../guide/auth.md) before calling this helper; it throws if no instance is available. Anonymous requests can use it too. Call `requireAuth(c)` separately to require a signed-in user.
73
+
74
+ Cookies set by `getAuth(c).api` calls are sent with the response, so endpoints such as `signInEmail` and `signUpEmail` sign in the current browser. They are not sent on a `POST` from another origin unless it is in `trustedOrigins`. See [server usage](../../guide/auth.md#server-usage).
75
+
76
+ **Signature:**
77
+
78
+ ```ts
79
+ function getAuth(c: CloudContext): AuthInstance;
80
+ ```
81
+
82
+ ## `requireAuth(c, options?)` {#requireauth-c}
83
+
84
+ Returns the authenticated user from the request context. Without `throwRedirect`, throws a 401 `HTTPException` if no session is present.
85
+
86
+ Use it without options in route handlers or actions when you want a plain-text `401`, not an error page:
87
+
88
+ ```ts
89
+ import { defineHandler } from '@builtbyfriends/bwf';
90
+ import { requireAuth } from '@builtbyfriends/bwf/auth';
91
+
92
+ export const GET = defineHandler((c) => {
93
+ const user = requireAuth(c);
94
+ return { email: user.email };
95
+ });
96
+ ```
97
+
98
+ To send a signed-out browser to a login page, pass `throwRedirect` to [redirect unauthenticated visitors to login](../../guide/auth.md#protect-a-server-route):
99
+
100
+ ```ts
101
+ import { defineHandler } from '@builtbyfriends/bwf';
102
+ import { requireAuth } from '@builtbyfriends/bwf/auth';
103
+
104
+ export const GET = defineHandler((c) => {
105
+ const user = requireAuth(c, { throwRedirect: '/login' });
106
+ return { email: user.email };
107
+ });
108
+ ```
109
+
110
+ `throwRedirect` works in handlers and middleware. When signed out, it throws a redirect with status `302` for GET/HEAD requests or `303` for other methods, stopping execution. When signed in, it returns the user normally.
111
+
112
+ The destination is application-controlled.
113
+
114
+ **Signature:**
115
+
116
+ ```ts
117
+ function requireAuth(c: CloudContext, options?: { throwRedirect?: string }): AuthUser;
118
+ ```
119
+
120
+ ## `AuthUser` {#authuser}
121
+
122
+ Better Auth user shape re-exported by bwf. It also includes the fields that Better Auth plugins and `user.additionalFields` in `auth.ts` add, for example `role` from `admin()` or a custom `plan` field. Your tsconfig needs the generated bwf types for this; see [Type Safety setup](../../guide/type-safety.md#setup).
123
+
124
+ ```ts
125
+ interface AuthUser {
126
+ id: string;
127
+ email: string;
128
+ emailVerified: boolean;
129
+ name: string;
130
+ image?: string | null;
131
+ createdAt: Date;
132
+ updatedAt: Date;
133
+ }
134
+ ```
135
+
136
+ ## `AuthSession` {#authsession}
137
+
138
+ Better Auth session shape re-exported by bwf. It also includes the session fields that Better Auth plugins in `auth.ts` add, for example `impersonatedBy` from `admin()`.
139
+
140
+ ```ts
141
+ interface AuthSession {
142
+ id: string;
143
+ token: string;
144
+ userId: string;
145
+ expiresAt: Date;
146
+ createdAt: Date;
147
+ updatedAt: Date;
148
+ ipAddress?: string | null;
149
+ userAgent?: string | null;
150
+ }
151
+ ```
152
+
153
+ ::: tip Types inside `auth.ts`
154
+ In `auth.ts` and its imports, let Better Auth infer hook types or use its `User` and `Session` types. Using bwf's inferred auth types or auth helper results there creates a circular reference. Callbacks such as `sendResetPassword` receive Better Auth's base `User` type.
155
+ :::
156
+
157
+ ## `AuthState` {#authstate}
158
+
159
+ Combined authenticated request state:
160
+
161
+ ```ts
162
+ interface AuthState {
163
+ user: AuthUser;
164
+ session: AuthSession;
165
+ }
166
+ ```
167
+
168
+ ## `auth` {#auth-1}
169
+
170
+ Imported from `"@builtbyfriends/bwf/client"`. This is a ready-to-use Better Auth client instance preconfigured with `basePath: "/api/auth"`.
171
+
172
+ ```ts
173
+ import { auth } from '@builtbyfriends/bwf/client';
174
+
175
+ await auth.signIn.email({ email, password });
176
+ await auth.signOut();
177
+ ```
178
+
179
+ The exact client methods come from Better Auth. For React hooks such as `useSession()`, import the React client:
180
+
181
+ ```ts
182
+ import { auth } from '@builtbyfriends/bwf/client/react';
183
+ ```
184
+
185
+ That subpath keeps the same `fetch`, `fetchStream`, and auth exports as `@builtbyfriends/bwf/client`, but binds `auth` and `createAuthClient` to Better Auth's React package.
186
+
187
+ ## `createAuthClient` {#createauthclient}
188
+
189
+ Imported from `"@builtbyfriends/bwf/client"`. Re-export of Better Auth's `createAuthClient` for advanced usage.
190
+
191
+ ```ts
192
+ import { createAuthClient } from '@builtbyfriends/bwf/client';
193
+
194
+ const auth = createAuthClient({ basePath: '/api/auth' });
195
+ ```
@@ -0,0 +1,90 @@
1
+ ---
2
+ description: 'Call your routes from client code with a typed fetch. Paths and response types come from the generated route map.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Fetch Client {#fetch-client}
7
+
8
+ Imported from `"@builtbyfriends/bwf/client"`.
9
+
10
+ ## `fetch(path, options?)` {#fetch-path-options}
11
+
12
+ Type-safe fetch client for calling your API routes from client code, built on top of [ofetch](https://github.com/unjs/ofetch). Route paths and return types are inferred from the generated `RouteMap`.
13
+
14
+ ```ts
15
+ import { fetch } from '@builtbyfriends/bwf/client';
16
+
17
+ // Types are fully inferred from your route handlers
18
+ const users = await fetch('/api/users');
19
+ const user = await fetch('/api/users/[id]', {
20
+ params: { id: '1' },
21
+ });
22
+ ```
23
+
24
+ **Signature:**
25
+
26
+ ```ts
27
+ function fetch<P extends keyof RouteMap, M extends MethodsOf<P>>(
28
+ path: P,
29
+ options?: FetchOptions<P, M>,
30
+ ): Promise<OutputOf<P, M>>;
31
+ ```
32
+
33
+ **Options:**
34
+
35
+ | Option | Type | Description |
36
+ | --------- | ------------------------ | ---------------------------------------------------------- |
37
+ | `method` | `string` | HTTP method. Defaults to `"GET"`. |
38
+ | `body` | `unknown` | Request body (auto-serialized as JSON). |
39
+ | `query` | `Record<string, string>` | Query string parameters. |
40
+ | `params` | `Record<string, string>` | URL path parameters (`[id]` segments). |
41
+ | `headers` | `HeadersInit` | Additional request headers. |
42
+ | `signal` | `AbortSignal` | Abort signal. |
43
+ | `baseURL` | `string` | Base URL prepended to the path. Useful for external calls. |
44
+ | `retry` | `number` | Number of retry attempts (ofetch default: 1 for GET). |
45
+ | `timeout` | `number` | Request timeout in milliseconds. |
46
+
47
+ Omitting `method` sends GET. Non-GET calls require an explicit `method`, including calls that specify the method as a generic type argument.
48
+
49
+ Returns the parsed JSON response body, or `undefined` for 204 responses. Throws `FetchError` on non-2xx responses.
50
+
51
+ ## `FetchError` {#fetcherror}
52
+
53
+ Error class thrown by `fetch` on non-2xx responses.
54
+
55
+ ```ts
56
+ import { fetch, FetchError } from '@builtbyfriends/bwf/client';
57
+
58
+ try {
59
+ await fetch('/api/users/[id]', { params: { id: '999' } });
60
+ } catch (e) {
61
+ if (e instanceof FetchError) {
62
+ console.log(e.status); // 404
63
+ console.log(e.response); // raw Response
64
+ }
65
+ }
66
+ ```
67
+
68
+ **Properties:**
69
+
70
+ | Property | Type | Description |
71
+ | ---------- | ---------- | ------------------------------------ |
72
+ | `status` | `number` | HTTP status code. |
73
+ | `response` | `Response` | The raw `Response` object. |
74
+ | `data` | `unknown` | Parsed response body (if available). |
75
+
76
+ ## Differences from Native `fetch` {#differences-from-native-fetch}
77
+
78
+ The typed client is built on [ofetch](https://github.com/unjs/ofetch) with a typed route layer on top. Key differences from native `fetch`:
79
+
80
+ | Behavior | Native `fetch` | `@builtbyfriends/bwf/client` `fetch` |
81
+ | ---------------------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
82
+ | **Return type** | `Promise<Response>`, so you call `.json()` yourself | `Promise<T>`, which auto-parses JSON and returns the typed result directly (`undefined` for `204`) |
83
+ | **Error handling** | Resolves on any HTTP status; you check `response.ok` | Throws `FetchError` on non-2xx responses |
84
+ | **URL construction** | Raw URL string | Route path with `[param]` interpolation from `options.params` + query string from `options.query` |
85
+ | **Body serialization** | Manual `JSON.stringify()` + `Content-Type` header | Auto-serializes `options.body` as JSON and sets `Content-Type: application/json` |
86
+ | **Type safety** | Accepts any URL or method | Constrains paths to `RouteMap` keys and methods to those defined per route. Invalid combinations fail at compile time. |
87
+ | **Retry** | None | Auto-retries on 408, 429, and 5xx (configurable via `retry` option) |
88
+ | **Timeout** | None | Configurable via `timeout` option |
89
+
90
+ `headers` and `signal` are passed through to the underlying fetch unchanged.
@@ -0,0 +1,118 @@
1
+ ---
2
+ description: 'Query D1, PostgreSQL, or MySQL with the Drizzle client from bwf/db, and seed data from a script.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Database and Seeding {#database}
7
+
8
+ Imported from `"@builtbyfriends/bwf/db"`. The `db` export is a [Drizzle ORM](https://orm.drizzle.team) instance for the configured database dialect: [Cloudflare D1](https://developers.cloudflare.com/d1/) by default, PostgreSQL with `"database": "pg"`, or MySQL with `"database": "mysql"`.
9
+
10
+ ## `db` {#db}
11
+
12
+ Default Drizzle instance, pre-wired with your schema from `db/schema.ts`.
13
+
14
+ ```ts
15
+ import { db } from '@builtbyfriends/bwf/db';
16
+ import { users } from '@schema';
17
+
18
+ const allUsers = await db.select().from(users).all();
19
+ ```
20
+
21
+ `db` uses your configured dialect and schema.
22
+
23
+ - D1 projects resolve the `DB` binding and expose `DrizzleD1Database<Schema>`.
24
+ - PostgreSQL projects use `DATABASE_URL` during local development and Hyperdrive's `connectionString` in production, exposing `NodePgDatabase<Schema>`.
25
+ - MySQL projects use the same connection sources and expose `MySql2Database<Schema>`.
26
+
27
+ ## `createDb(database)` {#createdb-database}
28
+
29
+ Creates a Drizzle instance for the active dialect.
30
+
31
+ For D1 projects, pass a specific D1 binding. Use this when you have multiple D1 databases or need a non-default binding.
32
+
33
+ ```ts
34
+ import { createDb } from '@builtbyfriends/bwf/db';
35
+ import { env } from 'cloudflare:workers';
36
+
37
+ const db = createDb(env.MY_OTHER_DB);
38
+ ```
39
+
40
+ For a fresh D1 read, pass `{ session: 'first-primary' }` and create the client inside the request. The default, `'first-unconstrained'`, allows the first query to use a replica. Both keep your schema and query types. See [Read replication](../../guide/database/d1.md#read-replication).
41
+
42
+ For PostgreSQL and MySQL projects, pass a connection string.
43
+
44
+ ```ts
45
+ import { createDb } from '@builtbyfriends/bwf/db';
46
+
47
+ const db = createDb('postgres://user:password@host:5432/app');
48
+ ```
49
+
50
+ **Signature:**
51
+
52
+ ```ts
53
+ // D1
54
+ function createDb(
55
+ d1: D1Database,
56
+ options?: { session?: D1SessionConstraint },
57
+ ): DrizzleD1Database<Schema>;
58
+
59
+ // PostgreSQL
60
+ function createDb(connectionString: string): NodePgDatabase<Schema>;
61
+
62
+ // MySQL
63
+ function createDb(connectionString: string): MySql2Database<Schema>;
64
+ ```
65
+
66
+ ## Query Operators {#query-operators}
67
+
68
+ `@builtbyfriends/bwf/db` re-exports commonly used [Drizzle operators](https://orm.drizzle.team/docs/operators) so you never need to depend on `drizzle-orm` directly:
69
+
70
+ ```ts
71
+ import { db, eq, and, or, desc, like, inArray, sql } from '@builtbyfriends/bwf/db';
72
+ ```
73
+
74
+ **Full list:** `sql`, `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `and`, `or`, `not`, `desc`, `asc`, `like`, `ilike`, `notLike`, `inArray`, `notInArray`, `isNull`, `isNotNull`, `between`, `notBetween`, `exists`, `notExists`, `count`, `sum`, `avg`, `min`, `max`.
75
+
76
+ Use the exported Drizzle types `SQL`, `SQLWrapper`, `AnyColumn`, and `BatchItem` to type query helpers and batches:
77
+
78
+ ```ts
79
+ import { db, sql, type BatchItem, type SQL, type SQLWrapper } from '@builtbyfriends/bwf/db';
80
+ import { posts } from '@schema';
81
+
82
+ function contains(column: SQLWrapper, text: string): SQL {
83
+ return sql`instr(${column}, ${text}) > 0`;
84
+ }
85
+
86
+ // D1 only: `db.batch()` takes at least one query.
87
+ const writes: [BatchItem<'sqlite'>, ...Array<BatchItem<'sqlite'>>] = [
88
+ db.update(posts).set({ published: true }).where(contains(posts.title, 'nosam')),
89
+ ];
90
+ await db.batch(writes);
91
+ ```
92
+
93
+ ## Seeding {#seeding}
94
+
95
+ Imported from `"@builtbyfriends/bwf/seed"`.
96
+
97
+ ### `defineSeed(fn)` {#defineseed-fn}
98
+
99
+ Identity helper for programmatic seed modules used by `bwf db seed`.
100
+
101
+ ```ts
102
+ import { defineSeed } from '@builtbyfriends/bwf/seed';
103
+
104
+ export default defineSeed<typeof import('./schema')>(async ({ db, schema }) => {
105
+ await db.insert(schema.users).values([
106
+ { name: 'Alice', email: 'alice@example.com' },
107
+ { name: 'Bob', email: 'bob@example.com' },
108
+ ]);
109
+ });
110
+ ```
111
+
112
+ The callback receives:
113
+
114
+ - `dialect`: `"sqlite"`, `"postgresql"`, or `"mysql"`
115
+ - `db`: a local Drizzle instance for the active dialect
116
+ - `schema`: the exports from `db/schema.ts` or `db/schema/`
117
+
118
+ Seed modules can export either `default` or a named `seed` function.
@@ -0,0 +1,63 @@
1
+ ---
2
+ description: 'Prepare a built app, SPA, or static site for a managed platform deployment without platform credentials.'
3
+ ---
4
+
5
+ # Deployment artifacts
6
+
7
+ Use `@builtbyfriends/bwf/deploy` from Node.js to prepare a built bwf app, SPA, or static site for a managed platform deployment without platform credentials.
8
+
9
+ Build the app in managed mode inside its isolated environment:
10
+
11
+ ```sh
12
+ BWF_DEPLOY_BUILD=1 NOSAM_DEPLOY_PROJECT_ID=artifact npm run build
13
+ ```
14
+
15
+ These values select a platform-compatible build. The target project is selected during publish approval.
16
+
17
+ ```ts
18
+ import { prepareDeployArtifact } from '@builtbyfriends/bwf/deploy';
19
+
20
+ const { artifact, assets } = await prepareDeployArtifact('/path/to/app');
21
+ ```
22
+
23
+ `artifact` contains the deployment manifest, asset metadata, and any Worker modules. `assets` maps asset URL paths to base64 bytes. SPAs and static sites use the same output directory and routing configuration as `bwf deploy`. Keep the prepared result unchanged while requesting [publish approval](/guide/platform/administration/connected-apps).
24
+
25
+ Use this API for built Cloudflare Worker apps, SPAs, and static sites. For remote data, Sandbox, or Live resources, use `bwf deploy`.
26
+
27
+ Run preparation inside the same isolated environment as the app build. App configuration and build plugins execute project code; keep platform credentials on the publishing server.
28
+
29
+ ## Cloudflare Build Output
30
+
31
+ ::: warning Experimental
32
+ `prepareCfBuildOutput` follows Cloudflare's draft Build Output format. Its options and the prepared directory can change between bwf releases.
33
+ :::
34
+
35
+ Use `prepareCfBuildOutput` to prepare an existing Worker build for Cloudflare publication:
36
+
37
+ ```ts
38
+ import { prepareCfBuildOutput } from '@builtbyfriends/bwf/deploy';
39
+
40
+ const prepared = await prepareCfBuildOutput('/path/to/app/dist/server', {
41
+ projectRoot: '/path/to/app',
42
+ mode: 'staging',
43
+ });
44
+ if (!prepared) {
45
+ throw new Error('The Worker build could not be prepared.');
46
+ }
47
+
48
+ try {
49
+ // Inspect or pass prepared.directory to your Cloudflare publication workflow.
50
+ } finally {
51
+ await prepared.dispose();
52
+ }
53
+ ```
54
+
55
+ Pass a Worker output directory containing a generated `wrangler.json`, such as `dist/ssr` or `dist/server`. For native Cloudflare Build Output, pass the project root containing `.cloudflare/output/v0`. The result is a temporary copy for your publication workflow. For Containers built from a local Dockerfile, publish from the same Docker environment used to build the image.
56
+
57
+ | Option | Description |
58
+ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
59
+ | `accountId` | Cloudflare account the build must target. A different account in the build returns `null`. When omitted, the build's account is kept or left unset. |
60
+ | `mode` | Vite build mode. Native output keeps the mode it was built with, and a different value returns `null`. For other output it defaults to `production`. |
61
+ | `projectRoot` | App directory containing `package.json` and its installed dependencies. Defaults to the input directory. |
62
+
63
+ The result provides `directory`, an optional `assetsDirectory` pointing to the input assets, and an async `dispose()` method. Dispose the result after publication. Unsupported configurations return `null`; missing or invalid build files throw an error.
@@ -0,0 +1,47 @@
1
+ ---
2
+ description: 'Persistent objects and typed WebSocket connections from bwf/durable.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Durable State and WebSockets {#durable-state}
7
+
8
+ Imported from `"@builtbyfriends/bwf/durable"`. See [Durable State](../../guide/durable-state.md) for the complete file convention and deployment support.
9
+
10
+ ## `defineDurableState(definition)` {#definedurablestate-definition}
11
+
12
+ Defines a typed, persisted Durable Object state machine. The returned object must be the default export of a module under `durable-objects/`; named-export the same object for typed RPC calls elsewhere in the app.
13
+
14
+ ```ts
15
+ function defineDurableState<TState, TEnv, TMethods>(definition: {
16
+ name?: string;
17
+ initialState: TState | ((env: TEnv) => TState | Promise<TState>);
18
+ version?: number;
19
+ migrations?: Array<{
20
+ version: number;
21
+ migrate(state: unknown): TState | Promise<TState>;
22
+ }>;
23
+ methods: TMethods;
24
+ fetch?: (context, request: Request) => Response | Promise<Response>;
25
+ alarm?: (context) => void | Promise<void>;
26
+ storageKey?: string;
27
+ }): DurableStateApi<TMethods>;
28
+ ```
29
+
30
+ `DurableStateApi` exposes `class`, `get(name)`, `get(namespace, name)`, `getById(id)`, and `getById(namespace, id)`. Stubs returned by the lookup helpers contain the definition's methods with their argument types preserved and return values wrapped in `Promise`.
31
+
32
+ `name` optionally fixes the persistent resource identity instead of deriving it from the filename. Run `bwf info` and pin the displayed name before renaming a deployed definition. Keep instance names passed to `get()` unchanged. See the [migration flow](../../guide/durable-state.md#rename-a-file-while-keeping-its-state).
33
+
34
+ ## WebSockets {#websockets}
35
+
36
+ Imported from `"@builtbyfriends/bwf/ws"`. `defineRoom()` adds shared-room helpers to hook contexts; `defineWebSocket()` supplies a connection's socket helpers. Both require `messages.client` and `messages.server` Standard Schema validators and support the hooks described in the [WebSocket guide](../../guide/websockets.md).
37
+
38
+ Both helpers accept these optional resource settings:
39
+
40
+ ```ts
41
+ name?: string;
42
+ key?: (context: { params: Record<string, string> }) => string;
43
+ ```
44
+
45
+ `name` fixes the Worker class and binding identity. Without it, bwf derives the identity from the route file. Run `bwf info` before moving a deployed route and pin its displayed name.
46
+
47
+ `key` selects the route instance and its `ctx.id`. Without it, routes use parameter names and values in route order (`room=general`, or `default` without parameters). A callback must return a stable string synchronously. When renaming parameters, preserve the complete old key to retain state. See [moving routes](../../guide/websockets.md#move-a-route-while-keeping-its-state) and [renaming parameters](../../guide/websockets.md#rename-a-route-parameter).
@@ -0,0 +1,51 @@
1
+ ---
2
+ description: 'Read validated environment values and binding types from bwf/env.'
3
+ outline: deep
4
+ ---
5
+
6
+ # Environment Variables {#environment}
7
+
8
+ Imported from `"@builtbyfriends/bwf/env"`.
9
+
10
+ ## `defineEnv(schema)` {#defineenv-schema}
11
+
12
+ Register an env schema and return the typed [`env`](#env) proxy. bwf auto-discovers `env.ts`, imports it during dev/build/deploy, generates `.bwf/env.d.ts`, validates production secrets before deploy, and validates values at worker boot.
13
+
14
+ ```ts
15
+ import { defineEnv, string, number, oneOf, url } from '@builtbyfriends/bwf/env';
16
+
17
+ export default defineEnv({
18
+ STRIPE_KEY: string(),
19
+ PORT: number().default(3000),
20
+ NODE_ENV: oneOf(['development', 'production']),
21
+ VITE_PUBLIC_URL: url(),
22
+ });
23
+ ```
24
+
25
+ ## `env` {#env}
26
+
27
+ Typed runtime proxy for declared env keys. Unknown keys and bindings pass through as `unknown`.
28
+
29
+ ```ts
30
+ import { env } from '@builtbyfriends/bwf/env';
31
+
32
+ const port = env.PORT;
33
+ ```
34
+
35
+ ## Schema helpers {#schema-helpers}
36
+
37
+ `@builtbyfriends/bwf/env` includes Standard Schema-compatible helpers: `string()`, `number()`, `boolean()`, `url()`, `email()`, `oneOf([...])`, and `json<T>()`. Each helper supports `.optional()` and `.default(value)`.
38
+
39
+ Non-client keys are server values and use remote secret storage in production. `VITE_*` keys are public build-time client values. Invalid input is redacted uniformly; storage is not selected with schema modifiers.
40
+
41
+ ## Types {#types-1}
42
+
43
+ `@builtbyfriends/bwf/env` also provides global Cloudflare environment types:
44
+
45
+ ```ts
46
+ /// <reference types="@builtbyfriends/bwf/env" />
47
+ ```
48
+
49
+ Declares the `Cloudflare.Env` namespace with `DB`, `KV`, `STORAGE`, `AI`, `SANDBOX`, and `ASSETS` binding types.
50
+
51
+ For handler context variables such as `c.set()` and `c.get()`, augment [`CloudContextVariables`](./types.md#cloudcontextvariables). This is separate from `Cloudflare.Env`, which types worker bindings.