@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,73 @@
1
+ import { H as outro, L as log } from "./dist-STQXl8ck.mjs";
2
+ import { a as join } from "./dist-DMYe8CZJ.mjs";
3
+ import { r as generateEnvTypes, t as findEnvFile } from "./env-types-Bg-dTh8u.mjs";
4
+ import { c as getToken } from "./auth-xnkmpZUl.mjs";
5
+ import { r as PlatformClient } from "./client-D3D5RM5h.mjs";
6
+ import { d as formatEnvReport, g as validateProdEnv, u as fetchRemoteSecretNames } from "./env-validation-DeqFUSKg.mjs";
7
+ import { m as printSuccess, p as note } from "./output-Bb34lF0w.mjs";
8
+ import { n as readDeploymentPlatform, r as readProjectConfig } from "./project-CC7eN00D.mjs";
9
+ import { mkdirSync, writeFileSync } from "node:fs";
10
+ // src/cli/env.ts
11
+ async function runEnvCommand(root, args) {
12
+ console.log();
13
+ if (args.subcommand === "check") {
14
+ await runCheck(root, args.useRemoteSecrets);
15
+ return;
16
+ }
17
+ if (args.subcommand === "types") {
18
+ runTypes(root);
19
+ return;
20
+ }
21
+ }
22
+ async function runCheck(root, useRemoteSecrets) {
23
+ let remoteSecrets;
24
+ if (useRemoteSecrets) {
25
+ const platform = readDeploymentPlatform(root);
26
+ if (platform === "none") throw new Error("env: Deployment is disabled. Run `bwf init` to choose a platform.");
27
+ if (platform === "cloudflare") {
28
+ const { listCloudflareSecrets, resolveCloudflareOperationContext } = await import("./cloudflare-operations-BcK849ue.mjs");
29
+ remoteSecrets = await listCloudflareSecrets(resolveCloudflareOperationContext(root));
30
+ } else {
31
+ const token = getToken(root);
32
+ if (!token) {
33
+ log.error("--remote requires authentication. Run `bwf account login` first.");
34
+ process.exit(1);
35
+ }
36
+ const config = readProjectConfig(root);
37
+ if (!config) {
38
+ log.error("--remote requires a linked project. Run `bwf project link` first.");
39
+ process.exit(1);
40
+ }
41
+ const client = new PlatformClient(token, { root });
42
+ remoteSecrets = await fetchRemoteSecretNames(client, config.projectId);
43
+ }
44
+ }
45
+ const { hasSchema, report } = await validateProdEnv(root, {
46
+ productionOnly: useRemoteSecrets,
47
+ remoteSecrets
48
+ });
49
+ if (!hasSchema) {
50
+ outro("No env.ts found — nothing to validate.");
51
+ return;
52
+ }
53
+ if (report.valid) {
54
+ printSuccess(useRemoteSecrets ? "All required remote env names are present; values validate at runtime." : "Local .env values are valid.");
55
+ return;
56
+ }
57
+ note(formatEnvReport(report), "Env validation failed");
58
+ if (report.missing.length > 0) log.info(useRemoteSecrets ? "Upload missing server values with `bwf secret put <NAME>`; set VITE_* values in the build shell or schema defaults." : "Add the missing values to .env or set them in your shell.");
59
+ process.exit(1);
60
+ }
61
+ function runTypes(root) {
62
+ const envFile = findEnvFile(root);
63
+ if (!envFile) {
64
+ outro("No env.ts found at project root — nothing to generate.");
65
+ return;
66
+ }
67
+ const outDir = join(root, ".bwf");
68
+ mkdirSync(outDir, { recursive: true });
69
+ const { dts } = generateEnvTypes(envFile, outDir);
70
+ writeFileSync(join(outDir, "env.d.ts"), dts);
71
+ printSuccess(`Wrote ${join(".bwf", "env.d.ts")}.`);
72
+ }
73
+ export { runEnvCommand };
@@ -0,0 +1,88 @@
1
+ import { a as join } from "./dist-DMYe8CZJ.mjs";
2
+ import { t as parseDotenvFile } from "./dotenv-4NdUCXbB.mjs";
3
+ import { readdirSync } from "node:fs";
4
+ // src/shared/env.ts
5
+ /** bwf's single local dotenv file. It is never a production configuration source. */
6
+ const LOCAL_ENV_FILE = ".env";
7
+ /** The fixed browser-exposure convention supported by `@builtbyfriends/bwf/env`. */
8
+ const CLIENT_ENV_PREFIX = "VITE_";
9
+ function isClientEnvKey(key) {
10
+ return key.startsWith(CLIENT_ENV_PREFIX);
11
+ }
12
+ /** Read the one local-development dotenv file. */
13
+ function loadLocalEnv(root, options = {}) {
14
+ return parseDotenvFile(join(root, LOCAL_ENV_FILE), { onWarn: options.onWarn });
15
+ }
16
+ /**
17
+ * Marks the isolated probes and Vite build run by
18
+ * `bwf deploy --platform cloudflare`.
19
+ *
20
+ * Kept here so the deploy orchestrator and Vite plugin share one spelling.
21
+ * The marker is passed through child-process env only; it is never a Worker
22
+ * binding and is not set for `bwf dev` or ordinary `vite build` commands.
23
+ */
24
+ const CLOUDFLARE_DEPLOY_BUILD_ENV = "BWF_CLOUDFLARE_DEPLOY_BUILD";
25
+ /**
26
+ * JSON map from each `queues/` name to the Cloudflare queue name that
27
+ * `bwf deploy --platform cloudflare` chose. Set only for its Vite build.
28
+ */
29
+ const CLOUDFLARE_QUEUE_NAMES_BUILD_ENV = "NOSAM_CLOUDFLARE_QUEUE_NAMES";
30
+ /**
31
+ * Find legacy Vite dotenv variants. bwf intentionally supports only `.env`;
32
+ * production configuration is project-scoped remote state instead of a file.
33
+ */
34
+ function findLegacyEnvFiles(root) {
35
+ try {
36
+ return readdirSync(root).filter((name) => name.startsWith(".env.") || name === ".env.example" || name === ".dev.vars" || name.startsWith(".dev.vars.")).sort((a, b) => a.localeCompare(b));
37
+ } catch {
38
+ return [];
39
+ }
40
+ }
41
+ /**
42
+ * Sentence to append to a legacy-file error when `.env.example` is among the
43
+ * files, since it is usually added out of habit to document expected keys.
44
+ */
45
+ function legacyEnvExampleHint(legacyFiles) {
46
+ return legacyFiles.includes(".env.example") ? " env.ts lists the keys this app expects, so .env.example is not needed." : "";
47
+ }
48
+ /**
49
+ * Resolve whether the plugin should run in "remote" mode (proxy real
50
+ * D1/KV/R2 via the platform) based on the project config plus an optional
51
+ * `BWF_REMOTE` env override.
52
+ *
53
+ * Tri-state override semantics:
54
+ * - `BWF_REMOTE=1` → force remote mode on
55
+ * - `BWF_REMOTE=0` → force remote mode off (e.g. local/CI builds of a
56
+ * project whose `bwf.config.ts` sets `remote: true`)
57
+ * - unset / any other value → fall back to `config.remote`
58
+ *
59
+ * The dev-server plugin (index.ts), the prerender build plugin
60
+ * (plugin-prerender.ts), and managed deploy (cli/deploy-managed-full.ts) must
61
+ * derive `remoteMode` through this helper so dev and build stay in lockstep.
62
+ */
63
+ function resolveRemoteMode(configRemote) {
64
+ const override = process.env.BWF_REMOTE;
65
+ if (override === "1") return true;
66
+ if (override === "0") return false;
67
+ return configRemote === true;
68
+ }
69
+ /**
70
+ * Names starting with this prefix are reserved for bwf. bwf sets them
71
+ * itself (proxy credentials, email and AI wiring), so `.env` and `env.ts`
72
+ * must not define them: Wrangler loads `.env` into the dev Worker on its own
73
+ * and writes it over `vars`, so dropping keys from `vars` cannot keep them
74
+ * out. `envSchemaPlugin` and `bwf env check` reject them instead.
75
+ */
76
+ const RESERVED_ENV_PREFIX = "__NOSAM_";
77
+ /** Names in `keys` that use the reserved `__NOSAM_` prefix, in input order. */
78
+ function findReservedEnvKeys(keys) {
79
+ return Array.from(keys).filter((key) => key.startsWith(RESERVED_ENV_PREFIX));
80
+ }
81
+ /**
82
+ * The error for reserved names found in `.env` or `env.ts`. Shared by the
83
+ * Vite plugin and `bwf env check` so both print the same text.
84
+ */
85
+ function reservedEnvKeysMessage(source, keys) {
86
+ return `${source} ${source === ".env" ? "defines" : "declares"} names reserved for bwf: ${keys.join(", ")}. bwf sets these itself; remove them. To trigger crons or queues locally, use the x-nosam-dev-trigger header printed at dev start.`;
87
+ }
88
+ export { findReservedEnvKeys as a, loadLocalEnv as c, findLegacyEnvFiles as i, reservedEnvKeysMessage as l, CLOUDFLARE_QUEUE_NAMES_BUILD_ENV as n, isClientEnvKey as o, LOCAL_ENV_FILE as r, legacyEnvExampleHint as s, CLOUDFLARE_DEPLOY_BUILD_ENV as t, resolveRemoteMode as u };
@@ -0,0 +1,71 @@
1
+ import { i as getRawRuntimeEnv, n as asEnv, r as envContext, t as INTERNAL_BINDING_PREFIXES } from "./env-raw-Bo6TtrHU.mjs";
2
+ import { AsyncLocalStorage } from "node:async_hooks";
3
+ // src/runtime/env.ts
4
+ /**
5
+ * Public runtime env API — exposed via "@builtbyfriends/bwf/_env".
6
+ *
7
+ * All exports from this module are accessible to user code.
8
+ * Internal platform bindings (__NOSAM_*, __PROJECT_*) are filtered
9
+ * from getRuntimeEnv() and blocked in getRuntimeBinding().
10
+ */
11
+ const REQUEST_SCOPE_SYMBOL = Symbol.for("bwf.runtimeRequestScope.v1");
12
+ const shared = globalThis;
13
+ shared[REQUEST_SCOPE_SYMBOL] ??= new AsyncLocalStorage();
14
+ const runtimeRequestContext = shared[REQUEST_SCOPE_SYMBOL];
15
+ /** @internal Reuse a resource only within the current runtime request. */
16
+ function getRuntimeRequestResource(key, initialize, outsideScope) {
17
+ const scope = runtimeRequestContext.getStore();
18
+ if (!scope) {
19
+ if (outsideScope) return outsideScope();
20
+ throw new Error("env: Request-scoped resource is unavailable outside a runtime handler.");
21
+ }
22
+ if (scope.resources.has(key)) return scope.resources.get(key);
23
+ const resource = initialize();
24
+ scope.resources.set(key, resource);
25
+ return resource;
26
+ }
27
+ function withRuntimeEnv(env, fn) {
28
+ const resolved = asEnv(env);
29
+ if (!resolved) return fn();
30
+ if (runtimeRequestContext.getStore()) return envContext.run(resolved, fn);
31
+ const scope = { resources: /* @__PURE__ */ new Map() };
32
+ return envContext.run(resolved, () => runtimeRequestContext.run(scope, fn));
33
+ }
34
+ /** Whether `name` is a framework binding hidden from user code. */
35
+ function isInternalBinding(name) {
36
+ return INTERNAL_BINDING_PREFIXES.some((p) => name.startsWith(p));
37
+ }
38
+ function filterEnvProxy(env) {
39
+ return new Proxy(env, {
40
+ get(target, prop, receiver) {
41
+ if (typeof prop === "string" && isInternalBinding(prop)) return;
42
+ return Reflect.get(target, prop, receiver);
43
+ },
44
+ has(target, prop) {
45
+ if (typeof prop === "string" && isInternalBinding(prop)) return false;
46
+ return Reflect.has(target, prop);
47
+ },
48
+ ownKeys(target) {
49
+ return Reflect.ownKeys(target).filter((key) => typeof key !== "string" || !isInternalBinding(key));
50
+ },
51
+ getOwnPropertyDescriptor(target, prop) {
52
+ if (typeof prop === "string" && isInternalBinding(prop)) return;
53
+ return Reflect.getOwnPropertyDescriptor(target, prop);
54
+ }
55
+ });
56
+ }
57
+ /** Returns the runtime env with internal platform bindings hidden. */
58
+ function getRuntimeEnv() {
59
+ return filterEnvProxy(getRawRuntimeEnv());
60
+ }
61
+ function getRuntimeBinding(name) {
62
+ const raw = getRawRuntimeEnv();
63
+ if (isInternalBinding(name)) return;
64
+ return raw[name];
65
+ }
66
+ function requireRuntimeBinding(name) {
67
+ const value = getRuntimeBinding(name);
68
+ if (value !== void 0 && value !== null) return value;
69
+ throw new Error(`env: Missing Cloudflare binding '${name}'.`);
70
+ }
71
+ export { requireRuntimeBinding as a, isInternalBinding as i, getRuntimeEnv as n, withRuntimeEnv as o, getRuntimeRequestResource as r, getRuntimeBinding as t };
@@ -0,0 +1,135 @@
1
+ // src/runtime/env-helpers.ts
2
+ function build(parse, state) {
3
+ return {
4
+ "~standard": {
5
+ version: 1,
6
+ vendor: "nosam",
7
+ validate(value) {
8
+ if (value === void 0 || value === null || value === "") {
9
+ if (state.defaultValue !== void 0) return { value: state.defaultValue };
10
+ if (state.optional) return { value: void 0 };
11
+ return { issues: [{ message: "Required" }] };
12
+ }
13
+ const result = parse(typeof value === "string" ? value : String(value));
14
+ if (result.ok) return { value: result.value };
15
+ return { issues: [{ message: result.message }] };
16
+ }
17
+ },
18
+ optional() {
19
+ return build(parse, {
20
+ optional: true,
21
+ defaultValue: state.defaultValue
22
+ });
23
+ },
24
+ default(value) {
25
+ return build(parse, {
26
+ optional: false,
27
+ defaultValue: value
28
+ });
29
+ }
30
+ };
31
+ }
32
+ const empty = () => ({
33
+ optional: false,
34
+ defaultValue: void 0
35
+ });
36
+ /** Required string env value. */
37
+ function string() {
38
+ return build((raw) => ({
39
+ ok: true,
40
+ value: raw
41
+ }), empty());
42
+ }
43
+ /** Numeric env value. Parses with `Number(raw)`; rejects NaN. */
44
+ function number() {
45
+ return build((raw) => {
46
+ const n = Number(raw);
47
+ if (Number.isNaN(n)) return {
48
+ ok: false,
49
+ message: `Expected a number, got "${raw}"`
50
+ };
51
+ return {
52
+ ok: true,
53
+ value: n
54
+ };
55
+ }, empty());
56
+ }
57
+ /** Boolean env value. Accepts "true"/"false"/"1"/"0" (case-insensitive). */
58
+ function boolean() {
59
+ return build((raw) => {
60
+ const lowercased = raw.toLowerCase();
61
+ if (lowercased === "true" || lowercased === "1") return {
62
+ ok: true,
63
+ value: true
64
+ };
65
+ if (lowercased === "false" || lowercased === "0") return {
66
+ ok: true,
67
+ value: false
68
+ };
69
+ return {
70
+ ok: false,
71
+ message: `Expected boolean (true/false/1/0), got "${raw}"`
72
+ };
73
+ }, empty());
74
+ }
75
+ /** URL string — validated via `new URL(raw)`. */
76
+ function url() {
77
+ return build((raw) => {
78
+ try {
79
+ new URL(raw);
80
+ return {
81
+ ok: true,
82
+ value: raw
83
+ };
84
+ } catch {
85
+ return {
86
+ ok: false,
87
+ message: `Expected a valid URL, got "${raw}"`
88
+ };
89
+ }
90
+ }, empty());
91
+ }
92
+ const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
93
+ /** Email string — basic shape validation. */
94
+ function email() {
95
+ return build((raw) => {
96
+ if (!EMAIL_RE.test(raw)) return {
97
+ ok: false,
98
+ message: `Expected a valid email, got "${raw}"`
99
+ };
100
+ return {
101
+ ok: true,
102
+ value: raw
103
+ };
104
+ }, empty());
105
+ }
106
+ /** One of a fixed set of literal string values. */
107
+ function oneOf(values) {
108
+ return build((raw) => {
109
+ if (values.includes(raw)) return {
110
+ ok: true,
111
+ value: raw
112
+ };
113
+ return {
114
+ ok: false,
115
+ message: `Expected one of ${values.join(", ")}, got "${raw}"`
116
+ };
117
+ }, empty());
118
+ }
119
+ /** JSON-parsed env value. Specify `T` to type the parsed result. */
120
+ function json() {
121
+ return build((raw) => {
122
+ try {
123
+ return {
124
+ ok: true,
125
+ value: JSON.parse(raw)
126
+ };
127
+ } catch (e) {
128
+ return {
129
+ ok: false,
130
+ message: `Invalid JSON: ${e.message}`
131
+ };
132
+ }
133
+ }, empty());
134
+ }
135
+ export { oneOf as a, number as i, email as n, string as o, json as r, url as s, boolean as t };
@@ -0,0 +1,20 @@
1
+ import { t as StandardSchemaV1 } from "./standard-schema-CuDawHOC.mjs";
2
+ type EnvSchema<T> = StandardSchemaV1<unknown, T> & {
3
+ optional(): EnvSchema<T | undefined>;
4
+ default(value: NonNullable<T>): EnvSchema<NonNullable<T>>;
5
+ };
6
+ /** Required string env value. */
7
+ declare function string(): EnvSchema<string>;
8
+ /** Numeric env value. Parses with `Number(raw)`; rejects NaN. */
9
+ declare function number(): EnvSchema<number>;
10
+ /** Boolean env value. Accepts "true"/"false"/"1"/"0" (case-insensitive). */
11
+ declare function boolean(): EnvSchema<boolean>;
12
+ /** URL string — validated via `new URL(raw)`. */
13
+ declare function url(): EnvSchema<string>;
14
+ /** Email string — basic shape validation. */
15
+ declare function email(): EnvSchema<string>;
16
+ /** One of a fixed set of literal string values. */
17
+ declare function oneOf<const Values extends Array<string>>(values: Values): EnvSchema<Values[number]>;
18
+ /** JSON-parsed env value. Specify `T` to type the parsed result. */
19
+ declare function json<T = unknown>(): EnvSchema<T>;
20
+ export { number as a, url as c, json as i, boolean as n, oneOf as o, email as r, string as s, EnvSchema as t };
@@ -0,0 +1,46 @@
1
+ // src/shared/env-mask.ts
2
+ /**
3
+ * Secret redaction helpers for env-validation output.
4
+ *
5
+ * Values are redacted (replaced with `<redacted>`) whenever they flow into
6
+ * a user-visible string — `EnvValidationError` messages, CLI reports, the
7
+ * dev-server warning block. The key name is never masked (the user needs
8
+ * it to locate the offending entry).
9
+ *
10
+ * Server env values are production secrets by definition, so validator
11
+ * messages redact the raw input unconditionally.
12
+ *
13
+ * Users can opt out of the guard for local debugging via
14
+ * `BWF_ENV_UNMASK=1` in the environment; that path prints a one-shot
15
+ * notice on stderr so the loosened output is visibly attributed.
16
+ *
17
+ * This module is a leaf — no imports from non-leaf modules, safe to reach
18
+ * from both the runtime (worker bundle) and the CLI host.
19
+ */
20
+ /** Sentinel emitted in place of a redacted value. */
21
+ const REDACTED = "<redacted>";
22
+ /** Environment variable that disables redaction when set to `1`. */
23
+ const UNMASK_ENV_VAR = "BWF_ENV_UNMASK";
24
+ /** Replace raw input in validator messages, regardless of its name or shape. */
25
+ function redactMessage(rawValue, message, options = {}) {
26
+ if (options.unmask) return message;
27
+ if (typeof rawValue !== "string" || rawValue.length === 0) return message;
28
+ return message.split(rawValue).join(REDACTED);
29
+ }
30
+ let unmaskResolved = null;
31
+ /**
32
+ * Resolve the effective unmask flag, consulting `process.env` exactly once
33
+ * per process. On the first affirmative read, we print a one-shot notice to
34
+ * stderr so CI logs clearly show the guard is off.
35
+ */
36
+ function isUnmaskActive() {
37
+ if (unmaskResolved !== null) return unmaskResolved;
38
+ try {
39
+ unmaskResolved = globalThis.process?.env?.[UNMASK_ENV_VAR] === "1";
40
+ } catch {
41
+ unmaskResolved = false;
42
+ }
43
+ if (unmaskResolved) console.error(`[bwf/env] ${UNMASK_ENV_VAR}=1 is set — env validation errors will include raw values. Unset it before sharing logs.`);
44
+ return unmaskResolved;
45
+ }
46
+ export { redactMessage as n, isUnmaskActive as t };
@@ -0,0 +1,119 @@
1
+ import { t as BwfPlatformSandbox } from "./sandbox-CWDjoEG2.mjs";
2
+ import { t as StandardSchemaV1 } from "./standard-schema-CuDawHOC.mjs";
3
+ type AnyValidator = StandardSchemaV1<unknown, unknown>;
4
+ type AnySchema = Record<string, AnyValidator>;
5
+ /**
6
+ * Type-only stub for the validated env shape. Augmented by the generated
7
+ * `.bwf/env.d.ts` so `env.X` is typed per the user's schema. Includes an
8
+ * index signature so untyped property access returns `unknown` (rather than
9
+ * a hard error) for bindings and keys not declared in the schema.
10
+ */
11
+ interface ValidatedEnv {
12
+ readonly [key: string]: unknown;
13
+ }
14
+ type InferEnv<S extends AnySchema> = { readonly [K in keyof S]: StandardSchemaV1.InferOutput<S[K]>; };
15
+ /**
16
+ * Register an env schema and return the typed `env` proxy.
17
+ *
18
+ * Calling `defineEnv` is the only required step — bwf auto-discovers
19
+ * `env.ts` at project root, imports it, and uses the schema for runtime
20
+ * validation, type generation, and deploy-time secret checks.
21
+ *
22
+ * The return value is identical to the `env` export from `@builtbyfriends/bwf/env`.
23
+ * Re-export it from your `env.ts` if you prefer the explicit
24
+ * `import { env } from "~/env"` pattern.
25
+ */
26
+ declare function defineEnv<S extends AnySchema>(schema: S): InferEnv<S>;
27
+ /**
28
+ * Internal: validate the whole schema against the worker env, from the generated
29
+ * worker entry. Catches remote-secret values the deploy CLI cannot see. A
30
+ * completed validation is reused for the same raw values; an env with other
31
+ * values is validated again. Async validators are awaited here, and their values
32
+ * serve later synchronous `env.X` reads of the env this call receives, and of any
33
+ * other env that holds the same raw values.
34
+ */
35
+ declare function _validateEnvOnce(envValues: unknown): Promise<void>;
36
+ /** Internal: framework-only access to the registered schema (for plugin/CLI). */
37
+ declare function _getRegisteredSchema(): AnySchema | null;
38
+ /**
39
+ * Internal: returns `true` once `defineEnv()` has been called at least once,
40
+ * regardless of whether the caller passed an empty schema. Gives tooling a
41
+ * reliable signal — `_getRegisteredSchema()` alone can't distinguish
42
+ * `defineEnv({})` (an intentional empty schema) from "never called".
43
+ */
44
+ declare function _hasRegisteredSchema(): boolean;
45
+ /**
46
+ * Internal: extract `.default(value)` values from the registered schema as
47
+ * stringified env values. Used for explicit build-time client fallbacks.
48
+ *
49
+ * Detection is schema-agnostic: probe each validator with `undefined` and,
50
+ * if it succeeds with a non-undefined value, that value is the default.
51
+ * Works for our built-in `.default(...)` helpers and for any Standard
52
+ * Schema validator with intrinsic default behaviour. Async validators are
53
+ * skipped (we can't get a sync default).
54
+ *
55
+ * Keys with no default — required keys and plain `.optional()` keys — are omitted.
56
+ */
57
+ declare function _getSchemaDefaults(): Record<string, string>;
58
+ declare class EnvValidationError extends Error {
59
+ readonly key: string;
60
+ readonly issues: Array<StandardSchemaV1.Issue>;
61
+ constructor(key: string, issues: Array<StandardSchemaV1.Issue>);
62
+ }
63
+ /**
64
+ * Typed env proxy. Reads from the runtime env, validating declared keys
65
+ * on first access and passing through bindings / unknown keys unchanged.
66
+ * Async validators must be resolved first by `_validateEnvOnce()`.
67
+ */
68
+ declare const env: ValidatedEnv;
69
+ /** Aggregate report from validating an entire env object against the schema. */
70
+ type EnvValidationReport = {
71
+ valid: boolean;
72
+ missing: Array<string>;
73
+ invalid: Array<{
74
+ key: string;
75
+ messages: Array<string>;
76
+ }>;
77
+ /**
78
+ * Resolved values for keys that validated successfully. After async
79
+ * pre-validation they serve sync `env.X` reads.
80
+ */
81
+ values: Map<string, unknown>;
82
+ };
83
+ /**
84
+ * Validate an env record (local dotenv, build inputs, or runtime bindings) against
85
+ * the registered schema. Used by the dev plugin (warnings), the deploy CLI
86
+ * (hard error), and `_validateEnvOnce` at worker boot.
87
+ *
88
+ * Async: awaits any validators that return a `Promise` (zod async refines,
89
+ * arktype narrows, etc.). Callers already run in async contexts.
90
+ */
91
+ declare function validateAllEnv(envValues: Record<string, unknown>): Promise<EnvValidationReport>;
92
+ declare global {
93
+ namespace Cloudflare {
94
+ interface Env {
95
+ DB: D1Database;
96
+ KV: KVNamespace;
97
+ STORAGE: R2Bucket;
98
+ AI: Ai;
99
+ SANDBOX: DurableObjectNamespace<BwfPlatformSandbox>;
100
+ ASSETS: Fetcher;
101
+ /** @internal Service binding to proxy worker (AI, revalidation, future features) */
102
+ __NOSAM_PROXY?: Fetcher;
103
+ /** @internal Custom proxy URL override */
104
+ __NOSAM_PROXY_URL?: string;
105
+ /** @internal Auth token for HTTP proxy (local dev) */
106
+ __NOSAM_TOKEN?: string;
107
+ /** @internal Project ID for HTTP proxy (local dev) */
108
+ __NOSAM_PROJECT_ID?: string;
109
+ /** @internal Staging environment flag */
110
+ __NOSAM_STAGING?: string;
111
+ /** @internal Project ID (service binding path) */
112
+ __PROJECT_ID?: string;
113
+ /** @internal Proxy token (service binding path) */
114
+ __NOSAM_PROXY_TOKEN?: string;
115
+ [key: `QUEUE_${string}`]: Queue<unknown> | undefined;
116
+ }
117
+ }
118
+ }
119
+ export { _getSchemaDefaults as a, defineEnv as c, _getRegisteredSchema as i, env as l, EnvValidationReport as n, _hasRegisteredSchema as o, ValidatedEnv as r, _validateEnvOnce as s, EnvValidationError as t, validateAllEnv as u };
@@ -0,0 +1,41 @@
1
+ import { AsyncLocalStorage } from "node:async_hooks";
2
+ // src/runtime/env-raw.ts
3
+ /**
4
+ * Raw runtime env resolution — framework-internal only.
5
+ *
6
+ * This module is NOT exported in package.json, so it cannot be imported
7
+ * via "@builtbyfriends/bwf/..." subpaths. Only framework modules can import it by relative path.
8
+ */
9
+ /** Prefixes for platform-internal bindings that must be hidden from user code. */
10
+ const INTERNAL_BINDING_PREFIXES = ["__NOSAM_", "__PROJECT_"];
11
+ /**
12
+ * One process or isolate can evaluate this module more than once: Vite's SSR module
13
+ * runner keeps its own copy beside a package it leaves external, and a dependency
14
+ * optimizer reload re-evaluates it while a request is in flight. Every copy must read
15
+ * the env of the current request, so the store lives on `globalThis`, like
16
+ * `authContext`. Two bwf versions in one process share it: change the key when the
17
+ * store shape changes.
18
+ */
19
+ const ENV_CONTEXT_SYMBOL = Symbol.for("bwf.envContext.v1");
20
+ const shared = globalThis;
21
+ shared[ENV_CONTEXT_SYMBOL] ??= new AsyncLocalStorage();
22
+ const envContext = shared[ENV_CONTEXT_SYMBOL];
23
+ let cloudflareEnv;
24
+ if (typeof navigator !== "undefined" && navigator.userAgent === "Cloudflare-Workers") import("cloudflare:workers").then((mod) => {
25
+ cloudflareEnv = asEnv(mod.env) ?? void 0;
26
+ }).catch(() => {});
27
+ function asEnv(value) {
28
+ if (typeof value !== "object" || value === null) return null;
29
+ if ("then" in value && typeof value.then === "function") return null;
30
+ return value;
31
+ }
32
+ function getGlobalEnv() {
33
+ return asEnv(globalThis.__env__);
34
+ }
35
+ /** Resolve raw env from AsyncLocalStorage, the ambient `globalThis.__env__`, or CF module env. */
36
+ function getRawRuntimeEnv() {
37
+ return envContext.getStore() ?? getGlobalEnv() ?? cloudflareEnv ?? (() => {
38
+ throw new Error("env: Cloudflare env is unavailable. Use void runtime bindings inside Worker handlers.");
39
+ })();
40
+ }
41
+ export { getRawRuntimeEnv as i, asEnv as n, envContext as r, INTERNAL_BINDING_PREFIXES as t };
@@ -0,0 +1,56 @@
1
+ import { s as relative } from "./dist-DMYe8CZJ.mjs";
2
+ import { r as bwfWarn } from "./log-JDnPc0cF.mjs";
3
+ import { n as readProjectPaths } from "./project-paths-iXHKRTTQ.mjs";
4
+ import { existsSync } from "node:fs";
5
+ // src/codegen/env-types.ts
6
+ /** Roots already warned about duplicate env.ts files — dedupes noisy repeat calls. */
7
+ const warnedRoots = /* @__PURE__ */ new Set();
8
+ /** Find the user's env schema file, if any. Warns once per root when multiple candidates exist. */
9
+ function findEnvFile(root) {
10
+ return findEnvFileForPaths(root, readProjectPaths(root));
11
+ }
12
+ function findEnvFileForPaths(root, paths) {
13
+ const matches = [];
14
+ for (const absPath of paths.envFileCandidates) if (existsSync(absPath)) matches.push(absPath);
15
+ if (matches.length > 1 && !warnedRoots.has(root)) {
16
+ warnedRoots.add(root);
17
+ const rel = matches.map((m) => relative(root, m));
18
+ bwfWarn(`Multiple env schema files found — using "${rel[0]}" and ignoring ${rel.slice(1).map((r) => `"${r}"`).join(", ")}. Keep just one.`);
19
+ }
20
+ return matches[0] ?? null;
21
+ }
22
+ /**
23
+ * Generate `.bwf/env.d.ts` content. Augments:
24
+ * - `@builtbyfriends/bwf/env`'s `ValidatedEnv` so `env.X` is typed
25
+ * - `@builtbyfriends/bwf/handler`'s `CloudBindings` so `c.env.X` is typed
26
+ *
27
+ * Uses `typeof import(...)` on the env schema file so TypeScript handles the
28
+ * inference — codegen never analyses types itself.
29
+ *
30
+ * @param envFileAbs Absolute path to the user's env schema file.
31
+ * @param outDir Absolute path to the project's `.bwf/` directory.
32
+ */
33
+ function generateEnvTypes(envFileAbs, outDir) {
34
+ const importPath = relative(outDir, envFileAbs);
35
+ const lines = [];
36
+ lines.push("// Auto-generated by void — do not edit");
37
+ lines.push("export {}");
38
+ lines.push("");
39
+ lines.push(`type _NosamEnvSchema = typeof import("${importPath}");`);
40
+ lines.push("type _NosamEnvShape = _NosamEnvSchema extends { default: infer D } ? D : _NosamEnvSchema extends { env: infer E } ? E : {};");
41
+ lines.push("");
42
+ lines.push("declare module \"@builtbyfriends/bwf/env\" {");
43
+ lines.push(" interface ValidatedEnv extends _NosamEnvShape {}");
44
+ lines.push("}");
45
+ lines.push("");
46
+ lines.push("declare global {");
47
+ lines.push(" interface BwfGeneratedEnvBindings extends _NosamEnvShape {}");
48
+ lines.push("}");
49
+ lines.push("");
50
+ lines.push("declare module \"@builtbyfriends/bwf/handler\" {");
51
+ lines.push(" interface CloudBindings extends _NosamEnvShape {}");
52
+ lines.push("}");
53
+ lines.push("");
54
+ return { dts: lines.join("\n") };
55
+ }
56
+ export { findEnvFileForPaths as n, generateEnvTypes as r, findEnvFile as t };
@@ -0,0 +1 @@
1
+ export { r as SelfHostSchemaError, a as computeInvalidEmittedKeys, c as deriveSelfHostSchemaFacts, p as readEmittedWorkerVars } from "./env-validation-DeqFUSKg.mjs";