clawsql 0.1.0

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

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

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

@@ -0,0 +1,75 @@
+/**
+ * ClawSQL - Operation Runner
+ *
+ * Base runner for failover operations.
+ * Implements the Template Method Pattern for operation execution.
+ */
+import { MySQLCluster, FailoverOperation } from '../../types/index.js';
+import { FailoverHook } from './types.js';
+import { InstancePromoter } from './promoter.js';
+import { ProxySQLManager } from '../routing/proxysql-manager.js';
+/**
+ * Operation Runner
+ * Executes the common flow for failover operations.
+ */
+export declare class OperationRunner {
+    private promoter;
+    private proxysql;
+    private preHooks;
+    private postHooks;
+    constructor(promoter: InstancePromoter, proxysql: ProxySQLManager);
+    /**
+     * Register a pre-execution hook
+     */
+    registerPreHook(hook: FailoverHook): void;
+    /**
+     * Register a post-execution hook
+     */
+    registerPostHook(hook: FailoverHook): void;
+    /**
+     * Execute the operation
+     * Template method that defines the skeleton of the operation.
+     */
+    execute(operation: FailoverOperation, cluster: MySQLCluster, isSwitchover: boolean): Promise<FailoverOperation>;
+    /**
+     * Create a step logging function
+     */
+    private createStepLogger;
+    /**
+     * Run pre-execution hooks
+     */
+    private runPreHooks;
+    /**
+     * Select candidate for promotion
+     */
+    private selectCandidate;
+    /**
+     * Promote the instance
+     */
+    private promoteInstance;
+    /**
+     * Reconfigure replicas to follow new primary
+     */
+    private reconfigureReplicas;
+    /**
+     * Update routing rules
+     */
+    private updateRouting;
+    /**
+     * Run post-execution hooks
+     */
+    private runPostHooks;
+    /**
+     * Handle operation failure
+     */
+    private handleFailure;
+    /**
+     * Get promotion message
+     */
+    private getPromotionMessage;
+    /**
+     * Get success message
+     */
+    private getSuccessMessage;
+}
+//# sourceMappingURL=operation-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operation-runner.d.ts","sourceRoot":"","sources":["../../../src/core/failover/operation-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAiB,iBAAiB,EAAiB,MAAM,sBAAsB,CAAC;AAErG,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AASjE;;;GAGG;AACH,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;IALlB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,SAAS,CAAsB;gBAG7B,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,eAAe;IAGnC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIzC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAI1C;;;OAGG;IACG,OAAO,CACX,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,YAAY,EACrB,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,iBAAiB,CAAC;IAwC7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;YACW,WAAW;IAWzB;;OAEG;YACW,eAAe;IA2B7B;;OAEG;YACW,eAAe;IAqB7B;;OAEG;YACW,mBAAmB;IAsBjC;;OAEG;YACW,aAAa;IAe3B;;OAEG;YACW,YAAY;IAa1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAG1B"}

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

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * ClawSQL - Operation Runner
+ *
+ * Base runner for failover operations.
+ * Implements the Template Method Pattern for operation execution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationRunner = void 0;
+const logger_js_1 = require("../../utils/logger.js");
+const index_js_1 = require("../../types/index.js");
+const exceptions_js_1 = require("../../utils/exceptions.js");
+const candidate_selector_js_1 = require("./candidate-selector.js");
+const proxysql_manager_js_1 = require("../routing/proxysql-manager.js");
+const logger = (0, logger_js_1.getLogger)('failover');
+/**
+ * Operation Runner
+ * Executes the common flow for failover operations.
+ */
+class OperationRunner {
+    promoter;
+    proxysql;
+    preHooks = [];
+    postHooks = [];
+    constructor(promoter, proxysql) {
+        this.promoter = promoter;
+        this.proxysql = proxysql;
+    }
+    /**
+     * Register a pre-execution hook
+     */
+    registerPreHook(hook) {
+        this.preHooks.push(hook);
+    }
+    /**
+     * Register a post-execution hook
+     */
+    registerPostHook(hook) {
+        this.postHooks.push(hook);
+    }
+    /**
+     * Execute the operation
+     * Template method that defines the skeleton of the operation.
+     */
+    async execute(operation, cluster, isSwitchover) {
+        const addStep = this.createStepLogger(operation);
+        operation.startedAt = new Date();
+        operation.state = index_js_1.FailoverState.DETECTING;
+        try {
+            // 1. Pre-execution hooks
+            await this.runPreHooks(operation, cluster, addStep);
+            // 2. Select candidate
+            const newPrimary = await this.selectCandidate(operation, cluster, addStep);
+            // 3. Promote instance
+            await this.promoteInstance(operation, cluster, newPrimary, isSwitchover, addStep);
+            // 4. Reconfigure replicas
+            await this.reconfigureReplicas(operation, cluster, newPrimary, addStep);
+            // 5. Update routing
+            await this.updateRouting(operation, cluster, newPrimary, addStep);
+            // Success
+            operation.state = index_js_1.FailoverState.COMPLETED;
+            operation.completedAt = new Date();
+            addStep(this.getSuccessMessage(isSwitchover));
+            logger.info({ operationId: operation.operationId, clusterId: cluster.clusterId }, this.getSuccessMessage(isSwitchover));
+        }
+        catch (error) {
+            this.handleFailure(operation, error, addStep, isSwitchover);
+        }
+        finally {
+            await this.runPostHooks(operation, cluster);
+        }
+        return operation;
+    }
+    /**
+     * Create a step logging function
+     */
+    createStepLogger(operation) {
+        return (step) => {
+            const timestamp = new Date().toISOString();
+            operation.steps.push(`[${timestamp}] ${step}`);
+        };
+    }
+    /**
+     * Run pre-execution hooks
+     */
+    async runPreHooks(operation, cluster, addStep) {
+        addStep('Running pre-execution hooks');
+        for (const hook of this.preHooks) {
+            await hook(operation, cluster);
+        }
+    }
+    /**
+     * Select candidate for promotion
+     */
+    async selectCandidate(operation, cluster, addStep) {
+        operation.state = index_js_1.FailoverState.CANDIDATE_SELECTION;
+        addStep('Selecting candidate for promotion');
+        // Auto-select if not specified
+        if (!operation.newPrimaryId) {
+            const selector = new candidate_selector_js_1.CandidateSelector();
+            const candidate = selector.select(cluster);
+            if (!candidate) {
+                throw new exceptions_js_1.FailoverError('No suitable candidate found for promotion');
+            }
+            operation.newPrimaryId = candidate_selector_js_1.CandidateSelector.getInstanceId(candidate);
+        }
+        // Find the instance
+        const newPrimary = candidate_selector_js_1.CandidateSelector.findReplica(cluster, operation.newPrimaryId);
+        if (!newPrimary) {
+            throw new exceptions_js_1.FailoverError(`Candidate ${operation.newPrimaryId} not found`);
+        }
+        return newPrimary;
+    }
+    /**
+     * Promote the instance
+     */
+    async promoteInstance(operation, cluster, newPrimary, isSwitchover, addStep) {
+        operation.state = index_js_1.FailoverState.PROMOTING;
+        addStep(this.getPromotionMessage(operation.newPrimaryId, isSwitchover));
+        const result = await this.promoter.promote(newPrimary, cluster, isSwitchover);
+        if (!result.success) {
+            throw new exceptions_js_1.FailoverError(result.error || 'Promotion failed');
+        }
+        if (isSwitchover) {
+            addStep('Started replication on demoted primary');
+        }
+    }
+    /**
+     * Reconfigure replicas to follow new primary
+     */
+    async reconfigureReplicas(operation, cluster, newPrimary, addStep) {
+        operation.state = index_js_1.FailoverState.RECONFIGURING;
+        addStep('Reconfiguring replicas');
+        const otherReplicas = cluster.replicas.filter(r => `${r.host}:${r.port}` !== operation.newPrimaryId);
+        for (const replica of otherReplicas) {
+            try {
+                await this.proxysql.relocateReplica(replica, newPrimary);
+            }
+            catch (error) {
+                logger.warn({ error, replica: `${replica.host}:${replica.port}` }, 'Failed to reconfigure replica');
+            }
+        }
+    }
+    /**
+     * Update routing rules
+     */
+    async updateRouting(_operation, cluster, newPrimary, addStep) {
+        addStep('Updating routing rules');
+        await this.proxysql.syncCluster({ ...cluster, primary: newPrimary }, proxysql_manager_js_1.ProxySQLManager.DEFAULT_WRITER_HOSTGROUP, proxysql_manager_js_1.ProxySQLManager.DEFAULT_READER_HOSTGROUP);
+    }
+    /**
+     * Run post-execution hooks
+     */
+    async runPostHooks(operation, cluster) {
+        for (const hook of this.postHooks) {
+            try {
+                await hook(operation, cluster);
+            }
+            catch (error) {
+                logger.error({ error }, 'Post-execution hook error');
+            }
+        }
+    }
+    /**
+     * Handle operation failure
+     */
+    handleFailure(operation, error, addStep, isSwitchover) {
+        operation.state = index_js_1.FailoverState.FAILED;
+        operation.error = error instanceof Error ? error.message : String(error);
+        operation.completedAt = new Date();
+        const operationType = isSwitchover ? 'Switchover' : 'Failover';
+        addStep(`${operationType} failed: ${operation.error}`);
+        logger.error({ error, operationId: operation.operationId }, `${operationType} failed`);
+    }
+    /**
+     * Get promotion message
+     */
+    getPromotionMessage(targetId, isSwitchover) {
+        return isSwitchover
+            ? `Switching over to ${targetId}`
+            : `Promoting ${targetId} to primary (failover)`;
+    }
+    /**
+     * Get success message
+     */
+    getSuccessMessage(isSwitchover) {
+        return isSwitchover ? 'Switchover completed successfully' : 'Failover completed successfully';
+    }
+}
+exports.OperationRunner = OperationRunner;
+//# sourceMappingURL=operation-runner.js.map

package/dist/core/failover/operation-runner.js.map

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

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

@@ -0,0 +1,33 @@
+/**
+ * ClawSQL - Instance Promoter
+ *
+ * Handles the promotion of instances to primary role.
+ * Coordinates with Orchestrator for the actual promotion.
+ */
+import { MySQLCluster, MySQLInstance } from '../../types/index.js';
+import { OrchestratorClient } from '../discovery/topology.js';
+import { PromotionResult } from './types.js';
+/**
+ * Instance Promoter
+ * Handles promotion logic and post-promotion tasks.
+ */
+export declare class InstancePromoter {
+    private orchestrator;
+    constructor(orchestrator: OrchestratorClient);
+    /**
+     * Promote an instance to primary
+     * @param instance - The instance to promote
+     * @param cluster - The cluster context
+     * @param isSwitchover - True for switchover (primary healthy), false for failover
+     */
+    promote(instance: MySQLInstance, cluster: MySQLCluster, isSwitchover: boolean): Promise<PromotionResult>;
+    /**
+     * Execute the promotion via Orchestrator
+     */
+    private executePromotion;
+    /**
+     * Start replication on the demoted primary
+     */
+    private startReplicationOnDemotedPrimary;
+}
+//# sourceMappingURL=promoter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promoter.d.ts","sourceRoot":"","sources":["../../../src/core/failover/promoter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA2B7C;;;GAGG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,YAAY;gBAAZ,YAAY,EAAE,kBAAkB;IAEpD;;;;;OAKG;IACG,OAAO,CACX,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,YAAY,EACrB,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,eAAe,CAAC;IA0B3B;;OAEG;YACW,gBAAgB;IAqB9B;;OAEG;YACW,gCAAgC;CAgB/C"}

package/dist/core/failover/promoter.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * ClawSQL - Instance Promoter
+ *
+ * Handles the promotion of instances to primary role.
+ * Coordinates with Orchestrator for the actual promotion.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstancePromoter = void 0;
+const logger_js_1 = require("../../utils/logger.js");
+const mysql_client_js_1 = require("../../utils/mysql-client.js");
+const logger = (0, logger_js_1.getLogger)('failover');
+/**
+ * Orchestrator response success indicators
+ */
+const SUCCESS_INDICATORS = ['Code', 'IsSuccessful', 'Success'];
+/**
+ * Check if Orchestrator response indicates success
+ */
+function isSuccessfulResponse(result) {
+    if (!result)
+        return false;
+    return SUCCESS_INDICATORS.some(key => result[key] === 'OK' || result[key] === true);
+}
+/**
+ * Extract error message from Orchestrator response
+ */
+function extractError(result) {
+    if (!result)
+        return 'Unknown error';
+    return result.Message || result.Error || JSON.stringify(result);
+}
+/**
+ * Instance Promoter
+ * Handles promotion logic and post-promotion tasks.
+ */
+class InstancePromoter {
+    orchestrator;
+    constructor(orchestrator) {
+        this.orchestrator = orchestrator;
+    }
+    /**
+     * Promote an instance to primary
+     * @param instance - The instance to promote
+     * @param cluster - The cluster context
+     * @param isSwitchover - True for switchover (primary healthy), false for failover
+     */
+    async promote(instance, cluster, isSwitchover) {
+        const clusterAlias = cluster.clusterId;
+        const oldPrimary = cluster.primary;
+        try {
+            const result = await this.executePromotion(instance, clusterAlias, isSwitchover);
+            if (!isSuccessfulResponse(result)) {
+                const errorMsg = extractError(result);
+                logger.error({ cluster: clusterAlias, result }, 'Promotion returned failure');
+                return { success: false, error: errorMsg };
+            }
+            // For switchover, start replication on the old primary
+            if (isSwitchover && oldPrimary) {
+                await this.startReplicationOnDemotedPrimary(oldPrimary);
+            }
+            return { success: true };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger.error({ error, instance: `${instance.host}:${instance.port}` }, 'Promotion failed');
+            return { success: false, error: errorMsg };
+        }
+    }
+    /**
+     * Execute the promotion via Orchestrator
+     */
+    async executePromotion(instance, clusterAlias, isSwitchover) {
+        if (isSwitchover) {
+            logger.info({ cluster: clusterAlias, target: `${instance.host}:${instance.port}` }, 'Performing graceful master takeover');
+            return this.orchestrator.gracefulMasterTakeover(clusterAlias, instance.host, instance.port);
+        }
+        else {
+            logger.info({ cluster: clusterAlias }, 'Performing force master failover');
+            return this.orchestrator.forceMasterFailover(clusterAlias);
+        }
+    }
+    /**
+     * Start replication on the demoted primary
+     */
+    async startReplicationOnDemotedPrimary(oldPrimary) {
+        const instanceId = `${oldPrimary.host}:${oldPrimary.port}`;
+        logger.info({ oldPrimary: instanceId }, 'Starting replication on demoted primary');
+        const mysqlClient = (0, mysql_client_js_1.getMySQLClient)();
+        const started = await mysqlClient.startReplication(oldPrimary.host, oldPrimary.port);
+        if (!started) {
+            logger.warn({ oldPrimary: instanceId }, 'Failed to start replication on demoted primary - manual intervention may be needed');
+        }
+    }
+}
+exports.InstancePromoter = InstancePromoter;
+//# sourceMappingURL=promoter.js.map

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

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

package/dist/core/failover/recovery-manager.d.ts

@@ -0,0 +1,47 @@
+/**
+ * ClawSQL - Recovery Manager
+ *
+ * Manages the recovery of instances after failover.
+ * Tracks instances that need recovery and handles the recovery process.
+ */
+import { OrchestratorClient } from '../discovery/topology.js';
+import { PendingRecovery, RecoveryResult, BatchRecoveryResult } from './types.js';
+/**
+ * Recovery Manager
+ * Handles tracking and recovery of instances after failover.
+ */
+export declare class RecoveryManager {
+    private orchestrator;
+    private pendingRecoveries;
+    constructor(orchestrator: OrchestratorClient);
+    /**
+     * Queue an instance for recovery
+     */
+    queueForRecovery(recovery: PendingRecovery): void;
+    /**
+     * Get all pending recoveries
+     */
+    getPending(): PendingRecovery[];
+    /**
+     * Check if an instance is pending recovery
+     */
+    isPending(instanceId: string): boolean;
+    /**
+     * Clear a pending recovery
+     */
+    clear(instanceId: string): boolean;
+    /**
+     * Recover a specific instance
+     */
+    recover(instanceId: string): Promise<RecoveryResult>;
+    /**
+     * Recover all pending instances
+     */
+    recoverAll(): Promise<BatchRecoveryResult>;
+    /**
+     * Create a pending recovery record
+     */
+    static createPendingRecovery(clusterId: string, host: string, port: number, newPrimaryId: string): PendingRecovery;
+    private delay;
+}
+//# sourceMappingURL=recovery-manager.d.ts.map

package/dist/core/failover/recovery-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-manager.d.ts","sourceRoot":"","sources":["../../../src/core/failover/recovery-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIlF;;;GAGG;AACH,qBAAa,eAAe;IAGd,OAAO,CAAC,YAAY;IAFhC,OAAO,CAAC,iBAAiB,CAA2C;gBAEhD,YAAY,EAAE,kBAAkB;IAEpD;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAQjD;;OAEG;IACH,UAAU,IAAI,eAAe,EAAE;IAI/B;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA6D1D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,mBAAmB,CAAC;IA0BhD;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,eAAe;IAWlB,OAAO,CAAC,KAAK;CAGd"}

package/dist/core/failover/recovery-manager.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * ClawSQL - Recovery Manager
+ *
+ * Manages the recovery of instances after failover.
+ * Tracks instances that need recovery and handles the recovery process.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecoveryManager = void 0;
+const logger_js_1 = require("../../utils/logger.js");
+const index_js_1 = require("../../types/index.js");
+const mysql_client_js_1 = require("../../utils/mysql-client.js");
+const logger = (0, logger_js_1.getLogger)('failover');
+/**
+ * Recovery Manager
+ * Handles tracking and recovery of instances after failover.
+ */
+class RecoveryManager {
+    orchestrator;
+    pendingRecoveries = new Map();
+    constructor(orchestrator) {
+        this.orchestrator = orchestrator;
+    }
+    /**
+     * Queue an instance for recovery
+     */
+    queueForRecovery(recovery) {
+        this.pendingRecoveries.set(recovery.instanceId, recovery);
+        logger.info({ instanceId: recovery.instanceId, newPrimaryId: recovery.newPrimaryId }, 'Instance queued for recovery');
+    }
+    /**
+     * Get all pending recoveries
+     */
+    getPending() {
+        return Array.from(this.pendingRecoveries.values());
+    }
+    /**
+     * Check if an instance is pending recovery
+     */
+    isPending(instanceId) {
+        return this.pendingRecoveries.has(instanceId);
+    }
+    /**
+     * Clear a pending recovery
+     */
+    clear(instanceId) {
+        return this.pendingRecoveries.delete(instanceId);
+    }
+    /**
+     * Recover a specific instance
+     */
+    async recover(instanceId) {
+        const pending = this.pendingRecoveries.get(instanceId);
+        if (!pending) {
+            return { success: false, message: `Instance ${instanceId} is not pending recovery` };
+        }
+        try {
+            logger.info({ instanceId, newPrimaryId: pending.newPrimaryId }, 'Attempting to recover instance');
+            // Verify instance is online
+            const instance = await this.orchestrator.getInstance(pending.host, pending.port);
+            if (!instance) {
+                return { success: false, message: `Instance ${instanceId} not found in Orchestrator` };
+            }
+            if (instance.state !== index_js_1.InstanceState.ONLINE) {
+                return {
+                    success: false,
+                    message: `Instance ${instanceId} is not online (state: ${instance.state})`
+                };
+            }
+            // Start replication
+            const mysqlClient = (0, mysql_client_js_1.getMySQLClient)();
+            const started = await mysqlClient.startReplication(pending.host, pending.port);
+            if (!started) {
+                return { success: false, message: `Failed to start replication on ${instanceId}` };
+            }
+            // Verify replication is running
+            await this.delay(2000);
+            const status = await mysqlClient.getReplicationStatus(pending.host, pending.port);
+            if (!status || !status.ioRunning || !status.sqlRunning) {
+                const ioStatus = status?.ioRunning ? 'running' : 'stopped';
+                const sqlStatus = status?.sqlRunning ? 'running' : 'stopped';
+                return {
+                    success: false,
+                    message: `Replication not fully running on ${instanceId}: IO=${ioStatus}, SQL=${sqlStatus}`
+                };
+            }
+            // Mark as recovered
+            pending.recoveredAt = new Date();
+            this.pendingRecoveries.delete(instanceId);
+            logger.info({ instanceId, newPrimaryId: pending.newPrimaryId }, 'Instance recovered successfully');
+            return {
+                success: true,
+                message: `Instance ${instanceId} recovered and replicating from ${pending.newPrimaryId}`
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error({ error, instanceId }, 'Recovery failed');
+            return { success: false, message: `Recovery failed: ${message}` };
+        }
+    }
+    /**
+     * Recover all pending instances
+     */
+    async recoverAll() {
+        const result = {
+            recovered: [],
+            stillPending: [],
+            errors: []
+        };
+        for (const [instanceId] of this.pendingRecoveries) {
+            const recoveryResult = await this.recover(instanceId);
+            if (recoveryResult.success) {
+                result.recovered.push(instanceId);
+            }
+            else if (recoveryResult.message.includes('not online') ||
+                recoveryResult.message.includes('not found')) {
+                result.stillPending.push(instanceId);
+            }
+            else {
+                result.errors.push(`${instanceId}: ${recoveryResult.message}`);
+                result.stillPending.push(instanceId);
+            }
+        }
+        return result;
+    }
+    /**
+     * Create a pending recovery record
+     */
+    static createPendingRecovery(clusterId, host, port, newPrimaryId) {
+        return {
+            clusterId,
+            instanceId: `${host}:${port}`,
+            host,
+            port,
+            newPrimaryId,
+            failedAt: new Date()
+        };
+    }
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+exports.RecoveryManager = RecoveryManager;
+//# sourceMappingURL=recovery-manager.js.map

package/dist/core/failover/recovery-manager.js.map

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