@papillon6814/copi 0.1.0 → 0.2.1

package/dist/src/migration-resolution.d.ts

@@ -0,0 +1,28 @@
+import type { ChangeApproval } from "./resource-mutations.ts";
+import type { MigrationMaskedDiff, MigrationResult, MigrationViewItem, MigrationWarning } from "./migration.ts";
+declare const preparedMigrationResolutionBrand: unique symbol;
+export interface PreparedMigrationResolution {
+    readonly [preparedMigrationResolutionBrand]: true;
+    readonly reviewId: string;
+}
+export type MigrationResolutionStatus = "ready" | "blocked" | "not-needed";
+export interface MigrationResolutionView {
+    readonly reviewId: string;
+    readonly status: MigrationResolutionStatus;
+    readonly backupDir: string | null;
+    readonly items: readonly MigrationViewItem[];
+    readonly conflicts: readonly string[];
+    readonly preservedPaths: readonly string[];
+    readonly maskedDiffs: readonly MigrationMaskedDiff[];
+    readonly sensitivePaths: readonly string[];
+    readonly warnings: readonly MigrationWarning[];
+}
+export type MigrationResolutionCheckpoint = "lease-acquired" | "before-claim-mkdir" | "after-claim-mkdir" | "after-claim-owner-temp-write" | "after-claim-owner-temp-sync" | "after-claim-owner-install" | "after-claim-directory-sync" | "after-claim-temp-unlink" | "after-claim-root-sync" | "before-record-temp-write" | "after-record-temp-write" | "after-record-temp-sync" | "after-record-install" | "after-record-root-sync" | "after-record-temp-unlink" | "after-record-temp-root-sync" | "before-action-intent" | "after-action-intent-temp-write" | "after-action-intent-temp-sync" | "after-action-intent-install" | "after-action-intent-root-sync" | "after-action-progress-temp-write" | "after-action-progress-temp-sync" | "after-action-progress-install" | "after-action-progress-root-sync" | "after-generation-temp-write" | "after-generation-temp-sync" | "after-generation-replace" | "after-generation-root-sync" | "before-action-unlink" | "after-action-unlink" | "before-action-parent-sync" | "after-action-parent-sync" | "after-terminal-update" | "before-record-unlink" | "after-record-unlink" | "after-record-unlink-root-sync";
+/** @internal A deterministic crash seam for subprocess checkpoint tests. */
+export declare function setMigrationResolutionCheckpointForTests(callback: ((point: MigrationResolutionCheckpoint, root: string) => void | Promise<void>) | undefined): void;
+export declare function prepareMigrationResolution(libraryDir: string): Promise<PreparedMigrationResolution>;
+export declare function readMigrationResolution(plan: PreparedMigrationResolution): MigrationResolutionView;
+/** @internal Cooperating ordinary storage readers/writers call this while holding the O_EXLOCK root lease. */
+export declare function resumeCompletedMigrationResolution(root: string, assertRootCurrent?: () => Promise<void>): Promise<void>;
+export declare function commitMigrationResolution(plan: PreparedMigrationResolution, approval: ChangeApproval): Promise<MigrationResult>;
+export {};