@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/dist/core/pactile/lifecycle.d.ts

@@ -0,0 +1,106 @@
+import { PACTILE_CANONICAL_ROOT_V1, type PactileLegacyRootV1 } from "./runtime.js";
+import { PACTILE_CONTRACT_SCHEMA_VERSION, type PactileContractParseResultV1 } from "./validation.js";
+export declare const MIGRATION_SOURCE_KINDS_V1: readonly ["fresh", "canonical", "legacy"];
+export type MigrationSourceKindV1 = (typeof MIGRATION_SOURCE_KINDS_V1)[number];
+export interface MigrationSourceV1 {
+    readonly kind: MigrationSourceKindV1;
+    readonly root: typeof PACTILE_CANONICAL_ROOT_V1 | PactileLegacyRootV1 | null;
+    readonly access: "none" | "read-only" | "read-write";
+    readonly runtimeVersion: string | null;
+    readonly schemaVersion: number | null;
+}
+export interface MigrationTargetV1 {
+    readonly root: typeof PACTILE_CANONICAL_ROOT_V1;
+    readonly runtimeVersion: string;
+    readonly schemaVersion: typeof PACTILE_CONTRACT_SCHEMA_VERSION;
+    readonly generationId: string;
+}
+export declare const MIGRATION_PHASES_V1: readonly ["detect", "backup", "stage", "validate", "commit", "reconcile", "doctor"];
+export type MigrationPhaseV1 = (typeof MIGRATION_PHASES_V1)[number];
+export declare const MIGRATION_ACTION_KINDS_V1: readonly ["capture-facts", "snapshot", "copy-byte-preserved", "transform-schema", "write-generation", "validate-generation", "activate-generation", "reconcile-projection", "doctor"];
+export type MigrationActionKindV1 = (typeof MIGRATION_ACTION_KINDS_V1)[number];
+export declare const MIGRATION_ACTION_DOMAINS_V1: readonly ["canonical", "projection"];
+export type MigrationActionDomainV1 = (typeof MIGRATION_ACTION_DOMAINS_V1)[number];
+export interface MigrationActionV1 {
+    readonly id: string;
+    readonly phase: MigrationPhaseV1;
+    readonly kind: MigrationActionKindV1;
+    readonly domain: MigrationActionDomainV1;
+    readonly sourceRef: string | null;
+    readonly targetRef: string | null;
+    readonly adapterId: string | null;
+    readonly reversible: boolean;
+}
+export interface MigrationPreservationV1 {
+    readonly bytePreservedRefs: readonly string[];
+    readonly transformedRefs: readonly string[];
+}
+export interface MigrationRecoveryV1 {
+    readonly backupRef: string;
+    readonly preserveNewerData: true;
+}
+export interface MigrationPlanV1 {
+    readonly schemaVersion: typeof PACTILE_CONTRACT_SCHEMA_VERSION;
+    readonly id: string;
+    readonly source: MigrationSourceV1;
+    readonly target: MigrationTargetV1;
+    readonly actions: readonly MigrationActionV1[];
+    readonly canonicalCommitPointActionId: string;
+    readonly preservation: MigrationPreservationV1;
+    readonly recovery: MigrationRecoveryV1;
+    readonly projectionPlanIds: readonly string[];
+}
+export declare const MIGRATION_JOURNAL_STATES_V1: readonly ["planned", "backed-up", "staged", "validated", "committed", "reconciling", "completed", "degraded", "recovering", "rolled-back", "failed"];
+export type MigrationJournalStateV1 = (typeof MIGRATION_JOURNAL_STATES_V1)[number];
+export declare const CANONICAL_COMMIT_STATES_V1: readonly ["pending", "committed"];
+export type CanonicalCommitStateV1 = (typeof CANONICAL_COMMIT_STATES_V1)[number];
+export interface CanonicalCommitV1 {
+    readonly status: CanonicalCommitStateV1;
+    readonly actionId: string;
+    readonly generationId: string | null;
+    readonly committedAt: string | null;
+}
+export declare const MIGRATION_RECOVERY_STATES_V1: readonly ["not-required", "available", "in-progress", "completed", "failed"];
+export type MigrationRecoveryStateV1 = (typeof MIGRATION_RECOVERY_STATES_V1)[number];
+export interface MigrationRecoveryStateRecordV1 {
+    readonly status: MigrationRecoveryStateV1;
+    readonly backupRef: string;
+    readonly updatedAt: string;
+    readonly error: string | null;
+}
+export declare const ADAPTER_RECONCILE_STATES_V1: readonly ["pending", "in-progress", "succeeded", "failed"];
+export type AdapterReconcileStateV1 = (typeof ADAPTER_RECONCILE_STATES_V1)[number];
+export interface AdapterReconcileJournalV1 {
+    readonly adapterId: string;
+    readonly projectionPlanId: string;
+    readonly status: AdapterReconcileStateV1;
+    readonly attempts: number;
+    readonly lastAttemptAt: string | null;
+    readonly lastError: string | null;
+}
+export declare const MIGRATION_JOURNAL_EVENTS_V1: readonly ["planned", "backup-completed", "stage-completed", "validation-completed", "canonical-committed", "adapter-reconcile-started", "adapter-reconcile-succeeded", "adapter-reconcile-failed", "doctor-completed", "recovery-started", "recovery-completed", "failed"];
+export type MigrationJournalEventKindV1 = (typeof MIGRATION_JOURNAL_EVENTS_V1)[number];
+export interface MigrationJournalEventV1 {
+    readonly sequence: number;
+    readonly at: string;
+    readonly event: MigrationJournalEventKindV1;
+    readonly actionId: string | null;
+    readonly adapterId: string | null;
+    readonly evidenceRefs: readonly string[];
+}
+export interface MigrationJournalV1 {
+    readonly schemaVersion: typeof PACTILE_CONTRACT_SCHEMA_VERSION;
+    readonly id: string;
+    readonly planId: string;
+    readonly planFingerprint: string;
+    readonly state: MigrationJournalStateV1;
+    readonly canonicalCommit: CanonicalCommitV1;
+    readonly recovery: MigrationRecoveryStateRecordV1;
+    readonly adapterReconciliations: readonly AdapterReconcileJournalV1[];
+    readonly events: readonly MigrationJournalEventV1[];
+}
+export declare const migrationPlanV1Schema: import("./validation.js").PactileContractSchemaV1<MigrationPlanV1>;
+export declare const migrationJournalV1Schema: import("./validation.js").PactileContractSchemaV1<MigrationJournalV1>;
+export declare function parseMigrationPlanV1(input: unknown): PactileContractParseResultV1<MigrationPlanV1>;
+export declare function parseMigrationJournalV1(input: unknown): PactileContractParseResultV1<MigrationJournalV1>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/core/pactile/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/core/pactile/lifecycle.ts"],"names":[],"mappings":"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"}