@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,402 @@
1
+ import { CEF_BRIDGE_PATCH_PATH, CEF_HELPER_SOURCES, ELECTROBUN_COMMIT, PINNED_CEF_BRIDGE_PATCH, applyElectrobunPatch } from "./electrobun-source-patch.js";
2
+ import { chmod, lstat, mkdir, mkdtemp, readFile, readdir, realpath, rename, rm, stat, writeFile } from "node:fs/promises";
3
+ import { dirname, isAbsolute, join } from "node:path";
4
+ import { createWriteStream } from "node:fs";
5
+ import { spawnSync } from "node:child_process";
6
+ import { createHash, randomUUID } from "node:crypto";
7
+ import { availableParallelism, homedir } from "node:os";
8
+ // src/native/cef-helper.ts
9
+ /** The CEF build Electrobun 2.0.5 pins (its src/shared/cef-version.ts). */
10
+ var CEF_VERSION = "156.0.7+g47dbc1d";
11
+ var CHROMIUM_VERSION = "156.0.8078.17";
12
+ /** Electrobun 2.0.5's macOS deployment target (its scripts/macos-release.js). */
13
+ var MACOS_DEPLOYMENT_TARGET = "14.0";
14
+ /** Bump when the build recipe below changes, so cached helpers are rebuilt. */
15
+ var RECIPE = 1;
16
+ /** Targets the packaged native probes exercise; any other CEF bundle fails closed. */
17
+ var TARGETS = {
18
+ "macos-arm64": {
19
+ platform: "macos",
20
+ sdk: "macosarm64",
21
+ sdkBytes: 134827440,
22
+ sdkSha256: "d9a4e98dfde499bfecc49ec2290395fbfffc3923fed5f967bb95c6e05e03e903",
23
+ stockHelperSha256: "059df37e1f7a91dc03f6f68079fb6d338db13c31c0c8a40a8d1b253d7a9b53b7"
24
+ },
25
+ "linux-x64": {
26
+ platform: "linux",
27
+ sdk: "linux64",
28
+ sdkBytes: 331669290,
29
+ sdkSha256: "46c55fff95da8d5cbe2db0fba16413e3e268bf240a5de1a5b8322e3cacdc6bfd",
30
+ stockHelperSha256: "e12d251e2aef2ebc950507075a51239726b4dcd807af4812b4ea762a69ef7ccd"
31
+ },
32
+ "win-x64": {
33
+ platform: "win",
34
+ sdk: "windows64",
35
+ sdkBytes: 174668703,
36
+ sdkSha256: "81ed0be65efe89013c354ce60f3d694958a613891a46efee2f3a25d5af8fdca0",
37
+ stockHelperSha256: "327e27822d813926bd03dba3caf1e12416981d4c6b973ba9f7cfd90b573e5a1b"
38
+ }
39
+ };
40
+ /** A failure message safe to print: this module's own bounded messages, never paths or tool output. */
41
+ var cefHelperFailure = (error) => error instanceof Error && /^(?:CEF|Unexpected|Unsupported|Expected|Invalid|Electrobun)\b/.test(error.message) ? error.message : "CEF helper preparation failed";
42
+ var sha256 = (bytes) => createHash("sha256").update(bytes).digest("hex");
43
+ function target(os, arch) {
44
+ const found = TARGETS[`${os}-${arch}`];
45
+ if (!found) throw new Error("Unsupported CEF helper target");
46
+ return found;
47
+ }
48
+ /** Cache key for one target's patched helper: pinned source, patch, CEF SDK and recipe. */
49
+ function cefHelperCacheKey(os, arch) {
50
+ const pin = target(os, arch);
51
+ const identity = JSON.stringify([
52
+ ELECTROBUN_COMMIT,
53
+ PINNED_CEF_BRIDGE_PATCH.patchSha256,
54
+ CEF_VERSION,
55
+ CHROMIUM_VERSION,
56
+ pin.sdkSha256,
57
+ RECIPE
58
+ ]);
59
+ return `cef-helper-${os}-${arch}-${sha256(Buffer.from(identity)).slice(0, 16)}`;
60
+ }
61
+ /** `ADEA_CEF_HELPER_CACHE` when set (CI caches it), otherwise the user's cache directory. */
62
+ function cefHelperCacheRoot(env) {
63
+ const configured = env.ADEA_CEF_HELPER_CACHE;
64
+ if (configured !== void 0) {
65
+ if (!isAbsolute(configured)) throw new Error("Invalid CEF helper cache directory");
66
+ return configured;
67
+ }
68
+ const base = process.platform === "darwin" ? join(homedir(), "Library", "Caches") : process.platform === "win32" ? env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local") : env.XDG_CACHE_HOME ?? join(homedir(), ".cache");
69
+ return join(base, "adea-app-framework");
70
+ }
71
+ /** Return the cached patched helper for this target, building it once from the pinned source. */
72
+ async function ensurePatchedCefHelper(env, os, arch, build = buildPatchedCefHelper) {
73
+ const pin = target(os, arch);
74
+ const root = cefHelperCacheRoot(env);
75
+ const entry = join(root, cefHelperCacheKey(os, arch));
76
+ const output = join(entry, pin.platform === "win" ? "process_helper.exe" : "process_helper");
77
+ try {
78
+ const info = await lstat(output);
79
+ if (info.isFile() && !info.isSymbolicLink() && info.size > 0) return output;
80
+ throw new Error("Invalid cached CEF helper");
81
+ } catch (error) {
82
+ if (error.code !== "ENOENT") throw error;
83
+ }
84
+ await mkdir(root, { recursive: true });
85
+ const work = await mkdtemp(join(root, ".build-"));
86
+ try {
87
+ const staged = join(work, "out");
88
+ await mkdir(staged);
89
+ await build(pin, work, join(staged, pin.platform === "win" ? "process_helper.exe" : "process_helper"));
90
+ try {
91
+ await rename(staged, entry);
92
+ } catch (error) {
93
+ if (![
94
+ "EEXIST",
95
+ "ENOTEMPTY",
96
+ "EPERM"
97
+ ].includes(error.code ?? "")) throw error;
98
+ await stat(output);
99
+ }
100
+ return output;
101
+ } finally {
102
+ await rm(work, {
103
+ recursive: true,
104
+ force: true
105
+ });
106
+ }
107
+ }
108
+ async function download(url, path, maxBytes) {
109
+ const response = await fetch(url, { signal: AbortSignal.timeout(9e5) });
110
+ if (!response.ok || !response.body) throw new Error("CEF helper download failed");
111
+ const hash = createHash("sha256");
112
+ const file = createWriteStream(path, { flags: "wx" });
113
+ let size = 0;
114
+ try {
115
+ for await (const chunk of response.body) {
116
+ size += chunk.byteLength;
117
+ if (size > maxBytes) throw new Error("CEF helper download exceeded its size");
118
+ hash.update(chunk);
119
+ if (!file.write(chunk)) await new Promise((resolve) => file.once("drain", resolve));
120
+ }
121
+ } finally {
122
+ await new Promise((resolve) => file.end(resolve));
123
+ }
124
+ return hash.digest("hex");
125
+ }
126
+ function step(name, command, args, cwd) {
127
+ const result = spawnSync(command, args, {
128
+ cwd,
129
+ stdio: "ignore",
130
+ timeout: 18e5
131
+ });
132
+ if (result.status !== 0) throw new Error(`CEF helper build failed at ${name} (${result.error ? "not started" : result.signal ?? result.status})`);
133
+ }
134
+ function visualStudioRoot() {
135
+ const vswhere = join(process.env["ProgramFiles(x86)"] ?? "C:\\Program Files (x86)", "Microsoft Visual Studio", "Installer", "vswhere.exe");
136
+ const result = spawnSync(vswhere, [
137
+ "-latest",
138
+ "-products",
139
+ "*",
140
+ "-requires",
141
+ "Microsoft.VisualStudio.Component.VC.Tools.x86.x64"
142
+ ], {
143
+ encoding: "utf8",
144
+ timeout: 6e4
145
+ });
146
+ const root = /^installationPath: (.+)$/m.exec(result.stdout ?? "")?.[1]?.trim();
147
+ if (result.status !== 0 || !root) throw new Error("CEF helper build requires Visual Studio C++");
148
+ return root;
149
+ }
150
+ /**
151
+ * Fetch the three pinned helper sources, apply the digest-pinned main-frame
152
+ * patch, and build this target's helper exactly as Electrobun 2.0.5's
153
+ * build.ts does, against the pinned CEF minimal distribution.
154
+ */
155
+ async function buildPatchedCefHelper(pin, work, output) {
156
+ const source = join(work, "electrobun");
157
+ for (const path of Object.values(CEF_HELPER_SOURCES)) {
158
+ await mkdir(dirname(join(source, path)), { recursive: true });
159
+ await download(`https://raw.githubusercontent.com/blackboardsh/electrobun/${ELECTROBUN_COMMIT}/${path}`, join(source, path), 65536);
160
+ }
161
+ step("source", "git", ["init", "-q"], source);
162
+ applyElectrobunPatch(source, CEF_BRIDGE_PATCH_PATH, PINNED_CEF_BRIDGE_PATCH);
163
+ const helperSource = join(source, CEF_HELPER_SOURCES[pin.platform]);
164
+ const distribution = `cef_binary_${CEF_VERSION}+chromium-${CHROMIUM_VERSION}_${pin.sdk}_minimal`;
165
+ const archive = join(work, "cef.tar.bz2");
166
+ if (await download(`https://cef-builds.spotifycdn.com/${encodeURIComponent(distribution)}.tar.bz2`, archive, pin.sdkBytes) !== pin.sdkSha256 || (await stat(archive)).size !== pin.sdkBytes) throw new Error("Unexpected CEF distribution digest");
167
+ const cef = join(work, "cef");
168
+ await mkdir(cef);
169
+ const library = {
170
+ macos: "Release/Chromium Embedded Framework.framework",
171
+ linux: "Release/libcef.so",
172
+ win: "Release/libcef.lib"
173
+ }[pin.platform];
174
+ step("extract", pin.platform === "win" ? join(process.env.SystemRoot ?? "C:\\Windows", "System32", "tar.exe") : "tar", [
175
+ "-xjf",
176
+ archive,
177
+ "--strip-components=1",
178
+ "-C",
179
+ cef,
180
+ ...[
181
+ "CMakeLists.txt",
182
+ "cmake",
183
+ "include",
184
+ "libcef_dll",
185
+ library
186
+ ].map((path) => `${distribution}/${path}`)
187
+ ], work);
188
+ await rm(archive);
189
+ const wrapperBuild = join(cef, "build");
190
+ const jobs = String(Math.max(1, availableParallelism()));
191
+ const prefixMap = `-ffile-prefix-map=${work}=.`;
192
+ if (pin.platform === "linux") {
193
+ step("wrapper", "cmake", [
194
+ "-S",
195
+ cef,
196
+ "-B",
197
+ wrapperBuild,
198
+ "-DCEF_USE_SANDBOX=OFF",
199
+ "-DCMAKE_BUILD_TYPE=Release",
200
+ `-DCMAKE_CXX_FLAGS=${prefixMap}`
201
+ ], work);
202
+ step("wrapper", "cmake", [
203
+ "--build",
204
+ wrapperBuild,
205
+ "--target",
206
+ "libcef_dll_wrapper",
207
+ "-j",
208
+ jobs
209
+ ], work);
210
+ const object = join(work, "process_helper_linux.o");
211
+ step("compile", "g++", [
212
+ "-c",
213
+ "-std=c++20",
214
+ prefixMap,
215
+ `-I${cef}`,
216
+ "-o",
217
+ object,
218
+ helperSource
219
+ ], work);
220
+ step("link", "g++", [
221
+ "-o",
222
+ output,
223
+ object,
224
+ join(wrapperBuild, "libcef_dll_wrapper", "libcef_dll_wrapper.a"),
225
+ join(cef, "Release", "libcef.so"),
226
+ "-Wl,-rpath,$ORIGIN",
227
+ "-lpthread",
228
+ "-ldl"
229
+ ], work);
230
+ } else if (pin.platform === "macos") {
231
+ const flags = [
232
+ "-arch",
233
+ "arm64",
234
+ `-mmacosx-version-min=${MACOS_DEPLOYMENT_TARGET}`
235
+ ];
236
+ step("wrapper", "cmake", [
237
+ "-S",
238
+ cef,
239
+ "-B",
240
+ wrapperBuild,
241
+ "-DPROJECT_ARCH=arm64",
242
+ "-DCMAKE_OSX_ARCHITECTURES=arm64",
243
+ "-DCMAKE_BUILD_TYPE=Release",
244
+ `-DCMAKE_OSX_DEPLOYMENT_TARGET=${MACOS_DEPLOYMENT_TARGET}`,
245
+ `-DCMAKE_CXX_FLAGS=${prefixMap}`
246
+ ], work);
247
+ step("wrapper", "cmake", [
248
+ "--build",
249
+ wrapperBuild,
250
+ "--target",
251
+ "libcef_dll_wrapper",
252
+ "-j",
253
+ jobs
254
+ ], work);
255
+ const object = join(work, "process_helper_mac.o");
256
+ step("compile", "xcrun", [
257
+ "--sdk",
258
+ "macosx",
259
+ "clang++",
260
+ ...flags,
261
+ "-std=c++20",
262
+ "-ObjC++",
263
+ "-fobjc-arc",
264
+ prefixMap,
265
+ `-I${cef}`
266
+ ].concat([
267
+ "-c",
268
+ helperSource,
269
+ "-o",
270
+ object
271
+ ]), work);
272
+ step("link", "xcrun", [
273
+ "--sdk",
274
+ "macosx",
275
+ "clang++",
276
+ ...flags,
277
+ "-std=c++20",
278
+ object,
279
+ "-o",
280
+ output
281
+ ].concat([
282
+ "-framework",
283
+ "Cocoa",
284
+ "-framework",
285
+ "WebKit",
286
+ "-framework",
287
+ "QuartzCore"
288
+ ]).concat([
289
+ "-F",
290
+ join(cef, "Release"),
291
+ "-framework",
292
+ "Chromium Embedded Framework"
293
+ ]).concat([
294
+ "-L",
295
+ join(wrapperBuild, "libcef_dll_wrapper"),
296
+ "-lcef_dll_wrapper",
297
+ "-stdlib=libc++"
298
+ ]), work);
299
+ const framework = "Frameworks/Chromium Embedded Framework.framework/Chromium Embedded Framework";
300
+ step("link", "install_name_tool", [
301
+ "-change",
302
+ `@executable_path/../${framework}`,
303
+ `@executable_path/../../../../${framework}`,
304
+ output
305
+ ], work);
306
+ step("sign", "codesign", [
307
+ "--force",
308
+ "--sign",
309
+ "-",
310
+ output
311
+ ], work);
312
+ } else {
313
+ const vcvars = join(visualStudioRoot(), "VC", "Auxiliary", "Build", "vcvarsall.bat");
314
+ const object = join(work, "process_helper_win.obj");
315
+ const script = join(work, "build.cmd");
316
+ await writeFile(script, [
317
+ "@echo off",
318
+ `call "${vcvars}" x64 >nul || exit /b 1`,
319
+ `cmake -G "NMake Makefiles" -S "${cef}" -B "${wrapperBuild}" -DPROJECT_ARCH=x86_64 -DCEF_USE_SANDBOX=OFF -DCMAKE_BUILD_TYPE=Release || exit /b 2`,
320
+ `cmake --build "${wrapperBuild}" --target libcef_dll_wrapper || exit /b 3`,
321
+ `cl /nologo /c /EHsc /std:c++20 /DNOMINMAX /I"${cef}" /D_USRDLL /D_WINDLL /Fo"${object}" "${helperSource}" || exit /b 4`,
322
+ `link /nologo /OUT:"${output}" user32.lib ole32.lib shell32.lib "${join(cef, "Release", "libcef.lib")}" "${join(wrapperBuild, "libcef_dll_wrapper", "libcef_dll_wrapper.lib")}" /SUBSYSTEM:WINDOWS "${object}" || exit /b 5`,
323
+ ""
324
+ ].join("\r\n"));
325
+ step("msvc", join(process.env.SystemRoot ?? "C:\\Windows", "System32", "cmd.exe"), [
326
+ "/d",
327
+ "/c",
328
+ script
329
+ ], work);
330
+ }
331
+ const info = await lstat(output);
332
+ if (!info.isFile() || info.size < 4096) throw new Error("CEF helper build produced no helper");
333
+ if (pin.platform !== "win") await chmod(output, 493);
334
+ }
335
+ var HELPER = /^.+ Helper(?: \((?:GPU|Renderer|Plugin|Alerts)\))?(?:\.exe)?$/;
336
+ var CEF_RUNTIME = /^(?:libcef\.so|libcef\.dll|Chromium Embedded Framework\.framework)$/;
337
+ /** Walk the build without following links; bounded so a runaway tree fails closed. */
338
+ async function scan(root) {
339
+ let cef = false;
340
+ let seen = 0;
341
+ const helpers = [];
342
+ const pending = [{
343
+ path: root,
344
+ depth: 0
345
+ }];
346
+ while (pending.length) {
347
+ const { path, depth } = pending.pop();
348
+ for (const entry of await readdir(path, { withFileTypes: true })) {
349
+ if (++seen > 5e5 || depth > 24) throw new Error("Electrobun build is too large to scan");
350
+ const child = join(path, entry.name);
351
+ if (CEF_RUNTIME.test(entry.name)) cef = true;
352
+ if (entry.isDirectory()) pending.push({
353
+ path: child,
354
+ depth: depth + 1
355
+ });
356
+ else if (entry.isFile() && HELPER.test(entry.name)) helpers.push(child);
357
+ }
358
+ }
359
+ return {
360
+ cef,
361
+ helpers
362
+ };
363
+ }
364
+ /**
365
+ * Replace every stock Electrobun CEF helper in a just-built bundle with the
366
+ * main-frame-only build. Bundles without CEF are untouched. Any helper whose
367
+ * bytes are neither the pinned stock helper nor the patched build fails the
368
+ * build. Runs before Electrobun signs, so the helper is signed with the app.
369
+ */
370
+ async function installPatchedCefHelpers(env, ensure = ensurePatchedCefHelper, stockSha256) {
371
+ if (![
372
+ "macos",
373
+ "linux",
374
+ "win"
375
+ ].includes(env.ELECTROBUN_OS ?? "") || !env.ELECTROBUN_BUILD_DIR) throw new Error("Invalid Electrobun build context");
376
+ const { cef, helpers } = await scan(await realpath(env.ELECTROBUN_BUILD_DIR));
377
+ if (!cef) return 0;
378
+ const pin = target(env.ELECTROBUN_OS, env.ELECTROBUN_ARCH);
379
+ if (!helpers.length) throw new Error("Expected bundled CEF helpers");
380
+ const patched = await readFile(await ensure(env, env.ELECTROBUN_OS, env.ELECTROBUN_ARCH));
381
+ const patchedSha256 = sha256(patched);
382
+ const stock = [];
383
+ for (const path of helpers) {
384
+ const digest = sha256(await readFile(path));
385
+ if (digest === (stockSha256 ?? pin.stockHelperSha256)) stock.push(path);
386
+ else if (digest !== patchedSha256) throw new Error("Unexpected CEF helper digest");
387
+ }
388
+ for (const path of stock) {
389
+ const temp = `${path}.${randomUUID()}.tmp`;
390
+ try {
391
+ await writeFile(temp, patched, {
392
+ flag: "wx",
393
+ mode: (await stat(path)).mode & 511
394
+ });
395
+ await rename(temp, path);
396
+ } finally {
397
+ await rm(temp, { force: true });
398
+ }
399
+ }
400
+ return helpers.length;
401
+ }
402
+ export { cefHelperCacheKey, cefHelperCacheRoot, cefHelperFailure, ensurePatchedCefHelper, installPatchedCefHelpers };
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Electrobun postBuild hook; runs before release hashing, packaging and signing.
3
+ * On Windows it applies the pinned WebView2 runtime correction. On every
4
+ * platform it replaces bundled CEF helpers with the build that exposes
5
+ * Electrobun's bridges to the main frame only; bundles without CEF are untouched.
6
+ */
7
+ export default function secureDesktopBuild(): Promise<void>;
@@ -0,0 +1,20 @@
1
+ import { cefHelperFailure, installPatchedCefHelpers } from "./cef-helper.js";
2
+ import secureWindowsBuild from "./windows-build-hook.js";
3
+ // src/native/desktop-build-hook.ts
4
+ /**
5
+ * Electrobun postBuild hook; runs before release hashing, packaging and signing.
6
+ * On Windows it applies the pinned WebView2 runtime correction. On every
7
+ * platform it replaces bundled CEF helpers with the build that exposes
8
+ * Electrobun's bridges to the main frame only; bundles without CEF are untouched.
9
+ */
10
+ async function secureDesktopBuild() {
11
+ await secureWindowsBuild();
12
+ let helpers;
13
+ try {
14
+ helpers = await installPatchedCefHelpers(process.env);
15
+ } catch (error) {
16
+ throw new Error(cefHelperFailure(error));
17
+ }
18
+ if (helpers) process.stdout.write(`Installed main-frame-only CEF helpers: ${helpers}\n`);
19
+ }
20
+ export { secureDesktopBuild as default };
@@ -0,0 +1,25 @@
1
+ /** Electrobun 2.0.5 (MIT), tag v2.0.5: the only source these patches target. */
2
+ export declare const ELECTROBUN_COMMIT = "d06abc9edf0b4e55116129cabbfe17bf89e11791";
3
+ export declare const SHORTCUT_PATCH_PATH: string;
4
+ export declare const CEF_BRIDGE_PATCH_PATH: string;
5
+ export type ElectrobunPatchPin = Readonly<{
6
+ patchSha256: string;
7
+ /** Files that must match exactly before patching. */
8
+ before: Readonly<Record<string, string>>;
9
+ /** Every file the patch writes, verified after applying it. */
10
+ after: Readonly<Record<string, string>>;
11
+ }>;
12
+ export declare const PINNED_SHORTCUT_PATCH: ElectrobunPatchPin;
13
+ /** The CEF renderer helper sources, one per platform. */
14
+ export declare const CEF_HELPER_SOURCES: {
15
+ readonly macos: 'package/src/native/macos/cef_process_helper_mac.cc';
16
+ readonly linux: 'package/src/native/linux/cef_process_helper_linux.cpp';
17
+ readonly win: 'package/src/native/win/cef_process_helper_win.cpp';
18
+ };
19
+ export declare const PINNED_CEF_BRIDGE_PATCH: ElectrobunPatchPin;
20
+ /**
21
+ * Apply a pinned patch to a checkout of the pinned Electrobun source. Every
22
+ * input and output is digest-checked; nothing is written unless the checkout
23
+ * and patch bytes are exactly the reviewed ones.
24
+ */
25
+ export declare function applyElectrobunPatch(root: string, patchPath: string, pin: ElectrobunPatchPin, git?: (root: string, args: string[]) => void): void;
@@ -0,0 +1,93 @@
1
+ import { dirname, isAbsolute, join, normalize } from "node:path";
2
+ import { lstatSync, readFileSync } from "node:fs";
3
+ import { execFileSync } from "node:child_process";
4
+ import { createHash } from "node:crypto";
5
+ import { fileURLToPath } from "node:url";
6
+ // src/native/electrobun-source-patch.ts
7
+ /** Electrobun 2.0.5 (MIT), tag v2.0.5: the only source these patches target. */
8
+ var ELECTROBUN_COMMIT = "d06abc9edf0b4e55116129cabbfe17bf89e11791";
9
+ /** Patches ship in `src/native/` so packaged consumers apply the reviewed bytes from `dist/` or `src/`. */
10
+ var shippedPatch = (name) => join(dirname(fileURLToPath(import.meta.url)), "..", "..", "src", "native", name);
11
+ var SHORTCUT_PATCH_PATH = shippedPatch("electrobun-windows-shortcut-com.patch");
12
+ var CEF_BRIDGE_PATCH_PATH = shippedPatch("electrobun-cef-main-frame-bridges.patch");
13
+ var extractor = "package/src/extractor/";
14
+ var PINNED_SHORTCUT_PATCH = {
15
+ patchSha256: "72a4b75bf3a7fe2e27b2bc322e6447bcfa4169e55eda2f536dcf8189b0a94ad5",
16
+ before: {
17
+ [`${extractor}build.zig`]: "b749c261250850a8e7d9d2d59fea1023b11a49d1b6d7311808c0ff1ca72b4400",
18
+ [`${extractor}main.zig`]: "20cc6e888ae99160079eb5c0d52974c2ba8838a6a0e3a80d3b24d828fbd26044"
19
+ },
20
+ after: {
21
+ [`${extractor}build.zig`]: "2b2c20a3ca4dbd7630205df547049389ca74628b8c1201b37aa867b96a8dd8a3",
22
+ [`${extractor}main.zig`]: "9e393d1b8161aad915b3ce16aff4fabebc9c145707a4bdf9a2cb8ae5233dd0e2",
23
+ [`${extractor}windows_shortcut.c`]: "1265bbbe87720784d9386b124ffe3bec4ae218389560eeebe85004531cb11698",
24
+ [`${extractor}windows_shortcut_test_helper.c`]: "1edccd2789efecfdea43911b89195c86fc95c0dda6ac76c0d1182a4d6fbee904"
25
+ }
26
+ };
27
+ /** The CEF renderer helper sources, one per platform. */
28
+ var CEF_HELPER_SOURCES = {
29
+ macos: "package/src/native/macos/cef_process_helper_mac.cc",
30
+ linux: "package/src/native/linux/cef_process_helper_linux.cpp",
31
+ win: "package/src/native/win/cef_process_helper_win.cpp"
32
+ };
33
+ var PINNED_CEF_BRIDGE_PATCH = {
34
+ patchSha256: "318429449d0051eadbb5e5b06df3825c19029a9eaec74793ddada520b4a41cf6",
35
+ before: {
36
+ [CEF_HELPER_SOURCES.macos]: "b7e7704e41fab57f09c111b42815c70fb4620c5064aa2ef3c58d90642717c2ba",
37
+ [CEF_HELPER_SOURCES.linux]: "f71d78b51da00a5236b922c5d60708ba077857e2d3e4f6230afaae10cf21ccea",
38
+ [CEF_HELPER_SOURCES.win]: "50fb1b1126349e4f74dda1266fa039d16a6adfc93ce692ed1a2dd26896dc3366"
39
+ },
40
+ after: {
41
+ [CEF_HELPER_SOURCES.macos]: "7ffd75efc92ca14452966ee0190e28a3e84eb4f8f92d5128e0f825ff6fdb1c7b",
42
+ [CEF_HELPER_SOURCES.linux]: "a674bd48c7f2daa4a7403dc3316ea976407667e524f4c1fb1cd9ab77337c0fd4",
43
+ [CEF_HELPER_SOURCES.win]: "4aef164c56c6acf40af959d716ae3d53de4e1250effdfe0dc5e4ce1be0a96678"
44
+ }
45
+ };
46
+ /** SHA-256 of text with CRLF normalized, so Windows checkouts compare by content. */
47
+ var sourceTextDigest = (bytes) => createHash("sha256").update(bytes.toString("utf8").replace(/\r\n/g, "\n")).digest("hex");
48
+ function sourceDigest(root, path) {
49
+ if (isAbsolute(path) || normalize(path).startsWith("..")) throw new Error("Invalid source path");
50
+ const full = join(root, path);
51
+ let info;
52
+ try {
53
+ info = lstatSync(full);
54
+ } catch (error) {
55
+ if (error.code === "ENOENT") return null;
56
+ throw error;
57
+ }
58
+ if (!info.isFile() || info.isSymbolicLink()) throw new Error("Unexpected Electrobun source type");
59
+ return sourceTextDigest(readFileSync(full));
60
+ }
61
+ var runGit = (root, args) => {
62
+ execFileSync("git", args, {
63
+ cwd: root,
64
+ stdio: [
65
+ "ignore",
66
+ "ignore",
67
+ "pipe"
68
+ ]
69
+ });
70
+ };
71
+ /**
72
+ * Apply a pinned patch to a checkout of the pinned Electrobun source. Every
73
+ * input and output is digest-checked; nothing is written unless the checkout
74
+ * and patch bytes are exactly the reviewed ones.
75
+ */
76
+ function applyElectrobunPatch(root, patchPath, pin, git = runGit) {
77
+ if (sourceTextDigest(readFileSync(patchPath)) !== pin.patchSha256) throw new Error("Unexpected Electrobun patch digest");
78
+ for (const [path, expected] of Object.entries(pin.before)) if (sourceDigest(root, path) !== expected) throw new Error("Unexpected Electrobun source digest");
79
+ for (const path of Object.keys(pin.after)) if (!(path in pin.before) && sourceDigest(root, path) !== null) throw new Error("Electrobun patch output already exists");
80
+ git(root, [
81
+ "apply",
82
+ "--check",
83
+ "--whitespace=error-all",
84
+ patchPath
85
+ ]);
86
+ git(root, [
87
+ "apply",
88
+ "--whitespace=error-all",
89
+ patchPath
90
+ ]);
91
+ for (const [path, expected] of Object.entries(pin.after)) if (sourceDigest(root, path) !== expected) throw new Error("Unexpected patched Electrobun source");
92
+ }
93
+ export { CEF_BRIDGE_PATCH_PATH, CEF_HELPER_SOURCES, ELECTROBUN_COMMIT, PINNED_CEF_BRIDGE_PATCH, PINNED_SHORTCUT_PATCH, SHORTCUT_PATCH_PATH, applyElectrobunPatch };
@@ -0,0 +1,2 @@
1
+ /** These links are emitted by Electrobun's Linux CEF bundle, and are relative to bin/. */
2
+ export declare function isLinuxCefLibraryLink(path: string, target: string): boolean;
@@ -0,0 +1,15 @@
1
+ // src/native/linux-cef-links.ts
2
+ var linuxCefLibraries = /* @__PURE__ */ new Set([
3
+ "libcef.so",
4
+ "libvulkan.so.1",
5
+ "libvk_swiftshader.so",
6
+ "libEGL.so",
7
+ "libGLESv2.so"
8
+ ]);
9
+ /** These links are emitted by Electrobun's Linux CEF bundle, and are relative to bin/. */
10
+ function isLinuxCefLibraryLink(path, target) {
11
+ if (!path.startsWith("bin/")) return false;
12
+ const name = path.slice(4);
13
+ return linuxCefLibraries.has(name) && target === `cef/${name}`;
14
+ }
15
+ export { isLinuxCefLibraryLink };
@@ -0,0 +1,27 @@
1
+ type SecretBackend = {
2
+ get(input: {
3
+ service: string;
4
+ name: string;
5
+ }): Promise<string | null>;
6
+ set(input: {
7
+ service: string;
8
+ name: string;
9
+ value: string;
10
+ persist: 'local';
11
+ }): Promise<void>;
12
+ delete(input: {
13
+ service: string;
14
+ name: string;
15
+ }): Promise<boolean>;
16
+ };
17
+ /** Native credentials only. Apps choose the service namespace and own authorization and migration. */
18
+ export declare function createNativeSecretStore(options: {
19
+ service: string;
20
+ backend?: SecretBackend;
21
+ maxBytes?: number;
22
+ }): {
23
+ get(account: string): Promise<string | null>;
24
+ set(account: string, value: string): Promise<void>;
25
+ delete(account: string): Promise<boolean>;
26
+ };
27
+ export {};
@@ -0,0 +1,70 @@
1
+ // src/native/native-secret-store.ts
2
+ var identifier = (value) => typeof value === "string" && value.length > 0 && value.length <= 128 && /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(value);
3
+ /** Native credentials only. Apps choose the service namespace and own authorization and migration. */
4
+ function createNativeSecretStore(options) {
5
+ const maxBytes = options.maxBytes ?? 2048;
6
+ if (!identifier(options.service) || !Number.isSafeInteger(maxBytes) || maxBytes < 1 || maxBytes > 2048) throw new Error("Invalid credential store configuration");
7
+ const backend = options.backend ?? Bun.secrets;
8
+ if (!backend || typeof backend.get !== "function" || typeof backend.set !== "function" || typeof backend.delete !== "function") throw new Error("Credential store unavailable");
9
+ let queue = Promise.resolve();
10
+ const name = (value) => {
11
+ if (!identifier(value)) throw new Error("Invalid credential name");
12
+ return value;
13
+ };
14
+ function ordered(task) {
15
+ const result = queue.then(task);
16
+ queue = result.then(() => {}, () => {});
17
+ return result;
18
+ }
19
+ async function read(account) {
20
+ try {
21
+ const value = await backend.get({
22
+ service: options.service,
23
+ name: account
24
+ });
25
+ if (value !== null && (typeof value !== "string" || value.includes("\0") || Buffer.byteLength(value, "utf8") > maxBytes)) throw new Error("Invalid native result");
26
+ return value;
27
+ } catch {
28
+ throw new Error("Credential store unavailable");
29
+ }
30
+ }
31
+ return {
32
+ get(account) {
33
+ const key = name(account);
34
+ return ordered(() => read(key));
35
+ },
36
+ set(account, value) {
37
+ const key = name(account);
38
+ if (typeof value !== "string" || !value || value.includes("\0") || Buffer.byteLength(value, "utf8") > maxBytes) throw new Error("Invalid credential value");
39
+ return ordered(async () => {
40
+ try {
41
+ await backend.set({
42
+ service: options.service,
43
+ name: key,
44
+ value,
45
+ persist: "local"
46
+ });
47
+ } catch {
48
+ throw new Error("Credential store unavailable");
49
+ }
50
+ if (await read(key) !== value) throw new Error("Credential store verification failed");
51
+ });
52
+ },
53
+ delete(account) {
54
+ const key = name(account);
55
+ return ordered(async () => {
56
+ try {
57
+ const removed = await backend.delete({
58
+ service: options.service,
59
+ name: key
60
+ });
61
+ if (typeof removed !== "boolean" || await read(key) !== null) throw new Error("Invalid native result");
62
+ return removed;
63
+ } catch {
64
+ throw new Error("Credential store unavailable");
65
+ }
66
+ });
67
+ }
68
+ };
69
+ }
70
+ export { createNativeSecretStore };