@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,940 @@
|
|
|
1
|
+
import { a as join } from "./dist-DMYe8CZJ.mjs";
|
|
2
|
+
import { t as cfAccessHeaders } from "./cf-access-CUP5L08W.mjs";
|
|
3
|
+
import { r as getPackageDir } from "./agents-BLiMq9E1.mjs";
|
|
4
|
+
import { a as getApiUrl } from "./auth-xnkmpZUl.mjs";
|
|
5
|
+
import { r as isCloudflareAccessChallenge, t as ensurePlatformAccessToken } from "./cf-access-Bhz9wX6p.mjs";
|
|
6
|
+
import { n as readPlatformDiscoveryResponse } from "./platform-discovery-Bxg9aZXU.mjs";
|
|
7
|
+
import { c as normalizePlatformApiUrl } from "./platform-registry-x1m9HBxf.mjs";
|
|
8
|
+
import { readFileSync } from "node:fs";
|
|
9
|
+
import { stripVTControlCharacters } from "node:util";
|
|
10
|
+
// src/cli/platform-errors.ts
|
|
11
|
+
function parsePlatformErrorBody(body) {
|
|
12
|
+
try {
|
|
13
|
+
const parsed = JSON.parse(body);
|
|
14
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
|
|
15
|
+
const result = {};
|
|
16
|
+
for (const key of [
|
|
17
|
+
"error",
|
|
18
|
+
"message",
|
|
19
|
+
"deployment",
|
|
20
|
+
"minVersion",
|
|
21
|
+
"clientVersion"
|
|
22
|
+
]) {
|
|
23
|
+
const value = parsed[key];
|
|
24
|
+
if (typeof value === "string") result[key] = value;
|
|
25
|
+
}
|
|
26
|
+
return result;
|
|
27
|
+
} catch {
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
function plainExplanation(value) {
|
|
32
|
+
const text = value ? stripVTControlCharacters(value).replace(/[\u0000-\u0008\u000b-\u001f\u007f]/g, " ").trim() : void 0;
|
|
33
|
+
return text && !text.startsWith("{") && !text.startsWith("[") && !/<[^>]+>/.test(text) ? text : void 0;
|
|
34
|
+
}
|
|
35
|
+
function platformErrorMessage(payload) {
|
|
36
|
+
const message = plainExplanation(payload?.message);
|
|
37
|
+
return message && !/^(forbidden|unauthorized|access denied|permission denied)[.!]?$/i.test(message) ? message : void 0;
|
|
38
|
+
}
|
|
39
|
+
function unexplainedRejection(status) {
|
|
40
|
+
if (status === 401) return "Authentication was rejected. Check the credentials for the selected platform and any access gateway in front of it.";
|
|
41
|
+
if (status === 403) return "Access was denied by the platform or its access gateway. Check the selected platform and ask its administrator to confirm your access.";
|
|
42
|
+
return "The platform did not provide an explanation. Retry the operation; if it still fails, contact the platform administrator.";
|
|
43
|
+
}
|
|
44
|
+
function permissionMessage(permission) {
|
|
45
|
+
if (permission === "owner") return "Only the project owner can perform this action. Ask the owner to run it using their platform login.";
|
|
46
|
+
if (permission === "read") return "This action requires project membership (reader or higher). Ask a project admin or owner for access.";
|
|
47
|
+
if (permission === "settings" || permission === "members") return "This action requires admin or owner access. Ask a project admin or owner to confirm your access.";
|
|
48
|
+
if (permission === "configure" || permission === "deploy") return "This action requires collaborator, admin, or owner access. Ask a project admin or owner to confirm your access.";
|
|
49
|
+
return "Ask the platform administrator to check your access to this action.";
|
|
50
|
+
}
|
|
51
|
+
const rejectionMessages = {
|
|
52
|
+
"invalid or expired token": "The platform reported an invalid or expired token. Sign in again with `bwf connect <platform-url>`, or replace `BWF_TOKEN` if you supplied it.",
|
|
53
|
+
"missing authorization header": "A platform login or token is required. Sign in with `bwf connect <platform-url>`, or supply a valid `BWF_TOKEN` for that platform.",
|
|
54
|
+
"session revoked; sign in again": "Your platform session was revoked. Sign in again with `bwf connect <platform-url>`, or replace `BWF_TOKEN` if you supplied it.",
|
|
55
|
+
"user not found": "This account is no longer available. Contact the platform administrator or sign in with an active account on this platform.",
|
|
56
|
+
"deploy credential revoked or expired": "This project deploy credential was revoked or expired. Ask the project owner to issue a replacement and update the credential used by your automation.",
|
|
57
|
+
"deploy token build is no longer active": "This build is no longer active. Start a new build to obtain a valid deployment credential.",
|
|
58
|
+
github_identity_required: "Link your GitHub account with `bwf github link`, then retry this operation.",
|
|
59
|
+
connect_authorization_required: "This GitHub repository requires authorization. Run `bwf github connect` in an interactive terminal to authorize access, then retry.",
|
|
60
|
+
"invalid connect grant": "GitHub authorization failed or expired. Run `bwf github connect` again.",
|
|
61
|
+
"installation access revoked": "Access to this GitHub installation was revoked. Ask its administrator to restore access, then run `bwf github join`.",
|
|
62
|
+
"account suspended": "This account is suspended. Contact the platform administrator to restore access.",
|
|
63
|
+
"project owner suspended": "The project owner is suspended. Ask the owner to contact the platform administrator.",
|
|
64
|
+
"project is being deleted": "This project is being deleted. Wait for deletion to finish before creating a replacement.",
|
|
65
|
+
"registered user not found": "No registered account matches that email address. Ask the recipient to sign in to this platform first, then invite their registered email.",
|
|
66
|
+
"the project owner cannot be invited or changed as a member": "The project owner cannot be invited or changed through team membership commands. Choose another member.",
|
|
67
|
+
"the project owner cannot leave the project": "The project owner cannot leave. Ask a platform administrator to transfer ownership first.",
|
|
68
|
+
"user is already a project member": "This user is already a project member. Use `bwf project team list` to find their user ID, then `bwf project team role` to change their role.",
|
|
69
|
+
"project member not found": "This user is no longer a project member. Run `bwf project team list` to check current members.",
|
|
70
|
+
"project has too many pending invitations": "This project has reached its pending invitation limit. Run `bwf project team invitations` and revoke invitations that are no longer needed."
|
|
71
|
+
};
|
|
72
|
+
function formatPlatformApiError(action, status, body, permission) {
|
|
73
|
+
const parsed = parsePlatformErrorBody(body);
|
|
74
|
+
const message = platformErrorMessage(parsed);
|
|
75
|
+
if (status === 426 && parsed?.error === "cli_outdated" && message) return message;
|
|
76
|
+
if (!parsed) {
|
|
77
|
+
if (status === 401 || status === 403) {
|
|
78
|
+
const plain = plainExplanation(body);
|
|
79
|
+
return `${action} (HTTP ${status}): ${plain && !/^(forbidden|unauthorized|access denied|permission denied)[.!]?$/i.test(plain) ? plain.replace(/\s+/g, " ").slice(0, 240) : unexplainedRejection(status)}`;
|
|
80
|
+
}
|
|
81
|
+
return `${action}: ${status} ${body}`;
|
|
82
|
+
}
|
|
83
|
+
return `${action} (HTTP ${status}): ${(message ?? (status === 403 && parsed.error === "forbidden" ? `Access denied. ${permissionMessage(permission)}` : (parsed.error && Object.hasOwn(rejectionMessages, parsed.error) ? rejectionMessages[parsed.error] : void 0) ?? (status === 401 && ["unauthorized", "missing token"].includes(parsed.error ?? "") ? rejectionMessages["invalid or expired token"] : plainExplanation(parsed.error)))) || unexplainedRejection(status)}`;
|
|
84
|
+
}
|
|
85
|
+
// src/cli/client.ts
|
|
86
|
+
function readCliVersion() {
|
|
87
|
+
try {
|
|
88
|
+
const pkgPath = join(getPackageDir(), "package.json");
|
|
89
|
+
const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
|
|
90
|
+
return typeof pkg.version === "string" ? pkg.version : null;
|
|
91
|
+
} catch {
|
|
92
|
+
return null;
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
const BWF_CLI_VERSION = readCliVersion();
|
|
96
|
+
/** The oldest bwf platform release this CLI supports. */
|
|
97
|
+
const MIN_PLATFORM_VERSION = "1.9.0";
|
|
98
|
+
const RELEASE_VERSION = /^(\d+)\.(\d+)\.(\d+)(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?$/;
|
|
99
|
+
/**
|
|
100
|
+
* Discovery probes keyed by platform base URL. Every outcome (pass,
|
|
101
|
+
* inconclusive, or too old) is kept for the rest of the process, so polling
|
|
102
|
+
* commands probe discovery once.
|
|
103
|
+
*/
|
|
104
|
+
const platformVersionProbes = /* @__PURE__ */ new Map();
|
|
105
|
+
/**
|
|
106
|
+
* Returns whether `version` is older than the release `minimumVersion`, or null
|
|
107
|
+
* when it is not a release version. A prerelease sorts before its release.
|
|
108
|
+
*/
|
|
109
|
+
function isOlderPlatformVersion(version, minimumVersion) {
|
|
110
|
+
const actual = RELEASE_VERSION.exec(version);
|
|
111
|
+
const minimum = RELEASE_VERSION.exec(minimumVersion);
|
|
112
|
+
if (!actual) return null;
|
|
113
|
+
for (const part of [
|
|
114
|
+
1,
|
|
115
|
+
2,
|
|
116
|
+
3
|
|
117
|
+
]) {
|
|
118
|
+
const difference = Number(actual[part]) - Number(minimum[part]);
|
|
119
|
+
if (difference !== 0) return difference < 0;
|
|
120
|
+
}
|
|
121
|
+
return actual[4] !== void 0 && minimum[4] === void 0;
|
|
122
|
+
}
|
|
123
|
+
const UPGRADE_PLATFORM_ACTION = "Ask its administrator to upgrade the platform runtime with `bwf platform upgrade`.";
|
|
124
|
+
function assertSupportedPlatform(apiUrl, probe) {
|
|
125
|
+
if (probe.kind === "unknown") return;
|
|
126
|
+
if (probe.kind === "missing") throw new Error(`The bwf platform at ${apiUrl} does not report its version, but this CLI requires ${MIN_PLATFORM_VERSION} or later. ${UPGRADE_PLATFORM_ACTION}`);
|
|
127
|
+
const { version } = probe;
|
|
128
|
+
if (version === "hosted" || isOlderPlatformVersion(version, "1.9.0") !== true) return;
|
|
129
|
+
throw new Error(`The bwf platform at ${apiUrl} runs version ${version}, but this CLI requires ${MIN_PLATFORM_VERSION} or later. ${UPGRADE_PLATFORM_ACTION}`);
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
* Detects the `cli_outdated` 426 response shape emitted by the platform's
|
|
133
|
+
* `cliVersionGate` middleware. When present, callers should surface the
|
|
134
|
+
* server's `message` field verbatim — it already includes upgrade
|
|
135
|
+
* instructions — rather than the default `<action>: <status> <body>`
|
|
136
|
+
* which would dump raw JSON at the user.
|
|
137
|
+
*/
|
|
138
|
+
function isCliOutdatedError(err) {
|
|
139
|
+
if (!(err instanceof PlatformApiError)) return false;
|
|
140
|
+
if (err.status !== 426) return false;
|
|
141
|
+
return parsePlatformErrorBody(err.body)?.error === "cli_outdated";
|
|
142
|
+
}
|
|
143
|
+
var PlatformApiError = class extends Error {
|
|
144
|
+
status;
|
|
145
|
+
body;
|
|
146
|
+
code;
|
|
147
|
+
constructor(action, status, body, permission) {
|
|
148
|
+
const parsed = parsePlatformErrorBody(body);
|
|
149
|
+
super(formatPlatformApiError(action, status, body, permission));
|
|
150
|
+
this.name = "PlatformApiError";
|
|
151
|
+
this.status = status;
|
|
152
|
+
this.body = body;
|
|
153
|
+
this.code = parsed?.error ?? parsed?.message;
|
|
154
|
+
}
|
|
155
|
+
};
|
|
156
|
+
async function throwPlatformApiError(action, res, permission) {
|
|
157
|
+
throw new PlatformApiError(action, res.status, await res.text(), isCloudflareAccessChallenge(res) ? void 0 : permission);
|
|
158
|
+
}
|
|
159
|
+
function isExpiredTokenError(error) {
|
|
160
|
+
if (error instanceof PlatformApiError) return error.status === 401 && error.code === "invalid or expired token";
|
|
161
|
+
return false;
|
|
162
|
+
}
|
|
163
|
+
/**
|
|
164
|
+
* True when `fetch` gave up waiting for response headers (undici's
|
|
165
|
+
* `HeadersTimeoutError`, 300 seconds by default). The request reached the
|
|
166
|
+
* server, which is still working on it.
|
|
167
|
+
*/
|
|
168
|
+
function isHeadersTimeoutError(error) {
|
|
169
|
+
let current = error;
|
|
170
|
+
for (let depth = 0; depth < 6 && current !== null && typeof current === "object"; depth++) {
|
|
171
|
+
const { code, name } = current;
|
|
172
|
+
if (code === "UND_ERR_HEADERS_TIMEOUT" || name === "HeadersTimeoutError") return true;
|
|
173
|
+
current = current.cause;
|
|
174
|
+
}
|
|
175
|
+
return false;
|
|
176
|
+
}
|
|
177
|
+
function isPreflightRejection(error) {
|
|
178
|
+
return error instanceof PlatformApiError && ([401, 403].includes(error.status) && !!parsePlatformErrorBody(error.body)?.error || isCliOutdatedError(error));
|
|
179
|
+
}
|
|
180
|
+
const DEPLOY_POST_MAX_RETRIES = 3;
|
|
181
|
+
const DEPLOY_POST_BACKOFF_MS = [
|
|
182
|
+
1e3,
|
|
183
|
+
5e3,
|
|
184
|
+
1e4
|
|
185
|
+
];
|
|
186
|
+
const DEPLOY_OBSERVATION_TIMEOUT_MS = 3e4;
|
|
187
|
+
const DEPLOY_OBSERVATION_DEADLINE_MS = 18e5;
|
|
188
|
+
const DEPLOY_OBSERVATION_BACKOFF_MS = [
|
|
189
|
+
1e3,
|
|
190
|
+
2e3,
|
|
191
|
+
5e3,
|
|
192
|
+
1e4,
|
|
193
|
+
3e4
|
|
194
|
+
];
|
|
195
|
+
var DeploymentProtocolError = class extends Error {};
|
|
196
|
+
var DeploymentObservationTimeoutError = class extends Error {
|
|
197
|
+
constructor(deploymentId) {
|
|
198
|
+
super(`Timed out observing deployment ${deploymentId}. Inspect with \`bwf project status\`.`);
|
|
199
|
+
}
|
|
200
|
+
};
|
|
201
|
+
function parseDeployEvent(value) {
|
|
202
|
+
if (!value || typeof value !== "object" || !("event" in value) || typeof value.event !== "string") throw new DeploymentProtocolError("Invalid deployment event from platform.");
|
|
203
|
+
const event = value;
|
|
204
|
+
if (event.seq !== void 0 && (!Number.isSafeInteger(event.seq) || event.seq < 1)) throw new DeploymentProtocolError("Invalid deployment event sequence from platform.");
|
|
205
|
+
if (event.event === "start" && typeof event.deploymentId !== "string" || event.event === "heartbeat" && (typeof event.step !== "string" || event.status !== void 0 && ![
|
|
206
|
+
"queued",
|
|
207
|
+
"running",
|
|
208
|
+
"recovering"
|
|
209
|
+
].includes(event.status) || event.recoveryAt !== void 0 && (typeof event.recoveryAt !== "string" || !Number.isFinite(Date.parse(event.recoveryAt)))) || event.event === "done" && (typeof event.deployment !== "string" || typeof event.url !== "string" || !Array.isArray(event.urls) || !event.urls.every((url) => typeof url === "string") || !Number.isSafeInteger(event.assets) || event.assets < 0 || !Number.isSafeInteger(event.workers) || event.workers < 0 || event.published !== void 0 && typeof event.published !== "boolean") || event.event === "error" && (typeof event.message !== "string" || typeof event.step !== "string")) throw new DeploymentProtocolError("Invalid deployment result from platform.");
|
|
210
|
+
return event;
|
|
211
|
+
}
|
|
212
|
+
/**
|
|
213
|
+
* HTTP client for the bwf platform API.
|
|
214
|
+
*/
|
|
215
|
+
var PlatformClient = class {
|
|
216
|
+
baseUrl;
|
|
217
|
+
authHeaders;
|
|
218
|
+
accessHeaders;
|
|
219
|
+
cliLog;
|
|
220
|
+
checkPlatformVersion;
|
|
221
|
+
apiUrl;
|
|
222
|
+
/**
|
|
223
|
+
* `checkPlatformVersion: false` skips the minimum platform version check.
|
|
224
|
+
* Only login uses it, so users can still sign in to an older platform.
|
|
225
|
+
*/
|
|
226
|
+
constructor(token, options) {
|
|
227
|
+
this.baseUrl = normalizePlatformApiUrl(options?.apiUrl ?? getApiUrl(options?.root));
|
|
228
|
+
this.cliLog = options?.cliLog;
|
|
229
|
+
this.checkPlatformVersion = options?.checkPlatformVersion !== false;
|
|
230
|
+
this.apiUrl = this.baseUrl;
|
|
231
|
+
ensurePlatformAccessToken(this.baseUrl);
|
|
232
|
+
this.accessHeaders = cfAccessHeaders(process.env, this.baseUrl);
|
|
233
|
+
this.authHeaders = {
|
|
234
|
+
Authorization: `Bearer ${token}`,
|
|
235
|
+
...BWF_CLI_VERSION !== null && { "X-Nosam-CLI-Version": BWF_CLI_VERSION }
|
|
236
|
+
};
|
|
237
|
+
}
|
|
238
|
+
async request(url, options = {}) {
|
|
239
|
+
if (new URL(url).origin !== this.baseUrl) throw new Error("Platform credentials cannot be sent to another origin.");
|
|
240
|
+
if (this.checkPlatformVersion) await this.ensureSupportedPlatform();
|
|
241
|
+
return this.send(url, options);
|
|
242
|
+
}
|
|
243
|
+
/**
|
|
244
|
+
* Checks the platform version once per process and base URL. Concurrent
|
|
245
|
+
* first requests share one probe, and its outcome is kept for later requests.
|
|
246
|
+
*/
|
|
247
|
+
async ensureSupportedPlatform() {
|
|
248
|
+
assertSupportedPlatform(this.baseUrl, await this.platformProbe());
|
|
249
|
+
}
|
|
250
|
+
platformProbe() {
|
|
251
|
+
const cached = platformVersionProbes.get(this.baseUrl);
|
|
252
|
+
if (cached) return cached;
|
|
253
|
+
const probe = this.probePlatformVersion();
|
|
254
|
+
platformVersionProbes.set(this.baseUrl, probe);
|
|
255
|
+
return probe;
|
|
256
|
+
}
|
|
257
|
+
/**
|
|
258
|
+
* Whether discovery says the platform accepts Worker modules uploaded to R2.
|
|
259
|
+
* False when discovery omits the field or gave no usable answer.
|
|
260
|
+
*/
|
|
261
|
+
async supportsDirectWorkerUpload() {
|
|
262
|
+
let probe = await this.platformProbe();
|
|
263
|
+
if (probe.kind === "unknown") probe = await this.probePlatformVersion();
|
|
264
|
+
return probe.kind === "version" && probe.directWorkerUpload;
|
|
265
|
+
}
|
|
266
|
+
/** Older servers otherwise ignore the execution mode and apply SQL anyway. */
|
|
267
|
+
async requireMigrationSkipSupport() {
|
|
268
|
+
const response = await this.request(`${this.baseUrl}/capabilities`, { signal: AbortSignal.timeout(15e3) });
|
|
269
|
+
if (!response.ok && response.status !== 404) await throwPlatformApiError("Failed to check migration capabilities", response, "deploy");
|
|
270
|
+
if ((response.ok ? await response.json() : null)?.skipMigrations !== true) throw new Error("deploy: This bwf platform does not support --skip-migrations. Ask its administrator to upgrade with `bwf platform upgrade`.");
|
|
271
|
+
}
|
|
272
|
+
/** Reads the platform version from public discovery, without credentials. */
|
|
273
|
+
async probePlatformVersion() {
|
|
274
|
+
let response;
|
|
275
|
+
try {
|
|
276
|
+
response = await this.send(`${this.baseUrl}/.well-known/nosam-platform`, {
|
|
277
|
+
headers: { Accept: "application/json" },
|
|
278
|
+
signal: AbortSignal.timeout(15e3)
|
|
279
|
+
});
|
|
280
|
+
} catch {
|
|
281
|
+
return { kind: "unknown" };
|
|
282
|
+
}
|
|
283
|
+
if (response.status === 404) {
|
|
284
|
+
await response.body?.cancel();
|
|
285
|
+
return { kind: "missing" };
|
|
286
|
+
}
|
|
287
|
+
try {
|
|
288
|
+
const discovery = await readPlatformDiscoveryResponse(this.baseUrl, response);
|
|
289
|
+
return {
|
|
290
|
+
kind: "version",
|
|
291
|
+
version: discovery.platformVersion,
|
|
292
|
+
directWorkerUpload: discovery.directWorkerUpload === true
|
|
293
|
+
};
|
|
294
|
+
} catch {
|
|
295
|
+
return { kind: "unknown" };
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
async send(url, options) {
|
|
299
|
+
if (!this.accessHeaders["CF-Access-Client-Id"]) ensurePlatformAccessToken(this.baseUrl);
|
|
300
|
+
const send = () => {
|
|
301
|
+
const currentAccessHeaders = cfAccessHeaders(process.env, this.baseUrl);
|
|
302
|
+
const accessHeaders = this.accessHeaders["CF-Access-Client-Id"] ? this.accessHeaders : Object.keys(currentAccessHeaders).length > 0 ? currentAccessHeaders : this.accessHeaders;
|
|
303
|
+
return {
|
|
304
|
+
accessHeaders,
|
|
305
|
+
response: fetch(url, {
|
|
306
|
+
...options,
|
|
307
|
+
headers: {
|
|
308
|
+
...options.headers,
|
|
309
|
+
...accessHeaders
|
|
310
|
+
},
|
|
311
|
+
redirect: "manual"
|
|
312
|
+
})
|
|
313
|
+
};
|
|
314
|
+
};
|
|
315
|
+
const first = send();
|
|
316
|
+
const response = await first.response;
|
|
317
|
+
if (!isCloudflareAccessChallenge(response)) return response;
|
|
318
|
+
if (first.accessHeaders["CF-Access-Client-Id"]) return response;
|
|
319
|
+
await response.body?.cancel();
|
|
320
|
+
ensurePlatformAccessToken(this.baseUrl, true, false, first.accessHeaders["cf-access-token"]);
|
|
321
|
+
return send().response;
|
|
322
|
+
}
|
|
323
|
+
/** Sends an authenticated request and throws `PlatformApiError` unless it succeeds. */
|
|
324
|
+
async call(url, action, options = {}) {
|
|
325
|
+
const { method, body, permission } = options;
|
|
326
|
+
const res = await this.request(url, {
|
|
327
|
+
...method !== void 0 && { method },
|
|
328
|
+
headers: body === void 0 ? { ...this.authHeaders } : {
|
|
329
|
+
"Content-Type": "application/json",
|
|
330
|
+
...this.authHeaders
|
|
331
|
+
},
|
|
332
|
+
...body !== void 0 && { body: JSON.stringify(body) }
|
|
333
|
+
});
|
|
334
|
+
if (!res.ok) await throwPlatformApiError(action, res, permission);
|
|
335
|
+
return res;
|
|
336
|
+
}
|
|
337
|
+
/**
|
|
338
|
+
* Calls a platform procedure (`POST /rpc/<name>`). A failure throws `PlatformApiError`
|
|
339
|
+
* with the procedure's error code in `error`, so callers handle it like any platform error.
|
|
340
|
+
*/
|
|
341
|
+
async rpc(name, action, input, { permission, signal } = {}) {
|
|
342
|
+
const res = await this.request(`${this.baseUrl}/rpc/${name}`, {
|
|
343
|
+
method: "POST",
|
|
344
|
+
headers: {
|
|
345
|
+
"Content-Type": "application/json",
|
|
346
|
+
"x-realtime-surface": "cli",
|
|
347
|
+
...this.authHeaders
|
|
348
|
+
},
|
|
349
|
+
body: input === void 0 ? "" : JSON.stringify(input),
|
|
350
|
+
...signal && { signal }
|
|
351
|
+
});
|
|
352
|
+
const text = await res.text();
|
|
353
|
+
if (res.ok) return JSON.parse(text).data;
|
|
354
|
+
let body = text;
|
|
355
|
+
try {
|
|
356
|
+
const { error } = JSON.parse(text);
|
|
357
|
+
if (error?.code) body = JSON.stringify({
|
|
358
|
+
error: error.code.toLowerCase(),
|
|
359
|
+
message: error.message
|
|
360
|
+
});
|
|
361
|
+
} catch {}
|
|
362
|
+
throw new PlatformApiError(action, res.status, body, isCloudflareAccessChallenge(res) ? void 0 : permission);
|
|
363
|
+
}
|
|
364
|
+
async json(url, action, options) {
|
|
365
|
+
return (await this.call(url, action, options)).json();
|
|
366
|
+
}
|
|
367
|
+
async startIdentityLink(connectionId) {
|
|
368
|
+
const result = await this.json(`${this.baseUrl}/auth/link`, "Failed to link login method", {
|
|
369
|
+
method: "POST",
|
|
370
|
+
body: { connectionId }
|
|
371
|
+
});
|
|
372
|
+
const url = new URL(result.url);
|
|
373
|
+
if (url.origin !== this.baseUrl || url.pathname !== "/auth/link" || url.username || url.password) throw new Error("auth: Invalid account-link URL from platform.");
|
|
374
|
+
return result;
|
|
375
|
+
}
|
|
376
|
+
async whoami() {
|
|
377
|
+
return this.rpc("me.get", "Failed to fetch user info");
|
|
378
|
+
}
|
|
379
|
+
async listProjects() {
|
|
380
|
+
return this.rpc("projects.list", "Failed to list projects");
|
|
381
|
+
}
|
|
382
|
+
/** A lightweight project list for interactive linking. */
|
|
383
|
+
async listProjectChoices() {
|
|
384
|
+
return this.rpc("projects.choices", "Failed to list project choices");
|
|
385
|
+
}
|
|
386
|
+
/** Resolve one known project without loading account-wide deployment and traffic summaries. */
|
|
387
|
+
async getProject(projectId) {
|
|
388
|
+
try {
|
|
389
|
+
return await this.rpc("projects.get", "Failed to get project", { projectId });
|
|
390
|
+
} catch (error) {
|
|
391
|
+
if (error instanceof PlatformApiError && error.status === 403) return null;
|
|
392
|
+
throw error;
|
|
393
|
+
}
|
|
394
|
+
}
|
|
395
|
+
/** Resolve a slug through the current platform contract. */
|
|
396
|
+
async findProjectBySlug(slug) {
|
|
397
|
+
return (await this.rpc("projects.resolve", "Failed to resolve project", { slug })).project;
|
|
398
|
+
}
|
|
399
|
+
async listProjectTokens(projectId) {
|
|
400
|
+
return this.rpc("tokens.list", "Failed to list project tokens", { projectId }, { permission: "owner" });
|
|
401
|
+
}
|
|
402
|
+
async getProjectZeroTrust(projectId) {
|
|
403
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/zero-trust`, "Failed to inspect project Zero Trust", { permission: "read" });
|
|
404
|
+
}
|
|
405
|
+
async setProjectZeroTrust(projectId, protectedProject) {
|
|
406
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/zero-trust`, "Failed to update project Zero Trust", {
|
|
407
|
+
method: "PUT",
|
|
408
|
+
body: { protected: protectedProject },
|
|
409
|
+
permission: "settings"
|
|
410
|
+
});
|
|
411
|
+
}
|
|
412
|
+
async reconcileProjectZeroTrust(projectId) {
|
|
413
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/zero-trust/reconcile`, "Failed to reconcile project Zero Trust", {
|
|
414
|
+
method: "POST",
|
|
415
|
+
permission: "settings"
|
|
416
|
+
});
|
|
417
|
+
}
|
|
418
|
+
async createProjectToken(projectId, input) {
|
|
419
|
+
return this.rpc("tokens.create", "Failed to create project token", {
|
|
420
|
+
projectId,
|
|
421
|
+
...input
|
|
422
|
+
}, { permission: "owner" });
|
|
423
|
+
}
|
|
424
|
+
async listProjectMembers(projectId) {
|
|
425
|
+
const body = await this.rpc("team.members", "Failed to list project members", { projectId }, { permission: "read" });
|
|
426
|
+
return {
|
|
427
|
+
members: body.members,
|
|
428
|
+
...body.warnings ? { warnings: body.warnings } : {}
|
|
429
|
+
};
|
|
430
|
+
}
|
|
431
|
+
async listProjectInvitations(projectId) {
|
|
432
|
+
return (await this.rpc("team.invitations", "Failed to list project invitations", { projectId }, { permission: "members" })).invitations;
|
|
433
|
+
}
|
|
434
|
+
async inviteProjectMember(projectId, email, role) {
|
|
435
|
+
return this.rpc("team.invite", "Failed to invite project member", {
|
|
436
|
+
projectId,
|
|
437
|
+
email,
|
|
438
|
+
role
|
|
439
|
+
}, { permission: "members" });
|
|
440
|
+
}
|
|
441
|
+
async renewProjectToken(projectId, credentialId, expiresInDays) {
|
|
442
|
+
return this.rpc("tokens.renew", "Failed to renew project token", {
|
|
443
|
+
projectId,
|
|
444
|
+
credentialId,
|
|
445
|
+
...expiresInDays ? { expiresInDays } : {}
|
|
446
|
+
}, { permission: "owner" });
|
|
447
|
+
}
|
|
448
|
+
async updateProjectMemberRole(projectId, userId, role) {
|
|
449
|
+
return this.rpc("team.setRole", "Failed to change project member role", {
|
|
450
|
+
projectId,
|
|
451
|
+
userId,
|
|
452
|
+
role
|
|
453
|
+
}, { permission: "members" });
|
|
454
|
+
}
|
|
455
|
+
async revokeProjectToken(projectId, credentialId) {
|
|
456
|
+
return this.rpc("tokens.revoke", "Failed to revoke project token", {
|
|
457
|
+
projectId,
|
|
458
|
+
credentialId
|
|
459
|
+
}, { permission: "owner" });
|
|
460
|
+
}
|
|
461
|
+
async removeProjectMember(projectId, userId) {
|
|
462
|
+
await this.rpc("team.remove", "Failed to remove project member", {
|
|
463
|
+
projectId,
|
|
464
|
+
userId
|
|
465
|
+
}, { permission: "members" });
|
|
466
|
+
}
|
|
467
|
+
async revokeProjectInvitation(projectId, invitationId) {
|
|
468
|
+
await this.rpc("team.revokeInvitation", "Failed to revoke project invitation", {
|
|
469
|
+
projectId,
|
|
470
|
+
invitationId
|
|
471
|
+
}, { permission: "members" });
|
|
472
|
+
}
|
|
473
|
+
async leaveProject(projectId) {
|
|
474
|
+
await this.rpc("team.leave", "Failed to leave project", { projectId });
|
|
475
|
+
}
|
|
476
|
+
async listPendingProjectInvitations() {
|
|
477
|
+
return (await this.rpc("team.myInvitations", "Failed to list pending project invitations")).invitations;
|
|
478
|
+
}
|
|
479
|
+
async respondToProjectInvitation(invitationId, action) {
|
|
480
|
+
await this.rpc("team.respond", `Failed to ${action} project invitation`, {
|
|
481
|
+
invitationId,
|
|
482
|
+
response: action
|
|
483
|
+
});
|
|
484
|
+
}
|
|
485
|
+
async listDeployments(projectId) {
|
|
486
|
+
return this.rpc("deployments.list", "Failed to list deployments", { projectId }, { permission: "read" });
|
|
487
|
+
}
|
|
488
|
+
async rollback(projectId, deploymentId, options) {
|
|
489
|
+
const body = { deploymentId };
|
|
490
|
+
if (options?.allowDestructive && options.allowDestructive.length > 0) body.allowDestructive = options.allowDestructive;
|
|
491
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/rollback`, "Rollback failed", {
|
|
492
|
+
method: "POST",
|
|
493
|
+
body,
|
|
494
|
+
permission: "deploy"
|
|
495
|
+
});
|
|
496
|
+
}
|
|
497
|
+
async cancelDeployment(projectId, deploymentId) {
|
|
498
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/deployments/${deploymentId}/cancel`, "Cancel deployment failed", {
|
|
499
|
+
method: "POST",
|
|
500
|
+
permission: "deploy"
|
|
501
|
+
});
|
|
502
|
+
}
|
|
503
|
+
async createProject(slug) {
|
|
504
|
+
return this.rpc("projects.create", "Failed to create project", { slug });
|
|
505
|
+
}
|
|
506
|
+
async preflight(projectId, assetManifest, hasWorker) {
|
|
507
|
+
const total = Object.keys(assetManifest).length;
|
|
508
|
+
try {
|
|
509
|
+
return await this.rpc("deploy.preflight", "Preflight failed", {
|
|
510
|
+
projectId,
|
|
511
|
+
assetManifest,
|
|
512
|
+
...hasWorker && { hasWorker }
|
|
513
|
+
}, { permission: "deploy" });
|
|
514
|
+
} catch (error) {
|
|
515
|
+
if (isPreflightRejection(error)) throw error;
|
|
516
|
+
return {
|
|
517
|
+
needed: Object.keys(assetManifest),
|
|
518
|
+
total,
|
|
519
|
+
skipped: 0
|
|
520
|
+
};
|
|
521
|
+
}
|
|
522
|
+
}
|
|
523
|
+
async requestUploadUrls(projectId, assets) {
|
|
524
|
+
this.cliLog?.info("upload_urls_post", { assetCount: assets.length });
|
|
525
|
+
const { urls } = await this.rpc("deploy.uploadUrls", "Failed to request upload URLs", {
|
|
526
|
+
projectId,
|
|
527
|
+
assets
|
|
528
|
+
}, { permission: "deploy" });
|
|
529
|
+
return urls;
|
|
530
|
+
}
|
|
531
|
+
/**
|
|
532
|
+
* Requests one presigned R2 PUT per Worker module, in `modules` order. The
|
|
533
|
+
* platform refuses a Worker over Cloudflare's size limit here (413
|
|
534
|
+
* `worker_too_large`), before any bytes are uploaded.
|
|
535
|
+
*/
|
|
536
|
+
async requestWorkerUploadUrls(projectId, modules) {
|
|
537
|
+
this.cliLog?.info("worker_upload_urls_post", { moduleCount: modules.length });
|
|
538
|
+
const json = await this.rpc("deploy.workerUploadUrls", "Failed to request worker upload URLs", {
|
|
539
|
+
projectId,
|
|
540
|
+
modules
|
|
541
|
+
}, { permission: "deploy" });
|
|
542
|
+
if (typeof json?.id !== "string" || !json.id || !Array.isArray(json.urls) || json.urls.length !== modules.length || !json.urls.every((entry) => typeof entry?.url === "string" && typeof entry.headers === "object" && !!entry.headers)) throw new Error("Invalid worker upload URLs from platform.");
|
|
543
|
+
return {
|
|
544
|
+
id: json.id,
|
|
545
|
+
urls: json.urls
|
|
546
|
+
};
|
|
547
|
+
}
|
|
548
|
+
async *finalizeDeploy(projectId, payload) {
|
|
549
|
+
const cliLog = this.cliLog;
|
|
550
|
+
const idempotencyKey = crypto.randomUUID();
|
|
551
|
+
cliLog?.info("deploy_post", { projectId });
|
|
552
|
+
let deploymentId;
|
|
553
|
+
let inline;
|
|
554
|
+
let attempt = 0;
|
|
555
|
+
while (true) try {
|
|
556
|
+
({deploymentId, events: inline} = await this.rpc("deploy.finalize", "Deploy failed", {
|
|
557
|
+
projectId,
|
|
558
|
+
body: payload,
|
|
559
|
+
idempotencyKey
|
|
560
|
+
}, { permission: "deploy" }));
|
|
561
|
+
break;
|
|
562
|
+
} catch (err) {
|
|
563
|
+
if (err instanceof PlatformApiError) {
|
|
564
|
+
const parsed = err.status === 409 ? parsePlatformErrorBody(err.body) : null;
|
|
565
|
+
const inFlight = /deployment ([A-Za-z0-9_-]{1,128})$/.exec(parsed?.message ?? "")?.[1];
|
|
566
|
+
if (parsed?.error === "deploy_in_progress" && inFlight) {
|
|
567
|
+
cliLog?.warn("deploy_conflict", {
|
|
568
|
+
projectId,
|
|
569
|
+
deploymentId: inFlight
|
|
570
|
+
});
|
|
571
|
+
yield {
|
|
572
|
+
event: "error",
|
|
573
|
+
step: "finalize",
|
|
574
|
+
message: `${parsed.message} — it may be an earlier attempt of this deploy or a concurrent one; inspect with \`bwf project status\` before redeploying`
|
|
575
|
+
};
|
|
576
|
+
return;
|
|
577
|
+
}
|
|
578
|
+
throw err;
|
|
579
|
+
}
|
|
580
|
+
if (!(err instanceof TypeError) || attempt >= DEPLOY_POST_MAX_RETRIES) {
|
|
581
|
+
cliLog?.error("deploy_fetch_rejected", err, {
|
|
582
|
+
projectId,
|
|
583
|
+
attempts: attempt + 1
|
|
584
|
+
});
|
|
585
|
+
throw err;
|
|
586
|
+
}
|
|
587
|
+
cliLog?.warn("deploy_fetch_retry", {
|
|
588
|
+
projectId,
|
|
589
|
+
attempt: attempt + 1,
|
|
590
|
+
delayMs: DEPLOY_POST_BACKOFF_MS[attempt],
|
|
591
|
+
error: err instanceof Error ? err.message : String(err)
|
|
592
|
+
});
|
|
593
|
+
await sleep(DEPLOY_POST_BACKOFF_MS[attempt]);
|
|
594
|
+
attempt++;
|
|
595
|
+
}
|
|
596
|
+
if (deploymentId === void 0) {
|
|
597
|
+
const failure = (inline ?? []).map(parseDeployEvent).find((event) => event.event === "error");
|
|
598
|
+
if (failure) {
|
|
599
|
+
yield failure;
|
|
600
|
+
return;
|
|
601
|
+
}
|
|
602
|
+
throw new Error("Platform returned no deployment receipt.");
|
|
603
|
+
}
|
|
604
|
+
if (!/^[A-Za-z0-9_-]{1,128}$/.test(deploymentId)) throw new Error("Invalid deployment receipt from platform.");
|
|
605
|
+
yield {
|
|
606
|
+
event: "start",
|
|
607
|
+
deploymentId
|
|
608
|
+
};
|
|
609
|
+
let cursor = 0;
|
|
610
|
+
for (const raw of inline ?? []) {
|
|
611
|
+
const event = parseDeployEvent(raw);
|
|
612
|
+
if (event.seq !== void 0) {
|
|
613
|
+
if (event.seq <= cursor) continue;
|
|
614
|
+
cursor = event.seq;
|
|
615
|
+
}
|
|
616
|
+
if (event.event === "start") continue;
|
|
617
|
+
yield event;
|
|
618
|
+
if (event.event === "done" || event.event === "error") return;
|
|
619
|
+
}
|
|
620
|
+
yield* this.followDeploymentEvents(projectId, deploymentId, cursor, Date.now() + DEPLOY_OBSERVATION_DEADLINE_MS);
|
|
621
|
+
}
|
|
622
|
+
async *followDeploymentEvents(projectId, deploymentId, since, deadline) {
|
|
623
|
+
let cursor = since;
|
|
624
|
+
let failures = 0;
|
|
625
|
+
while (Date.now() < deadline) {
|
|
626
|
+
let page;
|
|
627
|
+
try {
|
|
628
|
+
page = await this.rpc("deployments.events", "Failed to observe deployment", {
|
|
629
|
+
projectId,
|
|
630
|
+
deploymentId,
|
|
631
|
+
since: cursor
|
|
632
|
+
}, {
|
|
633
|
+
permission: "read",
|
|
634
|
+
signal: AbortSignal.timeout(Math.max(1, Math.min(DEPLOY_OBSERVATION_TIMEOUT_MS, deadline - Date.now())))
|
|
635
|
+
});
|
|
636
|
+
if (Date.now() >= deadline) throw new DeploymentObservationTimeoutError(deploymentId);
|
|
637
|
+
} catch (err) {
|
|
638
|
+
if (!(err instanceof TypeError || err instanceof DOMException && err.name === "TimeoutError" || err instanceof PlatformApiError && (err.status === 429 || err.status >= 500)) || failures >= DEPLOY_OBSERVATION_BACKOFF_MS.length) throw err;
|
|
639
|
+
const delayMs = DEPLOY_OBSERVATION_BACKOFF_MS[failures++];
|
|
640
|
+
this.cliLog?.warn("deploy_observation_retry", {
|
|
641
|
+
deploymentId,
|
|
642
|
+
cursor,
|
|
643
|
+
delayMs
|
|
644
|
+
});
|
|
645
|
+
await sleep(Math.min(delayMs, Math.max(0, deadline - Date.now())));
|
|
646
|
+
continue;
|
|
647
|
+
}
|
|
648
|
+
failures = 0;
|
|
649
|
+
if (!page || page.deploymentId !== deploymentId || !Array.isArray(page.events) || page.events.length > 1e3 || !Number.isSafeInteger(page.lastSeq) || page.lastSeq < cursor || typeof page.terminal !== "boolean") throw new Error("Invalid deployment observation response from platform.");
|
|
650
|
+
let previousSeq = 0;
|
|
651
|
+
for (const row of page.events) {
|
|
652
|
+
if (!row || !Number.isSafeInteger(row.seq) || row.seq <= previousSeq || row.seq > page.lastSeq) throw new Error("Invalid deployment observation sequence from platform.");
|
|
653
|
+
previousSeq = row.seq;
|
|
654
|
+
const event = parseDeployEvent(row.event);
|
|
655
|
+
if (row.seq <= cursor) continue;
|
|
656
|
+
cursor = row.seq;
|
|
657
|
+
if (event.event !== "start") yield event;
|
|
658
|
+
if (event.event === "done" || event.event === "error") return;
|
|
659
|
+
}
|
|
660
|
+
if (page.terminal) throw new Error("Platform finished deployment without a terminal result.");
|
|
661
|
+
if (page.heartbeat !== void 0) {
|
|
662
|
+
const heartbeat = parseDeployEvent(page.heartbeat);
|
|
663
|
+
if (heartbeat.event !== "heartbeat" || heartbeat.deploymentId !== void 0 && heartbeat.deploymentId !== deploymentId) throw new DeploymentProtocolError("Invalid deployment observation heartbeat.");
|
|
664
|
+
yield heartbeat;
|
|
665
|
+
}
|
|
666
|
+
await sleep(Math.min(1e3, Math.max(0, deadline - Date.now())));
|
|
667
|
+
}
|
|
668
|
+
throw new DeploymentObservationTimeoutError(deploymentId);
|
|
669
|
+
}
|
|
670
|
+
async listSecrets(projectId) {
|
|
671
|
+
return this.rpc("secrets.list", "Failed to list secrets", { projectId }, { permission: "configure" });
|
|
672
|
+
}
|
|
673
|
+
async setSecret(projectId, name, value) {
|
|
674
|
+
return this.rpc("secrets.set", "Failed to set secret", {
|
|
675
|
+
projectId,
|
|
676
|
+
name,
|
|
677
|
+
value
|
|
678
|
+
}, { permission: "configure" });
|
|
679
|
+
}
|
|
680
|
+
async deleteProject(projectId) {
|
|
681
|
+
return this.json(`${this.baseUrl}/projects/${projectId}`, "Failed to delete project", {
|
|
682
|
+
method: "DELETE",
|
|
683
|
+
permission: "owner"
|
|
684
|
+
});
|
|
685
|
+
}
|
|
686
|
+
async getMigrationStatus(projectId, dialect) {
|
|
687
|
+
const url = new URL(`${this.baseUrl}/projects/${projectId}/migrations`);
|
|
688
|
+
if (dialect) url.searchParams.set("dialect", dialect);
|
|
689
|
+
return this.json(url, "Failed to get migration status", { permission: "read" });
|
|
690
|
+
}
|
|
691
|
+
async applyRemoteMigrations(projectId, migrations) {
|
|
692
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/migrations/apply`, "Failed to apply remote migrations", {
|
|
693
|
+
method: "POST",
|
|
694
|
+
body: { migrations },
|
|
695
|
+
permission: "configure"
|
|
696
|
+
});
|
|
697
|
+
}
|
|
698
|
+
async renameMigrations(projectId, renames) {
|
|
699
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/migrations/rename`, "Failed to rename remote migrations", {
|
|
700
|
+
method: "POST",
|
|
701
|
+
body: { renames },
|
|
702
|
+
permission: "configure"
|
|
703
|
+
});
|
|
704
|
+
}
|
|
705
|
+
async addDomain(projectId, hostname) {
|
|
706
|
+
return this.rpc("domains.add", "Failed to add domain", {
|
|
707
|
+
projectId,
|
|
708
|
+
hostname
|
|
709
|
+
}, { permission: "settings" });
|
|
710
|
+
}
|
|
711
|
+
async listDomains(projectId) {
|
|
712
|
+
return this.rpc("domains.list", "Failed to list domains", { projectId }, { permission: "read" });
|
|
713
|
+
}
|
|
714
|
+
async getDomainStatus(projectId, domainId) {
|
|
715
|
+
return this.rpc("domains.status", "Failed to get domain status", {
|
|
716
|
+
projectId,
|
|
717
|
+
domainId
|
|
718
|
+
}, { permission: "read" });
|
|
719
|
+
}
|
|
720
|
+
async removeDomain(projectId, domainId) {
|
|
721
|
+
return this.rpc("domains.remove", "Failed to remove domain", {
|
|
722
|
+
projectId,
|
|
723
|
+
domainId
|
|
724
|
+
}, { permission: "settings" });
|
|
725
|
+
}
|
|
726
|
+
async deleteSecret(projectId, name) {
|
|
727
|
+
return this.rpc("secrets.delete", "Failed to delete secret", {
|
|
728
|
+
projectId,
|
|
729
|
+
name
|
|
730
|
+
}, { permission: "configure" });
|
|
731
|
+
}
|
|
732
|
+
async getResources(projectId) {
|
|
733
|
+
return this.rpc("projects.resources", "Failed to get resources", { projectId }, { permission: "read" });
|
|
734
|
+
}
|
|
735
|
+
async provisionDatabase(projectId, connectionString) {
|
|
736
|
+
return this.rpc("database.provision", "Failed to provision database", {
|
|
737
|
+
projectId,
|
|
738
|
+
connectionString
|
|
739
|
+
}, { permission: "configure" });
|
|
740
|
+
}
|
|
741
|
+
async setDatabaseUrl(projectId, connectionString) {
|
|
742
|
+
return this.rpc("database.setUrl", "Failed to update database URL", {
|
|
743
|
+
projectId,
|
|
744
|
+
connectionString
|
|
745
|
+
}, { permission: "configure" });
|
|
746
|
+
}
|
|
747
|
+
async getDatabaseUrl(projectId) {
|
|
748
|
+
return this.rpc("database.getUrl", "Failed to fetch database URL", { projectId }, { permission: "owner" });
|
|
749
|
+
}
|
|
750
|
+
async getLogs(projectId, since, limit = 200, deploymentId, level) {
|
|
751
|
+
const params = new URLSearchParams({
|
|
752
|
+
since,
|
|
753
|
+
limit: String(limit)
|
|
754
|
+
});
|
|
755
|
+
if (deploymentId) params.set("deploymentId", deploymentId);
|
|
756
|
+
if (level && level !== "all") params.set("level", level);
|
|
757
|
+
const json = await this.json(`${this.baseUrl}/projects/${projectId}/logs?${params}`, "Failed to fetch logs", { permission: "read" });
|
|
758
|
+
return {
|
|
759
|
+
entries: json.data,
|
|
760
|
+
...json.runtimeLogs === "minimal" ? { runtimeLogs: "minimal" } : {}
|
|
761
|
+
};
|
|
762
|
+
}
|
|
763
|
+
async getRequests(projectId, since, limit = 200, status) {
|
|
764
|
+
const params = new URLSearchParams({
|
|
765
|
+
since,
|
|
766
|
+
limit: String(limit)
|
|
767
|
+
});
|
|
768
|
+
if (status && status !== "all") params.set("status", status);
|
|
769
|
+
return (await this.json(`${this.baseUrl}/projects/${projectId}/requests?${params}`, "Failed to fetch requests", { permission: "read" })).data;
|
|
770
|
+
}
|
|
771
|
+
async listBuilds(projectId, limit = 20) {
|
|
772
|
+
const params = new URLSearchParams({ limit: String(limit) });
|
|
773
|
+
return (await this.json(`${this.baseUrl}/projects/${projectId}/builds?${params}`, "Failed to list builds", { permission: "read" })).builds;
|
|
774
|
+
}
|
|
775
|
+
async getBuildLogs(projectId, buildId, since = 0) {
|
|
776
|
+
const params = new URLSearchParams({ since: String(since) });
|
|
777
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/builds/${buildId}/logs?${params}`, "Failed to fetch build logs", { permission: "read" });
|
|
778
|
+
}
|
|
779
|
+
async getGithubInstallUrl() {
|
|
780
|
+
return this.json(`${this.baseUrl}/github/install-url`, "Failed to get GitHub install URL");
|
|
781
|
+
}
|
|
782
|
+
async listGithubInstallations() {
|
|
783
|
+
return this.json(`${this.baseUrl}/github/installations`, "Failed to list GitHub installations");
|
|
784
|
+
}
|
|
785
|
+
async connectGithub(projectId, body) {
|
|
786
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/github`, "Failed to connect GitHub repository", {
|
|
787
|
+
method: "POST",
|
|
788
|
+
body,
|
|
789
|
+
permission: "settings"
|
|
790
|
+
});
|
|
791
|
+
}
|
|
792
|
+
/**
|
|
793
|
+
* Start the per-repo connect authorization for a non-owner org member. The
|
|
794
|
+
* callback carries `?connect_grant=<signed>` or `?error=repo_not_accessible`.
|
|
795
|
+
*/
|
|
796
|
+
async getGithubConnectAuthorizeUrl(redirect, codeChallenge, installationId, repoFullName) {
|
|
797
|
+
const params = new URLSearchParams({
|
|
798
|
+
redirect,
|
|
799
|
+
code_challenge: codeChallenge,
|
|
800
|
+
code_challenge_method: "S256",
|
|
801
|
+
installationId,
|
|
802
|
+
repoFullName
|
|
803
|
+
});
|
|
804
|
+
return this.json(`${this.baseUrl}/github/connect-authorize-url?${params}`, "Failed to start GitHub connect authorization");
|
|
805
|
+
}
|
|
806
|
+
async getGithubConnection(projectId) {
|
|
807
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/github`, "Failed to get GitHub connection", { permission: "read" });
|
|
808
|
+
}
|
|
809
|
+
async updateGithubConnection(projectId, body) {
|
|
810
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/github`, "Failed to update GitHub connection", {
|
|
811
|
+
method: "PATCH",
|
|
812
|
+
body,
|
|
813
|
+
permission: "settings"
|
|
814
|
+
});
|
|
815
|
+
}
|
|
816
|
+
async deleteGithubConnection(projectId) {
|
|
817
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/github`, "Failed to disconnect GitHub repository", {
|
|
818
|
+
method: "DELETE",
|
|
819
|
+
permission: "settings"
|
|
820
|
+
});
|
|
821
|
+
}
|
|
822
|
+
async getGithubLinkUrl(redirect, codeChallenge) {
|
|
823
|
+
const params = new URLSearchParams({
|
|
824
|
+
redirect,
|
|
825
|
+
code_challenge: codeChallenge,
|
|
826
|
+
code_challenge_method: "S256"
|
|
827
|
+
});
|
|
828
|
+
return this.json(`${this.baseUrl}/github/link-url?${params}`, "Failed to start GitHub link");
|
|
829
|
+
}
|
|
830
|
+
async completeGithubLink(linkCode, codeVerifier) {
|
|
831
|
+
return this.json(`${this.baseUrl}/github/link/complete`, "Failed to complete GitHub link", {
|
|
832
|
+
method: "POST",
|
|
833
|
+
body: {
|
|
834
|
+
link_code: linkCode,
|
|
835
|
+
code_verifier: codeVerifier
|
|
836
|
+
}
|
|
837
|
+
});
|
|
838
|
+
}
|
|
839
|
+
async getGithubJoinUrl(redirect, codeChallenge) {
|
|
840
|
+
const params = new URLSearchParams({
|
|
841
|
+
redirect,
|
|
842
|
+
code_challenge: codeChallenge,
|
|
843
|
+
code_challenge_method: "S256"
|
|
844
|
+
});
|
|
845
|
+
return this.json(`${this.baseUrl}/github/join-url?${params}`, "Failed to start GitHub join");
|
|
846
|
+
}
|
|
847
|
+
async completeGithubJoin(joinCode, codeVerifier) {
|
|
848
|
+
return this.json(`${this.baseUrl}/github/join/complete`, "Failed to complete GitHub join", {
|
|
849
|
+
method: "POST",
|
|
850
|
+
body: {
|
|
851
|
+
join_code: joinCode,
|
|
852
|
+
code_verifier: codeVerifier
|
|
853
|
+
}
|
|
854
|
+
});
|
|
855
|
+
}
|
|
856
|
+
async getEmailUsage(projectId) {
|
|
857
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/email/usage`, "Failed to fetch email usage", { permission: "read" });
|
|
858
|
+
}
|
|
859
|
+
async getEmailLogs(projectId, limit) {
|
|
860
|
+
const url = new URL(`${this.baseUrl}/projects/${projectId}/email/logs`);
|
|
861
|
+
if (limit !== void 0) url.searchParams.set("limit", String(limit));
|
|
862
|
+
return this.json(url, "Failed to fetch email logs", { permission: "read" });
|
|
863
|
+
}
|
|
864
|
+
async getEmailOperation(projectId, operationId) {
|
|
865
|
+
return this.json(`${this.baseUrl}/projects/${encodeURIComponent(projectId)}/email/operations/${encodeURIComponent(operationId)}`, "Failed to fetch email operation", { permission: "read" });
|
|
866
|
+
}
|
|
867
|
+
async listEmailDestinations(projectId) {
|
|
868
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/email/destinations`, "Failed to list email destinations", { permission: "read" });
|
|
869
|
+
}
|
|
870
|
+
async addEmailDestination(projectId, address) {
|
|
871
|
+
const res = await this.call(`${this.baseUrl}/projects/${projectId}/email/destinations`, "Failed to add email destination", {
|
|
872
|
+
method: "POST",
|
|
873
|
+
body: { address },
|
|
874
|
+
permission: "settings"
|
|
875
|
+
});
|
|
876
|
+
return {
|
|
877
|
+
...await res.json(),
|
|
878
|
+
created: res.status === 201
|
|
879
|
+
};
|
|
880
|
+
}
|
|
881
|
+
async removeEmailDestination(projectId, destinationId) {
|
|
882
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/email/destinations/${destinationId}`, "Failed to remove email destination", {
|
|
883
|
+
method: "DELETE",
|
|
884
|
+
permission: "settings"
|
|
885
|
+
});
|
|
886
|
+
}
|
|
887
|
+
/** Installation email settings the CLI reads before starting a credential flow. */
|
|
888
|
+
async getEmailSettings(projectId) {
|
|
889
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/email/settings`, "Failed to read email settings", { permission: "read" });
|
|
890
|
+
}
|
|
891
|
+
async setEmailAlias(projectId, alias) {
|
|
892
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/email/alias`, "Failed to set the email alias", {
|
|
893
|
+
method: "PUT",
|
|
894
|
+
body: { alias },
|
|
895
|
+
permission: "settings"
|
|
896
|
+
});
|
|
897
|
+
}
|
|
898
|
+
async listEmailDomains(projectId) {
|
|
899
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/email/domains`, "Failed to list email domains", { permission: "read" });
|
|
900
|
+
}
|
|
901
|
+
/** Submit a scoped token once; later operations address the domain without it. */
|
|
902
|
+
async addEmailDomain(projectId, input) {
|
|
903
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/email/domains`, "Failed to add email domain", {
|
|
904
|
+
method: "POST",
|
|
905
|
+
body: {
|
|
906
|
+
domain: input.domain,
|
|
907
|
+
...input.apiToken !== void 0 ? { apiToken: input.apiToken } : {},
|
|
908
|
+
...input.attemptId !== void 0 ? { attemptId: input.attemptId } : {}
|
|
909
|
+
},
|
|
910
|
+
permission: "settings"
|
|
911
|
+
});
|
|
912
|
+
}
|
|
913
|
+
async getEmailDomain(projectId, domain) {
|
|
914
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/email/domains/${encodeURIComponent(domain)}`, "Failed to fetch email domain status", { permission: "read" });
|
|
915
|
+
}
|
|
916
|
+
/** Rotates the shared zone connection secret. */
|
|
917
|
+
async rotateEmailDomainSecret(projectId, domain, attemptId) {
|
|
918
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/email/domains/${encodeURIComponent(domain)}/rotate-secret`, "Failed to rotate email connection secret", {
|
|
919
|
+
method: "POST",
|
|
920
|
+
body: { attemptId },
|
|
921
|
+
permission: "settings"
|
|
922
|
+
});
|
|
923
|
+
}
|
|
924
|
+
async syncEmailDomain(projectId, domain) {
|
|
925
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/email/domains/${encodeURIComponent(domain)}/sync`, "Failed to sync email domain", {
|
|
926
|
+
method: "POST",
|
|
927
|
+
permission: "settings"
|
|
928
|
+
});
|
|
929
|
+
}
|
|
930
|
+
async removeEmailDomain(projectId, domain) {
|
|
931
|
+
return this.json(`${this.baseUrl}/projects/${projectId}/email/domains/${encodeURIComponent(domain)}`, "Failed to remove email domain", {
|
|
932
|
+
method: "DELETE",
|
|
933
|
+
permission: "settings"
|
|
934
|
+
});
|
|
935
|
+
}
|
|
936
|
+
};
|
|
937
|
+
function sleep(ms) {
|
|
938
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
939
|
+
}
|
|
940
|
+
export { isExpiredTokenError as a, parsePlatformErrorBody as c, isCliOutdatedError as i, platformErrorMessage as l, PlatformApiError as n, isHeadersTimeoutError as o, PlatformClient as r, isOlderPlatformVersion as s, MIN_PLATFORM_VERSION as t };
|