@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.
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-Cj0I2_bJ.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-D-DddkCQ.mjs +26 -0
  17. package/dist/auth-migrations-DDeifS3v.mjs +206 -0
  18. package/dist/auth-router-tWzIwf8f.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-HeXRQml6.mjs +1846 -0
  40. package/dist/client-D3D5RM5h.mjs +940 -0
  41. package/dist/client-VF2Nzc7Z.mjs +1 -0
  42. package/dist/cloudflare-auth-jb-1e43r.mjs +152 -0
  43. package/dist/cloudflare-cmd-B62t8Fm-.mjs +59 -0
  44. package/dist/cloudflare-config-i8yanry0.mjs +186 -0
  45. package/dist/cloudflare-connect-x7IsYghw.mjs +55 -0
  46. package/dist/cloudflare-operations-BeK7bhnP.mjs +627 -0
  47. package/dist/cloudflare-operations-C3Uu0Emj.mjs +1 -0
  48. package/dist/cloudflare-process-Cc6oiJqk.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-hLPNppu3.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-BH_md90k.mjs +1735 -0
  65. package/dist/delete-BSKI7V23.mjs +65 -0
  66. package/dist/deploy-C8KHBNsh.mjs +6512 -0
  67. package/dist/deploy-DCZBr7Ey.mjs +2 -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-C4ZhEiFG.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-B3TWga7x.mjs +742 -0
  84. package/dist/email-C_ATvNIG.mjs +2865 -0
  85. package/dist/email-cloudflare-DuAc9zny.mjs +854 -0
  86. package/dist/email-protocol-CZ0bAkI8.mjs +81 -0
  87. package/dist/env-CTAo8ifZ.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-BufZConV.mjs +488 -0
  97. package/dist/env-validation-DPqDo4DU.mjs +1 -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-CJ7DiiRF.mjs +161 -0
  111. package/dist/handler-CVsIfRv7.d.mts +279 -0
  112. package/dist/help-Bpv6Qeqn.mjs +1946 -0
  113. package/dist/help-CfZ4Bsw5.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-DRUR0j8C.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-B84t4BhW.mjs +130 -0
  124. package/dist/live-Dui0-aj_.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-C3EeOV7-.mjs +103 -0
  128. package/dist/log-JDnPc0cF.mjs +23 -0
  129. package/dist/login-Bl5lH8nH.mjs +87 -0
  130. package/dist/login-DoI7AsbY.mjs +1 -0
  131. package/dist/logs-CaT2N2f7.mjs +129 -0
  132. package/dist/migrate-CbGscX-V.mjs +125 -0
  133. package/dist/migrate-Ce3JKLVs.mjs +1 -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-BFg32YyY.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-C73WWJBl.mjs +443 -0
  145. package/dist/operator-cmd-CdZytuAF.mjs +1 -0
  146. package/dist/output-Bb34lF0w.mjs +173 -0
  147. package/dist/output-CVolXKC1.mjs +1 -0
  148. package/dist/package-DO4d3Qz5.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-NI_vfWvD.mjs +538 -0
  155. package/dist/platform-args-ZC1-A1N9.mjs +1 -0
  156. package/dist/platform-auth-config-d-lY5-aY.mjs +371 -0
  157. package/dist/platform-auth-protection-Dhw7lUCk.mjs +231 -0
  158. package/dist/platform-auth-recovery-DaCc0tlx.mjs +309 -0
  159. package/dist/platform-cmd-5Ry-C9im.mjs +193 -0
  160. package/dist/platform-cmd-5oZq91lI.mjs +1 -0
  161. package/dist/platform-discovery-Bxg9aZXU.mjs +40 -0
  162. package/dist/platform-domain-DLVdGvGG.mjs +256 -0
  163. package/dist/platform-lifecycle-CUgjipXO.mjs +1 -0
  164. package/dist/platform-lifecycle-fRt5VMls.mjs +8928 -0
  165. package/dist/platform-management-5hEsRfR2.mjs +1 -0
  166. package/dist/platform-management-Djh1hzLP.mjs +1607 -0
  167. package/dist/platform-plans-config-CkbUKFpm.mjs +447 -0
  168. package/dist/platform-recovery-Cghx7FCR.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-SfwCwnZg.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-DTF19-fC.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-DGlFJ3T9.mjs +1 -0
  188. package/dist/provision-mYVLuQiy.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-BvCHol52.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-7aA5hGoM.mjs +145 -0
  209. package/dist/runner-mysql-DrMKw203.mjs +1 -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-DCF9RXTc.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-DsSoNsKJ.mjs +23 -0
  343. package/dist/wrangler-DU784Dkf.mjs +1452 -0
  344. package/dist/wrangler-Rr9_76DQ.mjs +1 -0
  345. package/dist/ws-Q_osq9VK.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,450 @@
1
+ import { a as join, c as resolve } from "./dist-DMYe8CZJ.mjs";
2
+ import { t as writeFileAtomic } from "./atomic-write-DA6eD1Kp.mjs";
3
+ import { closeSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
4
+ import { parsePlatformInstallationManifest } from "@builtbyfriends/platform";
5
+ import { createCipheriv, createDecipheriv, createHash, randomBytes } from "node:crypto";
6
+ import { homedir, hostname } from "node:os";
7
+ import { Entry } from "@napi-rs/keyring";
8
+ // src/cli/keyring.ts
9
+ function readKeyringPassword(service, account) {
10
+ try {
11
+ return new Entry(service, account).getPassword();
12
+ } catch {
13
+ return null;
14
+ }
15
+ }
16
+ function writeKeyringPassword(service, account, password) {
17
+ try {
18
+ new Entry(service, account).setPassword(password);
19
+ return true;
20
+ } catch {
21
+ return false;
22
+ }
23
+ }
24
+ function deleteKeyringPassword(service, account) {
25
+ try {
26
+ new Entry(service, account).deletePassword();
27
+ return true;
28
+ } catch {
29
+ return false;
30
+ }
31
+ }
32
+ // src/cli/platform-registry.ts
33
+ const PLATFORM_REGISTRY_SCHEMA_VERSION = 1;
34
+ const DEFAULT_REGISTRY = {
35
+ activeConnectionId: null,
36
+ connections: [],
37
+ schemaVersion: PLATFORM_REGISTRY_SCHEMA_VERSION
38
+ };
39
+ const PLATFORM_RECOVERY_KEYRING_SERVICE = "dev.nosam.cli.platform";
40
+ const LEGACY_PLATFORM_RECOVERY_KEYRING_SERVICE = "dev.void.cli.platform";
41
+ const PLATFORM_RECOVERY_ENVELOPE_VERSION = 1;
42
+ /**
43
+ * The registry lives in `~/.bwf/platforms`. A machine that already has a registry in
44
+ * `~/.nosam/platforms` or `~/.void/platforms` from an earlier release keeps using it in
45
+ * place, so its saved connections and keychain entries still match.
46
+ */
47
+ function platformRegistryDirectory() {
48
+ const fromEnvironment = process.env.NOSAM_PLATFORM_REGISTRY_DIR ?? process.env.VOID_PLATFORM_REGISTRY_DIR;
49
+ if (fromEnvironment) return fromEnvironment;
50
+ const candidates = [
51
+ ".bwf",
52
+ ".nosam",
53
+ ".void"
54
+ ].map((name) => join(homedir(), name, "platforms"));
55
+ return candidates.find((directory) => existsSync(join(directory, "registry.json"))) ?? candidates[0];
56
+ }
57
+ function normalizePlatformApiUrl(value) {
58
+ let url;
59
+ try {
60
+ url = new URL(value);
61
+ } catch {
62
+ throw new Error(`platform: Invalid platform URL ${JSON.stringify(value)}.`);
63
+ }
64
+ if (!(url.protocol === "http:" && [
65
+ "localhost",
66
+ "127.0.0.1",
67
+ "[::1]"
68
+ ].includes(url.hostname)) && url.protocol !== "https:" || url.username || url.password) throw new Error("platform: Platform URLs must use HTTPS and must not contain credentials.");
69
+ if (url.search || url.hash) throw new Error("platform: Platform URLs must not contain query parameters or fragments.");
70
+ if (url.pathname !== "/" && url.pathname !== "") throw new Error("platform: Platform URLs must not contain a path.");
71
+ return url.origin;
72
+ }
73
+ function platformConnectionId(apiUrl) {
74
+ return createHash("sha256").update(normalizePlatformApiUrl(apiUrl)).digest("hex").slice(0, 20);
75
+ }
76
+ function platformCredentialAccount(apiUrl) {
77
+ return `platform:${createHash("sha256").update(normalizePlatformApiUrl(apiUrl)).digest("hex")}`;
78
+ }
79
+ function parseConnection(value) {
80
+ if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("platform: Invalid connection entry in the local registry.");
81
+ const entry = value;
82
+ const apiUrl = normalizePlatformApiUrl(String(entry.apiUrl ?? ""));
83
+ const id = String(entry.id ?? "");
84
+ if (id !== platformConnectionId(apiUrl)) throw new Error("platform: Connection id does not match its API URL.");
85
+ if (entry.kind !== "connected" && entry.kind !== "installed") throw new Error("platform: Invalid connection kind in the local registry.");
86
+ const lastUsedAt = String(entry.lastUsedAt ?? "");
87
+ if (!Number.isFinite(Date.parse(lastUsedAt))) throw new Error("platform: Invalid connection timestamp in the local registry.");
88
+ const optionalString = (input) => typeof input === "string" && input !== "" ? input : null;
89
+ const proxyUrl = optionalString(entry.proxyUrl);
90
+ return {
91
+ accountId: optionalString(entry.accountId),
92
+ apiUrl,
93
+ applicationDomain: optionalString(entry.applicationDomain),
94
+ displayName: typeof entry.displayName === "string" && entry.displayName.trim() ? entry.displayName.trim() : new URL(apiUrl).hostname,
95
+ id,
96
+ installationId: optionalString(entry.installationId),
97
+ kind: entry.kind,
98
+ lastUsedAt,
99
+ proxyUrl: proxyUrl === null ? null : normalizePlatformApiUrl(proxyUrl)
100
+ };
101
+ }
102
+ function readRegistry(directory) {
103
+ try {
104
+ const parsed = JSON.parse(readFileSync(join(directory, "registry.json"), "utf8"));
105
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("registry must be an object");
106
+ const value = parsed;
107
+ if (value.schemaVersion !== PLATFORM_REGISTRY_SCHEMA_VERSION || !Array.isArray(value.connections)) throw new Error("unsupported schema");
108
+ const connections = value.connections.map(parseConnection);
109
+ return {
110
+ activeConnectionId: typeof value.activeConnectionId === "string" && connections.some((connection) => connection.id === value.activeConnectionId) ? value.activeConnectionId : null,
111
+ connections,
112
+ schemaVersion: PLATFORM_REGISTRY_SCHEMA_VERSION
113
+ };
114
+ } catch (error) {
115
+ if (error.code === "ENOENT") return DEFAULT_REGISTRY;
116
+ throw new Error(`platform: Could not read ${join(directory, "registry.json")}: ${error instanceof Error ? error.message : String(error)}`);
117
+ }
118
+ }
119
+ function withRegistryLock(directory, operation) {
120
+ mkdirSync(directory, {
121
+ recursive: true,
122
+ mode: 448
123
+ });
124
+ const lockPath = join(directory, ".registry.lock");
125
+ let descriptor;
126
+ try {
127
+ descriptor = openSync(lockPath, "wx", 384);
128
+ } catch (error) {
129
+ if (error.code !== "EEXIST") throw error;
130
+ if (Date.now() - statSync(lockPath).mtimeMs < 6e5) throw new Error("platform: Another process is updating the platform registry.");
131
+ rmSync(lockPath, { force: true });
132
+ descriptor = openSync(lockPath, "wx", 384);
133
+ }
134
+ try {
135
+ return operation();
136
+ } finally {
137
+ closeSync(descriptor);
138
+ rmSync(lockPath, { force: true });
139
+ }
140
+ }
141
+ function writeJsonAtomically(path, value) {
142
+ writeFileAtomic(path, `${JSON.stringify(value, null, 2)}\n`, 384);
143
+ }
144
+ function acquirePlatformLifecycleLock(accountId, installationSlug, directory = platformRegistryDirectory()) {
145
+ if (!/^[A-Za-z0-9_-]+$/.test(accountId) || !/^[a-z0-9][a-z0-9-]{0,79}$/.test(installationSlug)) throw new Error("platform: Invalid lifecycle lock identity.");
146
+ const lockDirectory = join(directory, "locks");
147
+ mkdirSync(lockDirectory, {
148
+ recursive: true,
149
+ mode: 448
150
+ });
151
+ const lockPath = join(lockDirectory, `${accountId}-${installationSlug}.lock`);
152
+ const acquire = () => {
153
+ try {
154
+ const descriptor = openSync(lockPath, "wx", 384);
155
+ writeFileSync(descriptor, `${JSON.stringify({
156
+ host: hostname(),
157
+ pid: process.pid,
158
+ startedAt: (/* @__PURE__ */ new Date()).toISOString()
159
+ })}\n`);
160
+ return descriptor;
161
+ } catch (error) {
162
+ if (error.code !== "EEXIST") throw error;
163
+ let stale = false;
164
+ try {
165
+ const owner = JSON.parse(readFileSync(lockPath, "utf8"));
166
+ if (owner.host === hostname() && typeof owner.pid === "number") try {
167
+ process.kill(owner.pid, 0);
168
+ } catch (ownerError) {
169
+ stale = ownerError.code === "ESRCH";
170
+ }
171
+ else {
172
+ const startedAt = typeof owner.startedAt === "string" ? Date.parse(owner.startedAt) : NaN;
173
+ stale = Number.isFinite(startedAt) && Date.now() - startedAt > 72e5;
174
+ }
175
+ } catch {
176
+ stale = Date.now() - statSync(lockPath).mtimeMs > 72e5;
177
+ }
178
+ if (!stale) throw new Error(`platform: Another lifecycle operation is active for ${installationSlug} in account ${accountId}.`);
179
+ rmSync(lockPath, { force: true });
180
+ return acquire();
181
+ }
182
+ };
183
+ const descriptor = acquire();
184
+ let released = false;
185
+ return () => {
186
+ if (released) return;
187
+ released = true;
188
+ closeSync(descriptor);
189
+ rmSync(lockPath, { force: true });
190
+ };
191
+ }
192
+ function listPlatformConnections(directory = platformRegistryDirectory()) {
193
+ return readRegistry(directory).connections;
194
+ }
195
+ function assertPlatformInstallationSlugAvailable(installationSlug, directory = platformRegistryDirectory()) {
196
+ const collision = listInstallationManifests(directory).find((manifest) => manifest.status !== "uninstalled" && manifest.deployment.installationSlug === installationSlug);
197
+ if (collision) throw new Error(`platform: Installation ${collision.id} already uses this name. Resume it with \`bwf platform install --resume --name ${collision.id}\`.`);
198
+ }
199
+ function getActivePlatformConnection(directory = platformRegistryDirectory()) {
200
+ const registry = readRegistry(directory);
201
+ return registry.connections.find((connection) => connection.id === registry.activeConnectionId) ?? (registry.connections.length === 1 ? registry.connections[0] : null);
202
+ }
203
+ function platformConnectionSlug(connection, installations) {
204
+ const matches = installations.filter((manifest) => manifest.status !== "uninstalled" && manifest.id === connection.installationId && (connection.accountId === null || connection.accountId === manifest.account.id));
205
+ return matches.length === 1 ? matches[0].deployment.installationSlug : null;
206
+ }
207
+ /** Resolve saved platforms without selecting one or changing its credentials. */
208
+ function findPlatformConnections(selector, directory = platformRegistryDirectory(), connections = listPlatformConnections(directory)) {
209
+ let normalizedUrl = null;
210
+ try {
211
+ normalizedUrl = normalizePlatformApiUrl(selector);
212
+ } catch {}
213
+ const installations = connections.some((connection) => connection.installationId) ? listInstallationManifests(directory) : [];
214
+ return connections.filter((entry) => entry.id === selector || entry.installationId === selector || entry.displayName.toLowerCase() === selector.toLowerCase() || entry.apiUrl === normalizedUrl || platformConnectionSlug(entry, installations) === selector.toLowerCase());
215
+ }
216
+ function savePlatformConnection(input, directory = platformRegistryDirectory()) {
217
+ const apiUrl = normalizePlatformApiUrl(input.apiUrl);
218
+ const id = platformConnectionId(apiUrl);
219
+ const lastUsedAt = input.lastUsedAt ?? (/* @__PURE__ */ new Date()).toISOString();
220
+ const connection = parseConnection({
221
+ ...input,
222
+ apiUrl,
223
+ id,
224
+ lastUsedAt
225
+ });
226
+ return withRegistryLock(directory, () => {
227
+ const connections = readRegistry(directory).connections.filter((entry) => entry.id !== id);
228
+ connections.push(connection);
229
+ connections.sort((left, right) => left.displayName.localeCompare(right.displayName));
230
+ writeJsonAtomically(join(directory, "registry.json"), {
231
+ activeConnectionId: id,
232
+ connections,
233
+ schemaVersion: PLATFORM_REGISTRY_SCHEMA_VERSION
234
+ });
235
+ return connection;
236
+ });
237
+ }
238
+ function selectPlatformConnection(selector, directory = platformRegistryDirectory()) {
239
+ return withRegistryLock(directory, () => {
240
+ const current = readRegistry(directory);
241
+ const matches = findPlatformConnections(selector, directory, current.connections);
242
+ if (matches.length !== 1) throw new Error(matches.length === 0 ? `platform: No installed or connected platform matches ${JSON.stringify(selector)}.` : `platform: More than one platform matches ${JSON.stringify(selector)}. Use its id or URL.`);
243
+ const selected = {
244
+ ...matches[0],
245
+ lastUsedAt: (/* @__PURE__ */ new Date()).toISOString()
246
+ };
247
+ const connections = current.connections.map((entry) => entry.id === selected.id ? selected : entry);
248
+ writeJsonAtomically(join(directory, "registry.json"), {
249
+ activeConnectionId: selected.id,
250
+ connections,
251
+ schemaVersion: PLATFORM_REGISTRY_SCHEMA_VERSION
252
+ });
253
+ return selected;
254
+ });
255
+ }
256
+ function installationManifestPath(accountId, installationId, directory = platformRegistryDirectory()) {
257
+ if (!/^[A-Za-z0-9_-]+$/.test(accountId) || !/^[a-z0-9][a-z0-9-]{7,79}$/.test(installationId)) throw new Error("platform: Invalid account or installation id.");
258
+ return join(directory, accountId, `${installationId}.json`);
259
+ }
260
+ function writeInstallationManifest(manifest, directory = platformRegistryDirectory()) {
261
+ const path = installationManifestPath(manifest.account.id, manifest.id, directory);
262
+ const parent = join(directory, manifest.account.id);
263
+ mkdirSync(parent, {
264
+ recursive: true,
265
+ mode: 448
266
+ });
267
+ writeJsonAtomically(path, manifest);
268
+ }
269
+ function listInstallationManifests(directory = platformRegistryDirectory()) {
270
+ const manifests = [];
271
+ let accountDirectories;
272
+ try {
273
+ accountDirectories = readdirSync(directory, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
274
+ } catch (error) {
275
+ if (error.code === "ENOENT") return [];
276
+ throw error;
277
+ }
278
+ for (const accountId of accountDirectories) {
279
+ const accountPath = join(directory, accountId);
280
+ for (const entry of readdirSync(accountPath, { withFileTypes: true })) {
281
+ if (!entry.isFile() || !entry.name.endsWith(".json")) continue;
282
+ const path = join(accountPath, entry.name);
283
+ try {
284
+ manifests.push(parsePlatformInstallationManifest(JSON.parse(readFileSync(path, "utf8"))));
285
+ } catch (error) {
286
+ throw new Error(`platform: Invalid installation manifest ${path}: ${error instanceof Error ? error.message : String(error)}`);
287
+ }
288
+ }
289
+ }
290
+ return manifests.sort((left, right) => left.deployment.displayName.localeCompare(right.deployment.displayName));
291
+ }
292
+ function resolveInstallationManifest(selector, directory = platformRegistryDirectory()) {
293
+ const connection = selector ? listPlatformConnections(directory).find((entry) => entry.id === selector) : void 0;
294
+ const manifests = listInstallationManifests(directory).filter((manifest) => manifest.status !== "uninstalled" && (!selector || manifest.id === selector || manifest.id === connection?.installationId && (connection.accountId === null || connection.accountId === manifest.account.id) || manifest.deployment.installationSlug === selector || manifest.deployment.displayName.toLowerCase() === selector.toLowerCase()));
295
+ if (manifests.length !== 1) throw new Error(manifests.length === 0 ? `platform: No local installation matches ${JSON.stringify(selector)}.` : "platform: Multiple local installations match; specify an installation id.");
296
+ return manifests[0];
297
+ }
298
+ function writePendingInstallationSecrets(manifest, secrets, directory = platformRegistryDirectory()) {
299
+ const manifestPath = installationManifestPath(manifest.account.id, manifest.id, directory);
300
+ writeEncryptedRecoveryMaterial(manifest, "pending", manifestPath.replace(/\.json$/, ".secrets.enc"), secrets, directory);
301
+ rmSync(manifestPath.replace(/\.json$/, ".secrets"), { force: true });
302
+ }
303
+ function readPendingInstallationSecrets(manifest, directory = platformRegistryDirectory()) {
304
+ return readRecoveryMaterial(manifest, "pending", directory);
305
+ }
306
+ function promoteInstallationSecrets(manifest, directory = platformRegistryDirectory()) {
307
+ const manifestPath = installationManifestPath(manifest.account.id, manifest.id, directory);
308
+ const values = readPendingInstallationSecrets(manifest, directory);
309
+ if (!values) throw new Error("platform: Pending installation recovery material is missing.");
310
+ writeEncryptedRecoveryMaterial(manifest, "recovery", manifestPath.replace(/\.json$/, ".recovery.enc"), values, directory);
311
+ rmSync(manifestPath.replace(/\.json$/, ".secrets.enc"), { force: true });
312
+ rmSync(manifestPath.replace(/\.json$/, ".secrets"), { force: true });
313
+ rmSync(manifestPath.replace(/\.json$/, ".recovery"), { force: true });
314
+ }
315
+ function readInstallationRecoverySecrets(manifest, directory = platformRegistryDirectory()) {
316
+ const pending = readPendingInstallationSecrets(manifest, directory);
317
+ if (!pending) return readRecoveryMaterial(manifest, "recovery", directory);
318
+ const updateState = pendingWorkerSecretUpdateState(manifest, pending.workerSecretUpdatesJson);
319
+ if (updateState === "stale") return readRecoveryMaterial(manifest, "recovery", directory);
320
+ if (updateState === "committed") return Object.fromEntries(Object.entries(pending).filter(([name]) => name !== "workerSecretUpdatesJson"));
321
+ return pending;
322
+ }
323
+ function pendingWorkerSecretUpdateState(manifest, value) {
324
+ if (!value) return "active";
325
+ let parsed;
326
+ try {
327
+ parsed = JSON.parse(value);
328
+ } catch {
329
+ return "active";
330
+ }
331
+ if (!parsed || typeof parsed !== "object" || !("schema" in parsed) || parsed.schema !== 1 || !("id" in parsed) || typeof parsed.id !== "string" || !("baselineGeneration" in parsed) || !Number.isSafeInteger(parsed.baselineGeneration) || !("generation" in parsed) || parsed.generation !== null && !Number.isSafeInteger(parsed.generation)) return "active";
332
+ return platformWorkerSecretUpdateIntentState(manifest, {
333
+ baselineGeneration: Number(parsed.baselineGeneration),
334
+ generation: parsed.generation === null ? null : Number(parsed.generation),
335
+ id: parsed.id
336
+ });
337
+ }
338
+ function platformWorkerSecretUpdateIntentState(manifest, intent) {
339
+ const latestGeneration = latestPlatformWorkerCutoverGeneration(manifest);
340
+ const latestState = manifest.steps.flatMap((step) => {
341
+ const match = /^worker-secret-updates:(\d+):(pending|committed)$/.exec(step.key);
342
+ return match ? [{
343
+ generation: Number(match[1]),
344
+ id: step.resultHash,
345
+ state: match[2]
346
+ }] : [];
347
+ }).sort((left, right) => right.generation - left.generation || (left.state === right.state ? 0 : left.state === "committed" ? -1 : 1))[0];
348
+ if (!latestState) return intent.generation === null && intent.baselineGeneration === latestGeneration ? "active" : "stale";
349
+ if (latestState.generation !== latestGeneration || latestState.id !== intent.id) return "stale";
350
+ return latestState.state === "committed" ? "committed" : "active";
351
+ }
352
+ function latestPlatformWorkerCutoverGeneration(manifest) {
353
+ return Math.max(0, ...manifest.steps.flatMap((step) => {
354
+ const match = /^worker-(?:cutover|secret-updates|traffic-state):(\d+)/.exec(step.key);
355
+ return match ? [Number(match[1])] : [];
356
+ }));
357
+ }
358
+ function removeInstallationRecoverySecrets(manifest, directory = platformRegistryDirectory()) {
359
+ const manifestPath = installationManifestPath(manifest.account.id, manifest.id, directory);
360
+ rmSync(manifestPath.replace(/\.json$/, ".recovery.enc"), { force: true });
361
+ rmSync(manifestPath.replace(/\.json$/, ".secrets.enc"), { force: true });
362
+ rmSync(manifestPath.replace(/\.json$/, ".recovery"), { force: true });
363
+ rmSync(manifestPath.replace(/\.json$/, ".secrets"), { force: true });
364
+ }
365
+ function readRecoveryMaterial(manifest, kind, directory) {
366
+ const manifestPath = installationManifestPath(manifest.account.id, manifest.id, directory);
367
+ const encryptedPath = manifestPath.replace(/\.json$/, `.${kind === "pending" ? "secrets" : "recovery"}.enc`);
368
+ try {
369
+ const envelope = parseRecoveryEnvelope(JSON.parse(readFileSync(encryptedPath, "utf8")));
370
+ const key = platformRecoveryKey(directory, false);
371
+ if (!key) throw new Error("the encryption key is unavailable; restore it from the system keychain or set NOSAM_PLATFORM_RECOVERY_KEY");
372
+ const decipher = createDecipheriv("aes-256-gcm", key, Buffer.from(envelope.iv, "base64"));
373
+ decipher.setAAD(recoveryAad(manifest, kind));
374
+ decipher.setAuthTag(Buffer.from(envelope.tag, "base64"));
375
+ const plaintext = Buffer.concat([decipher.update(Buffer.from(envelope.ciphertext, "base64")), decipher.final()]);
376
+ return parseRecoveryValues(JSON.parse(plaintext.toString("utf8")), `${kind} recovery material`);
377
+ } catch (error) {
378
+ if (error.code !== "ENOENT") throw new Error(`platform: Could not read encrypted ${kind} material: ${error instanceof Error ? error.message : String(error)}`);
379
+ }
380
+ const legacyPath = manifestPath.replace(/\.json$/, kind === "pending" ? ".secrets" : ".recovery");
381
+ try {
382
+ const values = parseRecoveryValues(JSON.parse(readFileSync(legacyPath, "utf8")), `legacy ${kind} recovery material`);
383
+ writeEncryptedRecoveryMaterial(manifest, kind, encryptedPath, values, directory);
384
+ rmSync(legacyPath, { force: true });
385
+ return values;
386
+ } catch (error) {
387
+ if (error.code === "ENOENT") return null;
388
+ throw new Error(`platform: Could not migrate legacy ${kind} material: ${error instanceof Error ? error.message : String(error)}`);
389
+ }
390
+ }
391
+ function writeEncryptedRecoveryMaterial(manifest, kind, path, values, directory) {
392
+ const key = platformRecoveryKey(directory, true);
393
+ const iv = randomBytes(12);
394
+ const cipher = createCipheriv("aes-256-gcm", key, iv);
395
+ cipher.setAAD(recoveryAad(manifest, kind));
396
+ writeJsonAtomically(path, {
397
+ algorithm: "aes-256-gcm",
398
+ ciphertext: Buffer.concat([cipher.update(JSON.stringify(parseRecoveryValues(values, `${kind} recovery material`)), "utf8"), cipher.final()]).toString("base64"),
399
+ iv: iv.toString("base64"),
400
+ schemaVersion: PLATFORM_RECOVERY_ENVELOPE_VERSION,
401
+ tag: cipher.getAuthTag().toString("base64")
402
+ });
403
+ }
404
+ function recoveryAad(manifest, kind) {
405
+ return Buffer.from(`void-platform-recovery-v1\0${manifest.account.id}\0${manifest.id}\0${manifest.ownershipNonce}\0${kind}`);
406
+ }
407
+ function platformRecoveryKey(directory, create) {
408
+ const fromEnvironment = process.env.NOSAM_PLATFORM_RECOVERY_KEY;
409
+ if (fromEnvironment) return parseRecoveryKey(fromEnvironment, "NOSAM_PLATFORM_RECOVERY_KEY");
410
+ const legacyEnvironment = process.env.VOID_PLATFORM_RECOVERY_KEY;
411
+ if (legacyEnvironment) return parseRecoveryKey(legacyEnvironment, "VOID_PLATFORM_RECOVERY_KEY");
412
+ const account = `recovery:${createHash("sha256").update(resolve(directory)).digest("hex")}`;
413
+ const saved = readKeyringPassword(PLATFORM_RECOVERY_KEYRING_SERVICE, account) ?? readKeyringPassword(LEGACY_PLATFORM_RECOVERY_KEYRING_SERVICE, account);
414
+ if (saved) return parseRecoveryKey(saved, "system keychain recovery key");
415
+ if (!create) return null;
416
+ const generated = randomBytes(32);
417
+ if (!writeKeyringPassword(PLATFORM_RECOVERY_KEYRING_SERVICE, account, generated.toString("base64"))) throw new Error("platform: The system keychain is unavailable. Refusing to write platform secrets to disk. Configure a system keychain or set a base64-encoded 32-byte NOSAM_PLATFORM_RECOVERY_KEY from your secret manager.");
418
+ return generated;
419
+ }
420
+ function parseRecoveryKey(value, name) {
421
+ const key = Buffer.from(value, "base64");
422
+ if (key.byteLength !== 32 || key.toString("base64") !== value) throw new Error(`platform: ${name} must be a canonical base64-encoded 32-byte key.`);
423
+ return key;
424
+ }
425
+ function parseRecoveryEnvelope(value) {
426
+ if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("encrypted recovery envelope must be an object");
427
+ const envelope = value;
428
+ if (envelope.schemaVersion !== PLATFORM_RECOVERY_ENVELOPE_VERSION || envelope.algorithm !== "aes-256-gcm" || typeof envelope.ciphertext !== "string" || typeof envelope.iv !== "string" || typeof envelope.tag !== "string") throw new Error("encrypted recovery envelope is invalid");
429
+ if (Buffer.from(envelope.iv, "base64").byteLength !== 12) throw new Error("encrypted recovery IV is invalid");
430
+ if (Buffer.from(envelope.tag, "base64").byteLength !== 16) throw new Error("encrypted recovery tag is invalid");
431
+ return envelope;
432
+ }
433
+ function parseRecoveryValues(value, name) {
434
+ if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${name} must be an object`);
435
+ const entries = Object.entries(value);
436
+ if (entries.some(([, entry]) => typeof entry !== "string")) throw new Error(`${name} values must be strings`);
437
+ return Object.fromEntries(entries);
438
+ }
439
+ function removePlatformConnectionForInstallation(installationId, directory = platformRegistryDirectory()) {
440
+ withRegistryLock(directory, () => {
441
+ const current = readRegistry(directory);
442
+ const connections = current.connections.filter((connection) => connection.installationId !== installationId);
443
+ writeJsonAtomically(join(directory, "registry.json"), {
444
+ activeConnectionId: current.activeConnectionId && connections.some((connection) => connection.id === current.activeConnectionId) ? current.activeConnectionId : connections[0]?.id ?? null,
445
+ connections,
446
+ schemaVersion: PLATFORM_REGISTRY_SCHEMA_VERSION
447
+ });
448
+ });
449
+ }
450
+ export { deleteKeyringPassword as C, writePendingInstallationSecrets as S, writeKeyringPassword as T, removePlatformConnectionForInstallation as _, latestPlatformWorkerCutoverGeneration as a, selectPlatformConnection as b, normalizePlatformApiUrl as c, platformRegistryDirectory as d, platformWorkerSecretUpdateIntentState as f, removeInstallationRecoverySecrets as g, readPendingInstallationSecrets as h, getActivePlatformConnection as i, platformConnectionSlug as l, readInstallationRecoverySecrets as m, assertPlatformInstallationSlugAvailable as n, listInstallationManifests as o, promoteInstallationSecrets as p, findPlatformConnections as r, listPlatformConnections as s, acquirePlatformLifecycleLock as t, platformCredentialAccount as u, resolveInstallationManifest as v, readKeyringPassword as w, writeInstallationManifest as x, savePlatformConnection as y };
@@ -0,0 +1,72 @@
1
+ // src/cli/platform-runtime-logs.ts
2
+ /**
3
+ * Namespace scripts that run project code: one `user-<slug>-<deployment>` per
4
+ * deployment, and `void-do-<project>-<hash>` (or `nosam-do-`) hosts for custom Durable Objects.
5
+ */
6
+ const PROJECT_WORKER_PREFIXES = [
7
+ "user-",
8
+ "void-do-",
9
+ "nosam-do-"
10
+ ];
11
+ const CONCURRENCY = 4;
12
+ /** Printed by log readers when the platform answers `runtimeLogs: 'minimal'`. */
13
+ const MINIMAL_RUNTIME_LOGS_NOTE = "Log messages, exception messages and URLs are not recorded on this platform.";
14
+ /** Same `observability` the API sends when it uploads a project Worker. */
15
+ function projectWorkerObservability(minimal) {
16
+ return minimal ? { enabled: false } : {
17
+ enabled: true,
18
+ logs: {
19
+ invocation_logs: true,
20
+ head_sampling_rate: 1
21
+ }
22
+ };
23
+ }
24
+ function assertPlatformRuntimeLogsSupported(deployment, runtime) {
25
+ if (deployment.runtimeLogs && runtime.runtimeLogs !== 1) throw new Error("platform: This platform runtime cannot keep runtime logs minimal. Upgrade bwf or use a current platform runtime.");
26
+ }
27
+ /**
28
+ * Project Workers keep the settings they were uploaded with, so a changed
29
+ * mode is pushed to them. While minimal, every operation pushes it again, so
30
+ * a run that stopped before this step is finished by the next one.
31
+ */
32
+ function shouldUpdateProjectWorkerRuntimeLogs(input) {
33
+ const minimal = !!input.next.runtimeLogs;
34
+ return minimal || input.explicit || minimal !== !!input.previous?.runtimeLogs;
35
+ }
36
+ /**
37
+ * Update every project Worker's `observability` setting. Never throws: returns
38
+ * a warning to print when some Workers could not be updated.
39
+ */
40
+ async function updateProjectWorkerRuntimeLogs(client, input) {
41
+ const finish = input.minimal ? ` Run \`bwf platform repair ${input.installationId}\` to finish.` : ` Run \`bwf platform upgrade ${input.installationId} --runtime-logs full\` again to finish.`;
42
+ let scripts;
43
+ try {
44
+ scripts = (await client.listDispatchNamespaceScripts(input.accountId, input.namespace)).filter((name) => PROJECT_WORKER_PREFIXES.some((prefix) => name.startsWith(prefix)));
45
+ } catch (error) {
46
+ return `Could not list project Workers to update their Workers Logs setting: ${errorMessage(error)}.${finish}`;
47
+ }
48
+ const settings = { observability: projectWorkerObservability(input.minimal) };
49
+ const failed = [];
50
+ let next = 0;
51
+ const work = async () => {
52
+ while (next < scripts.length) {
53
+ const script = scripts[next++];
54
+ try {
55
+ await client.patchDispatchNamespaceScriptSettings(input.accountId, input.namespace, script, settings);
56
+ } catch {
57
+ failed.push(script);
58
+ }
59
+ }
60
+ };
61
+ await Promise.all(Array.from({ length: Math.min(CONCURRENCY, scripts.length) }, work));
62
+ if (failed.length === 0) return;
63
+ failed.sort();
64
+ const shown = failed.slice(0, 5).join(", ");
65
+ const more = failed.length > 5 ? ` and ${failed.length - 5} more` : "";
66
+ return `Could not update the Workers Logs setting of ${failed.length} project Worker${failed.length === 1 ? "" : "s"} (${shown}${more}).${finish}`;
67
+ }
68
+ function errorMessage(error) {
69
+ const message = error instanceof Error ? error.message : String(error);
70
+ return message.endsWith(".") ? message.slice(0, -1) : message;
71
+ }
72
+ export { updateProjectWorkerRuntimeLogs as i, assertPlatformRuntimeLogsSupported as n, shouldUpdateProjectWorkerRuntimeLogs as r, MINIMAL_RUNTIME_LOGS_NOTE as t };