@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,671 @@
1
+ import { randomBytes } from 'node:crypto'
2
+ import { chmod, lstat, mkdir, readFile, realpath, writeFile } from 'node:fs/promises'
3
+ import { createServer } from 'node:net'
4
+ import { delimiter, dirname, join } from 'node:path'
5
+ import { preflightInstallerRuntime, prepareInstallerCiBootstrap } from './installer-ci-bootstrap'
6
+ import { prepareInstallerExecution } from './installer-extraction'
7
+ import { verifyInstallerPayload } from './installer-identity'
8
+ import {
9
+ assertInstallerContext,
10
+ assertPortableAppName,
11
+ type InstallerPlatform,
12
+ type InstallerRenderer,
13
+ } from './installer-layout'
14
+ import {
15
+ assertInstallerRendererObservation,
16
+ type InstallerRendererObservation,
17
+ } from './installer-renderer-evidence'
18
+ import { extractCandidateRuntime, verifyInstalledPayload } from './installed-payload'
19
+ import {
20
+ parseOfflinePolicy,
21
+ type Artifact,
22
+ type OfflinePolicy,
23
+ type RendererEvidence,
24
+ } from '../release/release-qualification'
25
+ import { terminateGuardedWorker } from './installer-process-cleanup'
26
+ import type { ReleaseTrust, VerifiedRelease } from '../updates/signed-release'
27
+ import { stageUpdateSwap } from '../updates/update-swap-stage'
28
+ import { swapUpdateTree } from '../updates/update-swap'
29
+
30
+ function isolatedEnv(
31
+ parent: Record<string, string | undefined>,
32
+ profile: string,
33
+ platform: InstallerPlatform
34
+ ): Record<string, string> {
35
+ const env: Record<string, string> = {}
36
+ for (const name of [
37
+ 'PATH',
38
+ 'SystemRoot',
39
+ 'WINDIR',
40
+ 'COMSPEC',
41
+ 'PATHEXT',
42
+ 'LANG',
43
+ 'LC_ALL',
44
+ 'DISPLAY',
45
+ 'XAUTHORITY',
46
+ 'DBUS_SESSION_BUS_ADDRESS',
47
+ ])
48
+ if (parent[name]) env[name] = parent[name]!
49
+ Object.assign(env, {
50
+ CI: 'true',
51
+ GITHUB_ACTIONS: 'true',
52
+ RUNNER_ENVIRONMENT: 'github-hosted',
53
+ HOME: profile,
54
+ USERPROFILE: profile,
55
+ LOCALAPPDATA: join(profile, 'LocalAppData'),
56
+ XDG_DATA_HOME: join(profile, '.local', 'share'),
57
+ TMP: join(profile, 'tmp'),
58
+ TEMP: join(profile, 'tmp'),
59
+ TMPDIR: join(profile, 'tmp'),
60
+ ELECTROBUN_INSTALLER_UI_AUTOCLOSE: '1',
61
+ })
62
+ if (platform === 'windows-x64') env.TAR_OPTIONS = '--force-local'
63
+ return env
64
+ }
65
+ async function choosePort(): Promise<number> {
66
+ const server = createServer()
67
+ await new Promise<void>((resolve, reject) => {
68
+ server.once('error', reject)
69
+ server.listen(0, '127.0.0.1', resolve)
70
+ })
71
+ const address = server.address()
72
+ if (!address || typeof address === 'string' || address.port < 1024) {
73
+ server.close()
74
+ throw new Error('Cannot reserve test port')
75
+ }
76
+ await new Promise<void>((resolve, reject) =>
77
+ server.close((error) => (error ? reject(error) : resolve()))
78
+ )
79
+ return address.port
80
+ }
81
+ async function boundedJson(path: string): Promise<unknown> {
82
+ const info = await lstat(path)
83
+ if (!info.isFile() || info.isSymbolicLink() || info.size < 1 || info.size > 16384)
84
+ throw new Error('Invalid renderer observation')
85
+ const bytes = await readFile(path)
86
+ if (bytes.length !== info.size) throw new Error('Renderer observation changed')
87
+ return JSON.parse(bytes.toString('utf8'))
88
+ }
89
+ async function exists(path: string): Promise<boolean> {
90
+ try {
91
+ await lstat(path)
92
+ return true
93
+ } catch (error) {
94
+ if ((error as NodeJS.ErrnoException).code === 'ENOENT') return false
95
+ throw error
96
+ }
97
+ }
98
+ /** Whether the runner should start the installed app on this loop iteration.
99
+ *
100
+ * Electrobun's Windows and Linux extractors (since 2.0.1, `launchInstalledApp` in
101
+ * package/src/extractor/main.zig, still in 2.0.5) start the installed launcher themselves after
102
+ * a first install, inheriting the runner's isolated environment and guard context. Starting a
103
+ * second launcher there runs two instances against one profile: one Chromium/CEF profile
104
+ * (`root_cache_path`) admits a single process, while the worker guard admits whichever worker
105
+ * writes its identity first. When those two races pick different processes, the guarded worker
106
+ * never gets a renderer and its process exits after the permit. So the runner never starts the
107
+ * app on Windows or Linux. The macOS installer instead asks `open -n`, which the launch shim
108
+ * records without opening anything, so the runner starts the recorded bundle exactly once. */
109
+ /**
110
+ * The installer's last `error: Name` line, for diagnosing a failed install.
111
+ * Only a bounded identifier is returned: never paths, output or credentials.
112
+ */
113
+ export function installerErrorName(stderr: string): string | undefined {
114
+ let name: string | undefined
115
+ for (const match of stderr.matchAll(/^error: ([A-Za-z][A-Za-z0-9_]{0,63})\s*$/gm)) name = match[1]
116
+ return name
117
+ }
118
+
119
+ async function boundedStderr(stream: ReadableStream<Uint8Array>, limit = 64 * 1024) {
120
+ const decoder = new TextDecoder()
121
+ let text = ''
122
+ for await (const chunk of stream) {
123
+ if (text.length < limit) text += decoder.decode(chunk, { stream: true })
124
+ }
125
+ return text.slice(-limit)
126
+ }
127
+
128
+ export function shouldLaunchInstalledApp(state: {
129
+ platform: InstallerPlatform
130
+ ready: boolean
131
+ launched: boolean
132
+ acknowledged: boolean
133
+ installerExit: number | null
134
+ }): boolean {
135
+ return (
136
+ state.platform === 'macos-arm64' &&
137
+ state.ready &&
138
+ !state.launched &&
139
+ !state.acknowledged &&
140
+ state.installerExit === 0
141
+ )
142
+ }
143
+
144
+ const shim = `#!/bin/sh\numask 077\nif [ "\${CI:-}" != true ] || [ "\${GITHUB_ACTIONS:-}" != true ] || [ "\${RUNNER_ENVIRONMENT:-}" != github-hosted ] || [ "$#" -ne 2 ] || [ "$1" != "-n" ] || [ "$2" != "\${FRAMEWORK_CI_EXPECTED_APP:-}" ] || [ -z "\${FRAMEWORK_CI_LAUNCH_RECORD:-}" ] || [ -e "$FRAMEWORK_CI_LAUNCH_RECORD" ]; then exit 1; fi\n(set -C; printf '%s\\n' "$2" > "$FRAMEWORK_CI_LAUNCH_RECORD")\n`
145
+
146
+ /** Execute an installer only on a matching disposable hosted runner and return raw observations.
147
+ * This does not produce a release receipt or establish app-specific offline acceptance. */
148
+ export async function observeInstalledApp(options: {
149
+ platform: InstallerPlatform
150
+ renderer: InstallerRenderer
151
+ appName: string
152
+ appId: string
153
+ version: string
154
+ installer: string
155
+ archive: string
156
+ expectedReads?: readonly string[]
157
+ onStage?: (stage: string) => void
158
+ offlinePolicy?: OfflinePolicy
159
+ /** Sidecar executables the app bundles; installed copies must match the archive. */
160
+ sidecars?: readonly string[]
161
+ env?: Record<string, string | undefined>
162
+ /** After observing the installed version, apply this signed update and observe the new version. */
163
+ update?: {
164
+ descriptor: VerifiedRelease
165
+ trust: ReleaseTrust
166
+ archive: string
167
+ maxCompressedBytes: number
168
+ maxExpandedBytes: number
169
+ }
170
+ }): Promise<{
171
+ directory: string
172
+ observation: InstallerRendererObservation
173
+ blockedReads: number
174
+ artifacts: Artifact[]
175
+ evidence?: RendererEvidence
176
+ updated?: {
177
+ version: string
178
+ observation: InstallerRendererObservation
179
+ blockedReads: number
180
+ evidence?: RendererEvidence
181
+ }
182
+ }> {
183
+ const parent = options.env ?? process.env
184
+ const stage = (name: string) => {
185
+ try {
186
+ options.onStage?.(name)
187
+ } catch {
188
+ /* Diagnostics cannot change qualification. */
189
+ }
190
+ }
191
+ assertInstallerContext(parent, options.platform, process.platform, process.arch)
192
+ assertPortableAppName(options.appName)
193
+ if (
194
+ !/^[a-z][a-z0-9-]*(?:\.[a-z][a-z0-9-]*)+$/.test(options.appId) ||
195
+ options.appId.length > 255 ||
196
+ !/^\d+\.\d+\.\d+(?:-dev\.\d+)?$/.test(options.version) ||
197
+ options.version.length > 64 ||
198
+ (options.platform === 'linux-x64' && !parent.DISPLAY)
199
+ )
200
+ throw new Error('Invalid installer observation context')
201
+ const policy =
202
+ options.offlinePolicy === undefined ? undefined : parseOfflinePolicy(options.offlinePolicy)
203
+ const expectedReads = options.expectedReads ?? []
204
+ if (
205
+ !Array.isArray(expectedReads) ||
206
+ expectedReads.length > 32 ||
207
+ new Set(expectedReads).size !== expectedReads.length ||
208
+ JSON.stringify(expectedReads).length > 8192
209
+ )
210
+ throw new Error('Invalid expected reads')
211
+ for (const value of expectedReads) {
212
+ if (typeof value !== 'string' || value.length > 2048) throw new Error('Invalid expected read')
213
+ const url = new URL(value)
214
+ if (url.protocol !== 'https:' || url.username || url.password || url.hash || url.href !== value)
215
+ throw new Error('Invalid expected read')
216
+ }
217
+ const before = await verifyInstallerPayload({
218
+ platform: options.platform,
219
+ appName: options.appName,
220
+ installer: options.installer,
221
+ archive: options.archive,
222
+ env: parent,
223
+ })
224
+ stage('artifacts-verified')
225
+ const prepared = await prepareInstallerExecution({
226
+ platform: options.platform,
227
+ appName: options.appName,
228
+ installer: options.installer,
229
+ archive: options.archive,
230
+ env: parent,
231
+ })
232
+ stage('installer-prepared')
233
+ const bootstrap = await prepareInstallerCiBootstrap(parent)
234
+ const candidate = await extractCandidateRuntime({
235
+ platform: options.platform,
236
+ renderer: options.renderer,
237
+ appName: options.appName,
238
+ archive: options.archive,
239
+ profile: prepared.profile,
240
+ env: parent,
241
+ })
242
+ stage('runtime-extracted')
243
+ await preflightInstallerRuntime({ env: parent, runtime: candidate.path, bootstrap })
244
+ stage('runtime-preflight-passed')
245
+ for (const path of [
246
+ join(prepared.profile, 'LocalAppData'),
247
+ join(prepared.profile, '.local', 'share'),
248
+ join(prepared.profile, 'tmp'),
249
+ ])
250
+ await mkdir(path, { recursive: true, mode: 0o700 })
251
+ const mac = options.platform === 'macos-arm64',
252
+ windows = options.platform === 'windows-x64'
253
+ const installedRoot = mac
254
+ ? join(prepared.incoming, `${options.appName}.app`, 'Contents')
255
+ : join(
256
+ prepared.profile,
257
+ windows ? 'LocalAppData' : '.local/share',
258
+ options.appId,
259
+ 'stable',
260
+ 'app'
261
+ )
262
+ const resources = join(installedRoot, 'Resources'),
263
+ binary = join(installedRoot, mac ? 'MacOS' : 'bin'),
264
+ launcher = join(binary, windows ? 'launcher.exe' : 'launcher'),
265
+ runtime = join(binary, windows ? 'bun.exe' : 'bun')
266
+ const worker = join(resources, 'app', 'bun', 'index.js')
267
+ const sidecars = options.sidecars ?? []
268
+ let foreignHits = 0
269
+ const sentinel = policy
270
+ ? Bun.serve({
271
+ hostname: '127.0.0.1',
272
+ port: 0,
273
+ fetch: () => {
274
+ foreignHits++
275
+ return new Response('sentinel')
276
+ },
277
+ })
278
+ : undefined
279
+ const foreignOrigin = sentinel ? `http://127.0.0.1:${sentinel.port}` : undefined
280
+ const baseEnv = isolatedEnv(parent, prepared.profile, options.platform)
281
+ Object.assign(baseEnv, {
282
+ BUN_OPTIONS: bootstrap.bunOptions,
283
+ FRAMEWORK_CI_WORKER_ENTRY: worker,
284
+ FRAMEWORK_CI_EXPECTED_READS: JSON.stringify(expectedReads),
285
+ FRAMEWORK_CI_ALLOW_EPHEMERAL: '1',
286
+ ...(policy
287
+ ? {
288
+ FRAMEWORK_CI_OFFLINE_POLICY: JSON.stringify(policy),
289
+ FRAMEWORK_CI_FOREIGN_ORIGIN: foreignOrigin!,
290
+ }
291
+ : {}),
292
+ })
293
+ const installedPayload = (version: string, archive: string) =>
294
+ verifyInstalledPayload({
295
+ platform: options.platform,
296
+ renderer: options.renderer,
297
+ appName: options.appName,
298
+ version,
299
+ archive,
300
+ profile: prepared.directory,
301
+ installedRoot,
302
+ sidecars,
303
+ env: parent,
304
+ })
305
+ const installerUnchanged = async () => {
306
+ const after = await verifyInstallerPayload({
307
+ platform: options.platform,
308
+ appName: options.appName,
309
+ installer: options.installer,
310
+ archive: options.archive,
311
+ env: parent,
312
+ })
313
+ if (JSON.stringify(after) !== JSON.stringify(before))
314
+ throw new Error('Installer artifacts changed')
315
+ }
316
+
317
+ /** One guarded start of the installed app: by its installer, or by its launcher after an update. */
318
+ async function observeRun(run: {
319
+ directory: string
320
+ version: string
321
+ archive: string
322
+ start: 'installer' | 'launcher'
323
+ }): Promise<{
324
+ metrics: InstallerRendererObservation
325
+ blockedReads: number
326
+ evidence?: RendererEvidence
327
+ }> {
328
+ const viaInstaller = run.start === 'installer'
329
+ if (
330
+ sentinel &&
331
+ (!(await fetch(foreignOrigin + '/', { signal: AbortSignal.timeout(1000) })).ok ||
332
+ foreignHits !== 1)
333
+ )
334
+ throw new Error('Foreign network sentinel unavailable')
335
+ foreignHits = 0
336
+ const nonce = randomBytes(24).toString('hex')
337
+ const ack = join(run.directory, 'ack'),
338
+ permit = join(run.directory, 'permit'),
339
+ observation = join(run.directory, 'observation'),
340
+ unexpected = join(run.directory, 'unexpected'),
341
+ pidRecord = join(run.directory, 'worker-pid')
342
+ const env: Record<string, string> = {
343
+ ...baseEnv,
344
+ FRAMEWORK_CI_NONCE: nonce,
345
+ FRAMEWORK_CI_ACK: ack,
346
+ FRAMEWORK_CI_PERMIT: permit,
347
+ FRAMEWORK_CI_ORIGIN: origin,
348
+ FRAMEWORK_CI_OBSERVATION: observation,
349
+ FRAMEWORK_CI_UNEXPECTED: unexpected,
350
+ FRAMEWORK_CI_PID: pidRecord,
351
+ }
352
+ let launchRecord: string | undefined, expectedApp: string | undefined
353
+ if (mac && viaInstaller) {
354
+ const shimDir = join(run.directory, 'launch-shim')
355
+ await mkdir(shimDir, { mode: 0o700 })
356
+ const path = join(shimDir, 'open')
357
+ await writeFile(path, shim, { flag: 'wx', mode: 0o700 })
358
+ await chmod(path, 0o700)
359
+ expectedApp = join(await realpath(prepared.incoming), `${options.appName}.app`)
360
+ launchRecord = join(run.directory, 'launch-record')
361
+ Object.assign(env, {
362
+ PATH: shimDir + delimiter + (env.PATH ?? ''),
363
+ FRAMEWORK_CI_EXPECTED_APP: expectedApp,
364
+ FRAMEWORK_CI_LAUNCH_RECORD: launchRecord,
365
+ })
366
+ }
367
+ function spawnApp() {
368
+ return Bun.spawn({
369
+ cmd: [launcher],
370
+ cwd: prepared.incoming,
371
+ env,
372
+ stdout: 'ignore',
373
+ stderr: 'ignore',
374
+ signal: AbortSignal.timeout(240000),
375
+ })
376
+ }
377
+ const installer = viaInstaller
378
+ ? Bun.spawn({
379
+ cmd: [prepared.executable],
380
+ cwd: prepared.incoming,
381
+ env,
382
+ stdout: 'ignore',
383
+ stderr: 'pipe',
384
+ signal: AbortSignal.timeout(360000),
385
+ })
386
+ : undefined
387
+ const installerStderr = installer ? boundedStderr(installer.stderr).catch(() => '') : undefined
388
+ // After an update no installer runs, so the runner starts the swapped-in app exactly once.
389
+ let app: ReturnType<typeof spawnApp> | undefined = viaInstaller ? undefined : spawnApp(),
390
+ guardedPid: number | undefined
391
+ stage(viaInstaller ? 'installer-started' : 'updated-app-started')
392
+ try {
393
+ let deadline = Date.now() + 150000
394
+ let granted = false
395
+ while (Date.now() < deadline) {
396
+ if (installer && installer.exitCode !== null && installer.exitCode !== 0) {
397
+ const error = installerErrorName(
398
+ await Promise.race([installerStderr!, Bun.sleep(2000).then(() => '')])
399
+ )
400
+ throw new Error(
401
+ `Installer exited unsuccessfully (exit=${installer.exitCode}, signal=${installer.signalCode ?? 'none'}, ` +
402
+ `ready=${(await exists(worker)) && (await exists(launcher))}, acknowledged=${await exists(ack)}, ` +
403
+ `error=${error ?? 'none'})`
404
+ )
405
+ }
406
+ const ready =
407
+ (await exists(worker)) &&
408
+ (await exists(launcher)) &&
409
+ (await exists(join(resources, 'version.json')))
410
+ if (
411
+ installer &&
412
+ shouldLaunchInstalledApp({
413
+ platform: options.platform,
414
+ ready,
415
+ launched: app !== undefined,
416
+ acknowledged: await exists(ack),
417
+ installerExit: installer.exitCode,
418
+ })
419
+ ) {
420
+ if (
421
+ !launchRecord ||
422
+ !expectedApp ||
423
+ !(await exists(launchRecord)) ||
424
+ (await readFile(launchRecord, 'utf8')) !== expectedApp + '\n'
425
+ )
426
+ throw new Error('Installer launch request mismatch')
427
+ app = spawnApp()
428
+ }
429
+ if ((await exists(ack)) && !granted) {
430
+ stage('worker-acknowledged')
431
+ if ((await readFile(ack, 'utf8')) !== nonce + '\n')
432
+ throw new Error('Worker guard acknowledgement mismatch')
433
+ const record = await readFile(pidRecord, 'utf8'),
434
+ match = /^([a-f0-9]{48})\n([1-9]\d{0,9})\n$/.exec(record)
435
+ if (
436
+ !match ||
437
+ match[1] !== nonce ||
438
+ Number(match[2]) < 2 ||
439
+ Number(match[2]) === process.pid
440
+ )
441
+ throw new Error('Worker process identity mismatch')
442
+ guardedPid = Number(match[2])
443
+ await installedPayload(run.version, run.archive)
444
+ if (viaInstaller) await installerUnchanged()
445
+ stage('installed-files-verified')
446
+ await writeFile(permit, nonce + '\n', { flag: 'wx', mode: 0o600 })
447
+ granted = true
448
+ // Verifying a large CEF payload can consume the installation budget.
449
+ // Give the verified worker its own bounded renderer observation window.
450
+ deadline = Date.now() + 90000
451
+ stage('worker-permitted')
452
+ }
453
+ if (granted && (await exists(observation))) break
454
+ await Bun.sleep(250)
455
+ }
456
+ const observed = await exists(observation)
457
+ const unexpectedObserved = await exists(unexpected)
458
+ if (!granted || !observed || unexpectedObserved) {
459
+ let workerState = 'unknown'
460
+ if (guardedPid !== undefined) {
461
+ try {
462
+ process.kill(guardedPid, 0)
463
+ workerState = 'present'
464
+ } catch (error) {
465
+ workerState = (error as NodeJS.ErrnoException).code === 'ESRCH' ? 'exited' : 'unknown'
466
+ }
467
+ }
468
+ const appState = app
469
+ ? (app.exitCode ?? 'running')
470
+ : mac
471
+ ? 'not-spawned'
472
+ : 'installer-launched'
473
+ // Only bounded process states and booleans: no paths, output, or credentials.
474
+ throw new Error(
475
+ 'Installed renderer observation missing or unexpected activity observed' +
476
+ ` (start=${run.start}, permitted=${granted}, observed=${observed},` +
477
+ ` unexpected=${unexpectedObserved}, workerPid=${workerState},` +
478
+ ` installerExit=${installer ? (installer.exitCode ?? 'running') : 'none'},` +
479
+ ` appExit=${appState})`
480
+ )
481
+ }
482
+ stage('renderer-observed')
483
+ if (installer) {
484
+ const installerDeadline = Date.now() + 30000
485
+ while (installer.exitCode === null && Date.now() < installerDeadline) await Bun.sleep(250)
486
+ if (installer.exitCode !== 0) {
487
+ const error =
488
+ installer.exitCode === null
489
+ ? undefined
490
+ : installerErrorName(
491
+ await Promise.race([installerStderr!, Bun.sleep(2000).then(() => '')])
492
+ )
493
+ throw new Error(
494
+ `Installer did not complete successfully (exit=${installer.exitCode ?? 'running'}, error=${error ?? 'none'})`
495
+ )
496
+ }
497
+ stage('installer-completed')
498
+ }
499
+ const proof = await boundedJson(observation)
500
+ if (typeof proof !== 'object' || proof === null || Array.isArray(proof))
501
+ throw new Error('Invalid renderer observation')
502
+ const {
503
+ nonce: proofNonce,
504
+ origin: proofOrigin,
505
+ blockedReads,
506
+ unexpectedActivity,
507
+ offlinePolicy: proofPolicy,
508
+ bootstrapDenied,
509
+ ...metrics
510
+ } = proof as Record<string, unknown>
511
+ assertInstallerRendererObservation(metrics, Boolean(policy))
512
+ if (
513
+ proofNonce !== nonce ||
514
+ proofOrigin !== origin ||
515
+ !Number.isSafeInteger(blockedReads) ||
516
+ Number(blockedReads) < 0 ||
517
+ unexpectedActivity !== false
518
+ )
519
+ throw new Error('Renderer observation identity mismatch')
520
+ if (
521
+ policy &&
522
+ (JSON.stringify(parseOfflinePolicy(proofPolicy)) !== JSON.stringify(policy) ||
523
+ bootstrapDenied !== (policy.kind === 'local-bootstrap') ||
524
+ foreignHits !== 0)
525
+ )
526
+ throw new Error('Offline observation does not match policy')
527
+ await Bun.sleep(3000)
528
+ if (
529
+ (await exists(unexpected)) ||
530
+ foreignHits !== 0 ||
531
+ !(await fetch(origin + '/', { signal: AbortSignal.timeout(1000), redirect: 'error' })).ok
532
+ )
533
+ throw new Error('Installed app did not remain available')
534
+ await installedPayload(run.version, run.archive)
535
+ if (viaInstaller) await installerUnchanged()
536
+ if ((await exists(unexpected)) || foreignHits !== 0)
537
+ throw new Error('Unexpected activity after renderer observation')
538
+ if (guardedPid === undefined) throw new Error('Missing guarded process identity')
539
+ await terminateGuardedWorker({ pid: guardedPid, runtime, platform: options.platform, env })
540
+ guardedPid = undefined
541
+ stage('worker-cleaned')
542
+ const evidence: RendererEvidence | undefined = policy
543
+ ? {
544
+ method: 'native-dom-raf-v2',
545
+ origin,
546
+ samples: metrics.samples,
547
+ guardInstalled: true,
548
+ bootstrapDenied: Boolean(bootstrapDenied),
549
+ offlineObserved: true,
550
+ unexpectedActivity: false,
551
+ elapsedMs: metrics.elapsedMs,
552
+ visible: metrics.visible,
553
+ readyState: metrics.readyState,
554
+ width: metrics.width,
555
+ height: metrics.height,
556
+ interactiveElements: metrics.interactiveElements,
557
+ textLength: metrics.textLength,
558
+ markerObserved: metrics.markerObserved,
559
+ browserNetworkRestricted: metrics.foreignBlocked === true && foreignHits === 0,
560
+ offlinePolicy: policy,
561
+ }
562
+ : undefined
563
+ return {
564
+ metrics,
565
+ blockedReads: Number(blockedReads),
566
+ ...(evidence ? { evidence } : {}),
567
+ }
568
+ } finally {
569
+ for (const child of [installer, app])
570
+ if (child && child.exitCode === null) {
571
+ try {
572
+ child.kill('SIGKILL')
573
+ } catch {}
574
+ }
575
+ if (guardedPid !== undefined) {
576
+ try {
577
+ await terminateGuardedWorker({
578
+ pid: guardedPid,
579
+ runtime,
580
+ platform: options.platform,
581
+ env,
582
+ })
583
+ } catch {
584
+ /* Runner teardown owns unverified descendants. */
585
+ }
586
+ }
587
+ // Hosted-runner teardown owns any OS-launched descendants.
588
+ }
589
+ }
590
+
591
+ // One origin for both starts: the app keeps its loopback port across an update, as its
592
+ // browser storage is bound to that origin.
593
+ let origin = ''
594
+ try {
595
+ origin = `http://127.0.0.1:${await choosePort()}`
596
+ const installed = await observeRun({
597
+ directory: prepared.directory,
598
+ version: options.version,
599
+ archive: options.archive,
600
+ start: 'installer',
601
+ })
602
+ const result = {
603
+ directory: prepared.directory,
604
+ observation: installed.metrics,
605
+ blockedReads: installed.blockedReads,
606
+ artifacts: [before.installer, before.archive],
607
+ ...(installed.evidence ? { evidence: installed.evidence } : {}),
608
+ }
609
+ if (!options.update) {
610
+ stage('observation-complete')
611
+ return result
612
+ }
613
+ // Apply the signed update the way the app does: stage it beside the install,
614
+ // swap it in once the app has exited, then start the new version.
615
+ const update = options.update
616
+ const target = mac ? dirname(installedRoot) : installedRoot
617
+ const staged = await stageUpdateSwap({
618
+ descriptor: update.descriptor,
619
+ trust: update.trust,
620
+ currentVersion: options.version,
621
+ approved: true,
622
+ approvedVersion: update.descriptor.version,
623
+ target,
624
+ appName: options.appName,
625
+ platform: options.platform,
626
+ renderer: options.renderer,
627
+ archive: update.archive,
628
+ maxCompressedBytes: update.maxCompressedBytes,
629
+ maxExpandedBytes: update.maxExpandedBytes,
630
+ sidecars,
631
+ })
632
+ stage('update-staged')
633
+ await swapAfterExit(target, staged.staging)
634
+ stage('update-swapped')
635
+ await preflightInstallerRuntime({ env: parent, runtime, bootstrap })
636
+ const directory = join(prepared.directory, 'update')
637
+ await mkdir(directory, { mode: 0o700 })
638
+ const updated = await observeRun({
639
+ directory,
640
+ version: staged.version,
641
+ archive: update.archive,
642
+ start: 'launcher',
643
+ })
644
+ stage('observation-complete')
645
+ return {
646
+ ...result,
647
+ updated: {
648
+ version: staged.version,
649
+ observation: updated.metrics,
650
+ blockedReads: updated.blockedReads,
651
+ ...(updated.evidence ? { evidence: updated.evidence } : {}),
652
+ },
653
+ }
654
+ } finally {
655
+ sentinel?.stop(true)
656
+ }
657
+ }
658
+
659
+ /** The terminated app's processes can hold its files briefly, most visibly on Windows. */
660
+ async function swapAfterExit(target: string, staging: string): Promise<void> {
661
+ const deadline = Date.now() + 60000
662
+ for (;;) {
663
+ try {
664
+ await swapUpdateTree({ target, staging })
665
+ return
666
+ } catch (error) {
667
+ if (Date.now() > deadline) throw error
668
+ await Bun.sleep(500)
669
+ }
670
+ }
671
+ }