@builtbyfriends/bwf 0.0.0-stage → 1.9.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (448) hide show
  1. package/AGENTS_TEMPLATE.md +4 -0
  2. package/LICENSE +22 -0
  3. package/README.md +48 -2
  4. package/dist/account-cmd-Ddt8lGeL.mjs +45 -0
  5. package/dist/agents-BLiMq9E1.mjs +113 -0
  6. package/dist/application-analysis-C9Ck2Yeg.mjs +1498 -0
  7. package/dist/application-routing-DbR-W5lG.mjs +25 -0
  8. package/dist/atomic-write-DA6eD1Kp.mjs +17 -0
  9. package/dist/auth-BKsUmWbT.d.mts +77 -0
  10. package/dist/auth-DkvoW5hB.mjs +33 -0
  11. package/dist/auth-aKyIWkdS.mjs +1 -0
  12. package/dist/auth-client-6-Ft9i9T.d.mts +5 -0
  13. package/dist/auth-client-DwCdwKbw.mjs +5 -0
  14. package/dist/auth-client-react-CJdeErvM.mjs +5 -0
  15. package/dist/auth-client-react-DvQLe5Zb.d.mts +5 -0
  16. package/dist/auth-link-CCl-hJol.mjs +26 -0
  17. package/dist/auth-migrations-DDeifS3v.mjs +206 -0
  18. package/dist/auth-router-BG74WFUf.mjs +66 -0
  19. package/dist/auth-xnkmpZUl.mjs +311 -0
  20. package/dist/base64-ikl9yBy3.mjs +15 -0
  21. package/dist/better-auth-shared-Br6TNaYJ.mjs +473 -0
  22. package/dist/better-auth-shared-CsBNvPOU.d.mts +56 -0
  23. package/dist/build-cmd-BnZezraT.mjs +153 -0
  24. package/dist/build-output-dir-Clj_unKN.mjs +402 -0
  25. package/dist/cancel-deploy-DKAj5U1Z.mjs +57 -0
  26. package/dist/cf-access-Bhz9wX6p.mjs +131 -0
  27. package/dist/cf-access-CUP5L08W.mjs +67 -0
  28. package/dist/cf-build-output-DA6uJomQ.mjs +1 -0
  29. package/dist/cf-build-output-DNQTwMNU.mjs +438 -0
  30. package/dist/cf-command-values-2kOtxMo1.mjs +26 -0
  31. package/dist/cf-config-migrate-COOCi4Ge.mjs +330 -0
  32. package/dist/cf-worker-settings-CIh4t_yG.mjs +41 -0
  33. package/dist/cli/cli.d.mts +1 -0
  34. package/dist/cli/cli.mjs +88 -0
  35. package/dist/cli/cloudflare-operation-process.d.mts +1 -0
  36. package/dist/cli/cloudflare-operation-process.mjs +1284 -0
  37. package/dist/cli/env-schema-probe.d.mts +43 -0
  38. package/dist/cli/env-schema-probe.mjs +165 -0
  39. package/dist/cli-main-BfYf6fnB.mjs +1846 -0
  40. package/dist/client-D3D5RM5h.mjs +940 -0
  41. package/dist/client-VF2Nzc7Z.mjs +1 -0
  42. package/dist/cloudflare-auth-DzkU9H6r.mjs +152 -0
  43. package/dist/cloudflare-cmd-Bm6UhzAQ.mjs +59 -0
  44. package/dist/cloudflare-config-i8yanry0.mjs +186 -0
  45. package/dist/cloudflare-connect-B4ItSbJi.mjs +55 -0
  46. package/dist/cloudflare-operations-BcK849ue.mjs +1 -0
  47. package/dist/cloudflare-operations-DGF7xH7O.mjs +627 -0
  48. package/dist/cloudflare-process-tThIjEB2.mjs +309 -0
  49. package/dist/cloudflare-user-output-CqONaAbP.mjs +19 -0
  50. package/dist/collect-8i0wU63d.mjs +1 -0
  51. package/dist/collect-C6Blu9yw.mjs +48 -0
  52. package/dist/config-CN_RFRkS.mjs +86 -0
  53. package/dist/config-D5G-Tx6o.mjs +1 -0
  54. package/dist/config-DOaFIK3w.mjs +88 -0
  55. package/dist/config-entry.d.mts +202 -0
  56. package/dist/config-entry.mjs +6 -0
  57. package/dist/config-tNx0HlFv.mjs +516 -0
  58. package/dist/connect-CSNWKLzB.mjs +84 -0
  59. package/dist/create-project-B35ux-LA.mjs +126 -0
  60. package/dist/create-project-tJ1KwNss.mjs +1 -0
  61. package/dist/database-provider-DkZo4VwN.mjs +5 -0
  62. package/dist/database-provider.d.mts +25 -0
  63. package/dist/database-provider.mjs +1 -0
  64. package/dist/db-SOv4E9wr.mjs +1735 -0
  65. package/dist/delete-BSKI7V23.mjs +65 -0
  66. package/dist/deploy-BCSQoKC0.mjs +2 -0
  67. package/dist/deploy-CWJ3JJs_.mjs +6512 -0
  68. package/dist/deploy.d.mts +31 -0
  69. package/dist/deploy.mjs +118 -0
  70. package/dist/dev-inbox-I0nqTCdf.mjs +216 -0
  71. package/dist/discover-DJPmQcL5.mjs +36 -0
  72. package/dist/discover-EVuydEoM.mjs +1 -0
  73. package/dist/dist-B6eN80gc.mjs +1612 -0
  74. package/dist/dist-Cp4b1_T9.mjs +1 -0
  75. package/dist/dist-DMYe8CZJ.mjs +48 -0
  76. package/dist/dist-STQXl8ck.mjs +1878 -0
  77. package/dist/domain-BJaAbxuQ.mjs +149 -0
  78. package/dist/dotenv-4NdUCXbB.mjs +156 -0
  79. package/dist/drizzle-DqVFXtlc.mjs +306 -0
  80. package/dist/drizzle-Ds5P0n-S.mjs +1 -0
  81. package/dist/edge.d.mts +2 -0
  82. package/dist/edge.mjs +1 -0
  83. package/dist/email-C_ATvNIG.mjs +2865 -0
  84. package/dist/email-cloudflare-oXk2G1G3.mjs +854 -0
  85. package/dist/email-protocol-CZ0bAkI8.mjs +81 -0
  86. package/dist/email-rIfZgVAB.mjs +742 -0
  87. package/dist/env-BGTu3KWZ.mjs +73 -0
  88. package/dist/env-DUyTzroe.mjs +88 -0
  89. package/dist/env-Dl4Wggec.mjs +71 -0
  90. package/dist/env-helpers-BX0APszT.mjs +135 -0
  91. package/dist/env-helpers-U56xuFgL.d.mts +20 -0
  92. package/dist/env-mask-BsHxq3R8.mjs +46 -0
  93. package/dist/env-public-Cw_xPi1D.d.mts +119 -0
  94. package/dist/env-raw-Bo6TtrHU.mjs +41 -0
  95. package/dist/env-types-Bg-dTh8u.mjs +56 -0
  96. package/dist/env-validation-BlXzGgLZ.mjs +1 -0
  97. package/dist/env-validation-DeqFUSKg.mjs +488 -0
  98. package/dist/fetch-CBgyyhzm.d.mts +87 -0
  99. package/dist/fetch-error-DmlRM6e4.mjs +264 -0
  100. package/dist/fetch-stream-2GUN3YN1.mjs +102 -0
  101. package/dist/fetch-stream-bUXynOyZ.d.mts +32 -0
  102. package/dist/fetch-tpPiSK10.mjs +25 -0
  103. package/dist/gen-dc13IRXh.mjs +509 -0
  104. package/dist/gen-kQqhFyOP.mjs +1 -0
  105. package/dist/generate-BgtlYpKg.mjs +1 -0
  106. package/dist/generate-Da9mWKzU.mjs +80 -0
  107. package/dist/generated-wrangler-config-CoDaaFsA.mjs +17 -0
  108. package/dist/git-metadata-Cukp5kV5.mjs +82 -0
  109. package/dist/github-cmd-DT5Onu6E.mjs +690 -0
  110. package/dist/handler-B_ocHStk.d.mts +279 -0
  111. package/dist/handler-CNq7aSs1.mjs +161 -0
  112. package/dist/help-BK35YcRa.mjs +1946 -0
  113. package/dist/help-DaRezBj7.mjs +1 -0
  114. package/dist/inbound-CqubE-9T.d.mts +311 -0
  115. package/dist/inbound-lHugZPuK.mjs +509 -0
  116. package/dist/index.d.mts +64 -0
  117. package/dist/index.mjs +4163 -0
  118. package/dist/info-CLQoCenb.mjs +109 -0
  119. package/dist/init-CXanf5ck.mjs +2486 -0
  120. package/dist/limits-CMmYT2l8.d.mts +16 -0
  121. package/dist/limits-D27Lp6FP.mjs +46 -0
  122. package/dist/link-DinwJnon.mjs +52 -0
  123. package/dist/list-B1WAE9Wt.mjs +130 -0
  124. package/dist/live-KkEeda1Z.d.mts +105 -0
  125. package/dist/live-saC8barp.mjs +410 -0
  126. package/dist/load-user-env-g0ahkZcj.mjs +34 -0
  127. package/dist/local-d1-bUoAtFUe.mjs +103 -0
  128. package/dist/log-JDnPc0cF.mjs +23 -0
  129. package/dist/login-BUzyiyHV.mjs +1 -0
  130. package/dist/login-Dbv_T3Ru.mjs +87 -0
  131. package/dist/logs-BjMJooJQ.mjs +129 -0
  132. package/dist/migrate-DjW9_-sS.mjs +1 -0
  133. package/dist/migrate-DtcfKqPW.mjs +125 -0
  134. package/dist/migration-handler-22qiuWPq.mjs +469 -0
  135. package/dist/migration-handler-Bb2BJh6g.d.mts +38 -0
  136. package/dist/mime-BMUN_QKG.mjs +1004 -0
  137. package/dist/mysql-migration-sql-CNuBSqdx.mjs +239 -0
  138. package/dist/neon-CJzQSycr.mjs +52 -0
  139. package/dist/node-tfv-3v0V.mjs +64 -0
  140. package/dist/operator-ai-logging-Ay7M4KWw.mjs +121 -0
  141. package/dist/operator-args-BiGmSlZx.mjs +722 -0
  142. package/dist/operator-auth-DdYZYEkO.mjs +47 -0
  143. package/dist/operator-client-DBujdELO.mjs +82 -0
  144. package/dist/operator-cmd-BsHKYJYt.mjs +1 -0
  145. package/dist/operator-cmd-DTIkOAnP.mjs +443 -0
  146. package/dist/output-Bb34lF0w.mjs +173 -0
  147. package/dist/output-CVolXKC1.mjs +1 -0
  148. package/dist/package-BX_giUBX.mjs +1444 -0
  149. package/dist/package-json-DvS6IFRv.mjs +43 -0
  150. package/dist/pg-DoyPxa_X.mjs +15 -0
  151. package/dist/picocolors-D1NxSLw-.mjs +71 -0
  152. package/dist/plan-BHNt1QhK.mjs +1 -0
  153. package/dist/plan-DX4_-OM5.mjs +58 -0
  154. package/dist/platform-args-C-DyuCNX.mjs +1 -0
  155. package/dist/platform-args-CyeQWaZ7.mjs +538 -0
  156. package/dist/platform-auth-config-BfXqKSyZ.mjs +371 -0
  157. package/dist/platform-auth-protection-5FR6qoP_.mjs +231 -0
  158. package/dist/platform-auth-recovery-B5ZlqA8K.mjs +309 -0
  159. package/dist/platform-cmd-CcFDxtrl.mjs +1 -0
  160. package/dist/platform-cmd-ChXeBrRH.mjs +193 -0
  161. package/dist/platform-discovery-Bxg9aZXU.mjs +40 -0
  162. package/dist/platform-domain-CwatS3cz.mjs +256 -0
  163. package/dist/platform-lifecycle-0cXTmMsh.mjs +8928 -0
  164. package/dist/platform-lifecycle-BcoBAMux.mjs +1 -0
  165. package/dist/platform-management-6Wbdbob5.mjs +1607 -0
  166. package/dist/platform-management-hhnczOzr.mjs +1 -0
  167. package/dist/platform-plans-config-CkbUKFpm.mjs +447 -0
  168. package/dist/platform-recovery-DgIwlqB-.mjs +96 -0
  169. package/dist/platform-registry-x1m9HBxf.mjs +450 -0
  170. package/dist/platform-runtime-logs-kkoiYFpF.mjs +72 -0
  171. package/dist/platform-setup-DX8y_6Kh.mjs +306 -0
  172. package/dist/prepare-B9mB47T5.mjs +84 -0
  173. package/dist/prepare-DNIq07so.mjs +13 -0
  174. package/dist/prepare-LHkyJqxi.mjs +1 -0
  175. package/dist/project-CC7eN00D.mjs +141 -0
  176. package/dist/project-DcSd4BeI.mjs +1 -0
  177. package/dist/project-cmd-BydRwr-x.mjs +109 -0
  178. package/dist/project-paths-iXHKRTTQ.mjs +159 -0
  179. package/dist/project-slug-BUy0lmyR.mjs +1 -0
  180. package/dist/project-slug-CO6ci9XG.mjs +7 -0
  181. package/dist/project-team-CvdLhDF2.mjs +129 -0
  182. package/dist/project-token-CwZdUEGu.mjs +70 -0
  183. package/dist/project-tsconfig-P9X952KG.mjs +98 -0
  184. package/dist/project-zero-trust-CKDoPdN1.mjs +64 -0
  185. package/dist/providers-Cd3c7wi0.mjs +64 -0
  186. package/dist/providers-Df69hb_X.d.mts +5 -0
  187. package/dist/provision-BA59NCPO.mjs +1 -0
  188. package/dist/provision-C90fULHJ.mjs +1814 -0
  189. package/dist/queues-Bc3FsBQT.d.mts +5 -0
  190. package/dist/r2-conditions-DSLmkiR5.mjs +60 -0
  191. package/dist/requests-DNhfyF3l.mjs +52 -0
  192. package/dist/resolve-project-BCsAMDRA.mjs +47 -0
  193. package/dist/resolve-project-DhU9_lIo.mjs +1 -0
  194. package/dist/resource-name-DlJ9QXzg.mjs +10 -0
  195. package/dist/response-HmNjB30w.mjs +29 -0
  196. package/dist/rollback-wi6WK5T6.mjs +150 -0
  197. package/dist/rolldown-runtime-uD8oG6U2.mjs +24 -0
  198. package/dist/route-types-CRWhr93D.mjs +592 -0
  199. package/dist/route-url-BIDZT78M.mjs +58 -0
  200. package/dist/route-url-Bla3Upsy.d.mts +42 -0
  201. package/dist/routes-stub.d.mts +24 -0
  202. package/dist/routes-stub.mjs +1 -0
  203. package/dist/routing-assets-CSheDWWM.mjs +54 -0
  204. package/dist/rpc-DcByS_q0.d.mts +39 -0
  205. package/dist/rpc-DtxIN9Tv.mjs +19 -0
  206. package/dist/runner-CPerdjIl.mjs +163 -0
  207. package/dist/runner-CUNtS5x7.mjs +1 -0
  208. package/dist/runner-mysql-BjSoQ-mW.mjs +1 -0
  209. package/dist/runner-mysql-BmTI2EiF.mjs +145 -0
  210. package/dist/runner-pg-2pjltt0t.mjs +1 -0
  211. package/dist/runner-pg-mYc75KfH.mjs +61 -0
  212. package/dist/runtime/ai.d.mts +50 -0
  213. package/dist/runtime/ai.mjs +455 -0
  214. package/dist/runtime/auth-client-react.d.mts +2 -0
  215. package/dist/runtime/auth-client-react.mjs +1 -0
  216. package/dist/runtime/auth-client.d.mts +2 -0
  217. package/dist/runtime/auth-client.mjs +1 -0
  218. package/dist/runtime/auth.d.mts +2 -0
  219. package/dist/runtime/auth.mjs +1 -0
  220. package/dist/runtime/better-auth-mysql.d.mts +5 -0
  221. package/dist/runtime/better-auth-mysql.mjs +21 -0
  222. package/dist/runtime/better-auth-pg.d.mts +5 -0
  223. package/dist/runtime/better-auth-pg.mjs +21 -0
  224. package/dist/runtime/better-auth.d.mts +6 -0
  225. package/dist/runtime/better-auth.mjs +22 -0
  226. package/dist/runtime/client-react.d.mts +5 -0
  227. package/dist/runtime/client-react.mjs +5 -0
  228. package/dist/runtime/client.d.mts +5 -0
  229. package/dist/runtime/client.mjs +5 -0
  230. package/dist/runtime/db-mysql.d.mts +2 -0
  231. package/dist/runtime/db-mysql.mjs +1 -0
  232. package/dist/runtime/db-pg.d.mts +2 -0
  233. package/dist/runtime/db-pg.mjs +1 -0
  234. package/dist/runtime/db.d.mts +17 -0
  235. package/dist/runtime/db.mjs +36 -0
  236. package/dist/runtime/drizzle-arktype.d.mts +1 -0
  237. package/dist/runtime/drizzle-arktype.mjs +2 -0
  238. package/dist/runtime/drizzle-valibot.d.mts +1 -0
  239. package/dist/runtime/drizzle-valibot.mjs +2 -0
  240. package/dist/runtime/drizzle-zod.d.mts +1 -0
  241. package/dist/runtime/drizzle-zod.mjs +2 -0
  242. package/dist/runtime/durable.d.mts +64 -0
  243. package/dist/runtime/durable.mjs +165 -0
  244. package/dist/runtime/email/testing.d.mts +108 -0
  245. package/dist/runtime/email/testing.mjs +268 -0
  246. package/dist/runtime/email-protocol.d.mts +25 -0
  247. package/dist/runtime/email-protocol.mjs +1 -0
  248. package/dist/runtime/email.d.mts +26 -0
  249. package/dist/runtime/email.mjs +524 -0
  250. package/dist/runtime/env-public-client.d.mts +19 -0
  251. package/dist/runtime/env-public-client.mjs +55 -0
  252. package/dist/runtime/env-public.d.mts +4 -0
  253. package/dist/runtime/env-public.mjs +277 -0
  254. package/dist/runtime/env.d.mts +12 -0
  255. package/dist/runtime/env.mjs +1 -0
  256. package/dist/runtime/fetch-server.d.mts +6 -0
  257. package/dist/runtime/fetch-server.mjs +29 -0
  258. package/dist/runtime/fetch-stream.d.mts +3 -0
  259. package/dist/runtime/fetch-stream.mjs +3 -0
  260. package/dist/runtime/fetch.d.mts +2 -0
  261. package/dist/runtime/fetch.mjs +3 -0
  262. package/dist/runtime/handler.d.mts +3 -0
  263. package/dist/runtime/handler.mjs +1 -0
  264. package/dist/runtime/kv.d.mts +45 -0
  265. package/dist/runtime/kv.mjs +103 -0
  266. package/dist/runtime/limits.d.mts +2 -0
  267. package/dist/runtime/limits.mjs +1 -0
  268. package/dist/runtime/live-client.d.mts +40 -0
  269. package/dist/runtime/live-client.mjs +282 -0
  270. package/dist/runtime/live-server.d.mts +11 -0
  271. package/dist/runtime/live-server.mjs +419 -0
  272. package/dist/runtime/live.d.mts +3 -0
  273. package/dist/runtime/live.mjs +1 -0
  274. package/dist/runtime/log.d.mts +24 -0
  275. package/dist/runtime/log.mjs +57 -0
  276. package/dist/runtime/migration-handler-mysql.d.mts +2 -0
  277. package/dist/runtime/migration-handler-mysql.mjs +111 -0
  278. package/dist/runtime/migration-handler-pg.d.mts +2 -0
  279. package/dist/runtime/migration-handler-pg.mjs +94 -0
  280. package/dist/runtime/migration-handler.d.mts +2 -0
  281. package/dist/runtime/migration-handler.mjs +1 -0
  282. package/dist/runtime/procedure.d.mts +27 -0
  283. package/dist/runtime/procedure.mjs +36 -0
  284. package/dist/runtime/procedures.d.mts +24 -0
  285. package/dist/runtime/procedures.mjs +56 -0
  286. package/dist/runtime/queues.d.mts +2 -0
  287. package/dist/runtime/queues.mjs +8 -0
  288. package/dist/runtime/remote/binding-handler.d.mts +11 -0
  289. package/dist/runtime/remote/binding-handler.mjs +227 -0
  290. package/dist/runtime/remote/index.d.mts +12 -0
  291. package/dist/runtime/remote/index.mjs +467 -0
  292. package/dist/runtime/response.d.mts +11 -0
  293. package/dist/runtime/response.mjs +1 -0
  294. package/dist/runtime/route-url.d.mts +2 -0
  295. package/dist/runtime/route-url.mjs +1 -0
  296. package/dist/runtime/routing.d.mts +53 -0
  297. package/dist/runtime/routing.mjs +425 -0
  298. package/dist/runtime/rpc-react.d.mts +16 -0
  299. package/dist/runtime/rpc-react.mjs +50 -0
  300. package/dist/runtime/rpc.d.mts +2 -0
  301. package/dist/runtime/rpc.mjs +1 -0
  302. package/dist/runtime/sandbox-container.d.mts +3 -0
  303. package/dist/runtime/sandbox-container.mjs +1 -0
  304. package/dist/runtime/sandbox.d.mts +5 -0
  305. package/dist/runtime/sandbox.mjs +196 -0
  306. package/dist/runtime/schema-d1.d.mts +1 -0
  307. package/dist/runtime/schema-d1.mjs +2 -0
  308. package/dist/runtime/schema-mysql.d.mts +1 -0
  309. package/dist/runtime/schema-mysql.mjs +2 -0
  310. package/dist/runtime/schema-pg.d.mts +1 -0
  311. package/dist/runtime/schema-pg.mjs +2 -0
  312. package/dist/runtime/seed.d.mts +34 -0
  313. package/dist/runtime/seed.mjs +5 -0
  314. package/dist/runtime/sse-client.d.mts +31 -0
  315. package/dist/runtime/sse-client.mjs +42 -0
  316. package/dist/runtime/sse.d.mts +32 -0
  317. package/dist/runtime/sse.mjs +1 -0
  318. package/dist/runtime/storage.d.mts +4 -0
  319. package/dist/runtime/storage.mjs +13 -0
  320. package/dist/runtime/validator.d.mts +2 -0
  321. package/dist/runtime/validator.mjs +1 -0
  322. package/dist/runtime/ws-server.d.mts +26 -0
  323. package/dist/runtime/ws-server.mjs +297 -0
  324. package/dist/runtime/ws.d.mts +2 -0
  325. package/dist/runtime/ws.mjs +108 -0
  326. package/dist/sandbox-CWDjoEG2.d.mts +50 -0
  327. package/dist/sandbox-container-BqamdFCx.d.mts +73 -0
  328. package/dist/sandbox-container-d1AHLpgn.mjs +291 -0
  329. package/dist/secret-D5XrWshs.mjs +146 -0
  330. package/dist/skills-Dr3AjuBF.mjs +63 -0
  331. package/dist/sqlite-validation-CLJXXN93.mjs +24 -0
  332. package/dist/sse-CxR30yMF.mjs +174 -0
  333. package/dist/standard-schema-CuDawHOC.d.mts +40 -0
  334. package/dist/static-asset-marker-mWMX2dLa.mjs +38 -0
  335. package/dist/subcommand-prompt-B9yUo--u.mjs +370 -0
  336. package/dist/terminal-log-text-DNsWJREL.mjs +31 -0
  337. package/dist/types-D7-4tBu7.d.mts +1 -0
  338. package/dist/untrusted-env-lL7RkYiC.mjs +50 -0
  339. package/dist/validate-B-zsjhiz.mjs +162 -0
  340. package/dist/validate-DbqGdPPY.mjs +1 -0
  341. package/dist/validator-8-NZs2Xr.mjs +168 -0
  342. package/dist/version-metadata-DPhqnpaa.mjs +23 -0
  343. package/dist/wrangler-C3uyPadQ.mjs +1 -0
  344. package/dist/wrangler-TqTvJFWS.mjs +1452 -0
  345. package/dist/ws-DZRiIpYw.d.mts +137 -0
  346. package/dist/yarn-pnp-DgWbE7z5.mjs +91 -0
  347. package/docs/guide/ai.md +273 -0
  348. package/docs/guide/app-types.md +101 -0
  349. package/docs/guide/auth.md +255 -0
  350. package/docs/guide/database/d1.md +86 -0
  351. package/docs/guide/database/mysql.md +72 -0
  352. package/docs/guide/database/postgresql.md +94 -0
  353. package/docs/guide/database.md +454 -0
  354. package/docs/guide/deployment.md +124 -0
  355. package/docs/guide/durable-state.md +192 -0
  356. package/docs/guide/edge/headers.md +47 -0
  357. package/docs/guide/edge/redirects.md +85 -0
  358. package/docs/guide/edge/rewrites.md +119 -0
  359. package/docs/guide/edge/static-assets.md +94 -0
  360. package/docs/guide/email/domains.md +119 -0
  361. package/docs/guide/email/receiving.md +142 -0
  362. package/docs/guide/email/sending.md +262 -0
  363. package/docs/guide/email.md +23 -0
  364. package/docs/guide/env-vars.md +115 -0
  365. package/docs/guide/index.md +37 -0
  366. package/docs/guide/jobs.md +80 -0
  367. package/docs/guide/kv.md +100 -0
  368. package/docs/guide/live.md +181 -0
  369. package/docs/guide/platform/administration/access.md +165 -0
  370. package/docs/guide/platform/administration/connected-apps.md +84 -0
  371. package/docs/guide/platform/administration/email.md +169 -0
  372. package/docs/guide/platform/administration/operations.md +100 -0
  373. package/docs/guide/platform/administration/plans.md +156 -0
  374. package/docs/guide/platform/administration/projects.md +74 -0
  375. package/docs/guide/platform/administration/zero-trust.md +205 -0
  376. package/docs/guide/platform/development/local.md +122 -0
  377. package/docs/guide/platform/development/runtime.md +115 -0
  378. package/docs/guide/platform/development/schema-ci.md +44 -0
  379. package/docs/guide/platform/installation/ci.md +62 -0
  380. package/docs/guide/platform/installation/credentials.md +140 -0
  381. package/docs/guide/platform/installation/domains.md +120 -0
  382. package/docs/guide/platform/installation/first-deployment.md +95 -0
  383. package/docs/guide/platform/installation/maintenance.md +250 -0
  384. package/docs/guide/platform/installation/prerequisites.md +176 -0
  385. package/docs/guide/platform/installation/setup.md +300 -0
  386. package/docs/guide/platform/installation/uninstall.md +110 -0
  387. package/docs/guide/platform-administration.md +19 -0
  388. package/docs/guide/platform-development.md +16 -0
  389. package/docs/guide/procedures.md +48 -0
  390. package/docs/guide/project-collaboration.md +99 -0
  391. package/docs/guide/queues.md +149 -0
  392. package/docs/guide/quickstart.md +129 -0
  393. package/docs/guide/remote-dev.md +67 -0
  394. package/docs/guide/sandboxes.md +134 -0
  395. package/docs/guide/self-hosted-platform.md +45 -0
  396. package/docs/guide/server-routing.md +283 -0
  397. package/docs/guide/sse.md +174 -0
  398. package/docs/guide/storage.md +82 -0
  399. package/docs/guide/testing.md +64 -0
  400. package/docs/guide/type-safety.md +270 -0
  401. package/docs/guide/typed-fetch.md +98 -0
  402. package/docs/guide/websockets.md +230 -0
  403. package/docs/index.md +102 -0
  404. package/docs/integrations/agents.md +38 -0
  405. package/docs/integrations/cloudflare.md +241 -0
  406. package/docs/integrations/hono.md +127 -0
  407. package/docs/reference/api/auth.md +195 -0
  408. package/docs/reference/api/client.md +90 -0
  409. package/docs/reference/api/database.md +118 -0
  410. package/docs/reference/api/deploy.md +63 -0
  411. package/docs/reference/api/durable.md +47 -0
  412. package/docs/reference/api/env.md +51 -0
  413. package/docs/reference/api/handlers.md +189 -0
  414. package/docs/reference/api/plugin.md +40 -0
  415. package/docs/reference/api/resources.md +116 -0
  416. package/docs/reference/api/rewrites.md +111 -0
  417. package/docs/reference/api/types.md +126 -0
  418. package/docs/reference/api.md +71 -0
  419. package/docs/reference/cli/auth.md +87 -0
  420. package/docs/reference/cli/database.md +159 -0
  421. package/docs/reference/cli/deploy.md +117 -0
  422. package/docs/reference/cli/domains.md +42 -0
  423. package/docs/reference/cli/email.md +145 -0
  424. package/docs/reference/cli/generate.md +113 -0
  425. package/docs/reference/cli/github.md +181 -0
  426. package/docs/reference/cli/platform-config.md +93 -0
  427. package/docs/reference/cli/platform-email.md +81 -0
  428. package/docs/reference/cli/platform-installation.md +166 -0
  429. package/docs/reference/cli/platform-operations.md +90 -0
  430. package/docs/reference/cli/platform-users.md +159 -0
  431. package/docs/reference/cli/platform-zero-trust.md +60 -0
  432. package/docs/reference/cli/platform.md +78 -0
  433. package/docs/reference/cli/project.md +208 -0
  434. package/docs/reference/cli/secrets.md +79 -0
  435. package/docs/reference/cli/setup.md +88 -0
  436. package/docs/reference/cli.md +115 -0
  437. package/docs/reference/config.md +478 -0
  438. package/docs/reference/resource-inference.md +72 -0
  439. package/docs/reference/structure.md +138 -0
  440. package/package.json +389 -3
  441. package/sandbox.Dockerfile +4 -0
  442. package/schema.json +353 -0
  443. package/skills/bwf/SKILL.md +100 -0
  444. package/skills/migrate-vite-cloudflare-to-bwf/SKILL.md +53 -0
  445. package/templates/assets/bwf.svg +5 -0
  446. package/templates/assets/icons.svg +49 -0
  447. package/templates/assets/react.svg +1 -0
  448. package/templates/assets/stack.svg +35 -0
@@ -0,0 +1,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 };