@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,208 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 'Link a directory to a hosted project, then inspect deployments, logs, access, and rollbacks.'
|
|
3
|
+
outline: deep
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Projects {#project-commands}
|
|
7
|
+
|
|
8
|
+
## `bwf project status [name]` {#nosam-project-status-name}
|
|
9
|
+
|
|
10
|
+
Show deployments for the configured target.
|
|
11
|
+
|
|
12
|
+
- bwf targets show recent hosted deployments; `[name]` looks up a project by slug and otherwise the linked project is used.
|
|
13
|
+
- Cloudflare targets list Worker Versions, identify the active version, and show the recorded migration count. A project name is not accepted because the Worker name comes from `cloudflare.name` in `bwf.config.ts`.
|
|
14
|
+
- Owners and admins also see a warning when the platform cannot finish [replacing the project's credentials](../../guide/project-collaboration.md#change-or-remove-access).
|
|
15
|
+
|
|
16
|
+
## `bwf project link [name]` {#nosam-project-link-name}
|
|
17
|
+
|
|
18
|
+
Link current directory to an existing hosted bwf project by slug, or select interactively if omitted. State is stored in `.bwf/project.json`. Direct Cloudflare apps use `cloudflare.name` in `bwf.config.ts` and do not need linking.
|
|
19
|
+
|
|
20
|
+
## `bwf project list` {#nosam-project-list}
|
|
21
|
+
|
|
22
|
+
List all accessible hosted projects (slug, role, type, URL). Shared projects are included and the role column distinguishes them from projects you own. For a saved Cloudflare target, this displays the current Worker's versions instead because there is no bwf project registry.
|
|
23
|
+
|
|
24
|
+
## `bwf project team` {#nosam-project-team}
|
|
25
|
+
|
|
26
|
+
Manage access to a project hosted on a bwf platform:
|
|
27
|
+
|
|
28
|
+
```sh
|
|
29
|
+
bwf project team list [--project <slug>]
|
|
30
|
+
bwf project team invite <email> --role <reader|collaborator|admin> [--project <slug>]
|
|
31
|
+
bwf project team invitations [--project <slug>]
|
|
32
|
+
bwf project team role <user-id> <reader|collaborator|admin> [--project <slug>]
|
|
33
|
+
bwf project team remove <user-id> [--project <slug>]
|
|
34
|
+
bwf project team revoke <invitation-id> [--project <slug>]
|
|
35
|
+
bwf project team leave [--project <slug>]
|
|
36
|
+
bwf project team pending
|
|
37
|
+
bwf project team accept <invitation-id>
|
|
38
|
+
bwf project team decline <invitation-id>
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Project-scoped commands use `--project`, then `BWF_PROJECT`, then the linked project. Invitations can target only an email address already registered to a user on that platform; they do not create accounts or grant signup access. Only the invited account can accept or decline its invitation. `list` shows the same credential warning as `bwf project status`.
|
|
42
|
+
|
|
43
|
+
Readers can view the project but cannot deploy. Collaborators can deploy and manage deploy prerequisites. Project administrators can additionally manage domains, email destinations, GitHub configuration, and the project team. The owner alone can delete the project. See [Project Collaboration](../../guide/project-collaboration.md) for the full role boundaries.
|
|
44
|
+
|
|
45
|
+
Project-scoped team management commands are not available for projects deployed
|
|
46
|
+
directly to Cloudflare. The account-scoped `pending`, `accept`, and `decline`
|
|
47
|
+
commands use the active connection selected by `bwf connect <url>`, regardless
|
|
48
|
+
of the current project's link or deploy target. `BWF_API_URL` takes precedence;
|
|
49
|
+
an unscoped `BWF_TOKEN` selects bwf Cloud. These commands display their
|
|
50
|
+
platform, and accepting an invitation leaves directory links intact. To link
|
|
51
|
+
the invited application, run `bwf project link` in an unlinked checkout of
|
|
52
|
+
that application.
|
|
53
|
+
|
|
54
|
+
## `bwf project zero-trust` {#nosam-project-zero-trust}
|
|
55
|
+
|
|
56
|
+
Inspect or override protection for a project on a bwf platform:
|
|
57
|
+
|
|
58
|
+
```sh
|
|
59
|
+
bwf project zero-trust status [--project <slug>]
|
|
60
|
+
bwf project zero-trust protect [--project <slug>]
|
|
61
|
+
bwf project zero-trust public [--project <slug>]
|
|
62
|
+
bwf project zero-trust reconcile [--project <slug>]
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Project selection follows `--project`, then `BWF_PROJECT`, then the linked
|
|
66
|
+
project.
|
|
67
|
+
|
|
68
|
+
Readers can inspect the state. The owner or a project administrator can protect
|
|
69
|
+
the project, make it public, or repair drift. `public` does not change the
|
|
70
|
+
platform default for future projects. Deploys and rollbacks wait until a
|
|
71
|
+
protection change is finished; if one is refused, the owner or a project
|
|
72
|
+
administrator can run `bwf project zero-trust reconcile` before you retry.
|
|
73
|
+
These commands do not apply to direct Cloudflare deployments.
|
|
74
|
+
|
|
75
|
+
## `bwf project token <create|list|renew|revoke>` {#nosam-project-token-create-list-renew-revoke}
|
|
76
|
+
|
|
77
|
+
Manage revocable `aud: deploy` credentials for one bwf platform project. The
|
|
78
|
+
credential can only call the endpoints used by `bwf deploy`; it cannot access
|
|
79
|
+
operator, account, secret-writing, project-deletion, or other projects' routes.
|
|
80
|
+
|
|
81
|
+
```sh
|
|
82
|
+
bwf project token create --name github-actions --expires-in 30
|
|
83
|
+
bwf project token list
|
|
84
|
+
bwf project token renew <credential-id> --expires-in 30
|
|
85
|
+
bwf project token revoke <credential-id>
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Pass `--project <name>` outside a linked project. Expiry is bounded to 1–90
|
|
89
|
+
days. Create and renew display the bearer value once; replace the stored secret
|
|
90
|
+
immediately after renewal because the previous credential is revoked in the
|
|
91
|
+
same operation. Project deletion and owner suspension also stop its use. Login
|
|
92
|
+
method disablement does not revoke these independent deploy credentials.
|
|
93
|
+
|
|
94
|
+
Store the printed `BWF_TOKEN` and `BWF_API_URL` in the CI secret manager. The
|
|
95
|
+
Access pair passes the perimeter; the scoped bwf credential authorizes only
|
|
96
|
+
this project's deploy workflow. When remote proxy bindings are
|
|
97
|
+
used on an Access-protected platform, store `NOSAM_ACCESS_CREDENTIALS` as an
|
|
98
|
+
origin-keyed JSON secret containing both exact HTTPS origins, even if both use
|
|
99
|
+
the same service-token pair:
|
|
100
|
+
|
|
101
|
+
```json
|
|
102
|
+
{
|
|
103
|
+
"https://nosam-company-api.example.workers.dev": {
|
|
104
|
+
"CF_ACCESS_CLIENT_ID": "<service-token client ID>",
|
|
105
|
+
"CF_ACCESS_CLIENT_SECRET": "<service-token client secret>"
|
|
106
|
+
},
|
|
107
|
+
"https://nosam-company-proxy.example.workers.dev": {
|
|
108
|
+
"CF_ACCESS_CLIENT_ID": "<service-token client ID>",
|
|
109
|
+
"CF_ACCESS_CLIENT_SECRET": "<service-token client secret>"
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
`NOSAM_ACCESS_ORIGIN` scopes a pair to one origin, so selecting only the API
|
|
115
|
+
origin is insufficient for a workflow that calls the proxy. Use distinct pairs
|
|
116
|
+
in the two entries when the Access policies require them.
|
|
117
|
+
|
|
118
|
+
## `bwf project logs` {#nosam-project-logs}
|
|
119
|
+
|
|
120
|
+
```
|
|
121
|
+
bwf project logs [--level <level>] [--filter <text>] [--range <duration>] [--deployment <id>]
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
Show runtime logs from the deployed target. Hosted bwf targets query retained log history. Cloudflare targets open a live tail for the Worker named in `bwf.config.ts`; they do not provide historical log storage.
|
|
125
|
+
|
|
126
|
+
| Flag | Purpose | Default |
|
|
127
|
+
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
|
|
128
|
+
| `--range <duration>` | How far back to look. Format: `<number><unit>` (m/h/d). Max 7d. | `1h` |
|
|
129
|
+
| `--level <level>` | Filter by log level. One of `error`, `warn`, `info`, `log`, `debug`, `all`. `error` also includes uncaught exceptions, non-`ok` outcomes, and any 5xx response — even when the worker neither threw nor logged. | `all` |
|
|
130
|
+
| `--filter <text>` | Case-insensitive **substring** match against log message text and exception name/message — not a level filter. Shows the full request entry on any hit. | none |
|
|
131
|
+
| `--deployment <id>` | Filter logs to a specific deployment ID. | none |
|
|
132
|
+
|
|
133
|
+
Output shows one line per request (`HH:MM:SS METHOD URL STATUS`) with indented console log and exception lines beneath. Errors and exceptions are colored red, warnings yellow.
|
|
134
|
+
|
|
135
|
+
Examples:
|
|
136
|
+
|
|
137
|
+
```
|
|
138
|
+
bwf project logs --level error --range 12h
|
|
139
|
+
bwf project logs --level error --filter websocket
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
Logs include top-level `console.*` calls and uncaught errors captured by Cloudflare Tail. If you catch an error and save it only to your database, it won't appear here. Also log it with `console.error()` or `logger.error()` from `@builtbyfriends/bwf/log`. On hosted bwf targets, pass the `Error` object itself to `console.error()`, as in `console.error('Save failed:', error)`, to see its stack trace under the log line. Logging only `error.message` shows no stack.
|
|
143
|
+
|
|
144
|
+
For errors that never reach your Worker, such as edge routing errors or static site requests, use `bwf project requests --status 5xx`.
|
|
145
|
+
|
|
146
|
+
On a direct Cloudflare target, `--filter` becomes Cloudflare's live search, `--deployment` selects a Worker Version, and `--level error` selects error invocations. Other individual console levels cannot be filtered, and `--range` does not select history. `bwf project requests` is hosted-only.
|
|
147
|
+
|
|
148
|
+
## `bwf project requests` {#nosam-project-requests}
|
|
149
|
+
|
|
150
|
+
```
|
|
151
|
+
bwf project requests [--status <filter>] [--range <duration>]
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
Show request traffic for the linked project, including static assets and edge errors that do not appear in Worker logs.
|
|
155
|
+
|
|
156
|
+
| Flag | Purpose | Default |
|
|
157
|
+
| -------------------- | --------------------------------------------------------------------------------------------- | ------- |
|
|
158
|
+
| `--status <filter>` | Filter by status: a class (`2xx`, `3xx`, `4xx`, `5xx`) or an exact 3-digit code (e.g. `500`). | none |
|
|
159
|
+
| `--range <duration>` | How far back to look. Format: `<number><unit>` (m/h/d). Max 7d. | `1h` |
|
|
160
|
+
|
|
161
|
+
Output shows one line per request (`HH:MM:SS METHOD STATUS TYPE DURATION`). 5xx are colored red, 4xx yellow. Note: request paths are not recorded, so this view shows status and type rather than URLs — use `bwf project logs` for per-URL, per-log detail on requests that do reach your worker.
|
|
162
|
+
|
|
163
|
+
Examples:
|
|
164
|
+
|
|
165
|
+
```
|
|
166
|
+
bwf project requests --status 5xx
|
|
167
|
+
bwf project requests --range 24h
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
## `bwf project rollback [deployId]` {#nosam-project-rollback-deployid}
|
|
171
|
+
|
|
172
|
+
```
|
|
173
|
+
bwf project rollback [deployId] [--platform cloudflare]
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
Roll back to a previous deployment or Worker Version.
|
|
177
|
+
|
|
178
|
+
- If `[deployId]` is omitted, shows an interactive select menu of retained deployments
|
|
179
|
+
- If the target deployment has fewer applied migrations than the current one, a warning is shown listing the migration diff before confirmation
|
|
180
|
+
|
|
181
|
+
On a bwf platform, you can select a retained deployment. On Cloudflare, use a complete Worker Version ID or an unambiguous prefix. bwf activates that version at 100%. When both versions have complete trigger snapshots, it also restores the selected version's schedules, queues, workflows, routes, and custom domains. Otherwise, rollback keeps the current triggers and restores the code, including versions originally deployed outside bwf.
|
|
182
|
+
|
|
183
|
+
Pass `--platform cloudflare` to roll back a one-off Cloudflare deployment.
|
|
184
|
+
|
|
185
|
+
Database recovery is separate from code rollback. bwf asks for confirmation when the earlier code may be incompatible with the current schema. For D1 on Cloudflare, use [`bwf db restore`](./database.md#nosam-db-restore) with the restore point printed during deployment.
|
|
186
|
+
|
|
187
|
+
## `bwf project cancel [deployId]` {#nosam-project-cancel-deployid}
|
|
188
|
+
|
|
189
|
+
```
|
|
190
|
+
bwf project cancel [deployId]
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
Cancel an active deployment.
|
|
194
|
+
|
|
195
|
+
- If `[deployId]` is omitted, targets the linked project's active deployment
|
|
196
|
+
- If `[deployId]` is provided, targets that deployment; it must still be active
|
|
197
|
+
|
|
198
|
+
bwf asks for confirmation before it requests cancellation.
|
|
199
|
+
|
|
200
|
+
This command is hosted-only. Direct Cloudflare deploys are local operations and do not expose a remote build to cancel.
|
|
201
|
+
|
|
202
|
+
## `bwf project delete [name]` {#nosam-project-delete-name}
|
|
203
|
+
|
|
204
|
+
Permanently delete a hosted bwf project and all its resources (databases, KV namespaces, R2 buckets, deployments). Requires typing the project slug to confirm; `--force` (`-f`) skips the prompt.
|
|
205
|
+
|
|
206
|
+
If `[name]` is omitted, uses the linked project.
|
|
207
|
+
|
|
208
|
+
For direct Cloudflare targets this command refuses to run. Inferred resources can be shared, so bwf never performs automatic teardown; verify ownership and remove resources explicitly with Cloudflare tooling.
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 'List, set, and remove production secrets. Secret values are never printed.'
|
|
3
|
+
outline: deep
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Secrets and Environment {#secrets}
|
|
7
|
+
|
|
8
|
+
## `bwf secret list` {#nosam-secret-list}
|
|
9
|
+
|
|
10
|
+
```
|
|
11
|
+
bwf secret list [--project <name>]
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
List production secret names for the saved target. Secret values are never printed. Direct Cloudflare targets query the Worker named in `bwf.config.ts`; `--project` is hosted-only.
|
|
15
|
+
|
|
16
|
+
## `bwf secret put` {#nosam-secret-put}
|
|
17
|
+
|
|
18
|
+
```
|
|
19
|
+
bwf secret put <name> [--project <name>]
|
|
20
|
+
bwf secret put <name=value> [--project <name>]
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Value input modes:
|
|
24
|
+
|
|
25
|
+
- inline: `bwf secret put API_KEY=abcd`
|
|
26
|
+
- prompt (TTY): `bwf secret put API_KEY` (masked input)
|
|
27
|
+
- stdin: `echo -n "abcd" | bwf secret put API_KEY`
|
|
28
|
+
|
|
29
|
+
On a direct Cloudflare target, the value is stored as an encrypted Worker secret.
|
|
30
|
+
|
|
31
|
+
## `bwf secret sync` {#nosam-secret-sync}
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
bwf secret sync <file> [--project <name>] [--yes]
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Upload production server values from a dotenv file stored outside your project. Include only keys declared in `env.ts`; leave out local development credentials and public `VITE_*` values.
|
|
38
|
+
|
|
39
|
+
```sh
|
|
40
|
+
bwf secret sync /secure/path/production.env
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Pass `--yes` to skip confirmation in scripts and CI.
|
|
44
|
+
|
|
45
|
+
Existing remote secrets absent from the file are kept. Every entry must be a server key declared in `env.ts`, and its value must pass validation.
|
|
46
|
+
|
|
47
|
+
## `bwf secret delete` {#nosam-secret-delete}
|
|
48
|
+
|
|
49
|
+
```
|
|
50
|
+
bwf secret delete <name> [--project <name>]
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
Secret commands use the platform saved in `.bwf/project.json`. Hosted project resolution follows the same order as deploy (`--project`, env var, linked project). Direct Cloudflare targets reject `--project` and use the pinned root Cloudflare config.
|
|
54
|
+
|
|
55
|
+
On hosted projects, secret writes and deletes return a retryable conflict while a deployment or rollback is in progress. Wait for that operation to finish and retry; the rejected operation leaves the stored secret unchanged.
|
|
56
|
+
|
|
57
|
+
## Env Schema {#env-schema}
|
|
58
|
+
|
|
59
|
+
### `bwf env check` {#nosam-env-check}
|
|
60
|
+
|
|
61
|
+
```
|
|
62
|
+
bwf env check [--remote]
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Without `--remote`, validate `.env` plus the shell for local development. With `--remote`, validate build-shell client values and the remote server-secret names. Exits non-zero if a required key is missing or a readable value is invalid.
|
|
66
|
+
|
|
67
|
+
### `bwf env types` {#nosam-env-types}
|
|
68
|
+
|
|
69
|
+
```
|
|
70
|
+
bwf env types
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Regenerate `.bwf/env.d.ts` from `env.ts`. Normally happens automatically on dev server start and HMR; use this command after a fresh clone or to refresh stale types in non-dev contexts.
|
|
74
|
+
|
|
75
|
+
::: tip Deploy validation
|
|
76
|
+
`bwf deploy` runs the same schema validation automatically (with remote secrets) and refuses to upload if any required key is missing — no need to call `env check` separately when deploying.
|
|
77
|
+
:::
|
|
78
|
+
|
|
79
|
+
See [Environment Variables](../../guide/env-vars.md) for the full guide.
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 'Create a project with bwf init, prepare generated files, and inspect inferred resources.'
|
|
3
|
+
outline: deep
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Project Setup {#setup}
|
|
7
|
+
|
|
8
|
+
## `bwf info` {#nosam-info}
|
|
9
|
+
|
|
10
|
+
```sh
|
|
11
|
+
bwf info
|
|
12
|
+
bwf info --json
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Shows each Durable State and WebSocket definition's source file, inferred or explicit name, Worker class, and binding. WebSocket entries also include their route in JSON output. It runs locally without authentication, network requests, or file generation.
|
|
16
|
+
|
|
17
|
+
Before moving a deployed definition, copy the suggested `name` into `defineDurableState()`, `defineRoom()`, or `defineWebSocket()`. Keep that name after moving the file to preserve the resource. See [Durable State](../../guide/durable-state.md#rename-a-file-while-keeping-its-state) and [WebSockets](../../guide/websockets.md#move-a-route-while-keeping-its-state) for migration flows, including WebSocket parameter renames.
|
|
18
|
+
|
|
19
|
+
Resources recorded in `bwf.lock.json` without a matching definition appear separately. Adopt a suggested name only after identifying the resource you moved. If bwf cannot suggest a name, restore its original source and inspect it before moving it again.
|
|
20
|
+
|
|
21
|
+
`--json` returns `resources` and `recordedResources`. Current entries contain `file`, `definition`, `name`, `nameSource` (`inferred` or `explicit`), `className`, `bindingName`, and an optional `route`. Recorded entries contain `className` and `bindingName`, with `name` and `definition` when a matching name is available.
|
|
22
|
+
|
|
23
|
+
## `bwf migrate` {#nosam-migrate}
|
|
24
|
+
|
|
25
|
+
`bwf migrate` converts legacy `bwf.json` and root `wrangler.jsonc` or `wrangler.json` files into `bwf.config.ts`. It also accepts one root `wrangler*.json(c)` file referenced by a supported framework adapter. bwf saves backups in `.bwf/config-migration/`, records resource IDs in `bwf.lock.json`, and updates supported adapters to use its generated Cloudflare config.
|
|
26
|
+
|
|
27
|
+
The command adds generated `.cloudflare/` and `.bwf-wrangler.jsonc` files to `.gitignore` as needed. Review and commit `bwf.config.ts`, `bwf.lock.json`, and `.gitignore`. `bwf init` and `bwf deploy` migrate legacy files automatically. Resolve conflicting Cloudflare configs first, and keep the project's `bwf` package and CLI on the same version.
|
|
28
|
+
|
|
29
|
+
## `bwf init` {#nosam-init}
|
|
30
|
+
|
|
31
|
+
```sh
|
|
32
|
+
bwf init [--tsconfig] [--github] [--git | --no-git]
|
|
33
|
+
[--toolchain <name>] [--framework <name>] [--starter <name>] [--deploy <target>]
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Set up a new or existing bwf project. In an empty directory, choose Vite+ or Vite and a D1, PostgreSQL, MySQL, or SPA-only React starter. The new app's `bwf.config.ts` turns on [`routing.typedRoutes`](../config.md#routing-typedroutes).
|
|
37
|
+
|
|
38
|
+
Pass your choices as flags to scaffold from a script or coding agent:
|
|
39
|
+
|
|
40
|
+
| Flag | Values |
|
|
41
|
+
| ------------- | -------------------------------------- |
|
|
42
|
+
| `--toolchain` | `vite-plus`, `vite` |
|
|
43
|
+
| `--framework` | `react` |
|
|
44
|
+
| `--starter` | `sqlite`, `postgresql`, `mysql`, `spa` |
|
|
45
|
+
| `--deploy` | `cloudflare`, `bwf`, `none` |
|
|
46
|
+
|
|
47
|
+
```sh
|
|
48
|
+
bwf init --toolchain vite-plus --starter sqlite --deploy none
|
|
49
|
+
npm create nosam@latest my-app -- --toolchain vite-plus --starter sqlite --deploy none
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
For non-interactive scaffolding, choose `--deploy none` and run `bwf connect` later to sign in.
|
|
53
|
+
|
|
54
|
+
Vite+ projects install dependencies through `vp install`; no global Vite+ installation is required. bwf preserves existing package-manager versions and lockfiles. New Vite+ projects without a package-manager configuration use pnpm without pinning a version.
|
|
55
|
+
|
|
56
|
+
In an existing app, bwf adds missing dependencies and scripts and updates the Vite config. If it cannot edit your config, it prints the snippet to add.
|
|
57
|
+
|
|
58
|
+
The wizard also sets up TypeScript, agent instructions, environment declarations, and a deployment target. Choose Cloudflare, a bwf platform, or skip deployment setup. If you skip sign-in, run `bwf connect` when you're ready. See [Quick Start](../../guide/quickstart.md).
|
|
59
|
+
|
|
60
|
+
Every init run sets up coding agents. New projects get a minimal `AGENTS.md`
|
|
61
|
+
pointing to `node_modules/@builtbyfriends/bwf/docs/`. Existing projects prompt before the file
|
|
62
|
+
is created, appended to, or updated; CI and non-interactive runs leave existing
|
|
63
|
+
projects' instructions unchanged. Skills are linked for detected agents. See
|
|
64
|
+
[Coding Agents](../../integrations/agents.md).
|
|
65
|
+
|
|
66
|
+
Outside an existing repository or workspace package, bwf offers to initialize Git. Use `--git` to initialize without a prompt or `--no-git` to skip it. CI requires `--git` to initialize. Workspace packages do not accept these flags.
|
|
67
|
+
|
|
68
|
+
Run selected setup steps with:
|
|
69
|
+
|
|
70
|
+
| Flag | Purpose |
|
|
71
|
+
| ------------ | -------------------------------------------------------------- |
|
|
72
|
+
| `--tsconfig` | Update TypeScript configuration, preserving existing settings. |
|
|
73
|
+
| `--github` | Create the GitHub Actions deployment workflow. |
|
|
74
|
+
|
|
75
|
+
These flags can be combined and skip the other wizard steps. Coding agent setup
|
|
76
|
+
still runs. Add `--git` if you also want Git initialization.
|
|
77
|
+
|
|
78
|
+
For Cloudflare workflows, add a `CLOUDFLARE_API_TOKEN` repository secret. PostgreSQL and MySQL apps also need `DATABASE_URL`.
|
|
79
|
+
|
|
80
|
+
bwf platforms with GitHub Actions support use short-lived OIDC credentials. Authorize the repository with `bwf github connect <project> --repo <owner/repo> --executor github_actions`. Core self-hosted platforms do not support that integration. See [Deployment](../../guide/deployment.md#github).
|
|
81
|
+
|
|
82
|
+
## `bwf prepare` {#nosam-prepare}
|
|
83
|
+
|
|
84
|
+
```
|
|
85
|
+
bwf prepare
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Generates bwf’s types and TypeScript configuration without starting the dev server or building the app. Run it after a fresh clone or before typechecking in CI.
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 'Commands for creating a project, deploying it, and managing databases, secrets, domains, and a platform.'
|
|
3
|
+
outline: deep
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
<script setup>
|
|
7
|
+
import LegacyDocRedirect from "../.vitepress/theme/LegacyDocRedirect.vue";
|
|
8
|
+
import links from "../.vitepress/redirects/reference-cli.json";
|
|
9
|
+
</script>
|
|
10
|
+
|
|
11
|
+
<LegacyDocRedirect page="reference/cli.md" :links="links" />
|
|
12
|
+
|
|
13
|
+
# CLI Reference {#cli}
|
|
14
|
+
|
|
15
|
+
`bwf` is a local binary from the installed `bwf` package.
|
|
16
|
+
|
|
17
|
+
Use this page as a command reference. If you are setting up a project for the first time, start with [Quickstart](../guide/quickstart.md) and come back here when you need exact command behavior or flags.
|
|
18
|
+
|
|
19
|
+
## Command Groups
|
|
20
|
+
|
|
21
|
+
| Command group | Reference |
|
|
22
|
+
| ------------------------------------------ | ------------------------------------------------------------- |
|
|
23
|
+
| `init`, `prepare`, `info`, `migrate` | [Project setup](./cli/setup.md) |
|
|
24
|
+
| `connect`, `auth`, `account`, `cloudflare` | [Connections and authentication](./cli/auth.md) |
|
|
25
|
+
| `project` | [Projects, teams, logs, and rollback](./cli/project.md) |
|
|
26
|
+
| `deploy` | [Deployment](./cli/deploy.md) |
|
|
27
|
+
| `db` | [Database](./cli/database.md) |
|
|
28
|
+
| `gen` | [Code generation](./cli/generate.md) |
|
|
29
|
+
| `secret`, `env` | [Secrets and environment](./cli/secrets.md) |
|
|
30
|
+
| `github`, `build` | [GitHub and builds](./cli/github.md) |
|
|
31
|
+
| `domain` | [Custom domains](./cli/domains.md) |
|
|
32
|
+
| `email` | [Email](./cli/email.md) |
|
|
33
|
+
| `platform` | [Platform installation and administration](./cli/platform.md) |
|
|
34
|
+
|
|
35
|
+
## Cheat Sheet {#cheat-sheet}
|
|
36
|
+
|
|
37
|
+
Platform administrators can also choose AI Gateway logging [per project](./cli/platform-users.md#ai-gateway-logging) with `bwf platform project ai-logging`, or [per plan](../guide/platform/administration/plans.md#ai-gateway-logging) with `bwf platform config plans`.
|
|
38
|
+
|
|
39
|
+
| Command | Purpose |
|
|
40
|
+
| -------------------------------- | ----------------------------------------------------------------------------- |
|
|
41
|
+
| `bwf deploy` | Build and deploy to the configured platform |
|
|
42
|
+
| `bwf deploy --skip-migrations` | Deploy code without applying application or authentication SQL migrations |
|
|
43
|
+
| `bwf prepare` | Generate `.bwf` artifacts without starting Vite |
|
|
44
|
+
| `bwf info [--json]` | Inspect persistent resource names before moving their code |
|
|
45
|
+
| `bwf gen model <name> [cols...]` | Scaffold a Drizzle table and API routes |
|
|
46
|
+
| `bwf gen route <path>` | Create an API route |
|
|
47
|
+
| `bwf db push` | Apply schema directly without migration files |
|
|
48
|
+
| `bwf db generate` | Generate SQL migrations from schema changes |
|
|
49
|
+
| `bwf db status` | Show local/remote migration status |
|
|
50
|
+
| `bwf db reset` | Drop and re-apply all migrations |
|
|
51
|
+
| `bwf db seed` | Reset + seed local database |
|
|
52
|
+
| `bwf db execute <sql>` | Run SQL against the database (--remote for deployed) |
|
|
53
|
+
| `bwf db studio` | Open Drizzle Studio (--remote for a deployed external database) |
|
|
54
|
+
| `bwf db restore --bookmark <b>` | Restore the deployed D1 database to a restore point (direct Cloudflare) |
|
|
55
|
+
| `bwf secret put <name=value>` | Set a production secret |
|
|
56
|
+
| `bwf secret list` | List production secrets |
|
|
57
|
+
| `bwf secret sync <file>` | Bulk upload secrets from dotenv file |
|
|
58
|
+
| `bwf env check [--remote]` | Validate env.ts schema |
|
|
59
|
+
| `bwf env types` | Regenerate .bwf/env.d.ts from env.ts |
|
|
60
|
+
| `bwf auth login` | Authenticate with the project’s saved destination, or choose one |
|
|
61
|
+
| `bwf account login` | Authenticate with a bwf platform |
|
|
62
|
+
| `bwf cloudflare login` | Authenticate with Cloudflare through bwf |
|
|
63
|
+
| `bwf platform install` | Install a company bwf platform in Cloudflare |
|
|
64
|
+
| `bwf connect <url>` | Connect the CLI to a bwf platform; hostnames default to HTTPS |
|
|
65
|
+
| `bwf project link` | Link directory to a project |
|
|
66
|
+
| `bwf project logs` | Show runtime logs from deployed project |
|
|
67
|
+
| `bwf project requests` | Show request-level traffic (status, method, timing) |
|
|
68
|
+
| `bwf project rollback` | Roll back to a previous deployment |
|
|
69
|
+
| `bwf project cancel` | Cancel an active deployment |
|
|
70
|
+
| `bwf project zero-trust` | Inspect or override project Zero Trust protection |
|
|
71
|
+
| `bwf build logs` | Stream, tail, or download build logs |
|
|
72
|
+
| `bwf email status` | Show email readiness on your own Cloudflare account (`--platform cloudflare`) |
|
|
73
|
+
| `bwf email setup` | Set email up on your own Cloudflare account, without deploying |
|
|
74
|
+
| `bwf email usage` | Show monthly recipient attempts, inbound receipts, and quota |
|
|
75
|
+
| `bwf email logs` | Show recent email delivery activity |
|
|
76
|
+
| `bwf email destinations` | List verified recipient addresses |
|
|
77
|
+
| `bwf email allow <address>` | Add a recipient and send a verification email |
|
|
78
|
+
| `bwf email disallow <address>` | Remove a recipient from the allowlist |
|
|
79
|
+
| `bwf email alias [name]` | Show the shared mail address, or give it a shorter permanent name |
|
|
80
|
+
| `bwf email domain` | Send and receive at your own domain on a Cloudflare zone |
|
|
81
|
+
| `bwf init` | Set up a new or existing project, including coding agents |
|
|
82
|
+
| `bwf migrate` | Update project configuration |
|
|
83
|
+
|
|
84
|
+
## Binary Invocation {#binary-invocation}
|
|
85
|
+
|
|
86
|
+
The docs use `bwf` for brevity. Outside package scripts, run it with your package manager: `npx bwf`, `pnpm void`, `yarn void`, `bunx bwf`, or `vpx void`.
|
|
87
|
+
|
|
88
|
+
The CLI needs Node.js 24.22+ or 26.12+. `npx`, `bunx` and package scripts use the `node` on your `PATH`; `vpx` uses the version in `.node-version`.
|
|
89
|
+
|
|
90
|
+
Alternatively, you can add `./node_modules/.bin` to your `PATH` so that you can invoke `bwf` directly when you are in the root directory of your app.
|
|
91
|
+
|
|
92
|
+
:::warning ⚠️ Prefer local install
|
|
93
|
+
Install `bwf` in your project so the CLI and runtime use the same version.
|
|
94
|
+
:::
|
|
95
|
+
|
|
96
|
+
## Help {#help}
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
void --help
|
|
100
|
+
bwf help
|
|
101
|
+
bwf help <command>
|
|
102
|
+
bwf help <group> <command>
|
|
103
|
+
void <command> --help
|
|
104
|
+
void <group> <command> --help
|
|
105
|
+
void <group> help <command>
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Use `void --help` for the command list, or `bwf deploy --help` for a specific command. Help is available without signing in or setting up a project.
|
|
109
|
+
|
|
110
|
+
## Environment variables {#environment-variables}
|
|
111
|
+
|
|
112
|
+
| Variable | Purpose | Default |
|
|
113
|
+
| ------------- | ------------------------------------------------------------------------- | ------- |
|
|
114
|
+
| `BWF_TOKEN` | Auth token override instead of saved config | none |
|
|
115
|
+
| `BWF_PROJECT` | Default project slug for deploy, secret, domain, and cache purge commands | none |
|