@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.
- package/AGENTS_TEMPLATE.md +4 -0
- package/LICENSE +22 -0
- package/README.md +48 -2
- package/dist/account-cmd-Cj0I2_bJ.mjs +45 -0
- package/dist/agents-BLiMq9E1.mjs +113 -0
- package/dist/application-analysis-C9Ck2Yeg.mjs +1498 -0
- package/dist/application-routing-DbR-W5lG.mjs +25 -0
- package/dist/atomic-write-DA6eD1Kp.mjs +17 -0
- package/dist/auth-BKsUmWbT.d.mts +77 -0
- package/dist/auth-DkvoW5hB.mjs +33 -0
- package/dist/auth-aKyIWkdS.mjs +1 -0
- package/dist/auth-client-6-Ft9i9T.d.mts +5 -0
- package/dist/auth-client-DwCdwKbw.mjs +5 -0
- package/dist/auth-client-react-CJdeErvM.mjs +5 -0
- package/dist/auth-client-react-DvQLe5Zb.d.mts +5 -0
- package/dist/auth-link-D-DddkCQ.mjs +26 -0
- package/dist/auth-migrations-DDeifS3v.mjs +206 -0
- package/dist/auth-router-tWzIwf8f.mjs +66 -0
- package/dist/auth-xnkmpZUl.mjs +311 -0
- package/dist/base64-ikl9yBy3.mjs +15 -0
- package/dist/better-auth-shared-Br6TNaYJ.mjs +473 -0
- package/dist/better-auth-shared-CsBNvPOU.d.mts +56 -0
- package/dist/build-cmd-BnZezraT.mjs +153 -0
- package/dist/build-output-dir-Clj_unKN.mjs +402 -0
- package/dist/cancel-deploy-DKAj5U1Z.mjs +57 -0
- package/dist/cf-access-Bhz9wX6p.mjs +131 -0
- package/dist/cf-access-CUP5L08W.mjs +67 -0
- package/dist/cf-build-output-DA6uJomQ.mjs +1 -0
- package/dist/cf-build-output-DNQTwMNU.mjs +438 -0
- package/dist/cf-command-values-2kOtxMo1.mjs +26 -0
- package/dist/cf-config-migrate-COOCi4Ge.mjs +330 -0
- package/dist/cf-worker-settings-CIh4t_yG.mjs +41 -0
- package/dist/cli/cli.d.mts +1 -0
- package/dist/cli/cli.mjs +88 -0
- package/dist/cli/cloudflare-operation-process.d.mts +1 -0
- package/dist/cli/cloudflare-operation-process.mjs +1284 -0
- package/dist/cli/env-schema-probe.d.mts +43 -0
- package/dist/cli/env-schema-probe.mjs +165 -0
- package/dist/cli-main-HeXRQml6.mjs +1846 -0
- package/dist/client-D3D5RM5h.mjs +940 -0
- package/dist/client-VF2Nzc7Z.mjs +1 -0
- package/dist/cloudflare-auth-jb-1e43r.mjs +152 -0
- package/dist/cloudflare-cmd-B62t8Fm-.mjs +59 -0
- package/dist/cloudflare-config-i8yanry0.mjs +186 -0
- package/dist/cloudflare-connect-x7IsYghw.mjs +55 -0
- package/dist/cloudflare-operations-BeK7bhnP.mjs +627 -0
- package/dist/cloudflare-operations-C3Uu0Emj.mjs +1 -0
- package/dist/cloudflare-process-Cc6oiJqk.mjs +309 -0
- package/dist/cloudflare-user-output-CqONaAbP.mjs +19 -0
- package/dist/collect-8i0wU63d.mjs +1 -0
- package/dist/collect-C6Blu9yw.mjs +48 -0
- package/dist/config-CN_RFRkS.mjs +86 -0
- package/dist/config-D5G-Tx6o.mjs +1 -0
- package/dist/config-DOaFIK3w.mjs +88 -0
- package/dist/config-entry.d.mts +202 -0
- package/dist/config-entry.mjs +6 -0
- package/dist/config-tNx0HlFv.mjs +516 -0
- package/dist/connect-hLPNppu3.mjs +84 -0
- package/dist/create-project-B35ux-LA.mjs +126 -0
- package/dist/create-project-tJ1KwNss.mjs +1 -0
- package/dist/database-provider-DkZo4VwN.mjs +5 -0
- package/dist/database-provider.d.mts +25 -0
- package/dist/database-provider.mjs +1 -0
- package/dist/db-BH_md90k.mjs +1735 -0
- package/dist/delete-BSKI7V23.mjs +65 -0
- package/dist/deploy-C8KHBNsh.mjs +6512 -0
- package/dist/deploy-DCZBr7Ey.mjs +2 -0
- package/dist/deploy.d.mts +31 -0
- package/dist/deploy.mjs +118 -0
- package/dist/dev-inbox-I0nqTCdf.mjs +216 -0
- package/dist/discover-DJPmQcL5.mjs +36 -0
- package/dist/discover-EVuydEoM.mjs +1 -0
- package/dist/dist-B6eN80gc.mjs +1612 -0
- package/dist/dist-Cp4b1_T9.mjs +1 -0
- package/dist/dist-DMYe8CZJ.mjs +48 -0
- package/dist/dist-STQXl8ck.mjs +1878 -0
- package/dist/domain-C4ZhEiFG.mjs +149 -0
- package/dist/dotenv-4NdUCXbB.mjs +156 -0
- package/dist/drizzle-DqVFXtlc.mjs +306 -0
- package/dist/drizzle-Ds5P0n-S.mjs +1 -0
- package/dist/edge.d.mts +2 -0
- package/dist/edge.mjs +1 -0
- package/dist/email-B3TWga7x.mjs +742 -0
- package/dist/email-C_ATvNIG.mjs +2865 -0
- package/dist/email-cloudflare-DuAc9zny.mjs +854 -0
- package/dist/email-protocol-CZ0bAkI8.mjs +81 -0
- package/dist/env-CTAo8ifZ.mjs +73 -0
- package/dist/env-DUyTzroe.mjs +88 -0
- package/dist/env-Dl4Wggec.mjs +71 -0
- package/dist/env-helpers-BX0APszT.mjs +135 -0
- package/dist/env-helpers-U56xuFgL.d.mts +20 -0
- package/dist/env-mask-BsHxq3R8.mjs +46 -0
- package/dist/env-public-Cw_xPi1D.d.mts +119 -0
- package/dist/env-raw-Bo6TtrHU.mjs +41 -0
- package/dist/env-types-Bg-dTh8u.mjs +56 -0
- package/dist/env-validation-BufZConV.mjs +488 -0
- package/dist/env-validation-DPqDo4DU.mjs +1 -0
- package/dist/fetch-CBgyyhzm.d.mts +87 -0
- package/dist/fetch-error-DmlRM6e4.mjs +264 -0
- package/dist/fetch-stream-2GUN3YN1.mjs +102 -0
- package/dist/fetch-stream-bUXynOyZ.d.mts +32 -0
- package/dist/fetch-tpPiSK10.mjs +25 -0
- package/dist/gen-dc13IRXh.mjs +509 -0
- package/dist/gen-kQqhFyOP.mjs +1 -0
- package/dist/generate-BgtlYpKg.mjs +1 -0
- package/dist/generate-Da9mWKzU.mjs +80 -0
- package/dist/generated-wrangler-config-CoDaaFsA.mjs +17 -0
- package/dist/git-metadata-Cukp5kV5.mjs +82 -0
- package/dist/github-cmd-DT5Onu6E.mjs +690 -0
- package/dist/handler-CJ7DiiRF.mjs +161 -0
- package/dist/handler-CVsIfRv7.d.mts +279 -0
- package/dist/help-Bpv6Qeqn.mjs +1946 -0
- package/dist/help-CfZ4Bsw5.mjs +1 -0
- package/dist/inbound-CqubE-9T.d.mts +311 -0
- package/dist/inbound-lHugZPuK.mjs +509 -0
- package/dist/index.d.mts +64 -0
- package/dist/index.mjs +4163 -0
- package/dist/info-CLQoCenb.mjs +109 -0
- package/dist/init-DRUR0j8C.mjs +2486 -0
- package/dist/limits-CMmYT2l8.d.mts +16 -0
- package/dist/limits-D27Lp6FP.mjs +46 -0
- package/dist/link-DinwJnon.mjs +52 -0
- package/dist/list-B84t4BhW.mjs +130 -0
- package/dist/live-Dui0-aj_.d.mts +105 -0
- package/dist/live-saC8barp.mjs +410 -0
- package/dist/load-user-env-g0ahkZcj.mjs +34 -0
- package/dist/local-d1-C3EeOV7-.mjs +103 -0
- package/dist/log-JDnPc0cF.mjs +23 -0
- package/dist/login-Bl5lH8nH.mjs +87 -0
- package/dist/login-DoI7AsbY.mjs +1 -0
- package/dist/logs-CaT2N2f7.mjs +129 -0
- package/dist/migrate-CbGscX-V.mjs +125 -0
- package/dist/migrate-Ce3JKLVs.mjs +1 -0
- package/dist/migration-handler-22qiuWPq.mjs +469 -0
- package/dist/migration-handler-Bb2BJh6g.d.mts +38 -0
- package/dist/mime-BMUN_QKG.mjs +1004 -0
- package/dist/mysql-migration-sql-CNuBSqdx.mjs +239 -0
- package/dist/neon-CJzQSycr.mjs +52 -0
- package/dist/node-tfv-3v0V.mjs +64 -0
- package/dist/operator-ai-logging-Ay7M4KWw.mjs +121 -0
- package/dist/operator-args-BFg32YyY.mjs +722 -0
- package/dist/operator-auth-DdYZYEkO.mjs +47 -0
- package/dist/operator-client-DBujdELO.mjs +82 -0
- package/dist/operator-cmd-C73WWJBl.mjs +443 -0
- package/dist/operator-cmd-CdZytuAF.mjs +1 -0
- package/dist/output-Bb34lF0w.mjs +173 -0
- package/dist/output-CVolXKC1.mjs +1 -0
- package/dist/package-DO4d3Qz5.mjs +1444 -0
- package/dist/package-json-DvS6IFRv.mjs +43 -0
- package/dist/pg-DoyPxa_X.mjs +15 -0
- package/dist/picocolors-D1NxSLw-.mjs +71 -0
- package/dist/plan-BHNt1QhK.mjs +1 -0
- package/dist/plan-DX4_-OM5.mjs +58 -0
- package/dist/platform-args-NI_vfWvD.mjs +538 -0
- package/dist/platform-args-ZC1-A1N9.mjs +1 -0
- package/dist/platform-auth-config-d-lY5-aY.mjs +371 -0
- package/dist/platform-auth-protection-Dhw7lUCk.mjs +231 -0
- package/dist/platform-auth-recovery-DaCc0tlx.mjs +309 -0
- package/dist/platform-cmd-5Ry-C9im.mjs +193 -0
- package/dist/platform-cmd-5oZq91lI.mjs +1 -0
- package/dist/platform-discovery-Bxg9aZXU.mjs +40 -0
- package/dist/platform-domain-DLVdGvGG.mjs +256 -0
- package/dist/platform-lifecycle-CUgjipXO.mjs +1 -0
- package/dist/platform-lifecycle-fRt5VMls.mjs +8928 -0
- package/dist/platform-management-5hEsRfR2.mjs +1 -0
- package/dist/platform-management-Djh1hzLP.mjs +1607 -0
- package/dist/platform-plans-config-CkbUKFpm.mjs +447 -0
- package/dist/platform-recovery-Cghx7FCR.mjs +96 -0
- package/dist/platform-registry-x1m9HBxf.mjs +450 -0
- package/dist/platform-runtime-logs-kkoiYFpF.mjs +72 -0
- package/dist/platform-setup-SfwCwnZg.mjs +306 -0
- package/dist/prepare-B9mB47T5.mjs +84 -0
- package/dist/prepare-DNIq07so.mjs +13 -0
- package/dist/prepare-LHkyJqxi.mjs +1 -0
- package/dist/project-CC7eN00D.mjs +141 -0
- package/dist/project-DcSd4BeI.mjs +1 -0
- package/dist/project-cmd-DTF19-fC.mjs +109 -0
- package/dist/project-paths-iXHKRTTQ.mjs +159 -0
- package/dist/project-slug-BUy0lmyR.mjs +1 -0
- package/dist/project-slug-CO6ci9XG.mjs +7 -0
- package/dist/project-team-CvdLhDF2.mjs +129 -0
- package/dist/project-token-CwZdUEGu.mjs +70 -0
- package/dist/project-tsconfig-P9X952KG.mjs +98 -0
- package/dist/project-zero-trust-CKDoPdN1.mjs +64 -0
- package/dist/providers-Cd3c7wi0.mjs +64 -0
- package/dist/providers-Df69hb_X.d.mts +5 -0
- package/dist/provision-DGlFJ3T9.mjs +1 -0
- package/dist/provision-mYVLuQiy.mjs +1814 -0
- package/dist/queues-Bc3FsBQT.d.mts +5 -0
- package/dist/r2-conditions-DSLmkiR5.mjs +60 -0
- package/dist/requests-DNhfyF3l.mjs +52 -0
- package/dist/resolve-project-BCsAMDRA.mjs +47 -0
- package/dist/resolve-project-DhU9_lIo.mjs +1 -0
- package/dist/resource-name-DlJ9QXzg.mjs +10 -0
- package/dist/response-HmNjB30w.mjs +29 -0
- package/dist/rollback-BvCHol52.mjs +150 -0
- package/dist/rolldown-runtime-uD8oG6U2.mjs +24 -0
- package/dist/route-types-CRWhr93D.mjs +592 -0
- package/dist/route-url-BIDZT78M.mjs +58 -0
- package/dist/route-url-Bla3Upsy.d.mts +42 -0
- package/dist/routes-stub.d.mts +24 -0
- package/dist/routes-stub.mjs +1 -0
- package/dist/routing-assets-CSheDWWM.mjs +54 -0
- package/dist/rpc-DcByS_q0.d.mts +39 -0
- package/dist/rpc-DtxIN9Tv.mjs +19 -0
- package/dist/runner-CPerdjIl.mjs +163 -0
- package/dist/runner-CUNtS5x7.mjs +1 -0
- package/dist/runner-mysql-7aA5hGoM.mjs +145 -0
- package/dist/runner-mysql-DrMKw203.mjs +1 -0
- package/dist/runner-pg-2pjltt0t.mjs +1 -0
- package/dist/runner-pg-mYc75KfH.mjs +61 -0
- package/dist/runtime/ai.d.mts +50 -0
- package/dist/runtime/ai.mjs +455 -0
- package/dist/runtime/auth-client-react.d.mts +2 -0
- package/dist/runtime/auth-client-react.mjs +1 -0
- package/dist/runtime/auth-client.d.mts +2 -0
- package/dist/runtime/auth-client.mjs +1 -0
- package/dist/runtime/auth.d.mts +2 -0
- package/dist/runtime/auth.mjs +1 -0
- package/dist/runtime/better-auth-mysql.d.mts +5 -0
- package/dist/runtime/better-auth-mysql.mjs +21 -0
- package/dist/runtime/better-auth-pg.d.mts +5 -0
- package/dist/runtime/better-auth-pg.mjs +21 -0
- package/dist/runtime/better-auth.d.mts +6 -0
- package/dist/runtime/better-auth.mjs +22 -0
- package/dist/runtime/client-react.d.mts +5 -0
- package/dist/runtime/client-react.mjs +5 -0
- package/dist/runtime/client.d.mts +5 -0
- package/dist/runtime/client.mjs +5 -0
- package/dist/runtime/db-mysql.d.mts +2 -0
- package/dist/runtime/db-mysql.mjs +1 -0
- package/dist/runtime/db-pg.d.mts +2 -0
- package/dist/runtime/db-pg.mjs +1 -0
- package/dist/runtime/db.d.mts +17 -0
- package/dist/runtime/db.mjs +36 -0
- package/dist/runtime/drizzle-arktype.d.mts +1 -0
- package/dist/runtime/drizzle-arktype.mjs +2 -0
- package/dist/runtime/drizzle-valibot.d.mts +1 -0
- package/dist/runtime/drizzle-valibot.mjs +2 -0
- package/dist/runtime/drizzle-zod.d.mts +1 -0
- package/dist/runtime/drizzle-zod.mjs +2 -0
- package/dist/runtime/durable.d.mts +64 -0
- package/dist/runtime/durable.mjs +165 -0
- package/dist/runtime/email/testing.d.mts +108 -0
- package/dist/runtime/email/testing.mjs +268 -0
- package/dist/runtime/email-protocol.d.mts +25 -0
- package/dist/runtime/email-protocol.mjs +1 -0
- package/dist/runtime/email.d.mts +26 -0
- package/dist/runtime/email.mjs +524 -0
- package/dist/runtime/env-public-client.d.mts +19 -0
- package/dist/runtime/env-public-client.mjs +55 -0
- package/dist/runtime/env-public.d.mts +4 -0
- package/dist/runtime/env-public.mjs +277 -0
- package/dist/runtime/env.d.mts +12 -0
- package/dist/runtime/env.mjs +1 -0
- package/dist/runtime/fetch-server.d.mts +6 -0
- package/dist/runtime/fetch-server.mjs +29 -0
- package/dist/runtime/fetch-stream.d.mts +3 -0
- package/dist/runtime/fetch-stream.mjs +3 -0
- package/dist/runtime/fetch.d.mts +2 -0
- package/dist/runtime/fetch.mjs +3 -0
- package/dist/runtime/handler.d.mts +3 -0
- package/dist/runtime/handler.mjs +1 -0
- package/dist/runtime/kv.d.mts +45 -0
- package/dist/runtime/kv.mjs +103 -0
- package/dist/runtime/limits.d.mts +2 -0
- package/dist/runtime/limits.mjs +1 -0
- package/dist/runtime/live-client.d.mts +40 -0
- package/dist/runtime/live-client.mjs +282 -0
- package/dist/runtime/live-server.d.mts +11 -0
- package/dist/runtime/live-server.mjs +419 -0
- package/dist/runtime/live.d.mts +3 -0
- package/dist/runtime/live.mjs +1 -0
- package/dist/runtime/log.d.mts +24 -0
- package/dist/runtime/log.mjs +57 -0
- package/dist/runtime/migration-handler-mysql.d.mts +2 -0
- package/dist/runtime/migration-handler-mysql.mjs +111 -0
- package/dist/runtime/migration-handler-pg.d.mts +2 -0
- package/dist/runtime/migration-handler-pg.mjs +94 -0
- package/dist/runtime/migration-handler.d.mts +2 -0
- package/dist/runtime/migration-handler.mjs +1 -0
- package/dist/runtime/procedure.d.mts +27 -0
- package/dist/runtime/procedure.mjs +36 -0
- package/dist/runtime/procedures.d.mts +24 -0
- package/dist/runtime/procedures.mjs +56 -0
- package/dist/runtime/queues.d.mts +2 -0
- package/dist/runtime/queues.mjs +8 -0
- package/dist/runtime/remote/binding-handler.d.mts +11 -0
- package/dist/runtime/remote/binding-handler.mjs +227 -0
- package/dist/runtime/remote/index.d.mts +12 -0
- package/dist/runtime/remote/index.mjs +467 -0
- package/dist/runtime/response.d.mts +11 -0
- package/dist/runtime/response.mjs +1 -0
- package/dist/runtime/route-url.d.mts +2 -0
- package/dist/runtime/route-url.mjs +1 -0
- package/dist/runtime/routing.d.mts +53 -0
- package/dist/runtime/routing.mjs +425 -0
- package/dist/runtime/rpc-react.d.mts +16 -0
- package/dist/runtime/rpc-react.mjs +50 -0
- package/dist/runtime/rpc.d.mts +2 -0
- package/dist/runtime/rpc.mjs +1 -0
- package/dist/runtime/sandbox-container.d.mts +3 -0
- package/dist/runtime/sandbox-container.mjs +1 -0
- package/dist/runtime/sandbox.d.mts +5 -0
- package/dist/runtime/sandbox.mjs +196 -0
- package/dist/runtime/schema-d1.d.mts +1 -0
- package/dist/runtime/schema-d1.mjs +2 -0
- package/dist/runtime/schema-mysql.d.mts +1 -0
- package/dist/runtime/schema-mysql.mjs +2 -0
- package/dist/runtime/schema-pg.d.mts +1 -0
- package/dist/runtime/schema-pg.mjs +2 -0
- package/dist/runtime/seed.d.mts +34 -0
- package/dist/runtime/seed.mjs +5 -0
- package/dist/runtime/sse-client.d.mts +31 -0
- package/dist/runtime/sse-client.mjs +42 -0
- package/dist/runtime/sse.d.mts +32 -0
- package/dist/runtime/sse.mjs +1 -0
- package/dist/runtime/storage.d.mts +4 -0
- package/dist/runtime/storage.mjs +13 -0
- package/dist/runtime/validator.d.mts +2 -0
- package/dist/runtime/validator.mjs +1 -0
- package/dist/runtime/ws-server.d.mts +26 -0
- package/dist/runtime/ws-server.mjs +297 -0
- package/dist/runtime/ws.d.mts +2 -0
- package/dist/runtime/ws.mjs +108 -0
- package/dist/sandbox-CWDjoEG2.d.mts +50 -0
- package/dist/sandbox-container-BqamdFCx.d.mts +73 -0
- package/dist/sandbox-container-d1AHLpgn.mjs +291 -0
- package/dist/secret-DCF9RXTc.mjs +146 -0
- package/dist/skills-Dr3AjuBF.mjs +63 -0
- package/dist/sqlite-validation-CLJXXN93.mjs +24 -0
- package/dist/sse-CxR30yMF.mjs +174 -0
- package/dist/standard-schema-CuDawHOC.d.mts +40 -0
- package/dist/static-asset-marker-mWMX2dLa.mjs +38 -0
- package/dist/subcommand-prompt-B9yUo--u.mjs +370 -0
- package/dist/terminal-log-text-DNsWJREL.mjs +31 -0
- package/dist/types-D7-4tBu7.d.mts +1 -0
- package/dist/untrusted-env-lL7RkYiC.mjs +50 -0
- package/dist/validate-B-zsjhiz.mjs +162 -0
- package/dist/validate-DbqGdPPY.mjs +1 -0
- package/dist/validator-8-NZs2Xr.mjs +168 -0
- package/dist/version-metadata-DsSoNsKJ.mjs +23 -0
- package/dist/wrangler-DU784Dkf.mjs +1452 -0
- package/dist/wrangler-Rr9_76DQ.mjs +1 -0
- package/dist/ws-Q_osq9VK.d.mts +137 -0
- package/dist/yarn-pnp-DgWbE7z5.mjs +91 -0
- package/docs/guide/ai.md +273 -0
- package/docs/guide/app-types.md +101 -0
- package/docs/guide/auth.md +255 -0
- package/docs/guide/database/d1.md +86 -0
- package/docs/guide/database/mysql.md +72 -0
- package/docs/guide/database/postgresql.md +94 -0
- package/docs/guide/database.md +454 -0
- package/docs/guide/deployment.md +124 -0
- package/docs/guide/durable-state.md +192 -0
- package/docs/guide/edge/headers.md +47 -0
- package/docs/guide/edge/redirects.md +85 -0
- package/docs/guide/edge/rewrites.md +119 -0
- package/docs/guide/edge/static-assets.md +94 -0
- package/docs/guide/email/domains.md +119 -0
- package/docs/guide/email/receiving.md +142 -0
- package/docs/guide/email/sending.md +262 -0
- package/docs/guide/email.md +23 -0
- package/docs/guide/env-vars.md +115 -0
- package/docs/guide/index.md +37 -0
- package/docs/guide/jobs.md +80 -0
- package/docs/guide/kv.md +100 -0
- package/docs/guide/live.md +181 -0
- package/docs/guide/platform/administration/access.md +165 -0
- package/docs/guide/platform/administration/connected-apps.md +84 -0
- package/docs/guide/platform/administration/email.md +169 -0
- package/docs/guide/platform/administration/operations.md +100 -0
- package/docs/guide/platform/administration/plans.md +156 -0
- package/docs/guide/platform/administration/projects.md +74 -0
- package/docs/guide/platform/administration/zero-trust.md +205 -0
- package/docs/guide/platform/development/local.md +122 -0
- package/docs/guide/platform/development/runtime.md +115 -0
- package/docs/guide/platform/development/schema-ci.md +44 -0
- package/docs/guide/platform/installation/ci.md +62 -0
- package/docs/guide/platform/installation/credentials.md +140 -0
- package/docs/guide/platform/installation/domains.md +120 -0
- package/docs/guide/platform/installation/first-deployment.md +95 -0
- package/docs/guide/platform/installation/maintenance.md +250 -0
- package/docs/guide/platform/installation/prerequisites.md +176 -0
- package/docs/guide/platform/installation/setup.md +300 -0
- package/docs/guide/platform/installation/uninstall.md +110 -0
- package/docs/guide/platform-administration.md +19 -0
- package/docs/guide/platform-development.md +16 -0
- package/docs/guide/procedures.md +48 -0
- package/docs/guide/project-collaboration.md +99 -0
- package/docs/guide/queues.md +149 -0
- package/docs/guide/quickstart.md +129 -0
- package/docs/guide/remote-dev.md +67 -0
- package/docs/guide/sandboxes.md +134 -0
- package/docs/guide/self-hosted-platform.md +45 -0
- package/docs/guide/server-routing.md +283 -0
- package/docs/guide/sse.md +174 -0
- package/docs/guide/storage.md +82 -0
- package/docs/guide/testing.md +64 -0
- package/docs/guide/type-safety.md +270 -0
- package/docs/guide/typed-fetch.md +98 -0
- package/docs/guide/websockets.md +230 -0
- package/docs/index.md +102 -0
- package/docs/integrations/agents.md +38 -0
- package/docs/integrations/cloudflare.md +241 -0
- package/docs/integrations/hono.md +127 -0
- package/docs/reference/api/auth.md +195 -0
- package/docs/reference/api/client.md +90 -0
- package/docs/reference/api/database.md +118 -0
- package/docs/reference/api/deploy.md +63 -0
- package/docs/reference/api/durable.md +47 -0
- package/docs/reference/api/env.md +51 -0
- package/docs/reference/api/handlers.md +189 -0
- package/docs/reference/api/plugin.md +40 -0
- package/docs/reference/api/resources.md +116 -0
- package/docs/reference/api/rewrites.md +111 -0
- package/docs/reference/api/types.md +126 -0
- package/docs/reference/api.md +71 -0
- package/docs/reference/cli/auth.md +87 -0
- package/docs/reference/cli/database.md +159 -0
- package/docs/reference/cli/deploy.md +117 -0
- package/docs/reference/cli/domains.md +42 -0
- package/docs/reference/cli/email.md +145 -0
- package/docs/reference/cli/generate.md +113 -0
- package/docs/reference/cli/github.md +181 -0
- package/docs/reference/cli/platform-config.md +93 -0
- package/docs/reference/cli/platform-email.md +81 -0
- package/docs/reference/cli/platform-installation.md +166 -0
- package/docs/reference/cli/platform-operations.md +90 -0
- package/docs/reference/cli/platform-users.md +159 -0
- package/docs/reference/cli/platform-zero-trust.md +60 -0
- package/docs/reference/cli/platform.md +78 -0
- package/docs/reference/cli/project.md +208 -0
- package/docs/reference/cli/secrets.md +79 -0
- package/docs/reference/cli/setup.md +88 -0
- package/docs/reference/cli.md +115 -0
- package/docs/reference/config.md +478 -0
- package/docs/reference/resource-inference.md +72 -0
- package/docs/reference/structure.md +138 -0
- package/package.json +389 -3
- package/sandbox.Dockerfile +4 -0
- package/schema.json +353 -0
- package/skills/bwf/SKILL.md +100 -0
- package/skills/migrate-vite-cloudflare-to-bwf/SKILL.md +53 -0
- package/templates/assets/bwf.svg +5 -0
- package/templates/assets/icons.svg +49 -0
- package/templates/assets/react.svg +1 -0
- 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 };
|