@serve.zone/interfaces 19.8.0 → 20.1.0

package/dist_ts/platform/storagemigration.d.ts

@@ -0,0 +1,346 @@
+import type { IAppStoreObjectStorageRequest, IAppStoreStorageClass } from '../appstore/types.js';
+import type { IResolvedObjectStorageBinding, IResolvedStoragePolicyRef, IStorageObjectCredentialsRef } from './storage.js';
+export declare const storageMigrationContractLimits: Readonly<{
+    version: 1;
+    maximumControlJsonBytes: number;
+    maximumConfiguredStringBytes: 2048;
+    maximumIssueMessageBytes: 4096;
+    maximumAbortReasonBytes: 4096;
+    maximumEnvironmentKeyBytes: 256;
+    maximumSecretPathBytes: 2048;
+}>;
+export declare const storageMigrationCanonicalJsonRules: Readonly<{
+    version: 1;
+    encoding: "utf-8";
+    objectKeyOrdering: "utf-16-code-unit-ascending";
+    arrayOrdering: "preserved-dense";
+    unicodeNormalization: "preserved";
+    numberEncoding: "safe-integer-json-no-negative-zero";
+    digest: "sha256-lowercase-hex";
+}>;
+export declare class StorageMigrationContractError extends Error {
+    constructor(reasonArg: string);
+}
+export type TStagedObjectStorageBinding = Omit<IResolvedObjectStorageBinding, 'failure' | 'status'> & {
+    status: 'provisioning';
+};
+export type TActiveObjectStorageBinding = Omit<IResolvedObjectStorageBinding, 'failure' | 'status'> & {
+    status: 'ready';
+};
+export interface IStorageBindingMigrationOwner {
+    migrationId: string;
+    migrationDigest: string;
+}
+export interface IUnfencedObjectStorageBindingControlSnapshot {
+    schemaVersion: 1;
+    binding: TActiveObjectStorageBinding;
+    recordRevision: number;
+    snapshotDigest: string;
+    capturedAt: number;
+    activeMigration?: never;
+}
+export interface IFencedObjectStorageBindingControlSnapshot {
+    schemaVersion: 1;
+    binding: TActiveObjectStorageBinding;
+    recordRevision: number;
+    snapshotDigest: string;
+    capturedAt: number;
+    activeMigration: IStorageBindingMigrationOwner;
+}
+export type TUnfencedObjectStorageBindingControlSnapshotDigestPayload = Omit<IUnfencedObjectStorageBindingControlSnapshot, 'snapshotDigest'>;
+export type TFencedObjectStorageBindingControlSnapshotDigestPayload = Omit<IFencedObjectStorageBindingControlSnapshot, 'snapshotDigest'>;
+export interface IObjectStorageMigrationTarget {
+    policy: IResolvedStoragePolicyRef;
+    storageClass: IAppStoreStorageClass & {
+        kind: 'objectStorage';
+    };
+    request: IAppStoreObjectStorageRequest;
+    credentials: IStorageObjectCredentialsRef;
+}
+export interface IObjectStorageMigrationPrepareRequest {
+    schemaVersion: 1;
+    migrationId: string;
+    sourceControlSnapshot: IUnfencedObjectStorageBindingControlSnapshot;
+    workloadGeneration: number;
+    target: IObjectStorageMigrationTarget;
+}
+export interface IStorageMigrationSourceEvidence {
+    preparationSnapshot: IUnfencedObjectStorageBindingControlSnapshot;
+    fencedSnapshot: IFencedObjectStorageBindingControlSnapshot;
+}
+export interface IStorageMigrationProgress {
+    objectsCopied: number;
+    logicalBytesCopied: number;
+    physicalBytesCopied?: number;
+    objectsTotal?: number;
+    logicalBytesTotal?: number;
+    physicalBytesTotal?: number;
+    updatedAt: number;
+}
+export type TStorageMigrationPreCutoverRecoveryAction = 'retry' | 'abort';
+export type TStorageMigrationPostCutoverRecoveryAction = 'retry' | 'rollForward';
+export interface IStorageMigrationIssueBase {
+    code: string;
+    message: string;
+    retryable: boolean;
+    observedAt: number;
+}
+export interface IStorageMigrationPreCutoverIssue extends IStorageMigrationIssueBase {
+    allowedRecoveryActions: TStorageMigrationPreCutoverRecoveryAction[];
+}
+export interface IStorageMigrationPostCutoverIssue extends IStorageMigrationIssueBase {
+    allowedRecoveryActions: TStorageMigrationPostCutoverRecoveryAction[];
+}
+export interface IStorageMigrationMutationFence {
+    schemaVersion: 1;
+    migrationId: string;
+    migrationDigest: string;
+    expectedMigrationRevision: number;
+    mutationId: string;
+}
+export interface IObjectStorageMigrationConsumerQuiesceRequest extends IStorageMigrationMutationFence {
+    sourceRecordRevision: number;
+    sourceControlSnapshotDigest: string;
+    candidateDigest: string;
+    workloadGeneration: number;
+    persistedStagingDigest: string;
+    persistedStagingRevision: number;
+    consumerStoppedAt: number;
+}
+export type TObjectStorageMigrationPersistedStagingDigestPayload = Omit<IObjectStorageMigrationConsumerQuiesceRequest, 'persistedStagingDigest'>;
+export interface IStorageMigrationConsumerQuiesceEvidence {
+    request: IObjectStorageMigrationConsumerQuiesceRequest;
+    acceptedMigrationRevision: number;
+    acceptedAt: number;
+}
+export interface IObjectStorageMigrationConsumerActivationRequest extends IStorageMigrationMutationFence {
+    candidateDigest: string;
+    activeBindingDigest: string;
+    workloadGeneration: number;
+    persistedActivationDigest: string;
+    persistedActivationRevision: number;
+    consumerStartedAt: number;
+}
+export type TObjectStorageMigrationPersistedActivationDigestPayload = Omit<IObjectStorageMigrationConsumerActivationRequest, 'persistedActivationDigest'>;
+export interface IStorageMigrationConsumerActivationEvidence {
+    request: IObjectStorageMigrationConsumerActivationRequest;
+    acceptedMigrationRevision: number;
+    acceptedAt: number;
+}
+export interface IObjectStorageMigrationAbortRequest extends IStorageMigrationMutationFence {
+    reason: string;
+}
+export interface IObjectStorageMigrationResumeRequest extends IStorageMigrationMutationFence {
+    action: TStorageMigrationPreCutoverRecoveryAction | TStorageMigrationPostCutoverRecoveryAction;
+}
+export interface IObjectStorageMigrationCleanupRequest extends IStorageMigrationMutationFence {
+}
+export interface IStorageMigrationStatusBase {
+    schemaVersion: 1;
+    migrationId: string;
+    migrationDigest: string;
+    migrationRevision: number;
+    bindingId: string;
+    serviceId: string;
+    requestId: string;
+    workloadGeneration: number;
+    target: IObjectStorageMigrationTarget;
+    source: IStorageMigrationSourceEvidence;
+    progress?: IStorageMigrationProgress;
+    createdAt: number;
+    updatedAt: number;
+}
+interface IStorageMigrationLiveStatusBase extends IStorageMigrationStatusBase {
+    bindingFenceActive: true;
+}
+interface IStorageMigrationTerminalStatusBase extends IStorageMigrationStatusBase {
+    bindingFenceActive: false;
+    terminalAt: number;
+}
+interface IStorageMigrationCandidateStatusBase extends IStorageMigrationLiveStatusBase {
+    candidateIssued: true;
+    candidateBinding: TStagedObjectStorageBinding;
+    candidateDigest: string;
+}
+interface IStorageMigrationQuiescedCandidateStatusBase extends IStorageMigrationCandidateStatusBase {
+    consumerQuiesceEvidence: IStorageMigrationConsumerQuiesceEvidence;
+}
+interface IStorageMigrationDestinationAuthorizedStatusBase extends IStorageMigrationQuiescedCandidateStatusBase {
+    destinationBindingStartAuthorized: true;
+    authority: 'destination';
+    activeBinding: TActiveObjectStorageBinding;
+    activeBindingDigest: string;
+}
+export interface IStorageMigrationPreparingStatus extends IStorageMigrationLiveStatusBase {
+    phase: 'preparing';
+    candidateIssued: false;
+    candidateBinding?: never;
+    candidateDigest?: never;
+    consumerQuiesceEvidence?: never;
+    consumerActivationEvidence?: never;
+    commitPointCrossed: false;
+    destinationBindingStartAuthorized: false;
+    authority: 'source';
+    consumerAction: 'wait';
+    issue?: IStorageMigrationPreCutoverIssue;
+}
+export interface IStorageMigrationTransferringStatus extends IStorageMigrationLiveStatusBase {
+    phase: 'transferring';
+    candidateIssued: false;
+    candidateBinding?: never;
+    candidateDigest?: never;
+    consumerQuiesceEvidence?: never;
+    consumerActivationEvidence?: never;
+    commitPointCrossed: false;
+    destinationBindingStartAuthorized: false;
+    authority: 'source';
+    consumerAction: 'wait';
+    issue?: IStorageMigrationPreCutoverIssue;
+}
+export interface IStorageMigrationAwaitingConsumerQuiesceStatus extends IStorageMigrationCandidateStatusBase {
+    phase: 'awaitingConsumerQuiesce';
+    consumerQuiesceEvidence?: never;
+    consumerActivationEvidence?: never;
+    commitPointCrossed: false;
+    destinationBindingStartAuthorized: false;
+    authority: 'source';
+    consumerAction: 'stageCandidateAndStop';
+    issue?: IStorageMigrationPreCutoverIssue;
+}
+export interface IStorageMigrationFinalizingStatus extends IStorageMigrationQuiescedCandidateStatusBase {
+    phase: 'finalizing';
+    consumerActivationEvidence?: never;
+    commitPointCrossed: false;
+    destinationBindingStartAuthorized: false;
+    authority: 'source';
+    consumerAction: 'wait';
+    issue?: IStorageMigrationPreCutoverIssue;
+}
+export interface IStorageMigrationCommittingStatus extends IStorageMigrationQuiescedCandidateStatusBase {
+    phase: 'committing';
+    consumerActivationEvidence?: never;
+    commitPointCrossed: true;
+    destinationBindingStartAuthorized: false;
+    authority: 'transitioning';
+    consumerAction: 'wait';
+    issue?: IStorageMigrationPostCutoverIssue;
+}
+/**
+ * Destination authority is durable, but Corestore must continue returning
+ * `startDestination` until the exact activation acknowledgement is accepted.
+ */
+export interface IStorageMigrationReadyToStartStatus extends IStorageMigrationDestinationAuthorizedStatusBase {
+    phase: 'readyToStart';
+    consumerActivationEvidence?: never;
+    commitPointCrossed: true;
+    consumerAction: 'startDestination';
+    issue?: IStorageMigrationPostCutoverIssue;
+}
+export interface IStorageMigrationCleanupPendingStatus extends IStorageMigrationDestinationAuthorizedStatusBase {
+    phase: 'cleanupPending';
+    consumerActivationEvidence: IStorageMigrationConsumerActivationEvidence;
+    commitPointCrossed: true;
+    consumerAction: 'none';
+    issue?: IStorageMigrationPostCutoverIssue;
+}
+export interface IStorageMigrationCompleteStatus extends IStorageMigrationTerminalStatusBase {
+    phase: 'complete';
+    candidateIssued: true;
+    candidateBinding: TStagedObjectStorageBinding;
+    candidateDigest: string;
+    consumerQuiesceEvidence: IStorageMigrationConsumerQuiesceEvidence;
+    consumerActivationEvidence: IStorageMigrationConsumerActivationEvidence;
+    commitPointCrossed: true;
+    destinationBindingStartAuthorized: true;
+    authority: 'destination';
+    consumerAction: 'none';
+    activeBinding: TActiveObjectStorageBinding;
+    activeBindingDigest: string;
+}
+interface IStorageMigrationAbortingStatusBase extends IStorageMigrationLiveStatusBase {
+    phase: 'aborting';
+    commitPointCrossed: false;
+    destinationBindingStartAuthorized: false;
+    authority: 'source';
+    consumerAction: 'wait';
+    consumerQuiesceEvidence?: IStorageMigrationConsumerQuiesceEvidence;
+    consumerActivationEvidence?: never;
+    issue?: IStorageMigrationPreCutoverIssue;
+}
+export interface IStorageMigrationAbortingWithoutCandidateStatus extends IStorageMigrationAbortingStatusBase {
+    candidateIssued: false;
+    candidateBinding?: never;
+    candidateDigest?: never;
+    consumerQuiesceEvidence?: never;
+}
+export interface IStorageMigrationAbortingWithCandidateStatus extends IStorageMigrationAbortingStatusBase {
+    candidateIssued: true;
+    candidateBinding?: never;
+    candidateDigest: string;
+}
+interface IStorageMigrationAbortedStatusBase extends IStorageMigrationTerminalStatusBase {
+    phase: 'aborted';
+    commitPointCrossed: false;
+    destinationBindingStartAuthorized: false;
+    authority: 'source';
+    consumerAction: 'startSource';
+    activeBinding: TActiveObjectStorageBinding;
+    activeBindingDigest: string;
+    consumerQuiesceEvidence?: IStorageMigrationConsumerQuiesceEvidence;
+    consumerActivationEvidence?: never;
+}
+export interface IStorageMigrationAbortedWithoutCandidateStatus extends IStorageMigrationAbortedStatusBase {
+    candidateIssued: false;
+    candidateBinding?: never;
+    candidateDigest?: never;
+    consumerQuiesceEvidence?: never;
+}
+export interface IStorageMigrationAbortedWithCandidateStatus extends IStorageMigrationAbortedStatusBase {
+    candidateIssued: true;
+    candidateBinding?: never;
+    candidateDigest: string;
+}
+export type TObjectStorageMigrationStatus = IStorageMigrationPreparingStatus | IStorageMigrationTransferringStatus | IStorageMigrationAwaitingConsumerQuiesceStatus | IStorageMigrationFinalizingStatus | IStorageMigrationCommittingStatus | IStorageMigrationReadyToStartStatus | IStorageMigrationCleanupPendingStatus | IStorageMigrationCompleteStatus | IStorageMigrationAbortingWithoutCandidateStatus | IStorageMigrationAbortingWithCandidateStatus | IStorageMigrationAbortedWithoutCandidateStatus | IStorageMigrationAbortedWithCandidateStatus;
+/**
+ * Enforce this against Content-Length and the running request byte count
+ * before buffering or decoding a storage-migration control body.
+ */
+export declare const assertStorageMigrationControlIngressByteLength: (valueArg: unknown) => number;
+export declare const normalizeStorageBindingMigrationOwner: (valueArg: unknown) => Readonly<IStorageBindingMigrationOwner>;
+export declare const canonicalizeUnfencedObjectStorageBindingControlSnapshotPayload: (valueArg: unknown) => string;
+export declare const canonicalizeFencedObjectStorageBindingControlSnapshotPayload: (valueArg: unknown) => string;
+export declare const createUnfencedObjectStorageBindingControlSnapshotSha256: (valueArg: unknown) => Promise<string>;
+export declare const createFencedObjectStorageBindingControlSnapshotSha256: (valueArg: unknown) => Promise<string>;
+export declare const normalizeUnfencedObjectStorageBindingControlSnapshot: (valueArg: unknown) => Promise<Readonly<IUnfencedObjectStorageBindingControlSnapshot>>;
+export declare const normalizeFencedObjectStorageBindingControlSnapshot: (valueArg: unknown) => Promise<Readonly<IFencedObjectStorageBindingControlSnapshot>>;
+export declare const normalizeObjectStorageMigrationTarget: (valueArg: unknown) => Readonly<IObjectStorageMigrationTarget>;
+export declare const normalizeStagedObjectStorageBinding: (valueArg: unknown) => Readonly<TStagedObjectStorageBinding>;
+export declare const normalizeActiveObjectStorageBinding: (valueArg: unknown) => Readonly<TActiveObjectStorageBinding>;
+export declare const canonicalizeObjectStorageMigrationTargetRequest: (valueArg: unknown) => string;
+export declare const createObjectStorageMigrationTargetRequestSha256: (valueArg: unknown) => Promise<string>;
+export declare const canonicalizeObjectStorageMigrationBinding: (valueArg: unknown) => string;
+export declare const createObjectStorageMigrationBindingSha256: (valueArg: unknown) => Promise<string>;
+export declare const normalizeObjectStorageMigrationPrepareRequest: (valueArg: unknown) => Promise<Readonly<IObjectStorageMigrationPrepareRequest>>;
+export declare const canonicalizeObjectStorageMigrationPrepareRequest: (valueArg: unknown) => Promise<string>;
+export declare const createObjectStorageMigrationSha256: (valueArg: unknown) => Promise<string>;
+export declare const normalizeStorageMigrationMutationFence: (valueArg: unknown) => Readonly<IStorageMigrationMutationFence>;
+export declare const createObjectStorageMigrationPersistedStagingSha256: (valueArg: unknown) => Promise<string>;
+export declare const normalizeObjectStorageMigrationConsumerQuiesceRequest: (valueArg: unknown) => Promise<Readonly<IObjectStorageMigrationConsumerQuiesceRequest>>;
+export declare const createObjectStorageMigrationPersistedActivationSha256: (valueArg: unknown) => Promise<string>;
+export declare const normalizeObjectStorageMigrationConsumerActivationRequest: (valueArg: unknown) => Promise<Readonly<IObjectStorageMigrationConsumerActivationRequest>>;
+export declare const normalizeStorageMigrationConsumerQuiesceEvidence: (valueArg: unknown) => Promise<Readonly<IStorageMigrationConsumerQuiesceEvidence>>;
+export declare const normalizeStorageMigrationConsumerActivationEvidence: (valueArg: unknown) => Promise<Readonly<IStorageMigrationConsumerActivationEvidence>>;
+export declare const normalizeObjectStorageMigrationAbortRequest: (valueArg: unknown) => Readonly<IObjectStorageMigrationAbortRequest>;
+export declare const normalizeObjectStorageMigrationResumeRequest: (valueArg: unknown) => Readonly<IObjectStorageMigrationResumeRequest>;
+export declare const normalizeObjectStorageMigrationCleanupRequest: (valueArg: unknown) => Readonly<IObjectStorageMigrationCleanupRequest>;
+export declare const normalizeStorageMigrationSourceEvidence: (valueArg: unknown) => Promise<Readonly<IStorageMigrationSourceEvidence>>;
+export declare const normalizeObjectStorageMigrationStatus: (valueArg: unknown) => Promise<Readonly<TObjectStorageMigrationStatus>>;
+export declare const bindObjectStorageMigrationConsumerQuiesceRequest: (requestArg: unknown, statusArg: unknown) => Promise<Readonly<IObjectStorageMigrationConsumerQuiesceRequest>>;
+export declare const bindObjectStorageMigrationConsumerActivationRequest: (requestArg: unknown, statusArg: unknown) => Promise<Readonly<IObjectStorageMigrationConsumerActivationRequest>>;
+export declare const bindObjectStorageMigrationAbortRequest: (requestArg: unknown, statusArg: unknown) => Promise<Readonly<IObjectStorageMigrationAbortRequest>>;
+export declare const bindObjectStorageMigrationResumeRequest: (requestArg: unknown, statusArg: unknown) => Promise<Readonly<IObjectStorageMigrationResumeRequest>>;
+export declare const bindObjectStorageMigrationCleanupRequest: (requestArg: unknown, statusArg: unknown) => Promise<Readonly<IObjectStorageMigrationCleanupRequest>>;
+export declare const normalizeStorageMigrationProgress: (valueArg: unknown) => Readonly<IStorageMigrationProgress>;
+export declare const normalizeStorageMigrationPreCutoverIssue: (valueArg: unknown) => Readonly<IStorageMigrationPreCutoverIssue>;
+export declare const normalizeStorageMigrationPostCutoverIssue: (valueArg: unknown) => Readonly<IStorageMigrationPostCutoverIssue>;
+export { storageMigrationCanonicalDigestGoldenVectors, type IStorageMigrationCanonicalDigestGoldenVector, } from './storagemigration.golden.js';

package/dist_ts/platform/storagemigration.golden.d.ts

@@ -0,0 +1,49 @@
+import type { IObjectStorageMigrationPrepareRequest, TStagedObjectStorageBinding, TUnfencedObjectStorageBindingControlSnapshotDigestPayload } from './storagemigration.js';
+export interface IStorageMigrationCanonicalDigestGoldenVector<TInput> {
+    input: TInput;
+    canonicalJson: string;
+    sha256: string;
+}
+export declare const storageMigrationCanonicalDigestGoldenVectors: {
+    version: 1;
+    targetRequest: {
+        input: {
+            readonly id: "object-data";
+            readonly kind: "objectStorage";
+            readonly storageClass: "backupCapacity";
+            readonly capacity: {
+                readonly request: "500GiB";
+                readonly limit: "1TiB";
+            };
+            readonly reclaimPolicy: "retain";
+            readonly accessMode: "readWrite";
+            readonly delivery: {
+                readonly type: "environment";
+                readonly keys: {
+                    readonly endpoint: "APP_S3_ENDPOINT";
+                    readonly bucket: "APP_S3_BUCKET";
+                    readonly region: "APP_S3_REGION";
+                    readonly accessKeyId: "APP_S3_ACCESS_KEY";
+                    readonly secretAccessKey: "APP_S3_SECRET_KEY";
+                };
+            };
+        };
+        canonicalJson: string;
+        sha256: string;
+    };
+    preparationSnapshot: {
+        input: TUnfencedObjectStorageBindingControlSnapshotDigestPayload;
+        canonicalJson: string;
+        sha256: string;
+    };
+    prepareRequest: {
+        input: IObjectStorageMigrationPrepareRequest;
+        canonicalJson: string;
+        sha256: string;
+    };
+    candidateBinding: {
+        input: TStagedObjectStorageBinding;
+        canonicalJson: string;
+        sha256: string;
+    };
+};

package/dist_ts/platform/storagemigration.golden.js

@@ -0,0 +1,207 @@
+import { deepFreezeValue } from '../private/canonicaljson.js';
+const capabilities = {
+    performanceTier: 'capacity',
+    durability: 'persistent',
+    topology: 'singleNode',
+    hardQuota: true,
+    snapshots: 'none',
+    backup: true,
+    encryptedInTransit: true,
+};
+const delivery = {
+    type: 'environment',
+    keys: {
+        endpoint: 'APP_S3_ENDPOINT',
+        bucket: 'APP_S3_BUCKET',
+        region: 'APP_S3_REGION',
+        accessKeyId: 'APP_S3_ACCESS_KEY',
+        secretAccessKey: 'APP_S3_SECRET_KEY',
+    },
+};
+const credentials = {
+    secretBundleId: 'service-storage',
+    accessKeyIdKey: 'object.accessKeyId',
+    secretAccessKeyKey: 'object.secretAccessKey',
+};
+const sourceBinding = {
+    schemaVersion: 1,
+    id: 'binding-object',
+    serviceId: 'service-app',
+    requestId: 'object-data',
+    requestDigest: '1111111111111111111111111111111111111111111111111111111111111111',
+    kind: 'objectStorage',
+    generation: 3,
+    observedGeneration: 3,
+    status: 'ready',
+    policy: {
+        classId: 'source-object',
+        revision: '1',
+    },
+    capabilities,
+    resourceRef: 'source-resource',
+    accessMode: 'readWrite',
+    connection: {
+        endpoint: 'https://source.example.test',
+        bucket: 'source-bucket',
+        region: 'local',
+    },
+    credentials,
+    delivery,
+    versioning: false,
+    createdAt: 1_700_000_000_000,
+    updatedAt: 1_700_000_000_001,
+};
+const target = {
+    policy: {
+        classId: 'capacity-object',
+        revision: '4',
+    },
+    storageClass: {
+        kind: 'objectStorage',
+        purpose: 'backup',
+        required: {
+            performanceTier: 'capacity',
+            durability: 'persistent',
+            backup: true,
+        },
+    },
+    request: {
+        id: 'object-data',
+        kind: 'objectStorage',
+        storageClass: 'backupCapacity',
+        capacity: {
+            request: '500GiB',
+            limit: '1TiB',
+        },
+        reclaimPolicy: 'retain',
+        accessMode: 'readWrite',
+        delivery,
+    },
+    credentials,
+};
+const preparationSnapshotPayload = {
+    schemaVersion: 1,
+    binding: sourceBinding,
+    recordRevision: 12,
+    capturedAt: 1_700_000_000_010,
+};
+const preparationSnapshot = {
+    ...preparationSnapshotPayload,
+    snapshotDigest: '35870a0c3ca7f2ee70d0ae7f83109bec23a8ce59bf8efef1c94221a496210439',
+};
+const prepareRequest = {
+    schemaVersion: 1,
+    migrationId: 'migration-object-capacity',
+    sourceControlSnapshot: preparationSnapshot,
+    workloadGeneration: 8,
+    target,
+};
+const candidateBinding = {
+    ...sourceBinding,
+    requestDigest: '2096dfa1f6db50d670cbb4d6436f38c2eec383435c99346e31d0d1a9e0b1beba',
+    generation: 4,
+    observedGeneration: 3,
+    status: 'provisioning',
+    policy: target.policy,
+    resourceRef: 'destination-resource',
+    capacity: {
+        requested: '500GiB',
+        granted: '500GiB',
+        limit: '1TiB',
+    },
+    connection: {
+        endpoint: 'https://destination.example.test',
+        bucket: 'destination-bucket',
+        region: 'local',
+    },
+    updatedAt: 1_700_000_000_020,
+};
+export const storageMigrationCanonicalDigestGoldenVectors = deepFreezeValue({
+    version: 1,
+    targetRequest: {
+        input: target.request,
+        canonicalJson: '{"accessMode":"readWrite","capacity":{"limit":"1TiB","request":"500GiB"},' +
+            '"delivery":{"keys":{"accessKeyId":"APP_S3_ACCESS_KEY","bucket":"APP_S3_BUCKET",' +
+            '"endpoint":"APP_S3_ENDPOINT","region":"APP_S3_REGION",' +
+            '"secretAccessKey":"APP_S3_SECRET_KEY"},"type":"environment"},' +
+            '"id":"object-data","kind":"objectStorage","reclaimPolicy":"retain",' +
+            '"storageClass":"backupCapacity"}',
+        sha256: '2096dfa1f6db50d670cbb4d6436f38c2eec383435c99346e31d0d1a9e0b1beba',
+    },
+    preparationSnapshot: {
+        input: preparationSnapshotPayload,
+        canonicalJson: '{"binding":{"accessMode":"readWrite","capabilities":{"backup":true,' +
+            '"durability":"persistent","encryptedInTransit":true,"hardQuota":true,' +
+            '"performanceTier":"capacity","snapshots":"none","topology":"singleNode"},' +
+            '"connection":{"bucket":"source-bucket","endpoint":"https://source.example.test",' +
+            '"region":"local"},"createdAt":1700000000000,"credentials":' +
+            '{"accessKeyIdKey":"object.accessKeyId","secretAccessKeyKey":"object.secretAccessKey",' +
+            '"secretBundleId":"service-storage"},"delivery":{"keys":' +
+            '{"accessKeyId":"APP_S3_ACCESS_KEY","bucket":"APP_S3_BUCKET",' +
+            '"endpoint":"APP_S3_ENDPOINT","region":"APP_S3_REGION",' +
+            '"secretAccessKey":"APP_S3_SECRET_KEY"},"type":"environment"},' +
+            '"generation":3,"id":"binding-object","kind":"objectStorage",' +
+            '"observedGeneration":3,"policy":{"classId":"source-object","revision":"1"},' +
+            '"requestDigest":"1111111111111111111111111111111111111111111111111111111111111111",' +
+            '"requestId":"object-data","resourceRef":"source-resource","schemaVersion":1,' +
+            '"serviceId":"service-app","status":"ready","updatedAt":1700000000001,' +
+            '"versioning":false},"capturedAt":1700000000010,"recordRevision":12,"schemaVersion":1}',
+        sha256: '35870a0c3ca7f2ee70d0ae7f83109bec23a8ce59bf8efef1c94221a496210439',
+    },
+    prepareRequest: {
+        input: prepareRequest,
+        canonicalJson: '{"migrationId":"migration-object-capacity","schemaVersion":1,' +
+            '"sourceControlSnapshot":{"binding":{"accessMode":"readWrite",' +
+            '"capabilities":{"backup":true,"durability":"persistent",' +
+            '"encryptedInTransit":true,"hardQuota":true,"performanceTier":"capacity",' +
+            '"snapshots":"none","topology":"singleNode"},"connection":' +
+            '{"bucket":"source-bucket","endpoint":"https://source.example.test","region":"local"},' +
+            '"createdAt":1700000000000,"credentials":{"accessKeyIdKey":"object.accessKeyId",' +
+            '"secretAccessKeyKey":"object.secretAccessKey","secretBundleId":"service-storage"},' +
+            '"delivery":{"keys":{"accessKeyId":"APP_S3_ACCESS_KEY","bucket":"APP_S3_BUCKET",' +
+            '"endpoint":"APP_S3_ENDPOINT","region":"APP_S3_REGION",' +
+            '"secretAccessKey":"APP_S3_SECRET_KEY"},"type":"environment"},' +
+            '"generation":3,"id":"binding-object","kind":"objectStorage",' +
+            '"observedGeneration":3,"policy":{"classId":"source-object","revision":"1"},' +
+            '"requestDigest":"1111111111111111111111111111111111111111111111111111111111111111",' +
+            '"requestId":"object-data","resourceRef":"source-resource","schemaVersion":1,' +
+            '"serviceId":"service-app","status":"ready","updatedAt":1700000000001,' +
+            '"versioning":false},"capturedAt":1700000000010,"recordRevision":12,' +
+            '"schemaVersion":1,"snapshotDigest":' +
+            '"35870a0c3ca7f2ee70d0ae7f83109bec23a8ce59bf8efef1c94221a496210439"},' +
+            '"target":{"credentials":{"accessKeyIdKey":"object.accessKeyId",' +
+            '"secretAccessKeyKey":"object.secretAccessKey","secretBundleId":"service-storage"},' +
+            '"policy":{"classId":"capacity-object","revision":"4"},"request":' +
+            '{"accessMode":"readWrite","capacity":{"limit":"1TiB","request":"500GiB"},' +
+            '"delivery":{"keys":{"accessKeyId":"APP_S3_ACCESS_KEY","bucket":"APP_S3_BUCKET",' +
+            '"endpoint":"APP_S3_ENDPOINT","region":"APP_S3_REGION",' +
+            '"secretAccessKey":"APP_S3_SECRET_KEY"},"type":"environment"},' +
+            '"id":"object-data","kind":"objectStorage","reclaimPolicy":"retain",' +
+            '"storageClass":"backupCapacity"},"storageClass":{"kind":"objectStorage",' +
+            '"purpose":"backup","required":{"backup":true,"durability":"persistent",' +
+            '"performanceTier":"capacity"}}},"workloadGeneration":8}',
+        sha256: 'ecbb40ec9bfa20b9f4372eb0d00eaf79c3e84dd3132c5bde7e65ba3fec55e595',
+    },
+    candidateBinding: {
+        input: candidateBinding,
+        canonicalJson: '{"accessMode":"readWrite","capabilities":{"backup":true,' +
+            '"durability":"persistent","encryptedInTransit":true,"hardQuota":true,' +
+            '"performanceTier":"capacity","snapshots":"none","topology":"singleNode"},' +
+            '"capacity":{"granted":"500GiB","limit":"1TiB","requested":"500GiB"},' +
+            '"connection":{"bucket":"destination-bucket",' +
+            '"endpoint":"https://destination.example.test","region":"local"},' +
+            '"createdAt":1700000000000,"credentials":{"accessKeyIdKey":"object.accessKeyId",' +
+            '"secretAccessKeyKey":"object.secretAccessKey","secretBundleId":"service-storage"},' +
+            '"delivery":{"keys":{"accessKeyId":"APP_S3_ACCESS_KEY","bucket":"APP_S3_BUCKET",' +
+            '"endpoint":"APP_S3_ENDPOINT","region":"APP_S3_REGION",' +
+            '"secretAccessKey":"APP_S3_SECRET_KEY"},"type":"environment"},' +
+            '"generation":4,"id":"binding-object","kind":"objectStorage",' +
+            '"observedGeneration":3,"policy":{"classId":"capacity-object","revision":"4"},' +
+            '"requestDigest":"2096dfa1f6db50d670cbb4d6436f38c2eec383435c99346e31d0d1a9e0b1beba",' +
+            '"requestId":"object-data","resourceRef":"destination-resource",' +
+            '"schemaVersion":1,"serviceId":"service-app","status":"provisioning",' +
+            '"updatedAt":1700000000020,"versioning":false}',
+        sha256: 'b49017f41cd86626ccb05ffa5fb591994a5e20fad9856182b1a1d4c964c6177c',
+    },
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RvcmFnZW1pZ3JhdGlvbi5nb2xkZW4uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9wbGF0Zm9ybS9zdG9yYWdlbWlncmF0aW9uLmdvbGRlbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFlOUQsTUFBTSxZQUFZLEdBQUc7SUFDbkIsZUFBZSxFQUFFLFVBQVU7SUFDM0IsVUFBVSxFQUFFLFlBQVk7SUFDeEIsUUFBUSxFQUFFLFlBQVk7SUFDdEIsU0FBUyxFQUFFLElBQUk7SUFDZixTQUFTLEVBQUUsTUFBTTtJQUNqQixNQUFNLEVBQUUsSUFBSTtJQUNaLGtCQUFrQixFQUFFLElBQUk7Q0FDaEIsQ0FBQztBQUVYLE1BQU0sUUFBUSxHQUFHO0lBQ2YsSUFBSSxFQUFFLGFBQWE7SUFDbkIsSUFBSSxFQUFFO1FBQ0osUUFBUSxFQUFFLGlCQUFpQjtRQUMzQixNQUFNLEVBQUUsZUFBZTtRQUN2QixNQUFNLEVBQUUsZUFBZTtRQUN2QixXQUFXLEVBQUUsbUJBQW1CO1FBQ2hDLGVBQWUsRUFBRSxtQkFBbUI7S0FDckM7Q0FDTyxDQUFDO0FBRVgsTUFBTSxXQUFXLEdBQUc7SUFDbEIsY0FBYyxFQUFFLGlCQUFpQjtJQUNqQyxjQUFjLEVBQUUsb0JBQW9CO0lBQ3BDLGtCQUFrQixFQUFFLHdCQUF3QjtDQUM3QyxDQUFDO0FBRUYsTUFBTSxhQUFhLEdBQWdDO0lBQ2pELGFBQWEsRUFBRSxDQUFDO0lBQ2hCLEVBQUUsRUFBRSxnQkFBZ0I7SUFDcEIsU0FBUyxFQUFFLGFBQWE7SUFDeEIsU0FBUyxFQUFFLGFBQWE7SUFDeEIsYUFBYSxFQUNYLGtFQUFrRTtJQUNwRSxJQUFJLEVBQUUsZUFBZTtJQUNyQixVQUFVLEVBQUUsQ0FBQztJQUNiLGtCQUFrQixFQUFFLENBQUM7SUFDckIsTUFBTSxFQUFFLE9BQU87SUFDZixNQUFNLEVBQUU7UUFDTixPQUFPLEVBQUUsZUFBZTtRQUN4QixRQUFRLEVBQUUsR0FBRztLQUNkO0lBQ0QsWUFBWTtJQUNaLFdBQVcsRUFBRSxpQkFBaUI7SUFDOUIsVUFBVSxFQUFFLFdBQVc7SUFDdkIsVUFBVSxFQUFFO1FBQ1YsUUFBUSxFQUFFLDZCQUE2QjtRQUN2QyxNQUFNLEVBQUUsZUFBZTtRQUN2QixNQUFNLEVBQUUsT0FBTztLQUNoQjtJQUNELFdBQVc7SUFDWCxRQUFRO0lBQ1IsVUFBVSxFQUFFLEtBQUs7SUFDakIsU0FBUyxFQUFFLGlCQUFpQjtJQUM1QixTQUFTLEVBQUUsaUJBQWlCO0NBQzdCLENBQUM7QUFFRixNQUFNLE1BQU0sR0FBRztJQUNiLE1BQU0sRUFBRTtRQUNOLE9BQU8sRUFBRSxpQkFBaUI7UUFDMUIsUUFBUSxFQUFFLEdBQUc7S0FDZDtJQUNELFlBQVksRUFBRTtRQUNaLElBQUksRUFBRSxlQUFlO1FBQ3JCLE9BQU8sRUFBRSxRQUFRO1FBQ2pCLFFBQVEsRUFBRTtZQUNSLGVBQWUsRUFBRSxVQUFVO1lBQzNCLFVBQVUsRUFBRSxZQUFZO1lBQ3hCLE1BQU0sRUFBRSxJQUFJO1NBQ2I7S0FDRjtJQUNELE9BQU8sRUFBRTtRQUNQLEVBQUUsRUFBRSxhQUFhO1FBQ2pCLElBQUksRUFBRSxlQUFlO1FBQ3JCLFlBQVksRUFBRSxnQkFBZ0I7UUFDOUIsUUFBUSxFQUFFO1lBQ1IsT0FBTyxFQUFFLFFBQVE7WUFDakIsS0FBSyxFQUFFLE1BQU07U0FDZDtRQUNELGFBQWEsRUFBRSxRQUFRO1FBQ3ZCLFVBQVUsRUFBRSxXQUFXO1FBQ3ZCLFFBQVE7S0FDVDtJQUNELFdBQVc7Q0FDSCxDQUFDO0FBRVgsTUFBTSwwQkFBMEIsR0FDNEI7SUFDMUQsYUFBYSxFQUFFLENBQUM7SUFDaEIsT0FBTyxFQUFFLGFBQWE7SUFDdEIsY0FBYyxFQUFFLEVBQUU7SUFDbEIsVUFBVSxFQUFFLGlCQUFpQjtDQUM5QixDQUFDO0FBRUYsTUFBTSxtQkFBbUIsR0FBaUQ7SUFDeEUsR0FBRywwQkFBMEI7SUFDN0IsY0FBYyxFQUNaLGtFQUFrRTtDQUNyRSxDQUFDO0FBRUYsTUFBTSxjQUFjLEdBQTBDO0lBQzVELGFBQWEsRUFBRSxDQUFDO0lBQ2hCLFdBQVcsRUFBRSwyQkFBMkI7SUFDeEMscUJBQXFCLEVBQUUsbUJBQW1CO0lBQzFDLGtCQUFrQixFQUFFLENBQUM7SUFDckIsTUFBTTtDQUNQLENBQUM7QUFFRixNQUFNLGdCQUFnQixHQUFnQztJQUNwRCxHQUFHLGFBQWE7SUFDaEIsYUFBYSxFQUNYLGtFQUFrRTtJQUNwRSxVQUFVLEVBQUUsQ0FBQztJQUNiLGtCQUFrQixFQUFFLENBQUM7SUFDckIsTUFBTSxFQUFFLGNBQWM7SUFDdEIsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNO0lBQ3JCLFdBQVcsRUFBRSxzQkFBc0I7SUFDbkMsUUFBUSxFQUFFO1FBQ1IsU0FBUyxFQUFFLFFBQVE7UUFDbkIsT0FBTyxFQUFFLFFBQVE7UUFDakIsS0FBSyxFQUFFLE1BQU07S0FDZDtJQUNELFVBQVUsRUFBRTtRQUNWLFFBQVEsRUFBRSxrQ0FBa0M7UUFDNUMsTUFBTSxFQUFFLG9CQUFvQjtRQUM1QixNQUFNLEVBQUUsT0FBTztLQUNoQjtJQUNELFNBQVMsRUFBRSxpQkFBaUI7Q0FDN0IsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLDRDQUE0QyxHQUFHLGVBQWUsQ0FBQztJQUMxRSxPQUFPLEVBQUUsQ0FBVTtJQUNuQixhQUFhLEVBQUU7UUFDYixLQUFLLEVBQUUsTUFBTSxDQUFDLE9BQU87UUFDckIsYUFBYSxFQUNYLDJFQUEyRTtZQUMzRSxpRkFBaUY7WUFDakYsd0RBQXdEO1lBQ3hELCtEQUErRDtZQUMvRCxxRUFBcUU7WUFDckUsa0NBQWtDO1FBQ3BDLE1BQU0sRUFDSixrRUFBa0U7S0FDckU7SUFDRCxtQkFBbUIsRUFBRTtRQUNuQixLQUFLLEVBQUUsMEJBQTBCO1FBQ2pDLGFBQWEsRUFDWCxxRUFBcUU7WUFDckUsdUVBQXVFO1lBQ3ZFLDJFQUEyRTtZQUMzRSxrRkFBa0Y7WUFDbEYsNERBQTREO1lBQzVELHVGQUF1RjtZQUN2Rix5REFBeUQ7WUFDekQsOERBQThEO1lBQzlELHdEQUF3RDtZQUN4RCwrREFBK0Q7WUFDL0QsOERBQThEO1lBQzlELDZFQUE2RTtZQUM3RSxxRkFBcUY7WUFDckYsOEVBQThFO1lBQzlFLHVFQUF1RTtZQUN2RSx1RkFBdUY7UUFDekYsTUFBTSxFQUNKLGtFQUFrRTtLQUNyRTtJQUNELGNBQWMsRUFBRTtRQUNkLEtBQUssRUFBRSxjQUFjO1FBQ3JCLGFBQWEsRUFDWCwrREFBK0Q7WUFDL0QsK0RBQStEO1lBQy9ELDBEQUEwRDtZQUMxRCwwRUFBMEU7WUFDMUUsMkRBQTJEO1lBQzNELHVGQUF1RjtZQUN2RixpRkFBaUY7WUFDakYsb0ZBQW9GO1lBQ3BGLGlGQUFpRjtZQUNqRix3REFBd0Q7WUFDeEQsK0RBQStEO1lBQy9ELDhEQUE4RDtZQUM5RCw2RUFBNkU7WUFDN0UscUZBQXFGO1lBQ3JGLDhFQUE4RTtZQUM5RSx1RUFBdUU7WUFDdkUscUVBQXFFO1lBQ3JFLHFDQUFxQztZQUNyQyxzRUFBc0U7WUFDdEUsaUVBQWlFO1lBQ2pFLG9GQUFvRjtZQUNwRixrRUFBa0U7WUFDbEUsMkVBQTJFO1lBQzNFLGlGQUFpRjtZQUNqRix3REFBd0Q7WUFDeEQsK0RBQStEO1lBQy9ELHFFQUFxRTtZQUNyRSwwRUFBMEU7WUFDMUUseUVBQXlFO1lBQ3pFLHlEQUF5RDtRQUMzRCxNQUFNLEVBQ0osa0VBQWtFO0tBQ3JFO0lBQ0QsZ0JBQWdCLEVBQUU7UUFDaEIsS0FBSyxFQUFFLGdCQUFnQjtRQUN2QixhQUFhLEVBQ1gsMERBQTBEO1lBQzFELHVFQUF1RTtZQUN2RSwyRUFBMkU7WUFDM0Usc0VBQXNFO1lBQ3RFLDhDQUE4QztZQUM5QyxrRUFBa0U7WUFDbEUsaUZBQWlGO1lBQ2pGLG9GQUFvRjtZQUNwRixpRkFBaUY7WUFDakYsd0RBQXdEO1lBQ3hELCtEQUErRDtZQUMvRCw4REFBOEQ7WUFDOUQsK0VBQStFO1lBQy9FLHFGQUFxRjtZQUNyRixpRUFBaUU7WUFDakUsc0VBQXNFO1lBQ3RFLCtDQUErQztRQUNqRCxNQUFNLEVBQ0osa0VBQWtFO0tBQ3JFO0NBQ0YsQ0FBQyxDQUFDIn0=