@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,408 @@
1
+ import { createHash } from 'node:crypto'
2
+ import { assertNativeExecutable } from './native-executable'
3
+ import { lstat, open, realpath, rm } from 'node:fs/promises'
4
+ import { once } from 'node:events'
5
+ import { isAbsolute, join, relative, resolve, sep } from 'node:path'
6
+ import { createZstdDecompress } from 'node:zlib'
7
+ import { Parser, type ReadEntry } from 'tar'
8
+ import {
9
+ assertBuildMetadata,
10
+ assertInstallerContext,
11
+ assertPayloadLayout,
12
+ assertPortableAppName,
13
+ type InstallerPlatform,
14
+ type InstallerRenderer,
15
+ } from './installer-layout'
16
+ import { assertSidecarNames, sidecarBundlePath } from '../native/app-bundle'
17
+
18
+ function within(root: string, path: string): boolean {
19
+ const value = relative(root, path)
20
+ return value !== '' && value !== '..' && !value.startsWith('..' + sep) && !isAbsolute(value)
21
+ }
22
+ function cleanEnv(
23
+ parent: Record<string, string | undefined>,
24
+ forceLocal: boolean
25
+ ): Record<string, string> {
26
+ const env: Record<string, string> = {}
27
+ for (const name of ['PATH', 'SystemRoot', 'WINDIR', 'TMP', 'TEMP', 'TMPDIR', 'LANG', 'LC_ALL'])
28
+ if (parent[name]) env[name] = parent[name]!
29
+ if (forceLocal) env.TAR_OPTIONS = '--force-local'
30
+ return env
31
+ }
32
+ async function command(
33
+ args: string[],
34
+ env: Record<string, string>,
35
+ limit: number,
36
+ collect: boolean
37
+ ): Promise<{ digest: string; size: number; bytes: Buffer }> {
38
+ const child = Bun.spawn({
39
+ cmd: args,
40
+ env,
41
+ stdout: 'pipe',
42
+ stderr: 'pipe',
43
+ signal: AbortSignal.timeout(120000),
44
+ })
45
+ const errors = (async () => {
46
+ for await (const _part of child.stderr) {
47
+ /* Drain without logging untrusted output. */
48
+ }
49
+ })()
50
+ const hash = createHash('sha256'),
51
+ chunks: Buffer[] = []
52
+ let size = 0
53
+ try {
54
+ for await (const part of child.stdout) {
55
+ size += part.length
56
+ if (!Number.isSafeInteger(size) || size > limit)
57
+ throw new Error('Archive output exceeds bound')
58
+ hash.update(part)
59
+ if (collect) chunks.push(Buffer.from(part))
60
+ }
61
+ if ((await child.exited) !== 0 || size < 1) throw new Error('Cannot read archive member')
62
+ await errors
63
+ return { digest: hash.digest('hex'), size, bytes: Buffer.concat(chunks) }
64
+ } catch (error) {
65
+ child.kill()
66
+ await child.exited
67
+ await errors
68
+ throw error
69
+ }
70
+ }
71
+ /** Check and list a staged payload archive with the tar environment that extracts it: GNU
72
+ * tar on Windows needs the forced-local flag `cleanEnv` adds. */
73
+ async function listArchive(archive: string, platform: InstallerPlatform, env: NodeJS.ProcessEnv) {
74
+ const archiveInfo = await lstat(archive)
75
+ if (!archiveInfo.isFile() || archiveInfo.isSymbolicLink() || archiveInfo.size < 1)
76
+ throw new Error('Invalid staged archive')
77
+ const version = await command(['tar', '--version'], cleanEnv(env, false), 65536, true)
78
+ const tarEnv = cleanEnv(
79
+ env,
80
+ platform === 'windows-x64' && version.bytes.toString('utf8').startsWith('tar (GNU tar)')
81
+ )
82
+ const listing = await command(['tar', '--zstd', '-tf', archive], tarEnv, 8 * 1024 * 1024, true)
83
+ return {
84
+ archiveInfo,
85
+ tarEnv,
86
+ entries: listing.bytes.toString('utf8').split(/\r?\n/).filter(Boolean),
87
+ }
88
+ }
89
+
90
+ type ArchiveMember = { digest: string; size: number; bytes: Buffer; count: number }
91
+
92
+ /** Hash the selected members of a staged payload archive in one decompression pass.
93
+ * `limits` maps each archive path to its byte bound; `collect` names the members whose
94
+ * bytes are kept. Every match is counted, so a duplicated member is visible to the caller. */
95
+ async function readMembers(
96
+ archive: string,
97
+ limits: ReadonlyMap<string, number>,
98
+ collect: ReadonlySet<string>
99
+ ): Promise<Map<string, ArchiveMember>> {
100
+ const members = new Map<string, ArchiveMember>()
101
+ let failure: Error | undefined
102
+ const parser = new Parser({
103
+ strict: true,
104
+ maxMetaEntrySize: 1024 * 1024,
105
+ onReadEntry(entry: ReadEntry) {
106
+ const limit = limits.get(entry.path)
107
+ if (limit === undefined) return entry.resume()
108
+ const previous = members.get(entry.path)
109
+ if (previous) {
110
+ previous.count += 1
111
+ return entry.resume()
112
+ }
113
+ if (entry.type !== 'File' || entry.size < 1 || entry.size > limit) {
114
+ failure ??= new Error('Archive member missing or ambiguous')
115
+ return entry.resume()
116
+ }
117
+ const hash = createHash('sha256'),
118
+ chunks: Buffer[] = []
119
+ const member: ArchiveMember = { digest: '', size: 0, bytes: Buffer.alloc(0), count: 1 }
120
+ members.set(entry.path, member)
121
+ entry.on('data', (chunk: Buffer) => {
122
+ member.size += chunk.length
123
+ hash.update(chunk)
124
+ if (collect.has(entry.path)) chunks.push(chunk)
125
+ })
126
+ entry.on('end', () => {
127
+ member.digest = hash.digest('hex')
128
+ member.bytes = Buffer.concat(chunks)
129
+ })
130
+ },
131
+ })
132
+ const ended = once(parser, 'end')
133
+ const file = await open(archive, 'r')
134
+ try {
135
+ const input = file.createReadStream({ autoClose: false }),
136
+ inflate = createZstdDecompress()
137
+ input.on('error', (error) => inflate.destroy(error))
138
+ for await (const chunk of input.pipe(inflate)) {
139
+ if (!parser.write(chunk)) await once(parser, 'drain')
140
+ }
141
+ parser.end()
142
+ await ended
143
+ } finally {
144
+ await file.close()
145
+ }
146
+ if (failure) throw failure
147
+ return members
148
+ }
149
+
150
+ async function installed(
151
+ path: string,
152
+ root: string,
153
+ limit: number
154
+ ): Promise<{ digest: string; size: number }> {
155
+ const info = await lstat(path)
156
+ if (
157
+ !info.isFile() ||
158
+ info.isSymbolicLink() ||
159
+ !Number.isSafeInteger(info.size) ||
160
+ info.size < 1 ||
161
+ info.size > limit ||
162
+ !within(root, await realpath(path))
163
+ )
164
+ throw new Error('Invalid installed file')
165
+ const file = await open(path, 'r')
166
+ try {
167
+ const before = await file.stat()
168
+ if (before.dev !== info.dev || before.ino !== info.ino || before.size !== info.size)
169
+ throw new Error('Installed file changed')
170
+ const hash = createHash('sha256')
171
+ let size = 0
172
+ for await (const chunk of file.createReadStream({ autoClose: false })) {
173
+ size += chunk.length
174
+ if (size > before.size) throw new Error('Installed file changed')
175
+ hash.update(chunk)
176
+ }
177
+ const after = await file.stat()
178
+ if (
179
+ size !== before.size ||
180
+ after.size !== before.size ||
181
+ after.mtimeMs !== before.mtimeMs ||
182
+ after.dev !== before.dev ||
183
+ after.ino !== before.ino
184
+ )
185
+ throw new Error('Installed file changed')
186
+ return { digest: hash.digest('hex'), size }
187
+ } finally {
188
+ await file.close()
189
+ }
190
+ }
191
+
192
+ async function assertRuntimeBinary(path: string, platform: InstallerPlatform): Promise<void> {
193
+ const info = await lstat(path),
194
+ file = await open(path, 'r')
195
+ try {
196
+ await assertNativeExecutable(file, info.size, platform, 'runtime executable')
197
+ } finally {
198
+ await file.close()
199
+ }
200
+ }
201
+
202
+ /** Compare critical installed files to the staged archive before allowing app startup. */
203
+ export async function verifyInstalledPayload(options: {
204
+ platform: InstallerPlatform
205
+ renderer: InstallerRenderer
206
+ appName: string
207
+ version: string
208
+ archive: string
209
+ profile: string
210
+ installedRoot: string
211
+ /** Sidecar executables the app bundles; each is compared like the runtime. */
212
+ sidecars?: readonly string[]
213
+ env?: Record<string, string | undefined>
214
+ }): Promise<{ files: string[] }> {
215
+ const env = options.env ?? process.env
216
+ assertInstallerContext(env, options.platform, process.platform, process.arch)
217
+ assertPortableAppName(options.appName)
218
+ const sidecars = assertSidecarNames(options.sidecars ?? []).map((name) =>
219
+ sidecarBundlePath(name, options.platform)
220
+ )
221
+ if (!/^\d+\.\d+\.\d+(?:-dev\.\d+)?$/.test(options.version) || options.version.length > 64)
222
+ throw new Error('Invalid installed version')
223
+ const profile = await realpath(options.profile),
224
+ root = await realpath(options.installedRoot),
225
+ archive = resolve(options.archive)
226
+ if (
227
+ !(await lstat(profile)).isDirectory() ||
228
+ !(await lstat(root)).isDirectory() ||
229
+ !within(profile, root)
230
+ )
231
+ throw new Error('Installed root escapes isolated profile')
232
+ const { archiveInfo, entries } = await listArchive(archive, options.platform, env)
233
+ assertPayloadLayout({
234
+ platform: options.platform,
235
+ renderer: options.renderer,
236
+ appName: options.appName,
237
+ entries,
238
+ sidecars: options.sidecars ?? [],
239
+ })
240
+ const mac = options.platform === 'macos-arm64',
241
+ prefix = mac ? `${options.appName}.app/Contents` : options.appName.replaceAll(' ', ''),
242
+ suffix = options.platform === 'windows-x64' ? '.exe' : ''
243
+ const bin = mac ? 'MacOS' : 'bin'
244
+ const files = [
245
+ `${bin}/launcher${suffix}`,
246
+ `${bin}/bun${suffix}`,
247
+ 'Resources/version.json',
248
+ 'Resources/build.json',
249
+ 'Resources/main.js',
250
+ 'Resources/app/bun/index.js',
251
+ 'Resources/app/client/index.html',
252
+ ...sidecars,
253
+ ]
254
+ const selected = files.map((name) => {
255
+ const metadata = name === 'Resources/version.json' || name === 'Resources/build.json'
256
+ const limit = metadata
257
+ ? 1024 * 1024
258
+ : name === `${bin}/bun${suffix}` || sidecars.includes(name)
259
+ ? 256 * 1024 * 1024
260
+ : 64 * 1024 * 1024
261
+ const expected = `${prefix}/${name}`
262
+ const candidates = entries.filter((entry) => {
263
+ const normalized = entry.replace(/^\.\//, '').replaceAll('\\', '/')
264
+ return options.platform === 'windows-x64'
265
+ ? normalized.toLowerCase() === expected.toLowerCase()
266
+ : normalized === expected
267
+ })
268
+ if (candidates.length !== 1) throw new Error('Archive member missing or ambiguous')
269
+ return { name, metadata, limit, path: candidates[0]! }
270
+ })
271
+ const members = await readMembers(
272
+ archive,
273
+ new Map(selected.map(({ path, limit }) => [path, limit])),
274
+ new Set(selected.filter(({ metadata }) => metadata).map(({ path }) => path))
275
+ )
276
+ for (const { name, limit, path } of selected) {
277
+ const member = members.get(path)
278
+ if (!member || member.count !== 1) throw new Error('Archive member missing or ambiguous')
279
+ const current = await installed(join(root, name), root, limit)
280
+ if (member.size !== current.size || member.digest !== current.digest)
281
+ throw new Error(`Installed file differs from archive: ${name}`)
282
+ if (name === 'Resources/version.json') {
283
+ if (
284
+ member.size > 1024 * 1024 ||
285
+ JSON.parse(member.bytes.toString('utf8')).version !== options.version
286
+ )
287
+ throw new Error('Installed version mismatch')
288
+ } else if (name === 'Resources/build.json') {
289
+ if (member.size > 1024 * 1024) throw new Error('Invalid installed build metadata')
290
+ assertBuildMetadata(JSON.parse(member.bytes.toString('utf8')), options.renderer)
291
+ }
292
+ }
293
+ const after = await lstat(archive)
294
+ if (
295
+ !after.isFile() ||
296
+ after.isSymbolicLink() ||
297
+ after.dev !== archiveInfo.dev ||
298
+ after.ino !== archiveInfo.ino ||
299
+ after.size !== archiveInfo.size ||
300
+ after.mtimeMs !== archiveInfo.mtimeMs
301
+ )
302
+ throw new Error('Staged archive changed during verification')
303
+ return { files }
304
+ }
305
+
306
+ /** Extract only the candidate Bun executable to an isolated profile for guard preflight. */
307
+ export async function extractCandidateRuntime(options: {
308
+ platform: InstallerPlatform
309
+ renderer: InstallerRenderer
310
+ appName: string
311
+ archive: string
312
+ profile: string
313
+ env?: Record<string, string | undefined>
314
+ }): Promise<{ path: string; size: number; digest: string }> {
315
+ const env = options.env ?? process.env
316
+ assertInstallerContext(env, options.platform, process.platform, process.arch)
317
+ assertPortableAppName(options.appName)
318
+ if (!env.RUNNER_TEMP || !isAbsolute(env.RUNNER_TEMP))
319
+ throw new Error('Missing runner temp directory')
320
+ const tempRoot = await realpath(env.RUNNER_TEMP),
321
+ profile = await realpath(options.profile),
322
+ archive = resolve(options.archive)
323
+ if (!within(tempRoot, profile) || !(await lstat(profile)).isDirectory())
324
+ throw new Error('Runtime profile escapes runner temp')
325
+ const { archiveInfo, tarEnv, entries } = await listArchive(archive, options.platform, env)
326
+ assertPayloadLayout({
327
+ platform: options.platform,
328
+ renderer: options.renderer,
329
+ appName: options.appName,
330
+ entries,
331
+ })
332
+ const prefix =
333
+ options.platform === 'macos-arm64'
334
+ ? `${options.appName}.app/Contents/MacOS`
335
+ : `${options.appName.replaceAll(' ', '')}/bin`,
336
+ suffix = options.platform === 'windows-x64' ? '.exe' : ''
337
+ const expected = `${prefix}/bun${suffix}`
338
+ const candidates = entries.filter((entry) => {
339
+ const normalized = entry.replace(/^\.\//, '').replaceAll('\\', '/')
340
+ return options.platform === 'windows-x64'
341
+ ? normalized.toLowerCase() === expected.toLowerCase()
342
+ : normalized === expected
343
+ })
344
+ if (candidates.length !== 1) throw new Error('Runtime archive member missing or ambiguous')
345
+ const destination = join(profile, `candidate-bun${suffix}`),
346
+ output = await open(destination, 'wx', 0o700)
347
+ const spawn = () =>
348
+ Bun.spawn({
349
+ cmd: ['tar', '--zstd', '-xOf', archive, '--', candidates[0]!],
350
+ env: tarEnv,
351
+ stdout: 'pipe',
352
+ stderr: 'pipe',
353
+ signal: AbortSignal.timeout(120000),
354
+ })
355
+ let successful = false
356
+ try {
357
+ const child = spawn(),
358
+ errors = (async () => {
359
+ for await (const _part of child.stderr) {
360
+ /* Drain silently. */
361
+ }
362
+ })()
363
+ const hash = createHash('sha256')
364
+ let size = 0
365
+ try {
366
+ for await (const part of child.stdout) {
367
+ size += part.length
368
+ if (!Number.isSafeInteger(size) || size > 256 * 1024 * 1024)
369
+ throw new Error('Candidate runtime exceeds bound')
370
+ hash.update(part)
371
+ let offset = 0
372
+ while (offset < part.length) {
373
+ const result = await output.write(part, offset, part.length - offset)
374
+ if (!result.bytesWritten) throw new Error('Cannot stage candidate runtime')
375
+ offset += result.bytesWritten
376
+ }
377
+ }
378
+ if ((await child.exited) !== 0 || size < 4096) throw new Error('Invalid candidate runtime')
379
+ await errors
380
+ const after = await lstat(archive)
381
+ if (
382
+ !after.isFile() ||
383
+ after.isSymbolicLink() ||
384
+ after.dev !== archiveInfo.dev ||
385
+ after.ino !== archiveInfo.ino ||
386
+ after.size !== archiveInfo.size ||
387
+ after.mtimeMs !== archiveInfo.mtimeMs
388
+ )
389
+ throw new Error('Staged archive changed during extraction')
390
+ const digest = hash.digest('hex')
391
+ await output.sync()
392
+ const copied = await installed(destination, profile, 256 * 1024 * 1024)
393
+ if (copied.size !== size || copied.digest !== digest)
394
+ throw new Error('Candidate runtime copy differs')
395
+ await assertRuntimeBinary(destination, options.platform)
396
+ successful = true
397
+ return { path: destination, size, digest }
398
+ } catch (error) {
399
+ child.kill()
400
+ await child.exited
401
+ await errors
402
+ throw error
403
+ }
404
+ } finally {
405
+ await output.close()
406
+ if (!successful) await rm(destination, { force: true })
407
+ }
408
+ }
@@ -0,0 +1,199 @@
1
+ import { randomBytes } from 'node:crypto'
2
+ import { lstat, mkdir, mkdtemp, readFile, realpath, rm, writeFile } from 'node:fs/promises'
3
+ import { dirname, isAbsolute, join, relative, sep } from 'node:path'
4
+ import { fileURLToPath } from 'node:url'
5
+ import { isHostedRunner } from './hosted-runner'
6
+
7
+ /** The modules copied into the runner. The worker and preflight scripts import the rest. */
8
+ const bootstrapModules = [
9
+ 'installer/installer-ci-worker.js',
10
+ 'installer/installer-ci-preflight.js',
11
+ 'installer/installer-worker-guard.js',
12
+ 'installer/installer-fetch-guard.js',
13
+ 'installer/installer-renderer-evidence.js',
14
+ 'installer/hosted-runner.js',
15
+ 'release/release-qualification.js',
16
+ 'desktop/string-policy.js',
17
+ ]
18
+
19
+ export type InstallerCiBootstrap = {
20
+ directory: string
21
+ /** The Bun preload, which also runs as the guarded app worker. */
22
+ worker: string
23
+ preflight: string
24
+ bunOptions: string
25
+ }
26
+
27
+ /** Copy a bounded external preload into the current disposable runner's temp directory. */
28
+ export async function prepareInstallerCiBootstrap(
29
+ env: Record<string, string | undefined> = process.env
30
+ ): Promise<InstallerCiBootstrap> {
31
+ if (!isHostedRunner(env) || !env.RUNNER_TEMP || !isAbsolute(env.RUNNER_TEMP))
32
+ throw new Error('Installer bootstrap requires a disposable GitHub-hosted runner')
33
+ const parent = await realpath(env.RUNNER_TEMP)
34
+ if (/\s/.test(parent) || !(await lstat(parent)).isDirectory())
35
+ throw new Error('Runner temp cannot represent a Bun preload path')
36
+ // The closure keeps its dist/<folder>/ layout so cross-folder imports resolve.
37
+ const source = dirname(dirname(fileURLToPath(import.meta.url)))
38
+ const directory = await mkdtemp(join(parent, 'framework-ci-'))
39
+ try {
40
+ for (const name of bootstrapModules) {
41
+ const file = join(source, name),
42
+ info = await lstat(file)
43
+ if (!info.isFile() || info.isSymbolicLink() || info.size < 1 || info.size > 2 * 1024 * 1024)
44
+ throw new Error('Invalid installer bootstrap module')
45
+ const contents = await readFile(file)
46
+ if (contents.length !== info.size) throw new Error('Installer bootstrap module changed')
47
+ await mkdir(dirname(join(directory, name)), { recursive: true, mode: 0o700 })
48
+ await writeFile(join(directory, name), contents, { flag: 'wx', mode: 0o600 })
49
+ }
50
+ await writeFile(join(directory, 'package.json'), '{"type":"module"}\n', {
51
+ flag: 'wx',
52
+ mode: 0o600,
53
+ })
54
+ const worker = join(directory, 'installer/installer-ci-worker.js')
55
+ return {
56
+ directory,
57
+ worker,
58
+ preflight: join(directory, 'installer/installer-ci-preflight.js'),
59
+ bunOptions: `--preload=${worker}`,
60
+ }
61
+ } catch (error) {
62
+ await rm(directory, { recursive: true, force: true })
63
+ throw error
64
+ }
65
+ }
66
+
67
+ /** Exercise the externally prepared guard with the actual candidate Bun runtime. */
68
+ export async function preflightInstallerRuntime(options: {
69
+ env: Record<string, string | undefined>
70
+ runtime: string
71
+ bootstrap: InstallerCiBootstrap
72
+ }): Promise<void> {
73
+ const { env, runtime, bootstrap } = options
74
+ if (
75
+ !isHostedRunner(env) ||
76
+ !env.RUNNER_TEMP ||
77
+ !isAbsolute(env.RUNNER_TEMP) ||
78
+ !isAbsolute(runtime)
79
+ )
80
+ throw new Error('Runtime preflight requires a disposable hosted runner')
81
+ const tempRoot = await realpath(env.RUNNER_TEMP),
82
+ bootstrapRoot = await realpath(bootstrap.directory)
83
+ const relativeBootstrap = relative(tempRoot, bootstrapRoot)
84
+ if (
85
+ !relativeBootstrap ||
86
+ relativeBootstrap === '..' ||
87
+ relativeBootstrap.startsWith('..' + sep) ||
88
+ isAbsolute(relativeBootstrap) ||
89
+ /\s/.test(bootstrapRoot) ||
90
+ bootstrap.worker !== join(bootstrapRoot, 'installer/installer-ci-worker.js') ||
91
+ bootstrap.preflight !== join(bootstrapRoot, 'installer/installer-ci-preflight.js') ||
92
+ bootstrap.bunOptions !== `--preload=${bootstrap.worker}`
93
+ )
94
+ throw new Error('Invalid installer bootstrap location')
95
+ await runInstallerPreflight({
96
+ env,
97
+ runtime,
98
+ worker: bootstrap.worker,
99
+ preflight: bootstrap.preflight,
100
+ parent: tempRoot,
101
+ })
102
+ }
103
+
104
+ /** Run the guard preflight from explicit worker and preflight modules in a clean,
105
+ * hosted-shaped environment. `preflightInstallerRuntime` validates a prepared bootstrap
106
+ * before calling this; tests call it directly with the source modules. */
107
+ export async function runInstallerPreflight(options: {
108
+ env: Record<string, string | undefined>
109
+ runtime: string
110
+ worker: string
111
+ preflight: string
112
+ /** Directory that receives the short-lived acknowledgement and permit files. */
113
+ parent: string
114
+ }): Promise<void> {
115
+ const { env, runtime, worker, preflight } = options
116
+ for (const path of [worker, preflight]) {
117
+ const item = await lstat(path)
118
+ if (!item.isFile() || item.isSymbolicLink())
119
+ throw new Error('Invalid installer bootstrap module')
120
+ }
121
+ const info = await lstat(runtime)
122
+ if (!info.isFile() || info.isSymbolicLink() || info.size < 4096)
123
+ throw new Error('Invalid candidate Bun runtime')
124
+ const temporary = await mkdtemp(join(options.parent, 'framework-preflight-'))
125
+ try {
126
+ const clean: Record<string, string> = {}
127
+ for (const key of [
128
+ 'PATH',
129
+ 'SystemRoot',
130
+ 'WINDIR',
131
+ 'COMSPEC',
132
+ 'PATHEXT',
133
+ 'TMP',
134
+ 'TEMP',
135
+ 'TMPDIR',
136
+ 'LANG',
137
+ 'LC_ALL',
138
+ ])
139
+ if (env[key]) clean[key] = env[key]!
140
+ const nonce = randomBytes(24).toString('hex')
141
+ Object.assign(clean, {
142
+ CI: 'true',
143
+ GITHUB_ACTIONS: 'true',
144
+ RUNNER_ENVIRONMENT: 'github-hosted',
145
+ BUN_OPTIONS: `--preload=${worker}`,
146
+ FRAMEWORK_CI_WORKER_ENTRY: preflight,
147
+ FRAMEWORK_CI_NONCE: nonce,
148
+ FRAMEWORK_CI_ACK: join(temporary, 'ack'),
149
+ FRAMEWORK_CI_PERMIT: join(temporary, 'permit'),
150
+ FRAMEWORK_CI_ORIGIN: 'http://127.0.0.1:48999',
151
+ FRAMEWORK_CI_OBSERVATION: join(temporary, 'observation'),
152
+ FRAMEWORK_CI_UNEXPECTED: join(temporary, 'unexpected'),
153
+ FRAMEWORK_CI_EXPECTED_READS: JSON.stringify([
154
+ 'https://example.invalid/framework-ci-sentinel',
155
+ ]),
156
+ })
157
+ const child = Bun.spawn({
158
+ cmd: [runtime, preflight],
159
+ env: clean,
160
+ stdout: 'pipe',
161
+ stderr: 'pipe',
162
+ signal: AbortSignal.timeout(15000),
163
+ })
164
+ const hardStop = setTimeout(() => {
165
+ try {
166
+ child.kill('SIGKILL')
167
+ } catch {}
168
+ }, 20000)
169
+ const out = (async () => {
170
+ let text = ''
171
+ for await (const chunk of child.stdout) {
172
+ text += new TextDecoder().decode(chunk)
173
+ if (text.length > 65536) {
174
+ child.kill()
175
+ throw new Error('Runtime preflight output exceeds bound')
176
+ }
177
+ }
178
+ return text
179
+ })()
180
+ const err = (async () => {
181
+ for await (const _chunk of child.stderr) {
182
+ /* Do not expose runtime output. */
183
+ }
184
+ })()
185
+ const [stdout, , status] = await Promise.all([out, err, child.exited]).finally(() =>
186
+ clearTimeout(hardStop)
187
+ )
188
+ if (status !== 0 || !stdout.includes('framework installer preload preflight passed'))
189
+ throw new Error('Candidate Bun runtime failed installer preflight')
190
+ try {
191
+ await lstat(join(temporary, 'unexpected'))
192
+ throw new Error('Runtime preflight recorded unexpected activity')
193
+ } catch (error) {
194
+ if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error
195
+ }
196
+ } finally {
197
+ await rm(temporary, { recursive: true, force: true })
198
+ }
199
+ }
@@ -0,0 +1,61 @@
1
+ // Exercises the external worker guard with the exact runtime that will be installed.
2
+ // As the main script it starts the guarded worker and checks its report; inside that
3
+ // worker it is the harmless app entry that tries a blocked fetch and a nested worker.
4
+ import { readFile, writeFile } from 'node:fs/promises'
5
+
6
+ if (Bun.isMainThread) await drivePreflight()
7
+ else await reportPreflightState()
8
+
9
+ async function drivePreflight(): Promise<void> {
10
+ const {
11
+ FRAMEWORK_CI_WORKER_ENTRY: entry,
12
+ FRAMEWORK_CI_NONCE: nonce,
13
+ FRAMEWORK_CI_ACK: ack,
14
+ FRAMEWORK_CI_PERMIT: permit,
15
+ } = process.env
16
+ if (!entry || !nonce || !ack || !permit) throw new Error('Missing preflight context')
17
+ const worker = new Worker(entry, {})
18
+ const result = new Promise<unknown>((resolve) =>
19
+ worker.addEventListener('message', (event) => resolve(event.data), { once: true })
20
+ )
21
+ const deadline = Date.now() + 10000
22
+ let acknowledged = false
23
+ while (!acknowledged && Date.now() < deadline) {
24
+ try {
25
+ acknowledged = (await readFile(ack, 'utf8')) === nonce + '\n'
26
+ } catch {}
27
+ if (!acknowledged) await Bun.sleep(20)
28
+ }
29
+ if (!acknowledged) throw new Error('Worker guard acknowledgement missing')
30
+ await writeFile(permit, nonce + '\n', { flag: 'wx', mode: 0o600 })
31
+ let timer: ReturnType<typeof setTimeout>
32
+ const timeout = new Promise<null>((resolve) => {
33
+ timer = setTimeout(() => resolve(null), Math.max(0, deadline - Date.now()))
34
+ })
35
+ const value = (await Promise.race([result, timeout])) as {
36
+ blocked?: boolean
37
+ nested?: boolean
38
+ } | null
39
+ clearTimeout(timer!)
40
+ worker.terminate()
41
+ if (value?.blocked !== true || value.nested !== true)
42
+ throw new Error('Worker guard preflight failed')
43
+ console.log('framework installer preload preflight passed')
44
+ }
45
+
46
+ async function reportPreflightState(): Promise<void> {
47
+ let blocked = false,
48
+ nested = false
49
+ try {
50
+ await fetch('https://example.invalid/framework-ci-sentinel')
51
+ } catch {
52
+ blocked = true
53
+ }
54
+ try {
55
+ const nestedWorker = new Worker('unexpected')
56
+ nestedWorker.terminate()
57
+ } catch {
58
+ nested = true
59
+ }
60
+ postMessage({ blocked, nested })
61
+ }