@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,79 @@
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 function createOpenUrlChannel(
5
+ app: { on(name: 'open-url', handler: (payload: { url?: unknown }) => void): unknown },
6
+ options: { maxBuffered?: number; maxLength?: number; onError?: () => void | Promise<void> } = {}
7
+ ) {
8
+ const maxBuffered = options.maxBuffered ?? 8,
9
+ maxLength = options.maxLength ?? 2048
10
+ if (
11
+ !app ||
12
+ typeof app.on !== 'function' ||
13
+ !Number.isSafeInteger(maxBuffered) ||
14
+ maxBuffered < 1 ||
15
+ maxBuffered > 128 ||
16
+ !Number.isSafeInteger(maxLength) ||
17
+ maxLength < 1 ||
18
+ maxLength > 16384 ||
19
+ (options.onError !== undefined && typeof options.onError !== 'function')
20
+ )
21
+ throw new Error('Invalid open-url channel configuration')
22
+ const pending: string[] = []
23
+ let receive: ((url: string) => void | Promise<void>) | undefined,
24
+ disposed = false,
25
+ draining = false
26
+ const reportError = () => {
27
+ try {
28
+ const result = options.onError?.()
29
+ if (result) void Promise.resolve(result).catch(() => {})
30
+ } catch {
31
+ /* Do not let diagnostics interrupt native delivery. */
32
+ }
33
+ }
34
+ const deliver = (url: string) => {
35
+ try {
36
+ const result = receive?.(url)
37
+ if (result) void Promise.resolve(result).catch(reportError)
38
+ } catch {
39
+ reportError()
40
+ }
41
+ }
42
+ const unsubscribe = app.on('open-url', (payload) => {
43
+ if (
44
+ disposed ||
45
+ typeof payload?.url !== 'string' ||
46
+ !payload.url ||
47
+ payload.url.length > maxLength
48
+ )
49
+ return
50
+ if (receive && !draining) {
51
+ deliver(payload.url)
52
+ return
53
+ }
54
+ if (pending.length < maxBuffered) pending.push(payload.url)
55
+ })
56
+ return {
57
+ attach(next: (url: string) => void | Promise<void>) {
58
+ if (disposed || receive || typeof next !== 'function')
59
+ throw new Error('Open-url receiver is unavailable')
60
+ receive = next
61
+ draining = true
62
+ try {
63
+ while (pending.length) {
64
+ if (disposed) break
65
+ deliver(pending.shift()!)
66
+ }
67
+ } finally {
68
+ draining = false
69
+ }
70
+ },
71
+ dispose() {
72
+ if (disposed) return
73
+ disposed = true
74
+ receive = undefined
75
+ pending.length = 0
76
+ if (typeof unsubscribe === 'function') unsubscribe()
77
+ },
78
+ }
79
+ }
@@ -0,0 +1,9 @@
1
+ /** Return whether a value contains an ASCII control character. */
2
+ export function containsAsciiControl(value: string, includeSpace = false): boolean {
3
+ const maximum = includeSpace ? 0x20 : 0x1f
4
+ for (let index = 0; index < value.length; index++) {
5
+ const code = value.charCodeAt(index)
6
+ if (code <= maximum || code === 0x7f) return true
7
+ }
8
+ return false
9
+ }
@@ -0,0 +1,32 @@
1
+ import { containsAsciiControl } from '../desktop/string-policy'
2
+
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
+ export function safeArchivePath(path: string, fold: boolean): string | undefined {
9
+ const normalized = path.replace(/^\.\//, '').replace(/\/$/, '')
10
+ const parts = normalized.split('/')
11
+ if (
12
+ !normalized ||
13
+ normalized.length > 4096 ||
14
+ normalized.startsWith('/') ||
15
+ /^[A-Za-z]:/.test(normalized) ||
16
+ normalized.includes('\\') ||
17
+ containsAsciiControl(normalized) ||
18
+ parts.some(
19
+ (part) =>
20
+ !part ||
21
+ part === '.' ||
22
+ part === '..' ||
23
+ part.length > 255 ||
24
+ (fold &&
25
+ (/[<>:"|?*]/.test(part) ||
26
+ /[. ]$/.test(part) ||
27
+ /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i.test(part)))
28
+ )
29
+ )
30
+ return undefined
31
+ return normalized
32
+ }
@@ -0,0 +1,307 @@
1
+ /**
2
+ * Command artifacts: portable command-line payloads (release-config `commandArtifacts`). The
3
+ * release build leaves the payload directory, staging packs it into a `.tar.gz` whose one root
4
+ * directory is named after the asset, and qualification extracts that exact archive into a clean
5
+ * location and runs it there. Diagnostics name a failed stage only, never paths or output.
6
+ */
7
+ import type { Stats } from 'node:fs'
8
+ import { lstat, mkdir, mkdtemp, readdir, rm } from 'node:fs/promises'
9
+ import { tmpdir } from 'node:os'
10
+ import { basename, join, relative, sep } from 'node:path'
11
+ import { c as create, t as list, x as extract, type ReadEntry } from 'tar'
12
+ import { safeArchivePath } from './archive-entry'
13
+ import type { InstallerPlatform } from './installer-layout'
14
+ import type { CommandArtifactPolicy } from '../release/release-config'
15
+
16
+ const MAX_ENTRIES = 100000
17
+ const MAX_EXPANDED_BYTES = 2 * 1024 * 1024 * 1024
18
+ const MAX_ARCHIVE_BYTES = 1024 * 1024 * 1024
19
+ const COMMAND_TIMEOUT_MS = 60000
20
+ const SERVICE_SETTLE_MS = 5000
21
+ const SERVICE_STOP_MS = 30000
22
+
23
+ /** The archive's one root directory: the asset name without `.tar.gz`. */
24
+ export function commandArtifactRoot(asset: string): string {
25
+ if (!asset.endsWith('.tar.gz') || asset.length <= '.tar.gz'.length)
26
+ throw new Error('Command artifacts are .tar.gz archives')
27
+ return asset.slice(0, -'.tar.gz'.length)
28
+ }
29
+
30
+ /** The launcher inside the root: `bin/<executable>`, or `bin/<executable>.cmd` on Windows. */
31
+ function commandLauncher(executable: string, platform: InstallerPlatform): string {
32
+ return `bin/${executable}${platform === 'windows-x64' ? '.cmd' : ''}`
33
+ }
34
+
35
+ async function collect(root: string, directory: string, entries: string[]): Promise<void> {
36
+ const children = await readdir(directory, { withFileTypes: true })
37
+ // Sort for a reproducible archive; readdir order is file-system defined.
38
+ // oxlint-disable-next-line unicorn/no-array-sort
39
+ children.sort((left, right) => (left.name < right.name ? -1 : left.name > right.name ? 1 : 0))
40
+ for (const child of children) {
41
+ const path = join(directory, child.name)
42
+ const info = await lstat(path)
43
+ const name = relative(root, path).split(sep).join('/')
44
+ if (info.isDirectory()) {
45
+ entries.push(name)
46
+ await collect(root, path, entries)
47
+ } else if (info.isFile()) entries.push(name)
48
+ else throw new Error('Command artifact holds an unsupported entry')
49
+ if (entries.length > MAX_ENTRIES) throw new Error('Command artifact has too many entries')
50
+ }
51
+ }
52
+
53
+ /** Pack the built payload directory into `archive` under its asset-named root. */
54
+ export async function packCommandArtifact(options: {
55
+ source: string
56
+ archive: string
57
+ executable: string
58
+ platform: InstallerPlatform
59
+ }): Promise<void> {
60
+ const { source, archive, executable, platform } = options
61
+ const root = commandArtifactRoot(basename(archive))
62
+ const info = await lstat(source)
63
+ if (!info.isDirectory()) throw new Error('Command artifact build is not a directory')
64
+ const launcher = await lstat(join(source, commandLauncher(executable, platform))).catch(
65
+ () => undefined
66
+ )
67
+ if (
68
+ !launcher?.isFile() ||
69
+ launcher.size < 1 ||
70
+ (platform !== 'windows-x64' && !(launcher.mode & 0o100))
71
+ )
72
+ throw new Error('Command artifact build has no launcher')
73
+ const entries: string[] = []
74
+ await collect(source, source, entries)
75
+ await create(
76
+ {
77
+ file: archive,
78
+ cwd: source,
79
+ gzip: true,
80
+ portable: true,
81
+ noDirRecurse: true,
82
+ mtime: new Date(0),
83
+ prefix: root,
84
+ },
85
+ entries
86
+ )
87
+ }
88
+
89
+ /**
90
+ * Read a command artifact archive: every entry is a regular file or directory under the
91
+ * asset-named root, within bounds, and the launcher is present (executable off Windows). With
92
+ * `destination`, also extract it there.
93
+ */
94
+ export async function readCommandArtifact(options: {
95
+ archive: string
96
+ executable: string
97
+ platform: InstallerPlatform
98
+ destination?: string
99
+ }): Promise<{ entries: number; bytes: number }> {
100
+ const { archive, executable, platform, destination } = options
101
+ const info = await lstat(archive)
102
+ if (!info.isFile() || info.size < 1 || info.size > MAX_ARCHIVE_BYTES)
103
+ throw new Error('Invalid command artifact archive')
104
+ const root = commandArtifactRoot(basename(archive))
105
+ const fold = platform === 'windows-x64'
106
+ const launcher = `${root}/${commandLauncher(executable, platform)}`
107
+ const seen = new Set<string>()
108
+ let invalid = false,
109
+ bytes = 0,
110
+ launcherFound = false
111
+ const filter = (path: string, entry: ReadEntry | Stats) => {
112
+ if (!('type' in entry)) {
113
+ invalid = true
114
+ return false
115
+ }
116
+ const value = entry
117
+ const normalized = safeArchivePath(path, fold)
118
+ const key = normalized && (fold ? normalized.toLowerCase() : normalized)
119
+ if (
120
+ !normalized ||
121
+ !key ||
122
+ (normalized !== root && !normalized.startsWith(`${root}/`)) ||
123
+ (value.type !== 'File' && value.type !== 'Directory') ||
124
+ seen.has(key) ||
125
+ seen.size >= MAX_ENTRIES
126
+ ) {
127
+ invalid = true
128
+ return false
129
+ }
130
+ seen.add(key)
131
+ if (value.type === 'File') {
132
+ bytes += value.size ?? 0
133
+ if (!Number.isSafeInteger(bytes) || bytes > MAX_EXPANDED_BYTES) {
134
+ invalid = true
135
+ return false
136
+ }
137
+ if (normalized === launcher)
138
+ launcherFound = Boolean(value.size) && (fold || Boolean((value.mode ?? 0) & 0o100))
139
+ }
140
+ return true
141
+ }
142
+ if (destination)
143
+ await extract({
144
+ file: archive,
145
+ cwd: destination,
146
+ strict: true,
147
+ preserveOwner: false,
148
+ umask: 0o022,
149
+ maxMetaEntrySize: 1024 * 1024,
150
+ filter,
151
+ })
152
+ else await list({ file: archive, strict: true, maxMetaEntrySize: 1024 * 1024, filter })
153
+ if (invalid) throw new Error('Unsafe or unsupported command artifact entry')
154
+ if (!launcherFound) throw new Error('Command artifact has no launcher')
155
+ return { entries: seen.size, bytes }
156
+ }
157
+
158
+ type Spawned = ReturnType<typeof Bun.spawn>
159
+
160
+ async function boundedText(stream: ReadableStream<Uint8Array>, maximum: number) {
161
+ const chunks: Uint8Array[] = []
162
+ let size = 0
163
+ for await (const chunk of stream) {
164
+ size += chunk.length
165
+ // Keep draining past the bound so the child never blocks on a full pipe.
166
+ if (size <= maximum) chunks.push(chunk)
167
+ }
168
+ return size > maximum ? undefined : Buffer.concat(chunks).toString('utf8')
169
+ }
170
+
171
+ async function exitedWithin(child: Spawned, milliseconds: number): Promise<number | undefined> {
172
+ let timer: ReturnType<typeof setTimeout> | undefined
173
+ const timeout = new Promise<undefined>((resolve) => {
174
+ timer = setTimeout(() => resolve(undefined), milliseconds)
175
+ })
176
+ try {
177
+ return await Promise.race([child.exited, timeout])
178
+ } finally {
179
+ clearTimeout(timer)
180
+ }
181
+ }
182
+
183
+ /** The bounded result of qualifying one extracted command artifact. */
184
+ export type CommandQualification = {
185
+ installed: true
186
+ versionMatched: true
187
+ probesPassed: true
188
+ serviceStarted: true
189
+ serviceStopped: 'sigterm' | 'process-tree'
190
+ }
191
+
192
+ /**
193
+ * Extract the archive into a new private location with its own home and data directories, then
194
+ * run `--version` (it must print `version`), each probe (each must exit 0), and the service
195
+ * (it must stay up through a settle window, then stop on SIGTERM with exit 0; on Windows, where
196
+ * no signal reaches a console process, its process tree is terminated).
197
+ */
198
+ export async function qualifyCommandArtifact(options: {
199
+ archive: string
200
+ platform: InstallerPlatform
201
+ policy: CommandArtifactPolicy
202
+ version: string
203
+ env: Record<string, string | undefined>
204
+ settleMs?: number
205
+ }): Promise<CommandQualification> {
206
+ const { archive, platform, policy, version } = options
207
+ const windows = platform === 'windows-x64'
208
+ const location = await mkdtemp(join(tmpdir(), 'framework-command-'))
209
+ let service: Spawned | undefined
210
+ try {
211
+ const install = join(location, 'install'),
212
+ home = join(location, 'home'),
213
+ temp = join(location, 'tmp')
214
+ for (const path of [install, home, temp]) await mkdir(path, { mode: 0o700 })
215
+ await readCommandArtifact({
216
+ archive,
217
+ executable: policy.executable,
218
+ platform,
219
+ destination: install,
220
+ })
221
+ const bin = join(install, commandArtifactRoot(basename(archive)), 'bin')
222
+ const launcher = join(bin, basename(commandLauncher(policy.executable, platform)))
223
+ const installed = await lstat(launcher)
224
+ if (!installed.isFile() || installed.size < 1)
225
+ throw new Error('Command artifact install failed')
226
+ const env: Record<string, string> = {}
227
+ for (const name of ['PATH', 'SystemRoot', 'WINDIR', 'COMSPEC', 'PATHEXT', 'LANG'])
228
+ if (options.env[name]) env[name] = options.env[name]!
229
+ Object.assign(env, {
230
+ HOME: home,
231
+ USERPROFILE: home,
232
+ TMPDIR: temp,
233
+ TMP: temp,
234
+ TEMP: temp,
235
+ XDG_DATA_HOME: join(home, '.local', 'share'),
236
+ XDG_CONFIG_HOME: join(home, '.config'),
237
+ XDG_STATE_HOME: join(home, '.local', 'state'),
238
+ XDG_CACHE_HOME: join(home, '.cache'),
239
+ LOCALAPPDATA: join(home, 'AppData', 'Local'),
240
+ APPDATA: join(home, 'AppData', 'Roaming'),
241
+ ...policy.qualification.env,
242
+ })
243
+ // cmd.exe runs the launcher from its own directory, so no path needs quoting.
244
+ const command = (args: readonly string[]) =>
245
+ windows ? ['cmd.exe', '/d', '/c', basename(launcher), ...args] : [launcher, ...args]
246
+ const spawn = (args: readonly string[], output: 'pipe' | 'ignore') =>
247
+ Bun.spawn({
248
+ cmd: command(args),
249
+ cwd: windows ? bin : home,
250
+ env,
251
+ stdin: 'ignore',
252
+ stdout: output,
253
+ stderr: output,
254
+ })
255
+ const runOnce = async (args: readonly string[]) => {
256
+ const child = spawn(args, 'pipe')
257
+ const stdout = boundedText(child.stdout as ReadableStream<Uint8Array>, 65536)
258
+ const stderr = boundedText(child.stderr as ReadableStream<Uint8Array>, 65536)
259
+ const status = await exitedWithin(child, COMMAND_TIMEOUT_MS)
260
+ if (status === undefined) {
261
+ child.kill('SIGKILL')
262
+ await child.exited
263
+ }
264
+ const [text] = await Promise.all([stdout, stderr])
265
+ return { status, text }
266
+ }
267
+ const reported = await runOnce(['--version'])
268
+ if (reported.status !== 0 || reported.text?.trim() !== version)
269
+ throw new Error('Command artifact version mismatch')
270
+ for (const probe of policy.qualification.probes)
271
+ if ((await runOnce(probe)).status !== 0) throw new Error('Command artifact probe failed')
272
+ service = spawn(policy.qualification.service, 'ignore')
273
+ if ((await exitedWithin(service, options.settleMs ?? SERVICE_SETTLE_MS)) !== undefined)
274
+ throw new Error('Command artifact service exited early')
275
+ if (windows) {
276
+ const kill = Bun.spawn({
277
+ cmd: ['taskkill.exe', '/PID', String(service.pid), '/T', '/F'],
278
+ env,
279
+ stdin: 'ignore',
280
+ stdout: 'ignore',
281
+ stderr: 'ignore',
282
+ })
283
+ if ((await exitedWithin(kill, COMMAND_TIMEOUT_MS)) !== 0)
284
+ throw new Error('Command artifact service did not stop')
285
+ if ((await exitedWithin(service, SERVICE_STOP_MS)) === undefined)
286
+ throw new Error('Command artifact service did not stop')
287
+ } else {
288
+ service.kill('SIGTERM')
289
+ if ((await exitedWithin(service, SERVICE_STOP_MS)) !== 0)
290
+ throw new Error('Command artifact service did not stop cleanly')
291
+ }
292
+ service = undefined
293
+ return {
294
+ installed: true,
295
+ versionMatched: true,
296
+ probesPassed: true,
297
+ serviceStarted: true,
298
+ serviceStopped: windows ? 'process-tree' : 'sigterm',
299
+ }
300
+ } finally {
301
+ if (service) {
302
+ service.kill('SIGKILL')
303
+ await exitedWithin(service, SERVICE_STOP_MS)
304
+ }
305
+ await rm(location, { recursive: true, force: true, maxRetries: 5, retryDelay: 200 })
306
+ }
307
+ }
@@ -0,0 +1,75 @@
1
+ import { lstat, writeFile } from 'node:fs/promises'
2
+ import { join, resolve } from 'node:path'
3
+ import { assertInstallerContext, type InstallerPlatform } from './installer-layout'
4
+ import { qualifyCommandArtifact } from './command-artifact'
5
+ import { planReleaseAssets } from '../release/release-assets-plan'
6
+ import { parseReleaseConfig } from '../release/release-config'
7
+ import { validateCommandReceipt, type CommandReceipt } from '../release/release-qualification'
8
+ import { fileIdentity } from '../release/release-publication'
9
+
10
+ /** The receipt a command artifact's qualification stages beside the payloads. */
11
+ export const commandReceiptName = (kind: string, platform: string) =>
12
+ `command-test-${kind}-${platform}.json`
13
+
14
+ /** Qualify every command artifact of one platform in the trusted release-assets workflow. */
15
+ export async function qualifyCommandArtifactsCommand(options: {
16
+ env: Record<string, string | undefined>
17
+ config: unknown
18
+ tag: string
19
+ platform: InstallerPlatform
20
+ directory: string
21
+ }): Promise<CommandReceipt[]> {
22
+ const { env, config, tag, platform } = options
23
+ const parsed = parseReleaseConfig(config)
24
+ if (!parsed.commandArtifacts.length) return []
25
+ assertInstallerContext(env, platform, process.platform, process.arch)
26
+ if (env.RELEASE_TAG !== tag) throw new Error('Command artifact release tag mismatch')
27
+ const plan = await planReleaseAssets({ env, config, tag })
28
+ if (env.SOURCE_SHA !== plan.sourceSha) throw new Error('Command artifact source mismatch')
29
+ const requirements = parsed.requirements(tag)
30
+ const directory = resolve(options.directory)
31
+ const identity = {
32
+ tag,
33
+ sourceSha: plan.sourceSha,
34
+ workflowSha: plan.workflowSha,
35
+ runId: env.GITHUB_RUN_ID!,
36
+ runAttempt: Number(env.GITHUB_RUN_ATTEMPT),
37
+ }
38
+ const receipts: CommandReceipt[] = []
39
+ for (const policy of parsed.commandArtifacts) {
40
+ const name = requirements.commandArtifacts![policy.kind]![platform]!
41
+ const destination = join(directory, commandReceiptName(policy.kind, platform))
42
+ try {
43
+ await lstat(destination)
44
+ throw new Error('Command artifact receipt already exists')
45
+ } catch (error) {
46
+ if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error
47
+ }
48
+ const path = join(directory, name)
49
+ const asset = await fileIdentity(path, name)
50
+ const result = await qualifyCommandArtifact({
51
+ archive: path,
52
+ platform,
53
+ policy,
54
+ version: plan.version,
55
+ env,
56
+ })
57
+ if (JSON.stringify(await fileIdentity(path, name)) !== JSON.stringify(asset))
58
+ throw new Error('Staged command artifact changed')
59
+ const receipt: CommandReceipt = {
60
+ schema: 1,
61
+ ...identity,
62
+ kind: policy.kind,
63
+ platform,
64
+ ...result,
65
+ asset,
66
+ }
67
+ validateCommandReceipt(identity, receipt, policy.kind, platform, name, [asset])
68
+ await writeFile(destination, JSON.stringify(receipt, null, 2) + '\n', {
69
+ flag: 'wx',
70
+ mode: 0o600,
71
+ })
72
+ receipts.push(receipt)
73
+ }
74
+ return receipts
75
+ }
@@ -0,0 +1,11 @@
1
+ /** True only on a disposable GitHub-hosted Actions runner. */
2
+ export function isHostedRunner(env: Record<string, string | undefined>): boolean {
3
+ return (
4
+ env.CI === 'true' && env.GITHUB_ACTIONS === 'true' && env.RUNNER_ENVIRONMENT === 'github-hosted'
5
+ )
6
+ }
7
+
8
+ /** Refuse `subject` anywhere but a disposable GitHub-hosted runner. */
9
+ export function assertHostedRunner(env: Record<string, string | undefined>, subject: string): void {
10
+ if (!isHostedRunner(env)) throw new Error(`${subject} requires a disposable GitHub-hosted runner`)
11
+ }