@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.
- package/AGENTS_TEMPLATE.md +4 -0
- package/LICENSE +22 -0
- package/README.md +48 -2
- package/dist/account-cmd-Ddt8lGeL.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-CCl-hJol.mjs +26 -0
- package/dist/auth-migrations-DDeifS3v.mjs +206 -0
- package/dist/auth-router-BG74WFUf.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-BfYf6fnB.mjs +1846 -0
- package/dist/client-D3D5RM5h.mjs +940 -0
- package/dist/client-VF2Nzc7Z.mjs +1 -0
- package/dist/cloudflare-auth-DzkU9H6r.mjs +152 -0
- package/dist/cloudflare-cmd-Bm6UhzAQ.mjs +59 -0
- package/dist/cloudflare-config-i8yanry0.mjs +186 -0
- package/dist/cloudflare-connect-B4ItSbJi.mjs +55 -0
- package/dist/cloudflare-operations-BcK849ue.mjs +1 -0
- package/dist/cloudflare-operations-DGF7xH7O.mjs +627 -0
- package/dist/cloudflare-process-tThIjEB2.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-CSNWKLzB.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-SOv4E9wr.mjs +1735 -0
- package/dist/delete-BSKI7V23.mjs +65 -0
- package/dist/deploy-BCSQoKC0.mjs +2 -0
- package/dist/deploy-CWJ3JJs_.mjs +6512 -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-BJaAbxuQ.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-C_ATvNIG.mjs +2865 -0
- package/dist/email-cloudflare-oXk2G1G3.mjs +854 -0
- package/dist/email-protocol-CZ0bAkI8.mjs +81 -0
- package/dist/email-rIfZgVAB.mjs +742 -0
- package/dist/env-BGTu3KWZ.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-BlXzGgLZ.mjs +1 -0
- package/dist/env-validation-DeqFUSKg.mjs +488 -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-B_ocHStk.d.mts +279 -0
- package/dist/handler-CNq7aSs1.mjs +161 -0
- package/dist/help-BK35YcRa.mjs +1946 -0
- package/dist/help-DaRezBj7.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-CXanf5ck.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-B1WAE9Wt.mjs +130 -0
- package/dist/live-KkEeda1Z.d.mts +105 -0
- package/dist/live-saC8barp.mjs +410 -0
- package/dist/load-user-env-g0ahkZcj.mjs +34 -0
- package/dist/local-d1-bUoAtFUe.mjs +103 -0
- package/dist/log-JDnPc0cF.mjs +23 -0
- package/dist/login-BUzyiyHV.mjs +1 -0
- package/dist/login-Dbv_T3Ru.mjs +87 -0
- package/dist/logs-BjMJooJQ.mjs +129 -0
- package/dist/migrate-DjW9_-sS.mjs +1 -0
- package/dist/migrate-DtcfKqPW.mjs +125 -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-BiGmSlZx.mjs +722 -0
- package/dist/operator-auth-DdYZYEkO.mjs +47 -0
- package/dist/operator-client-DBujdELO.mjs +82 -0
- package/dist/operator-cmd-BsHKYJYt.mjs +1 -0
- package/dist/operator-cmd-DTIkOAnP.mjs +443 -0
- package/dist/output-Bb34lF0w.mjs +173 -0
- package/dist/output-CVolXKC1.mjs +1 -0
- package/dist/package-BX_giUBX.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-C-DyuCNX.mjs +1 -0
- package/dist/platform-args-CyeQWaZ7.mjs +538 -0
- package/dist/platform-auth-config-BfXqKSyZ.mjs +371 -0
- package/dist/platform-auth-protection-5FR6qoP_.mjs +231 -0
- package/dist/platform-auth-recovery-B5ZlqA8K.mjs +309 -0
- package/dist/platform-cmd-CcFDxtrl.mjs +1 -0
- package/dist/platform-cmd-ChXeBrRH.mjs +193 -0
- package/dist/platform-discovery-Bxg9aZXU.mjs +40 -0
- package/dist/platform-domain-CwatS3cz.mjs +256 -0
- package/dist/platform-lifecycle-0cXTmMsh.mjs +8928 -0
- package/dist/platform-lifecycle-BcoBAMux.mjs +1 -0
- package/dist/platform-management-6Wbdbob5.mjs +1607 -0
- package/dist/platform-management-hhnczOzr.mjs +1 -0
- package/dist/platform-plans-config-CkbUKFpm.mjs +447 -0
- package/dist/platform-recovery-DgIwlqB-.mjs +96 -0
- package/dist/platform-registry-x1m9HBxf.mjs +450 -0
- package/dist/platform-runtime-logs-kkoiYFpF.mjs +72 -0
- package/dist/platform-setup-DX8y_6Kh.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-BydRwr-x.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-BA59NCPO.mjs +1 -0
- package/dist/provision-C90fULHJ.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-wi6WK5T6.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-BjSoQ-mW.mjs +1 -0
- package/dist/runner-mysql-BmTI2EiF.mjs +145 -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-D5XrWshs.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-DPhqnpaa.mjs +23 -0
- package/dist/wrangler-C3uyPadQ.mjs +1 -0
- package/dist/wrangler-TqTvJFWS.mjs +1452 -0
- package/dist/ws-DZRiIpYw.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
package/docs/index.md
ADDED
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 'Build with Vite and deploy with bwf: a CLI, platform, and full-stack SDK for apps on Cloudflare.'
|
|
3
|
+
layout: home
|
|
4
|
+
theme: dark
|
|
5
|
+
|
|
6
|
+
hero:
|
|
7
|
+
name: bwf
|
|
8
|
+
text: Build with Vite. Deploy with bwf.
|
|
9
|
+
tagline: bwf is a CLI, platform, and full-stack SDK that unifies building & deploying apps.
|
|
10
|
+
actions:
|
|
11
|
+
- theme: brand
|
|
12
|
+
text: Get Started
|
|
13
|
+
link: ./guide/
|
|
14
|
+
- theme: alt
|
|
15
|
+
text: View on GitHub
|
|
16
|
+
link: https://github.com/voidzero-dev/void
|
|
17
|
+
- theme: alt
|
|
18
|
+
text: Read the Announcement
|
|
19
|
+
link: https://blog.cloudflare.com/deploy-with-nosam
|
|
20
|
+
features:
|
|
21
|
+
- iconify: lucide:layers
|
|
22
|
+
visual: stack
|
|
23
|
+
title: Full-Stack, Inferred
|
|
24
|
+
details: Import what you need. bwf provides local resources and provisions them on deploy.
|
|
25
|
+
highlights:
|
|
26
|
+
- Server routes and authentication
|
|
27
|
+
- Databases, storage, and AI
|
|
28
|
+
- Queues and scheduled jobs
|
|
29
|
+
guide:
|
|
30
|
+
text: Explore the SDK
|
|
31
|
+
link: /guide/
|
|
32
|
+
- iconify: lucide:wand-sparkles
|
|
33
|
+
visual: resources
|
|
34
|
+
title: Typed from Database to UI
|
|
35
|
+
details: Share types across your database, API routes, and React components.
|
|
36
|
+
highlights:
|
|
37
|
+
- Types from your database schema
|
|
38
|
+
- Typed API routes and fetch client
|
|
39
|
+
- Server code stays on the server
|
|
40
|
+
guide:
|
|
41
|
+
text: Explore Type Safety
|
|
42
|
+
link: /guide/type-safety
|
|
43
|
+
- iconify: lucide:blocks
|
|
44
|
+
visual: frameworks
|
|
45
|
+
title: React SPAs with a Backend
|
|
46
|
+
details: Build a React single-page app and add server routes when you need them.
|
|
47
|
+
highlights:
|
|
48
|
+
- React SPA built and served by Vite
|
|
49
|
+
- Optional API routes, middleware, and jobs
|
|
50
|
+
- Deploy static SPAs and static sites too
|
|
51
|
+
guide:
|
|
52
|
+
text: Explore App Types
|
|
53
|
+
link: /guide/app-types
|
|
54
|
+
platform_features:
|
|
55
|
+
- id: platform-ai-coding
|
|
56
|
+
iconify: lucide:bot
|
|
57
|
+
title: Secure Vibe Coding for Your Team
|
|
58
|
+
details: Let your team build and deploy with coding agents while admins retain control of Cloudflare access.
|
|
59
|
+
highlights:
|
|
60
|
+
- Enable non-technical teammates to build their own apps
|
|
61
|
+
- Keep Cloudflare credentials with your admin team
|
|
62
|
+
- Deploy prototypes fast and share apps for feedback
|
|
63
|
+
guide:
|
|
64
|
+
text: Explore team deployments
|
|
65
|
+
link: /guide/self-hosted-platform
|
|
66
|
+
visual: rive
|
|
67
|
+
image_alt: Animated illustration of apps being built for a team
|
|
68
|
+
- id: platform-control-plane
|
|
69
|
+
iconify: lucide:panels-top-left
|
|
70
|
+
visual: resources
|
|
71
|
+
title: Control Plane for Managing Apps
|
|
72
|
+
details: Manage users, projects, deployments, and platform health from the admin UI or CLI.
|
|
73
|
+
highlights:
|
|
74
|
+
- Manage users and project access & resources
|
|
75
|
+
- Inspect deployments, logs, and rollbacks
|
|
76
|
+
- Monitor platform health and usage
|
|
77
|
+
guide:
|
|
78
|
+
text: Platform administration
|
|
79
|
+
link: /guide/platform-administration
|
|
80
|
+
image_alt: List of bwf platform commands for access, builds, invitations, and administration
|
|
81
|
+
- id: platform-security
|
|
82
|
+
iconify: lucide:shield-check
|
|
83
|
+
title: Bring your Own Security
|
|
84
|
+
details: Fork and customize your own bwf platform based on your team's security standards.
|
|
85
|
+
highlights:
|
|
86
|
+
- Manage access through Cloudflare Access, Google, GitHub, or OIDC
|
|
87
|
+
- Control who can sign in and deploy
|
|
88
|
+
- Protect projects with your access policies
|
|
89
|
+
guide:
|
|
90
|
+
text: Configure platform access
|
|
91
|
+
link: /guide/platform/administration/access
|
|
92
|
+
visual: rive
|
|
93
|
+
image_alt: Animated illustration of self-hosted platform security
|
|
94
|
+
footer_heading: Build with Vite. Deploy with bwf.
|
|
95
|
+
footer_subheading: Server code, resources, and deployment in one workflow.
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
<script setup>
|
|
99
|
+
import Home from './.vitepress/theme/Home.vue'
|
|
100
|
+
</script>
|
|
101
|
+
|
|
102
|
+
<Home />
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "Set up coding agents with bwf init, including project instructions and links to bwf's docs and skills."
|
|
3
|
+
outline: deep
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Using bwf with Coding Agents
|
|
7
|
+
|
|
8
|
+
`bwf init` sets up coding agents as part of project initialization:
|
|
9
|
+
|
|
10
|
+
```sh
|
|
11
|
+
npx bwf init
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
New projects get a minimal `AGENTS.md` explaining bwf and where to read its docs.
|
|
15
|
+
In an existing project, bwf asks before creating, appending to, or updating
|
|
16
|
+
`AGENTS.md`. It preserves your instructions outside the bwf section. Declining
|
|
17
|
+
keeps the file unchanged; CI and non-interactive runs skip changes to existing
|
|
18
|
+
projects' instructions.
|
|
19
|
+
|
|
20
|
+
The complete Markdown docs ship at `node_modules/@builtbyfriends/bwf/docs/`. Start with
|
|
21
|
+
`guide/quickstart.md` for setup and `reference/cli.md` for commands. Agents can
|
|
22
|
+
read them directly, even without a linked skill.
|
|
23
|
+
|
|
24
|
+
## Skills
|
|
25
|
+
|
|
26
|
+
Skills point your agent to the commands and docs it needs for the task. They link to the installed `bwf` package, so the guidance matches the version your app uses.
|
|
27
|
+
|
|
28
|
+
bwf ships two skills:
|
|
29
|
+
|
|
30
|
+
- **`bwf`:** commands and docs for app development.
|
|
31
|
+
- **`migrate-vite-cloudflare-to-nosam`:** migration skill for converting existing `@cloudflare/vite-plugin` apps to bwf.
|
|
32
|
+
|
|
33
|
+
Skills are linked automatically by `bwf init` when it detects a supported
|
|
34
|
+
agent's configuration. For example, Claude Code uses `.claude/skills/` and Codex
|
|
35
|
+
uses `.agents/skills/`. The skills use the app's installed docs so their guidance
|
|
36
|
+
matches its bwf version. Globally installed skills can use the docs in their
|
|
37
|
+
bwf package when there is no local installation. If no agent is detected, the
|
|
38
|
+
instructions still point directly to the bundled docs.
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 'Deploy to Cloudflare Workers. bwf detects the resources your app uses, creates bindings, and publishes the Worker.'
|
|
3
|
+
outline: deep
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Cloudflare
|
|
7
|
+
|
|
8
|
+
bwf runs on Cloudflare Workers. It detects the resources your app uses, creates bindings, and deploys to your account.
|
|
9
|
+
|
|
10
|
+
## Bindings
|
|
11
|
+
|
|
12
|
+
In bwf routes and middleware, use `c.env`:
|
|
13
|
+
|
|
14
|
+
```ts
|
|
15
|
+
// routes/api/users.ts
|
|
16
|
+
import { defineHandler } from '@builtbyfriends/bwf';
|
|
17
|
+
|
|
18
|
+
export const GET = defineHandler(async (c) => {
|
|
19
|
+
const { results } = await c.env.DB.prepare('SELECT * FROM users').all();
|
|
20
|
+
return c.json({ users: results });
|
|
21
|
+
});
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Server code outside a handler can also import bindings from `cloudflare:workers`:
|
|
25
|
+
|
|
26
|
+
```ts
|
|
27
|
+
import { env } from 'cloudflare:workers';
|
|
28
|
+
|
|
29
|
+
const { results } = await env.DB.prepare('SELECT * FROM users').all();
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
### TypeScript setup
|
|
33
|
+
|
|
34
|
+
Add `@builtbyfriends/bwf/env` to your TypeScript types:
|
|
35
|
+
|
|
36
|
+
```json
|
|
37
|
+
{
|
|
38
|
+
"compilerOptions": {
|
|
39
|
+
"types": ["@builtbyfriends/bwf/env"]
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
This provides binding and Workers runtime types. For custom bindings in `bwf.config.ts`, run `bwf prepare` or start the dev server or build to type them on `c.env`. See [Custom Binding Types](../guide/type-safety.md#custom-binding-types) for RPC methods on service and Durable Object bindings.
|
|
45
|
+
|
|
46
|
+
### Available bindings
|
|
47
|
+
|
|
48
|
+
| Binding | Resource | Use in your app |
|
|
49
|
+
| ---------------- | --------------- | ----------------------------------------- |
|
|
50
|
+
| `DB` | D1 | `c.env.DB` or `@builtbyfriends/bwf/db` |
|
|
51
|
+
| `KV` | KV | `c.env.KV` or `@builtbyfriends/bwf/kv` |
|
|
52
|
+
| `STORAGE` | R2 | `c.env.STORAGE` or `@builtbyfriends/bwf/storage` |
|
|
53
|
+
| `AI` | Workers AI | `c.env.AI` or `@builtbyfriends/bwf/ai` |
|
|
54
|
+
| `ASSETS` | Static assets | `c.env.ASSETS.fetch(request)` |
|
|
55
|
+
| `QUEUE_*` | Queues | `defineQueue()` or `@builtbyfriends/bwf/queues` |
|
|
56
|
+
| Filename-derived | Durable Objects | A module in `durable-objects/` |
|
|
57
|
+
|
|
58
|
+
Use [binding configuration](../reference/resource-inference.md#explicit-binding-overrides) when you need to enable, disable, or rename an inferred binding.
|
|
59
|
+
|
|
60
|
+
## Cloudflare Configuration
|
|
61
|
+
|
|
62
|
+
Define Worker settings in `bwf.config.ts`:
|
|
63
|
+
|
|
64
|
+
```ts
|
|
65
|
+
import { defineConfig } from '@builtbyfriends/bwf/config';
|
|
66
|
+
|
|
67
|
+
export default defineConfig({
|
|
68
|
+
worker: {
|
|
69
|
+
compatibility_date: '2026-02-24',
|
|
70
|
+
compatibility_flags: ['nodejs_compat'],
|
|
71
|
+
},
|
|
72
|
+
cloudflare: {
|
|
73
|
+
name: 'my-app',
|
|
74
|
+
services: [{ binding: 'API', service: 'my-api-worker' }],
|
|
75
|
+
},
|
|
76
|
+
});
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
Put binding arrays, resource IDs, routes, and service bindings under `cloudflare`. bwf preserves your configured bindings and adds missing inferred resources. The `worker` field takes precedence for compatibility settings and variables. See [Configuration](../reference/config.md).
|
|
80
|
+
|
|
81
|
+
Commit `bwf.lock.json` when bwf records resource IDs or Durable Object migrations. Keep generated Cloudflare config out of Git.
|
|
82
|
+
|
|
83
|
+
Declare environment variables in `env.ts`, put local values in `.env`, and set production server values with `bwf secret put`. See [Environment Variables](../guide/env-vars.md).
|
|
84
|
+
|
|
85
|
+
## Deploy to your own Cloudflare account
|
|
86
|
+
|
|
87
|
+
Choose Cloudflare during `bwf init`, then deploy:
|
|
88
|
+
|
|
89
|
+
```sh
|
|
90
|
+
bwf deploy
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
bwf opens your browser to sign in and asks which account to use when you have several. If the browser doesn't open, follow the link and confirm the code printed in the terminal.
|
|
94
|
+
|
|
95
|
+
To set up deployment later, run `bwf connect --platform cloudflare`. To select Cloudflare for one deploy, run:
|
|
96
|
+
|
|
97
|
+
```sh
|
|
98
|
+
bwf deploy --platform cloudflare
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
Use `bwf cloudflare login`, `status`, and `logout` to manage your session.
|
|
102
|
+
|
|
103
|
+
### Deploy an existing Worker
|
|
104
|
+
|
|
105
|
+
For an existing bwf app deployed directly to Cloudflare, keep its root `wrangler.jsonc` or `wrangler.json` and run:
|
|
106
|
+
|
|
107
|
+
```sh
|
|
108
|
+
bwf deploy
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
If no destination is selected, bwf offers to link the existing Worker. Accept to sign in and deploy. bwf migrates the configuration to `bwf.config.ts` and `bwf.lock.json`, preserving bindings, variables, secrets, routes, and schedules. Commit both files.
|
|
112
|
+
|
|
113
|
+
Keep the first deployment focused on the existing app. Add resources, auth, migrations, or other runtime features after linking. If the Worker has a newer inactive upload, activate or remove it in Cloudflare before retrying.
|
|
114
|
+
|
|
115
|
+
Readiness checks need either an existing [version metadata binding](https://developers.cloudflare.com/workers/runtime-apis/bindings/version-metadata/) or access to [Version URLs](https://developers.cloudflare.com/workers/versions-and-deployments/version-urls/). bwf stops before activation if neither is available.
|
|
116
|
+
|
|
117
|
+
If linking reports a missing binding, use the existing Worker's binding name and resource ID in `cloudflare` and `inference.bindings`. Keep `.bwf/cloudflare-link.json` when retrying.
|
|
118
|
+
|
|
119
|
+
Before changing dashboard-managed triggers or visibility later, add the current `routes`, `workers_dev`, and `preview_urls` to your config. Convert `wrangler.toml` to JSON/JSONC before linking. Named environments need separate bwf project configs.
|
|
120
|
+
|
|
121
|
+
### What happens during deploy
|
|
122
|
+
|
|
123
|
+
bwf creates missing resources, builds the app, checks secrets and migrations, uploads the Worker, verifies readiness, and updates traffic and triggers. Resource IDs are saved in `bwf.lock.json`.
|
|
124
|
+
|
|
125
|
+
A failed build or validation can leave provisioned resources in your account. Run the first deploy from one machine at a time, then commit the lock file before deploying from other machines or CI.
|
|
126
|
+
|
|
127
|
+
Apps using email need `email.from` in `bwf.config.ts`. bwf reviews the domain's setup before building and asks before changing it. See [Email](../guide/email/domains.md#your-own-cloudflare-account).
|
|
128
|
+
|
|
129
|
+
### Deploying from CI
|
|
130
|
+
|
|
131
|
+
Set these CI secrets and variables as needed:
|
|
132
|
+
|
|
133
|
+
| Name | When needed |
|
|
134
|
+
| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
135
|
+
| `CLOUDFLARE_API_TOKEN` | Required. Workers Scripts: Edit, read access to bound resources, and edit access to products bwf provisions. |
|
|
136
|
+
| `CLOUDFLARE_ACCOUNT_ID` | When the token can access several accounts. |
|
|
137
|
+
| `DATABASE_URL` | PostgreSQL and MySQL provisioning and migrations. |
|
|
138
|
+
| `CLOUDFLARE_WORKERS_SUBDOMAIN` | When workers.dev is enabled and the version has no preview URL. Use `my-team` or `my-team.workers.dev`. An account subdomain does not create a readiness URL when `workers_dev` is false. |
|
|
139
|
+
| `CF_ACCESS_CLIENT_ID`, `CF_ACCESS_CLIENT_SECRET` | When Cloudflare Access protects the readiness URL. |
|
|
140
|
+
| `CF_ACCESS_READINESS_ORIGIN` | When Access protects a route or Custom Domain and `workers_dev` is `false`. See [Cloudflare Access](#cloudflare-access). |
|
|
141
|
+
|
|
142
|
+
For email, run `bwf email setup --platform cloudflare` locally, commit `bwf.lock.json`, and pass `--require-email` in CI. The token also needs Email Routing Edit and Email Sending Edit.
|
|
143
|
+
|
|
144
|
+
#### Cloudflare Access
|
|
145
|
+
|
|
146
|
+
For local deployment to an Access-protected Worker, you can use a short-lived user session:
|
|
147
|
+
|
|
148
|
+
```sh
|
|
149
|
+
export CF_ACCESS_TOKEN="$(cloudflared access token --app=https://<worker>.<account>.workers.dev)"
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
bwf uses Access credentials for readiness checks without saving them. If checks are denied, the deployment fails. A first-deploy bootstrap can already be active behind Access when this happens.
|
|
153
|
+
|
|
154
|
+
By default, bwf sends Access credentials only to `workers.dev` URLs. If `workers_dev` is `false`, bwf can check readiness through your first route or Custom Domain. To send the credentials there, set `CF_ACCESS_READINESS_ORIGIN` to that hostname's origin:
|
|
155
|
+
|
|
156
|
+
```sh
|
|
157
|
+
export CF_ACCESS_READINESS_ORIGIN="https://app.example.com"
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
Set this variable in the shell or CI environment running `bwf deploy`. Use an exact HTTPS origin for a hostname you control that serves this Worker; bwf sends your Access credentials there.
|
|
161
|
+
|
|
162
|
+
### Databases and secrets
|
|
163
|
+
|
|
164
|
+
For PostgreSQL and MySQL, supply `DATABASE_URL` to the deploy process. bwf uses it for Hyperdrive and migrations without writing it to config. MySQL schema changes can partially apply before an error; see [failed MySQL migrations](../guide/database/mysql.md#failed-migrations).
|
|
165
|
+
|
|
166
|
+
Creating Hyperdrive requires an API token with Hyperdrive edit permission. Alternatively, create it in Cloudflare and add its ID to `cloudflare.hyperdrive`; an existing binding works with browser login.
|
|
167
|
+
|
|
168
|
+
Run `bwf db generate` and commit migrations before deploying schema changes. This includes Better Auth tables. Custom D1 migration directories, tables, and patterns are supported; deploy stops if the files to apply differ from the validated history.
|
|
169
|
+
|
|
170
|
+
Set production server values with `bwf secret put <NAME>`. bwf preserves existing remote secrets and creates `BETTER_AUTH_SECRET` when an auth app needs one. Local `.env` values are never deployed.
|
|
171
|
+
|
|
172
|
+
### Readiness and rollback
|
|
173
|
+
|
|
174
|
+
bwf checks an uploaded version before sending it traffic. If the Worker has no public URL, because workers.dev is off and no route or Custom Domain is configured, bwf activates it without a readiness check.
|
|
175
|
+
|
|
176
|
+
If readiness or trigger updates fail, bwf restores the previous deployment. If trigger updates fail and the previous triggers can't be restored, such as after another tool's deployment or from an empty draft, the new version stays live. The error names the version serving traffic.
|
|
177
|
+
|
|
178
|
+
Finish or cancel gradual rollouts in Cloudflare before deploying through bwf.
|
|
179
|
+
|
|
180
|
+
For an existing Durable Object Worker that Cloudflare cannot stage, review the changes and use:
|
|
181
|
+
|
|
182
|
+
```sh
|
|
183
|
+
bwf deploy --platform cloudflare --atomic
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
To use this on every deploy, set `deploy: { cloudflare: { mode: 'atomic' } }`. Atomic deployment sends traffic to the new version before its readiness check. Durable Object class migrations cannot be rolled back across their migration boundary.
|
|
187
|
+
|
|
188
|
+
A new Worker may need an active first deployment before readiness can be checked. Keep `.bwf/cloudflare-candidate.json` if a staged upload fails so you can retry from the same checkout.
|
|
189
|
+
|
|
190
|
+
Inspect or restore versions with:
|
|
191
|
+
|
|
192
|
+
```sh
|
|
193
|
+
bwf project status
|
|
194
|
+
bwf project rollback [version]
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
bwf restores recorded triggers along with the code. Versions without a complete trigger snapshot keep current routes and schedules. Database recovery is separate: use [`bwf db restore`](../reference/cli/database.md#nosam-db-restore) to undo D1 migrations.
|
|
198
|
+
|
|
199
|
+
#### Scope and limitations
|
|
200
|
+
|
|
201
|
+
bwf deploys bwf apps (a React SPA with an optional backend), static SPAs, static sites, and supported SSGs.
|
|
202
|
+
|
|
203
|
+
- bwf apps support bwf routing rules for redirects, rewrites, fallbacks, and headers.
|
|
204
|
+
- `--skip-build` works for existing static output. Worker apps require a fresh build.
|
|
205
|
+
- Named Cloudflare environments aren't supported. Use a separate bwf project config for each target.
|
|
206
|
+
- Sandbox requires Workers Paid and Docker. See [Sandbox requirements](../guide/sandboxes.md#deployment) for plan and token permissions.
|
|
207
|
+
- Email to arbitrary recipients requires Workers Paid; verified recipients and inbound mail work on Workers Free. See [Email](../guide/email/domains.md#your-own-cloudflare-account).
|
|
208
|
+
|
|
209
|
+
Commit Durable Object migration history in `bwf.lock.json`. Do not delete or reorder deployed steps.
|
|
210
|
+
|
|
211
|
+
### Managing the deployed app
|
|
212
|
+
|
|
213
|
+
`bwf secret`, `bwf domain`, `bwf project status|list|logs|rollback`, and remote `bwf db` commands use the selected account and Worker. Logs are a live tail.
|
|
214
|
+
|
|
215
|
+
Custom domain commands update routes immediately. If a first deployment times out while DNS or TLS is propagating, check the domain in Cloudflare and retry once `/__nosam/ready` is reachable.
|
|
216
|
+
|
|
217
|
+
`bwf project delete` does not remove Cloudflare resources. Review ownership and remove them in Cloudflare.
|
|
218
|
+
|
|
219
|
+
### Local development
|
|
220
|
+
|
|
221
|
+
Local D1, KV, and R2 bindings use local data. Your production resource IDs are used during deployment.
|
|
222
|
+
|
|
223
|
+
Workers AI runs remotely after you connect to Cloudflare, so development calls consume your account's allowance. Remote bindings in development and preview use your `bwf cloudflare login` session, or `CLOUDFLARE_API_TOKEN` when it is set.
|
|
224
|
+
|
|
225
|
+
### AI on your Cloudflare account {#ai-self-host}
|
|
226
|
+
|
|
227
|
+
`ai.run()`, `ai.stream()`, and `ai.image()` use your Workers AI binding. For provider models, configure your AI Gateway and store the provider key as a Worker secret:
|
|
228
|
+
|
|
229
|
+
```ts
|
|
230
|
+
import { defineConfig } from '@builtbyfriends/bwf/config';
|
|
231
|
+
|
|
232
|
+
export default defineConfig({
|
|
233
|
+
ai: { gateway: 'my-gateway' },
|
|
234
|
+
});
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
```sh
|
|
238
|
+
bwf secret put OPENAI_API_KEY
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
`ai.provider('openai').fetch(...)` then uses that gateway and key. See the [AI guide](../guide/ai.md) for examples. Use [AI Gateway analytics](https://developers.cloudflare.com/ai-gateway/) to inspect account usage.
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 'bwf route handlers run on Hono. Add hono to your app when your code imports from it directly.'
|
|
3
|
+
outline: deep
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Hono
|
|
7
|
+
|
|
8
|
+
bwf handlers run on [Hono](https://hono.dev). bwf depends on Hono internally, but if your app imports from `hono/*` directly, add `hono` to your app's dependencies first.
|
|
9
|
+
|
|
10
|
+
```bash
|
|
11
|
+
npm install hono
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
Once `hono` is installed in your app, you can use built-in middleware, helpers, and third-party Hono packages directly.
|
|
15
|
+
|
|
16
|
+
## Built-in Middleware
|
|
17
|
+
|
|
18
|
+
Use Hono's built-in middleware in your global middleware files or per-route:
|
|
19
|
+
|
|
20
|
+
```ts
|
|
21
|
+
import { defineMiddleware } from '@builtbyfriends/bwf';
|
|
22
|
+
// middleware/01.cors.ts
|
|
23
|
+
import { cors } from 'hono/cors';
|
|
24
|
+
|
|
25
|
+
export default defineMiddleware(cors({ origin: 'https://example.com' }));
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
```ts
|
|
29
|
+
import { defineHandler } from '@builtbyfriends/bwf';
|
|
30
|
+
// routes/api/products.ts (per-route cache)
|
|
31
|
+
import { cache } from 'hono/cache';
|
|
32
|
+
import { listProducts } from '../../lib/products';
|
|
33
|
+
|
|
34
|
+
export const GET = defineHandler(
|
|
35
|
+
cache({ cacheName: 'products', cacheControl: 'max-age=3600' }),
|
|
36
|
+
async () => ({ products: await listProducts() }),
|
|
37
|
+
);
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
::: warning
|
|
41
|
+
`cache()` stores one response per URL and returns it to every visitor. It skips requests with an `Authorization` header, but not cookies. Use it only on routes whose response is the same for everyone, never on a route that reads the signed-in user.
|
|
42
|
+
:::
|
|
43
|
+
|
|
44
|
+
```ts
|
|
45
|
+
import { defineHandler } from '@builtbyfriends/bwf';
|
|
46
|
+
// routes/api/webhooks/stripe.ts (per-route usage)
|
|
47
|
+
import { bearerAuth } from 'hono/bearer-auth';
|
|
48
|
+
|
|
49
|
+
export const POST = defineHandler(bearerAuth({ token: 'webhook-secret' }), async (c) => {
|
|
50
|
+
const body = await c.req.json();
|
|
51
|
+
return { received: true };
|
|
52
|
+
});
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## Response Helpers
|
|
56
|
+
|
|
57
|
+
Hono's context helpers are available on `c` in every handler:
|
|
58
|
+
|
|
59
|
+
```ts
|
|
60
|
+
import { defineHandler } from '@builtbyfriends/bwf';
|
|
61
|
+
// routes/api/download.ts
|
|
62
|
+
import { stream } from 'hono/streaming';
|
|
63
|
+
|
|
64
|
+
export const GET = defineHandler((c) => {
|
|
65
|
+
return stream(c, async (stream) => {
|
|
66
|
+
await stream.write('chunk 1');
|
|
67
|
+
await stream.write('chunk 2');
|
|
68
|
+
});
|
|
69
|
+
});
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
```ts
|
|
73
|
+
// routes/api/data.ts
|
|
74
|
+
import { defineHandler } from '@builtbyfriends/bwf';
|
|
75
|
+
|
|
76
|
+
export const GET = defineHandler((c) => {
|
|
77
|
+
c.header('X-Custom', 'value');
|
|
78
|
+
c.status(201);
|
|
79
|
+
return c.json({ created: true });
|
|
80
|
+
});
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## Third-party Middleware
|
|
84
|
+
|
|
85
|
+
Any `hono/*` or `@hono/*` package works. Install the package in your app, then use it directly:
|
|
86
|
+
|
|
87
|
+
```ts
|
|
88
|
+
import { defineMiddleware } from '@builtbyfriends/bwf';
|
|
89
|
+
// middleware/01.rate-limit.ts
|
|
90
|
+
import { rateLimiter } from 'hono-rate-limiter';
|
|
91
|
+
|
|
92
|
+
export default defineMiddleware(rateLimiter({ windowMs: 60_000, limit: 100 }));
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## Utilities
|
|
96
|
+
|
|
97
|
+
Hono's standalone helpers work anywhere:
|
|
98
|
+
|
|
99
|
+
```ts
|
|
100
|
+
import { HTTPException } from 'hono/http-exception';
|
|
101
|
+
|
|
102
|
+
// Throw typed HTTP errors
|
|
103
|
+
throw new HTTPException(404, { message: 'User not found' });
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
For the full list of built-in middleware, see the [Hono documentation](https://hono.dev/docs/middleware/builtin).
|
|
107
|
+
|
|
108
|
+
### Redirects
|
|
109
|
+
|
|
110
|
+
Return `c.redirect()` from a handler to redirect. From a shared helper, throw an `HTTPException` with the redirect response in `res`. This works in handlers and middleware:
|
|
111
|
+
|
|
112
|
+
```ts
|
|
113
|
+
import type { CloudContext } from '@builtbyfriends/bwf';
|
|
114
|
+
import { getUser } from '@builtbyfriends/bwf/auth';
|
|
115
|
+
// lib/require-page-user.ts
|
|
116
|
+
import { HTTPException } from 'hono/http-exception';
|
|
117
|
+
|
|
118
|
+
export function requirePageUser(c: CloudContext) {
|
|
119
|
+
const user = getUser();
|
|
120
|
+
if (!user) {
|
|
121
|
+
throw new HTTPException(302, { res: c.redirect('/login') });
|
|
122
|
+
}
|
|
123
|
+
return user;
|
|
124
|
+
}
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
After a mutation, use `303` for both the exception and `c.redirect('/login', 303)` so the browser follows with a GET.
|