@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,231 @@
1
+ import { createChannelProofVerifier } from "./channel-proof.js";
2
+ // src/desktop/desktop-stream.ts
3
+ function payloadSize(payload) {
4
+ return typeof payload === "string" ? new TextEncoder().encode(payload).byteLength : payload.byteLength;
5
+ }
6
+ /** Application-owned stream authorization and lifecycle, independent of the socket implementation. */
7
+ function createDesktopStreams(options) {
8
+ const now = options.now ?? Date.now;
9
+ const timeout = options.handshakeTimeoutMs ?? 5e3;
10
+ const limit = options.maxConnections ?? 32;
11
+ const maxFrameBytes = options.maxFrameBytes ?? 262144;
12
+ if (![
13
+ timeout,
14
+ limit,
15
+ maxFrameBytes
16
+ ].every((value) => Number.isSafeInteger(value) && value > 0)) throw new Error("Invalid stream limits");
17
+ const verifier = createChannelProofVerifier({
18
+ resolve: options.authority.resolve,
19
+ now,
20
+ context: "framework-stream-attach-v1",
21
+ maxBodyBytes: 4096
22
+ });
23
+ const providers = /* @__PURE__ */ new Map();
24
+ const connections = /* @__PURE__ */ new Set();
25
+ const unsubscribe = options.authority.onRevoke((identity) => {
26
+ for (const connection of connections) if (connection.identity?.channelId === identity.channelId && connection.identity.credentialId === identity.credentialId) connection.close();
27
+ });
28
+ let stopped = false;
29
+ return {
30
+ register(name, provider) {
31
+ if (stopped || !/^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/.test(name) || name.length > 128 || providers.has(name) || typeof provider.parse !== "function" || typeof provider.authorize !== "function" || typeof provider.open !== "function") throw new Error("Invalid stream provider");
32
+ providers.set(name, provider);
33
+ return () => {
34
+ if (providers.get(name) !== provider) return;
35
+ providers.delete(name);
36
+ for (const connection of connections) if (connection.provider === provider) connection.close();
37
+ };
38
+ },
39
+ accept(socket) {
40
+ if (stopped || connections.size >= limit) {
41
+ socket.close();
42
+ return;
43
+ }
44
+ let closed = false, identity, principal, handler, phase = "attach", busy = false;
45
+ let queue = Promise.resolve(), queuedBytes = 0, queuedCount = 0;
46
+ const outbound = [];
47
+ let outboundBytes = 0;
48
+ const abort = new AbortController();
49
+ let expiry;
50
+ const current = () => {
51
+ if (closed || !identity) return false;
52
+ const channel = options.authority.resolve(identity);
53
+ return !!channel && channel.expiresAt > now() && Object.is(channel.principal, principal);
54
+ };
55
+ const close = () => {
56
+ if (closed) return;
57
+ closed = true;
58
+ clearTimeout(timer);
59
+ if (expiry) clearTimeout(expiry);
60
+ connections.delete(connection);
61
+ abort.abort();
62
+ try {
63
+ handler?.close();
64
+ } catch {}
65
+ try {
66
+ socket.close();
67
+ } catch {}
68
+ };
69
+ const connection = { close };
70
+ const timer = setTimeout(close, timeout);
71
+ connections.add(connection);
72
+ const send = (payload) => {
73
+ if (!current() || typeof payload !== "string" && !(payload instanceof Uint8Array) || payloadSize(payload) > maxFrameBytes) {
74
+ close();
75
+ return false;
76
+ }
77
+ if (phase === "opening") {
78
+ if (outbound.length >= 64 || outboundBytes + payloadSize(payload) > 1048576) {
79
+ close();
80
+ return false;
81
+ }
82
+ const copy = typeof payload === "string" ? payload : Uint8Array.from(payload);
83
+ outbound.push(copy);
84
+ outboundBytes += payloadSize(copy);
85
+ return true;
86
+ }
87
+ if (phase !== "open") {
88
+ close();
89
+ return false;
90
+ }
91
+ try {
92
+ if (socket.send(payload) === true) return true;
93
+ } catch {}
94
+ close();
95
+ return false;
96
+ };
97
+ return {
98
+ close,
99
+ async receive(payload) {
100
+ if (closed) return;
101
+ if (phase === "open") {
102
+ if (typeof payload !== "string" && !(payload instanceof Uint8Array) || payloadSize(payload) > maxFrameBytes || queuedCount >= 64 || queuedBytes + payloadSize(payload) > 1048576) {
103
+ close();
104
+ return;
105
+ }
106
+ const copy = typeof payload === "string" ? payload : Uint8Array.from(payload);
107
+ const bytes = payloadSize(copy);
108
+ queuedCount++;
109
+ queuedBytes += bytes;
110
+ const task = queue.then(async () => {
111
+ if (!current()) {
112
+ close();
113
+ return;
114
+ }
115
+ await handler.receive(copy);
116
+ }).catch(() => {
117
+ close();
118
+ }).finally(() => {
119
+ queuedCount--;
120
+ queuedBytes -= bytes;
121
+ });
122
+ queue = task;
123
+ await task;
124
+ return;
125
+ }
126
+ if (typeof payload !== "string" && !(payload instanceof Uint8Array) || payloadSize(payload) > (phase === "attach" ? 8192 : maxFrameBytes) || busy) {
127
+ close();
128
+ return;
129
+ }
130
+ busy = true;
131
+ try {
132
+ if (phase === "attach") {
133
+ if (typeof payload !== "string") {
134
+ close();
135
+ return;
136
+ }
137
+ let request;
138
+ try {
139
+ request = JSON.parse(payload);
140
+ } catch {
141
+ close();
142
+ return;
143
+ }
144
+ const result = verifier.verify(request);
145
+ if (!result.ok) {
146
+ close();
147
+ return;
148
+ }
149
+ let input;
150
+ try {
151
+ input = JSON.parse(request.body);
152
+ } catch {
153
+ close();
154
+ return;
155
+ }
156
+ if (!input || typeof input !== "object" || Array.isArray(input) || typeof input.name !== "string") {
157
+ close();
158
+ return;
159
+ }
160
+ const provider = providers.get(input.name);
161
+ if (!provider) {
162
+ close();
163
+ return;
164
+ }
165
+ connection.provider = provider;
166
+ let parsed;
167
+ try {
168
+ parsed = provider.parse(input.input);
169
+ } catch {
170
+ close();
171
+ return;
172
+ }
173
+ identity = {
174
+ channelId: request.channelId,
175
+ credentialId: request.credentialId
176
+ };
177
+ connection.identity = identity;
178
+ principal = result.principal;
179
+ phase = "opening";
180
+ if (!current() || await provider.authorize(result.principal, parsed) !== true || !current() || providers.get(input.name) !== provider) {
181
+ close();
182
+ return;
183
+ }
184
+ const channel = options.authority.resolve(identity);
185
+ if (!channel) {
186
+ close();
187
+ return;
188
+ }
189
+ expiry = setTimeout(close, Math.min(channel.expiresAt - now(), 2147483647));
190
+ const opened = await provider.open(result.principal, parsed, {
191
+ signal: abort.signal,
192
+ send,
193
+ current,
194
+ close
195
+ });
196
+ if (!opened || typeof opened.receive !== "function" || typeof opened.close !== "function") {
197
+ close();
198
+ return;
199
+ }
200
+ if (!current()) {
201
+ try {
202
+ opened.close();
203
+ } catch {}
204
+ close();
205
+ return;
206
+ }
207
+ handler = opened;
208
+ phase = "open";
209
+ clearTimeout(timer);
210
+ if (!send(JSON.stringify({ ok: true }))) return;
211
+ for (const value of outbound.splice(0)) if (!send(value)) return;
212
+ outboundBytes = 0;
213
+ } else close();
214
+ } catch {
215
+ close();
216
+ } finally {
217
+ busy = false;
218
+ }
219
+ }
220
+ };
221
+ },
222
+ stop() {
223
+ if (stopped) return;
224
+ stopped = true;
225
+ unsubscribe();
226
+ for (const connection of connections) connection.close();
227
+ providers.clear();
228
+ }
229
+ };
230
+ }
231
+ export { createDesktopStreams };
@@ -0,0 +1,19 @@
1
+ /** Origin screening adapted from adea-ai/adea channel/loopback.ts and shell boot,
2
+ * commit 6155d18941acbb14d9099bc2a33a50ee9683a068 (Apache-2.0).
3
+ * Headers are not authentication: a local process can forge all of them.
4
+ * Never disclose credentials or dispatch privileged commands on this basis alone. */
5
+ export type LoopbackPolicy = Readonly<{
6
+ origin: string;
7
+ host: string;
8
+ }>;
9
+ export type RequestMetadata = Readonly<{
10
+ host?: string | null;
11
+ origin?: string | null;
12
+ secFetchSite?: string | null;
13
+ secFetchDest?: string | null;
14
+ }>;
15
+ export declare function createLoopbackPolicy(origin: string): LoopbackPolicy;
16
+ /** Screen out foreign Host, Origin and browser fetch-site metadata before authentication. */
17
+ export declare function matchesLoopbackOrigin(request: RequestMetadata, policy: LoopbackPolicy): boolean;
18
+ /** Classify document requests for rendering only; this is not proof of a trusted window. */
19
+ export declare function isDocumentNavigationRequest(request: RequestMetadata, policy: LoopbackPolicy): boolean;
@@ -0,0 +1,23 @@
1
+ // src/desktop/loopback-policy.ts
2
+ function createLoopbackPolicy(origin) {
3
+ const match = /^http:\/\/127\.0\.0\.1:([1-9][0-9]{0,4})\/?$/.exec(origin);
4
+ if (!match || Number(match[1]) === 80 || Number(match[1]) > 65535) throw new Error("Invalid loopback origin");
5
+ const host = `127.0.0.1:${match[1]}`;
6
+ return Object.freeze({
7
+ origin: `http://${host}`,
8
+ host
9
+ });
10
+ }
11
+ /** Screen out foreign Host, Origin and browser fetch-site metadata before authentication. */
12
+ function matchesLoopbackOrigin(request, policy) {
13
+ if (request.host !== policy.host) return false;
14
+ if (request.secFetchSite && !["same-origin", "none"].includes(request.secFetchSite)) return false;
15
+ if (request.origin === policy.origin) return true;
16
+ if (request.origin !== null && request.origin !== void 0) return false;
17
+ return request.secFetchSite === "same-origin";
18
+ }
19
+ /** Classify document requests for rendering only; this is not proof of a trusted window. */
20
+ function isDocumentNavigationRequest(request, policy) {
21
+ return request.host === policy.host && request.secFetchDest === "document" && (request.secFetchSite === "none" || request.secFetchSite === "same-origin") && (request.origin === void 0 || request.origin === null || request.origin === policy.origin);
22
+ }
23
+ export { createLoopbackPolicy, isDocumentNavigationRequest, matchesLoopbackOrigin };
@@ -0,0 +1,15 @@
1
+ /** A bounded queue for native open-url events received before app initialization.
2
+ * URL contents are untrusted; the receiver must validate targets and payloads.
3
+ * Async receivers start in event order but their completion is not serialized. */
4
+ export declare function createOpenUrlChannel(app: {
5
+ on(name: 'open-url', handler: (payload: {
6
+ url?: unknown;
7
+ }) => void): unknown;
8
+ }, options?: {
9
+ maxBuffered?: number;
10
+ maxLength?: number;
11
+ onError?: () => void | Promise<void>;
12
+ }): {
13
+ attach(next: (url: string) => void | Promise<void>): void;
14
+ dispose(): void;
15
+ };
@@ -0,0 +1,55 @@
1
+ // src/desktop/open-url-channel.ts
2
+ /** A bounded queue for native open-url events received before app initialization.
3
+ * URL contents are untrusted; the receiver must validate targets and payloads.
4
+ * Async receivers start in event order but their completion is not serialized. */
5
+ function createOpenUrlChannel(app, options = {}) {
6
+ const maxBuffered = options.maxBuffered ?? 8, maxLength = options.maxLength ?? 2048;
7
+ if (!app || typeof app.on !== "function" || !Number.isSafeInteger(maxBuffered) || maxBuffered < 1 || maxBuffered > 128 || !Number.isSafeInteger(maxLength) || maxLength < 1 || maxLength > 16384 || options.onError !== void 0 && typeof options.onError !== "function") throw new Error("Invalid open-url channel configuration");
8
+ const pending = [];
9
+ let receive, disposed = false, draining = false;
10
+ const reportError = () => {
11
+ try {
12
+ const result = options.onError?.();
13
+ if (result) Promise.resolve(result).catch(() => {});
14
+ } catch {}
15
+ };
16
+ const deliver = (url) => {
17
+ try {
18
+ const result = receive?.(url);
19
+ if (result) Promise.resolve(result).catch(reportError);
20
+ } catch {
21
+ reportError();
22
+ }
23
+ };
24
+ const unsubscribe = app.on("open-url", (payload) => {
25
+ if (disposed || typeof payload?.url !== "string" || !payload.url || payload.url.length > maxLength) return;
26
+ if (receive && !draining) {
27
+ deliver(payload.url);
28
+ return;
29
+ }
30
+ if (pending.length < maxBuffered) pending.push(payload.url);
31
+ });
32
+ return {
33
+ attach(next) {
34
+ if (disposed || receive || typeof next !== "function") throw new Error("Open-url receiver is unavailable");
35
+ receive = next;
36
+ draining = true;
37
+ try {
38
+ while (pending.length) {
39
+ if (disposed) break;
40
+ deliver(pending.shift());
41
+ }
42
+ } finally {
43
+ draining = false;
44
+ }
45
+ },
46
+ dispose() {
47
+ if (disposed) return;
48
+ disposed = true;
49
+ receive = void 0;
50
+ pending.length = 0;
51
+ if (typeof unsubscribe === "function") unsubscribe();
52
+ }
53
+ };
54
+ }
55
+ export { createOpenUrlChannel };
@@ -0,0 +1,2 @@
1
+ /** Return whether a value contains an ASCII control character. */
2
+ export declare function containsAsciiControl(value: string, includeSpace?: boolean): boolean;
@@ -0,0 +1,11 @@
1
+ // src/desktop/string-policy.ts
2
+ /** Return whether a value contains an ASCII control character. */
3
+ function containsAsciiControl(value, includeSpace = false) {
4
+ const maximum = includeSpace ? 32 : 31;
5
+ for (let index = 0; index < value.length; index++) {
6
+ const code = value.charCodeAt(index);
7
+ if (code <= maximum || code === 127) return true;
8
+ }
9
+ return false;
10
+ }
11
+ export { containsAsciiControl };
@@ -0,0 +1 @@
1
+ {"version":"0.24.0","commit":"c8c0113e93350252c7663325de13629da17dc923"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Normalize one tar entry path (no leading `./` or trailing `/`), or return undefined when it is
3
+ * absolute, escapes its root, holds control characters, or (with `fold`, for Windows) names a
4
+ * component Windows cannot hold.
5
+ */
6
+ export declare function safeArchivePath(path: string, fold: boolean): string | undefined;
@@ -0,0 +1,14 @@
1
+ import { containsAsciiControl } from "../desktop/string-policy.js";
2
+ // src/installer/archive-entry.ts
3
+ /**
4
+ * Normalize one tar entry path (no leading `./` or trailing `/`), or return undefined when it is
5
+ * absolute, escapes its root, holds control characters, or (with `fold`, for Windows) names a
6
+ * component Windows cannot hold.
7
+ */
8
+ function safeArchivePath(path, fold) {
9
+ const normalized = path.replace(/^\.\//, "").replace(/\/$/, "");
10
+ const parts = normalized.split("/");
11
+ if (!normalized || normalized.length > 4096 || normalized.startsWith("/") || /^[A-Za-z]:/.test(normalized) || normalized.includes("\\") || containsAsciiControl(normalized) || parts.some((part) => !part || part === "." || part === ".." || part.length > 255 || fold && (/[<>:"|?*]/.test(part) || /[. ]$/.test(part) || /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i.test(part)))) return void 0;
12
+ return normalized;
13
+ }
14
+ export { safeArchivePath };
@@ -0,0 +1,47 @@
1
+ import type { InstallerPlatform } from './installer-layout';
2
+ import type { CommandArtifactPolicy } from '../release/release-config';
3
+ /** The archive's one root directory: the asset name without `.tar.gz`. */
4
+ export declare function commandArtifactRoot(asset: string): string;
5
+ /** Pack the built payload directory into `archive` under its asset-named root. */
6
+ export declare function packCommandArtifact(options: {
7
+ source: string;
8
+ archive: string;
9
+ executable: string;
10
+ platform: InstallerPlatform;
11
+ }): Promise<void>;
12
+ /**
13
+ * Read a command artifact archive: every entry is a regular file or directory under the
14
+ * asset-named root, within bounds, and the launcher is present (executable off Windows). With
15
+ * `destination`, also extract it there.
16
+ */
17
+ export declare function readCommandArtifact(options: {
18
+ archive: string;
19
+ executable: string;
20
+ platform: InstallerPlatform;
21
+ destination?: string;
22
+ }): Promise<{
23
+ entries: number;
24
+ bytes: number;
25
+ }>;
26
+ /** The bounded result of qualifying one extracted command artifact. */
27
+ export type CommandQualification = {
28
+ installed: true;
29
+ versionMatched: true;
30
+ probesPassed: true;
31
+ serviceStarted: true;
32
+ serviceStopped: 'sigterm' | 'process-tree';
33
+ };
34
+ /**
35
+ * Extract the archive into a new private location with its own home and data directories, then
36
+ * run `--version` (it must print `version`), each probe (each must exit 0), and the service
37
+ * (it must stay up through a settle window, then stop on SIGTERM with exit 0; on Windows, where
38
+ * no signal reaches a console process, its process tree is terminated).
39
+ */
40
+ export declare function qualifyCommandArtifact(options: {
41
+ archive: string;
42
+ platform: InstallerPlatform;
43
+ policy: CommandArtifactPolicy;
44
+ version: string;
45
+ env: Record<string, string | undefined>;
46
+ settleMs?: number;
47
+ }): Promise<CommandQualification>;