clawsql 0.1.0

package/dist/core/failover/candidate-selector.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * ClawSQL - Candidate Selector
+ *
+ * Selects the best candidate for promotion during failover.
+ * Implements the Strategy Pattern for different selection strategies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.candidateSelector = exports.CandidateSelector = exports.LowestLagStrategy = void 0;
+const index_js_1 = require("../../types/index.js");
+/**
+ * Default selection strategy
+ * Selects the replica with lowest replication lag among healthy instances.
+ */
+class LowestLagStrategy {
+    select(replicas) {
+        const healthyReplicas = replicas.filter(r => this.isHealthy(r));
+        if (healthyReplicas.length === 0) {
+            return null;
+        }
+        // Sort by replication lag (prefer lowest)
+        const sorted = [...healthyReplicas].sort((a, b) => {
+            const lagA = a.replicationLag ?? Infinity;
+            const lagB = b.replicationLag ?? Infinity;
+            return lagA - lagB;
+        });
+        return sorted[0];
+    }
+    isHealthy(instance) {
+        return instance.state === index_js_1.InstanceState.ONLINE;
+    }
+}
+exports.LowestLagStrategy = LowestLagStrategy;
+/**
+ * Candidate Selector
+ * Handles the selection of the best replica to promote.
+ */
+class CandidateSelector {
+    strategy;
+    constructor(strategy) {
+        this.strategy = strategy || new LowestLagStrategy();
+    }
+    /**
+     * Select the best candidate from cluster replicas
+     */
+    select(cluster) {
+        if (!cluster.replicas.length) {
+            return null;
+        }
+        return this.strategy.select(cluster.replicas);
+    }
+    /**
+     * Find a specific replica by ID
+     */
+    static findReplica(cluster, targetId) {
+        return cluster.replicas.find(r => `${r.host}:${r.port}` === targetId || r.host === targetId);
+    }
+    /**
+     * Get instance ID string
+     */
+    static getInstanceId(instance) {
+        return `${instance.host}:${instance.port}`;
+    }
+}
+exports.CandidateSelector = CandidateSelector;
+/**
+ * Default selector instance
+ */
+exports.candidateSelector = new CandidateSelector();
+//# sourceMappingURL=candidate-selector.js.map

package/dist/core/failover/candidate-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-selector.js","sourceRoot":"","sources":["../../../src/core/failover/candidate-selector.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mDAAkF;AASlF;;;GAGG;AACH,MAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAyB;QAC9B,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CACrC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CACvB,CAAC;QAEF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,0CAA0C;QAC1C,MAAM,MAAM,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAChD,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,IAAI,QAAQ,CAAC;YAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,IAAI,QAAQ,CAAC;YAC1C,OAAO,IAAI,GAAG,IAAI,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAEO,SAAS,CAAC,QAAuB;QACvC,OAAO,QAAQ,CAAC,KAAK,KAAK,wBAAa,CAAC,MAAM,CAAC;IACjD,CAAC;CACF;AAvBD,8CAuBC;AAED;;;GAGG;AACH,MAAa,iBAAiB;IACpB,QAAQ,CAAoB;IAEpC,YAAY,QAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,iBAAiB,EAAE,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAqB;QAC1B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAqB,EAAE,QAAgB;QACxD,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAC1B,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAC/D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAuB;QAC1C,OAAO,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;CACF;AAhCD,8CAgCC;AAED;;GAEG;AACU,QAAA,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/core/failover/executor.d.ts

@@ -0,0 +1,104 @@
+/**
+ * ClawSQL - Failover Executor
+ *
+ * Main orchestrator for failover operations.
+ * Coordinates switchover, failover, and recovery operations.
+ *
+ * Terminology:
+ * - Switchover: Planned operation when primary is healthy. Promotes a replica and fixes replication.
+ * - Failover: Emergency operation when primary is down. Promotes a replica automatically.
+ * - Manual Failover: User-initiated when primary is down. User selects which replica to promote.
+ */
+import { MySQLCluster, FailoverOperation, FailureEvent } from '../../types/index.js';
+import { OrchestratorClient } from '../discovery/topology.js';
+import { ProxySQLManager } from '../routing/proxysql-manager.js';
+import { FailoverHook, PendingRecovery, RecoveryResult, BatchRecoveryResult } from './types.js';
+/**
+ * Failover Executor
+ * Main entry point for all failover operations.
+ */
+export declare class FailoverExecutor {
+    private orchestrator;
+    private proxysql;
+    private promoter;
+    private recoveryManager;
+    private operationRunner;
+    private currentOperation;
+    private operationHistory;
+    static readonly MAX_FAILOVER_TIME = 30;
+    constructor(orchestrator?: OrchestratorClient, proxysql?: ProxySQLManager);
+    /**
+     * Register a pre-failover hook
+     */
+    registerPreFailoverHook(hook: FailoverHook): void;
+    /**
+     * Register a post-failover hook
+     */
+    registerPostFailoverHook(hook: FailoverHook): void;
+    /**
+     * Execute automatic failover
+     */
+    executeAutomaticFailover(failureEvent: FailureEvent, cluster: MySQLCluster): Promise<FailoverOperation>;
+    /**
+     * Execute switchover (planned, primary is healthy)
+     * Promotes a replica to primary and starts replication on the old primary.
+     */
+    executeSwitchover(cluster: MySQLCluster, targetPrimaryId?: string, reason?: string): Promise<FailoverOperation>;
+    /**
+     * Execute manual failover (primary is down, user selects replica)
+     */
+    executeManualFailover(cluster: MySQLCluster, targetPrimaryId?: string, reason?: string): Promise<FailoverOperation>;
+    /**
+     * Get all pending recoveries
+     */
+    getPendingRecoveries(): PendingRecovery[];
+    /**
+     * Check if an instance is pending recovery
+     */
+    isPendingRecovery(instanceId: string): boolean;
+    /**
+     * Recover an old primary instance
+     */
+    recoverInstance(instanceId: string): Promise<RecoveryResult>;
+    /**
+     * Check all pending recoveries and recover instances that are back online
+     */
+    checkAndRecoverAll(): Promise<BatchRecoveryResult>;
+    /**
+     * Clear a pending recovery (manual override)
+     */
+    clearPendingRecovery(instanceId: string): boolean;
+    /**
+     * Get current operation
+     */
+    getCurrentOperation(): FailoverOperation | null;
+    /**
+     * Get operation history
+     */
+    getOperationHistory(clusterId?: string, limit?: number): FailoverOperation[];
+    /**
+     * Get operation by ID
+     */
+    getOperation(operationId: string): FailoverOperation | undefined;
+    /**
+     * Cancel an in-progress operation
+     */
+    cancelOperation(operationId: string): Promise<boolean>;
+    /**
+     * Record an operation to history
+     */
+    private recordOperation;
+    /**
+     * Execute switchover operation
+     */
+    private executeSwitchoverOperation;
+    /**
+     * Execute failover operation
+     */
+    private executeFailoverOperation;
+}
+/**
+ * Get the Failover executor instance
+ */
+export declare function getFailoverExecutor(): FailoverExecutor;
+//# sourceMappingURL=executor.d.ts.map

package/dist/core/failover/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/core/failover/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAiB,YAAY,EAAY,MAAM,sBAAsB,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAyB,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,eAAe,EAAsB,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAOhG;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAkB;IAEzC,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,gBAAgB,CAA2B;IAEnD,MAAM,CAAC,QAAQ,CAAC,iBAAiB,MAAM;gBAGrC,YAAY,CAAC,EAAE,kBAAkB,EACjC,QAAQ,CAAC,EAAE,eAAe;IAa5B;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIjD;;OAEG;IACH,wBAAwB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAQlD;;OAEG;IACG,wBAAwB,CAC5B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,iBAAiB,CAAC;IAS7B;;;OAGG;IACG,iBAAiB,CACrB,OAAO,EAAE,YAAY,EACrB,eAAe,CAAC,EAAE,MAAM,EACxB,MAAM,GAAE,MAAW,GAClB,OAAO,CAAC,iBAAiB,CAAC;IA+B7B;;OAEG;IACG,qBAAqB,CACzB,OAAO,EAAE,YAAY,EACrB,eAAe,CAAC,EAAE,MAAM,EACxB,MAAM,GAAE,MAAW,GAClB,OAAO,CAAC,iBAAiB,CAAC;IAmC7B;;OAEG;IACH,oBAAoB,IAAI,eAAe,EAAE;IAIzC;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI9C;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIlE;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIxD;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAQjD;;OAEG;IACH,mBAAmB,IAAI,iBAAiB,GAAG,IAAI;IAI/C;;OAEG;IACH,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,iBAAiB,EAAE;IAUjF;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhE;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB5D;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;YACW,0BAA0B;IAexC;;OAEG;YACW,wBAAwB;CAgCvC;AAQD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD"}

package/dist/core/failover/executor.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * ClawSQL - Failover Executor
+ *
+ * Main orchestrator for failover operations.
+ * Coordinates switchover, failover, and recovery operations.
+ *
+ * Terminology:
+ * - Switchover: Planned operation when primary is healthy. Promotes a replica and fixes replication.
+ * - Failover: Emergency operation when primary is down. Promotes a replica automatically.
+ * - Manual Failover: User-initiated when primary is down. User selects which replica to promote.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FailoverExecutor = void 0;
+exports.getFailoverExecutor = getFailoverExecutor;
+const index_js_1 = require("../../types/index.js");
+const topology_js_1 = require("../discovery/topology.js");
+const proxysql_manager_js_1 = require("../routing/proxysql-manager.js");
+const operation_builder_js_1 = require("./operation-builder.js");
+const candidate_selector_js_1 = require("./candidate-selector.js");
+const promoter_js_1 = require("./promoter.js");
+const recovery_manager_js_1 = require("./recovery-manager.js");
+const operation_runner_js_1 = require("./operation-runner.js");
+/**
+ * Failover Executor
+ * Main entry point for all failover operations.
+ */
+class FailoverExecutor {
+    orchestrator;
+    proxysql;
+    promoter;
+    recoveryManager;
+    operationRunner;
+    currentOperation = null;
+    operationHistory = [];
+    static MAX_FAILOVER_TIME = 30; // seconds
+    constructor(orchestrator, proxysql) {
+        this.orchestrator = orchestrator || (0, topology_js_1.getOrchestratorClient)();
+        this.proxysql = proxysql || (0, proxysql_manager_js_1.getProxySQLManager)();
+        this.promoter = new promoter_js_1.InstancePromoter(this.orchestrator);
+        this.recoveryManager = new recovery_manager_js_1.RecoveryManager(this.orchestrator);
+        this.operationRunner = new operation_runner_js_1.OperationRunner(this.promoter, this.proxysql);
+    }
+    // =========================================================================
+    // Hook Registration
+    // =========================================================================
+    /**
+     * Register a pre-failover hook
+     */
+    registerPreFailoverHook(hook) {
+        this.operationRunner.registerPreHook(hook);
+    }
+    /**
+     * Register a post-failover hook
+     */
+    registerPostFailoverHook(hook) {
+        this.operationRunner.registerPostHook(hook);
+    }
+    // =========================================================================
+    // Public Operations
+    // =========================================================================
+    /**
+     * Execute automatic failover
+     */
+    async executeAutomaticFailover(failureEvent, cluster) {
+        const operation = operation_builder_js_1.OperationBuilder.create()
+            .forCluster(cluster)
+            .asAutomatic(failureEvent.eventId, `Automatic failover due to ${failureEvent.failureType}`)
+            .build();
+        return this.executeFailoverOperation(operation, cluster);
+    }
+    /**
+     * Execute switchover (planned, primary is healthy)
+     * Promotes a replica to primary and starts replication on the old primary.
+     */
+    async executeSwitchover(cluster, targetPrimaryId, reason = '') {
+        // Validate primary is healthy
+        if (!cluster.primary || !(0, index_js_1.isOnline)(cluster.primary)) {
+            return this.recordOperation((0, operation_builder_js_1.createFailedOperation)(cluster, 'Switchover requires a healthy primary. Use failover for unhealthy primary.', reason || 'Switchover requested'));
+        }
+        // Validate target if specified
+        if (targetPrimaryId) {
+            const targetReplica = candidate_selector_js_1.CandidateSelector.findReplica(cluster, targetPrimaryId);
+            if (!targetReplica) {
+                return this.recordOperation((0, operation_builder_js_1.createFailedOperation)(cluster, `Target '${targetPrimaryId}' not found in cluster replicas. ` +
+                    `Available: ${cluster.replicas.map(r => `${r.host}:${r.port}`).join(', ')}`, reason || 'Switchover requested'));
+            }
+        }
+        const operation = (0, operation_builder_js_1.createSwitchoverOperation)(cluster, targetPrimaryId, reason);
+        return this.executeSwitchoverOperation(operation, cluster);
+    }
+    /**
+     * Execute manual failover (primary is down, user selects replica)
+     */
+    async executeManualFailover(cluster, targetPrimaryId, reason = '') {
+        // Validate primary is NOT healthy
+        if (cluster.primary && (0, index_js_1.isOnline)(cluster.primary)) {
+            return this.recordOperation((0, operation_builder_js_1.createFailedOperation)(cluster, 'Primary is healthy. Use switchover for planned primary change.', reason || 'Manual failover requested'));
+        }
+        // Validate target if specified
+        if (targetPrimaryId) {
+            const targetReplica = candidate_selector_js_1.CandidateSelector.findReplica(cluster, targetPrimaryId);
+            if (!targetReplica) {
+                return this.recordOperation((0, operation_builder_js_1.createFailedOperation)(cluster, `Target '${targetPrimaryId}' not found in cluster replicas. ` +
+                    `Available: ${cluster.replicas.map(r => `${r.host}:${r.port}`).join(', ')}`, reason || 'Manual failover requested'));
+            }
+        }
+        const operation = (0, operation_builder_js_1.createFailoverOperation)(cluster, targetPrimaryId, reason);
+        return this.executeFailoverOperation(operation, cluster);
+    }
+    // =========================================================================
+    // Recovery Management
+    // =========================================================================
+    /**
+     * Get all pending recoveries
+     */
+    getPendingRecoveries() {
+        return this.recoveryManager.getPending();
+    }
+    /**
+     * Check if an instance is pending recovery
+     */
+    isPendingRecovery(instanceId) {
+        return this.recoveryManager.isPending(instanceId);
+    }
+    /**
+     * Recover an old primary instance
+     */
+    async recoverInstance(instanceId) {
+        return this.recoveryManager.recover(instanceId);
+    }
+    /**
+     * Check all pending recoveries and recover instances that are back online
+     */
+    async checkAndRecoverAll() {
+        return this.recoveryManager.recoverAll();
+    }
+    /**
+     * Clear a pending recovery (manual override)
+     */
+    clearPendingRecovery(instanceId) {
+        return this.recoveryManager.clear(instanceId);
+    }
+    // =========================================================================
+    // Operation History
+    // =========================================================================
+    /**
+     * Get current operation
+     */
+    getCurrentOperation() {
+        return this.currentOperation;
+    }
+    /**
+     * Get operation history
+     */
+    getOperationHistory(clusterId, limit = 100) {
+        let operations = [...this.operationHistory];
+        if (clusterId) {
+            operations = operations.filter(o => o.clusterId === clusterId);
+        }
+        return operations
+            .sort((a, b) => (a.startedAt?.getTime() || 0) - (b.startedAt?.getTime() || 0))
+            .slice(-limit);
+    }
+    /**
+     * Get operation by ID
+     */
+    getOperation(operationId) {
+        return this.operationHistory.find(o => o.operationId === operationId);
+    }
+    /**
+     * Cancel an in-progress operation
+     */
+    async cancelOperation(operationId) {
+        if (this.currentOperation?.operationId === operationId) {
+            this.currentOperation.state = index_js_1.FailoverState.FAILED;
+            this.currentOperation.error = 'Cancelled by user';
+            this.currentOperation.completedAt = new Date();
+            this.operationHistory.push(this.currentOperation);
+            this.currentOperation = null;
+            return true;
+        }
+        return false;
+    }
+    // =========================================================================
+    // Private Methods
+    // =========================================================================
+    /**
+     * Record an operation to history
+     */
+    recordOperation(operation) {
+        this.operationHistory.push(operation);
+        return operation;
+    }
+    /**
+     * Execute switchover operation
+     */
+    async executeSwitchoverOperation(operation, cluster) {
+        this.currentOperation = operation;
+        try {
+            const result = await this.operationRunner.execute(operation, cluster, true);
+            this.operationHistory.push(result);
+            return result;
+        }
+        finally {
+            this.currentOperation = null;
+        }
+    }
+    /**
+     * Execute failover operation
+     */
+    async executeFailoverOperation(operation, cluster) {
+        this.currentOperation = operation;
+        try {
+            const result = await this.operationRunner.execute(operation, cluster, false);
+            // Queue old primary for recovery on successful failover
+            if (result.state === index_js_1.FailoverState.COMPLETED && cluster.primary && result.newPrimaryId) {
+                const pendingRecovery = recovery_manager_js_1.RecoveryManager.createPendingRecovery(cluster.clusterId, cluster.primary.host, cluster.primary.port, result.newPrimaryId);
+                this.recoveryManager.queueForRecovery(pendingRecovery);
+                const addStep = (step) => {
+                    const timestamp = new Date().toISOString();
+                    result.steps.push(`[${timestamp}] ${step}`);
+                };
+                addStep(`Old primary ${pendingRecovery.instanceId} queued for recovery`);
+            }
+            this.operationHistory.push(result);
+            return result;
+        }
+        finally {
+            this.currentOperation = null;
+        }
+    }
+}
+exports.FailoverExecutor = FailoverExecutor;
+// =============================================================================
+// Singleton
+// =============================================================================
+let failoverExecutor = null;
+/**
+ * Get the Failover executor instance
+ */
+function getFailoverExecutor() {
+    if (!failoverExecutor) {
+        failoverExecutor = new FailoverExecutor();
+    }
+    return failoverExecutor;
+}
+//# sourceMappingURL=executor.js.map

package/dist/core/failover/executor.js.map

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

package/dist/core/failover/operation-builder.d.ts

@@ -0,0 +1,71 @@
+/**
+ * ClawSQL - Operation Builder
+ *
+ * Factory for creating failover operations.
+ * Uses the Factory Pattern to encapsulate operation creation logic.
+ */
+import { FailoverOperation, MySQLCluster, MySQLInstance } from '../../types/index.js';
+/**
+ * Operation Builder
+ * Provides a fluent interface for constructing failover operations.
+ */
+export declare class OperationBuilder {
+    private operation;
+    /**
+     * Start building a new operation
+     */
+    static create(): OperationBuilder;
+    /**
+     * Set the operation ID
+     */
+    withId(id?: string): this;
+    /**
+     * Set the cluster
+     */
+    forCluster(cluster: MySQLCluster): this;
+    /**
+     * Set as manual operation
+     */
+    asManual(reason: string): this;
+    /**
+     * Set as automatic operation
+     */
+    asAutomatic(triggeredBy: string, reason: string): this;
+    /**
+     * Set target primary
+     */
+    withTarget(instance: MySQLInstance): this;
+    /**
+     * Set target by ID
+     */
+    withTargetId(targetId: string): this;
+    /**
+     * Mark as failed with error
+     */
+    asFailed(error: string): this;
+    /**
+     * Initialize as idle (ready to execute)
+     */
+    asIdle(): this;
+    /**
+     * Build the operation
+     */
+    build(): FailoverOperation;
+}
+/**
+ * Create a failed operation immediately
+ */
+export declare function createFailedOperation(cluster: MySQLCluster, error: string, reason: string): FailoverOperation;
+/**
+ * Create a switchover operation
+ */
+export declare function createSwitchoverOperation(cluster: MySQLCluster, targetId: string | undefined, reason: string): FailoverOperation;
+/**
+ * Create a failover operation
+ */
+export declare function createFailoverOperation(cluster: MySQLCluster, targetId: string | undefined, reason: string): FailoverOperation;
+/**
+ * Create an automatic failover operation
+ */
+export declare function createAutomaticFailoverOperation(cluster: MySQLCluster, failureType: string, eventId: string): FailoverOperation;
+//# sourceMappingURL=operation-builder.d.ts.map

package/dist/core/failover/operation-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-builder.d.ts","sourceRoot":"","sources":["../../../src/core/failover/operation-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAiB,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErG;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAkC;IAEnD;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,gBAAgB;IAIjC;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAQvC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM9B;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAOtD;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAKzC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ7B;;OAEG;IACH,MAAM,IAAI,IAAI;IAMd;;OAEG;IACH,KAAK,IAAI,iBAAiB;CAY3B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,iBAAiB,CAMnB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,GACb,iBAAiB,CAWnB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,GACb,iBAAiB,CAWnB;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,iBAAiB,CAMnB"}

package/dist/core/failover/operation-builder.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * ClawSQL - Operation Builder
+ *
+ * Factory for creating failover operations.
+ * Uses the Factory Pattern to encapsulate operation creation logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationBuilder = void 0;
+exports.createFailedOperation = createFailedOperation;
+exports.createSwitchoverOperation = createSwitchoverOperation;
+exports.createFailoverOperation = createFailoverOperation;
+exports.createAutomaticFailoverOperation = createAutomaticFailoverOperation;
+const uuid_1 = require("uuid");
+const index_js_1 = require("../../types/index.js");
+/**
+ * Operation Builder
+ * Provides a fluent interface for constructing failover operations.
+ */
+class OperationBuilder {
+    operation = {};
+    /**
+     * Start building a new operation
+     */
+    static create() {
+        return new OperationBuilder();
+    }
+    /**
+     * Set the operation ID
+     */
+    withId(id) {
+        this.operation.operationId = id || (0, uuid_1.v4)();
+        return this;
+    }
+    /**
+     * Set the cluster
+     */
+    forCluster(cluster) {
+        this.operation.clusterId = cluster.clusterId;
+        this.operation.oldPrimaryId = cluster.primary
+            ? `${cluster.primary.host}:${cluster.primary.port}`
+            : '';
+        return this;
+    }
+    /**
+     * Set as manual operation
+     */
+    asManual(reason) {
+        this.operation.manual = true;
+        this.operation.reason = reason;
+        return this;
+    }
+    /**
+     * Set as automatic operation
+     */
+    asAutomatic(triggeredBy, reason) {
+        this.operation.manual = false;
+        this.operation.reason = reason;
+        this.operation.triggeredBy = triggeredBy;
+        return this;
+    }
+    /**
+     * Set target primary
+     */
+    withTarget(instance) {
+        this.operation.newPrimaryId = `${instance.host}:${instance.port}`;
+        return this;
+    }
+    /**
+     * Set target by ID
+     */
+    withTargetId(targetId) {
+        this.operation.newPrimaryId = targetId;
+        return this;
+    }
+    /**
+     * Mark as failed with error
+     */
+    asFailed(error) {
+        this.operation.state = index_js_1.FailoverState.FAILED;
+        this.operation.error = error;
+        this.operation.completedAt = new Date();
+        this.operation.steps = this.operation.steps || [];
+        return this;
+    }
+    /**
+     * Initialize as idle (ready to execute)
+     */
+    asIdle() {
+        this.operation.state = index_js_1.FailoverState.IDLE;
+        this.operation.steps = [];
+        return this;
+    }
+    /**
+     * Build the operation
+     */
+    build() {
+        if (!this.operation.operationId) {
+            this.operation.operationId = (0, uuid_1.v4)();
+        }
+        if (!this.operation.state) {
+            this.operation.state = index_js_1.FailoverState.IDLE;
+        }
+        if (!this.operation.steps) {
+            this.operation.steps = [];
+        }
+        return this.operation;
+    }
+}
+exports.OperationBuilder = OperationBuilder;
+/**
+ * Create a failed operation immediately
+ */
+function createFailedOperation(cluster, error, reason) {
+    return OperationBuilder.create()
+        .forCluster(cluster)
+        .asManual(reason)
+        .asFailed(error)
+        .build();
+}
+/**
+ * Create a switchover operation
+ */
+function createSwitchoverOperation(cluster, targetId, reason) {
+    const builder = OperationBuilder.create()
+        .forCluster(cluster)
+        .asManual(reason)
+        .asIdle();
+    if (targetId) {
+        builder.withTargetId(targetId);
+    }
+    return builder.build();
+}
+/**
+ * Create a failover operation
+ */
+function createFailoverOperation(cluster, targetId, reason) {
+    const builder = OperationBuilder.create()
+        .forCluster(cluster)
+        .asManual(reason)
+        .asIdle();
+    if (targetId) {
+        builder.withTargetId(targetId);
+    }
+    return builder.build();
+}
+/**
+ * Create an automatic failover operation
+ */
+function createAutomaticFailoverOperation(cluster, failureType, eventId) {
+    return OperationBuilder.create()
+        .forCluster(cluster)
+        .asAutomatic(eventId, `Automatic failover due to ${failureType}`)
+        .asIdle()
+        .build();
+}
+//# sourceMappingURL=operation-builder.js.map