@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,297 @@
1
+ import { t as authContext } from "../auth-DkvoW5hB.mjs";
2
+ import { o as withRuntimeEnv } from "../env-Dl4Wggec.mjs";
3
+ // src/runtime/ws-server.ts
4
+ function matchRoute(pattern, pathname) {
5
+ const patternSegments = pattern.split("/").filter(Boolean);
6
+ const pathSegments = pathname.split("/").filter(Boolean);
7
+ const params = {};
8
+ let i = 0;
9
+ for (; i < patternSegments.length; i++) {
10
+ const patternSegment = patternSegments[i];
11
+ const pathSegment = pathSegments[i];
12
+ if (patternSegment === "*") return {
13
+ matched: true,
14
+ params
15
+ };
16
+ if (patternSegment.endsWith("{.+}") && patternSegment.startsWith(":")) {
17
+ params[patternSegment.slice(1, -4)] = decodeURIComponent(pathSegments.slice(i).join("/"));
18
+ return {
19
+ matched: true,
20
+ params
21
+ };
22
+ }
23
+ if (pathSegment == null) return {
24
+ matched: false,
25
+ params: {}
26
+ };
27
+ if (patternSegment.startsWith(":")) {
28
+ params[patternSegment.slice(1)] = decodeURIComponent(pathSegment);
29
+ continue;
30
+ }
31
+ if (patternSegment !== pathSegment) return {
32
+ matched: false,
33
+ params: {}
34
+ };
35
+ }
36
+ if (i !== pathSegments.length) return {
37
+ matched: false,
38
+ params: {}
39
+ };
40
+ return {
41
+ matched: true,
42
+ params
43
+ };
44
+ }
45
+ function getRouteMatch(request, route) {
46
+ const { pathname } = new URL(request.url);
47
+ const match = matchRoute(route.pattern, pathname);
48
+ return match.matched ? match.params : null;
49
+ }
50
+ function buildWebSocketInstanceId(route, params) {
51
+ if (route.key) {
52
+ const key = route.key({ params });
53
+ if (typeof key !== "string") throw new Error("ws: key must return a string synchronously.");
54
+ return key;
55
+ }
56
+ if (route.params.length === 0) return "default";
57
+ const entries = route.params.map((name) => [name, params[name] ?? ""]);
58
+ if (entries.length > 1 && entries.some(([, value]) => value.includes("&"))) return `v2:${JSON.stringify(entries)}`;
59
+ return route.params.map((name) => `${name}=${params[name] ?? ""}`).join("&");
60
+ }
61
+ async function serializeServerEvent(schema, event) {
62
+ const result = await schema["~standard"].validate(event);
63
+ if (result.issues) throw new Error(`ws: Message validation failed: ${result.issues.map((issue) => issue.message).join("; ")}.`);
64
+ return JSON.stringify(result.value);
65
+ }
66
+ function parseIncomingMessage(message) {
67
+ if (typeof message === "string") return message;
68
+ if (message instanceof ArrayBuffer) return new TextDecoder().decode(message);
69
+ return new TextDecoder().decode(message.buffer.slice(message.byteOffset, message.byteOffset + message.byteLength));
70
+ }
71
+ function withAuthState(state, fn) {
72
+ return Promise.resolve(authContext.run({
73
+ user: state?.user ?? null,
74
+ state
75
+ }, fn));
76
+ }
77
+ function getStoredConnection(webSocket) {
78
+ const stored = webSocket.deserializeAttachment?.();
79
+ if (stored) return {
80
+ ...stored,
81
+ authState: stored.authState ?? null
82
+ };
83
+ return {
84
+ id: crypto.randomUUID(),
85
+ params: {},
86
+ roomId: "default",
87
+ user: null,
88
+ authState: null
89
+ };
90
+ }
91
+ function completeWebSocketClose(webSocket, code, reason) {
92
+ if (webSocket.readyState === 3) return;
93
+ if ([
94
+ 1004,
95
+ 1005,
96
+ 1006,
97
+ 1015
98
+ ].includes(code)) webSocket.close();
99
+ else webSocket.close(code, reason);
100
+ }
101
+ function setStoredConnection(webSocket, data) {
102
+ webSocket.serializeAttachment?.(data);
103
+ }
104
+ function createConnection(webSocket, serverSchema) {
105
+ return {
106
+ get id() {
107
+ return getStoredConnection(webSocket).id;
108
+ },
109
+ get state() {
110
+ return getStoredConnection(webSocket).state;
111
+ },
112
+ async send(event) {
113
+ webSocket.send(await serializeServerEvent(serverSchema, event));
114
+ },
115
+ close(code, reason) {
116
+ webSocket.close(code, reason);
117
+ },
118
+ setState(data) {
119
+ setStoredConnection(webSocket, {
120
+ ...getStoredConnection(webSocket),
121
+ state: data
122
+ });
123
+ }
124
+ };
125
+ }
126
+ function createRoomController(state, serverSchema) {
127
+ return {
128
+ async broadcast(event, excludeIds = []) {
129
+ const payload = await serializeServerEvent(serverSchema, event);
130
+ for (const socket of state.getWebSockets()) {
131
+ const stored = getStoredConnection(socket);
132
+ if (excludeIds.includes(stored.id)) continue;
133
+ socket.send(payload);
134
+ }
135
+ },
136
+ getConnections() {
137
+ return state.getWebSockets().map((socket) => createConnection(socket, serverSchema));
138
+ },
139
+ getConnection(id) {
140
+ const socket = state.getWebSockets().find((item) => getStoredConnection(item).id === id);
141
+ return socket ? createConnection(socket, serverSchema) : void 0;
142
+ }
143
+ };
144
+ }
145
+ function createHookContext(definition, state, env, request, webSocket, stored) {
146
+ const serverSchema = definition.messages.server;
147
+ const base = {
148
+ id: stored.roomId,
149
+ params: stored.params,
150
+ user: stored.user,
151
+ request,
152
+ env,
153
+ storage: state.storage
154
+ };
155
+ const connection = createConnection(webSocket, serverSchema);
156
+ return definition.__kind === "room" ? {
157
+ ...base,
158
+ room: createRoomController(state, serverSchema),
159
+ connection
160
+ } : {
161
+ ...base,
162
+ socket: connection
163
+ };
164
+ }
165
+ function assertDefinition(definition) {
166
+ if (!definition?.messages?.client || !definition?.messages?.server) throw new Error("ws: WebSocket routes must define both messages.client and messages.server.");
167
+ }
168
+ function createWebSocketDurableObject(definition, route, authRuntime, resolveAuthState) {
169
+ assertDefinition(definition);
170
+ if (definition.name !== route.name) throw new Error("ws: name must be statically discoverable in the route definition. Run bwf info to inspect this route.");
171
+ const instanceRoute = {
172
+ ...route,
173
+ key: definition.key
174
+ };
175
+ class NosamWebSocketDurableObject {
176
+ state;
177
+ env;
178
+ constructor(state, env) {
179
+ this.state = state;
180
+ this.env = env;
181
+ }
182
+ fetch(request) {
183
+ return withRuntimeEnv(this.env, () => this.handleFetch(request));
184
+ }
185
+ context(request, webSocket, stored) {
186
+ return createHookContext(definition, this.state, this.env, request, webSocket, stored);
187
+ }
188
+ async handleFetch(request) {
189
+ const params = getRouteMatch(request, route) ?? {};
190
+ const roomId = buildWebSocketInstanceId(instanceRoute, params);
191
+ const authState = authRuntime && resolveAuthState ? await resolveAuthState(request, this.env, authRuntime) : null;
192
+ const user = authState?.user ?? null;
193
+ if (request.headers.get("upgrade")?.toLowerCase() === "websocket") {
194
+ const pair = new WebSocketPair();
195
+ const client = pair[0];
196
+ const server = pair[1];
197
+ const stored = {
198
+ id: crypto.randomUUID(),
199
+ params,
200
+ roomId,
201
+ user,
202
+ authState
203
+ };
204
+ setStoredConnection(server, stored);
205
+ const beforeConnectCtx = this.context(request, server, stored);
206
+ const decision = await withAuthState(authState, () => definition.onBeforeConnect?.(beforeConnectCtx));
207
+ if (decision instanceof Response) return decision;
208
+ this.state.acceptWebSocket(server);
209
+ const connectCtx = this.context(request, server, stored);
210
+ await withAuthState(authState, () => definition.onConnect?.(connectCtx));
211
+ return new Response(null, {
212
+ status: 101,
213
+ webSocket: client
214
+ });
215
+ }
216
+ if (!definition.onRequest) return new Response("Upgrade Required", { status: 426 });
217
+ const stored = {
218
+ id: crypto.randomUUID(),
219
+ params,
220
+ roomId,
221
+ user,
222
+ authState
223
+ };
224
+ const ctx = this.context(request, new WebSocketPair()[1], stored);
225
+ return withAuthState(authState, () => definition.onRequest(ctx));
226
+ }
227
+ webSocketMessage(webSocket, message) {
228
+ return withRuntimeEnv(this.env, () => this.handleWebSocketMessage(webSocket, message));
229
+ }
230
+ async handleWebSocketMessage(webSocket, message) {
231
+ const stored = getStoredConnection(webSocket);
232
+ const raw = parseIncomingMessage(message);
233
+ let parsed;
234
+ try {
235
+ parsed = JSON.parse(raw);
236
+ } catch {
237
+ webSocket.close(1007, "Invalid JSON");
238
+ return;
239
+ }
240
+ const result = await definition.messages.client["~standard"].validate(parsed);
241
+ if (result.issues) {
242
+ webSocket.close(1007, "Invalid message");
243
+ return;
244
+ }
245
+ const request = new Request(`https://nosam.local${route.pattern}`);
246
+ const ctx = this.context(request, webSocket, stored);
247
+ await withAuthState(stored.authState ?? null, () => definition.onMessage?.(ctx, result.value));
248
+ }
249
+ webSocketClose(webSocket, code, reason, wasClean) {
250
+ return withRuntimeEnv(this.env, () => this.handleWebSocketClose(webSocket, code, reason, wasClean));
251
+ }
252
+ async handleWebSocketClose(webSocket, code, reason, wasClean) {
253
+ completeWebSocketClose(webSocket, code, reason);
254
+ const stored = getStoredConnection(webSocket);
255
+ const request = new Request(`https://nosam.local${route.pattern}`);
256
+ const ctx = this.context(request, webSocket, stored);
257
+ await withAuthState(stored.authState ?? null, () => definition.onClose?.(ctx, {
258
+ code,
259
+ reason,
260
+ wasClean
261
+ }));
262
+ }
263
+ }
264
+ return NosamWebSocketDurableObject;
265
+ }
266
+ /** Keep a removed WebSocket Durable Object class deployable without deleting its storage. */
267
+ function createWebSocketTombstoneDurableObject(className) {
268
+ return class NosamWebSocketTombstoneDurableObject {
269
+ state;
270
+ env;
271
+ constructor(state, env) {
272
+ this.state = state;
273
+ this.env = env;
274
+ }
275
+ async fetch() {
276
+ return new Response(`WebSocket route ${className} has been removed.`, { status: 410 });
277
+ }
278
+ async webSocketMessage(webSocket) {
279
+ webSocket.close(1012, "WebSocket route removed");
280
+ }
281
+ async webSocketClose(webSocket, code, reason) {
282
+ completeWebSocketClose(webSocket, code, reason);
283
+ }
284
+ };
285
+ }
286
+ function getStub(env, route, params) {
287
+ const binding = env[route.bindingName];
288
+ if (!binding) return null;
289
+ const id = binding.idFromName(buildWebSocketInstanceId(route, params));
290
+ return binding.get(id);
291
+ }
292
+ async function forwardWebSocketRequest(request, env, route) {
293
+ const stub = getStub(env, route, getRouteMatch(request, route) ?? {});
294
+ if (!stub) return new Response(`Missing Durable Object binding "${route.bindingName}"`, { status: 503 });
295
+ return stub.fetch(request);
296
+ }
297
+ export { buildWebSocketInstanceId, createWebSocketDurableObject, createWebSocketTombstoneDurableObject, forwardWebSocketRequest };
@@ -0,0 +1,2 @@
1
+ import { a as RoomContext, c as SocketContext, d as WebSocketConnection, f as WebSocketInstanceKey, h as defineWebSocket, i as ConnectCommonOptions, l as SocketDefinition, m as defineRoom, n as BwfSocket, o as RoomController, p as connect, r as BwfSocketCloseEvent, s as RoomDefinition, t as AnyWebSocketDefinition, u as WebSocketBaseContext } from "../ws-DZRiIpYw.mjs";
2
+ export { AnyWebSocketDefinition, BwfSocket, BwfSocketCloseEvent, ConnectCommonOptions, RoomContext, RoomController, RoomDefinition, SocketContext, SocketDefinition, WebSocketBaseContext, WebSocketConnection, WebSocketInstanceKey, connect, defineRoom, defineWebSocket };
@@ -0,0 +1,108 @@
1
+ import { t as isResourceName } from "../resource-name-DlJ9QXzg.mjs";
2
+ import { t as interpolateRouteParams } from "../route-url-BIDZT78M.mjs";
3
+ // src/runtime/ws.ts
4
+ function defineRoom(definition) {
5
+ assertResourceName(definition.name);
6
+ return {
7
+ ...definition,
8
+ __kind: "room"
9
+ };
10
+ }
11
+ function defineWebSocket(definition) {
12
+ assertResourceName(definition.name);
13
+ return {
14
+ ...definition,
15
+ __kind: "socket"
16
+ };
17
+ }
18
+ function assertResourceName(name) {
19
+ if (name !== void 0 && !isResourceName(name)) throw new Error("ws: name must contain a word starting with a letter.");
20
+ }
21
+ var BwfSocket = class {
22
+ url;
23
+ options;
24
+ socket = null;
25
+ listeners = {
26
+ message: /* @__PURE__ */ new Set(),
27
+ open: /* @__PURE__ */ new Set(),
28
+ close: /* @__PURE__ */ new Set(),
29
+ error: /* @__PURE__ */ new Set()
30
+ };
31
+ buffer = [];
32
+ reconnectAttempts = 0;
33
+ closedByUser = false;
34
+ reconnectTimer;
35
+ constructor(url, options) {
36
+ this.url = url;
37
+ this.options = options;
38
+ this.connect();
39
+ }
40
+ emit(type, value) {
41
+ for (const listener of this.listeners[type]) listener(value);
42
+ }
43
+ connect() {
44
+ const WebSocketCtor = globalThis.WebSocket;
45
+ if (!WebSocketCtor) throw new Error("ws: WebSocket is not available in this runtime.");
46
+ this.socket = new WebSocketCtor(this.url, this.options.protocols);
47
+ this.socket.addEventListener("open", () => {
48
+ this.reconnectAttempts = 0;
49
+ const queued = this.buffer.splice(0);
50
+ for (const item of queued) this.socket?.send(JSON.stringify(item));
51
+ this.emit("open", void 0);
52
+ });
53
+ this.socket.addEventListener("message", (event) => {
54
+ try {
55
+ this.emit("message", JSON.parse(event.data));
56
+ } catch (error) {
57
+ this.emit("error", error);
58
+ }
59
+ });
60
+ this.socket.addEventListener("error", (error) => {
61
+ this.emit("error", error);
62
+ });
63
+ this.socket.addEventListener("close", (event) => {
64
+ this.emit("close", {
65
+ code: event.code,
66
+ reason: event.reason,
67
+ wasClean: event.wasClean
68
+ });
69
+ if (this.closedByUser || this.options.reconnect === false) return;
70
+ if (this.options.maxReconnectAttempts != null && this.reconnectAttempts >= this.options.maxReconnectAttempts) return;
71
+ this.reconnectAttempts += 1;
72
+ const delay = this.options.reconnectDelayMs ?? 1e3;
73
+ this.reconnectTimer = setTimeout(() => this.connect(), delay);
74
+ });
75
+ }
76
+ send(event) {
77
+ if (this.socket?.readyState === 1) {
78
+ this.socket.send(JSON.stringify(event));
79
+ return;
80
+ }
81
+ this.buffer.push(event);
82
+ }
83
+ close(code, reason) {
84
+ this.closedByUser = true;
85
+ clearTimeout(this.reconnectTimer);
86
+ this.socket?.close(code, reason);
87
+ }
88
+ on(type, handler) {
89
+ this.listeners[type].add(handler);
90
+ return () => {
91
+ this.listeners[type].delete(handler);
92
+ };
93
+ }
94
+ };
95
+ function resolveBaseUrl(baseURL) {
96
+ if (baseURL) return new URL(baseURL);
97
+ const location = globalThis.location;
98
+ if (!location) throw new Error("ws: connect() requires a browser-like runtime or an explicit \"baseURL\".");
99
+ return new URL(location.href);
100
+ }
101
+ function connect(path, options = {}) {
102
+ const base = resolveBaseUrl(options.baseURL);
103
+ const resolvedPath = interpolateRouteParams(path, options.params);
104
+ const url = new URL(resolvedPath, base);
105
+ url.protocol = url.protocol === "https:" || url.protocol === "wss:" ? "wss:" : "ws:";
106
+ return new BwfSocket(url.toString(), options);
107
+ }
108
+ export { BwfSocket, connect, defineRoom, defineWebSocket };
@@ -0,0 +1,50 @@
1
+ import { t as UsageLimit } from "./limits-CMmYT2l8.mjs";
2
+ import { a as SandboxExecOptions, c as SandboxOptions, i as SandboxContainer } from "./sandbox-container-BqamdFCx.mjs";
3
+ import { Files } from "@cloudflare/sandbox";
4
+ declare const DEFAULT_SANDBOX_ID = "default";
5
+ declare const DEFAULT_SANDBOX_BINDING = "SANDBOX";
6
+ declare const SANDBOX_SERVICE_BINDING = "__NOSAM_SANDBOX";
7
+ type BwfSandboxOptions = SandboxOptions & {
8
+ binding?: string;
9
+ normalizeId?: boolean;
10
+ };
11
+ type SandboxProcess = {
12
+ pid: number;
13
+ isPty: boolean;
14
+ stdin: WritableStream | null;
15
+ stdout: ReadableStream | null;
16
+ stderr: ReadableStream | null;
17
+ readonly exitCode: Promise<number>;
18
+ output(): Promise<ExecOutput>;
19
+ kill(signal?: number): Promise<void>;
20
+ resize(cols: number, rows: number): Promise<void>;
21
+ };
22
+ type SandboxFiles = { [K in keyof Files]: Files[K] extends ((...args: infer A) => Promise<infer R>) ? (...args: A) => Promise<R> : never; };
23
+ type SandboxClient = {
24
+ exec(argv: Array<string>, options?: SandboxExecOptions): Promise<SandboxProcess>;
25
+ run(argv: Array<string>, options?: SandboxExecOptions): Promise<ExecOutput>;
26
+ files: SandboxFiles;
27
+ fetch(port: number, request: Request): Promise<Response>;
28
+ running(): Promise<boolean>;
29
+ destroy(): Promise<void>;
30
+ };
31
+ declare class SandboxLimitError extends UsageLimit {
32
+ override readonly name = "SandboxLimitError";
33
+ readonly reason: "concurrency" | "runtime_budget";
34
+ constructor(reason: "concurrency" | "runtime_budget", message?: string);
35
+ }
36
+ declare class SandboxUnavailableError extends Error {
37
+ override readonly name = "SandboxUnavailableError";
38
+ constructor(message?: string);
39
+ }
40
+ declare function __setSandboxBindingName(bindingName: string): void;
41
+ /** Generated local/native DO. Managed execution uses the trusted controller. */
42
+ declare class BwfPlatformSandbox<Env = unknown> extends SandboxContainer<Env> {
43
+ protected override beforeStart(): Promise<void>;
44
+ }
45
+ /** Resolve a container by name. Starts on the first command, file or port operation. */
46
+ declare function getSandbox(id?: string, options?: BwfSandboxOptions): Promise<SandboxClient>;
47
+ declare const sandbox: {
48
+ get: typeof getSandbox;
49
+ };
50
+ export { SANDBOX_SERVICE_BINDING as a, SandboxLimitError as c, __setSandboxBindingName as d, getSandbox as f, DEFAULT_SANDBOX_ID as i, SandboxProcess as l, BwfSandboxOptions as n, SandboxClient as o, sandbox as p, DEFAULT_SANDBOX_BINDING as r, SandboxFiles as s, BwfPlatformSandbox as t, SandboxUnavailableError as u };
@@ -0,0 +1,73 @@
1
+ import { DurableObject } from "cloudflare:workers";
2
+ type SandboxInstance = "lite" | "standard-1" | "standard-2" | "standard-3" | "standard-4";
3
+ type SandboxOptions = {
4
+ inactivityTimeoutMs?: number;
5
+ enableInternet?: boolean;
6
+ labels?: Record<string, string>;
7
+ };
8
+ type SandboxExecOptions = ContainerExecOptions & {
9
+ signal?: AbortSignal;
10
+ pty?: boolean | {
11
+ cols?: number;
12
+ rows?: number;
13
+ };
14
+ };
15
+ type SandboxCapability = {
16
+ invoke(operation: string, args: Array<unknown>): Promise<unknown>;
17
+ };
18
+ declare const SANDBOX_PORT_HEADER = "x-nosam-sandbox-port";
19
+ type SandboxProcessWire = {
20
+ capability: SandboxCapability;
21
+ pid: number;
22
+ isPty: boolean;
23
+ stdin: WritableStream | null;
24
+ stdout: ReadableStream | null;
25
+ stderr: ReadableStream | null;
26
+ };
27
+ type SandboxNativeContainer = Omit<Container, "start" | "exec"> & {
28
+ readonly images: Record<string, string>;
29
+ start(options: {
30
+ image: string;
31
+ instance: SandboxInstance;
32
+ enableInternet: boolean;
33
+ labels?: Record<string, string>;
34
+ entrypoint?: Array<string>;
35
+ }): void;
36
+ exec(argv: Array<string>, options?: SandboxExecOptions): Promise<ExecProcess & {
37
+ isPty?: boolean;
38
+ resize(cols: number, rows: number): void;
39
+ }>;
40
+ };
41
+ declare const DEFAULT_SANDBOX_INACTIVITY_TIMEOUT_MS: number;
42
+ declare function validateSandboxOptions(options: SandboxOptions): void;
43
+ /** Shared native execution, used by local Workers and the trusted platform controller. */
44
+ declare class SandboxContainer<Env = unknown> extends DurableObject<Env> {
45
+ #private;
46
+ protected instanceType: SandboxInstance;
47
+ protected starting: boolean;
48
+ fetch(request: Request): Promise<Response>;
49
+ constructor(ctx: DurableObjectState, env: Env);
50
+ protected get container(): SandboxNativeContainer;
51
+ configure(options: SandboxOptions): Promise<void>;
52
+ protected get inactivityTimeoutMs(): number;
53
+ protected beforeStart(): Promise<void>;
54
+ protected afterStart(): Promise<void>;
55
+ protected beforeUse(): Promise<void>;
56
+ protected stopped(): Promise<void>;
57
+ protected processContext(_exitCode: Promise<number>): unknown;
58
+ protected waitForProcessExit(exitCode: Promise<number>, _context?: unknown): Promise<number>;
59
+ /** Native abort listeners must be detached as soon as a process exits. */
60
+ protected execProcess(argv: Array<string>, options?: SandboxExecOptions): Promise<ExecProcess & {
61
+ isPty?: boolean;
62
+ resize(cols: number, rows: number): void;
63
+ }>;
64
+ protected initializationOutput(argv: Array<string>, options: SandboxExecOptions, timeoutMs: number): Promise<ExecOutput>;
65
+ protected initialize(): Promise<void>;
66
+ protected get entrypoint(): Array<string> | undefined;
67
+ protected get image(): string;
68
+ protected ensureRunning(): Promise<void>;
69
+ private setup;
70
+ destroy(): Promise<void>;
71
+ invoke(operation: string, args: Array<unknown>): Promise<unknown>;
72
+ }
73
+ export { SandboxExecOptions as a, SandboxOptions as c, SandboxContainer as i, SandboxProcessWire as l, SANDBOX_PORT_HEADER as n, SandboxInstance as o, SandboxCapability as r, SandboxNativeContainer as s, DEFAULT_SANDBOX_INACTIVITY_TIMEOUT_MS as t, validateSandboxOptions as u };