@adea-ai/app-framework 0.0.0-stage → 0.24.0

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 (474) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +30 -0
  3. package/README.md +967 -2
  4. package/dist/app/application.d.ts +47 -0
  5. package/dist/app/application.js +115 -0
  6. package/dist/app/create-application.d.ts +13 -0
  7. package/dist/app/create-application.js +178 -0
  8. package/dist/app/service-registry.d.ts +44 -0
  9. package/dist/app/service-registry.js +116 -0
  10. package/dist/appearance/appearance-host.d.ts +62 -0
  11. package/dist/appearance/appearance-host.js +115 -0
  12. package/dist/appearance/appearance-preferences.d.ts +106 -0
  13. package/dist/appearance/appearance-preferences.js +175 -0
  14. package/dist/appearance/composition.d.ts +11 -0
  15. package/dist/appearance/composition.js +16 -0
  16. package/dist/appearance/custom-theme-import.d.ts +14 -0
  17. package/dist/appearance/custom-theme-import.js +315 -0
  18. package/dist/appearance/custom-theme-library.d.ts +146 -0
  19. package/dist/appearance/custom-theme-library.js +378 -0
  20. package/dist/appearance/editor.d.ts +20 -0
  21. package/dist/appearance/editor.js +47 -0
  22. package/dist/appearance/theme-file-importer.d.ts +23 -0
  23. package/dist/appearance/theme-file-importer.js +66 -0
  24. package/dist/appearance/theme-record-adapter.d.ts +26 -0
  25. package/dist/appearance/theme-record-adapter.js +64 -0
  26. package/dist/appearance/theme-registry.d.ts +10 -0
  27. package/dist/appearance/theme-registry.js +16 -0
  28. package/dist/appearance/window-surface.d.ts +5 -0
  29. package/dist/appearance/window-surface.js +9 -0
  30. package/dist/ci/toolchain-identity.d.ts +39 -0
  31. package/dist/ci/toolchain-identity.js +196 -0
  32. package/dist/cli/cef-helper-cli.d.ts +2 -0
  33. package/dist/cli/cef-helper-cli.js +18 -0
  34. package/dist/cli/cli-runner.d.ts +8 -0
  35. package/dist/cli/cli-runner.js +23 -0
  36. package/dist/cli/create-application-cli.d.ts +2 -0
  37. package/dist/cli/create-application-cli.js +40 -0
  38. package/dist/cli/electrobun-shortcut-patch-cli.d.ts +2 -0
  39. package/dist/cli/electrobun-shortcut-patch-cli.js +17 -0
  40. package/dist/cli/framework-update-cli.d.ts +2 -0
  41. package/dist/cli/framework-update-cli.js +40 -0
  42. package/dist/cli/release-assets-plan-cli.d.ts +2 -0
  43. package/dist/cli/release-assets-plan-cli.js +14 -0
  44. package/dist/cli/release-cut-cli.d.ts +2 -0
  45. package/dist/cli/release-cut-cli.js +27 -0
  46. package/dist/cli/release-descriptor-staging-cli.d.ts +2 -0
  47. package/dist/cli/release-descriptor-staging-cli.js +45 -0
  48. package/dist/cli/release-finalize-cli.d.ts +1 -0
  49. package/dist/cli/release-finalize-cli.js +30 -0
  50. package/dist/cli/release-promote-cli.d.ts +2 -0
  51. package/dist/cli/release-promote-cli.js +32 -0
  52. package/dist/cli/release-publish-cli.d.ts +2 -0
  53. package/dist/cli/release-publish-cli.js +48 -0
  54. package/dist/cli/release-sign-cli.d.ts +2 -0
  55. package/dist/cli/release-sign-cli.js +13 -0
  56. package/dist/cli/release-step-cli.d.ts +2 -0
  57. package/dist/cli/release-step-cli.js +44 -0
  58. package/dist/cli/toolchain-identity-cli.d.ts +2 -0
  59. package/dist/cli/toolchain-identity-cli.js +10 -0
  60. package/dist/cli/update-helper-cli.d.ts +1 -0
  61. package/dist/cli/update-helper-cli.js +10 -0
  62. package/dist/cli/windows-runtime-patch-cli.d.ts +2 -0
  63. package/dist/cli/windows-runtime-patch-cli.js +17 -0
  64. package/dist/desktop/application-command-client.d.ts +15 -0
  65. package/dist/desktop/application-command-client.js +21 -0
  66. package/dist/desktop/channel-handshake.d.ts +32 -0
  67. package/dist/desktop/channel-handshake.js +111 -0
  68. package/dist/desktop/channel-proof.d.ts +43 -0
  69. package/dist/desktop/channel-proof.js +85 -0
  70. package/dist/desktop/client-assets.d.ts +7 -0
  71. package/dist/desktop/client-assets.js +59 -0
  72. package/dist/desktop/desktop-client.d.ts +23 -0
  73. package/dist/desktop/desktop-client.js +231 -0
  74. package/dist/desktop/desktop-gateway.d.ts +18 -0
  75. package/dist/desktop/desktop-gateway.js +146 -0
  76. package/dist/desktop/desktop-host.d.ts +48 -0
  77. package/dist/desktop/desktop-host.js +208 -0
  78. package/dist/desktop/desktop-stream.d.ts +36 -0
  79. package/dist/desktop/desktop-stream.js +231 -0
  80. package/dist/desktop/loopback-policy.d.ts +19 -0
  81. package/dist/desktop/loopback-policy.js +23 -0
  82. package/dist/desktop/open-url-channel.d.ts +15 -0
  83. package/dist/desktop/open-url-channel.js +55 -0
  84. package/dist/desktop/string-policy.d.ts +2 -0
  85. package/dist/desktop/string-policy.js +11 -0
  86. package/dist/framework-source.json +1 -0
  87. package/dist/installer/archive-entry.d.ts +6 -0
  88. package/dist/installer/archive-entry.js +14 -0
  89. package/dist/installer/command-artifact.d.ts +47 -0
  90. package/dist/installer/command-artifact.js +261 -0
  91. package/dist/installer/command-qualification-command.d.ts +12 -0
  92. package/dist/installer/command-qualification-command.js +71 -0
  93. package/dist/installer/hosted-runner.d.ts +4 -0
  94. package/dist/installer/hosted-runner.js +10 -0
  95. package/dist/installer/installed-payload.d.ts +29 -0
  96. package/dist/installer/installed-payload.js +312 -0
  97. package/dist/installer/installer-ci-bootstrap.d.ts +26 -0
  98. package/dist/installer/installer-ci-bootstrap.js +160 -0
  99. package/dist/installer/installer-ci-preflight.d.ts +1 -0
  100. package/dist/installer/installer-ci-preflight.js +49 -0
  101. package/dist/installer/installer-ci-worker.d.ts +1 -0
  102. package/dist/installer/installer-ci-worker.js +105 -0
  103. package/dist/installer/installer-extraction.d.ts +14 -0
  104. package/dist/installer/installer-extraction.js +289 -0
  105. package/dist/installer/installer-fetch-guard.d.ts +15 -0
  106. package/dist/installer/installer-fetch-guard.js +50 -0
  107. package/dist/installer/installer-identity.d.ts +23 -0
  108. package/dist/installer/installer-identity.js +286 -0
  109. package/dist/installer/installer-layout.d.ts +21 -0
  110. package/dist/installer/installer-layout.js +89 -0
  111. package/dist/installer/installer-observation.d.ts +64 -0
  112. package/dist/installer/installer-observation.js +473 -0
  113. package/dist/installer/installer-process-cleanup.d.ts +18 -0
  114. package/dist/installer/installer-process-cleanup.js +158 -0
  115. package/dist/installer/installer-qualification-command.d.ts +11 -0
  116. package/dist/installer/installer-qualification-command.js +71 -0
  117. package/dist/installer/installer-renderer-evidence.d.ts +43 -0
  118. package/dist/installer/installer-renderer-evidence.js +136 -0
  119. package/dist/installer/installer-upgrade-command.d.ts +37 -0
  120. package/dist/installer/installer-upgrade-command.js +172 -0
  121. package/dist/installer/installer-worker-guard.d.ts +21 -0
  122. package/dist/installer/installer-worker-guard.js +72 -0
  123. package/dist/installer/native-executable.d.ts +5 -0
  124. package/dist/installer/native-executable.js +21 -0
  125. package/dist/installer/upgrade-asset-download.d.ts +13 -0
  126. package/dist/installer/upgrade-asset-download.js +41 -0
  127. package/dist/installer/write-all.d.ts +6 -0
  128. package/dist/installer/write-all.js +11 -0
  129. package/dist/native/app-bundle.d.ts +28 -0
  130. package/dist/native/app-bundle.js +60 -0
  131. package/dist/native/cef-helper.d.ts +28 -0
  132. package/dist/native/cef-helper.js +402 -0
  133. package/dist/native/desktop-build-hook.d.ts +7 -0
  134. package/dist/native/desktop-build-hook.js +20 -0
  135. package/dist/native/electrobun-source-patch.d.ts +25 -0
  136. package/dist/native/electrobun-source-patch.js +93 -0
  137. package/dist/native/linux-cef-links.d.ts +2 -0
  138. package/dist/native/linux-cef-links.js +15 -0
  139. package/dist/native/native-secret-store.d.ts +27 -0
  140. package/dist/native/native-secret-store.js +70 -0
  141. package/dist/native/native-utilities.d.ts +24 -0
  142. package/dist/native/native-utilities.js +85 -0
  143. package/dist/native/partitioned-window.d.ts +34 -0
  144. package/dist/native/partitioned-window.js +44 -0
  145. package/dist/native/renderer-profile.d.ts +53 -0
  146. package/dist/native/renderer-profile.js +30 -0
  147. package/dist/native/secure-window.d.ts +38 -0
  148. package/dist/native/secure-window.js +77 -0
  149. package/dist/native/sidecar-services.d.ts +23 -0
  150. package/dist/native/sidecar-services.js +46 -0
  151. package/dist/native/sidecar.d.ts +81 -0
  152. package/dist/native/sidecar.js +250 -0
  153. package/dist/native/window-bootstrap.d.ts +24 -0
  154. package/dist/native/window-bootstrap.js +63 -0
  155. package/dist/native/window-options.d.ts +32 -0
  156. package/dist/native/window-options.js +23 -0
  157. package/dist/native/windows-build-hook-internal.d.ts +2 -0
  158. package/dist/native/windows-build-hook-internal.js +32 -0
  159. package/dist/native/windows-build-hook.d.ts +2 -0
  160. package/dist/native/windows-build-hook.js +12 -0
  161. package/dist/native/windows-runtime-patch-internal.d.ts +3 -0
  162. package/dist/native/windows-runtime-patch-internal.js +20 -0
  163. package/dist/native/windows-runtime-patch.d.ts +4 -0
  164. package/dist/native/windows-runtime-patch.js +12 -0
  165. package/dist/release/feed-release-cut.d.ts +23 -0
  166. package/dist/release/feed-release-cut.js +93 -0
  167. package/dist/release/feed-state.d.ts +25 -0
  168. package/dist/release/feed-state.js +81 -0
  169. package/dist/release/framework-package-publish.d.ts +21 -0
  170. package/dist/release/framework-package-publish.js +125 -0
  171. package/dist/release/framework-update.d.ts +30 -0
  172. package/dist/release/framework-update.js +139 -0
  173. package/dist/release/github-cli.d.ts +6 -0
  174. package/dist/release/github-cli.js +16 -0
  175. package/dist/release/github-release-assets.d.ts +3 -0
  176. package/dist/release/github-release-assets.js +24 -0
  177. package/dist/release/github-release-cut.d.ts +14 -0
  178. package/dist/release/github-release-cut.js +174 -0
  179. package/dist/release/github-release-lookup.d.ts +7 -0
  180. package/dist/release/github-release-lookup.js +29 -0
  181. package/dist/release/github-release-promotion.d.ts +10 -0
  182. package/dist/release/github-release-promotion.js +78 -0
  183. package/dist/release/github-release-provenance.d.ts +9 -0
  184. package/dist/release/github-release-provenance.js +27 -0
  185. package/dist/release/github-release-publisher.d.ts +9 -0
  186. package/dist/release/github-release-publisher.js +63 -0
  187. package/dist/release/github-release-qualification.d.ts +12 -0
  188. package/dist/release/github-release-qualification.js +80 -0
  189. package/dist/release/local-provenance.d.ts +24 -0
  190. package/dist/release/local-provenance.js +72 -0
  191. package/dist/release/local-release.d.ts +133 -0
  192. package/dist/release/local-release.js +387 -0
  193. package/dist/release/macos-dmg.d.ts +22 -0
  194. package/dist/release/macos-dmg.js +91 -0
  195. package/dist/release/release-artifact.d.ts +6 -0
  196. package/dist/release/release-artifact.js +38 -0
  197. package/dist/release/release-assets-plan.d.ts +14 -0
  198. package/dist/release/release-assets-plan.js +65 -0
  199. package/dist/release/release-config.d.ts +76 -0
  200. package/dist/release/release-config.js +180 -0
  201. package/dist/release/release-cut-command.d.ts +13 -0
  202. package/dist/release/release-cut-command.js +39 -0
  203. package/dist/release/release-cut.d.ts +54 -0
  204. package/dist/release/release-cut.js +76 -0
  205. package/dist/release/release-descriptor-staging.d.ts +34 -0
  206. package/dist/release/release-descriptor-staging.js +147 -0
  207. package/dist/release/release-finalize.d.ts +16 -0
  208. package/dist/release/release-finalize.js +104 -0
  209. package/dist/release/release-promotion-command.d.ts +12 -0
  210. package/dist/release/release-promotion-command.js +28 -0
  211. package/dist/release/release-promotion.d.ts +29 -0
  212. package/dist/release/release-promotion.js +57 -0
  213. package/dist/release/release-publication.d.ts +33 -0
  214. package/dist/release/release-publication.js +138 -0
  215. package/dist/release/release-publish-command.d.ts +7 -0
  216. package/dist/release/release-publish-command.js +91 -0
  217. package/dist/release/release-qualification.d.ts +106 -0
  218. package/dist/release/release-qualification.js +135 -0
  219. package/dist/release/release-staging.d.ts +9 -0
  220. package/dist/release/release-staging.js +61 -0
  221. package/dist/release/release-steps.d.ts +38 -0
  222. package/dist/release/release-steps.js +147 -0
  223. package/dist/release/retained-release-build.d.ts +19 -0
  224. package/dist/release/retained-release-build.js +122 -0
  225. package/dist/shell/app-shell.d.ts +61 -0
  226. package/dist/shell/app-shell.js +318 -0
  227. package/dist/shell/app-utilities.d.ts +122 -0
  228. package/dist/shell/app-utilities.js +334 -0
  229. package/dist/shell/application-menu-commands.d.ts +5 -0
  230. package/dist/shell/application-menu-commands.js +11 -0
  231. package/dist/shell/application-menu.d.ts +61 -0
  232. package/dist/shell/application-menu.js +208 -0
  233. package/dist/shell/help-shortcuts.d.ts +12 -0
  234. package/dist/shell/help-shortcuts.js +22 -0
  235. package/dist/shell/settings-sections.d.ts +31 -0
  236. package/dist/shell/settings-sections.js +50 -0
  237. package/dist/shell/shortcut-platform.d.ts +17 -0
  238. package/dist/shell/shortcut-platform.js +25 -0
  239. package/dist/update-helper.bundle.js +260 -0
  240. package/dist/updates/channel-update-manager.d.ts +46 -0
  241. package/dist/updates/channel-update-manager.js +114 -0
  242. package/dist/updates/desktop-updater.d.ts +104 -0
  243. package/dist/updates/desktop-updater.js +345 -0
  244. package/dist/updates/release-feed.d.ts +61 -0
  245. package/dist/updates/release-feed.js +111 -0
  246. package/dist/updates/release-location.d.ts +9 -0
  247. package/dist/updates/release-location.js +80 -0
  248. package/dist/updates/release-version.d.ts +12 -0
  249. package/dist/updates/release-version.js +43 -0
  250. package/dist/updates/signed-release.d.ts +63 -0
  251. package/dist/updates/signed-release.js +162 -0
  252. package/dist/updates/stable-file.d.ts +10 -0
  253. package/dist/updates/stable-file.js +22 -0
  254. package/dist/updates/update-adapter.d.ts +57 -0
  255. package/dist/updates/update-adapter.js +72 -0
  256. package/dist/updates/update-arm.d.ts +24 -0
  257. package/dist/updates/update-arm.js +95 -0
  258. package/dist/updates/update-channel-store.d.ts +8 -0
  259. package/dist/updates/update-channel-store.js +72 -0
  260. package/dist/updates/update-discovery.d.ts +13 -0
  261. package/dist/updates/update-discovery.js +56 -0
  262. package/dist/updates/update-download.d.ts +14 -0
  263. package/dist/updates/update-download.js +67 -0
  264. package/dist/updates/update-exclusive-rename.d.ts +2 -0
  265. package/dist/updates/update-exclusive-rename.js +52 -0
  266. package/dist/updates/update-extraction.d.ts +18 -0
  267. package/dist/updates/update-extraction.js +183 -0
  268. package/dist/updates/update-handoff-plan.d.ts +22 -0
  269. package/dist/updates/update-handoff-plan.js +28 -0
  270. package/dist/updates/update-helper.d.ts +24 -0
  271. package/dist/updates/update-helper.js +56 -0
  272. package/dist/updates/update-launch.d.ts +5 -0
  273. package/dist/updates/update-launch.js +27 -0
  274. package/dist/updates/update-manager.d.ts +40 -0
  275. package/dist/updates/update-manager.js +83 -0
  276. package/dist/updates/update-process-fence.d.ts +10 -0
  277. package/dist/updates/update-process-fence.js +114 -0
  278. package/dist/updates/update-resume.d.ts +13 -0
  279. package/dist/updates/update-resume.js +34 -0
  280. package/dist/updates/update-shutdown.d.ts +15 -0
  281. package/dist/updates/update-shutdown.js +29 -0
  282. package/dist/updates/update-state.d.ts +30 -0
  283. package/dist/updates/update-state.js +18 -0
  284. package/dist/updates/update-swap-stage.d.ts +27 -0
  285. package/dist/updates/update-swap-stage.js +58 -0
  286. package/dist/updates/update-swap.d.ts +10 -0
  287. package/dist/updates/update-swap.js +30 -0
  288. package/dist/views/app-about.d.ts +22 -0
  289. package/dist/views/app-about.js +43 -0
  290. package/dist/views/app-appearance.d.ts +11 -0
  291. package/dist/views/app-appearance.js +42 -0
  292. package/dist/views/app-help.d.ts +17 -0
  293. package/dist/views/app-help.js +42 -0
  294. package/dist/views/app-settings.d.ts +26 -0
  295. package/dist/views/app-settings.js +97 -0
  296. package/dist/views/appearance-surface.d.ts +9 -0
  297. package/dist/views/appearance-surface.js +334 -0
  298. package/dist/views/update-surface.d.ts +34 -0
  299. package/dist/views/update-surface.js +64 -0
  300. package/package.json +363 -4
  301. package/src/app/application.tsx +138 -0
  302. package/src/app/create-application.ts +245 -0
  303. package/src/app/service-registry.ts +124 -0
  304. package/src/appearance/appearance-host.tsx +205 -0
  305. package/src/appearance/appearance-preferences.ts +287 -0
  306. package/src/appearance/composition.ts +29 -0
  307. package/src/appearance/custom-theme-import.ts +424 -0
  308. package/src/appearance/custom-theme-library.ts +600 -0
  309. package/src/appearance/editor.ts +94 -0
  310. package/src/appearance/theme-file-importer.ts +103 -0
  311. package/src/appearance/theme-record-adapter.ts +106 -0
  312. package/src/appearance/theme-registry.ts +20 -0
  313. package/src/appearance/window-surface.ts +18 -0
  314. package/src/ci/toolchain-identity.ts +244 -0
  315. package/src/cli/cef-helper-cli.ts +21 -0
  316. package/src/cli/cli-runner.ts +29 -0
  317. package/src/cli/create-application-cli.ts +62 -0
  318. package/src/cli/electrobun-shortcut-patch-cli.ts +24 -0
  319. package/src/cli/framework-update-cli.ts +41 -0
  320. package/src/cli/release-assets-plan-cli.ts +14 -0
  321. package/src/cli/release-cut-cli.ts +41 -0
  322. package/src/cli/release-descriptor-staging-cli.ts +57 -0
  323. package/src/cli/release-finalize-cli.ts +34 -0
  324. package/src/cli/release-promote-cli.ts +31 -0
  325. package/src/cli/release-publish-cli.ts +46 -0
  326. package/src/cli/release-sign-cli.ts +24 -0
  327. package/src/cli/release-step-cli.ts +71 -0
  328. package/src/cli/toolchain-identity-cli.ts +12 -0
  329. package/src/cli/update-helper-cli.ts +12 -0
  330. package/src/cli/windows-runtime-patch-cli.ts +17 -0
  331. package/src/desktop/application-command-client.ts +43 -0
  332. package/src/desktop/channel-handshake.ts +136 -0
  333. package/src/desktop/channel-proof.ts +122 -0
  334. package/src/desktop/client-assets.ts +75 -0
  335. package/src/desktop/desktop-client.ts +303 -0
  336. package/src/desktop/desktop-gateway.ts +189 -0
  337. package/src/desktop/desktop-host.ts +335 -0
  338. package/src/desktop/desktop-stream.ts +324 -0
  339. package/src/desktop/loopback-policy.ts +41 -0
  340. package/src/desktop/open-url-channel.ts +79 -0
  341. package/src/desktop/string-policy.ts +9 -0
  342. package/src/installer/archive-entry.ts +32 -0
  343. package/src/installer/command-artifact.ts +307 -0
  344. package/src/installer/command-qualification-command.ts +75 -0
  345. package/src/installer/hosted-runner.ts +11 -0
  346. package/src/installer/installed-payload.ts +408 -0
  347. package/src/installer/installer-ci-bootstrap.ts +199 -0
  348. package/src/installer/installer-ci-preflight.ts +61 -0
  349. package/src/installer/installer-ci-worker.ts +105 -0
  350. package/src/installer/installer-extraction.ts +367 -0
  351. package/src/installer/installer-fetch-guard.ts +75 -0
  352. package/src/installer/installer-identity.ts +331 -0
  353. package/src/installer/installer-layout.ts +167 -0
  354. package/src/installer/installer-observation.ts +671 -0
  355. package/src/installer/installer-process-cleanup.ts +167 -0
  356. package/src/installer/installer-qualification-command.ts +81 -0
  357. package/src/installer/installer-renderer-evidence.ts +268 -0
  358. package/src/installer/installer-upgrade-command.ts +226 -0
  359. package/src/installer/installer-worker-guard.ts +112 -0
  360. package/src/installer/native-executable.ts +37 -0
  361. package/src/installer/upgrade-asset-download.ts +72 -0
  362. package/src/installer/write-all.ts +19 -0
  363. package/src/native/app-bundle.ts +86 -0
  364. package/src/native/cef-helper.ts +471 -0
  365. package/src/native/desktop-build-hook.ts +21 -0
  366. package/src/native/electrobun-cef-main-frame-bridges.patch +63 -0
  367. package/src/native/electrobun-source-patch.ts +107 -0
  368. package/src/native/electrobun-windows-shortcut-com.patch +923 -0
  369. package/src/native/linux-cef-links.ts +14 -0
  370. package/src/native/native-secret-store.ts +99 -0
  371. package/src/native/native-utilities.ts +166 -0
  372. package/src/native/partitioned-window.ts +62 -0
  373. package/src/native/renderer-profile.ts +27 -0
  374. package/src/native/secure-window.ts +115 -0
  375. package/src/native/sidecar-services.ts +71 -0
  376. package/src/native/sidecar.ts +387 -0
  377. package/src/native/window-bootstrap.ts +77 -0
  378. package/src/native/window-options.ts +24 -0
  379. package/src/native/windows-build-hook-internal.ts +49 -0
  380. package/src/native/windows-build-hook.ts +12 -0
  381. package/src/native/windows-runtime-patch-internal.ts +48 -0
  382. package/src/native/windows-runtime-patch.ts +15 -0
  383. package/src/release/feed-release-cut.ts +110 -0
  384. package/src/release/feed-state.ts +135 -0
  385. package/src/release/framework-package-publish.ts +163 -0
  386. package/src/release/framework-update.ts +196 -0
  387. package/src/release/github-cli.ts +27 -0
  388. package/src/release/github-release-assets.ts +36 -0
  389. package/src/release/github-release-cut.ts +237 -0
  390. package/src/release/github-release-lookup.ts +39 -0
  391. package/src/release/github-release-promotion.ts +112 -0
  392. package/src/release/github-release-provenance.ts +65 -0
  393. package/src/release/github-release-publisher.ts +90 -0
  394. package/src/release/github-release-qualification.ts +144 -0
  395. package/src/release/local-provenance.ts +92 -0
  396. package/src/release/local-release.ts +525 -0
  397. package/src/release/macos-dmg.ts +113 -0
  398. package/src/release/release-artifact.ts +53 -0
  399. package/src/release/release-assets-plan.ts +118 -0
  400. package/src/release/release-config.ts +420 -0
  401. package/src/release/release-cut-command.ts +80 -0
  402. package/src/release/release-cut.ts +133 -0
  403. package/src/release/release-descriptor-staging.ts +242 -0
  404. package/src/release/release-finalize.ts +191 -0
  405. package/src/release/release-promotion-command.ts +36 -0
  406. package/src/release/release-promotion.ts +132 -0
  407. package/src/release/release-publication.ts +213 -0
  408. package/src/release/release-publish-command.ts +163 -0
  409. package/src/release/release-qualification.ts +397 -0
  410. package/src/release/release-staging.ts +87 -0
  411. package/src/release/release-steps.ts +173 -0
  412. package/src/release/retained-release-build.ts +217 -0
  413. package/src/shell/app-shell.tsx +285 -0
  414. package/src/shell/app-utilities.tsx +437 -0
  415. package/src/shell/application-menu-commands.ts +6 -0
  416. package/src/shell/application-menu.ts +250 -0
  417. package/src/shell/help-shortcuts.ts +24 -0
  418. package/src/shell/settings-sections.ts +74 -0
  419. package/src/shell/shortcut-platform.ts +35 -0
  420. package/src/updates/channel-update-manager.ts +127 -0
  421. package/src/updates/desktop-updater.ts +440 -0
  422. package/src/updates/release-feed.ts +187 -0
  423. package/src/updates/release-location.ts +101 -0
  424. package/src/updates/release-version.ts +57 -0
  425. package/src/updates/signed-release.ts +311 -0
  426. package/src/updates/stable-file.ts +32 -0
  427. package/src/updates/update-adapter.ts +129 -0
  428. package/src/updates/update-arm.ts +107 -0
  429. package/src/updates/update-channel-store.ts +86 -0
  430. package/src/updates/update-discovery.ts +113 -0
  431. package/src/updates/update-download.ts +82 -0
  432. package/src/updates/update-exclusive-rename.ts +58 -0
  433. package/src/updates/update-extraction.ts +261 -0
  434. package/src/updates/update-handoff-plan.ts +75 -0
  435. package/src/updates/update-helper.ts +87 -0
  436. package/src/updates/update-launch.ts +33 -0
  437. package/src/updates/update-manager.ts +130 -0
  438. package/src/updates/update-process-fence.ts +125 -0
  439. package/src/updates/update-resume.ts +34 -0
  440. package/src/updates/update-shutdown.ts +37 -0
  441. package/src/updates/update-state.ts +34 -0
  442. package/src/updates/update-swap-stage.ts +75 -0
  443. package/src/updates/update-swap.ts +30 -0
  444. package/src/views/app-about.tsx +44 -0
  445. package/src/views/app-appearance.tsx +32 -0
  446. package/src/views/app-help.tsx +43 -0
  447. package/src/views/app-settings.tsx +88 -0
  448. package/src/views/appearance-surface.tsx +427 -0
  449. package/src/views/update-surface.tsx +85 -0
  450. package/templates/application/.gitattributes +1 -0
  451. package/templates/application/.github/workflows/release-assets.yml +29 -0
  452. package/templates/application/.github/workflows/release-finalize.yml +29 -0
  453. package/templates/application/.github/workflows/release-please.yml +19 -0
  454. package/templates/application/.github/workflows/release.yml +29 -0
  455. package/templates/application/.github/workflows/validation.yml +28 -0
  456. package/templates/application/.oxfmtrc.json +6 -0
  457. package/templates/application/.oxlintrc.json +48 -0
  458. package/templates/application/.release-please-manifest.json +3 -0
  459. package/templates/application/README.md +47 -0
  460. package/templates/application/electrobun.config.ts +22 -0
  461. package/templates/application/release-please-config.json +12 -0
  462. package/templates/application/scripts/app-version.ts +9 -0
  463. package/templates/application/scripts/build-desktop.ts +34 -0
  464. package/templates/application/scripts/secure-build.ts +1 -0
  465. package/templates/application/scripts/stage-release.ts +21 -0
  466. package/templates/application/src/bun/index.ts +80 -0
  467. package/templates/application/src/electrobun.d.ts +27 -0
  468. package/templates/application/src/web/index.html +12 -0
  469. package/templates/application/src/web/main.tsx +97 -0
  470. package/templates/application/src/web/public/icon.svg +1 -0
  471. package/templates/application/src/web/style.css +3 -0
  472. package/templates/application/tests/app-config.test.ts +9 -0
  473. package/templates/application/tsconfig.json +15 -0
  474. package/templates/application/vite.config.ts +10 -0
@@ -0,0 +1,167 @@
1
+ import { dlopen, FFIType, ptr } from 'bun:ffi'
2
+ import { execFile } from 'node:child_process'
3
+ import { realpath } from 'node:fs/promises'
4
+ import { promisify } from 'node:util'
5
+ import { assertInstallerContext, type InstallerPlatform } from './installer-layout'
6
+ const execute = promisify(execFile)
7
+ /** Terminate only the verified app runtime process on a disposable runner. */
8
+ export async function terminateGuardedWorker(options: {
9
+ pid: number
10
+ runtime: string
11
+ platform: InstallerPlatform
12
+ env: Record<string, string | undefined>
13
+ }): Promise<void> {
14
+ const { pid, runtime, platform } = options
15
+ assertInstallerContext(options.env, platform, process.platform, process.arch)
16
+ if (!Number.isSafeInteger(pid) || pid < 2 || pid === process.pid)
17
+ throw new Error('Invalid guarded process identity')
18
+ const env: Record<string, string> = {}
19
+ for (const name of [
20
+ 'PATH',
21
+ 'SystemRoot',
22
+ 'WINDIR',
23
+ 'COMSPEC',
24
+ 'PATHEXT',
25
+ 'TMP',
26
+ 'TEMP',
27
+ 'TMPDIR',
28
+ 'LANG',
29
+ 'LC_ALL',
30
+ ])
31
+ if (options.env[name]) env[name] = options.env[name]!
32
+ const expected = await realpath(runtime)
33
+ const actual = await runningExecutable(pid, platform, env)
34
+ // A worker that exited on its own is already cleaned up.
35
+ if (actual === undefined) return
36
+ // A macOS worker already exiting on its own has released its executable; it needs no
37
+ // signal, only time to finish.
38
+ if (actual !== EXITING) {
39
+ if (
40
+ platform === 'windows-x64'
41
+ ? actual.toLowerCase() !== expected.toLowerCase()
42
+ : actual !== expected
43
+ )
44
+ throw new Error('Guarded process executable mismatch')
45
+ process.kill(pid, 'SIGKILL')
46
+ }
47
+ const deadline = Date.now() + 5000
48
+ while (Date.now() < deadline) {
49
+ // The executable was verified before the signal. On macOS its command may
50
+ // become unavailable while exit is in progress, before the process is a
51
+ // zombie; only the state is needed to observe completion here.
52
+ if (
53
+ platform === 'macos-arm64'
54
+ ? await macosWorkerExited(() => readMacosState(pid, env))
55
+ : (await runningExecutable(pid, platform, env)) === undefined
56
+ )
57
+ return
58
+ await Bun.sleep(100)
59
+ }
60
+ throw new Error('Guarded process did not exit')
61
+ }
62
+
63
+ const EXITING = Symbol('exiting')
64
+
65
+ /**
66
+ * Read one `ps -o stat= -o comm=` line. macOS reports the command of a process that is
67
+ * exiting (`E`) or an unreaped zombie (`Z`) as `(bun)` or `<defunct>`, not an executable
68
+ * path. A zombie has already exited and cannot be killed; an exiting process is pending.
69
+ */
70
+ export function macosProcess(line: string): string | typeof EXITING | undefined {
71
+ const match = /^(\S+)\s+(.+)$/.exec(line.trim())
72
+ if (!match) throw new Error('Unable to query guarded process state')
73
+ const [, state, command] = match as unknown as [string, string, string]
74
+ if (state.startsWith('Z')) return undefined
75
+ if (state.includes('E') || !command.startsWith('/')) return EXITING
76
+ return command
77
+ }
78
+
79
+ /** An absent or zombie process has exited; an exiting process is still pending. */
80
+ export async function macosWorkerExited(readState: () => Promise<string | undefined>) {
81
+ const state = (await readState())?.trim()
82
+ if (state === undefined) return true
83
+ if (!/^\S+$/.test(state)) throw new Error('Unable to query guarded process state')
84
+ return state.startsWith('Z')
85
+ }
86
+
87
+ async function readMacosState(pid: number, env: Record<string, string>) {
88
+ const listed = await execute('/bin/ps', ['-p', String(pid), '-o', 'stat='], {
89
+ env,
90
+ timeout: 5000,
91
+ maxBuffer: 16384,
92
+ }).catch((error: { code?: unknown }) => {
93
+ if (error.code === 1) return undefined
94
+ throw error
95
+ })
96
+ return listed?.stdout
97
+ }
98
+
99
+ /**
100
+ * The executable of a running process, or undefined once it has exited. On Windows
101
+ * an exited process stays openable while another process holds a handle to it (the
102
+ * Electrobun extractor that launched it), so a signal-0 probe would still report it
103
+ * alive; its exit code tells the truth.
104
+ */
105
+ async function runningExecutable(
106
+ pid: number,
107
+ platform: InstallerPlatform,
108
+ env: Record<string, string>
109
+ ): Promise<string | typeof EXITING | undefined> {
110
+ if (platform === 'linux-x64')
111
+ return realpath(`/proc/${pid}/exe`).catch((error: NodeJS.ErrnoException) => {
112
+ if (error.code === 'ENOENT') return undefined
113
+ throw error
114
+ })
115
+ if (platform === 'macos-arm64') {
116
+ const listed = await execute('/bin/ps', ['-p', String(pid), '-o', 'stat=', '-o', 'comm='], {
117
+ env,
118
+ timeout: 5000,
119
+ maxBuffer: 16384,
120
+ }).catch((error: { code?: unknown }) => {
121
+ // ps exits 1 when no process matches.
122
+ if (error.code === 1) return undefined
123
+ throw error
124
+ })
125
+ if (!listed) return undefined
126
+ const state = macosProcess(listed.stdout)
127
+ return state === EXITING || state === undefined ? state : realpath(state)
128
+ }
129
+ return windowsRunningExecutable(pid)
130
+ }
131
+
132
+ const PROCESS_QUERY_LIMITED_INFORMATION = 0x1000,
133
+ STILL_ACTIVE = 259
134
+
135
+ /** Ask the kernel directly: an exited process keeps no STILL_ACTIVE exit code even while
136
+ * another process holds a handle to it. */
137
+ async function windowsRunningExecutable(pid: number): Promise<string | undefined> {
138
+ const kernel = dlopen('kernel32.dll', {
139
+ OpenProcess: { args: [FFIType.u32, FFIType.i32, FFIType.u32], returns: FFIType.ptr },
140
+ GetExitCodeProcess: { args: [FFIType.ptr, FFIType.ptr], returns: FFIType.i32 },
141
+ QueryFullProcessImageNameW: {
142
+ args: [FFIType.ptr, FFIType.u32, FFIType.ptr, FFIType.ptr],
143
+ returns: FFIType.i32,
144
+ },
145
+ CloseHandle: { args: [FFIType.ptr], returns: FFIType.i32 },
146
+ })
147
+ try {
148
+ const handle = kernel.symbols.OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION, 0, pid)
149
+ // No such process, or a process id that was already released.
150
+ if (!handle) return undefined
151
+ try {
152
+ const code = new Uint32Array(1)
153
+ if (!kernel.symbols.GetExitCodeProcess(handle, ptr(code)))
154
+ throw new Error('Unable to query guarded process state')
155
+ if (code[0] !== STILL_ACTIVE) return undefined
156
+ const name = new Uint16Array(32768),
157
+ length = new Uint32Array([name.length])
158
+ if (!kernel.symbols.QueryFullProcessImageNameW(handle, 0, ptr(name), ptr(length)))
159
+ throw new Error('Unable to query guarded process executable')
160
+ return realpath(Buffer.from(name.buffer, 0, length[0]! * 2).toString('utf16le'))
161
+ } finally {
162
+ kernel.symbols.CloseHandle(handle)
163
+ }
164
+ } finally {
165
+ kernel.close()
166
+ }
167
+ }
@@ -0,0 +1,81 @@
1
+ import { lstat, writeFile } from 'node:fs/promises'
2
+ import { join, resolve } from 'node:path'
3
+ import { observeInstalledApp } from './installer-observation'
4
+ import { planReleaseAssets } from '../release/release-assets-plan'
5
+ import { parseReleaseConfig } from '../release/release-config'
6
+ import { validateInstallerReceipt, type InstallerReceipt } from '../release/release-qualification'
7
+ import type { InstallerPlatform, InstallerRenderer } from './installer-layout'
8
+
9
+ /** Qualify one platform in the trusted release-assets workflow and stage its receipt. */
10
+ export async function qualifyInstallerCommand(options: {
11
+ env: Record<string, string | undefined>
12
+ config: unknown
13
+ tag: string
14
+ platform: InstallerPlatform
15
+ renderer: InstallerRenderer
16
+ directory: string
17
+ }): Promise<InstallerReceipt> {
18
+ const { env, config, tag, platform, renderer } = options
19
+ if (
20
+ !['macos-arm64', 'windows-x64', 'linux-x64'].includes(platform) ||
21
+ !['native', 'cef'].includes(renderer) ||
22
+ typeof config !== 'object' ||
23
+ config === null ||
24
+ Array.isArray(config) ||
25
+ typeof (config as { appName?: unknown }).appName !== 'string' ||
26
+ typeof (config as { appId?: unknown }).appId !== 'string'
27
+ )
28
+ throw new Error('Invalid installer qualification context')
29
+ if (env.RELEASE_TAG !== tag) throw new Error('Installer release tag mismatch')
30
+ const plan = await planReleaseAssets({ env, config, tag })
31
+ if (env.SOURCE_SHA !== plan.sourceSha) throw new Error('Installer source identity mismatch')
32
+ const parsed = parseReleaseConfig(config),
33
+ requirements = parsed.requirements(tag),
34
+ policy = requirements.offlinePolicy,
35
+ names = requirements.platforms[platform]
36
+ if (!policy || !names || names.length !== 2)
37
+ throw new Error('Installer qualification requires an explicit offline policy and payloads')
38
+ const directory = resolve(options.directory),
39
+ destination = join(directory, `installer-test-${platform}.json`)
40
+ try {
41
+ await lstat(destination)
42
+ throw new Error('Installer receipt already exists')
43
+ } catch (error) {
44
+ if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error
45
+ }
46
+ const app = config as { appName: string; appId: string }
47
+ const result = await observeInstalledApp({
48
+ env,
49
+ platform,
50
+ renderer,
51
+ appName: app.appName,
52
+ appId: app.appId,
53
+ version: plan.version,
54
+ installer: join(directory, names[0]!),
55
+ archive: join(directory, names[1]!),
56
+ expectedReads: parsed.expectedReads,
57
+ offlinePolicy: policy,
58
+ sidecars: parsed.sidecars,
59
+ })
60
+ if (!result.evidence) throw new Error('Missing measured offline evidence')
61
+ const identity = {
62
+ tag,
63
+ sourceSha: plan.sourceSha,
64
+ workflowSha: plan.workflowSha,
65
+ runId: env.GITHUB_RUN_ID!,
66
+ runAttempt: Number(env.GITHUB_RUN_ATTEMPT),
67
+ }
68
+ const receipt: InstallerReceipt = {
69
+ schema: 2,
70
+ ...identity,
71
+ platform,
72
+ installed: true,
73
+ launched: true,
74
+ rendererReady: true,
75
+ rendererEvidence: result.evidence,
76
+ assets: result.artifacts,
77
+ }
78
+ validateInstallerReceipt(identity, receipt, platform, names, result.artifacts, policy)
79
+ await writeFile(destination, JSON.stringify(receipt, null, 2) + '\n', { flag: 'wx', mode: 0o600 })
80
+ return receipt
81
+ }
@@ -0,0 +1,268 @@
1
+ import { parseOfflinePolicy, type OfflinePolicy } from '../release/release-qualification'
2
+ import { assertHostedRunner } from './hosted-runner'
3
+
4
+ function safeScriptString(value: string): string {
5
+ return JSON.stringify(value)
6
+ .replaceAll('<', '\\u003c')
7
+ .replaceAll('\u2028', '\\u2028')
8
+ .replaceAll('\u2029', '\\u2029')
9
+ }
10
+ /** Renderer observations only. Installer identity, startup guard and offline behavior
11
+ * must be independently verified before an installer receipt can be issued. */
12
+ export type InstallerRendererObservation = {
13
+ samples: number
14
+ elapsedMs: number
15
+ visible: boolean
16
+ readyState: string
17
+ width: number
18
+ height: number
19
+ interactiveElements: number
20
+ textLength: number
21
+ markerObserved?: boolean
22
+ foreignBlocked?: boolean
23
+ }
24
+ export function assertInstallerRendererObservation(
25
+ value: unknown,
26
+ offline = false
27
+ ): asserts value is InstallerRendererObservation {
28
+ if (typeof value !== 'object' || value === null || Array.isArray(value))
29
+ throw new Error('Invalid renderer observation')
30
+ const item = value as Record<string, unknown>
31
+ const keys = [
32
+ 'samples',
33
+ 'elapsedMs',
34
+ 'visible',
35
+ 'readyState',
36
+ 'width',
37
+ 'height',
38
+ 'interactiveElements',
39
+ 'textLength',
40
+ ...(offline ? ['markerObserved', 'foreignBlocked'] : []),
41
+ ]
42
+ if (
43
+ (offline && (item.markerObserved !== true || item.foreignBlocked !== true)) ||
44
+ Object.keys(item).length !== keys.length ||
45
+ keys.some((key) => !Object.hasOwn(item, key)) ||
46
+ item.samples !== 2 ||
47
+ typeof item.elapsedMs !== 'number' ||
48
+ !Number.isFinite(item.elapsedMs) ||
49
+ item.elapsedMs < 3000 ||
50
+ item.elapsedMs > 120000 ||
51
+ item.visible !== true ||
52
+ !['interactive', 'complete'].includes(String(item.readyState)) ||
53
+ typeof item.width !== 'number' ||
54
+ !Number.isFinite(item.width) ||
55
+ item.width < 100 ||
56
+ typeof item.height !== 'number' ||
57
+ !Number.isFinite(item.height) ||
58
+ item.height < 100 ||
59
+ !Number.isSafeInteger(item.interactiveElements) ||
60
+ Number(item.interactiveElements) < 1 ||
61
+ !Number.isSafeInteger(item.textLength) ||
62
+ Number(item.textLength) < 1
63
+ )
64
+ throw new Error('Incomplete renderer observation')
65
+ }
66
+ async function boundedBody(message: Request | Response, maximum: number): Promise<string> {
67
+ const declared = message.headers.get('content-length')
68
+ if (declared !== null && (!/^\d+$/.test(declared) || Number(declared) > maximum))
69
+ throw new Error('Renderer body exceeds bound')
70
+ if (!message.body) throw new Error('Missing renderer body')
71
+ const reader = message.body.getReader(),
72
+ chunks: Uint8Array[] = []
73
+ let size = 0
74
+ try {
75
+ while (true) {
76
+ const next = await reader.read()
77
+ if (next.done) break
78
+ size += next.value.length
79
+ if (size > maximum) {
80
+ await reader.cancel()
81
+ throw new Error('Renderer body exceeds bound')
82
+ }
83
+ chunks.push(next.value)
84
+ }
85
+ } finally {
86
+ reader.releaseLock()
87
+ }
88
+ const bytes = new Uint8Array(size)
89
+ let offset = 0
90
+ for (const chunk of chunks) {
91
+ bytes.set(chunk, offset)
92
+ offset += chunk.length
93
+ }
94
+ return new TextDecoder('utf-8', { fatal: true }).decode(bytes)
95
+ }
96
+ function probeScript(nonce: string, policy?: OfflinePolicy, foreignOrigin?: string): string {
97
+ const offline = policy
98
+ ? `data.markerObserved=(d.body?.innerText||'').includes(${safeScriptString(policy.marker)});try{await fetch(${safeScriptString(foreignOrigin!)}+'/',{mode:'no-cors',cache:'no-store'});data.foreignBlocked=false}catch{data.foreignBlocked=true}`
99
+ : ''
100
+ return `<script>(()=>{const started=performance.now();requestAnimationFrame(()=>{setTimeout(()=>requestAnimationFrame(async()=>{const d=document;const data={samples:2,elapsedMs:performance.now()-started,visible:d.visibilityState==='visible',readyState:d.readyState,width:innerWidth,height:innerHeight,interactiveElements:d.querySelectorAll('button,input,textarea,select,a[href],[role="button"]').length,textLength:(d.body?.innerText||'').trim().length};${offline};fetch('/__framework_installer_probe/${nonce}',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify(data),redirect:'error'}).catch(()=>{});}),3100);});})();</script>`
101
+ }
102
+
103
+ /** Wrap the installed host's handler on the nonce-bound loopback origin. */
104
+ export function createInstallerRendererHandler(options: {
105
+ env: Record<string, string | undefined>
106
+ origin: string
107
+ nonce: string
108
+ offlinePolicy?: OfflinePolicy
109
+ foreignOrigin?: string
110
+ handle(request: Request): Response | Promise<Response>
111
+ save(
112
+ value: InstallerRendererObservation,
113
+ state: { bootstrapDenied: boolean }
114
+ ): void | Promise<void>
115
+ }): (request: Request) => Promise<Response> {
116
+ assertHostedRunner(options.env, 'Renderer probe')
117
+ const origin = new URL(options.origin)
118
+ if (
119
+ origin.protocol !== 'http:' ||
120
+ origin.hostname !== '127.0.0.1' ||
121
+ !origin.port ||
122
+ origin.origin !== options.origin ||
123
+ !/^[a-f0-9]{48}$/.test(options.nonce)
124
+ )
125
+ throw new Error('Invalid renderer probe context')
126
+ const policy =
127
+ options.offlinePolicy === undefined ? undefined : parseOfflinePolicy(options.offlinePolicy)
128
+ if (policy) {
129
+ if (!options.foreignOrigin) throw new Error('Missing foreign network sentinel')
130
+ const foreign = new URL(options.foreignOrigin)
131
+ if (
132
+ foreign.protocol !== 'http:' ||
133
+ foreign.hostname !== '127.0.0.1' ||
134
+ !foreign.port ||
135
+ foreign.origin !== options.foreignOrigin ||
136
+ foreign.origin === origin.origin
137
+ )
138
+ throw new Error('Invalid foreign network sentinel')
139
+ } else if (options.foreignOrigin !== undefined)
140
+ throw new Error('Unexpected foreign network sentinel')
141
+ const path = `/__framework_installer_probe/${options.nonce}`
142
+ let documentServed = false,
143
+ received = false,
144
+ bootstrapDenied = false
145
+ return async (request) => {
146
+ const url = new URL(request.url)
147
+ if (url.origin !== options.origin || request.headers.get('host') !== origin.host)
148
+ return new Response(null, { status: 403 })
149
+ if (policy?.kind === 'local-bootstrap' && url.pathname === policy.path) {
150
+ if (
151
+ request.headers.get('origin') === options.origin &&
152
+ [null, 'same-origin'].includes(request.headers.get('sec-fetch-site'))
153
+ )
154
+ bootstrapDenied = true
155
+ return new Response(null, { status: 503 })
156
+ }
157
+ if (url.pathname.startsWith('/__framework_installer_probe/')) {
158
+ if (
159
+ url.pathname !== path ||
160
+ url.search ||
161
+ request.method !== 'POST' ||
162
+ request.headers.get('origin') !== options.origin ||
163
+ ![null, 'same-origin'].includes(request.headers.get('sec-fetch-site')) ||
164
+ request.headers.get('content-type') !== 'application/json' ||
165
+ !documentServed ||
166
+ received
167
+ )
168
+ return new Response(null, { status: 403 })
169
+ received = true
170
+ try {
171
+ const value: unknown = JSON.parse(await boundedBody(request, 4096))
172
+ assertInstallerRendererObservation(value, Boolean(policy))
173
+ await options.save(value, { bootstrapDenied })
174
+ return new Response(null, { status: 204 })
175
+ } catch {
176
+ return new Response(null, { status: 400 })
177
+ }
178
+ }
179
+ const response = await options.handle(request)
180
+ if (
181
+ request.method !== 'GET' ||
182
+ url.pathname !== '/' ||
183
+ url.search ||
184
+ response.status !== 200 ||
185
+ !/^text\/html\b/i.test(response.headers.get('content-type') ?? '')
186
+ )
187
+ return response
188
+ if (response.headers.has('content-encoding'))
189
+ throw new Error('Encoded renderer documents are unsupported')
190
+ const html = await boundedBody(response, 2 * 1024 * 1024)
191
+ if (!html.includes('</body>')) throw new Error('Invalid renderer document')
192
+ documentServed = true
193
+ const headers = new Headers(response.headers)
194
+ headers.delete('content-length')
195
+ headers.delete('content-encoding')
196
+ headers.delete('etag')
197
+ // Add a separate restrictive policy; never replace the app's own CSP.
198
+ headers.append(
199
+ 'content-security-policy',
200
+ "default-src 'self' data:; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; connect-src 'self'; img-src 'self' data: blob:; media-src 'self' data: blob:; font-src 'self' data:; frame-src 'none'; object-src 'none'; base-uri 'none'"
201
+ )
202
+ return new Response(
203
+ html.replace(
204
+ '</body>',
205
+ probeScript(options.nonce, policy, options.foreignOrigin) + '</body>'
206
+ ),
207
+ { status: response.status, statusText: response.statusText, headers }
208
+ )
209
+ }
210
+ }
211
+
212
+ /** Intercept the one expected Bun.serve listener before importing the app worker. */
213
+ export function installInstallerRendererProbe(options: {
214
+ env: Record<string, string | undefined>
215
+ origin: string
216
+ nonce: string
217
+ allowEphemeral?: boolean
218
+ offlinePolicy?: OfflinePolicy
219
+ foreignOrigin?: string
220
+ runtime: { serve: (...args: any[]) => any }
221
+ save(
222
+ value: InstallerRendererObservation,
223
+ state: { bootstrapDenied: boolean }
224
+ ): void | Promise<void>
225
+ }): void {
226
+ const { runtime } = options
227
+ const original = runtime.serve
228
+ if (typeof original !== 'function') throw new Error('Missing Bun server implementation')
229
+ let used = false
230
+ const port = Number(new URL(options.origin).port)
231
+ const replace = function (config: {
232
+ hostname?: unknown
233
+ port?: unknown
234
+ fetch?: unknown
235
+ [key: string]: unknown
236
+ }) {
237
+ if (
238
+ !config ||
239
+ config.hostname !== '127.0.0.1' ||
240
+ (Number(config.port) !== port && !(options.allowEphemeral === true && config.port === 0))
241
+ )
242
+ return original.call(runtime, config)
243
+ if (used || typeof config.fetch !== 'function')
244
+ throw new Error('Unexpected renderer probe listener')
245
+ used = true
246
+ const fetch = config.fetch as (
247
+ request: Request,
248
+ server: unknown
249
+ ) => Response | Promise<Response>
250
+ let activeServer: unknown
251
+ const handler = createInstallerRendererHandler({
252
+ ...options,
253
+ handle: (request) => fetch(request, activeServer),
254
+ })
255
+ return original.call(runtime, {
256
+ ...config,
257
+ port,
258
+ fetch(request: Request, server: unknown) {
259
+ activeServer = server
260
+ return handler(request)
261
+ },
262
+ })
263
+ }
264
+ // Validate the full context before changing Bun.serve, even if no listener is opened.
265
+ createInstallerRendererHandler({ ...options, handle: () => new Response() })
266
+ if (!Reflect.set(runtime, 'serve', replace) || runtime.serve !== replace)
267
+ throw new Error('Cannot install renderer probe')
268
+ }