@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.
- package/LICENSE +201 -0
- package/NOTICE +30 -0
- package/README.md +967 -2
- package/dist/app/application.d.ts +47 -0
- package/dist/app/application.js +115 -0
- package/dist/app/create-application.d.ts +13 -0
- package/dist/app/create-application.js +178 -0
- package/dist/app/service-registry.d.ts +44 -0
- package/dist/app/service-registry.js +116 -0
- package/dist/appearance/appearance-host.d.ts +62 -0
- package/dist/appearance/appearance-host.js +115 -0
- package/dist/appearance/appearance-preferences.d.ts +106 -0
- package/dist/appearance/appearance-preferences.js +175 -0
- package/dist/appearance/composition.d.ts +11 -0
- package/dist/appearance/composition.js +16 -0
- package/dist/appearance/custom-theme-import.d.ts +14 -0
- package/dist/appearance/custom-theme-import.js +315 -0
- package/dist/appearance/custom-theme-library.d.ts +146 -0
- package/dist/appearance/custom-theme-library.js +378 -0
- package/dist/appearance/editor.d.ts +20 -0
- package/dist/appearance/editor.js +47 -0
- package/dist/appearance/theme-file-importer.d.ts +23 -0
- package/dist/appearance/theme-file-importer.js +66 -0
- package/dist/appearance/theme-record-adapter.d.ts +26 -0
- package/dist/appearance/theme-record-adapter.js +64 -0
- package/dist/appearance/theme-registry.d.ts +10 -0
- package/dist/appearance/theme-registry.js +16 -0
- package/dist/appearance/window-surface.d.ts +5 -0
- package/dist/appearance/window-surface.js +9 -0
- package/dist/ci/toolchain-identity.d.ts +39 -0
- package/dist/ci/toolchain-identity.js +196 -0
- package/dist/cli/cef-helper-cli.d.ts +2 -0
- package/dist/cli/cef-helper-cli.js +18 -0
- package/dist/cli/cli-runner.d.ts +8 -0
- package/dist/cli/cli-runner.js +23 -0
- package/dist/cli/create-application-cli.d.ts +2 -0
- package/dist/cli/create-application-cli.js +40 -0
- package/dist/cli/electrobun-shortcut-patch-cli.d.ts +2 -0
- package/dist/cli/electrobun-shortcut-patch-cli.js +17 -0
- package/dist/cli/framework-update-cli.d.ts +2 -0
- package/dist/cli/framework-update-cli.js +40 -0
- package/dist/cli/release-assets-plan-cli.d.ts +2 -0
- package/dist/cli/release-assets-plan-cli.js +14 -0
- package/dist/cli/release-cut-cli.d.ts +2 -0
- package/dist/cli/release-cut-cli.js +27 -0
- package/dist/cli/release-descriptor-staging-cli.d.ts +2 -0
- package/dist/cli/release-descriptor-staging-cli.js +45 -0
- package/dist/cli/release-finalize-cli.d.ts +1 -0
- package/dist/cli/release-finalize-cli.js +30 -0
- package/dist/cli/release-promote-cli.d.ts +2 -0
- package/dist/cli/release-promote-cli.js +32 -0
- package/dist/cli/release-publish-cli.d.ts +2 -0
- package/dist/cli/release-publish-cli.js +48 -0
- package/dist/cli/release-sign-cli.d.ts +2 -0
- package/dist/cli/release-sign-cli.js +13 -0
- package/dist/cli/release-step-cli.d.ts +2 -0
- package/dist/cli/release-step-cli.js +44 -0
- package/dist/cli/toolchain-identity-cli.d.ts +2 -0
- package/dist/cli/toolchain-identity-cli.js +10 -0
- package/dist/cli/update-helper-cli.d.ts +1 -0
- package/dist/cli/update-helper-cli.js +10 -0
- package/dist/cli/windows-runtime-patch-cli.d.ts +2 -0
- package/dist/cli/windows-runtime-patch-cli.js +17 -0
- package/dist/desktop/application-command-client.d.ts +15 -0
- package/dist/desktop/application-command-client.js +21 -0
- package/dist/desktop/channel-handshake.d.ts +32 -0
- package/dist/desktop/channel-handshake.js +111 -0
- package/dist/desktop/channel-proof.d.ts +43 -0
- package/dist/desktop/channel-proof.js +85 -0
- package/dist/desktop/client-assets.d.ts +7 -0
- package/dist/desktop/client-assets.js +59 -0
- package/dist/desktop/desktop-client.d.ts +23 -0
- package/dist/desktop/desktop-client.js +231 -0
- package/dist/desktop/desktop-gateway.d.ts +18 -0
- package/dist/desktop/desktop-gateway.js +146 -0
- package/dist/desktop/desktop-host.d.ts +48 -0
- package/dist/desktop/desktop-host.js +208 -0
- package/dist/desktop/desktop-stream.d.ts +36 -0
- package/dist/desktop/desktop-stream.js +231 -0
- package/dist/desktop/loopback-policy.d.ts +19 -0
- package/dist/desktop/loopback-policy.js +23 -0
- package/dist/desktop/open-url-channel.d.ts +15 -0
- package/dist/desktop/open-url-channel.js +55 -0
- package/dist/desktop/string-policy.d.ts +2 -0
- package/dist/desktop/string-policy.js +11 -0
- package/dist/framework-source.json +1 -0
- package/dist/installer/archive-entry.d.ts +6 -0
- package/dist/installer/archive-entry.js +14 -0
- package/dist/installer/command-artifact.d.ts +47 -0
- package/dist/installer/command-artifact.js +261 -0
- package/dist/installer/command-qualification-command.d.ts +12 -0
- package/dist/installer/command-qualification-command.js +71 -0
- package/dist/installer/hosted-runner.d.ts +4 -0
- package/dist/installer/hosted-runner.js +10 -0
- package/dist/installer/installed-payload.d.ts +29 -0
- package/dist/installer/installed-payload.js +312 -0
- package/dist/installer/installer-ci-bootstrap.d.ts +26 -0
- package/dist/installer/installer-ci-bootstrap.js +160 -0
- package/dist/installer/installer-ci-preflight.d.ts +1 -0
- package/dist/installer/installer-ci-preflight.js +49 -0
- package/dist/installer/installer-ci-worker.d.ts +1 -0
- package/dist/installer/installer-ci-worker.js +105 -0
- package/dist/installer/installer-extraction.d.ts +14 -0
- package/dist/installer/installer-extraction.js +289 -0
- package/dist/installer/installer-fetch-guard.d.ts +15 -0
- package/dist/installer/installer-fetch-guard.js +50 -0
- package/dist/installer/installer-identity.d.ts +23 -0
- package/dist/installer/installer-identity.js +286 -0
- package/dist/installer/installer-layout.d.ts +21 -0
- package/dist/installer/installer-layout.js +89 -0
- package/dist/installer/installer-observation.d.ts +64 -0
- package/dist/installer/installer-observation.js +473 -0
- package/dist/installer/installer-process-cleanup.d.ts +18 -0
- package/dist/installer/installer-process-cleanup.js +158 -0
- package/dist/installer/installer-qualification-command.d.ts +11 -0
- package/dist/installer/installer-qualification-command.js +71 -0
- package/dist/installer/installer-renderer-evidence.d.ts +43 -0
- package/dist/installer/installer-renderer-evidence.js +136 -0
- package/dist/installer/installer-upgrade-command.d.ts +37 -0
- package/dist/installer/installer-upgrade-command.js +172 -0
- package/dist/installer/installer-worker-guard.d.ts +21 -0
- package/dist/installer/installer-worker-guard.js +72 -0
- package/dist/installer/native-executable.d.ts +5 -0
- package/dist/installer/native-executable.js +21 -0
- package/dist/installer/upgrade-asset-download.d.ts +13 -0
- package/dist/installer/upgrade-asset-download.js +41 -0
- package/dist/installer/write-all.d.ts +6 -0
- package/dist/installer/write-all.js +11 -0
- package/dist/native/app-bundle.d.ts +28 -0
- package/dist/native/app-bundle.js +60 -0
- package/dist/native/cef-helper.d.ts +28 -0
- package/dist/native/cef-helper.js +402 -0
- package/dist/native/desktop-build-hook.d.ts +7 -0
- package/dist/native/desktop-build-hook.js +20 -0
- package/dist/native/electrobun-source-patch.d.ts +25 -0
- package/dist/native/electrobun-source-patch.js +93 -0
- package/dist/native/linux-cef-links.d.ts +2 -0
- package/dist/native/linux-cef-links.js +15 -0
- package/dist/native/native-secret-store.d.ts +27 -0
- package/dist/native/native-secret-store.js +70 -0
- package/dist/native/native-utilities.d.ts +24 -0
- package/dist/native/native-utilities.js +85 -0
- package/dist/native/partitioned-window.d.ts +34 -0
- package/dist/native/partitioned-window.js +44 -0
- package/dist/native/renderer-profile.d.ts +53 -0
- package/dist/native/renderer-profile.js +30 -0
- package/dist/native/secure-window.d.ts +38 -0
- package/dist/native/secure-window.js +77 -0
- package/dist/native/sidecar-services.d.ts +23 -0
- package/dist/native/sidecar-services.js +46 -0
- package/dist/native/sidecar.d.ts +81 -0
- package/dist/native/sidecar.js +250 -0
- package/dist/native/window-bootstrap.d.ts +24 -0
- package/dist/native/window-bootstrap.js +63 -0
- package/dist/native/window-options.d.ts +32 -0
- package/dist/native/window-options.js +23 -0
- package/dist/native/windows-build-hook-internal.d.ts +2 -0
- package/dist/native/windows-build-hook-internal.js +32 -0
- package/dist/native/windows-build-hook.d.ts +2 -0
- package/dist/native/windows-build-hook.js +12 -0
- package/dist/native/windows-runtime-patch-internal.d.ts +3 -0
- package/dist/native/windows-runtime-patch-internal.js +20 -0
- package/dist/native/windows-runtime-patch.d.ts +4 -0
- package/dist/native/windows-runtime-patch.js +12 -0
- package/dist/release/feed-release-cut.d.ts +23 -0
- package/dist/release/feed-release-cut.js +93 -0
- package/dist/release/feed-state.d.ts +25 -0
- package/dist/release/feed-state.js +81 -0
- package/dist/release/framework-package-publish.d.ts +21 -0
- package/dist/release/framework-package-publish.js +125 -0
- package/dist/release/framework-update.d.ts +30 -0
- package/dist/release/framework-update.js +139 -0
- package/dist/release/github-cli.d.ts +6 -0
- package/dist/release/github-cli.js +16 -0
- package/dist/release/github-release-assets.d.ts +3 -0
- package/dist/release/github-release-assets.js +24 -0
- package/dist/release/github-release-cut.d.ts +14 -0
- package/dist/release/github-release-cut.js +174 -0
- package/dist/release/github-release-lookup.d.ts +7 -0
- package/dist/release/github-release-lookup.js +29 -0
- package/dist/release/github-release-promotion.d.ts +10 -0
- package/dist/release/github-release-promotion.js +78 -0
- package/dist/release/github-release-provenance.d.ts +9 -0
- package/dist/release/github-release-provenance.js +27 -0
- package/dist/release/github-release-publisher.d.ts +9 -0
- package/dist/release/github-release-publisher.js +63 -0
- package/dist/release/github-release-qualification.d.ts +12 -0
- package/dist/release/github-release-qualification.js +80 -0
- package/dist/release/local-provenance.d.ts +24 -0
- package/dist/release/local-provenance.js +72 -0
- package/dist/release/local-release.d.ts +133 -0
- package/dist/release/local-release.js +387 -0
- package/dist/release/macos-dmg.d.ts +22 -0
- package/dist/release/macos-dmg.js +91 -0
- package/dist/release/release-artifact.d.ts +6 -0
- package/dist/release/release-artifact.js +38 -0
- package/dist/release/release-assets-plan.d.ts +14 -0
- package/dist/release/release-assets-plan.js +65 -0
- package/dist/release/release-config.d.ts +76 -0
- package/dist/release/release-config.js +180 -0
- package/dist/release/release-cut-command.d.ts +13 -0
- package/dist/release/release-cut-command.js +39 -0
- package/dist/release/release-cut.d.ts +54 -0
- package/dist/release/release-cut.js +76 -0
- package/dist/release/release-descriptor-staging.d.ts +34 -0
- package/dist/release/release-descriptor-staging.js +147 -0
- package/dist/release/release-finalize.d.ts +16 -0
- package/dist/release/release-finalize.js +104 -0
- package/dist/release/release-promotion-command.d.ts +12 -0
- package/dist/release/release-promotion-command.js +28 -0
- package/dist/release/release-promotion.d.ts +29 -0
- package/dist/release/release-promotion.js +57 -0
- package/dist/release/release-publication.d.ts +33 -0
- package/dist/release/release-publication.js +138 -0
- package/dist/release/release-publish-command.d.ts +7 -0
- package/dist/release/release-publish-command.js +91 -0
- package/dist/release/release-qualification.d.ts +106 -0
- package/dist/release/release-qualification.js +135 -0
- package/dist/release/release-staging.d.ts +9 -0
- package/dist/release/release-staging.js +61 -0
- package/dist/release/release-steps.d.ts +38 -0
- package/dist/release/release-steps.js +147 -0
- package/dist/release/retained-release-build.d.ts +19 -0
- package/dist/release/retained-release-build.js +122 -0
- package/dist/shell/app-shell.d.ts +61 -0
- package/dist/shell/app-shell.js +318 -0
- package/dist/shell/app-utilities.d.ts +122 -0
- package/dist/shell/app-utilities.js +334 -0
- package/dist/shell/application-menu-commands.d.ts +5 -0
- package/dist/shell/application-menu-commands.js +11 -0
- package/dist/shell/application-menu.d.ts +61 -0
- package/dist/shell/application-menu.js +208 -0
- package/dist/shell/help-shortcuts.d.ts +12 -0
- package/dist/shell/help-shortcuts.js +22 -0
- package/dist/shell/settings-sections.d.ts +31 -0
- package/dist/shell/settings-sections.js +50 -0
- package/dist/shell/shortcut-platform.d.ts +17 -0
- package/dist/shell/shortcut-platform.js +25 -0
- package/dist/update-helper.bundle.js +260 -0
- package/dist/updates/channel-update-manager.d.ts +46 -0
- package/dist/updates/channel-update-manager.js +114 -0
- package/dist/updates/desktop-updater.d.ts +104 -0
- package/dist/updates/desktop-updater.js +345 -0
- package/dist/updates/release-feed.d.ts +61 -0
- package/dist/updates/release-feed.js +111 -0
- package/dist/updates/release-location.d.ts +9 -0
- package/dist/updates/release-location.js +80 -0
- package/dist/updates/release-version.d.ts +12 -0
- package/dist/updates/release-version.js +43 -0
- package/dist/updates/signed-release.d.ts +63 -0
- package/dist/updates/signed-release.js +162 -0
- package/dist/updates/stable-file.d.ts +10 -0
- package/dist/updates/stable-file.js +22 -0
- package/dist/updates/update-adapter.d.ts +57 -0
- package/dist/updates/update-adapter.js +72 -0
- package/dist/updates/update-arm.d.ts +24 -0
- package/dist/updates/update-arm.js +95 -0
- package/dist/updates/update-channel-store.d.ts +8 -0
- package/dist/updates/update-channel-store.js +72 -0
- package/dist/updates/update-discovery.d.ts +13 -0
- package/dist/updates/update-discovery.js +56 -0
- package/dist/updates/update-download.d.ts +14 -0
- package/dist/updates/update-download.js +67 -0
- package/dist/updates/update-exclusive-rename.d.ts +2 -0
- package/dist/updates/update-exclusive-rename.js +52 -0
- package/dist/updates/update-extraction.d.ts +18 -0
- package/dist/updates/update-extraction.js +183 -0
- package/dist/updates/update-handoff-plan.d.ts +22 -0
- package/dist/updates/update-handoff-plan.js +28 -0
- package/dist/updates/update-helper.d.ts +24 -0
- package/dist/updates/update-helper.js +56 -0
- package/dist/updates/update-launch.d.ts +5 -0
- package/dist/updates/update-launch.js +27 -0
- package/dist/updates/update-manager.d.ts +40 -0
- package/dist/updates/update-manager.js +83 -0
- package/dist/updates/update-process-fence.d.ts +10 -0
- package/dist/updates/update-process-fence.js +114 -0
- package/dist/updates/update-resume.d.ts +13 -0
- package/dist/updates/update-resume.js +34 -0
- package/dist/updates/update-shutdown.d.ts +15 -0
- package/dist/updates/update-shutdown.js +29 -0
- package/dist/updates/update-state.d.ts +30 -0
- package/dist/updates/update-state.js +18 -0
- package/dist/updates/update-swap-stage.d.ts +27 -0
- package/dist/updates/update-swap-stage.js +58 -0
- package/dist/updates/update-swap.d.ts +10 -0
- package/dist/updates/update-swap.js +30 -0
- package/dist/views/app-about.d.ts +22 -0
- package/dist/views/app-about.js +43 -0
- package/dist/views/app-appearance.d.ts +11 -0
- package/dist/views/app-appearance.js +42 -0
- package/dist/views/app-help.d.ts +17 -0
- package/dist/views/app-help.js +42 -0
- package/dist/views/app-settings.d.ts +26 -0
- package/dist/views/app-settings.js +97 -0
- package/dist/views/appearance-surface.d.ts +9 -0
- package/dist/views/appearance-surface.js +334 -0
- package/dist/views/update-surface.d.ts +34 -0
- package/dist/views/update-surface.js +64 -0
- package/package.json +363 -4
- package/src/app/application.tsx +138 -0
- package/src/app/create-application.ts +245 -0
- package/src/app/service-registry.ts +124 -0
- package/src/appearance/appearance-host.tsx +205 -0
- package/src/appearance/appearance-preferences.ts +287 -0
- package/src/appearance/composition.ts +29 -0
- package/src/appearance/custom-theme-import.ts +424 -0
- package/src/appearance/custom-theme-library.ts +600 -0
- package/src/appearance/editor.ts +94 -0
- package/src/appearance/theme-file-importer.ts +103 -0
- package/src/appearance/theme-record-adapter.ts +106 -0
- package/src/appearance/theme-registry.ts +20 -0
- package/src/appearance/window-surface.ts +18 -0
- package/src/ci/toolchain-identity.ts +244 -0
- package/src/cli/cef-helper-cli.ts +21 -0
- package/src/cli/cli-runner.ts +29 -0
- package/src/cli/create-application-cli.ts +62 -0
- package/src/cli/electrobun-shortcut-patch-cli.ts +24 -0
- package/src/cli/framework-update-cli.ts +41 -0
- package/src/cli/release-assets-plan-cli.ts +14 -0
- package/src/cli/release-cut-cli.ts +41 -0
- package/src/cli/release-descriptor-staging-cli.ts +57 -0
- package/src/cli/release-finalize-cli.ts +34 -0
- package/src/cli/release-promote-cli.ts +31 -0
- package/src/cli/release-publish-cli.ts +46 -0
- package/src/cli/release-sign-cli.ts +24 -0
- package/src/cli/release-step-cli.ts +71 -0
- package/src/cli/toolchain-identity-cli.ts +12 -0
- package/src/cli/update-helper-cli.ts +12 -0
- package/src/cli/windows-runtime-patch-cli.ts +17 -0
- package/src/desktop/application-command-client.ts +43 -0
- package/src/desktop/channel-handshake.ts +136 -0
- package/src/desktop/channel-proof.ts +122 -0
- package/src/desktop/client-assets.ts +75 -0
- package/src/desktop/desktop-client.ts +303 -0
- package/src/desktop/desktop-gateway.ts +189 -0
- package/src/desktop/desktop-host.ts +335 -0
- package/src/desktop/desktop-stream.ts +324 -0
- package/src/desktop/loopback-policy.ts +41 -0
- package/src/desktop/open-url-channel.ts +79 -0
- package/src/desktop/string-policy.ts +9 -0
- package/src/installer/archive-entry.ts +32 -0
- package/src/installer/command-artifact.ts +307 -0
- package/src/installer/command-qualification-command.ts +75 -0
- package/src/installer/hosted-runner.ts +11 -0
- package/src/installer/installed-payload.ts +408 -0
- package/src/installer/installer-ci-bootstrap.ts +199 -0
- package/src/installer/installer-ci-preflight.ts +61 -0
- package/src/installer/installer-ci-worker.ts +105 -0
- package/src/installer/installer-extraction.ts +367 -0
- package/src/installer/installer-fetch-guard.ts +75 -0
- package/src/installer/installer-identity.ts +331 -0
- package/src/installer/installer-layout.ts +167 -0
- package/src/installer/installer-observation.ts +671 -0
- package/src/installer/installer-process-cleanup.ts +167 -0
- package/src/installer/installer-qualification-command.ts +81 -0
- package/src/installer/installer-renderer-evidence.ts +268 -0
- package/src/installer/installer-upgrade-command.ts +226 -0
- package/src/installer/installer-worker-guard.ts +112 -0
- package/src/installer/native-executable.ts +37 -0
- package/src/installer/upgrade-asset-download.ts +72 -0
- package/src/installer/write-all.ts +19 -0
- package/src/native/app-bundle.ts +86 -0
- package/src/native/cef-helper.ts +471 -0
- package/src/native/desktop-build-hook.ts +21 -0
- package/src/native/electrobun-cef-main-frame-bridges.patch +63 -0
- package/src/native/electrobun-source-patch.ts +107 -0
- package/src/native/electrobun-windows-shortcut-com.patch +923 -0
- package/src/native/linux-cef-links.ts +14 -0
- package/src/native/native-secret-store.ts +99 -0
- package/src/native/native-utilities.ts +166 -0
- package/src/native/partitioned-window.ts +62 -0
- package/src/native/renderer-profile.ts +27 -0
- package/src/native/secure-window.ts +115 -0
- package/src/native/sidecar-services.ts +71 -0
- package/src/native/sidecar.ts +387 -0
- package/src/native/window-bootstrap.ts +77 -0
- package/src/native/window-options.ts +24 -0
- package/src/native/windows-build-hook-internal.ts +49 -0
- package/src/native/windows-build-hook.ts +12 -0
- package/src/native/windows-runtime-patch-internal.ts +48 -0
- package/src/native/windows-runtime-patch.ts +15 -0
- package/src/release/feed-release-cut.ts +110 -0
- package/src/release/feed-state.ts +135 -0
- package/src/release/framework-package-publish.ts +163 -0
- package/src/release/framework-update.ts +196 -0
- package/src/release/github-cli.ts +27 -0
- package/src/release/github-release-assets.ts +36 -0
- package/src/release/github-release-cut.ts +237 -0
- package/src/release/github-release-lookup.ts +39 -0
- package/src/release/github-release-promotion.ts +112 -0
- package/src/release/github-release-provenance.ts +65 -0
- package/src/release/github-release-publisher.ts +90 -0
- package/src/release/github-release-qualification.ts +144 -0
- package/src/release/local-provenance.ts +92 -0
- package/src/release/local-release.ts +525 -0
- package/src/release/macos-dmg.ts +113 -0
- package/src/release/release-artifact.ts +53 -0
- package/src/release/release-assets-plan.ts +118 -0
- package/src/release/release-config.ts +420 -0
- package/src/release/release-cut-command.ts +80 -0
- package/src/release/release-cut.ts +133 -0
- package/src/release/release-descriptor-staging.ts +242 -0
- package/src/release/release-finalize.ts +191 -0
- package/src/release/release-promotion-command.ts +36 -0
- package/src/release/release-promotion.ts +132 -0
- package/src/release/release-publication.ts +213 -0
- package/src/release/release-publish-command.ts +163 -0
- package/src/release/release-qualification.ts +397 -0
- package/src/release/release-staging.ts +87 -0
- package/src/release/release-steps.ts +173 -0
- package/src/release/retained-release-build.ts +217 -0
- package/src/shell/app-shell.tsx +285 -0
- package/src/shell/app-utilities.tsx +437 -0
- package/src/shell/application-menu-commands.ts +6 -0
- package/src/shell/application-menu.ts +250 -0
- package/src/shell/help-shortcuts.ts +24 -0
- package/src/shell/settings-sections.ts +74 -0
- package/src/shell/shortcut-platform.ts +35 -0
- package/src/updates/channel-update-manager.ts +127 -0
- package/src/updates/desktop-updater.ts +440 -0
- package/src/updates/release-feed.ts +187 -0
- package/src/updates/release-location.ts +101 -0
- package/src/updates/release-version.ts +57 -0
- package/src/updates/signed-release.ts +311 -0
- package/src/updates/stable-file.ts +32 -0
- package/src/updates/update-adapter.ts +129 -0
- package/src/updates/update-arm.ts +107 -0
- package/src/updates/update-channel-store.ts +86 -0
- package/src/updates/update-discovery.ts +113 -0
- package/src/updates/update-download.ts +82 -0
- package/src/updates/update-exclusive-rename.ts +58 -0
- package/src/updates/update-extraction.ts +261 -0
- package/src/updates/update-handoff-plan.ts +75 -0
- package/src/updates/update-helper.ts +87 -0
- package/src/updates/update-launch.ts +33 -0
- package/src/updates/update-manager.ts +130 -0
- package/src/updates/update-process-fence.ts +125 -0
- package/src/updates/update-resume.ts +34 -0
- package/src/updates/update-shutdown.ts +37 -0
- package/src/updates/update-state.ts +34 -0
- package/src/updates/update-swap-stage.ts +75 -0
- package/src/updates/update-swap.ts +30 -0
- package/src/views/app-about.tsx +44 -0
- package/src/views/app-appearance.tsx +32 -0
- package/src/views/app-help.tsx +43 -0
- package/src/views/app-settings.tsx +88 -0
- package/src/views/appearance-surface.tsx +427 -0
- package/src/views/update-surface.tsx +85 -0
- package/templates/application/.gitattributes +1 -0
- package/templates/application/.github/workflows/release-assets.yml +29 -0
- package/templates/application/.github/workflows/release-finalize.yml +29 -0
- package/templates/application/.github/workflows/release-please.yml +19 -0
- package/templates/application/.github/workflows/release.yml +29 -0
- package/templates/application/.github/workflows/validation.yml +28 -0
- package/templates/application/.oxfmtrc.json +6 -0
- package/templates/application/.oxlintrc.json +48 -0
- package/templates/application/.release-please-manifest.json +3 -0
- package/templates/application/README.md +47 -0
- package/templates/application/electrobun.config.ts +22 -0
- package/templates/application/release-please-config.json +12 -0
- package/templates/application/scripts/app-version.ts +9 -0
- package/templates/application/scripts/build-desktop.ts +34 -0
- package/templates/application/scripts/secure-build.ts +1 -0
- package/templates/application/scripts/stage-release.ts +21 -0
- package/templates/application/src/bun/index.ts +80 -0
- package/templates/application/src/electrobun.d.ts +27 -0
- package/templates/application/src/web/index.html +12 -0
- package/templates/application/src/web/main.tsx +97 -0
- package/templates/application/src/web/public/icon.svg +1 -0
- package/templates/application/src/web/style.css +3 -0
- package/templates/application/tests/app-config.test.ts +9 -0
- package/templates/application/tsconfig.json +15 -0
- 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
|
+
}
|