@adea-ai/app-framework 0.24.0 → 0.24.1

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 (128) hide show
  1. package/README.md +43 -1
  2. package/dist/framework-source.json +1 -1
  3. package/dist/release/framework-package-publish.js +4 -2
  4. package/dist/shell/app-shell.js +21 -33
  5. package/dist/shell/navigation-drawer.d.ts +12 -0
  6. package/dist/shell/navigation-drawer.js +42 -0
  7. package/package.json +13 -2
  8. package/src/shell/app-shell.tsx +29 -20
  9. package/src/shell/navigation-drawer.tsx +36 -0
  10. package/src/app/create-application.ts +0 -245
  11. package/src/app/service-registry.ts +0 -124
  12. package/src/ci/toolchain-identity.ts +0 -244
  13. package/src/cli/cef-helper-cli.ts +0 -21
  14. package/src/cli/cli-runner.ts +0 -29
  15. package/src/cli/create-application-cli.ts +0 -62
  16. package/src/cli/electrobun-shortcut-patch-cli.ts +0 -24
  17. package/src/cli/framework-update-cli.ts +0 -41
  18. package/src/cli/release-assets-plan-cli.ts +0 -14
  19. package/src/cli/release-cut-cli.ts +0 -41
  20. package/src/cli/release-descriptor-staging-cli.ts +0 -57
  21. package/src/cli/release-finalize-cli.ts +0 -34
  22. package/src/cli/release-promote-cli.ts +0 -31
  23. package/src/cli/release-publish-cli.ts +0 -46
  24. package/src/cli/release-sign-cli.ts +0 -24
  25. package/src/cli/release-step-cli.ts +0 -71
  26. package/src/cli/toolchain-identity-cli.ts +0 -12
  27. package/src/cli/update-helper-cli.ts +0 -12
  28. package/src/cli/windows-runtime-patch-cli.ts +0 -17
  29. package/src/desktop/application-command-client.ts +0 -43
  30. package/src/desktop/channel-handshake.ts +0 -136
  31. package/src/desktop/channel-proof.ts +0 -122
  32. package/src/desktop/desktop-client.ts +0 -303
  33. package/src/desktop/desktop-gateway.ts +0 -189
  34. package/src/desktop/desktop-host.ts +0 -335
  35. package/src/desktop/desktop-stream.ts +0 -324
  36. package/src/desktop/loopback-policy.ts +0 -41
  37. package/src/desktop/open-url-channel.ts +0 -79
  38. package/src/desktop/string-policy.ts +0 -9
  39. package/src/installer/archive-entry.ts +0 -32
  40. package/src/installer/command-artifact.ts +0 -307
  41. package/src/installer/command-qualification-command.ts +0 -75
  42. package/src/installer/hosted-runner.ts +0 -11
  43. package/src/installer/installed-payload.ts +0 -408
  44. package/src/installer/installer-ci-bootstrap.ts +0 -199
  45. package/src/installer/installer-ci-preflight.ts +0 -61
  46. package/src/installer/installer-ci-worker.ts +0 -105
  47. package/src/installer/installer-extraction.ts +0 -367
  48. package/src/installer/installer-fetch-guard.ts +0 -75
  49. package/src/installer/installer-identity.ts +0 -331
  50. package/src/installer/installer-layout.ts +0 -167
  51. package/src/installer/installer-observation.ts +0 -671
  52. package/src/installer/installer-process-cleanup.ts +0 -167
  53. package/src/installer/installer-qualification-command.ts +0 -81
  54. package/src/installer/installer-renderer-evidence.ts +0 -268
  55. package/src/installer/installer-upgrade-command.ts +0 -226
  56. package/src/installer/installer-worker-guard.ts +0 -112
  57. package/src/installer/native-executable.ts +0 -37
  58. package/src/installer/upgrade-asset-download.ts +0 -72
  59. package/src/installer/write-all.ts +0 -19
  60. package/src/native/app-bundle.ts +0 -86
  61. package/src/native/cef-helper.ts +0 -471
  62. package/src/native/desktop-build-hook.ts +0 -21
  63. package/src/native/electrobun-source-patch.ts +0 -107
  64. package/src/native/linux-cef-links.ts +0 -14
  65. package/src/native/native-secret-store.ts +0 -99
  66. package/src/native/native-utilities.ts +0 -166
  67. package/src/native/partitioned-window.ts +0 -62
  68. package/src/native/secure-window.ts +0 -115
  69. package/src/native/sidecar-services.ts +0 -71
  70. package/src/native/sidecar.ts +0 -387
  71. package/src/native/window-bootstrap.ts +0 -77
  72. package/src/native/windows-build-hook-internal.ts +0 -49
  73. package/src/native/windows-build-hook.ts +0 -12
  74. package/src/native/windows-runtime-patch-internal.ts +0 -48
  75. package/src/native/windows-runtime-patch.ts +0 -15
  76. package/src/release/feed-release-cut.ts +0 -110
  77. package/src/release/feed-state.ts +0 -135
  78. package/src/release/framework-package-publish.ts +0 -163
  79. package/src/release/framework-update.ts +0 -196
  80. package/src/release/github-cli.ts +0 -27
  81. package/src/release/github-release-assets.ts +0 -36
  82. package/src/release/github-release-cut.ts +0 -237
  83. package/src/release/github-release-lookup.ts +0 -39
  84. package/src/release/github-release-promotion.ts +0 -112
  85. package/src/release/github-release-provenance.ts +0 -65
  86. package/src/release/github-release-publisher.ts +0 -90
  87. package/src/release/github-release-qualification.ts +0 -144
  88. package/src/release/local-provenance.ts +0 -92
  89. package/src/release/local-release.ts +0 -525
  90. package/src/release/macos-dmg.ts +0 -113
  91. package/src/release/release-artifact.ts +0 -53
  92. package/src/release/release-assets-plan.ts +0 -118
  93. package/src/release/release-config.ts +0 -420
  94. package/src/release/release-cut-command.ts +0 -80
  95. package/src/release/release-cut.ts +0 -133
  96. package/src/release/release-descriptor-staging.ts +0 -242
  97. package/src/release/release-finalize.ts +0 -191
  98. package/src/release/release-promotion-command.ts +0 -36
  99. package/src/release/release-promotion.ts +0 -132
  100. package/src/release/release-publication.ts +0 -213
  101. package/src/release/release-publish-command.ts +0 -163
  102. package/src/release/release-qualification.ts +0 -397
  103. package/src/release/release-staging.ts +0 -87
  104. package/src/release/release-steps.ts +0 -173
  105. package/src/release/retained-release-build.ts +0 -217
  106. package/src/shell/application-menu-commands.ts +0 -6
  107. package/src/shell/application-menu.ts +0 -250
  108. package/src/updates/channel-update-manager.ts +0 -127
  109. package/src/updates/desktop-updater.ts +0 -440
  110. package/src/updates/release-feed.ts +0 -187
  111. package/src/updates/release-location.ts +0 -101
  112. package/src/updates/signed-release.ts +0 -311
  113. package/src/updates/stable-file.ts +0 -32
  114. package/src/updates/update-arm.ts +0 -107
  115. package/src/updates/update-channel-store.ts +0 -86
  116. package/src/updates/update-discovery.ts +0 -113
  117. package/src/updates/update-download.ts +0 -82
  118. package/src/updates/update-exclusive-rename.ts +0 -58
  119. package/src/updates/update-extraction.ts +0 -261
  120. package/src/updates/update-handoff-plan.ts +0 -75
  121. package/src/updates/update-helper.ts +0 -87
  122. package/src/updates/update-launch.ts +0 -33
  123. package/src/updates/update-manager.ts +0 -130
  124. package/src/updates/update-process-fence.ts +0 -125
  125. package/src/updates/update-resume.ts +0 -34
  126. package/src/updates/update-shutdown.ts +0 -37
  127. package/src/updates/update-swap-stage.ts +0 -75
  128. package/src/updates/update-swap.ts +0 -30
@@ -1,213 +0,0 @@
1
- import { createHash } from 'node:crypto'
2
- import { lstat, mkdtemp, open, rm, writeFile } from 'node:fs/promises'
3
- import { tmpdir } from 'node:os'
4
- import { join, resolve } from 'node:path'
5
- import { openUnchangedFile, sameFile } from '../updates/stable-file'
6
- import { verifyReleaseDescriptor, type ReleaseTrust } from '../updates/signed-release'
7
- import { releaseAssetNames } from './release-config'
8
- import {
9
- validateReleaseQualification,
10
- type Artifact,
11
- type CommandReceipt,
12
- type InstallerReceipt,
13
- type Qualification,
14
- type ReleaseIdentity,
15
- type Requirements,
16
- } from './release-qualification'
17
-
18
- export type RemoteReleaseState = {
19
- tag: string
20
- sourceSha: string
21
- sourceOnMain: boolean
22
- workflowOnMain: boolean
23
- draft: boolean
24
- assets: Artifact[]
25
- }
26
- export type ReleasePublisher = {
27
- /** Read tag target, release status, current assets and ancestry from the trusted provider. */
28
- inspect(identity: ReleaseIdentity): Promise<RemoteReleaseState>
29
- /** Upload without replacing an existing asset; reject name collisions. */
30
- upload(path: string, artifact: Artifact): Promise<void>
31
- }
32
- function same(left: Artifact, right: Artifact) {
33
- return left.name === right.name && left.size === right.size && left.digest === right.digest
34
- }
35
- /** Hash one staged regular file without following links, refusing a change while reading. */
36
- export async function fileIdentity(path: string, name: string): Promise<Artifact> {
37
- const info = await lstat(path)
38
- if (!info.isFile() || info.isSymbolicLink()) throw new Error('Invalid staged artifact')
39
- const { file, before } = await openUnchangedFile(path, info, 'Invalid staged artifact')
40
- try {
41
- if (!Number.isSafeInteger(before.size) || before.size < 1)
42
- throw new Error('Invalid staged artifact')
43
- const hash = createHash('sha256')
44
- let size = 0
45
- for await (const chunk of file.createReadStream({ autoClose: false })) {
46
- size += chunk.length
47
- if (size > before.size) throw new Error('Staged artifact changed')
48
- hash.update(chunk)
49
- }
50
- const after = await file.stat()
51
- if (size !== before.size || !sameFile(before, after)) throw new Error('Staged artifact changed')
52
- return { name, size, digest: 'sha256:' + hash.digest('hex') }
53
- } finally {
54
- await file.close()
55
- }
56
- }
57
-
58
- /** Publish a qualified attempt with immutable payloads and discovery assets last. */
59
- export async function publishQualifiedRelease(options: {
60
- directory: string
61
- identity: ReleaseIdentity
62
- requirements: Requirements
63
- installerReceipts: InstallerReceipt[]
64
- /** Required exactly when the requirements name command artifacts. */
65
- commandReceipts?: CommandReceipt[]
66
- discoveryTrust: Record<string, { trust: ReleaseTrust; allowedPayloads: readonly string[] }>
67
- remote: ReleasePublisher
68
- allowDraft?: boolean
69
- }): Promise<Qualification> {
70
- const { identity, requirements, remote } = options
71
- const directory = resolve(options.directory)
72
- const names = releaseAssetNames(requirements)
73
- if (
74
- !names.length ||
75
- new Set(names).size !== names.length ||
76
- names.some((name) => !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name))
77
- )
78
- throw new Error('Invalid release asset names')
79
- const discoveryAssets = Object.keys(options.discoveryTrust)
80
- if (
81
- !discoveryAssets.length ||
82
- new Set(discoveryAssets).size !== discoveryAssets.length ||
83
- discoveryAssets.some((name) => !requirements.releaseAssets.includes(name))
84
- )
85
- throw new Error('Invalid discovery assets')
86
- for (const config of Object.values(options.discoveryTrust)) {
87
- if (
88
- !config.allowedPayloads.length ||
89
- new Set(config.allowedPayloads).size !== config.allowedPayloads.length ||
90
- config.allowedPayloads.some((name) => !names.includes(name) || discoveryAssets.includes(name))
91
- )
92
- throw new Error('Invalid discovery payload policy')
93
- }
94
- const staged = await Promise.all(names.map((name) => fileIdentity(join(directory, name), name)))
95
- const platforms = Object.keys(requirements.platforms)
96
- const receipt: Qualification = {
97
- schema: 2,
98
- ...identity,
99
- platforms,
100
- installerTests: platforms,
101
- installerReceipts: options.installerReceipts,
102
- ...(options.commandReceipts ? { commandReceipts: options.commandReceipts } : {}),
103
- assets: staged,
104
- }
105
- validateReleaseQualification(
106
- { tag_name: identity.tag, draft: false, assets: staged },
107
- receipt,
108
- identity.sourceSha,
109
- requirements
110
- )
111
- for (const name of discoveryAssets) {
112
- const expected = staged.find((asset) => asset.name === name)!
113
- if (expected.size > 65536) throw new Error('Discovery asset is too large')
114
- const handle = await open(join(directory, name), 'r')
115
- let bytes: Buffer
116
- try {
117
- const buffer = Buffer.alloc(65537)
118
- let offset = 0
119
- while (offset < buffer.length) {
120
- const result = await handle.read(buffer, offset, buffer.length - offset, offset)
121
- if (!result.bytesRead) break
122
- offset += result.bytesRead
123
- }
124
- bytes = buffer.subarray(0, offset)
125
- } finally {
126
- await handle.close()
127
- }
128
- if (
129
- bytes.length !== expected.size ||
130
- 'sha256:' + createHash('sha256').update(bytes).digest('hex') !== expected.digest
131
- )
132
- throw new Error('Discovery asset changed')
133
- let parsed: unknown
134
- try {
135
- parsed = JSON.parse(bytes.toString('utf8'))
136
- } catch {
137
- throw new Error('Invalid discovery asset')
138
- }
139
- const verified = verifyReleaseDescriptor(parsed, options.discoveryTrust[name]!.trust)
140
- if (!verified.ok) throw new Error('Untrusted discovery asset')
141
- const descriptor = verified.descriptor
142
- if (
143
- descriptor.tag !== identity.tag ||
144
- descriptor.sourceSha !== identity.sourceSha ||
145
- descriptor.workflowSha !== identity.workflowSha ||
146
- descriptor.runId !== identity.runId ||
147
- descriptor.runAttempt !== identity.runAttempt
148
- )
149
- throw new Error('Discovery provenance mismatch')
150
- const payload = staged.find((asset) => asset.name === descriptor.asset.name)
151
- if (
152
- !payload ||
153
- !options.discoveryTrust[name]!.allowedPayloads.includes(payload.name) ||
154
- payload.size !== descriptor.asset.size ||
155
- payload.digest !== 'sha256:' + descriptor.asset.sha256
156
- )
157
- throw new Error('Discovery payload mismatch')
158
- }
159
-
160
- const receiptName = `qualification-${identity.runId}-${identity.runAttempt}.json`
161
- if (names.includes(receiptName)) throw new Error('Qualification asset collides with payload')
162
- const bytes = Buffer.from(JSON.stringify(receipt, null, 2) + '\n')
163
- const receiptArtifact = {
164
- name: receiptName,
165
- size: bytes.length,
166
- digest: 'sha256:' + createHash('sha256').update(bytes).digest('hex'),
167
- }
168
- const ordered = [
169
- ...staged.filter((asset) => !discoveryAssets.includes(asset.name)),
170
- receiptArtifact,
171
- ...staged.filter((asset) => discoveryAssets.includes(asset.name)),
172
- ]
173
- let expectedDraft: boolean | undefined
174
- const check = async () => {
175
- const state = await remote.inspect(identity)
176
- if (
177
- state.tag !== identity.tag ||
178
- state.sourceSha !== identity.sourceSha ||
179
- !state.sourceOnMain ||
180
- !state.workflowOnMain ||
181
- (state.draft && options.allowDraft !== true) ||
182
- (expectedDraft !== undefined && state.draft !== expectedDraft)
183
- )
184
- throw new Error('Untrusted release identity')
185
- expectedDraft = state.draft
186
- for (const expected of ordered) {
187
- const existing = state.assets.filter((asset) => asset.name === expected.name)
188
- if (existing.length > 1 || (existing.length && !same(existing[0]!, expected)))
189
- throw new Error(`Immutable asset conflict: ${expected.name}`)
190
- }
191
- return state
192
- }
193
- await check() // No public writes before all receipts, source and existing payloads pass.
194
- const temp = await mkdtemp(join(tmpdir(), 'framework-qualification-'))
195
- try {
196
- const receiptPath = join(temp, receiptName)
197
- await writeFile(receiptPath, bytes, { flag: 'wx' })
198
- for (const artifact of ordered) {
199
- const state = await check()
200
- if (state.assets.some((asset) => asset.name === artifact.name)) continue
201
- const path = artifact.name === receiptName ? receiptPath : join(directory, artifact.name)
202
- if (!same(await fileIdentity(path, artifact.name), artifact))
203
- throw new Error('Staged artifact changed before upload')
204
- await remote.upload(path, artifact)
205
- const published = await check()
206
- if (!published.assets.some((asset) => same(asset, artifact)))
207
- throw new Error('Published artifact differs from staging')
208
- }
209
- return receipt
210
- } finally {
211
- await rm(temp, { recursive: true, force: true })
212
- }
213
- }
@@ -1,163 +0,0 @@
1
- import { githubCli } from './github-cli'
2
- import { open } from 'node:fs/promises'
3
- import { join, resolve } from 'node:path'
4
- import { createGitHubReleasePublisher } from './github-release-publisher'
5
- import { publishQualifiedRelease } from './release-publication'
6
- import { discoveryPolicies, parseReleaseConfig } from './release-config'
7
- import { commandReceiptName } from '../installer/command-qualification-command'
8
- import type { CommandReceipt, InstallerReceipt } from './release-qualification'
9
- import { feedUrl } from '../updates/release-feed'
10
- import { assertRepositorySlug, type ReleaseTrust } from '../updates/signed-release'
11
-
12
- const record = (value: unknown): value is Record<string, unknown> =>
13
- typeof value === 'object' && value !== null && !Array.isArray(value)
14
- async function boundedJson(path: string): Promise<unknown> {
15
- const handle = await open(path, 'r')
16
- try {
17
- const stat = await handle.stat()
18
- if (!stat.isFile() || stat.size < 1 || stat.size > 262144) throw new Error('Invalid receipt')
19
- const buffer = Buffer.alloc(stat.size + 1)
20
- let offset = 0
21
- while (offset < buffer.length) {
22
- const result = await handle.read(buffer, offset, buffer.length - offset, offset)
23
- if (!result.bytesRead) break
24
- offset += result.bytesRead
25
- }
26
- if (offset !== stat.size) throw new Error('Receipt changed')
27
- return JSON.parse(buffer.subarray(0, offset).toString('utf8'))
28
- } finally {
29
- await handle.close()
30
- }
31
- }
32
-
33
- /** Publish only the current trusted release-assets attempt and its staged receipts. */
34
- export async function runReleasePublishCommand(options: {
35
- env: Record<string, string | undefined>
36
- config: unknown
37
- directory: string
38
- run?: (args: string[], input?: string) => Promise<string>
39
- }) {
40
- const { env, config } = options
41
- if (
42
- env.GITHUB_ACTIONS !== 'true' ||
43
- env.GITHUB_REF !== 'refs/heads/main' ||
44
- env.GITHUB_EVENT_NAME !== 'workflow_dispatch' ||
45
- !env.GITHUB_REPOSITORY ||
46
- !/^[a-f0-9]{40}$/.test(env.GITHUB_SHA ?? '') ||
47
- !/^[a-f0-9]{40}$/.test(env.SOURCE_SHA ?? '') ||
48
- !/^[1-9]\d{0,19}$/.test(env.GITHUB_RUN_ID ?? '') ||
49
- !/^[1-9]\d{0,8}$/.test(env.GITHUB_RUN_ATTEMPT ?? '') ||
50
- !/^v\d+\.\d+\.\d+(?:-dev\.\d+)?$/.test(env.RELEASE_TAG ?? '')
51
- )
52
- throw new Error('Publication requires a trusted release-assets workflow')
53
- assertRepositorySlug(env.GITHUB_REPOSITORY)
54
- const { requirements, releasePleaseManifestPath, releaseWorkflows, feed } =
55
- parseReleaseConfig(config)
56
- if (
57
- !record(config) ||
58
- typeof config.appId !== 'string' ||
59
- !/^[a-z][a-z0-9-]*(?:\.[a-z][a-z0-9-]*)+$/.test(config.appId) ||
60
- config.appId.length > 255 ||
61
- !record(config.releaseSigningKeys) ||
62
- !record(config.descriptors)
63
- )
64
- throw new Error('Invalid release signing configuration')
65
- const keyEntries = Object.entries(config.releaseSigningKeys)
66
- if (!keyEntries.length || keyEntries.length > 16)
67
- throw new Error('Missing release verification keys')
68
- const keys = new Map<string, string>()
69
- for (const [id, encoded] of keyEntries) {
70
- if (!/^[a-z0-9][a-z0-9._-]{0,63}$/.test(id) || typeof encoded !== 'string')
71
- throw new Error('Invalid release verification key')
72
- const raw = Buffer.from(encoded, 'base64')
73
- if (raw.length !== 32 || raw.toString('base64') !== encoded)
74
- throw new Error('Invalid release verification key')
75
- keys.set(id, encoded)
76
- }
77
- const tag = env.RELEASE_TAG!,
78
- repository = env.GITHUB_REPOSITORY,
79
- releaseRequirements = requirements(tag)
80
- const isDev = tag.includes('-dev.')
81
- const discoveryTrust: Record<
82
- string,
83
- { trust: ReleaseTrust; allowedPayloads: readonly string[] }
84
- > = {}
85
- for (const policy of discoveryPolicies(config, tag))
86
- discoveryTrust[policy.name] = {
87
- trust: {
88
- appId: policy.appId,
89
- repository,
90
- channel: policy.channel,
91
- platform: policy.os,
92
- arch: policy.arch,
93
- feed: feedUrl(feed),
94
- keys,
95
- },
96
- allowedPayloads: [policy.payload],
97
- }
98
- const run = options.run ?? githubCli()
99
- const workflow = JSON.parse(
100
- await run([
101
- 'api',
102
- `repos/${repository}/actions/runs/${env.GITHUB_RUN_ID}/attempts/${env.GITHUB_RUN_ATTEMPT}`,
103
- ])
104
- ) as {
105
- id?: unknown
106
- run_attempt?: unknown
107
- head_sha?: unknown
108
- event?: unknown
109
- path?: unknown
110
- repository?: { full_name?: unknown }
111
- }
112
- if (
113
- String(workflow?.id) !== env.GITHUB_RUN_ID ||
114
- String(workflow?.run_attempt) !== env.GITHUB_RUN_ATTEMPT ||
115
- workflow?.head_sha !== env.GITHUB_SHA ||
116
- workflow?.event !== 'workflow_dispatch' ||
117
- workflow?.path !== releaseWorkflows.assets ||
118
- workflow?.repository?.full_name !== repository
119
- )
120
- throw new Error('Release-assets workflow provenance mismatch')
121
- const directory = resolve(options.directory)
122
- const installerReceipts = await Promise.all(
123
- Object.keys(releaseRequirements.platforms).map(
124
- async (platform) =>
125
- (await boundedJson(join(directory, `installer-test-${platform}.json`))) as InstallerReceipt
126
- )
127
- )
128
- const commandReceipts = releaseRequirements.commandArtifacts
129
- ? await Promise.all(
130
- Object.entries(releaseRequirements.commandArtifacts).flatMap(([kind, byPlatform]) =>
131
- Object.keys(byPlatform).map(
132
- async (platform) =>
133
- (await boundedJson(
134
- join(directory, commandReceiptName(kind, platform))
135
- )) as CommandReceipt
136
- )
137
- )
138
- )
139
- : undefined
140
- const identity = {
141
- tag,
142
- sourceSha: env.SOURCE_SHA!,
143
- workflowSha: env.GITHUB_SHA!,
144
- runId: env.GITHUB_RUN_ID!,
145
- runAttempt: Number(env.GITHUB_RUN_ATTEMPT),
146
- }
147
- const remote = createGitHubReleasePublisher({
148
- repository,
149
- identity,
150
- releasePleaseManifestPath,
151
- run,
152
- })
153
- return publishQualifiedRelease({
154
- directory,
155
- identity,
156
- requirements: releaseRequirements,
157
- installerReceipts,
158
- ...(commandReceipts ? { commandReceipts } : {}),
159
- discoveryTrust,
160
- remote,
161
- allowDraft: !isDev,
162
- })
163
- }