@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,524 @@
1
+ import { n as bytesToBase64 } from "../base64-ikl9yBy3.mjs";
2
+ import { o as withTimeout, r as readBoundedJson } from "../email-protocol-CZ0bAkI8.mjs";
3
+ import { a as DEV_INBOX_ENV_VAR, b as serializeCapturedMessage, c as DEV_INBOX_TOKEN_ENV_VAR, d as captureMessage, h as hasActiveSink, i as DEV_INBOX_CAPTURE_URL, p as dispatchToSinks } from "../dev-inbox-I0nqTCdf.mjs";
4
+ import { a as createMessageProxy, c as isForwardableEmailMessage, d as readProjectSlug, f as replyEmail, i as bytesToReadableStream, l as parseEmail, o as defineEmail, p as tryGetRawRuntimeEnv, r as ParseEmailError, s as enactEmailActions, u as readEnvString } from "../inbound-lHugZPuK.mjs";
5
+ import { a as normalizeEmail, i as newId, n as MimeError, r as buildMime } from "../mime-BMUN_QKG.mjs";
6
+ import { isRecord } from "@builtbyfriends/deploy-core";
7
+ // src/runtime/email.ts
8
+ function makeError(code, message, cause) {
9
+ return cause === void 0 ? {
10
+ code,
11
+ message
12
+ } : {
13
+ code,
14
+ message,
15
+ cause
16
+ };
17
+ }
18
+ const SEND_EMAIL_BINDING_NAME = "SEND_EMAIL";
19
+ const EMAIL_PROVIDER_DEADLINE_MS = 3e4;
20
+ const PLATFORM_SEND_DEADLINE_MS = 6e4;
21
+ var EmailBindingTimeoutError = class extends Error {
22
+ constructor() {
23
+ super("email binding outcome unknown after timeout");
24
+ this.name = "EmailBindingTimeoutError";
25
+ }
26
+ };
27
+ function resolveSendEmailBinding(env) {
28
+ const binding = env?.[SEND_EMAIL_BINDING_NAME];
29
+ if (typeof binding !== "object" || binding === null) return;
30
+ return typeof binding.send === "function" ? binding : void 0;
31
+ }
32
+ /**
33
+ * Map a `send_email` binding error to a framework code: Email Service `E_*`
34
+ * codes, then the older Email Routing message. Anything else is
35
+ * `OUTCOME_UNKNOWN`: once `send()` started, a rejection does not prove the
36
+ * provider declined the message.
37
+ */
38
+ function classifyBindingError(e) {
39
+ const message = e instanceof Error ? e.message : String(e);
40
+ switch (typeof e?.code === "string" ? e.code : "") {
41
+ case "E_RECIPIENT_NOT_ALLOWED": return makeError("UNVERIFIED_DESTINATION", message, e);
42
+ case "E_SENDER_NOT_VERIFIED":
43
+ case "E_SENDER_DOMAIN_NOT_AVAILABLE": return makeError("INVALID_FROM", message, e);
44
+ case "E_RATE_LIMIT_EXCEEDED":
45
+ case "E_DAILY_LIMIT_EXCEEDED": return makeError("QUOTA_EXCEEDED", message, e);
46
+ }
47
+ if (UNVERIFIED_DESTINATION_RE.test(message)) return makeError("UNVERIFIED_DESTINATION", message, e);
48
+ return makeError("OUTCOME_UNKNOWN", message, e);
49
+ }
50
+ const UNVERIFIED_DESTINATION_RE = /^[^\n]{0,200}destination address[^\n]{0,200}not (?:yet )?verified/i;
51
+ /**
52
+ * Send one `EmailMessage` per recipient through the worker's own binding,
53
+ * within one bounded batch, reporting `deliveries` as the proxy does. The
54
+ * stream is rebuilt per send: a `ReadableStream` is one-shot.
55
+ */
56
+ async function sendViaBinding(binding, from, recipients, raw, fallbackId) {
57
+ let EmailMessage;
58
+ try {
59
+ ({EmailMessage} = await import("cloudflare:email"));
60
+ } catch (e) {
61
+ return err("UPSTREAM_ERROR", `email: SEND_EMAIL is bound but cloudflare:email could not be loaded: ${e instanceof Error ? e.message : String(e)}`, e);
62
+ }
63
+ const deliveries = [];
64
+ const deadline = Date.now() + PLATFORM_SEND_DEADLINE_MS;
65
+ const remaining = () => Math.min(EMAIL_PROVIDER_DEADLINE_MS, deadline - Date.now());
66
+ for (let index = 0; index < recipients.length; index++) {
67
+ const recipient = recipients[index];
68
+ if (remaining() <= 0) {
69
+ for (const unstarted of recipients.slice(index)) deliveries.push({
70
+ recipient: unstarted,
71
+ ok: false,
72
+ state: "cancelled",
73
+ error: makeError("UPSTREAM_ERROR", "email: batch deadline elapsed before provider submission")
74
+ });
75
+ break;
76
+ }
77
+ try {
78
+ const result = await withTimeout(remaining(), () => binding.send(new EmailMessage(from, recipient, bytesToReadableStream(raw))), () => new EmailBindingTimeoutError());
79
+ const mid = typeof result?.messageId === "string" ? result.messageId : "";
80
+ deliveries.push({
81
+ recipient,
82
+ ok: true,
83
+ messageId: mid || fallbackId
84
+ });
85
+ } catch (e) {
86
+ const error = e instanceof EmailBindingTimeoutError ? makeError("OUTCOME_UNKNOWN", "email: binding submission timed out; inspect provider logs before retrying", e) : classifyBindingError(e);
87
+ deliveries.push({
88
+ recipient,
89
+ ok: false,
90
+ ...error.code === "OUTCOME_UNKNOWN" ? { state: "outcome_unknown" } : {},
91
+ error
92
+ });
93
+ }
94
+ }
95
+ if (deliveries.some((d) => !d.ok)) return {
96
+ ok: false,
97
+ deliveries
98
+ };
99
+ return {
100
+ ok: true,
101
+ ids: deliveries.map((d) => ({
102
+ recipient: d.recipient,
103
+ messageId: d.messageId
104
+ }))
105
+ };
106
+ }
107
+ /**
108
+ * Recipients deduplicated by lowercased address: Cloudflare does not
109
+ * collapse duplicate envelopes, and each one costs quota.
110
+ */
111
+ function uniqueRecipients(normalized) {
112
+ const seen = /* @__PURE__ */ new Set();
113
+ const recipients = [];
114
+ for (const r of [
115
+ ...normalized.to,
116
+ ...normalized.cc,
117
+ ...normalized.bcc
118
+ ]) {
119
+ const lower = r.email.toLowerCase();
120
+ if (seen.has(lower)) continue;
121
+ seen.add(lower);
122
+ recipients.push(lower);
123
+ }
124
+ return recipients;
125
+ }
126
+ function resolveDefaultFrom(opts) {
127
+ const supplied = opts.from;
128
+ if (!(supplied === void 0 || supplied === null || typeof supplied === "string" && supplied.trim() === "" || typeof supplied === "object" && supplied !== null && !("email" in supplied))) return opts;
129
+ const configured = readEnvString("__NOSAM_EMAIL_FROM");
130
+ if (configured) return {
131
+ ...opts,
132
+ from: configured
133
+ };
134
+ const slug = readProjectSlug();
135
+ const domain = readEnvString("__NOSAM_EMAIL_DOMAIN");
136
+ if (!slug || !domain) {
137
+ if (supplied === null) {
138
+ const next = { ...opts };
139
+ delete next.from;
140
+ return next;
141
+ }
142
+ return opts;
143
+ }
144
+ return {
145
+ ...opts,
146
+ from: `${slug}+noreply@${domain}`
147
+ };
148
+ }
149
+ function err(code, message, cause) {
150
+ return {
151
+ ok: false,
152
+ error: makeError(code, message, cause)
153
+ };
154
+ }
155
+ function coerceErrorCode(code) {
156
+ return [
157
+ "BINDING_MISSING",
158
+ "INVALID_FROM",
159
+ "INVALID_TO",
160
+ "UNVERIFIED_DESTINATION",
161
+ "MIME_ERROR",
162
+ "QUOTA_EXCEEDED",
163
+ "IDEMPOTENCY_CONFLICT",
164
+ "OUTCOME_UNKNOWN",
165
+ "UPSTREAM_ERROR"
166
+ ].find((knownCode) => knownCode === code) ?? "UPSTREAM_ERROR";
167
+ }
168
+ /**
169
+ * Text of the `{ error, message? }` refusal the proxy's middleware sends
170
+ * ahead of the email handler, preferring the human `message`; `null` for any
171
+ * other shape.
172
+ */
173
+ function readProxyRefusal(body) {
174
+ if (typeof body !== "object" || body === null || Array.isArray(body)) return null;
175
+ const { error, message } = body;
176
+ if (typeof error !== "string" || error === "") return null;
177
+ return typeof message === "string" && message !== "" ? message : error;
178
+ }
179
+ function readProxyResponse(value) {
180
+ if (!isRecord(value)) return null;
181
+ const operationId = value.operationId;
182
+ if (value.ok === true && Array.isArray(value.ids)) return {
183
+ ok: true,
184
+ ids: value.ids,
185
+ operationId
186
+ };
187
+ if (value.ok !== false) return null;
188
+ if (Array.isArray(value.deliveries)) return {
189
+ ok: false,
190
+ deliveries: value.deliveries,
191
+ operationId
192
+ };
193
+ const error = value.error;
194
+ if (typeof error === "object" && error !== null) return {
195
+ ok: false,
196
+ error: {
197
+ code: "code" in error ? error.code : void 0,
198
+ message: "message" in error ? error.message : void 0
199
+ },
200
+ operationId
201
+ };
202
+ return null;
203
+ }
204
+ /**
205
+ * Require exactly one valid outcome per requested recipient, in any order. A
206
+ * missing, duplicate or foreign entry makes the whole result unknown, since
207
+ * trimming it could hide a submission. Diagnostics name entries by index.
208
+ */
209
+ function readRecipientList(raw, recipients, shape, readEntry) {
210
+ if (raw.length !== recipients.length) return {
211
+ ok: false,
212
+ reason: `expected ${recipients.length} deliveries, got ${raw.length}`
213
+ };
214
+ const requested = new Set(recipients);
215
+ const seen = /* @__PURE__ */ new Set();
216
+ const entries = [];
217
+ for (const [i, d] of raw.entries()) {
218
+ const entry = typeof d === "object" && d !== null ? d : null;
219
+ const recipient = entry?.recipient;
220
+ if (entry === null || typeof recipient !== "string") return {
221
+ ok: false,
222
+ reason: `entry ${i} is not ${shape}`
223
+ };
224
+ const value = readEntry(entry, recipient);
225
+ if (value === void 0) return {
226
+ ok: false,
227
+ reason: `entry ${i} is not ${shape}`
228
+ };
229
+ if (!requested.has(recipient)) return {
230
+ ok: false,
231
+ reason: `entry ${i} names a recipient that was not requested`
232
+ };
233
+ if (seen.has(recipient)) return {
234
+ ok: false,
235
+ reason: `entry ${i} repeats a recipient`
236
+ };
237
+ seen.add(recipient);
238
+ entries.push(value);
239
+ }
240
+ return {
241
+ ok: true,
242
+ entries
243
+ };
244
+ }
245
+ /**
246
+ * The `ids` of an `ok: true` response, one accepted outcome per recipient.
247
+ * The framework's Message-ID stands in for an empty provider reference.
248
+ */
249
+ function readDeliveryList(raw, recipients, fallbackId) {
250
+ return readRecipientList(raw, recipients, "{ recipient: string, messageId: string }", (entry, recipient) => typeof entry.messageId === "string" ? {
251
+ recipient,
252
+ messageId: entry.messageId || fallbackId,
253
+ ...entry.state === "provider_accepted" ? { state: "provider_accepted" } : {}
254
+ } : void 0);
255
+ }
256
+ /**
257
+ * Preserve each recipient's acceptance or error and recorded state. `ok: false`
258
+ * alone does not establish that retrying is safe: submission may be unresolved.
259
+ */
260
+ function readFailureDeliveries(raw, recipients, fallbackId) {
261
+ return readRecipientList(raw, recipients, "{ recipient: string, ok: true, messageId: string } | { recipient: string, ok: false, error: { message: string } }", (entry, recipient) => {
262
+ if (entry.ok === true) return typeof entry.messageId === "string" ? {
263
+ recipient,
264
+ ok: true,
265
+ messageId: entry.messageId || fallbackId,
266
+ ...entry.state === "provider_accepted" ? { state: "provider_accepted" } : {}
267
+ } : void 0;
268
+ if (entry.ok === false) {
269
+ const state = readDeliveryState(entry.state);
270
+ const error = entry.error;
271
+ return typeof error === "object" && error !== null && typeof error.message === "string" ? {
272
+ recipient,
273
+ ok: false,
274
+ error: makeError(coerceErrorCode(error.code), error.message),
275
+ ...state ? { state } : {}
276
+ } : void 0;
277
+ }
278
+ });
279
+ }
280
+ function readDeliveryState(value) {
281
+ return [
282
+ "rejected",
283
+ "reserved",
284
+ "attempt_started",
285
+ "provider_accepted",
286
+ "failed",
287
+ "outcome_unknown",
288
+ "cancelled"
289
+ ].find((state) => state === value);
290
+ }
291
+ const MAX_PROXY_RESPONSE_BYTES = 65536;
292
+ async function readResponseAsResult(res, recipients, fallbackId, beforeDeadline) {
293
+ let body;
294
+ try {
295
+ body = await readBoundedJson(res, MAX_PROXY_RESPONSE_BYTES, beforeDeadline);
296
+ } catch {
297
+ return err("OUTCOME_UNKNOWN", `email: could not establish the send outcome (status ${res.status}); check email logs or repeat the same idempotency key`);
298
+ }
299
+ const response = readProxyResponse(body);
300
+ if (response === null) {
301
+ const refusal = readProxyRefusal(body);
302
+ if (!res.ok && refusal !== null) return err("UPSTREAM_ERROR", `email: proxy returned ${res.status}: ${refusal}`, body);
303
+ return err("OUTCOME_UNKNOWN", `email: proxy returned malformed response (status ${res.status})`, body);
304
+ }
305
+ const malformedList = (reason) => err("OUTCOME_UNKNOWN", `email: proxy returned a malformed delivery list (${reason}); do not retry with a new idempotency key`, body);
306
+ const operation = typeof response.operationId === "string" && response.operationId.length <= 128 ? { operationId: response.operationId } : {};
307
+ if (response.ok === true) {
308
+ const list = readDeliveryList(response.ids, recipients, fallbackId);
309
+ return list.ok ? {
310
+ ok: true,
311
+ ids: list.entries,
312
+ ...operation
313
+ } : malformedList(list.reason);
314
+ }
315
+ if ("deliveries" in response) {
316
+ const list = readFailureDeliveries(response.deliveries, recipients, fallbackId);
317
+ return list.ok ? {
318
+ ok: false,
319
+ deliveries: list.entries,
320
+ ...operation
321
+ } : malformedList(list.reason);
322
+ }
323
+ const e = response.error;
324
+ return {
325
+ ...err(coerceErrorCode(e.code), typeof e.message === "string" ? e.message : "email: upstream send failed"),
326
+ ...operation
327
+ };
328
+ }
329
+ /**
330
+ * The loopback into the `bwf dev` inbox: `DEV_INBOX_ENV_VAR` names the
331
+ * assets binding, which in dev reaches the Vite dev server. Undefined
332
+ * outside dev.
333
+ */
334
+ function resolveDevInbox(env) {
335
+ const bindingName = env?.[DEV_INBOX_ENV_VAR];
336
+ if (typeof bindingName !== "string" || bindingName.length === 0) return;
337
+ const binding = env?.[bindingName];
338
+ if (typeof binding !== "object" || binding === null) return;
339
+ if (typeof binding.fetch !== "function") return;
340
+ const token = env?.[DEV_INBOX_TOKEN_ENV_VAR];
341
+ return {
342
+ fetcher: binding,
343
+ token: typeof token === "string" && token.length > 0 ? token : void 0
344
+ };
345
+ }
346
+ const DEV_INBOX_TIMEOUT_MS = 5e3;
347
+ /** Bound on the error text a failed capture echoes from the dev server. */
348
+ const DEV_INBOX_ERROR_EXCERPT_CHARS = 200;
349
+ const DEV_INBOX_ERROR_EXCERPT_TIMEOUT_MS = 1e3;
350
+ /**
351
+ * First line of a refusal, so a 401 names the header it wanted. One chunk
352
+ * under its own deadline: a stalled body must not hang `sendEmail`.
353
+ */
354
+ async function readErrorExcerpt(res) {
355
+ let timer;
356
+ try {
357
+ const reader = res.body?.getReader();
358
+ if (!reader) return "";
359
+ const first = await Promise.race([reader.read().then(({ value }) => value), new Promise((resolve) => {
360
+ timer = setTimeout(() => resolve(void 0), DEV_INBOX_ERROR_EXCERPT_TIMEOUT_MS);
361
+ })]);
362
+ reader.cancel().catch(() => {});
363
+ if (!first) return "";
364
+ return new TextDecoder().decode(first).trim().split("\n")[0].slice(0, DEV_INBOX_ERROR_EXCERPT_CHARS);
365
+ } catch {
366
+ return "";
367
+ } finally {
368
+ if (timer !== void 0) clearTimeout(timer);
369
+ }
370
+ }
371
+ async function postToDevInbox(inbox, captured) {
372
+ let timer;
373
+ try {
374
+ const attempt = Promise.resolve(inbox.fetcher.fetch(`http://localhost${DEV_INBOX_CAPTURE_URL}`, {
375
+ method: "POST",
376
+ headers: {
377
+ "content-type": "application/json",
378
+ ...inbox.token !== void 0 && { ["x-nosam-dev-trigger"]: inbox.token }
379
+ },
380
+ body: serializeCapturedMessage(captured)
381
+ })).then((res) => ({
382
+ kind: "response",
383
+ res
384
+ }), (cause) => ({
385
+ kind: "error",
386
+ cause
387
+ }));
388
+ const settled = await Promise.race([attempt, new Promise((resolve) => {
389
+ timer = setTimeout(() => resolve({ kind: "timeout" }), DEV_INBOX_TIMEOUT_MS);
390
+ })]);
391
+ if (settled.kind === "timeout") return {
392
+ ok: false,
393
+ reason: `no response within ${DEV_INBOX_TIMEOUT_MS}ms`
394
+ };
395
+ if (settled.kind === "error") {
396
+ const cause = settled.cause;
397
+ return {
398
+ ok: false,
399
+ reason: cause instanceof Error ? cause.message : String(cause)
400
+ };
401
+ }
402
+ const { res } = settled;
403
+ if (!res.ok) {
404
+ const excerpt = await readErrorExcerpt(res);
405
+ return {
406
+ ok: false,
407
+ reason: `dev server responded ${res.status}${excerpt ? `: ${excerpt}` : ""}`
408
+ };
409
+ }
410
+ if (res.headers.get("x-nosam-email-inbox") !== "captured") return {
411
+ ok: false,
412
+ reason: "response did not come from the dev inbox"
413
+ };
414
+ return { ok: true };
415
+ } catch (e) {
416
+ return {
417
+ ok: false,
418
+ reason: e instanceof Error ? e.message : String(e)
419
+ };
420
+ } finally {
421
+ if (timer !== void 0) clearTimeout(timer);
422
+ }
423
+ }
424
+ /** A captured send's result: one id per unique recipient, as a deployed send reports. */
425
+ function capturedResult(normalized, captureId) {
426
+ return {
427
+ ok: true,
428
+ ids: uniqueRecipients(normalized).map((recipient) => ({
429
+ recipient,
430
+ messageId: captureId
431
+ }))
432
+ };
433
+ }
434
+ /**
435
+ * Send an email via the worker's own `SEND_EMAIL` binding or the bwf
436
+ * platform proxy.
437
+ *
438
+ * During `bwf dev` the message is captured by the local inbox
439
+ * (`/__nosam/inbox`) and never reaches the proxy; an in-process sink
440
+ * (`@builtbyfriends/bwf/email/testing`) takes precedence over it.
441
+ */
442
+ async function sendEmail(opts) {
443
+ if (opts.idempotencyKey !== void 0 && (typeof opts.idempotencyKey !== "string" || !/^[\x21-\x7e]{1,128}$/.test(opts.idempotencyKey))) return err("MIME_ERROR", "email: idempotencyKey must contain 1–128 printable non-space ASCII characters.");
444
+ const resolvedOpts = resolveDefaultFrom(opts);
445
+ if (resolvedOpts.from === void 0) return err("INVALID_FROM", "email: 'from' is required. Set it explicitly or deploy via bwf so the platform-injected __NOSAM_PROJECT_SLUG and __NOSAM_EMAIL_DOMAIN can default it to <slug>+noreply@<domain>.");
446
+ const optsWithFrom = resolvedOpts;
447
+ let normalized;
448
+ let raw;
449
+ let messageId;
450
+ try {
451
+ normalized = await normalizeEmail(optsWithFrom);
452
+ ({raw, messageId} = buildMime(normalized));
453
+ } catch (e) {
454
+ if (e instanceof MimeError) return err(e.code, e.message, e);
455
+ return err("MIME_ERROR", e instanceof Error ? e.message : String(e), e);
456
+ }
457
+ const rawEnv = tryGetRawRuntimeEnv();
458
+ if (!opts.sendInDev && hasActiveSink()) {
459
+ const captured = captureMessage(normalized, raw, messageId);
460
+ dispatchToSinks(captured);
461
+ return capturedResult(normalized, captured.id);
462
+ }
463
+ const devInbox = opts.sendInDev ? void 0 : resolveDevInbox(rawEnv);
464
+ if (devInbox) {
465
+ const captured = captureMessage(normalized, raw, messageId);
466
+ const delivered = await postToDevInbox(devInbox, captured);
467
+ if (delivered.ok) return capturedResult(normalized, captured.id);
468
+ const message = `email: the bwf dev inbox at ${DEV_INBOX_CAPTURE_URL} is unreachable (${delivered.reason}), so nothing was captured and nothing was sent.`;
469
+ console.warn(`[bwf/email] ${message}`);
470
+ return err("UPSTREAM_ERROR", message);
471
+ }
472
+ const recipients = uniqueRecipients(normalized);
473
+ const sendBinding = resolveSendEmailBinding(rawEnv);
474
+ if (sendBinding) {
475
+ if (opts.idempotencyKey !== void 0) return err("MIME_ERROR", "email: idempotencyKey requires a bwf platform; the native Cloudflare binding cannot deduplicate sends.");
476
+ return sendViaBinding(sendBinding, normalized.from.email, recipients, raw, messageId);
477
+ }
478
+ const env = rawEnv;
479
+ const proxy = env?.__NOSAM_PROXY;
480
+ const projectId = env?.__PROJECT_ID;
481
+ const proxyToken = env?.__NOSAM_PROXY_TOKEN;
482
+ if (!proxy || !projectId || !proxyToken) return err("BINDING_MISSING", "email: neither SEND_EMAIL nor __NOSAM_PROXY is available, so nothing was sent. Deploy via bwf to bind the platform proxy, or set `email.from` in bwf.config.ts so `bwf deploy --platform cloudflare` provisions the SEND_EMAIL binding. Under `bwf dev` messages are captured by the local inbox at /__nosam/inbox instead — reaching this error there means that path was bypassed by the deprecated `sendInDev: true` (it never delivers) or unavailable (the worker has no assets binding to reach the dev server through).");
483
+ const body = {
484
+ projectId,
485
+ aiToken: proxyToken,
486
+ from: normalized.from.email,
487
+ recipients,
488
+ mimeBase64: bytesToBase64(raw),
489
+ requestId: newId("req"),
490
+ ...opts.idempotencyKey === void 0 ? {} : { idempotencyKey: opts.idempotencyKey }
491
+ };
492
+ const requestBody = JSON.stringify(body);
493
+ const controller = new AbortController();
494
+ const deadline = Date.now() + PLATFORM_SEND_DEADLINE_MS;
495
+ const beforeDeadline = (run) => withTimeout(deadline - Date.now(), run, () => {
496
+ controller.abort();
497
+ return /* @__PURE__ */ new Error("email platform send timed out");
498
+ });
499
+ let res;
500
+ try {
501
+ res = await beforeDeadline(() => proxy.fetch("https://email-proxy/email/send", {
502
+ method: "POST",
503
+ headers: { "content-type": "application/json" },
504
+ body: requestBody,
505
+ signal: controller.signal
506
+ }));
507
+ } catch (e) {
508
+ return err("OUTCOME_UNKNOWN", `email: send outcome is unknown: ${e instanceof Error ? e.message : String(e)}. Check email logs or repeat the same idempotency key; do not create a new send.`, e);
509
+ }
510
+ return readResponseAsResult(res, recipients, messageId, beforeDeadline);
511
+ }
512
+ /**
513
+ * Build a normalized email + raw MIME for advanced callers who want to feed
514
+ * the message into a custom transport. Throws on invalid input.
515
+ */
516
+ async function createEmail(opts) {
517
+ if (opts.from === void 0) throw new MimeError("INVALID_FROM", "createEmail: 'from' is required (this entrypoint does not apply __NOSAM_PROJECT_SLUG defaulting).");
518
+ const email = await normalizeEmail(opts);
519
+ return {
520
+ email,
521
+ ...buildMime(email)
522
+ };
523
+ }
524
+ export { MimeError, ParseEmailError, createEmail, createMessageProxy, defineEmail, enactEmailActions, isForwardableEmailMessage, parseEmail, replyEmail, sendEmail };
@@ -0,0 +1,19 @@
1
+ import { a as number, c as url, i as json, n as boolean, o as oneOf, r as email, s as string, t as EnvSchema } from "../env-helpers-U56xuFgL.mjs";
2
+ export declare const env: Record<string, unknown>;
3
+ /**
4
+ * In client builds `defineEnv` is a no-op identity function — schema
5
+ * registration only happens server-side. We still return the `env` proxy so
6
+ * t3-style `export const env = defineEnv({...})` keeps working in shared
7
+ * modules.
8
+ */
9
+ export declare function defineEnv<S>(_schema: S): typeof env;
10
+ export declare class EnvValidationError extends Error {
11
+ readonly key: string;
12
+ readonly issues: Array<{
13
+ message: string;
14
+ }>;
15
+ constructor(key: string, issues: Array<{
16
+ message: string;
17
+ }>);
18
+ }
19
+ export { type EnvSchema, boolean, email, json, number, oneOf, string, url };
@@ -0,0 +1,55 @@
1
+ import { a as oneOf, i as number, n as email, o as string, r as json, s as url, t as boolean } from "../env-helpers-BX0APszT.mjs";
2
+ // src/runtime/env-public-client.ts
3
+ function getClientEnv() {
4
+ return import.meta.env;
5
+ }
6
+ function readClientKey(key) {
7
+ const meta = getClientEnv();
8
+ if (meta && key in meta) return meta[key];
9
+ throw new Error(`env: Key '${key}' is not exposed to the client. bwf only exposes VITE_* schema keys to browser code. Either rename the key in env.ts with that prefix, or move this access to a server module.`);
10
+ }
11
+ const env = new Proxy({}, {
12
+ get(_target, key) {
13
+ if (typeof key === "symbol") return;
14
+ return readClientKey(String(key));
15
+ },
16
+ has(_target, key) {
17
+ if (typeof key !== "string") return false;
18
+ const meta = getClientEnv();
19
+ return meta ? key in meta : false;
20
+ },
21
+ ownKeys() {
22
+ const meta = getClientEnv();
23
+ return meta ? Object.keys(meta) : [];
24
+ },
25
+ getOwnPropertyDescriptor(_target, key) {
26
+ if (typeof key !== "string") return;
27
+ const meta = getClientEnv();
28
+ if (!meta || !(key in meta)) return;
29
+ return {
30
+ enumerable: true,
31
+ configurable: true,
32
+ value: meta[key]
33
+ };
34
+ }
35
+ });
36
+ /**
37
+ * In client builds `defineEnv` is a no-op identity function — schema
38
+ * registration only happens server-side. We still return the `env` proxy so
39
+ * t3-style `export const env = defineEnv({...})` keeps working in shared
40
+ * modules.
41
+ */
42
+ function defineEnv(_schema) {
43
+ return env;
44
+ }
45
+ var EnvValidationError = class extends Error {
46
+ key;
47
+ issues;
48
+ constructor(key, issues) {
49
+ super(`Invalid env "${key}": ${issues.map((i) => i.message).join(", ")}`);
50
+ this.key = key;
51
+ this.issues = issues;
52
+ this.name = "EnvValidationError";
53
+ }
54
+ };
55
+ export { EnvValidationError, boolean, defineEnv, email, env, json, number, oneOf, string, url };
@@ -0,0 +1,4 @@
1
+ /// <reference types="@cloudflare/workers-types" />
2
+ import { a as number, c as url, i as json, n as boolean, o as oneOf, r as email, s as string, t as EnvSchema } from "../env-helpers-U56xuFgL.mjs";
3
+ import { a as _getSchemaDefaults, c as defineEnv, i as _getRegisteredSchema, l as env, n as EnvValidationReport, o as _hasRegisteredSchema, r as ValidatedEnv, s as _validateEnvOnce, t as EnvValidationError, u as validateAllEnv } from "../env-public-Cw_xPi1D.mjs";
4
+ export { type EnvSchema, EnvValidationError, EnvValidationReport, ValidatedEnv, _getRegisteredSchema, _getSchemaDefaults, _hasRegisteredSchema, _validateEnvOnce, boolean, defineEnv, email, env, json, number, oneOf, string, url, validateAllEnv };