@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,50 @@
1
+ // src/shell/settings-sections.ts
2
+ var sectionId = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
3
+ var hashPrefix = "#settings";
4
+ /** Validate section identifiers, labels and groups before the dialog mounts. */
5
+ function defineSettingsSections(sections) {
6
+ if (sections.length === 0) throw new Error("At least one settings section is required");
7
+ const ids = /* @__PURE__ */ new Set();
8
+ return Object.freeze(sections.map((section) => {
9
+ if (!sectionId.test(section.id) || !section.label.trim() || !section.group.trim() || typeof section.render !== "function" || ids.has(section.id)) throw new Error("Settings section identifiers, labels and groups must be valid and unique");
10
+ ids.add(section.id);
11
+ return Object.freeze({ ...section });
12
+ }));
13
+ }
14
+ /** The canonical deep link for a settings section. */
15
+ function settingsHash(id) {
16
+ return `${hashPrefix}/${id}`;
17
+ }
18
+ /** Whether a location hash addresses the settings surface. */
19
+ function isSettingsHash(hash) {
20
+ return hash === hashPrefix || hash.startsWith(`${hashPrefix}/`);
21
+ }
22
+ /**
23
+ * The section a `#settings/<id>` hash addresses. When it names no known section, the
24
+ * known `fallback` section, or else the first section.
25
+ */
26
+ function settingsSectionFromHash(hash, sections, fallback) {
27
+ if (!isSettingsHash(hash)) return void 0;
28
+ const known = (id) => sections.some((section) => section.id === id);
29
+ const candidate = hash.slice(10);
30
+ if (known(candidate)) return candidate;
31
+ return known(fallback) ? fallback : sections[0]?.id;
32
+ }
33
+ /** Group sections in first-appearance order for the shared settings navigation. */
34
+ function settingsGroups(sections) {
35
+ const groups = /* @__PURE__ */ new Map();
36
+ for (const section of sections) {
37
+ const items = groups.get(section.group) ?? [];
38
+ items.push({
39
+ value: section.id,
40
+ label: section.label,
41
+ icon: section.icon
42
+ });
43
+ groups.set(section.group, items);
44
+ }
45
+ return [...groups].map(([label, items]) => ({
46
+ label,
47
+ items
48
+ }));
49
+ }
50
+ export { defineSettingsSections, isSettingsHash, settingsGroups, settingsHash, settingsSectionFromHash };
@@ -0,0 +1,17 @@
1
+ /** Which modifier family the running OS uses for chords: ⌘ on Apple platforms, Ctrl elsewhere. */
2
+ export type ShortcutPlatform = 'mac' | 'other';
3
+ /** The shortcut platform the browser reports; `other` where there is no navigator. */
4
+ export declare function detectShortcutPlatform(): ShortcutPlatform;
5
+ /**
6
+ * The shortcut platform for an application identity. An explicit `shortcutPlatform`
7
+ * wins; a `platform` label that names an Apple OS keeps its earlier meaning; any other
8
+ * label (`desktop`, `web`, a product name) defers to the browser.
9
+ */
10
+ export declare function resolveShortcutPlatform(identity: {
11
+ platform?: string;
12
+ shortcutPlatform?: ShortcutPlatform;
13
+ }): ShortcutPlatform;
14
+ /** The modifier glyph drawn for a shortcut platform. */
15
+ export declare function shortcutModifierKey(platform: ShortcutPlatform): '⌘' | 'Ctrl';
16
+ /** The settings chord as a menu row draws it: `⌘,` or `Ctrl+,`. */
17
+ export declare function settingsShortcutLabel(platform: ShortcutPlatform): string;
@@ -0,0 +1,25 @@
1
+ // src/shell/shortcut-platform.ts
2
+ var applePlatform = /Mac|iPhone|iPad|iPod/i;
3
+ /** The shortcut platform the browser reports; `other` where there is no navigator. */
4
+ function detectShortcutPlatform() {
5
+ return typeof navigator !== "undefined" && applePlatform.test(navigator.platform) ? "mac" : "other";
6
+ }
7
+ /**
8
+ * The shortcut platform for an application identity. An explicit `shortcutPlatform`
9
+ * wins; a `platform` label that names an Apple OS keeps its earlier meaning; any other
10
+ * label (`desktop`, `web`, a product name) defers to the browser.
11
+ */
12
+ function resolveShortcutPlatform(identity) {
13
+ if (identity.shortcutPlatform) return identity.shortcutPlatform;
14
+ if (identity.platform && applePlatform.test(identity.platform)) return "mac";
15
+ return detectShortcutPlatform();
16
+ }
17
+ /** The modifier glyph drawn for a shortcut platform. */
18
+ function shortcutModifierKey(platform) {
19
+ return platform === "mac" ? "⌘" : "Ctrl";
20
+ }
21
+ /** The settings chord as a menu row draws it: `⌘,` or `Ctrl+,`. */
22
+ function settingsShortcutLabel(platform) {
23
+ return platform === "mac" ? "⌘," : "Ctrl+,";
24
+ }
25
+ export { detectShortcutPlatform, resolveShortcutPlatform, settingsShortcutLabel, shortcutModifierKey };
@@ -0,0 +1,260 @@
1
+ // @bun
2
+ // src/updates/update-helper.ts
3
+ import { constants, writeFileSync } from "fs";
4
+ import { lstat, open, writeFile } from "fs/promises";
5
+ import { isAbsolute as isAbsolute5, join as join3, resolve as resolve4 } from "path";
6
+
7
+ // src/updates/update-launch.ts
8
+ import { spawn } from "child_process";
9
+ import { dirname, isAbsolute, join, resolve } from "path";
10
+ function updateLauncherPath(platform, target) {
11
+ if (typeof target !== "string" || !isAbsolute(target) || resolve(target) !== target)
12
+ throw new Error("Invalid update target");
13
+ if (platform === "macos-arm64")
14
+ return join(target, "Contents", "MacOS", "launcher");
15
+ if (platform === "windows-x64")
16
+ return join(target, "bin", "launcher.exe");
17
+ if (platform === "linux-x64")
18
+ return join(target, "bin", "launcher");
19
+ throw new Error("Unsupported update platform");
20
+ }
21
+ async function launchInstalledApp(platform, target, env = process.env) {
22
+ const executable = updateLauncherPath(platform, target);
23
+ const child = spawn(executable, [], {
24
+ cwd: dirname(executable),
25
+ detached: true,
26
+ stdio: "ignore",
27
+ env
28
+ });
29
+ await new Promise((done, reject) => {
30
+ child.once("spawn", done);
31
+ child.once("error", reject);
32
+ });
33
+ child.unref();
34
+ }
35
+
36
+ // src/updates/update-process-fence.ts
37
+ import { execFile } from "child_process";
38
+ import { dlopen, FFIType, ptr } from "bun:ffi";
39
+ import { realpath } from "fs/promises";
40
+ import { isAbsolute as isAbsolute2 } from "path";
41
+ import { promisify } from "util";
42
+ var execute = promisify(execFile);
43
+ function isProcessRunning(pid) {
44
+ try {
45
+ process.kill(pid, 0);
46
+ return true;
47
+ } catch (error) {
48
+ if (error.code === "ESRCH")
49
+ return false;
50
+ throw new Error("Cannot inspect update process", { cause: error });
51
+ }
52
+ }
53
+ async function waitForUpdateProcesses(options) {
54
+ if (!Array.isArray(options.processes) || options.processes.length < 1 || options.processes.length > 16 || !Number.isSafeInteger(options.timeoutMs) || options.timeoutMs < 1 || options.timeoutMs > 120000)
55
+ throw new Error("Invalid update process fence");
56
+ const seen = new Set, env = {};
57
+ const deadline = Date.now() + options.timeoutMs;
58
+ for (const key of ["PATH", "SystemRoot", "WINDIR", "TMP", "TEMP", "TMPDIR", "LANG", "LC_ALL"])
59
+ if ((options.env ?? process.env)[key])
60
+ env[key] = (options.env ?? process.env)[key];
61
+ async function executable(pid) {
62
+ if (process.platform === "linux")
63
+ return realpath(`/proc/${pid}/exe`);
64
+ if (process.platform === "darwin")
65
+ return realpath((await execute("/bin/ps", ["-p", String(pid), "-o", "comm="], {
66
+ env,
67
+ timeout: Math.max(1, Math.min(5000, deadline - Date.now())),
68
+ maxBuffer: 16384
69
+ })).stdout.trim());
70
+ if (process.platform === "win32") {
71
+ const library = dlopen("kernel32.dll", {
72
+ OpenProcess: { args: [FFIType.u32, FFIType.i32, FFIType.u32], returns: FFIType.ptr },
73
+ QueryFullProcessImageNameW: {
74
+ args: [FFIType.ptr, FFIType.u32, FFIType.ptr, FFIType.ptr],
75
+ returns: FFIType.i32
76
+ },
77
+ CloseHandle: { args: [FFIType.ptr], returns: FFIType.i32 }
78
+ });
79
+ try {
80
+ const handle = library.symbols.OpenProcess(4096, 0, pid);
81
+ if (!handle)
82
+ throw new Error("Cannot open update process");
83
+ try {
84
+ const buffer = Buffer.alloc(32768 * 2), length = Buffer.alloc(4);
85
+ length.writeUInt32LE(32768);
86
+ if (!library.symbols.QueryFullProcessImageNameW(handle, 0, ptr(buffer), ptr(length)))
87
+ throw new Error("Cannot inspect update process");
88
+ const count = length.readUInt32LE();
89
+ if (!count || count >= 32768)
90
+ throw new Error("Invalid update process path");
91
+ return await realpath(buffer.subarray(0, count * 2).toString("utf16le"));
92
+ } finally {
93
+ library.symbols.CloseHandle(handle);
94
+ }
95
+ } finally {
96
+ library.close();
97
+ }
98
+ }
99
+ throw new Error("Unsupported update process platform");
100
+ }
101
+ const waiting = new Set;
102
+ for (const processInfo of options.processes) {
103
+ if (!processInfo || !Number.isSafeInteger(processInfo.pid) || processInfo.pid < 2 || processInfo.pid > 4294967295 || processInfo.pid === process.pid || seen.has(processInfo.pid) || typeof processInfo.executable !== "string" || !isAbsolute2(processInfo.executable))
104
+ throw new Error("Invalid update process identity");
105
+ if (Date.now() >= deadline)
106
+ throw new Error("Update process fence timed out");
107
+ seen.add(processInfo.pid);
108
+ if (!isProcessRunning(processInfo.pid))
109
+ throw new Error("Update process exited before verification");
110
+ let actual;
111
+ try {
112
+ actual = await executable(processInfo.pid);
113
+ } catch {
114
+ throw new Error("Cannot verify update process");
115
+ }
116
+ const expected = await realpath(processInfo.executable);
117
+ if (process.platform === "win32" ? actual.toLowerCase() !== expected.toLowerCase() : actual !== expected)
118
+ throw new Error("Update process executable mismatch");
119
+ waiting.add(processInfo.pid);
120
+ }
121
+ if (Date.now() >= deadline)
122
+ throw new Error("Update process fence timed out");
123
+ for (const pid of waiting)
124
+ if (!isProcessRunning(pid))
125
+ throw new Error("Update process exited before verification");
126
+ const notified = options.onVerified?.();
127
+ if (typeof notified === "object" && notified !== null && "then" in notified)
128
+ throw new Error("Update process acknowledgement must be synchronous");
129
+ while (waiting.size) {
130
+ for (const pid of waiting)
131
+ if (!isProcessRunning(pid))
132
+ waiting.delete(pid);
133
+ if (!waiting.size)
134
+ return;
135
+ if (Date.now() >= deadline)
136
+ throw new Error("Update processes did not exit");
137
+ await Bun.sleep(Math.min(100, Math.max(1, deadline - Date.now())));
138
+ }
139
+ }
140
+
141
+ // src/updates/update-swap.ts
142
+ import { rm } from "fs/promises";
143
+ import { basename, dirname as dirname2, isAbsolute as isAbsolute4, join as join2, resolve as resolve3 } from "path";
144
+
145
+ // src/updates/update-exclusive-rename.ts
146
+ import { dlopen as dlopen2, FFIType as FFIType2, ptr as ptr2 } from "bun:ffi";
147
+ import { isAbsolute as isAbsolute3, resolve as resolve2 } from "path";
148
+ function renameUpdateExclusive(source, destination) {
149
+ if (typeof source !== "string" || typeof destination !== "string" || !isAbsolute3(source) || !isAbsolute3(destination) || resolve2(source) !== source || resolve2(destination) !== destination || source === destination || source.includes("\x00") || destination.includes("\x00"))
150
+ throw new Error("Invalid exclusive rename paths");
151
+ if (process.platform === "darwin") {
152
+ const library = dlopen2("libSystem.B.dylib", {
153
+ renamex_np: { args: [FFIType2.ptr, FFIType2.ptr, FFIType2.u32], returns: FFIType2.i32 }
154
+ });
155
+ try {
156
+ const from = Buffer.from(source + "\x00"), to = Buffer.from(destination + "\x00");
157
+ if (library.symbols.renamex_np(ptr2(from), ptr2(to), 4) !== 0)
158
+ throw new Error("Exclusive rename failed");
159
+ } finally {
160
+ library.close();
161
+ }
162
+ } else if (process.platform === "linux") {
163
+ const library = dlopen2("libc.so.6", {
164
+ renameat2: {
165
+ args: [FFIType2.i32, FFIType2.ptr, FFIType2.i32, FFIType2.ptr, FFIType2.u32],
166
+ returns: FFIType2.i32
167
+ }
168
+ });
169
+ try {
170
+ const from = Buffer.from(source + "\x00"), to = Buffer.from(destination + "\x00");
171
+ if (library.symbols.renameat2(-100, ptr2(from), -100, ptr2(to), 1) !== 0)
172
+ throw new Error("Exclusive rename failed");
173
+ } finally {
174
+ library.close();
175
+ }
176
+ } else if (process.platform === "win32") {
177
+ const library = dlopen2("kernel32.dll", {
178
+ MoveFileW: { args: [FFIType2.ptr, FFIType2.ptr], returns: FFIType2.i32 }
179
+ });
180
+ try {
181
+ const from = Buffer.from(source + "\x00", "utf16le"), to = Buffer.from(destination + "\x00", "utf16le");
182
+ if (library.symbols.MoveFileW(ptr2(from), ptr2(to)) === 0)
183
+ throw new Error("Exclusive rename failed");
184
+ } finally {
185
+ library.close();
186
+ }
187
+ } else
188
+ throw new Error("Unsupported exclusive rename platform");
189
+ }
190
+
191
+ // src/updates/update-swap.ts
192
+ function updateStagingFor(target) {
193
+ if (typeof target !== "string" || !isAbsolute4(target) || resolve3(target) !== target)
194
+ throw new Error("Invalid update target");
195
+ return join2(dirname2(target), `.${basename(target)}.framework-update`);
196
+ }
197
+ async function swapUpdateTree(options) {
198
+ const { target, staging } = options;
199
+ if (dirname2(staging) !== dirname2(target) || staging === target)
200
+ throw new Error("Invalid update swap context");
201
+ const old = join2(staging, "old");
202
+ renameUpdateExclusive(target, old);
203
+ try {
204
+ renameUpdateExclusive(join2(staging, "candidate"), target);
205
+ } catch (error) {
206
+ renameUpdateExclusive(old, target);
207
+ throw error;
208
+ }
209
+ await rm(old, { recursive: true, force: true });
210
+ }
211
+
212
+ // src/updates/update-helper.ts
213
+ function parseUpdateHelperRequest(value) {
214
+ const data = value;
215
+ if (typeof value !== "object" || value === null || Array.isArray(value) || data.schema !== 1 || typeof data.target !== "string" || !isAbsolute5(data.target) || resolve4(data.target) !== data.target || !["macos-arm64", "windows-x64", "linux-x64"].includes(data.platform) || typeof data.version !== "string" || !/^\d+\.\d+\.\d+(?:-dev\.\d+)?$/.test(data.version) || !Array.isArray(data.processes) || !Number.isSafeInteger(data.processTimeoutMs) || data.processTimeoutMs < 1 || data.processTimeoutMs > 120000)
216
+ throw new Error("Invalid update helper request");
217
+ return Object.freeze(data);
218
+ }
219
+ async function readRequest(staging) {
220
+ const path = join3(staging, "request.json"), info = await lstat(path);
221
+ if (!info.isFile() || info.size < 1 || info.size > 65536)
222
+ throw new Error("Invalid update helper request");
223
+ const file = await open(path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
224
+ try {
225
+ return parseUpdateHelperRequest(JSON.parse(await file.readFile("utf8")));
226
+ } finally {
227
+ await file.close();
228
+ }
229
+ }
230
+ async function runUpdateHelper(options) {
231
+ const request = await readRequest(options.staging);
232
+ if (updateStagingFor(request.target) !== options.staging)
233
+ throw new Error("Update helper request does not match its staging directory");
234
+ await waitForUpdateProcesses({
235
+ processes: request.processes,
236
+ timeoutMs: request.processTimeoutMs,
237
+ onVerified: () => writeFileSync(join3(options.staging, "helper-armed"), String(process.pid), {
238
+ flag: "wx",
239
+ mode: 384
240
+ })
241
+ });
242
+ let outcome = "failed";
243
+ try {
244
+ await swapUpdateTree({ target: request.target, staging: options.staging });
245
+ await writeFile(join3(options.staging, "updated"), request.version, { mode: 384 });
246
+ outcome = "updated";
247
+ } catch {}
248
+ await launchInstalledApp(request.platform, request.target, options.env);
249
+ return outcome;
250
+ }
251
+
252
+ // src/cli/update-helper-cli.ts
253
+ var index = process.argv.indexOf("--staging");
254
+ var staging = index > 0 ? process.argv[index + 1] : undefined;
255
+ if (!staging) {
256
+ console.error("Usage: update-helper --staging <directory>");
257
+ process.exit(2);
258
+ }
259
+ var outcome = await runUpdateHelper({ staging }).catch(() => "failed");
260
+ process.exit(outcome === "updated" ? 0 : 1);
@@ -0,0 +1,46 @@
1
+ import { createUpdateManager } from './update-manager';
2
+ import { type UpdateChannel } from './release-version';
3
+ import type { ReleaseTrust } from './signed-release';
4
+ import type { FetchFunction } from './release-location';
5
+ type ManagerOptions = Parameters<typeof createUpdateManager>[0];
6
+ /** Re-read the persisted channel for every check and bind an approval to that choice. */
7
+ export declare function createChannelUpdateManager(options: {
8
+ store: {
9
+ read(): Promise<UpdateChannel>;
10
+ save(channel: UpdateChannel): Promise<UpdateChannel>;
11
+ };
12
+ trust: Omit<ReleaseTrust, 'channel'>;
13
+ discoveryNames: Record<UpdateChannel, string>;
14
+ currentVersion: string;
15
+ directory: string;
16
+ maxBytes: number;
17
+ stage: ManagerOptions['stage'];
18
+ discover?: ManagerOptions['discover'];
19
+ download?: ManagerOptions['download'];
20
+ fetch?: FetchFunction;
21
+ }): {
22
+ status: () => Readonly<{
23
+ phase: "available" | "checking" | "current" | "downloading" | "failed" | "idle" | "staged" | "staging";
24
+ currentVersion: string;
25
+ availableVersion: string | null;
26
+ error: string | null;
27
+ }>;
28
+ readChannel: () => Promise<UpdateChannel>;
29
+ saveChannel(channel: UpdateChannel): Promise<UpdateChannel>;
30
+ check(): Promise<Readonly<{
31
+ phase: "available" | "checking" | "current" | "downloading" | "failed" | "idle" | "staged" | "staging";
32
+ currentVersion: string;
33
+ availableVersion: string | null;
34
+ error: string | null;
35
+ }>>;
36
+ install(input: {
37
+ approved: boolean;
38
+ expectedVersion: string;
39
+ }): Promise<Readonly<{
40
+ phase: "available" | "checking" | "current" | "downloading" | "failed" | "idle" | "staged" | "staging";
41
+ currentVersion: string;
42
+ availableVersion: string | null;
43
+ error: string | null;
44
+ }>>;
45
+ };
46
+ export {};
@@ -0,0 +1,114 @@
1
+ import { isUpdateChannel } from "./release-version.js";
2
+ import { createUpdateManager } from "./update-manager.js";
3
+ import { releaseChannelForUpdate } from "./update-channel-store.js";
4
+ // src/updates/channel-update-manager.ts
5
+ /** Re-read the persisted channel for every check and bind an approval to that choice. */
6
+ function createChannelUpdateManager(options) {
7
+ let busy = false, active;
8
+ let state = Object.freeze({
9
+ phase: "idle",
10
+ currentVersion: options.currentVersion,
11
+ availableVersion: null,
12
+ error: null
13
+ });
14
+ const acquire = () => {
15
+ if (busy) throw new Error("Update manager is busy");
16
+ busy = true;
17
+ };
18
+ const idle = () => state = Object.freeze({
19
+ phase: "idle",
20
+ currentVersion: options.currentVersion,
21
+ availableVersion: null,
22
+ error: null
23
+ });
24
+ const failed = () => state = Object.freeze({
25
+ phase: "failed",
26
+ currentVersion: options.currentVersion,
27
+ availableVersion: null,
28
+ error: "Update check failed. Please try again."
29
+ });
30
+ const status = () => active?.manager.status() ?? state;
31
+ return {
32
+ status,
33
+ readChannel: () => options.store.read(),
34
+ async saveChannel(channel) {
35
+ if (!isUpdateChannel(channel)) throw new Error("Invalid update channel");
36
+ acquire();
37
+ try {
38
+ if (status().phase === "staged") throw new Error("An update is already staged");
39
+ const saved = await options.store.save(channel);
40
+ if (saved !== channel) throw new Error("Update channel was not saved");
41
+ active = void 0;
42
+ idle();
43
+ return saved;
44
+ } finally {
45
+ busy = false;
46
+ }
47
+ },
48
+ async check() {
49
+ acquire();
50
+ try {
51
+ if (status().phase === "staged") throw new Error("An update is already staged");
52
+ active = void 0;
53
+ state = Object.freeze({
54
+ phase: "checking",
55
+ currentVersion: options.currentVersion,
56
+ availableVersion: null,
57
+ error: null
58
+ });
59
+ try {
60
+ const channel = await options.store.read();
61
+ if (!isUpdateChannel(channel)) throw new Error("Invalid update channel");
62
+ const manager = createUpdateManager({
63
+ currentVersion: options.currentVersion,
64
+ trust: {
65
+ ...options.trust,
66
+ channel: releaseChannelForUpdate(channel)
67
+ },
68
+ discoveryName: options.discoveryNames[channel],
69
+ directory: options.directory,
70
+ maxBytes: options.maxBytes,
71
+ discover: options.discover,
72
+ download: options.download,
73
+ fetch: options.fetch,
74
+ stage: async (input) => {
75
+ if (await options.store.read() !== channel) throw new Error("Update channel changed");
76
+ await options.stage(input);
77
+ if (await options.store.read() !== channel) throw new Error("Update channel changed");
78
+ }
79
+ });
80
+ active = {
81
+ channel,
82
+ manager
83
+ };
84
+ state = await manager.check();
85
+ if (await options.store.read() !== channel) {
86
+ active = void 0;
87
+ return failed();
88
+ }
89
+ return state;
90
+ } catch {
91
+ active = void 0;
92
+ return failed();
93
+ }
94
+ } finally {
95
+ busy = false;
96
+ }
97
+ },
98
+ async install(input) {
99
+ acquire();
100
+ try {
101
+ if (!active || await options.store.read() !== active.channel) {
102
+ active = void 0;
103
+ idle();
104
+ throw new Error("Update channel changed");
105
+ }
106
+ state = await active.manager.install(input);
107
+ return state;
108
+ } finally {
109
+ busy = false;
110
+ }
111
+ }
112
+ };
113
+ }
114
+ export { createChannelUpdateManager };
@@ -0,0 +1,104 @@
1
+ import { type createServiceRegistry } from '../app/service-registry';
2
+ import type { InstallerPlatform, InstallerRenderer } from '../installer/installer-layout';
3
+ import { createChannelUpdateManager } from './channel-update-manager';
4
+ import { type UpdateChannel } from './release-version';
5
+ import type { ReleaseTrust } from './signed-release';
6
+ import type { UpdateState } from './update-adapter';
7
+ import type { NativeUpdateState } from './update-state';
8
+ export type DesktopUpdatePhase = UpdateState['phase'];
9
+ /** The snapshot every update service returns. */
10
+ export type DesktopUpdateStatus = NativeUpdateState<DesktopUpdatePhase>;
11
+ type Manager = Pick<ReturnType<typeof createChannelUpdateManager>, 'status' | 'readChannel' | 'saveChannel' | 'check' | 'install'>;
12
+ /** The release identity an app's release-config.json declares. */
13
+ export type DesktopRelease = {
14
+ appId: string;
15
+ appName: string;
16
+ releaseSigningKeys: Readonly<Record<string, string>>;
17
+ /** Where releases are published: `{ base: 'https://adea.dev/releases/', app: 'adea' }`. */
18
+ releaseFeed: Readonly<{
19
+ base: string;
20
+ app: string;
21
+ }>;
22
+ sidecars?: readonly string[];
23
+ };
24
+ /** The release platform this host runs on, or null where framework apps ship no build. */
25
+ export declare function updatePlatform(platform?: string, arch?: string): InstallerPlatform | null;
26
+ /**
27
+ * The installed app tree the swap replaces: the `.app` bundle on macOS, the
28
+ * app directory elsewhere. The host entry runs from `Resources/app/bun`.
29
+ */
30
+ export declare function installTarget(entryDirectory: string, platform: InstallerPlatform): string;
31
+ /** Each channel's signed descriptor for `platform`, as the release workflows publish them. */
32
+ export declare function discoveryNames(platform: InstallerPlatform): Record<UpdateChannel, string>;
33
+ /**
34
+ * What a descriptor must match: this app, repository and platform, signed by a
35
+ * configured key. Null until a key is configured, so such a build reports
36
+ * updates as unavailable instead of failing.
37
+ */
38
+ export declare function updateTrust(platform: InstallerPlatform, identity: {
39
+ appId: string;
40
+ repository: string;
41
+ feed: string;
42
+ keys: Readonly<Record<string, string>>;
43
+ }): Omit<ReleaseTrust, 'channel'> | null;
44
+ export type UpdateInstallRequest = {
45
+ expectedVersion: string;
46
+ approved: boolean;
47
+ restart?: boolean;
48
+ };
49
+ export type UpdaterOptions = {
50
+ appName: string;
51
+ repository: string;
52
+ currentVersion: string;
53
+ changelog?: string;
54
+ /** Null where updates cannot apply: an unsupported platform or no trusted key. */
55
+ manager: Manager | null;
56
+ /** A status read while idle starts the one check, so a badge needs no second checker. */
57
+ checkWhenIdle?: boolean;
58
+ /** Hand off to the post-exit helper and quit, after a staged install the user asked to restart. */
59
+ restart(version: string): Promise<void>;
60
+ /** Aborts the download in flight. */
61
+ abortDownload?(): void;
62
+ };
63
+ /** The update commands over a framework channel update manager. */
64
+ export declare function createUpdater(options: UpdaterOptions): {
65
+ status(): Promise<DesktopUpdateStatus>;
66
+ check: () => Promise<DesktopUpdateStatus>;
67
+ channel(): Promise<UpdateChannel>;
68
+ saveChannel(channel: UpdateChannel): Promise<UpdateChannel>;
69
+ install(request: UpdateInstallRequest): Promise<DesktopUpdateStatus>;
70
+ cancel(): Promise<DesktopUpdateStatus>;
71
+ };
72
+ export type DesktopUpdater = ReturnType<typeof createUpdater>;
73
+ /**
74
+ * The updater for the packaged app at `entryDirectory`. Clears downloads left
75
+ * by an earlier run and reports what an earlier helper did.
76
+ */
77
+ export declare function createDesktopUpdater(options: {
78
+ release: DesktopRelease;
79
+ repository: string;
80
+ renderer: InstallerRenderer;
81
+ entryDirectory: string;
82
+ dataDirectory: string;
83
+ /** Where the chosen channel is kept; the data directory unless given. */
84
+ stateDirectory?: string;
85
+ currentVersion: string;
86
+ changelog?: string;
87
+ /** The shipped update helper, relative to `Resources/app`. */
88
+ helperScript: string;
89
+ checkWhenIdle?: boolean;
90
+ quit(): void;
91
+ log(line: string): void;
92
+ }): Promise<DesktopUpdater>;
93
+ type Services<Principal> = ReturnType<typeof createServiceRegistry<Principal>>;
94
+ /** The `desktop_update_channel_save` argument. */
95
+ export declare function parseUpdateChannel(value: unknown): UpdateChannel;
96
+ /** The `desktop_update_install` argument. */
97
+ export declare function parseUpdateInstall(value: unknown): UpdateInstallRequest;
98
+ /** Register the `desktop_update_*` services the web client's update adapter calls. */
99
+ export declare function registerUpdateServices<Principal>(options: {
100
+ services: Services<Principal>;
101
+ updater: DesktopUpdater;
102
+ authorize(principal: Principal): boolean;
103
+ }): () => void;
104
+ export {};