@builtbyfriends/bwf 0.0.0-stage → 1.9.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (448) hide show
  1. package/AGENTS_TEMPLATE.md +4 -0
  2. package/LICENSE +22 -0
  3. package/README.md +48 -2
  4. package/dist/account-cmd-Ddt8lGeL.mjs +45 -0
  5. package/dist/agents-BLiMq9E1.mjs +113 -0
  6. package/dist/application-analysis-C9Ck2Yeg.mjs +1498 -0
  7. package/dist/application-routing-DbR-W5lG.mjs +25 -0
  8. package/dist/atomic-write-DA6eD1Kp.mjs +17 -0
  9. package/dist/auth-BKsUmWbT.d.mts +77 -0
  10. package/dist/auth-DkvoW5hB.mjs +33 -0
  11. package/dist/auth-aKyIWkdS.mjs +1 -0
  12. package/dist/auth-client-6-Ft9i9T.d.mts +5 -0
  13. package/dist/auth-client-DwCdwKbw.mjs +5 -0
  14. package/dist/auth-client-react-CJdeErvM.mjs +5 -0
  15. package/dist/auth-client-react-DvQLe5Zb.d.mts +5 -0
  16. package/dist/auth-link-CCl-hJol.mjs +26 -0
  17. package/dist/auth-migrations-DDeifS3v.mjs +206 -0
  18. package/dist/auth-router-BG74WFUf.mjs +66 -0
  19. package/dist/auth-xnkmpZUl.mjs +311 -0
  20. package/dist/base64-ikl9yBy3.mjs +15 -0
  21. package/dist/better-auth-shared-Br6TNaYJ.mjs +473 -0
  22. package/dist/better-auth-shared-CsBNvPOU.d.mts +56 -0
  23. package/dist/build-cmd-BnZezraT.mjs +153 -0
  24. package/dist/build-output-dir-Clj_unKN.mjs +402 -0
  25. package/dist/cancel-deploy-DKAj5U1Z.mjs +57 -0
  26. package/dist/cf-access-Bhz9wX6p.mjs +131 -0
  27. package/dist/cf-access-CUP5L08W.mjs +67 -0
  28. package/dist/cf-build-output-DA6uJomQ.mjs +1 -0
  29. package/dist/cf-build-output-DNQTwMNU.mjs +438 -0
  30. package/dist/cf-command-values-2kOtxMo1.mjs +26 -0
  31. package/dist/cf-config-migrate-COOCi4Ge.mjs +330 -0
  32. package/dist/cf-worker-settings-CIh4t_yG.mjs +41 -0
  33. package/dist/cli/cli.d.mts +1 -0
  34. package/dist/cli/cli.mjs +88 -0
  35. package/dist/cli/cloudflare-operation-process.d.mts +1 -0
  36. package/dist/cli/cloudflare-operation-process.mjs +1284 -0
  37. package/dist/cli/env-schema-probe.d.mts +43 -0
  38. package/dist/cli/env-schema-probe.mjs +165 -0
  39. package/dist/cli-main-BfYf6fnB.mjs +1846 -0
  40. package/dist/client-D3D5RM5h.mjs +940 -0
  41. package/dist/client-VF2Nzc7Z.mjs +1 -0
  42. package/dist/cloudflare-auth-DzkU9H6r.mjs +152 -0
  43. package/dist/cloudflare-cmd-Bm6UhzAQ.mjs +59 -0
  44. package/dist/cloudflare-config-i8yanry0.mjs +186 -0
  45. package/dist/cloudflare-connect-B4ItSbJi.mjs +55 -0
  46. package/dist/cloudflare-operations-BcK849ue.mjs +1 -0
  47. package/dist/cloudflare-operations-DGF7xH7O.mjs +627 -0
  48. package/dist/cloudflare-process-tThIjEB2.mjs +309 -0
  49. package/dist/cloudflare-user-output-CqONaAbP.mjs +19 -0
  50. package/dist/collect-8i0wU63d.mjs +1 -0
  51. package/dist/collect-C6Blu9yw.mjs +48 -0
  52. package/dist/config-CN_RFRkS.mjs +86 -0
  53. package/dist/config-D5G-Tx6o.mjs +1 -0
  54. package/dist/config-DOaFIK3w.mjs +88 -0
  55. package/dist/config-entry.d.mts +202 -0
  56. package/dist/config-entry.mjs +6 -0
  57. package/dist/config-tNx0HlFv.mjs +516 -0
  58. package/dist/connect-CSNWKLzB.mjs +84 -0
  59. package/dist/create-project-B35ux-LA.mjs +126 -0
  60. package/dist/create-project-tJ1KwNss.mjs +1 -0
  61. package/dist/database-provider-DkZo4VwN.mjs +5 -0
  62. package/dist/database-provider.d.mts +25 -0
  63. package/dist/database-provider.mjs +1 -0
  64. package/dist/db-SOv4E9wr.mjs +1735 -0
  65. package/dist/delete-BSKI7V23.mjs +65 -0
  66. package/dist/deploy-BCSQoKC0.mjs +2 -0
  67. package/dist/deploy-CWJ3JJs_.mjs +6512 -0
  68. package/dist/deploy.d.mts +31 -0
  69. package/dist/deploy.mjs +118 -0
  70. package/dist/dev-inbox-I0nqTCdf.mjs +216 -0
  71. package/dist/discover-DJPmQcL5.mjs +36 -0
  72. package/dist/discover-EVuydEoM.mjs +1 -0
  73. package/dist/dist-B6eN80gc.mjs +1612 -0
  74. package/dist/dist-Cp4b1_T9.mjs +1 -0
  75. package/dist/dist-DMYe8CZJ.mjs +48 -0
  76. package/dist/dist-STQXl8ck.mjs +1878 -0
  77. package/dist/domain-BJaAbxuQ.mjs +149 -0
  78. package/dist/dotenv-4NdUCXbB.mjs +156 -0
  79. package/dist/drizzle-DqVFXtlc.mjs +306 -0
  80. package/dist/drizzle-Ds5P0n-S.mjs +1 -0
  81. package/dist/edge.d.mts +2 -0
  82. package/dist/edge.mjs +1 -0
  83. package/dist/email-C_ATvNIG.mjs +2865 -0
  84. package/dist/email-cloudflare-oXk2G1G3.mjs +854 -0
  85. package/dist/email-protocol-CZ0bAkI8.mjs +81 -0
  86. package/dist/email-rIfZgVAB.mjs +742 -0
  87. package/dist/env-BGTu3KWZ.mjs +73 -0
  88. package/dist/env-DUyTzroe.mjs +88 -0
  89. package/dist/env-Dl4Wggec.mjs +71 -0
  90. package/dist/env-helpers-BX0APszT.mjs +135 -0
  91. package/dist/env-helpers-U56xuFgL.d.mts +20 -0
  92. package/dist/env-mask-BsHxq3R8.mjs +46 -0
  93. package/dist/env-public-Cw_xPi1D.d.mts +119 -0
  94. package/dist/env-raw-Bo6TtrHU.mjs +41 -0
  95. package/dist/env-types-Bg-dTh8u.mjs +56 -0
  96. package/dist/env-validation-BlXzGgLZ.mjs +1 -0
  97. package/dist/env-validation-DeqFUSKg.mjs +488 -0
  98. package/dist/fetch-CBgyyhzm.d.mts +87 -0
  99. package/dist/fetch-error-DmlRM6e4.mjs +264 -0
  100. package/dist/fetch-stream-2GUN3YN1.mjs +102 -0
  101. package/dist/fetch-stream-bUXynOyZ.d.mts +32 -0
  102. package/dist/fetch-tpPiSK10.mjs +25 -0
  103. package/dist/gen-dc13IRXh.mjs +509 -0
  104. package/dist/gen-kQqhFyOP.mjs +1 -0
  105. package/dist/generate-BgtlYpKg.mjs +1 -0
  106. package/dist/generate-Da9mWKzU.mjs +80 -0
  107. package/dist/generated-wrangler-config-CoDaaFsA.mjs +17 -0
  108. package/dist/git-metadata-Cukp5kV5.mjs +82 -0
  109. package/dist/github-cmd-DT5Onu6E.mjs +690 -0
  110. package/dist/handler-B_ocHStk.d.mts +279 -0
  111. package/dist/handler-CNq7aSs1.mjs +161 -0
  112. package/dist/help-BK35YcRa.mjs +1946 -0
  113. package/dist/help-DaRezBj7.mjs +1 -0
  114. package/dist/inbound-CqubE-9T.d.mts +311 -0
  115. package/dist/inbound-lHugZPuK.mjs +509 -0
  116. package/dist/index.d.mts +64 -0
  117. package/dist/index.mjs +4163 -0
  118. package/dist/info-CLQoCenb.mjs +109 -0
  119. package/dist/init-CXanf5ck.mjs +2486 -0
  120. package/dist/limits-CMmYT2l8.d.mts +16 -0
  121. package/dist/limits-D27Lp6FP.mjs +46 -0
  122. package/dist/link-DinwJnon.mjs +52 -0
  123. package/dist/list-B1WAE9Wt.mjs +130 -0
  124. package/dist/live-KkEeda1Z.d.mts +105 -0
  125. package/dist/live-saC8barp.mjs +410 -0
  126. package/dist/load-user-env-g0ahkZcj.mjs +34 -0
  127. package/dist/local-d1-bUoAtFUe.mjs +103 -0
  128. package/dist/log-JDnPc0cF.mjs +23 -0
  129. package/dist/login-BUzyiyHV.mjs +1 -0
  130. package/dist/login-Dbv_T3Ru.mjs +87 -0
  131. package/dist/logs-BjMJooJQ.mjs +129 -0
  132. package/dist/migrate-DjW9_-sS.mjs +1 -0
  133. package/dist/migrate-DtcfKqPW.mjs +125 -0
  134. package/dist/migration-handler-22qiuWPq.mjs +469 -0
  135. package/dist/migration-handler-Bb2BJh6g.d.mts +38 -0
  136. package/dist/mime-BMUN_QKG.mjs +1004 -0
  137. package/dist/mysql-migration-sql-CNuBSqdx.mjs +239 -0
  138. package/dist/neon-CJzQSycr.mjs +52 -0
  139. package/dist/node-tfv-3v0V.mjs +64 -0
  140. package/dist/operator-ai-logging-Ay7M4KWw.mjs +121 -0
  141. package/dist/operator-args-BiGmSlZx.mjs +722 -0
  142. package/dist/operator-auth-DdYZYEkO.mjs +47 -0
  143. package/dist/operator-client-DBujdELO.mjs +82 -0
  144. package/dist/operator-cmd-BsHKYJYt.mjs +1 -0
  145. package/dist/operator-cmd-DTIkOAnP.mjs +443 -0
  146. package/dist/output-Bb34lF0w.mjs +173 -0
  147. package/dist/output-CVolXKC1.mjs +1 -0
  148. package/dist/package-BX_giUBX.mjs +1444 -0
  149. package/dist/package-json-DvS6IFRv.mjs +43 -0
  150. package/dist/pg-DoyPxa_X.mjs +15 -0
  151. package/dist/picocolors-D1NxSLw-.mjs +71 -0
  152. package/dist/plan-BHNt1QhK.mjs +1 -0
  153. package/dist/plan-DX4_-OM5.mjs +58 -0
  154. package/dist/platform-args-C-DyuCNX.mjs +1 -0
  155. package/dist/platform-args-CyeQWaZ7.mjs +538 -0
  156. package/dist/platform-auth-config-BfXqKSyZ.mjs +371 -0
  157. package/dist/platform-auth-protection-5FR6qoP_.mjs +231 -0
  158. package/dist/platform-auth-recovery-B5ZlqA8K.mjs +309 -0
  159. package/dist/platform-cmd-CcFDxtrl.mjs +1 -0
  160. package/dist/platform-cmd-ChXeBrRH.mjs +193 -0
  161. package/dist/platform-discovery-Bxg9aZXU.mjs +40 -0
  162. package/dist/platform-domain-CwatS3cz.mjs +256 -0
  163. package/dist/platform-lifecycle-0cXTmMsh.mjs +8928 -0
  164. package/dist/platform-lifecycle-BcoBAMux.mjs +1 -0
  165. package/dist/platform-management-6Wbdbob5.mjs +1607 -0
  166. package/dist/platform-management-hhnczOzr.mjs +1 -0
  167. package/dist/platform-plans-config-CkbUKFpm.mjs +447 -0
  168. package/dist/platform-recovery-DgIwlqB-.mjs +96 -0
  169. package/dist/platform-registry-x1m9HBxf.mjs +450 -0
  170. package/dist/platform-runtime-logs-kkoiYFpF.mjs +72 -0
  171. package/dist/platform-setup-DX8y_6Kh.mjs +306 -0
  172. package/dist/prepare-B9mB47T5.mjs +84 -0
  173. package/dist/prepare-DNIq07so.mjs +13 -0
  174. package/dist/prepare-LHkyJqxi.mjs +1 -0
  175. package/dist/project-CC7eN00D.mjs +141 -0
  176. package/dist/project-DcSd4BeI.mjs +1 -0
  177. package/dist/project-cmd-BydRwr-x.mjs +109 -0
  178. package/dist/project-paths-iXHKRTTQ.mjs +159 -0
  179. package/dist/project-slug-BUy0lmyR.mjs +1 -0
  180. package/dist/project-slug-CO6ci9XG.mjs +7 -0
  181. package/dist/project-team-CvdLhDF2.mjs +129 -0
  182. package/dist/project-token-CwZdUEGu.mjs +70 -0
  183. package/dist/project-tsconfig-P9X952KG.mjs +98 -0
  184. package/dist/project-zero-trust-CKDoPdN1.mjs +64 -0
  185. package/dist/providers-Cd3c7wi0.mjs +64 -0
  186. package/dist/providers-Df69hb_X.d.mts +5 -0
  187. package/dist/provision-BA59NCPO.mjs +1 -0
  188. package/dist/provision-C90fULHJ.mjs +1814 -0
  189. package/dist/queues-Bc3FsBQT.d.mts +5 -0
  190. package/dist/r2-conditions-DSLmkiR5.mjs +60 -0
  191. package/dist/requests-DNhfyF3l.mjs +52 -0
  192. package/dist/resolve-project-BCsAMDRA.mjs +47 -0
  193. package/dist/resolve-project-DhU9_lIo.mjs +1 -0
  194. package/dist/resource-name-DlJ9QXzg.mjs +10 -0
  195. package/dist/response-HmNjB30w.mjs +29 -0
  196. package/dist/rollback-wi6WK5T6.mjs +150 -0
  197. package/dist/rolldown-runtime-uD8oG6U2.mjs +24 -0
  198. package/dist/route-types-CRWhr93D.mjs +592 -0
  199. package/dist/route-url-BIDZT78M.mjs +58 -0
  200. package/dist/route-url-Bla3Upsy.d.mts +42 -0
  201. package/dist/routes-stub.d.mts +24 -0
  202. package/dist/routes-stub.mjs +1 -0
  203. package/dist/routing-assets-CSheDWWM.mjs +54 -0
  204. package/dist/rpc-DcByS_q0.d.mts +39 -0
  205. package/dist/rpc-DtxIN9Tv.mjs +19 -0
  206. package/dist/runner-CPerdjIl.mjs +163 -0
  207. package/dist/runner-CUNtS5x7.mjs +1 -0
  208. package/dist/runner-mysql-BjSoQ-mW.mjs +1 -0
  209. package/dist/runner-mysql-BmTI2EiF.mjs +145 -0
  210. package/dist/runner-pg-2pjltt0t.mjs +1 -0
  211. package/dist/runner-pg-mYc75KfH.mjs +61 -0
  212. package/dist/runtime/ai.d.mts +50 -0
  213. package/dist/runtime/ai.mjs +455 -0
  214. package/dist/runtime/auth-client-react.d.mts +2 -0
  215. package/dist/runtime/auth-client-react.mjs +1 -0
  216. package/dist/runtime/auth-client.d.mts +2 -0
  217. package/dist/runtime/auth-client.mjs +1 -0
  218. package/dist/runtime/auth.d.mts +2 -0
  219. package/dist/runtime/auth.mjs +1 -0
  220. package/dist/runtime/better-auth-mysql.d.mts +5 -0
  221. package/dist/runtime/better-auth-mysql.mjs +21 -0
  222. package/dist/runtime/better-auth-pg.d.mts +5 -0
  223. package/dist/runtime/better-auth-pg.mjs +21 -0
  224. package/dist/runtime/better-auth.d.mts +6 -0
  225. package/dist/runtime/better-auth.mjs +22 -0
  226. package/dist/runtime/client-react.d.mts +5 -0
  227. package/dist/runtime/client-react.mjs +5 -0
  228. package/dist/runtime/client.d.mts +5 -0
  229. package/dist/runtime/client.mjs +5 -0
  230. package/dist/runtime/db-mysql.d.mts +2 -0
  231. package/dist/runtime/db-mysql.mjs +1 -0
  232. package/dist/runtime/db-pg.d.mts +2 -0
  233. package/dist/runtime/db-pg.mjs +1 -0
  234. package/dist/runtime/db.d.mts +17 -0
  235. package/dist/runtime/db.mjs +36 -0
  236. package/dist/runtime/drizzle-arktype.d.mts +1 -0
  237. package/dist/runtime/drizzle-arktype.mjs +2 -0
  238. package/dist/runtime/drizzle-valibot.d.mts +1 -0
  239. package/dist/runtime/drizzle-valibot.mjs +2 -0
  240. package/dist/runtime/drizzle-zod.d.mts +1 -0
  241. package/dist/runtime/drizzle-zod.mjs +2 -0
  242. package/dist/runtime/durable.d.mts +64 -0
  243. package/dist/runtime/durable.mjs +165 -0
  244. package/dist/runtime/email/testing.d.mts +108 -0
  245. package/dist/runtime/email/testing.mjs +268 -0
  246. package/dist/runtime/email-protocol.d.mts +25 -0
  247. package/dist/runtime/email-protocol.mjs +1 -0
  248. package/dist/runtime/email.d.mts +26 -0
  249. package/dist/runtime/email.mjs +524 -0
  250. package/dist/runtime/env-public-client.d.mts +19 -0
  251. package/dist/runtime/env-public-client.mjs +55 -0
  252. package/dist/runtime/env-public.d.mts +4 -0
  253. package/dist/runtime/env-public.mjs +277 -0
  254. package/dist/runtime/env.d.mts +12 -0
  255. package/dist/runtime/env.mjs +1 -0
  256. package/dist/runtime/fetch-server.d.mts +6 -0
  257. package/dist/runtime/fetch-server.mjs +29 -0
  258. package/dist/runtime/fetch-stream.d.mts +3 -0
  259. package/dist/runtime/fetch-stream.mjs +3 -0
  260. package/dist/runtime/fetch.d.mts +2 -0
  261. package/dist/runtime/fetch.mjs +3 -0
  262. package/dist/runtime/handler.d.mts +3 -0
  263. package/dist/runtime/handler.mjs +1 -0
  264. package/dist/runtime/kv.d.mts +45 -0
  265. package/dist/runtime/kv.mjs +103 -0
  266. package/dist/runtime/limits.d.mts +2 -0
  267. package/dist/runtime/limits.mjs +1 -0
  268. package/dist/runtime/live-client.d.mts +40 -0
  269. package/dist/runtime/live-client.mjs +282 -0
  270. package/dist/runtime/live-server.d.mts +11 -0
  271. package/dist/runtime/live-server.mjs +419 -0
  272. package/dist/runtime/live.d.mts +3 -0
  273. package/dist/runtime/live.mjs +1 -0
  274. package/dist/runtime/log.d.mts +24 -0
  275. package/dist/runtime/log.mjs +57 -0
  276. package/dist/runtime/migration-handler-mysql.d.mts +2 -0
  277. package/dist/runtime/migration-handler-mysql.mjs +111 -0
  278. package/dist/runtime/migration-handler-pg.d.mts +2 -0
  279. package/dist/runtime/migration-handler-pg.mjs +94 -0
  280. package/dist/runtime/migration-handler.d.mts +2 -0
  281. package/dist/runtime/migration-handler.mjs +1 -0
  282. package/dist/runtime/procedure.d.mts +27 -0
  283. package/dist/runtime/procedure.mjs +36 -0
  284. package/dist/runtime/procedures.d.mts +24 -0
  285. package/dist/runtime/procedures.mjs +56 -0
  286. package/dist/runtime/queues.d.mts +2 -0
  287. package/dist/runtime/queues.mjs +8 -0
  288. package/dist/runtime/remote/binding-handler.d.mts +11 -0
  289. package/dist/runtime/remote/binding-handler.mjs +227 -0
  290. package/dist/runtime/remote/index.d.mts +12 -0
  291. package/dist/runtime/remote/index.mjs +467 -0
  292. package/dist/runtime/response.d.mts +11 -0
  293. package/dist/runtime/response.mjs +1 -0
  294. package/dist/runtime/route-url.d.mts +2 -0
  295. package/dist/runtime/route-url.mjs +1 -0
  296. package/dist/runtime/routing.d.mts +53 -0
  297. package/dist/runtime/routing.mjs +425 -0
  298. package/dist/runtime/rpc-react.d.mts +16 -0
  299. package/dist/runtime/rpc-react.mjs +50 -0
  300. package/dist/runtime/rpc.d.mts +2 -0
  301. package/dist/runtime/rpc.mjs +1 -0
  302. package/dist/runtime/sandbox-container.d.mts +3 -0
  303. package/dist/runtime/sandbox-container.mjs +1 -0
  304. package/dist/runtime/sandbox.d.mts +5 -0
  305. package/dist/runtime/sandbox.mjs +196 -0
  306. package/dist/runtime/schema-d1.d.mts +1 -0
  307. package/dist/runtime/schema-d1.mjs +2 -0
  308. package/dist/runtime/schema-mysql.d.mts +1 -0
  309. package/dist/runtime/schema-mysql.mjs +2 -0
  310. package/dist/runtime/schema-pg.d.mts +1 -0
  311. package/dist/runtime/schema-pg.mjs +2 -0
  312. package/dist/runtime/seed.d.mts +34 -0
  313. package/dist/runtime/seed.mjs +5 -0
  314. package/dist/runtime/sse-client.d.mts +31 -0
  315. package/dist/runtime/sse-client.mjs +42 -0
  316. package/dist/runtime/sse.d.mts +32 -0
  317. package/dist/runtime/sse.mjs +1 -0
  318. package/dist/runtime/storage.d.mts +4 -0
  319. package/dist/runtime/storage.mjs +13 -0
  320. package/dist/runtime/validator.d.mts +2 -0
  321. package/dist/runtime/validator.mjs +1 -0
  322. package/dist/runtime/ws-server.d.mts +26 -0
  323. package/dist/runtime/ws-server.mjs +297 -0
  324. package/dist/runtime/ws.d.mts +2 -0
  325. package/dist/runtime/ws.mjs +108 -0
  326. package/dist/sandbox-CWDjoEG2.d.mts +50 -0
  327. package/dist/sandbox-container-BqamdFCx.d.mts +73 -0
  328. package/dist/sandbox-container-d1AHLpgn.mjs +291 -0
  329. package/dist/secret-D5XrWshs.mjs +146 -0
  330. package/dist/skills-Dr3AjuBF.mjs +63 -0
  331. package/dist/sqlite-validation-CLJXXN93.mjs +24 -0
  332. package/dist/sse-CxR30yMF.mjs +174 -0
  333. package/dist/standard-schema-CuDawHOC.d.mts +40 -0
  334. package/dist/static-asset-marker-mWMX2dLa.mjs +38 -0
  335. package/dist/subcommand-prompt-B9yUo--u.mjs +370 -0
  336. package/dist/terminal-log-text-DNsWJREL.mjs +31 -0
  337. package/dist/types-D7-4tBu7.d.mts +1 -0
  338. package/dist/untrusted-env-lL7RkYiC.mjs +50 -0
  339. package/dist/validate-B-zsjhiz.mjs +162 -0
  340. package/dist/validate-DbqGdPPY.mjs +1 -0
  341. package/dist/validator-8-NZs2Xr.mjs +168 -0
  342. package/dist/version-metadata-DPhqnpaa.mjs +23 -0
  343. package/dist/wrangler-C3uyPadQ.mjs +1 -0
  344. package/dist/wrangler-TqTvJFWS.mjs +1452 -0
  345. package/dist/ws-DZRiIpYw.d.mts +137 -0
  346. package/dist/yarn-pnp-DgWbE7z5.mjs +91 -0
  347. package/docs/guide/ai.md +273 -0
  348. package/docs/guide/app-types.md +101 -0
  349. package/docs/guide/auth.md +255 -0
  350. package/docs/guide/database/d1.md +86 -0
  351. package/docs/guide/database/mysql.md +72 -0
  352. package/docs/guide/database/postgresql.md +94 -0
  353. package/docs/guide/database.md +454 -0
  354. package/docs/guide/deployment.md +124 -0
  355. package/docs/guide/durable-state.md +192 -0
  356. package/docs/guide/edge/headers.md +47 -0
  357. package/docs/guide/edge/redirects.md +85 -0
  358. package/docs/guide/edge/rewrites.md +119 -0
  359. package/docs/guide/edge/static-assets.md +94 -0
  360. package/docs/guide/email/domains.md +119 -0
  361. package/docs/guide/email/receiving.md +142 -0
  362. package/docs/guide/email/sending.md +262 -0
  363. package/docs/guide/email.md +23 -0
  364. package/docs/guide/env-vars.md +115 -0
  365. package/docs/guide/index.md +37 -0
  366. package/docs/guide/jobs.md +80 -0
  367. package/docs/guide/kv.md +100 -0
  368. package/docs/guide/live.md +181 -0
  369. package/docs/guide/platform/administration/access.md +165 -0
  370. package/docs/guide/platform/administration/connected-apps.md +84 -0
  371. package/docs/guide/platform/administration/email.md +169 -0
  372. package/docs/guide/platform/administration/operations.md +100 -0
  373. package/docs/guide/platform/administration/plans.md +156 -0
  374. package/docs/guide/platform/administration/projects.md +74 -0
  375. package/docs/guide/platform/administration/zero-trust.md +205 -0
  376. package/docs/guide/platform/development/local.md +122 -0
  377. package/docs/guide/platform/development/runtime.md +115 -0
  378. package/docs/guide/platform/development/schema-ci.md +44 -0
  379. package/docs/guide/platform/installation/ci.md +62 -0
  380. package/docs/guide/platform/installation/credentials.md +140 -0
  381. package/docs/guide/platform/installation/domains.md +120 -0
  382. package/docs/guide/platform/installation/first-deployment.md +95 -0
  383. package/docs/guide/platform/installation/maintenance.md +250 -0
  384. package/docs/guide/platform/installation/prerequisites.md +176 -0
  385. package/docs/guide/platform/installation/setup.md +300 -0
  386. package/docs/guide/platform/installation/uninstall.md +110 -0
  387. package/docs/guide/platform-administration.md +19 -0
  388. package/docs/guide/platform-development.md +16 -0
  389. package/docs/guide/procedures.md +48 -0
  390. package/docs/guide/project-collaboration.md +99 -0
  391. package/docs/guide/queues.md +149 -0
  392. package/docs/guide/quickstart.md +129 -0
  393. package/docs/guide/remote-dev.md +67 -0
  394. package/docs/guide/sandboxes.md +134 -0
  395. package/docs/guide/self-hosted-platform.md +45 -0
  396. package/docs/guide/server-routing.md +283 -0
  397. package/docs/guide/sse.md +174 -0
  398. package/docs/guide/storage.md +82 -0
  399. package/docs/guide/testing.md +64 -0
  400. package/docs/guide/type-safety.md +270 -0
  401. package/docs/guide/typed-fetch.md +98 -0
  402. package/docs/guide/websockets.md +230 -0
  403. package/docs/index.md +102 -0
  404. package/docs/integrations/agents.md +38 -0
  405. package/docs/integrations/cloudflare.md +241 -0
  406. package/docs/integrations/hono.md +127 -0
  407. package/docs/reference/api/auth.md +195 -0
  408. package/docs/reference/api/client.md +90 -0
  409. package/docs/reference/api/database.md +118 -0
  410. package/docs/reference/api/deploy.md +63 -0
  411. package/docs/reference/api/durable.md +47 -0
  412. package/docs/reference/api/env.md +51 -0
  413. package/docs/reference/api/handlers.md +189 -0
  414. package/docs/reference/api/plugin.md +40 -0
  415. package/docs/reference/api/resources.md +116 -0
  416. package/docs/reference/api/rewrites.md +111 -0
  417. package/docs/reference/api/types.md +126 -0
  418. package/docs/reference/api.md +71 -0
  419. package/docs/reference/cli/auth.md +87 -0
  420. package/docs/reference/cli/database.md +159 -0
  421. package/docs/reference/cli/deploy.md +117 -0
  422. package/docs/reference/cli/domains.md +42 -0
  423. package/docs/reference/cli/email.md +145 -0
  424. package/docs/reference/cli/generate.md +113 -0
  425. package/docs/reference/cli/github.md +181 -0
  426. package/docs/reference/cli/platform-config.md +93 -0
  427. package/docs/reference/cli/platform-email.md +81 -0
  428. package/docs/reference/cli/platform-installation.md +166 -0
  429. package/docs/reference/cli/platform-operations.md +90 -0
  430. package/docs/reference/cli/platform-users.md +159 -0
  431. package/docs/reference/cli/platform-zero-trust.md +60 -0
  432. package/docs/reference/cli/platform.md +78 -0
  433. package/docs/reference/cli/project.md +208 -0
  434. package/docs/reference/cli/secrets.md +79 -0
  435. package/docs/reference/cli/setup.md +88 -0
  436. package/docs/reference/cli.md +115 -0
  437. package/docs/reference/config.md +478 -0
  438. package/docs/reference/resource-inference.md +72 -0
  439. package/docs/reference/structure.md +138 -0
  440. package/package.json +389 -3
  441. package/sandbox.Dockerfile +4 -0
  442. package/schema.json +353 -0
  443. package/skills/bwf/SKILL.md +100 -0
  444. package/skills/migrate-vite-cloudflare-to-bwf/SKILL.md +53 -0
  445. package/templates/assets/bwf.svg +5 -0
  446. package/templates/assets/icons.svg +49 -0
  447. package/templates/assets/react.svg +1 -0
  448. package/templates/assets/stack.svg +35 -0
@@ -0,0 +1,2 @@
1
+ export * from "drizzle-arktype";
2
+ export {};
@@ -0,0 +1 @@
1
+ export * from "drizzle-valibot";
@@ -0,0 +1,2 @@
1
+ export * from "drizzle-valibot";
2
+ export {};
@@ -0,0 +1 @@
1
+ export * from "drizzle-zod";
@@ -0,0 +1,2 @@
1
+ export * from "drizzle-zod";
2
+ export {};
@@ -0,0 +1,64 @@
1
+ import { DurableObject as DurableObject$1 } from "cloudflare:workers";
2
+ type NativeDurableClass = new (...args: Array<never>) => DurableObject$1<unknown>;
3
+ export type DurableObjectApi<TClass extends NativeDurableClass> = {
4
+ class: TClass;
5
+ /** @internal Called by the generated Worker entry. */
6
+ __bind(bindingName: string, resourceName?: string): void;
7
+ get(name: string): DurableObjectStub<InstanceType<TClass>>;
8
+ get(namespace: DurableObjectNamespace<InstanceType<TClass>>, name: string): DurableObjectStub<InstanceType<TClass>>;
9
+ getById(id: DurableObjectId): DurableObjectStub<InstanceType<TClass>>;
10
+ getById(namespace: DurableObjectNamespace<InstanceType<TClass>>, id: DurableObjectId): DurableObjectStub<InstanceType<TClass>>;
11
+ };
12
+ /** Register a native Durable Object class without altering its lifecycle or RPC methods. */
13
+ export declare function defineDurableObject<TClass extends NativeDurableClass>(definition: {
14
+ name?: string;
15
+ class: TClass;
16
+ }): DurableObjectApi<TClass>;
17
+ export type DurableStateContext<TState, TEnv extends Record<string, unknown>> = {
18
+ state: TState;
19
+ readonly env: TEnv;
20
+ readonly id: DurableObjectId;
21
+ readonly storage: DurableObjectStorage;
22
+ setAlarm(scheduledTime: number | Date): Promise<void>;
23
+ deleteAlarm(): Promise<void>;
24
+ };
25
+ export type DurableStateMethod<TState, TEnv extends Record<string, unknown>, TArgs extends Array<unknown> = Array<unknown>, TResult = unknown> = (context: DurableStateContext<TState, TEnv>, ...args: TArgs) => TResult | Promise<TResult>;
26
+ export type DurableStateMethods<TState, TEnv extends Record<string, unknown>> = Record<string, DurableStateMethod<TState, TEnv, Array<never>, unknown>>;
27
+ export type DurableStateMigration<TState> = {
28
+ /** State version produced by this migration. Versions must be contiguous and start at 1. */
29
+ version: number;
30
+ migrate(state: unknown): TState | Promise<TState>;
31
+ };
32
+ type MethodArguments<TMethod> = TMethod extends ((context: infer _TContext, ...args: infer TArgs) => infer _TResult) ? TArgs : never;
33
+ type MethodResult<TMethod> = TMethod extends ((...args: infer _TArgs) => infer TResult) ? Awaited<TResult> : never;
34
+ export type DurableStateRpc<TMethods> = { [TName in keyof TMethods]: (...args: MethodArguments<TMethods[TName]>) => Promise<MethodResult<TMethods[TName]>>; };
35
+ export type TypedDurableObjectStub<TMethods> = DurableObjectStub & DurableStateRpc<TMethods>;
36
+ export type DurableStateClass<TMethods> = {
37
+ new (state: DurableObjectState, env: Record<string, unknown>): DurableObject & DurableStateRpc<TMethods> & {
38
+ fetch(request: Request): Promise<Response>;
39
+ alarm(): Promise<void>;
40
+ };
41
+ };
42
+ export type DurableStateDefinition<TState, TEnv extends Record<string, unknown>, TMethods extends DurableStateMethods<TState, TEnv>> = {
43
+ /** Optional persistent resource name. Pin the name reported by `bwf info` before moving this definition. */
44
+ name?: string;
45
+ initialState: TState | ((env: TEnv) => TState | Promise<TState>);
46
+ /** Current persisted state version. Defaults to 0. */
47
+ version?: number;
48
+ migrations?: ReadonlyArray<DurableStateMigration<TState>>;
49
+ methods: TMethods;
50
+ fetch?: DurableStateMethod<TState, TEnv, [request: Request], Response>;
51
+ alarm?: DurableStateMethod<TState, TEnv, [], void>;
52
+ storageKey?: string;
53
+ };
54
+ export type DurableStateApi<TMethods> = {
55
+ class: DurableStateClass<TMethods>;
56
+ /** @internal Called by bwf's generated worker entry. */
57
+ __bind(bindingName: string, resourceName?: string): void;
58
+ get(name: string): TypedDurableObjectStub<TMethods>;
59
+ get(namespace: DurableObjectNamespace, name: string): TypedDurableObjectStub<TMethods>;
60
+ getById(id: DurableObjectId): TypedDurableObjectStub<TMethods>;
61
+ getById(namespace: DurableObjectNamespace, id: DurableObjectId): TypedDurableObjectStub<TMethods>;
62
+ };
63
+ export declare function defineDurableState<TState, TEnv extends Record<string, unknown> = Record<string, unknown>, const TMethods extends DurableStateMethods<TState, TEnv> = DurableStateMethods<TState, TEnv>>(definition: DurableStateDefinition<TState, TEnv, TMethods>): DurableStateApi<TMethods>;
64
+ export {};
@@ -0,0 +1,165 @@
1
+ import { t as isResourceName } from "../resource-name-DlJ9QXzg.mjs";
2
+ import { a as requireRuntimeBinding, o as withRuntimeEnv } from "../env-Dl4Wggec.mjs";
3
+ import { DurableObject } from "cloudflare:workers";
4
+ // src/runtime/durable.ts
5
+ const DEFAULT_STORAGE_KEY = "__nosam_durable_state";
6
+ /** Register a native Durable Object class without altering its lifecycle or RPC methods. */
7
+ function defineDurableObject(definition) {
8
+ if (definition.name !== void 0 && !isResourceName(definition.name)) throw new Error("durable: name must contain a word starting with a letter.");
9
+ let bindingName;
10
+ function boundNamespace() {
11
+ if (!bindingName) throw new Error("durable: this definition is not bound. Default-export it from a file in durable-objects/.");
12
+ return requireRuntimeBinding(bindingName);
13
+ }
14
+ return {
15
+ class: definition.class,
16
+ __bind(name, resourceName) {
17
+ if (definition.name !== resourceName) throw new Error("durable: name must be statically discoverable in defineDurableObject(). Run bwf info to inspect this definition.");
18
+ if (bindingName && bindingName !== name) throw new Error(`durable: definition is already bound to '${bindingName}' and cannot also bind to '${name}'.`);
19
+ bindingName = name;
20
+ },
21
+ get(namespaceOrName, maybeName) {
22
+ const namespace = typeof namespaceOrName === "string" ? boundNamespace() : namespaceOrName;
23
+ return namespace.get(namespace.idFromName(typeof namespaceOrName === "string" ? namespaceOrName : maybeName));
24
+ },
25
+ getById(namespaceOrId, maybeId) {
26
+ return (maybeId ? namespaceOrId : boundNamespace()).get(maybeId ?? namespaceOrId);
27
+ }
28
+ };
29
+ }
30
+ function assertMigrations(version, migrations) {
31
+ const byVersion = /* @__PURE__ */ new Map();
32
+ for (const migration of migrations) {
33
+ if (!Number.isInteger(migration.version) || migration.version < 1) throw new Error("durable: migration versions must be positive integers.");
34
+ if (migration.version > version) throw new Error(`durable: migration version ${migration.version} exceeds the current state version ${version}.`);
35
+ if (byVersion.has(migration.version)) throw new Error(`durable: duplicate migration version ${migration.version}.`);
36
+ byVersion.set(migration.version, migration);
37
+ }
38
+ for (let expected = 1; expected <= version; expected++) if (!byVersion.has(expected)) throw new Error(`durable: missing state migration for version ${expected}.`);
39
+ return byVersion;
40
+ }
41
+ function defineDurableState(definition) {
42
+ if (definition.name !== void 0 && !isResourceName(definition.name)) throw new Error("durable: name must contain a word starting with a letter.");
43
+ const version = definition.version ?? 0;
44
+ if (!Number.isInteger(version) || version < 0) throw new Error("durable: version must be a non-negative integer.");
45
+ const migrations = assertMigrations(version, definition.migrations ?? []);
46
+ const storageKey = definition.storageKey ?? DEFAULT_STORAGE_KEY;
47
+ let bindingName;
48
+ function boundNamespace() {
49
+ if (!bindingName) throw new Error("durable: this state definition is not bound. Default-export it from a file in durable-objects/.");
50
+ return requireRuntimeBinding(bindingName);
51
+ }
52
+ class BwfDurableState extends DurableObject {
53
+ #value;
54
+ #ready;
55
+ #queue = Promise.resolve();
56
+ #objectState;
57
+ #runtimeEnv;
58
+ constructor(objectState, env) {
59
+ super(objectState, env);
60
+ this.#objectState = objectState;
61
+ this.#runtimeEnv = env;
62
+ this.#ready = objectState.blockConcurrencyWhile(() => withRuntimeEnv(this.#runtimeEnv, () => this.#load()));
63
+ }
64
+ async #load() {
65
+ const stored = await this.#objectState.storage.get(storageKey);
66
+ if (!stored) {
67
+ const initial = typeof definition.initialState === "function" ? await definition.initialState(this.#runtimeEnv) : structuredClone(definition.initialState);
68
+ this.#value = initial;
69
+ await this.#persist();
70
+ return;
71
+ }
72
+ if (stored.__nosamDurableState !== true || !Number.isInteger(stored.version)) throw new Error(`durable: invalid state record at storage key '${storageKey}'.`);
73
+ if (stored.version > version) throw new Error(`durable: stored state version ${stored.version} is newer than supported version ${version}.`);
74
+ let value = stored.value;
75
+ for (let nextVersion = stored.version + 1; nextVersion <= version; nextVersion++) value = await migrations.get(nextVersion).migrate(value);
76
+ this.#value = value;
77
+ if (stored.version !== version) await this.#persist();
78
+ }
79
+ #persist() {
80
+ return this.#objectState.storage.put(storageKey, {
81
+ __nosamDurableState: true,
82
+ version,
83
+ value: this.#value
84
+ });
85
+ }
86
+ #context() {
87
+ const instance = this;
88
+ return {
89
+ get state() {
90
+ return instance.#value;
91
+ },
92
+ set state(value) {
93
+ instance.#value = value;
94
+ },
95
+ env: this.#runtimeEnv,
96
+ id: this.#objectState.id,
97
+ storage: this.#objectState.storage,
98
+ setAlarm: (scheduledTime) => this.#objectState.storage.setAlarm(scheduledTime),
99
+ deleteAlarm: () => this.#objectState.storage.deleteAlarm()
100
+ };
101
+ }
102
+ #run(operation) {
103
+ return withRuntimeEnv(this.#runtimeEnv, () => {
104
+ const result = this.#queue.then(async () => {
105
+ await this.#ready;
106
+ const previousValue = structuredClone(this.#value);
107
+ try {
108
+ const operationResult = await operation();
109
+ await this.#persist();
110
+ return operationResult;
111
+ } catch (error) {
112
+ this.#value = previousValue;
113
+ throw error;
114
+ }
115
+ });
116
+ this.#queue = result.then(() => void 0, () => void 0);
117
+ return result;
118
+ });
119
+ }
120
+ fetch(request) {
121
+ if (!definition.fetch) return Promise.resolve(new Response("Not Found", { status: 404 }));
122
+ return this.#run(async () => {
123
+ return definition.fetch(this.#context(), request);
124
+ });
125
+ }
126
+ alarm() {
127
+ if (!definition.alarm) return Promise.resolve();
128
+ return this.#run(async () => {
129
+ await definition.alarm(this.#context());
130
+ });
131
+ }
132
+ static {
133
+ for (const [name, method] of Object.entries(definition.methods)) {
134
+ if (name === "fetch" || name === "alarm" || name === "constructor") throw new Error(`durable: method name '${name}' is reserved.`);
135
+ Object.defineProperty(this.prototype, name, {
136
+ enumerable: false,
137
+ value(...args) {
138
+ return this.#run(async () => {
139
+ return method(this.#context(), ...args);
140
+ });
141
+ }
142
+ });
143
+ }
144
+ }
145
+ }
146
+ return {
147
+ class: BwfDurableState,
148
+ __bind(name, resourceName) {
149
+ if (definition.name !== resourceName) throw new Error("durable: name must be statically discoverable in defineDurableState(). Run bwf info to inspect this definition.");
150
+ if (bindingName && bindingName !== name) throw new Error(`durable: state definition is already bound to '${bindingName}' and cannot also bind to '${name}'.`);
151
+ bindingName = name;
152
+ },
153
+ get(namespaceOrName, maybeName) {
154
+ const namespace = typeof namespaceOrName === "string" ? boundNamespace() : namespaceOrName;
155
+ const name = typeof namespaceOrName === "string" ? namespaceOrName : maybeName;
156
+ return namespace.get(namespace.idFromName(name));
157
+ },
158
+ getById(namespaceOrId, maybeId) {
159
+ const namespace = maybeId ? namespaceOrId : boundNamespace();
160
+ const id = maybeId ?? namespaceOrId;
161
+ return namespace.get(id);
162
+ }
163
+ };
164
+ }
165
+ export { defineDurableObject, defineDurableState };
@@ -0,0 +1,108 @@
1
+ /// <reference types="@cloudflare/workers-types" />
2
+ import { r as EmailHandler } from "../../inbound-CqubE-9T.mjs";
3
+ interface CapturedMessage {
4
+ id: string;
5
+ capturedAt: number;
6
+ raw: Uint8Array;
7
+ messageId: string;
8
+ from: {
9
+ email: string;
10
+ name?: string;
11
+ };
12
+ to: Array<{
13
+ email: string;
14
+ name?: string;
15
+ }>;
16
+ cc: Array<{
17
+ email: string;
18
+ name?: string;
19
+ }>;
20
+ bcc: Array<{
21
+ email: string;
22
+ name?: string;
23
+ }>;
24
+ replyTo?: {
25
+ email: string;
26
+ name?: string;
27
+ };
28
+ subject: string;
29
+ text?: string;
30
+ html?: string;
31
+ headers: Record<string, string>;
32
+ attachments: Array<{
33
+ filename: string;
34
+ contentType: string;
35
+ size: number;
36
+ contentId?: string;
37
+ disposition: "attachment" | "inline";
38
+ }>;
39
+ }
40
+ export interface EmailTestHarness {
41
+ /** Messages captured since the harness was created (or since the last clear). */
42
+ readonly messages: ReadonlyArray<CapturedMessage>;
43
+ /** Discard captured messages. */
44
+ clear(): void;
45
+ /** Stop intercepting sends. After dispose, real binding sends resume. */
46
+ dispose(): void;
47
+ }
48
+ export declare function createEmailTestHarness(): EmailTestHarness;
49
+ export interface InboundDeliverOptions {
50
+ from: string;
51
+ to: string;
52
+ subject?: string;
53
+ text?: string;
54
+ html?: string;
55
+ headers?: Record<string, string>;
56
+ /** Override the constructed MIME body. Bytes preferred; strings encoded as UTF-8. */
57
+ raw?: string | Uint8Array;
58
+ }
59
+ export interface InboundReplyCapture {
60
+ from: string;
61
+ to: string;
62
+ raw: Uint8Array;
63
+ }
64
+ export interface InboundForwardCapture {
65
+ to: string;
66
+ headers?: Headers;
67
+ }
68
+ export interface InboundDeliveryResult {
69
+ /** Which handler key matched. `undefined` if the message was not handled. */
70
+ handler?: string;
71
+ params: Record<string, string>;
72
+ }
73
+ export interface InboundTestHarness {
74
+ readonly replies: ReadonlyArray<InboundReplyCapture>;
75
+ readonly forwards: ReadonlyArray<InboundForwardCapture>;
76
+ readonly rejects: ReadonlyArray<string>;
77
+ readonly deliveries: ReadonlyArray<InboundDeliveryResult>;
78
+ deliver(opts: InboundDeliverOptions): Promise<InboundDeliveryResult>;
79
+ clear(): void;
80
+ }
81
+ export interface InboundTestHarnessOptions {
82
+ /**
83
+ * Address pattern → handler. Pattern syntax matches the file-based
84
+ * convention: `support`, `support+[ticket]`, `[user]`, `[user]+[tag]`.
85
+ * Reserved key: `_default` (fallback handler, mirrors email/_default.ts).
86
+ */
87
+ routes: Record<string, EmailHandler>;
88
+ /** Forwarded as the second arg to handlers. Defaults to `{}`. */
89
+ env?: unknown;
90
+ /**
91
+ * Project slug used to strip the platform-injected `<slug>+` prefix from
92
+ * `message.to` before handlers see it (mirrors production: the dispatched
93
+ * `message.to` is `<tag>@<domain>`, never `<slug>+<tag>@<domain>`). When
94
+ * omitted, the harness infers the slug from each delivery's recipient
95
+ * (everything before the first `+` in the local-part) so existing tests
96
+ * with synthetic `slug+tag@domain` recipients keep working without
97
+ * configuration.
98
+ *
99
+ * `null` means NO platform prefix at all — a worker deployed on your own
100
+ * Cloudflare account (`bwf deploy --platform cloudflare`) receives the
101
+ * address the handler author wrote, and the dispatcher matches the full
102
+ * local part: `support@mail.acme.com` reaches `support`, and
103
+ * `support+T-42@mail.acme.com` reaches `support+[ticket]` with `T-42`.
104
+ */
105
+ slug?: string | null;
106
+ }
107
+ export declare function createInboundTestHarness(opts: InboundTestHarnessOptions): InboundTestHarness;
108
+ export type { CapturedMessage };
@@ -0,0 +1,268 @@
1
+ import { n as compileEmailPattern, t as compareEmailRoutes } from "../../email-C_ATvNIG.mjs";
2
+ import { y as registerEmailSink } from "../../dev-inbox-I0nqTCdf.mjs";
3
+ import { a as createMessageProxy, n as MAX_INBOUND_HEADERS, t as MAX_INBOUND_BYTES } from "../../inbound-lHugZPuK.mjs";
4
+ import { a as normalizeEmail, r as buildMime } from "../../mime-BMUN_QKG.mjs";
5
+ // src/runtime/email/testing.ts
6
+ /**
7
+ * Test harnesses for bwf/email.
8
+ *
9
+ * createEmailTestHarness — captures outbound `sendEmail` calls.
10
+ * createInboundTestHarness — delivers a synthesized message through your
11
+ * inbound route table and captures any
12
+ * replies / forwards / rejects.
13
+ *
14
+ * import { createEmailTestHarness } from "@builtbyfriends/bwf/email/testing";
15
+ * const harness = createEmailTestHarness();
16
+ * await sendEmail({ from: "a@x.dev", to: "b@y.dev", subject: "hi", text: "yo" });
17
+ * expect(harness.messages[0].subject).toBe("hi");
18
+ * harness.dispose();
19
+ *
20
+ * import { createInboundTestHarness } from "@builtbyfriends/bwf/email/testing";
21
+ * const inbound = createInboundTestHarness({
22
+ * routes: { "support+[ticket]": supportHandler, _default: catchAll },
23
+ * });
24
+ * const result = await inbound.deliver({
25
+ * from: "user@example.com",
26
+ * // The WIRE address: `<slug>+<tag>@<domain>`, as the platform delivers
27
+ * // it. The harness strips `<slug>+` before matching, so passing the
28
+ * // user-facing "support+abc-1@app.dev" would read `support` as the slug.
29
+ * to: "myslug+support+abc-1@app.dev",
30
+ * subject: "help",
31
+ * text: "thanks",
32
+ * });
33
+ * expect(result.handler).toBe("support+[ticket]");
34
+ * expect(result.params).toEqual({ ticket: "abc-1" });
35
+ */
36
+ function createEmailTestHarness() {
37
+ const messages = [];
38
+ const unregister = registerEmailSink((m) => {
39
+ messages.push(m);
40
+ });
41
+ return {
42
+ get messages() {
43
+ return messages;
44
+ },
45
+ clear() {
46
+ messages.length = 0;
47
+ },
48
+ dispose() {
49
+ unregister();
50
+ messages.length = 0;
51
+ }
52
+ };
53
+ }
54
+ function compileRoutes(routes) {
55
+ const compiled = [];
56
+ let defaultHandler;
57
+ for (const [key, handler] of Object.entries(routes)) {
58
+ if (key === "_default") {
59
+ defaultHandler = handler;
60
+ continue;
61
+ }
62
+ const pattern = compileEmailPattern(key);
63
+ if (!pattern) throw new Error(`createInboundTestHarness: route key ${JSON.stringify(key)} is not a valid email pattern. Use shapes like "support", "support+[ticket]", "[user]", "[user]+[tag]", or the reserved key "_default".`);
64
+ compiled.push({
65
+ address: key,
66
+ pattern,
67
+ handler
68
+ });
69
+ }
70
+ compiled.sort(compareEmailRoutes);
71
+ return {
72
+ compiled,
73
+ defaultHandler
74
+ };
75
+ }
76
+ async function buildSyntheticRaw(opts) {
77
+ if (opts.raw !== void 0) return typeof opts.raw === "string" ? new TextEncoder().encode(opts.raw) : opts.raw;
78
+ const text = opts.text ?? (opts.html ? void 0 : "(empty)");
79
+ const normalized = await normalizeEmail({
80
+ from: opts.from,
81
+ to: opts.to,
82
+ subject: opts.subject ?? "",
83
+ text,
84
+ html: opts.html,
85
+ headers: opts.headers
86
+ });
87
+ return buildMime(normalized).raw;
88
+ }
89
+ /** The router's `InboundTooManyHeadersError` (`email-router.ts`). */
90
+ var InboundTooManyHeadersError = class extends Error {};
91
+ /**
92
+ * Unfolded headers of a raw message, up to the first blank line. Unparsable
93
+ * lines are skipped so malformed fixtures still reach the handler. Like the
94
+ * router's `buildEnvelope`, refuses more than `maxDistinct` distinct
95
+ * case-insensitive names before materializing more.
96
+ */
97
+ function parseHeaderBlock(raw, maxDistinct) {
98
+ const headers = new Headers();
99
+ const text = new TextDecoder().decode(raw);
100
+ const end = text.indexOf("\r\n\r\n");
101
+ const block = end === -1 ? text : text.slice(0, end);
102
+ let distinct = 0;
103
+ let current = "";
104
+ const commit = () => {
105
+ const colon = current.indexOf(":");
106
+ if (colon > 0) {
107
+ const name = current.slice(0, colon).trim();
108
+ let known;
109
+ try {
110
+ known = headers.has(name);
111
+ } catch {
112
+ current = "";
113
+ return;
114
+ }
115
+ if (!known && distinct >= maxDistinct) throw new InboundTooManyHeadersError();
116
+ try {
117
+ headers.set(name, current.slice(colon + 1).trim());
118
+ if (!known) distinct++;
119
+ } catch {}
120
+ }
121
+ current = "";
122
+ };
123
+ for (let pos = 0; pos <= block.length;) {
124
+ const nl = block.indexOf("\r\n", pos);
125
+ const line = nl === -1 ? block.slice(pos) : block.slice(pos, nl);
126
+ pos = nl === -1 ? block.length + 1 : nl + 2;
127
+ if (line === "") break;
128
+ if (/^[ \t]/.test(line) && current !== "") {
129
+ current += ` ${line.trim()}`;
130
+ continue;
131
+ }
132
+ commit();
133
+ current = line;
134
+ }
135
+ commit();
136
+ return headers;
137
+ }
138
+ function createInboundTestHarness(opts) {
139
+ const { compiled, defaultHandler } = compileRoutes(opts.routes);
140
+ const env = opts.env ?? {};
141
+ const replies = [];
142
+ const forwards = [];
143
+ const rejects = [];
144
+ const deliveries = [];
145
+ async function deliver(input) {
146
+ const raw = await buildSyntheticRaw(input);
147
+ let headers;
148
+ if (opts.slug === null) headers = parseHeaderBlock(raw, Infinity);
149
+ else {
150
+ const at = input.to.indexOf("@");
151
+ const label = at === -1 ? "bwf email" : input.to.slice(at + 1).toLowerCase() || "bwf email";
152
+ if (raw.byteLength > MAX_INBOUND_BYTES) return refuse(`${label}: message too large (max ${MAX_INBOUND_BYTES} bytes)`);
153
+ try {
154
+ headers = parseHeaderBlock(raw, MAX_INBOUND_HEADERS);
155
+ } catch (e) {
156
+ if (e instanceof InboundTooManyHeadersError) return refuse(`${label}: too many headers (max ${MAX_INBOUND_HEADERS})`);
157
+ throw e;
158
+ }
159
+ }
160
+ for (const [k, v] of new Headers(input.headers ?? {})) headers.set(k, v);
161
+ if (!headers.has("Subject") && input.subject) headers.set("Subject", input.subject);
162
+ if (!headers.has("From")) headers.set("From", input.from);
163
+ if (!headers.has("To")) headers.set("To", input.to);
164
+ const slug = (() => {
165
+ if (opts.slug === null) return;
166
+ if (opts.slug) return opts.slug;
167
+ const local = input.to.split("@")[0] ?? "";
168
+ const plus = local.indexOf("+");
169
+ return plus === -1 ? void 0 : local.slice(0, plus);
170
+ })();
171
+ const { message, getActions } = createMessageProxy({
172
+ from: input.from,
173
+ to: input.to,
174
+ headers: Object.fromEntries(headers),
175
+ raw,
176
+ rawSize: raw.byteLength
177
+ }, { slug });
178
+ const ctx = {
179
+ waitUntil() {},
180
+ passThroughOnException() {}
181
+ };
182
+ const fullLocal = input.to.split("@")[0] ?? "";
183
+ const plus = fullLocal.indexOf("+");
184
+ const local = opts.slug === null ? fullLocal : plus === -1 ? "" : fullLocal.slice(plus + 1);
185
+ async function dispatch() {
186
+ for (const route of compiled) {
187
+ const m = new RegExp(route.pattern.regexSource, "i").exec(local);
188
+ if (!m) continue;
189
+ const params = {};
190
+ for (let i = 0; i < route.pattern.paramNames.length; i++) params[route.pattern.paramNames[i]] = m[i + 1];
191
+ const info = { params };
192
+ await route.handler(message, env, ctx, info);
193
+ return {
194
+ handler: route.address,
195
+ params
196
+ };
197
+ }
198
+ if (defaultHandler) {
199
+ await defaultHandler(message, env, ctx, { params: {} });
200
+ return {
201
+ handler: "_default",
202
+ params: {}
203
+ };
204
+ }
205
+ message.setReject(`no handler matched recipient "${input.to}" — add email/_default.ts to handle unmatched mail`);
206
+ return {
207
+ handler: void 0,
208
+ params: {}
209
+ };
210
+ }
211
+ const result = await dispatch();
212
+ record(getActions());
213
+ deliveries.push(result);
214
+ return result;
215
+ }
216
+ function refuse(reason) {
217
+ record([{
218
+ type: "reject",
219
+ reason
220
+ }]);
221
+ const result = {
222
+ handler: void 0,
223
+ params: {}
224
+ };
225
+ deliveries.push(result);
226
+ return result;
227
+ }
228
+ function record(actions) {
229
+ for (const action of actions) switch (action.type) {
230
+ case "reject":
231
+ rejects.push(action.reason);
232
+ break;
233
+ case "forward":
234
+ forwards.push({
235
+ to: action.to,
236
+ ...action.headers ? { headers: new Headers(action.headers) } : {}
237
+ });
238
+ break;
239
+ case "reply": replies.push({
240
+ from: action.from,
241
+ to: action.to,
242
+ raw: action.raw
243
+ });
244
+ }
245
+ }
246
+ return {
247
+ get replies() {
248
+ return replies;
249
+ },
250
+ get forwards() {
251
+ return forwards;
252
+ },
253
+ get rejects() {
254
+ return rejects;
255
+ },
256
+ get deliveries() {
257
+ return deliveries;
258
+ },
259
+ deliver,
260
+ clear() {
261
+ replies.length = 0;
262
+ forwards.length = 0;
263
+ rejects.length = 0;
264
+ deliveries.length = 0;
265
+ }
266
+ };
267
+ }
268
+ export { createEmailTestHarness, createInboundTestHarness };
@@ -0,0 +1,25 @@
1
+ import { EMAIL_PROTOCOL_VERSION, encodeEmailActions, readEmailEnvelope } from "@builtbyfriends/platform/email-protocol";
2
+ type ReceiptVerificationInput = {
3
+ receipt: string;
4
+ projectId: string;
5
+ deploymentId: string;
6
+ recipient: string;
7
+ };
8
+ type ReceiptVerifier = {
9
+ fetch(input: string | Request, init?: RequestInit): Promise<Response>;
10
+ };
11
+ /**
12
+ * Settle `run()` within `ms`, or reject with `onTimeout()`. `run` is not
13
+ * called when `ms` has already elapsed.
14
+ */
15
+ export declare function withTimeout<T>(ms: number, run: () => Promise<T>, onTimeout: () => Error): Promise<T>;
16
+ /**
17
+ * Read a JSON body of at most `maxBytes`, each read bounded by `race`. A
18
+ * declared length must be exact.
19
+ */
20
+ export declare function readBoundedJson(response: Response, maxBytes: number, race: <T>(run: () => Promise<T>) => Promise<T>, { rejectEncoding }?: {
21
+ rejectEncoding?: boolean;
22
+ }): Promise<unknown>;
23
+ /** Validate a gateway receipt without exposing the signing secret to the tenant worker. */
24
+ export declare function verifyEmailReceiptThroughProxy(proxy: ReceiptVerifier, projectToken: string, input: ReceiptVerificationInput): Promise<boolean>;
25
+ export { EMAIL_PROTOCOL_VERSION, encodeEmailActions, readEmailEnvelope };
@@ -0,0 +1 @@
1
+ export { t as EMAIL_PROTOCOL_VERSION, n as encodeEmailActions, r as readBoundedJson, i as readEmailEnvelope, a as verifyEmailReceiptThroughProxy, o as withTimeout } from "../email-protocol-CZ0bAkI8.mjs";
@@ -0,0 +1,26 @@
1
+ /// <reference types="@cloudflare/workers-types" />
2
+ import { C as SendEmailOptions, S as SendEmailErrorCode, T as SendEmailResult, _ as Attachment, a as MessageProxy, b as SendEmailDelivery, c as ParsedEmail, d as defineEmail, f as enactEmailActions, g as Address, h as replyEmail, i as EmailHandlerInfo, l as ReplyEmailOptions, m as parseEmail, n as EmailEnvelope, o as ParseEmailError, p as isForwardableEmailMessage, r as EmailHandler, s as ParseEmailErrorCode, t as EmailAction, u as createMessageProxy, v as EmailDeliveryState, w as SendEmailRecipientResult, x as SendEmailError, y as NormalizedEmail } from "../inbound-CqubE-9T.mjs";
3
+ type MimeErrorCode = "INVALID_FROM" | "INVALID_TO" | "MIME_ERROR";
4
+ export declare class MimeError extends Error {
5
+ code: MimeErrorCode;
6
+ constructor(code: MimeErrorCode, message: string);
7
+ }
8
+ /**
9
+ * Send an email via the worker's own `SEND_EMAIL` binding or the bwf
10
+ * platform proxy.
11
+ *
12
+ * During `bwf dev` the message is captured by the local inbox
13
+ * (`/__nosam/inbox`) and never reaches the proxy; an in-process sink
14
+ * (`@builtbyfriends/bwf/email/testing`) takes precedence over it.
15
+ */
16
+ export declare function sendEmail(opts: SendEmailOptions): Promise<SendEmailResult>;
17
+ /**
18
+ * Build a normalized email + raw MIME for advanced callers who want to feed
19
+ * the message into a custom transport. Throws on invalid input.
20
+ */
21
+ export declare function createEmail(opts: SendEmailOptions): Promise<{
22
+ email: NormalizedEmail;
23
+ raw: Uint8Array;
24
+ messageId: string;
25
+ }>;
26
+ export { type Address, type Attachment, type EmailAction, type EmailDeliveryState, type EmailEnvelope, type EmailHandler, type EmailHandlerInfo, type MessageProxy, type MimeErrorCode, type NormalizedEmail, ParseEmailError, type ParseEmailErrorCode, type ParsedEmail, type ReplyEmailOptions, type SendEmailDelivery, type SendEmailError, type SendEmailErrorCode, type SendEmailOptions, type SendEmailRecipientResult, type SendEmailResult, createMessageProxy, defineEmail, enactEmailActions, isForwardableEmailMessage, parseEmail, replyEmail };