@msn-control/liftoff 0.11.2 → 0.12.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/DEVELOPER.md +26 -24
- package/README.md +18 -18
- package/assets/governance/single-maintainer-gitflow/activation-v2-graph.json +1583 -0
- package/dist/adapters/credentials/github-enrollment.d.ts +51 -0
- package/dist/adapters/credentials/github-enrollment.js +226 -0
- package/dist/adapters/credentials/github-enrollment.js.map +1 -0
- package/dist/adapters/credentials/protected-input.d.ts +7 -0
- package/dist/adapters/credentials/protected-input.js +68 -0
- package/dist/adapters/credentials/protected-input.js.map +1 -0
- package/dist/adapters/filesystem/executables.d.ts +2 -0
- package/dist/adapters/filesystem/executables.js +70 -0
- package/dist/adapters/filesystem/executables.js.map +1 -0
- package/dist/adapters/filesystem/update-previews.d.ts +9 -0
- package/dist/adapters/filesystem/update-previews.js +45 -2
- package/dist/adapters/filesystem/update-previews.js.map +1 -1
- package/dist/adapters/filesystem/workstation-attempts.d.ts +13 -0
- package/dist/adapters/filesystem/workstation-attempts.js +78 -0
- package/dist/adapters/filesystem/workstation-attempts.js.map +1 -0
- package/dist/adapters/github/activation-rest.d.ts +40 -0
- package/dist/adapters/github/activation-rest.js +272 -0
- package/dist/adapters/github/activation-rest.js.map +1 -0
- package/dist/adapters/process/shell-command.d.ts +1 -0
- package/dist/adapters/process/shell-command.js +5 -2
- package/dist/adapters/process/shell-command.js.map +1 -1
- package/dist/adapters/state/azure-blob.d.ts +43 -0
- package/dist/adapters/state/azure-blob.js +335 -0
- package/dist/adapters/state/azure-blob.js.map +1 -0
- package/dist/adapters/state/darwin-capabilities.d.ts +33 -0
- package/dist/adapters/state/darwin-capabilities.js +146 -0
- package/dist/adapters/state/darwin-capabilities.js.map +1 -0
- package/dist/adapters/state/darwin-native-host.d.ts +32 -0
- package/dist/adapters/state/darwin-native-host.js +294 -0
- package/dist/adapters/state/darwin-native-host.js.map +1 -0
- package/dist/adapters/state/darwin-profile.d.ts +6 -0
- package/dist/adapters/state/darwin-profile.js +56 -0
- package/dist/adapters/state/darwin-profile.js.map +1 -0
- package/dist/adapters/state/darwin-system-program.d.ts +1 -0
- package/dist/adapters/state/darwin-system-program.js +94 -0
- package/dist/adapters/state/darwin-system-program.js.map +1 -0
- package/dist/adapters/state/local-qualification.d.ts +16 -0
- package/dist/adapters/state/local-qualification.js +299 -0
- package/dist/adapters/state/local-qualification.js.map +1 -0
- package/dist/adapters/state/local.d.ts +25 -0
- package/dist/adapters/state/local.js +145 -0
- package/dist/adapters/state/local.js.map +1 -0
- package/dist/adapters/state/native-command.d.ts +21 -0
- package/dist/adapters/state/native-command.js +82 -0
- package/dist/adapters/state/native-command.js.map +1 -0
- package/dist/adapters/state/native-files.d.ts +2 -0
- package/dist/adapters/state/native-files.js +47 -0
- package/dist/adapters/state/native-files.js.map +1 -0
- package/dist/adapters/state/native-system.d.ts +38 -0
- package/dist/adapters/state/native-system.js +86 -0
- package/dist/adapters/state/native-system.js.map +1 -0
- package/dist/adapters/state/opentofu.d.ts +35 -0
- package/dist/adapters/state/opentofu.js +350 -0
- package/dist/adapters/state/opentofu.js.map +1 -0
- package/dist/adapters/state/owned-process.d.ts +43 -0
- package/dist/adapters/state/owned-process.js +252 -0
- package/dist/adapters/state/owned-process.js.map +1 -0
- package/dist/adapters/state/posix-lock-program.d.ts +1 -0
- package/dist/adapters/state/posix-lock-program.js +185 -0
- package/dist/adapters/state/posix-lock-program.js.map +1 -0
- package/dist/adapters/state/posix-native-lock.d.ts +15 -0
- package/dist/adapters/state/posix-native-lock.js +145 -0
- package/dist/adapters/state/posix-native-lock.js.map +1 -0
- package/dist/adapters/state/protected-workspace.d.ts +57 -0
- package/dist/adapters/state/protected-workspace.js +412 -0
- package/dist/adapters/state/protected-workspace.js.map +1 -0
- package/dist/application/context.d.ts +3 -0
- package/dist/application/diagnose/doctor.d.ts +5 -0
- package/dist/application/diagnose/doctor.js +21 -5
- package/dist/application/diagnose/doctor.js.map +1 -1
- package/dist/application/diagnose/generated-project.js +2 -7
- package/dist/application/diagnose/generated-project.js.map +1 -1
- package/dist/application/initialize/fixture.js +8 -1
- package/dist/application/initialize/fixture.js.map +1 -1
- package/dist/application/initialize/use-case.js +70 -36
- package/dist/application/initialize/use-case.js.map +1 -1
- package/dist/application/project/manifest.js +5 -4
- package/dist/application/project/manifest.js.map +1 -1
- package/dist/application/state-migration/execution.d.ts +32 -0
- package/dist/application/state-migration/execution.js +440 -0
- package/dist/application/state-migration/execution.js.map +1 -0
- package/dist/application/state-migration/index.d.ts +22 -0
- package/dist/application/state-migration/index.js +17 -0
- package/dist/application/state-migration/index.js.map +1 -0
- package/dist/application/state-migration/lifecycle.d.ts +3 -0
- package/dist/application/state-migration/lifecycle.js +149 -0
- package/dist/application/state-migration/lifecycle.js.map +1 -0
- package/dist/application/state-migration/planning.d.ts +7 -0
- package/dist/application/state-migration/planning.js +150 -0
- package/dist/application/state-migration/planning.js.map +1 -0
- package/dist/application/state-migration/recovery.d.ts +5 -0
- package/dist/application/state-migration/recovery.js +145 -0
- package/dist/application/state-migration/recovery.js.map +1 -0
- package/dist/application/state-migration/runtime.d.ts +32 -0
- package/dist/application/state-migration/runtime.js +188 -0
- package/dist/application/state-migration/runtime.js.map +1 -0
- package/dist/application/state-migration/service.d.ts +2 -0
- package/dist/application/state-migration/service.js +20 -0
- package/dist/application/state-migration/service.js.map +1 -0
- package/dist/application/update/command-guidance.d.ts +19 -2
- package/dist/application/update/command-guidance.js +20 -6
- package/dist/application/update/command-guidance.js.map +1 -1
- package/dist/application/update/guidance-context.d.ts +2 -0
- package/dist/application/update/guidance-context.js +35 -0
- package/dist/application/update/guidance-context.js.map +1 -0
- package/dist/application/update/inspection.d.ts +21 -4
- package/dist/application/update/inspection.js +88 -29
- package/dist/application/update/inspection.js.map +1 -1
- package/dist/application/update/migration-runtime.js +25 -13
- package/dist/application/update/migration-runtime.js.map +1 -1
- package/dist/application/update/output.d.ts +4 -1
- package/dist/application/update/output.js +14 -4
- package/dist/application/update/output.js.map +1 -1
- package/dist/application/update/preview.d.ts +10 -1
- package/dist/application/update/preview.js +26 -4
- package/dist/application/update/preview.js.map +1 -1
- package/dist/application/update/revalidation-plan.d.ts +1 -0
- package/dist/application/update/revalidation-plan.js +27 -15
- package/dist/application/update/revalidation-plan.js.map +1 -1
- package/dist/application/update/revalidation.d.ts +4 -1
- package/dist/application/update/revalidation.js +64 -23
- package/dist/application/update/revalidation.js.map +1 -1
- package/dist/application/update/use-case.js +50 -29
- package/dist/application/update/use-case.js.map +1 -1
- package/dist/cli/args/definitions.js +11 -3
- package/dist/cli/args/definitions.js.map +1 -1
- package/dist/cli/args/parser.js +29 -3
- package/dist/cli/args/parser.js.map +1 -1
- package/dist/domain/governance/activation/approvals.d.ts +264 -7
- package/dist/domain/governance/activation/approvals.js +166 -23
- package/dist/domain/governance/activation/approvals.js.map +1 -1
- package/dist/domain/governance/activation/capabilities.js +5 -2
- package/dist/domain/governance/activation/capabilities.js.map +1 -1
- package/dist/domain/governance/activation/evidence.d.ts +2 -1
- package/dist/domain/governance/activation/evidence.js +64 -11
- package/dist/domain/governance/activation/evidence.js.map +1 -1
- package/dist/domain/governance/activation/graph.d.ts +11 -384
- package/dist/domain/governance/activation/graph.js +424 -379
- package/dist/domain/governance/activation/graph.js.map +1 -1
- package/dist/domain/governance/activation/inputs.d.ts +3 -1
- package/dist/domain/governance/activation/inputs.js +47 -6
- package/dist/domain/governance/activation/inputs.js.map +1 -1
- package/dist/domain/governance/activation/operations.d.ts +4 -1
- package/dist/domain/governance/activation/operations.js +110 -22
- package/dist/domain/governance/activation/operations.js.map +1 -1
- package/dist/domain/governance/activation/readiness.d.ts +10 -0
- package/dist/domain/governance/activation/readiness.js +77 -38
- package/dist/domain/governance/activation/readiness.js.map +1 -1
- package/dist/domain/governance/activation/types.d.ts +151 -9
- package/dist/domain/governance/activation/types.js +23 -1
- package/dist/domain/governance/activation/types.js.map +1 -1
- package/dist/domain/governance/activation/validators.d.ts +4 -1
- package/dist/domain/governance/activation/validators.js +419 -26
- package/dist/domain/governance/activation/validators.js.map +1 -1
- package/dist/domain/governance/policy/identity.d.ts +55 -13
- package/dist/domain/governance/policy/identity.js +28 -8
- package/dist/domain/governance/policy/identity.js.map +1 -1
- package/dist/domain/project/artifact-lifecycle.d.ts +2 -1
- package/dist/domain/project/artifact-lifecycle.js +7 -1
- package/dist/domain/project/artifact-lifecycle.js.map +1 -1
- package/dist/domain/project/catalog.d.ts +50 -1
- package/dist/domain/project/catalog.js +104 -4
- package/dist/domain/project/catalog.js.map +1 -1
- package/dist/domain/project/contracts.d.ts +9 -1
- package/dist/domain/project/infrastructure-layout.d.ts +1 -1
- package/dist/domain/project/infrastructure-layout.js +3 -1
- package/dist/domain/project/infrastructure-layout.js.map +1 -1
- package/dist/domain/project/manifest/governance.d.ts +1 -1
- package/dist/domain/project/manifest/governance.js +9 -10
- package/dist/domain/project/manifest/governance.js.map +1 -1
- package/dist/domain/project/planning.js +4 -5
- package/dist/domain/project/planning.js.map +1 -1
- package/dist/domain/repair/stateful-bounded.d.ts +1 -0
- package/dist/domain/repair/stateful-bounded.js +37 -0
- package/dist/domain/repair/stateful-bounded.js.map +1 -0
- package/dist/domain/repair/stateful-invariants.d.ts +28 -0
- package/dist/domain/repair/stateful-invariants.js +278 -0
- package/dist/domain/repair/stateful-invariants.js.map +1 -0
- package/dist/domain/repair/stateful.d.ts +690 -0
- package/dist/domain/repair/stateful.js +26 -0
- package/dist/domain/repair/stateful.js.map +1 -0
- package/dist/domain/workstation/constraints.d.ts +1 -0
- package/dist/domain/workstation/constraints.js.map +1 -1
- package/dist/domain/workstation/contracts.d.ts +42 -0
- package/dist/domain/workstation/contracts.js +2 -0
- package/dist/domain/workstation/contracts.js.map +1 -0
- package/dist/domain/workstation/executables.d.ts +19 -0
- package/dist/domain/workstation/executables.js +68 -0
- package/dist/domain/workstation/executables.js.map +1 -0
- package/dist/domain/workstation/versions.d.ts +8 -0
- package/dist/domain/workstation/versions.js +145 -0
- package/dist/domain/workstation/versions.js.map +1 -0
- package/dist/framework-adapters.d.ts +2 -0
- package/dist/framework-adapters.js +148 -22
- package/dist/framework-adapters.js.map +1 -1
- package/dist/framework-validation.d.ts +6 -0
- package/dist/framework-validation.js +89 -24
- package/dist/framework-validation.js.map +1 -1
- package/dist/generators/common/base.js +57 -17
- package/dist/generators/common/base.js.map +1 -1
- package/dist/governance-activation/activation-state.js +39 -7
- package/dist/governance-activation/activation-state.js.map +1 -1
- package/dist/governance-activation/authority-records.d.ts +4 -0
- package/dist/governance-activation/authority-records.js +24 -0
- package/dist/governance-activation/authority-records.js.map +1 -0
- package/dist/governance-activation/commands.d.ts +9 -1
- package/dist/governance-activation/commands.js +392 -97
- package/dist/governance-activation/commands.js.map +1 -1
- package/dist/governance-activation/compatibility.d.ts +11 -8
- package/dist/governance-activation/compatibility.js +37 -23
- package/dist/governance-activation/compatibility.js.map +1 -1
- package/dist/governance-activation/doctor.js +40 -16
- package/dist/governance-activation/doctor.js.map +1 -1
- package/dist/governance-activation/github-config.d.ts +17 -0
- package/dist/governance-activation/github-config.js +88 -0
- package/dist/governance-activation/github-config.js.map +1 -0
- package/dist/governance-activation/github-discovery.d.ts +18 -0
- package/dist/governance-activation/github-discovery.js +229 -0
- package/dist/governance-activation/github-discovery.js.map +1 -0
- package/dist/governance-activation/github-ports.d.ts +12 -0
- package/dist/governance-activation/github-ports.js +4 -0
- package/dist/governance-activation/github-ports.js.map +1 -0
- package/dist/governance-activation/github-publication.d.ts +3 -0
- package/dist/governance-activation/github-publication.js +190 -0
- package/dist/governance-activation/github-publication.js.map +1 -0
- package/dist/governance-activation/historical-common.d.ts +98 -0
- package/dist/governance-activation/historical-common.js +269 -0
- package/dist/governance-activation/historical-common.js.map +1 -0
- package/dist/governance-activation/historical-credential-policy.d.ts +3 -0
- package/dist/governance-activation/historical-credential-policy.js +91 -0
- package/dist/governance-activation/historical-credential-policy.js.map +1 -0
- package/dist/governance-activation/historical-inputs.d.ts +6 -0
- package/dist/governance-activation/historical-inputs.js +57 -0
- package/dist/governance-activation/historical-inputs.js.map +1 -0
- package/dist/governance-activation/historical-safety.d.ts +9 -0
- package/dist/governance-activation/historical-safety.js +102 -0
- package/dist/governance-activation/historical-safety.js.map +1 -0
- package/dist/governance-activation/historical-source-metadata.d.ts +31 -0
- package/dist/governance-activation/historical-source-metadata.js +55 -0
- package/dist/governance-activation/historical-source-metadata.js.map +1 -0
- package/dist/governance-activation/historical-state.d.ts +12 -50
- package/dist/governance-activation/historical-state.js +195 -308
- package/dist/governance-activation/historical-state.js.map +1 -1
- package/dist/governance-activation/historical-v1-auxiliary.d.ts +1 -0
- package/dist/governance-activation/historical-v1-auxiliary.js +43 -0
- package/dist/governance-activation/historical-v1-auxiliary.js.map +1 -0
- package/dist/governance-activation/historical-v1-phase-contracts.d.ts +31 -0
- package/dist/governance-activation/historical-v1-phase-contracts.js +46 -0
- package/dist/governance-activation/historical-v1-phase-contracts.js.map +1 -0
- package/dist/governance-activation/historical-v2.d.ts +53 -0
- package/dist/governance-activation/historical-v2.js +313 -0
- package/dist/governance-activation/historical-v2.js.map +1 -0
- package/dist/governance-activation/history-contracts.d.ts +21 -12
- package/dist/governance-activation/history-contracts.js +99 -27
- package/dist/governance-activation/history-contracts.js.map +1 -1
- package/dist/governance-activation/inputs.d.ts +8 -2
- package/dist/governance-activation/inputs.js +41 -6
- package/dist/governance-activation/inputs.js.map +1 -1
- package/dist/governance-activation/migration-history.d.ts +43 -5
- package/dist/governance-activation/migration-history.js +231 -50
- package/dist/governance-activation/migration-history.js.map +1 -1
- package/dist/governance-activation/migration.d.ts +7 -4
- package/dist/governance-activation/migration.js +53 -252
- package/dist/governance-activation/migration.js.map +1 -1
- package/dist/governance-activation/phase-azure.d.ts +3 -0
- package/dist/governance-activation/phase-azure.js +205 -0
- package/dist/governance-activation/phase-azure.js.map +1 -0
- package/dist/governance-activation/phase-bootstrap-state.js +3 -0
- package/dist/governance-activation/phase-bootstrap-state.js.map +1 -1
- package/dist/governance-activation/phase-github.d.ts +3 -0
- package/dist/governance-activation/phase-github.js +192 -0
- package/dist/governance-activation/phase-github.js.map +1 -0
- package/dist/governance-activation/phase-governance.js +8 -2
- package/dist/governance-activation/phase-governance.js.map +1 -1
- package/dist/governance-activation/public-plans.d.ts +36 -0
- package/dist/governance-activation/public-plans.js +100 -0
- package/dist/governance-activation/public-plans.js.map +1 -0
- package/dist/governance-activation/read-only.d.ts +3 -1
- package/dist/governance-activation/read-only.js +7 -3
- package/dist/governance-activation/read-only.js.map +1 -1
- package/dist/governance-activation/reconciliation.js +10 -0
- package/dist/governance-activation/reconciliation.js.map +1 -1
- package/dist/governance-activation/seed-lifecycle.js +14 -25
- package/dist/governance-activation/seed-lifecycle.js.map +1 -1
- package/dist/governance-activation/source-of-truth.d.ts +21 -5
- package/dist/governance-activation/source-of-truth.js +102 -13
- package/dist/governance-activation/source-of-truth.js.map +1 -1
- package/dist/governance-activation/task-projection.d.ts +4 -1
- package/dist/governance-activation/task-projection.js +32 -3
- package/dist/governance-activation/task-projection.js.map +1 -1
- package/dist/governance-activation/task-writes.d.ts +42 -0
- package/dist/governance-activation/task-writes.js +250 -0
- package/dist/governance-activation/task-writes.js.map +1 -0
- package/dist/governance-activation/transition-files.d.ts +12 -0
- package/dist/governance-activation/transition-files.js +109 -0
- package/dist/governance-activation/transition-files.js.map +1 -0
- package/dist/governance-activation/transition-planning.d.ts +3 -1
- package/dist/governance-activation/transition-planning.js +158 -20
- package/dist/governance-activation/transition-planning.js.map +1 -1
- package/dist/governance-activation/transition-ports.d.ts +31 -3
- package/dist/governance-activation/transition-records.d.ts +11 -1
- package/dist/governance-activation/transition-records.js +52 -6
- package/dist/governance-activation/transition-records.js.map +1 -1
- package/dist/governance-activation/transitions.d.ts +5 -0
- package/dist/governance-activation/transitions.js +271 -37
- package/dist/governance-activation/transitions.js.map +1 -1
- package/dist/governance-assessment/engine.js +22 -15
- package/dist/governance-assessment/engine.js.map +1 -1
- package/dist/governance-assessment/project.d.ts +2 -0
- package/dist/governance-assessment/project.js +2 -1
- package/dist/governance-assessment/project.js.map +1 -1
- package/dist/interactive.d.ts +0 -1
- package/dist/interactive.js +3 -22
- package/dist/interactive.js.map +1 -1
- package/dist/openspec-profile.d.ts +2 -1
- package/dist/openspec-profile.js +11 -41
- package/dist/openspec-profile.js.map +1 -1
- package/dist/repository-governance.d.ts +10 -5
- package/dist/repository-governance.js +178 -92
- package/dist/repository-governance.js.map +1 -1
- package/dist/telemetry/contract.d.ts +1 -1
- package/dist/telemetry/contract.js +3 -0
- package/dist/telemetry/contract.js.map +1 -1
- package/dist/workstation-catalog.d.ts +13 -1
- package/dist/workstation-catalog.js +122 -0
- package/dist/workstation-catalog.js.map +1 -1
- package/dist/workstation.d.ts +69 -14
- package/dist/workstation.js +600 -215
- package/dist/workstation.js.map +1 -1
- package/docs/cli-reference.md +94 -23
- package/docs/configuration-and-manifests.md +11 -10
- package/docs/prerequisites.md +93 -18
- package/docs/repository-governance.md +68 -40
- package/docs/spec-workflows-and-agents.md +132 -13
- package/docs/troubleshooting.md +28 -0
- package/package.json +1 -1
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { type AzureBlobAccessProvider, type AzureBlobStateBinding, type AzureStateRequest, type AzureStateResponse, type AzureStateTokenProvider, type AzureStateTransport, type StateBackendAdapter, type StateBackendLease, type StateBackendMetadata, type StateExecutionContext } from '../../domain/repair/stateful.js';
|
|
2
|
+
export type { AzureBlobAccessProvider, AzureStateRequest, AzureStateResponse, AzureStateTokenProvider, AzureStateTransport } from '../../domain/repair/stateful.js';
|
|
3
|
+
export declare function azureStateUrl(binding: AzureBlobStateBinding, target: AzureStateRequest['target']): string;
|
|
4
|
+
export declare class FetchAzureStateTransport implements AzureStateTransport {
|
|
5
|
+
private readonly options;
|
|
6
|
+
constructor(options: {
|
|
7
|
+
tokens: AzureStateTokenProvider;
|
|
8
|
+
fetch?: typeof globalThis.fetch;
|
|
9
|
+
timeoutMs?: number;
|
|
10
|
+
maxResponseBytes?: number;
|
|
11
|
+
now?: () => number;
|
|
12
|
+
});
|
|
13
|
+
toJSON(): {
|
|
14
|
+
transport: string;
|
|
15
|
+
};
|
|
16
|
+
request(request: AzureStateRequest): Promise<AzureStateResponse>;
|
|
17
|
+
private perform;
|
|
18
|
+
}
|
|
19
|
+
export declare class AzureBlobStateBackend implements StateBackendAdapter {
|
|
20
|
+
#private;
|
|
21
|
+
private readonly options;
|
|
22
|
+
readonly binding: AzureBlobStateBinding;
|
|
23
|
+
constructor(binding: AzureBlobStateBinding, options: {
|
|
24
|
+
transport: AzureStateTransport;
|
|
25
|
+
access: AzureBlobAccessProvider;
|
|
26
|
+
now?: () => number;
|
|
27
|
+
maxStateBytes?: number;
|
|
28
|
+
});
|
|
29
|
+
toJSON(): {
|
|
30
|
+
backendRef: string;
|
|
31
|
+
kind: 'azurerm';
|
|
32
|
+
};
|
|
33
|
+
private now;
|
|
34
|
+
assertAccess(context: StateExecutionContext, write: boolean, signal?: AbortSignal): Promise<void>;
|
|
35
|
+
private request;
|
|
36
|
+
metadata(context: StateExecutionContext, signal?: AbortSignal): Promise<StateBackendMetadata>;
|
|
37
|
+
private held;
|
|
38
|
+
readPrivate(expected: StateBackendMetadata, context: StateExecutionContext, lease?: StateBackendLease, signal?: AbortSignal): Promise<Uint8Array>;
|
|
39
|
+
acquire(expected: StateBackendMetadata, context: StateExecutionContext, operationId: string, signal?: AbortSignal): Promise<StateBackendLease>;
|
|
40
|
+
private check;
|
|
41
|
+
writePrivate(request: Parameters<StateBackendAdapter['writePrivate']>[0]): Promise<StateBackendMetadata>;
|
|
42
|
+
remove(request: Parameters<StateBackendAdapter['remove']>[0]): Promise<StateBackendMetadata>;
|
|
43
|
+
}
|
|
@@ -0,0 +1,335 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto';
|
|
2
|
+
import { StateMigrationError } from '../../domain/repair/stateful.js';
|
|
3
|
+
import { inspectStateBytes, stateAssert, stateBindingDigest, stateMetadataMatches, stateSnapshotMatches } from '../../domain/repair/stateful-invariants.js';
|
|
4
|
+
import { boundedStateOperation } from '../../domain/repair/stateful-bounded.js';
|
|
5
|
+
const responseHeaders = [
|
|
6
|
+
'etag', 'content-length', 'x-ms-version-id', 'x-ms-server-encrypted',
|
|
7
|
+
'x-ms-error-code', 'x-ms-lease-id', 'x-ms-lease-status', 'x-ms-lease-state',
|
|
8
|
+
'x-ms-meta-liftoff-operation'
|
|
9
|
+
];
|
|
10
|
+
const requestHeaders = new Set([
|
|
11
|
+
'if-match', 'if-none-match', 'x-ms-lease-id', 'x-ms-lease-action', 'x-ms-lease-duration',
|
|
12
|
+
'x-ms-proposed-lease-id', 'x-ms-blob-type', 'x-ms-meta-liftoff-operation', 'content-type'
|
|
13
|
+
]);
|
|
14
|
+
export function azureStateUrl(binding, target) {
|
|
15
|
+
stateBindingDigest(binding);
|
|
16
|
+
const base = `https://${binding.account}.blob.core.windows.net/${binding.container}`;
|
|
17
|
+
return target === 'container'
|
|
18
|
+
? `${base}?restype=container&comp=metadata`
|
|
19
|
+
: `${base}/${binding.key.split('/').map(encodeURIComponent).join('/')}${target === 'lease' ? '?comp=lease' : ''}`;
|
|
20
|
+
}
|
|
21
|
+
export class FetchAzureStateTransport {
|
|
22
|
+
options;
|
|
23
|
+
constructor(options) {
|
|
24
|
+
this.options = options;
|
|
25
|
+
}
|
|
26
|
+
toJSON() { return { transport: 'azure-blob-private-capture' }; }
|
|
27
|
+
async request(request) {
|
|
28
|
+
stateBindingDigest(request.binding);
|
|
29
|
+
stateAssert(request.target !== 'container' || request.method === 'HEAD', 'invalid-binding');
|
|
30
|
+
stateAssert(request.target !== 'lease' || request.method === 'PUT', 'invalid-binding');
|
|
31
|
+
const timeoutMs = this.options.timeoutMs ?? 15_000;
|
|
32
|
+
stateAssert(timeoutMs > 0 && timeoutMs <= 120_000, 'invalid-binding');
|
|
33
|
+
const signal = AbortSignal.any([AbortSignal.timeout(timeoutMs), ...(request.signal ? [request.signal] : [])]);
|
|
34
|
+
return boundedStateOperation(signal, () => this.perform(request, signal));
|
|
35
|
+
}
|
|
36
|
+
async perform(request, signal) {
|
|
37
|
+
try {
|
|
38
|
+
const token = await this.options.tokens.getToken({
|
|
39
|
+
tenantId: request.binding.tenantId, principalId: request.context.principalId,
|
|
40
|
+
scope: 'https://storage.azure.com/.default', signal
|
|
41
|
+
});
|
|
42
|
+
stateAssert(token.tenantId === request.binding.tenantId && token.principalId === request.context.principalId
|
|
43
|
+
&& token.expiresAt > (this.options.now?.() ?? Date.now()) + 30_000 && typeof token.token === 'string'
|
|
44
|
+
&& token.token.length > 0 && !/[\r\n]/.test(token.token), 'access-denied');
|
|
45
|
+
const headers = {};
|
|
46
|
+
for (const [name, value] of Object.entries(request.headers ?? {})) {
|
|
47
|
+
stateAssert(requestHeaders.has(name) && !/[\r\n]/.test(value), 'invalid-binding');
|
|
48
|
+
headers[name] = value;
|
|
49
|
+
}
|
|
50
|
+
headers.authorization = `Bearer ${token.token}`;
|
|
51
|
+
headers['x-ms-version'] = '2023-11-03';
|
|
52
|
+
headers['x-ms-date'] = new Date(this.options.now?.() ?? Date.now()).toUTCString();
|
|
53
|
+
headers['x-ms-client-request-id'] = request.operationId ?? randomUUID();
|
|
54
|
+
const response = await (this.options.fetch ?? globalThis.fetch)(azureStateUrl(request.binding, request.target), {
|
|
55
|
+
method: request.method, headers, redirect: 'error', signal,
|
|
56
|
+
...(request.body ? { body: Buffer.from(request.body) } : {})
|
|
57
|
+
});
|
|
58
|
+
const safeHeaders = {};
|
|
59
|
+
for (const name of responseHeaders) {
|
|
60
|
+
const value = response.headers.get(name);
|
|
61
|
+
if (value !== null)
|
|
62
|
+
safeHeaders[name] = value;
|
|
63
|
+
}
|
|
64
|
+
const maxBytes = this.options.maxResponseBytes ?? 32 * 1024 * 1024;
|
|
65
|
+
const length = Number(response.headers.get('content-length') ?? 0);
|
|
66
|
+
stateAssert(Number.isSafeInteger(length) && length >= 0 && (request.method === 'HEAD' || length <= maxBytes), 'storage-limit');
|
|
67
|
+
const parts = [];
|
|
68
|
+
let size = 0;
|
|
69
|
+
const reader = request.method === 'HEAD' ? undefined : response.body?.getReader();
|
|
70
|
+
if (reader) {
|
|
71
|
+
try {
|
|
72
|
+
while (true) {
|
|
73
|
+
const chunk = await reader.read();
|
|
74
|
+
if (chunk.done)
|
|
75
|
+
break;
|
|
76
|
+
size += chunk.value.byteLength;
|
|
77
|
+
stateAssert(size <= maxBytes, 'storage-limit');
|
|
78
|
+
parts.push(chunk.value);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
finally {
|
|
82
|
+
await reader.cancel().catch(() => undefined);
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
return { status: response.status, headers: safeHeaders, body: Buffer.concat(parts) };
|
|
86
|
+
}
|
|
87
|
+
catch (error) {
|
|
88
|
+
if (error instanceof StateMigrationError)
|
|
89
|
+
throw error;
|
|
90
|
+
if (signal.aborted)
|
|
91
|
+
throw new StateMigrationError(request.signal?.aborted ? 'cancelled' : 'timeout');
|
|
92
|
+
throw new StateMigrationError('access-denied');
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
function successful(response, allowed) {
|
|
97
|
+
if (allowed.includes(response.status))
|
|
98
|
+
return;
|
|
99
|
+
if (response.status === 409 || response.status === 412)
|
|
100
|
+
throw new StateMigrationError('stale-state');
|
|
101
|
+
if (response.status === 401 || response.status === 403)
|
|
102
|
+
throw new StateMigrationError('access-denied');
|
|
103
|
+
if (response.status === 408 || response.status === 504)
|
|
104
|
+
throw new StateMigrationError('timeout');
|
|
105
|
+
throw new StateMigrationError('incomplete-observation');
|
|
106
|
+
}
|
|
107
|
+
class AzureLease {
|
|
108
|
+
backendId;
|
|
109
|
+
send;
|
|
110
|
+
now;
|
|
111
|
+
absent;
|
|
112
|
+
#leaseId = null;
|
|
113
|
+
#lost = false;
|
|
114
|
+
#released = false;
|
|
115
|
+
#removed = false;
|
|
116
|
+
#expiresAt = 0;
|
|
117
|
+
#renewal = null;
|
|
118
|
+
#timer = null;
|
|
119
|
+
get kind() { return this.#leaseId ? 'blob-lease' : 'conditional-create'; }
|
|
120
|
+
get leaseId() { return this.#leaseId; }
|
|
121
|
+
constructor(backendId, send, now, absent) {
|
|
122
|
+
this.backendId = backendId;
|
|
123
|
+
this.send = send;
|
|
124
|
+
this.now = now;
|
|
125
|
+
this.absent = absent;
|
|
126
|
+
}
|
|
127
|
+
async lock(etag) {
|
|
128
|
+
stateAssert(!this.#leaseId && !this.#lost && !this.#released, 'lock-lost');
|
|
129
|
+
const id = randomUUID();
|
|
130
|
+
const response = await this.send({
|
|
131
|
+
'x-ms-lease-action': 'acquire', 'x-ms-lease-duration': '60', 'x-ms-proposed-lease-id': id, 'if-match': etag
|
|
132
|
+
});
|
|
133
|
+
successful(response, [201]);
|
|
134
|
+
stateAssert(response.headers['x-ms-lease-id'] === id, 'lock-lost');
|
|
135
|
+
this.#leaseId = id;
|
|
136
|
+
this.#expiresAt = this.now() + 55_000;
|
|
137
|
+
this.#timer = setInterval(() => { void this.renew().catch(() => undefined); }, 20_000);
|
|
138
|
+
this.#timer.unref?.();
|
|
139
|
+
}
|
|
140
|
+
async renew() {
|
|
141
|
+
if (this.#renewal)
|
|
142
|
+
return this.#renewal;
|
|
143
|
+
if (this.#released || this.#removed || this.#lost || !this.#leaseId)
|
|
144
|
+
return;
|
|
145
|
+
this.#renewal = (async () => {
|
|
146
|
+
try {
|
|
147
|
+
stateAssert(this.now() < this.#expiresAt, 'lock-lost');
|
|
148
|
+
const response = await this.send({ 'x-ms-lease-action': 'renew', 'x-ms-lease-id': this.#leaseId });
|
|
149
|
+
successful(response, [200]);
|
|
150
|
+
this.#expiresAt = this.now() + 55_000;
|
|
151
|
+
}
|
|
152
|
+
catch {
|
|
153
|
+
this.#lost = true;
|
|
154
|
+
throw new StateMigrationError('lock-lost');
|
|
155
|
+
}
|
|
156
|
+
})();
|
|
157
|
+
try {
|
|
158
|
+
await this.#renewal;
|
|
159
|
+
}
|
|
160
|
+
finally {
|
|
161
|
+
this.#renewal = null;
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
async assertHeld() {
|
|
165
|
+
stateAssert(!this.#released && !this.#lost, 'lock-lost');
|
|
166
|
+
if (this.#removed)
|
|
167
|
+
return;
|
|
168
|
+
if (!this.#leaseId) {
|
|
169
|
+
stateAssert(await this.absent(), 'stale-state');
|
|
170
|
+
return;
|
|
171
|
+
}
|
|
172
|
+
await this.renew();
|
|
173
|
+
stateAssert(!this.#lost && this.now() < this.#expiresAt, 'lock-lost');
|
|
174
|
+
}
|
|
175
|
+
markRemoved() {
|
|
176
|
+
this.#removed = true;
|
|
177
|
+
if (this.#timer)
|
|
178
|
+
clearInterval(this.#timer);
|
|
179
|
+
}
|
|
180
|
+
async release() {
|
|
181
|
+
if (this.#timer)
|
|
182
|
+
clearInterval(this.#timer);
|
|
183
|
+
if (this.#released)
|
|
184
|
+
return;
|
|
185
|
+
await this.#renewal?.catch(() => undefined);
|
|
186
|
+
this.#released = true;
|
|
187
|
+
if (!this.#leaseId || this.#removed)
|
|
188
|
+
return;
|
|
189
|
+
const response = await this.send({ 'x-ms-lease-action': 'release', 'x-ms-lease-id': this.#leaseId });
|
|
190
|
+
if (![200, 404].includes(response.status))
|
|
191
|
+
throw new StateMigrationError('lock-lost');
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
export class AzureBlobStateBackend {
|
|
195
|
+
options;
|
|
196
|
+
binding;
|
|
197
|
+
#leases = new WeakSet();
|
|
198
|
+
constructor(binding, options) {
|
|
199
|
+
this.options = options;
|
|
200
|
+
stateBindingDigest(binding);
|
|
201
|
+
this.binding = Object.freeze(structuredClone(binding));
|
|
202
|
+
}
|
|
203
|
+
toJSON() { return { backendRef: stateBindingDigest(this.binding), kind: 'azurerm' }; }
|
|
204
|
+
now() { return this.options.now?.() ?? Date.now(); }
|
|
205
|
+
async assertAccess(context, write, signal) {
|
|
206
|
+
const access = await this.options.access.observe(this.binding, context, write, signal);
|
|
207
|
+
stateAssert(access.bindingDigest === stateBindingDigest(this.binding) && access.ownerId === this.binding.ownerId
|
|
208
|
+
&& access.hostId === context.hostId && access.principalId === context.principalId, 'ownership-mismatch');
|
|
209
|
+
stateAssert(access.network === this.binding.network && access.reachable && access.canRead
|
|
210
|
+
&& (!write || access.canWrite) && access.expiresAt > this.now(), 'access-denied');
|
|
211
|
+
stateAssert(access.serverSideEncryption && access.versioning && access.softDelete, 'unsupported-encryption');
|
|
212
|
+
}
|
|
213
|
+
request(context, fields) {
|
|
214
|
+
return this.options.transport.request({ ...fields, binding: this.binding, context });
|
|
215
|
+
}
|
|
216
|
+
async metadata(context, signal) {
|
|
217
|
+
await this.assertAccess(context, false, signal);
|
|
218
|
+
const response = await this.request(context, { method: 'HEAD', target: 'blob', signal });
|
|
219
|
+
if (response.status === 404) {
|
|
220
|
+
stateAssert(response.headers['x-ms-error-code'] === 'BlobNotFound', 'incomplete-observation');
|
|
221
|
+
successful(await this.request(context, { method: 'HEAD', target: 'container', signal }), [200]);
|
|
222
|
+
return {
|
|
223
|
+
backendId: this.binding.id, bindingDigest: stateBindingDigest(this.binding),
|
|
224
|
+
exists: false, version: null, etag: null, size: 0, observedAt: this.now()
|
|
225
|
+
};
|
|
226
|
+
}
|
|
227
|
+
successful(response, [200]);
|
|
228
|
+
const etag = response.headers.etag;
|
|
229
|
+
const version = response.headers['x-ms-version-id'] ?? etag;
|
|
230
|
+
const size = Number(response.headers['content-length']);
|
|
231
|
+
stateAssert(typeof etag === 'string' && /^"0x[a-fA-F0-9]+"$/.test(etag)
|
|
232
|
+
&& typeof version === 'string' && version.length <= 128 && !/[\x00-\x1f]/.test(version), 'incomplete-observation');
|
|
233
|
+
stateAssert(response.headers['x-ms-server-encrypted'] === 'true', 'unsupported-encryption');
|
|
234
|
+
stateAssert(Number.isSafeInteger(size) && size >= 0, 'incomplete-observation');
|
|
235
|
+
const operationId = response.headers['x-ms-meta-liftoff-operation'];
|
|
236
|
+
return {
|
|
237
|
+
backendId: this.binding.id, bindingDigest: stateBindingDigest(this.binding),
|
|
238
|
+
exists: true, version, etag, size, observedAt: this.now(),
|
|
239
|
+
...(operationId && /^[a-f0-9-]{36}$/.test(operationId) ? { operationId } : {})
|
|
240
|
+
};
|
|
241
|
+
}
|
|
242
|
+
async held(lease) {
|
|
243
|
+
stateAssert(lease instanceof AzureLease && this.#leases.has(lease) && lease.backendId === this.binding.id, 'lock-lost');
|
|
244
|
+
await lease.assertHeld();
|
|
245
|
+
return lease;
|
|
246
|
+
}
|
|
247
|
+
async readPrivate(expected, context, lease, signal) {
|
|
248
|
+
await this.assertAccess(context, false, signal);
|
|
249
|
+
const held = lease ? await this.held(lease) : null;
|
|
250
|
+
stateAssert(expected.backendId === this.binding.id && expected.bindingDigest === stateBindingDigest(this.binding)
|
|
251
|
+
&& expected.exists && expected.etag, 'stale-state');
|
|
252
|
+
stateAssert(expected.size <= (this.options.maxStateBytes ?? 32 * 1024 * 1024), 'storage-limit');
|
|
253
|
+
const response = await this.request(context, {
|
|
254
|
+
method: 'GET', target: 'blob', headers: {
|
|
255
|
+
'if-match': expected.etag, ...(held?.leaseId ? { 'x-ms-lease-id': held.leaseId } : {})
|
|
256
|
+
}, signal
|
|
257
|
+
});
|
|
258
|
+
successful(response, [200]);
|
|
259
|
+
stateAssert(response.headers.etag === expected.etag && response.body.byteLength === expected.size, 'stale-state');
|
|
260
|
+
stateAssert(stateMetadataMatches(expected, await this.metadata(context, signal)), 'stale-state');
|
|
261
|
+
if (held)
|
|
262
|
+
await held.assertHeld();
|
|
263
|
+
return response.body;
|
|
264
|
+
}
|
|
265
|
+
async acquire(expected, context, operationId, signal) {
|
|
266
|
+
await this.assertAccess(context, true, signal);
|
|
267
|
+
stateAssert(stateMetadataMatches(expected, await this.metadata(context, signal)), 'stale-state');
|
|
268
|
+
const lease = new AzureLease(this.binding.id, (headers) => this.request(context, {
|
|
269
|
+
method: 'PUT', target: 'lease', headers, operationId,
|
|
270
|
+
...(headers['x-ms-lease-action'] === 'acquire' ? { signal } : {})
|
|
271
|
+
}), () => this.now(), async () => !(await this.metadata(context, signal)).exists);
|
|
272
|
+
this.#leases.add(lease);
|
|
273
|
+
if (expected.exists)
|
|
274
|
+
await lease.lock(expected.etag);
|
|
275
|
+
else
|
|
276
|
+
await lease.assertHeld();
|
|
277
|
+
return lease;
|
|
278
|
+
}
|
|
279
|
+
async check(expected, context, lease, signal) {
|
|
280
|
+
const metadata = await this.metadata(context, signal);
|
|
281
|
+
const bytes = metadata.exists ? await this.readPrivate(metadata, context, lease, signal) : null;
|
|
282
|
+
try {
|
|
283
|
+
stateAssert(stateSnapshotMatches(expected, inspectStateBytes(metadata, bytes).snapshot), 'stale-state');
|
|
284
|
+
}
|
|
285
|
+
finally {
|
|
286
|
+
bytes?.fill(0);
|
|
287
|
+
}
|
|
288
|
+
await lease.assertHeld();
|
|
289
|
+
}
|
|
290
|
+
async writePrivate(request) {
|
|
291
|
+
await this.assertAccess(request.context, true, request.signal);
|
|
292
|
+
const lease = await this.held(request.lease);
|
|
293
|
+
await this.check(request.expected, request.context, lease, request.signal);
|
|
294
|
+
const candidate = inspectStateBytes({ ...request.expected, exists: true, size: request.bytes.byteLength }, request.bytes).snapshot;
|
|
295
|
+
if (request.expected.exists) {
|
|
296
|
+
stateAssert(candidate.lineage === request.expected.lineage && candidate.serial >= request.expected.serial, 'stale-state');
|
|
297
|
+
stateAssert(lease.leaseId, 'lock-lost');
|
|
298
|
+
}
|
|
299
|
+
const response = await this.request(request.context, {
|
|
300
|
+
method: 'PUT', target: 'blob', body: request.bytes, operationId: request.operationId, signal: request.signal,
|
|
301
|
+
headers: {
|
|
302
|
+
'x-ms-blob-type': 'BlockBlob', 'content-type': 'application/json',
|
|
303
|
+
'x-ms-meta-liftoff-operation': request.operationId,
|
|
304
|
+
...(request.expected.exists
|
|
305
|
+
? { 'if-match': request.expected.etag, 'x-ms-lease-id': lease.leaseId }
|
|
306
|
+
: { 'if-none-match': '*' })
|
|
307
|
+
}
|
|
308
|
+
});
|
|
309
|
+
successful(response, [201]);
|
|
310
|
+
const current = await this.metadata(request.context, request.signal);
|
|
311
|
+
stateAssert(current.etag === response.headers.etag && current.operationId === request.operationId, 'stale-state');
|
|
312
|
+
// An absent blob cannot be leased. Its first publication is an atomic create,
|
|
313
|
+
// followed by acquisition against that exact ETag, before source retirement.
|
|
314
|
+
if (!lease.leaseId)
|
|
315
|
+
await lease.lock(current.etag);
|
|
316
|
+
await lease.assertHeld();
|
|
317
|
+
return current;
|
|
318
|
+
}
|
|
319
|
+
async remove(request) {
|
|
320
|
+
await this.assertAccess(request.context, true, request.signal);
|
|
321
|
+
const lease = await this.held(request.lease);
|
|
322
|
+
await this.check(request.expected, request.context, lease, request.signal);
|
|
323
|
+
stateAssert(request.expected.exists && request.expected.etag && lease.leaseId, 'stale-state');
|
|
324
|
+
const response = await this.request(request.context, {
|
|
325
|
+
method: 'DELETE', target: 'blob', operationId: request.operationId, signal: request.signal,
|
|
326
|
+
headers: { 'if-match': request.expected.etag, 'x-ms-lease-id': lease.leaseId }
|
|
327
|
+
});
|
|
328
|
+
successful(response, [202]);
|
|
329
|
+
lease.markRemoved();
|
|
330
|
+
const current = await this.metadata(request.context, request.signal);
|
|
331
|
+
stateAssert(!current.exists, 'verification-incomplete');
|
|
332
|
+
return current;
|
|
333
|
+
}
|
|
334
|
+
}
|
|
335
|
+
//# sourceMappingURL=azure-blob.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"azure-blob.js","sourceRoot":"","sources":["../../../src/adapters/state/azure-blob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,mBAAmB,EAYpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,iBAAiB,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAC/F,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAMhF,MAAM,eAAe,GAAG;IACtB,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,uBAAuB;IACpE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,kBAAkB;IAC3E,6BAA6B;CACrB,CAAC;AACX,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,qBAAqB;IACxF,wBAAwB,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,cAAc;CAC1F,CAAC,CAAC;AAEH,MAAM,UAAU,aAAa,CAAC,OAA8B,EAAE,MAAmC;IAC/F,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,WAAW,OAAO,CAAC,OAAO,0BAA0B,OAAO,CAAC,SAAS,EAAE,CAAC;IACrF,OAAO,MAAM,KAAK,WAAW;QAC3B,CAAC,CAAC,GAAG,IAAI,kCAAkC;QAC3C,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACtH,CAAC;AAED,MAAM,OAAO,wBAAwB;IACN,OAAO;IAApC,YAA6B,OAM5B;uBAN4B,OAAO;IAMhC,CAAC;IAEL,MAAM,KAA4B,OAAO,EAAE,SAAS,EAAE,4BAA4B,EAAE,CAAC,CAAC,CAAC;IAEvF,KAAK,CAAC,OAAO,CAAC,OAA0B;QACtC,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,WAAW,CAAC,OAAO,CAAC,MAAM,KAAK,WAAW,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAC5F,WAAW,CAAC,OAAO,CAAC,MAAM,KAAK,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,iBAAiB,CAAC,CAAC;QACvF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;QACnD,WAAW,CAAC,SAAS,GAAG,CAAC,IAAI,SAAS,IAAI,OAAO,EAAE,iBAAiB,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9G,OAAO,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5E,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,OAA0B,EAAE,MAAmB;QACnE,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAC/C,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW;gBAC5E,KAAK,EAAE,oCAAoC,EAAE,MAAM;aACpD,CAAC,CAAC;YACH,WAAW,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,WAAW;mBACvG,KAAK,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;mBAClG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC;YAC7E,MAAM,OAAO,GAA2B,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;gBAClE,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC,CAAC;gBAClF,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YACxB,CAAC;YACD,OAAO,CAAC,aAAa,GAAG,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC;YAChD,OAAO,CAAC,cAAc,CAAC,GAAG,YAAY,CAAC;YACvC,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAClF,OAAO,CAAC,wBAAwB,CAAC,GAAG,OAAO,CAAC,WAAW,IAAI,UAAU,EAAE,CAAC;YACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;gBAC9G,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM;gBAC1D,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7D,CAAC,CAAC;YACH,MAAM,WAAW,GAA2B,EAAE,CAAC;YAC/C,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;gBACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACzC,IAAI,KAAK,KAAK,IAAI;oBAAE,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YAChD,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;YACnE,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;YACnE,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,IAAI,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC;YAC/H,MAAM,KAAK,GAAiB,EAAE,CAAC;YAC/B,IAAI,IAAI,GAAG,CAAC,CAAC;YACb,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;YAClF,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC;oBACH,OAAO,IAAI,EAAE,CAAC;wBACZ,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;wBAClC,IAAI,KAAK,CAAC,IAAI;4BAAE,MAAM;wBACtB,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;wBAC/B,WAAW,CAAC,IAAI,IAAI,QAAQ,EAAE,eAAe,CAAC,CAAC;wBAC/C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAC1B,CAAC;gBACH,CAAC;wBAAS,CAAC;oBAAC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAAC,CAAC;YAC7D,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,mBAAmB;gBAAE,MAAM,KAAK,CAAC;YACtD,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACrG,MAAM,IAAI,mBAAmB,CAAC,eAAe,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;CACF;AAED,SAAS,UAAU,CAAC,QAA4B,EAAE,OAA0B;IAC1E,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO;IAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACrG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,mBAAmB,CAAC,eAAe,CAAC,CAAC;IACvG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACjG,MAAM,IAAI,mBAAmB,CAAC,wBAAwB,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU;IAYH,SAAS;IACD,IAAI;IACJ,GAAG;IACH,MAAM;IAdzB,QAAQ,GAAkB,IAAI,CAAC;IAC/B,KAAK,GAAG,KAAK,CAAC;IACd,SAAS,GAAG,KAAK,CAAC;IAClB,QAAQ,GAAG,KAAK,CAAC;IACjB,UAAU,GAAG,CAAC,CAAC;IACf,QAAQ,GAAyB,IAAI,CAAC;IACtC,MAAM,GAA0C,IAAI,CAAC;IACrD,IAAI,IAAI,KAA0C,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC/G,IAAI,OAAO,KAAoB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtD,YACW,SAAiB,EACT,IAAsE,EACtE,GAAiB,EACjB,MAA8B;yBAHtC,SAAS;oBACD,IAAI;mBACJ,GAAG;sBACH,MAAM;IACtB,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAC3E,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;YAC/B,mBAAmB,EAAE,SAAS,EAAE,qBAAqB,EAAE,IAAI,EAAE,wBAAwB,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI;SAC5G,CAAC,CAAC;QACH,UAAU,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,EAAE,WAAW,CAAC,CAAC;QACnE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACvF,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,KAAK;QACjB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACxC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC5E,IAAI,CAAC,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE;YAC1B,IAAI,CAAC;gBACH,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;gBACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,mBAAmB,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,CAAC,QAAS,EAAE,CAAC,CAAC;gBACpG,UAAU,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;gBAClB,MAAM,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,IAAI,CAAC;YAAC,MAAM,IAAI,CAAC,QAAQ,CAAC;QAAC,CAAC;gBAAS,CAAC;YAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,UAAU;QACd,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,WAAW,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACxE,CAAC;IAED,WAAW;QACT,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,IAAI,CAAC,MAAM;YAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,MAAM;YAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrG,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACxF,CAAC;CACF;AAED,MAAM,OAAO,qBAAqB;IAG6B,OAAO;IAF3D,OAAO,CAAwB;IACxC,OAAO,GAAG,IAAI,OAAO,EAAc,CAAC;IACpC,YAAY,OAA8B,EAAmB,OAK5D;uBAL4D,OAAO;QAMlE,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,KAA8C,OAAO,EAAE,UAAU,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IACvH,GAAG,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAEpE,KAAK,CAAC,YAAY,CAAC,OAA8B,EAAE,KAAc,EAAE,MAAoB;QACrF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACvF,WAAW,CAAC,MAAM,CAAC,aAAa,KAAK,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO;eAC3G,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;QAC3G,WAAW,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,OAAO;eACpF,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;QACpF,WAAW,CAAC,MAAM,CAAC,oBAAoB,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC;IAC/G,CAAC;IAEO,OAAO,CAAC,OAA8B,EAAE,MAAsD;QACpG,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAA8B,EAAE,MAAoB;QACjE,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACzF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,cAAc,EAAE,wBAAwB,CAAC,CAAC;YAC9F,UAAU,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAChG,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,aAAa,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC;gBAC3E,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;aAC1E,CAAC;QACJ,CAAC;QACD,UAAU,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;QACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACxD,WAAW,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;eAClE,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC,CAAC;QACrH,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,uBAAuB,CAAC,KAAK,MAAM,EAAE,wBAAwB,CAAC,CAAC;QAC5F,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,wBAAwB,CAAC,CAAC;QAC/E,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACpE,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,aAAa,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC;YAC3E,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACzD,GAAG,CAAC,WAAW,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/E,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,KAAwB;QACzC,WAAW,CAAC,KAAK,YAAY,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QACxH,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAA8B,EAAE,OAA8B,EAAE,KAAyB,EAAE,MAAoB;QAC/H,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,WAAW,CAAC,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,QAAQ,CAAC,aAAa,KAAK,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC;eAC5G,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QACtD,WAAW,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,EAAE,eAAe,CAAC,CAAC;QAChG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;YAC3C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;gBACtC,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvF,EAAE,MAAM;SACV,CAAC,CAAC;QACH,UAAU,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAClH,WAAW,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QACjG,IAAI,IAAI;YAAE,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAA8B,EAAE,OAA8B,EAAE,WAAmB,EAAE,MAAoB;QACrH,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/C,WAAW,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QACjG,MAAM,KAAK,GAAG,IAAI,UAAU,CAC1B,IAAI,CAAC,OAAO,CAAC,EAAE,EACf,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;YACjC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW;YACpD,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClE,CAAC,EACF,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAChB,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAC3D,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,QAAQ,CAAC,MAAM;YAAE,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAK,CAAC,CAAC;;YACjD,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,QAAuB,EAAE,OAA8B,EAAE,KAAiB,EAAE,MAAoB;QAClH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChG,IAAI,CAAC;YAAC,WAAW,CAAC,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC;QAAC,CAAC;gBACxG,CAAC;YAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;QAC3B,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAA2D;QAC5E,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC;QACnI,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC5B,WAAW,CAAC,SAAS,CAAC,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,OAAO,IAAI,SAAS,CAAC,MAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAO,EAAE,aAAa,CAAC,CAAC;YAC5H,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE;YACnD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM;YAC5G,OAAO,EAAE;gBACP,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB;gBACjE,6BAA6B,EAAE,OAAO,CAAC,WAAW;gBAClD,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM;oBACzB,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAK,EAAE,eAAe,EAAE,KAAK,CAAC,OAAQ,EAAE;oBACzE,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC;aAC9B;SACF,CAAC,CAAC;QACH,UAAU,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACrE,WAAW,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAClH,8EAA8E;QAC9E,6EAA6E;QAC7E,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAK,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAqD;QAChE,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3E,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9F,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE;YACnD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM;YAC1F,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,OAAO,EAAE;SAC/E,CAAC,CAAC;QACH,UAAU,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,KAAK,CAAC,WAAW,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACrE,WAAW,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { type DarwinStateKeychainReference, type DarwinStateVolumeObservation, type DarwinStateStorageProfile, type DarwinStateStorageProfileOptions, type DarwinStateSystemBridge, type ProtectedVolumeAttestor, type StateEncryptionKeyProvider, type StateExecutionContext, type StateRegisteredExecutable } from '../../domain/repair/stateful.js';
|
|
2
|
+
export type { DarwinStateSystemBridge } from '../../domain/repair/stateful.js';
|
|
3
|
+
export declare class PythonDarwinStateSystemBridge implements DarwinStateSystemBridge {
|
|
4
|
+
private readonly python;
|
|
5
|
+
private readonly workingDirectory;
|
|
6
|
+
constructor(python: StateRegisteredExecutable, workingDirectory: string);
|
|
7
|
+
request(operation: 'volume' | 'keychain-metadata' | 'keychain-secret', input: object, signal?: AbortSignal): Promise<Record<string, unknown>>;
|
|
8
|
+
}
|
|
9
|
+
export declare function observeDarwinStateVolume(bridge: DarwinStateSystemBridge, directory: string, signal?: AbortSignal): Promise<DarwinStateVolumeObservation>;
|
|
10
|
+
export declare class DarwinFileVaultVolumeAttestor implements ProtectedVolumeAttestor {
|
|
11
|
+
#private;
|
|
12
|
+
private readonly options;
|
|
13
|
+
constructor(options: {
|
|
14
|
+
bridge: DarwinStateSystemBridge;
|
|
15
|
+
root: string;
|
|
16
|
+
volumeId: string;
|
|
17
|
+
now?: () => number;
|
|
18
|
+
});
|
|
19
|
+
verify(directory: string, context: StateExecutionContext): ReturnType<ProtectedVolumeAttestor['verify']>;
|
|
20
|
+
}
|
|
21
|
+
export declare function darwinStateKeyReferenceId(reference: DarwinStateKeychainReference): string;
|
|
22
|
+
export declare class DarwinKeychainStateKeyProvider implements StateEncryptionKeyProvider {
|
|
23
|
+
private readonly reference;
|
|
24
|
+
private readonly bridge;
|
|
25
|
+
readonly keyRef: string;
|
|
26
|
+
constructor(reference: DarwinStateKeychainReference, bridge: DarwinStateSystemBridge);
|
|
27
|
+
describe(keyRef: string, context: StateExecutionContext): ReturnType<StateEncryptionKeyProvider['describe']>;
|
|
28
|
+
withKey<T>(keyRef: string, action: (key: Uint8Array) => Promise<T>): Promise<T>;
|
|
29
|
+
toJSON(): {
|
|
30
|
+
keyRef: string;
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
export declare function createDarwinStateStorageProfile(options: DarwinStateStorageProfileOptions): Promise<DarwinStateStorageProfile>;
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto';
|
|
2
|
+
import { lstat, realpath } from 'node:fs/promises';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { StateMigrationError } from '../../domain/repair/stateful.js';
|
|
5
|
+
import { stateAssert, stateObjectDigest } from '../../domain/repair/stateful-invariants.js';
|
|
6
|
+
import { darwinStateSystemProgram } from './darwin-system-program.js';
|
|
7
|
+
import { nativeStateHostId, runPrivateStateProcess } from './native-system.js';
|
|
8
|
+
import { DarwinPosixStateLockProvider } from './posix-native-lock.js';
|
|
9
|
+
import { EncryptedStateWorkspace, FilesystemProtectedArtifactStorage } from './protected-workspace.js';
|
|
10
|
+
export class PythonDarwinStateSystemBridge {
|
|
11
|
+
python;
|
|
12
|
+
workingDirectory;
|
|
13
|
+
constructor(python, workingDirectory) {
|
|
14
|
+
this.python = python;
|
|
15
|
+
this.workingDirectory = workingDirectory;
|
|
16
|
+
}
|
|
17
|
+
async request(operation, input, signal) {
|
|
18
|
+
stateAssert(process.platform === 'darwin', 'unsupported-native-platform');
|
|
19
|
+
const result = await runPrivateStateProcess({
|
|
20
|
+
executable: this.python, args: ['-I', '-S', '-B', '-c', darwinStateSystemProgram],
|
|
21
|
+
cwd: this.workingDirectory, stdin: Buffer.from(JSON.stringify({ ...input, operation })),
|
|
22
|
+
timeoutMs: 40_000, maximumBytes: 32_768, signal
|
|
23
|
+
});
|
|
24
|
+
try {
|
|
25
|
+
stateAssert(result.exitCode === 0, operation === 'volume' ? 'protected-workspace-required' : 'key-unavailable');
|
|
26
|
+
const reply = JSON.parse(Buffer.from(result.stdout).toString('utf8'));
|
|
27
|
+
stateAssert(reply.ok === true, operation === 'volume' ? 'protected-workspace-required' : 'key-unavailable');
|
|
28
|
+
return reply;
|
|
29
|
+
}
|
|
30
|
+
catch (error) {
|
|
31
|
+
if (error instanceof StateMigrationError)
|
|
32
|
+
throw error;
|
|
33
|
+
throw new StateMigrationError(operation === 'volume' ? 'protected-workspace-required' : 'key-unavailable');
|
|
34
|
+
}
|
|
35
|
+
finally {
|
|
36
|
+
result.stdout.fill(0);
|
|
37
|
+
result.stderr.fill(0);
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
export async function observeDarwinStateVolume(bridge, directory, signal) {
|
|
42
|
+
stateAssert(path.isAbsolute(directory) && await realpath(directory) === directory, 'unsafe-path');
|
|
43
|
+
const observed = await bridge.request('volume', { directory }, signal);
|
|
44
|
+
stateAssert(observed.canonicalDirectory === directory && typeof observed.volumeId === 'string'
|
|
45
|
+
&& /^[a-fA-F0-9-]{36}$/.test(observed.volumeId) && typeof observed.deviceNode === 'string'
|
|
46
|
+
&& /^\/dev\/disk[0-9]+(?:s[0-9]+)*$/.test(observed.deviceNode), 'protected-workspace-required');
|
|
47
|
+
return {
|
|
48
|
+
canonicalDirectory: directory, deviceNode: observed.deviceNode, volumeId: observed.volumeId,
|
|
49
|
+
filesystem: typeof observed.filesystem === 'string' ? observed.filesystem : '',
|
|
50
|
+
fileVault: observed.fileVault === true, encrypted: observed.encrypted === true, locked: observed.locked !== false,
|
|
51
|
+
ownerUid: Number(observed.ownerUid), mode: Number(observed.mode), aclEntries: Number(observed.aclEntries),
|
|
52
|
+
hostId: nativeStateHostId()
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
export class DarwinFileVaultVolumeAttestor {
|
|
56
|
+
options;
|
|
57
|
+
#cache = new Map();
|
|
58
|
+
constructor(options) {
|
|
59
|
+
this.options = options;
|
|
60
|
+
}
|
|
61
|
+
async verify(directory, context) {
|
|
62
|
+
stateAssert(process.platform === 'darwin' && context.hostId === nativeStateHostId(), 'unsupported-native-platform');
|
|
63
|
+
const relative = path.relative(this.options.root, directory);
|
|
64
|
+
stateAssert(relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative)), 'unsafe-path');
|
|
65
|
+
const current = await lstat(directory);
|
|
66
|
+
stateAssert(current.isDirectory() && !current.isSymbolicLink() && current.uid === process.getuid?.()
|
|
67
|
+
&& (current.mode & 0o077) === 0 && await realpath(directory) === directory, 'unsafe-path');
|
|
68
|
+
const now = this.options.now?.() ?? Date.now();
|
|
69
|
+
const directoryStamp = stateObjectDigest({ dev: current.dev, ino: current.ino, mode: current.mode, ctime: current.ctimeMs });
|
|
70
|
+
let cached = this.#cache.get(directory);
|
|
71
|
+
if (!cached || cached.expiresAt <= now || cached.directoryStamp !== directoryStamp) {
|
|
72
|
+
cached = { observation: await observeDarwinStateVolume(this.options.bridge, directory), expiresAt: now + 10_000, directoryStamp };
|
|
73
|
+
this.#cache.set(directory, cached);
|
|
74
|
+
}
|
|
75
|
+
const observed = cached.observation;
|
|
76
|
+
stateAssert(observed.volumeId === this.options.volumeId && observed.filesystem === 'apfs'
|
|
77
|
+
&& observed.fileVault && observed.encrypted && !observed.locked
|
|
78
|
+
&& observed.ownerUid === process.getuid?.() && (observed.mode & 0o077) === 0 && observed.aclEntries === 0, 'protected-workspace-required');
|
|
79
|
+
return {
|
|
80
|
+
canonicalDirectory: directory, hostId: nativeStateHostId(), encryptedVolume: true, privateAccess: true,
|
|
81
|
+
storageClass: 'protected-state-workspace', expiresAt: cached.expiresAt
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
export function darwinStateKeyReferenceId(reference) {
|
|
86
|
+
return `keychain:${stateObjectDigest(reference)}`;
|
|
87
|
+
}
|
|
88
|
+
export class DarwinKeychainStateKeyProvider {
|
|
89
|
+
reference;
|
|
90
|
+
bridge;
|
|
91
|
+
keyRef;
|
|
92
|
+
constructor(reference, bridge) {
|
|
93
|
+
this.reference = reference;
|
|
94
|
+
this.bridge = bridge;
|
|
95
|
+
stateAssert(path.isAbsolute(reference.keychainPath)
|
|
96
|
+
&& /^org\.liftoff\.state\.[a-zA-Z0-9_.:-]{1,160}$/.test(reference.service)
|
|
97
|
+
&& /^[a-zA-Z0-9][a-zA-Z0-9_.:-]{0,159}$/.test(reference.account), 'key-unavailable');
|
|
98
|
+
this.reference = Object.freeze(structuredClone(reference));
|
|
99
|
+
this.keyRef = darwinStateKeyReferenceId(this.reference);
|
|
100
|
+
}
|
|
101
|
+
async describe(keyRef, context) {
|
|
102
|
+
stateAssert(keyRef === this.keyRef && context.projectId === this.reference.account && context.hostId === nativeStateHostId(), 'key-unavailable');
|
|
103
|
+
const observed = await this.bridge.request('keychain-metadata', { reference: this.reference });
|
|
104
|
+
stateAssert(observed.present === true && observed.uid === process.getuid?.(), 'key-unavailable');
|
|
105
|
+
return { keyRef, ownerId: this.reference.account, hostId: nativeStateHostId(), storage: 'external-key-provider', algorithm: 'aes-256-gcm' };
|
|
106
|
+
}
|
|
107
|
+
async withKey(keyRef, action) {
|
|
108
|
+
stateAssert(keyRef === this.keyRef, 'key-unavailable');
|
|
109
|
+
const observed = await this.bridge.request('keychain-secret', { reference: this.reference });
|
|
110
|
+
stateAssert(observed.uid === process.getuid?.() && typeof observed.value === 'string', 'key-unavailable');
|
|
111
|
+
const stored = Buffer.from(observed.value, 'base64');
|
|
112
|
+
delete observed.value;
|
|
113
|
+
try {
|
|
114
|
+
const encoded = stored.toString('ascii').trim();
|
|
115
|
+
stateAssert(/^[A-Za-z0-9+/]{43}=$/.test(encoded), 'key-unavailable');
|
|
116
|
+
const key = Buffer.from(encoded, 'base64');
|
|
117
|
+
try {
|
|
118
|
+
stateAssert(key.length === 32, 'key-unavailable');
|
|
119
|
+
return await action(key);
|
|
120
|
+
}
|
|
121
|
+
finally {
|
|
122
|
+
key.fill(0);
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
finally {
|
|
126
|
+
stored.fill(0);
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
toJSON() { return { keyRef: this.keyRef }; }
|
|
130
|
+
}
|
|
131
|
+
export async function createDarwinStateStorageProfile(options) {
|
|
132
|
+
stateAssert(options.tools.hostId === nativeStateHostId(), 'unsupported-native-platform');
|
|
133
|
+
const bridge = new PythonDarwinStateSystemBridge(options.tools.python, options.workspaceRoot);
|
|
134
|
+
const observed = await observeDarwinStateVolume(bridge, options.workspaceRoot);
|
|
135
|
+
stateAssert(observed.filesystem === 'apfs' && observed.fileVault && observed.encrypted && !observed.locked
|
|
136
|
+
&& observed.ownerUid === process.getuid?.() && (observed.mode & 0o077) === 0 && observed.aclEntries === 0, 'protected-workspace-required');
|
|
137
|
+
stateAssert(options.keyReference.account === options.projectId, 'ownership-mismatch');
|
|
138
|
+
const volume = new DarwinFileVaultVolumeAttestor({ bridge, root: options.workspaceRoot, volumeId: observed.volumeId });
|
|
139
|
+
const keys = new DarwinKeychainStateKeyProvider(options.keyReference, bridge);
|
|
140
|
+
const storage = new FilesystemProtectedArtifactStorage(options.workspaceRoot, volume);
|
|
141
|
+
const workspace = new EncryptedStateWorkspace({
|
|
142
|
+
workspaceId: options.workspaceId ?? randomUUID(), keyRef: keys.keyRef, ownerId: options.projectId, storage, keys
|
|
143
|
+
});
|
|
144
|
+
return { workspace, volume, keys, keyRef: keys.keyRef, locks: new DarwinPosixStateLockProvider({ python: options.tools.python }), hostId: nativeStateHostId() };
|
|
145
|
+
}
|
|
146
|
+
//# sourceMappingURL=darwin-capabilities.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"darwin-capabilities.js","sourceRoot":"","sources":["../../../src/adapters/state/darwin-capabilities.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { type DarwinAzureReaderReference, type DarwinStateSystemBridge, type NativeStateHost, type ProtectedVolumeAttestor, type StateExecutionContext } from '../../domain/repair/stateful.js';
|
|
2
|
+
export declare function assertEnvironmentOnlyProviders(directory: string): Promise<void>;
|
|
3
|
+
export declare class DarwinKeychainAzureReader {
|
|
4
|
+
private readonly options;
|
|
5
|
+
readonly identityDigest: string;
|
|
6
|
+
constructor(options: {
|
|
7
|
+
reference: DarwinAzureReaderReference;
|
|
8
|
+
bridge: DarwinStateSystemBridge;
|
|
9
|
+
fetch?: typeof globalThis.fetch;
|
|
10
|
+
});
|
|
11
|
+
private json;
|
|
12
|
+
resolve(context: StateExecutionContext, resourceIds: readonly string[], signal?: AbortSignal): Promise<Readonly<Record<string, string>>>;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Observes an encrypted, private staging directory and a genuinely read-only
|
|
16
|
+
* Azure identity. Isolation here is staging/HOME/config isolation, NOT an OS
|
|
17
|
+
* sandbox; only the separately inspected fixed provider/module contract may run.
|
|
18
|
+
*/
|
|
19
|
+
export declare class DarwinObservedStateHost implements NativeStateHost {
|
|
20
|
+
#private;
|
|
21
|
+
private readonly options;
|
|
22
|
+
constructor(options: {
|
|
23
|
+
root: string;
|
|
24
|
+
context: StateExecutionContext;
|
|
25
|
+
volume: ProtectedVolumeAttestor;
|
|
26
|
+
reader: DarwinKeychainAzureReader;
|
|
27
|
+
});
|
|
28
|
+
verify(directory: string): ReturnType<NativeStateHost['verify']>;
|
|
29
|
+
privateEnvironment(directory: string): Promise<Readonly<Record<string, string>>>;
|
|
30
|
+
terminateProcessTree(pid: number): Promise<void>;
|
|
31
|
+
quiesce(): Promise<void>;
|
|
32
|
+
}
|