@papillon6814/copi 0.1.0 → 0.2.1

package/dist/src/migration.d.ts

@@ -0,0 +1,49 @@
+import type { ChangeApproval } from "./resource-mutations.ts";
+export type MigrationStatus = "ready" | "blocked" | "already-v2";
+export type MigrationSelection = "sources" | "items";
+export interface MigrationViewItem {
+    readonly id: string;
+    readonly name: string;
+    readonly target: string;
+    readonly selection: MigrationSelection;
+}
+export interface MigrationMaskedDiff {
+    readonly path: string;
+    readonly summary: string;
+}
+export interface MigrationWarning {
+    readonly code: string;
+    readonly message: string;
+    readonly path?: string;
+}
+export interface MigrationView {
+    readonly reviewId: string;
+    readonly status: MigrationStatus;
+    readonly items: readonly MigrationViewItem[];
+    readonly conflicts: readonly string[];
+    readonly preservedPaths: readonly string[];
+    readonly maskedDiffs: readonly MigrationMaskedDiff[];
+    readonly sensitivePaths: readonly string[];
+    readonly warnings: readonly MigrationWarning[];
+}
+declare const preparedMigrationBrand: unique symbol;
+export interface PreparedMigration {
+    readonly [preparedMigrationBrand]: true;
+    readonly reviewId: string;
+}
+/** Result shape shared by migration and post-switch resolution commits. */
+export interface MigrationResult {
+    readonly catalogVersion: 2;
+    readonly backupDir: string | null;
+    readonly preservedPaths: readonly string[];
+}
+export type MigrationPreviewCheckpoint = "after-tree-scan";
+/** @internal A deterministic seam for tests that change the filesystem while a preview is open. */
+export declare function setMigrationPreviewCheckpointForTests(callback: ((point: MigrationPreviewCheckpoint, root: string) => void | Promise<void>) | undefined): void;
+export declare function prepareMigration(libraryDir: string): Promise<PreparedMigration>;
+export declare function readMigration(plan: PreparedMigration): MigrationView;
+/** @internal Validates the storage adapter's request without exposing fixed migration buffers. */
+export declare function assertPreparedMigrationRequest(plan: PreparedMigration, value: unknown): Promise<void>;
+export declare function commitMigration(plan: PreparedMigration, approval: ChangeApproval): Promise<MigrationResult>;
+export { prepareMigrationResolution, readMigrationResolution, commitMigrationResolution } from "./migration-resolution.ts";
+export type { PreparedMigrationResolution, MigrationResolutionStatus, MigrationResolutionView } from "./migration-resolution.ts";