clawsql 0.1.0

package/dist/core/sync/replica-recovery.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ClawSQL - Replica Recovery
+ *
+ * Handles automatic recovery of replica instances after failover.
+ * - Starts replication on demoted primary
+ * - Ends maintenance mode when appropriate
+ */
+import { MySQLInstance } from '../../types/index.js';
+import { OrchestratorClient } from '../discovery/topology.js';
+/**
+ * Result of a replica recovery attempt
+ */
+export interface RecoveryResult {
+    recovered: boolean;
+    reason: string;
+}
+/**
+ * Attempt to recover a replica instance
+ *
+ * This is called after failover/switchover when a replica is in maintenance
+ * or unhealthy state. It tries to:
+ * 1. Start replication on the replica
+ * 2. End maintenance mode if the replica is healthy
+ *
+ * @param replica The replica instance to recover
+ * @param newPrimary The new primary to follow
+ * @param orchestrator Orchestrator client for API calls
+ * @returns Recovery result indicating success or failure with reason
+ */
+export declare function recoverReplica(replica: MySQLInstance, newPrimary: MySQLInstance, orchestrator: OrchestratorClient): Promise<RecoveryResult>;
+/**
+ * Recover multiple replicas in parallel
+ *
+ * @param replicas List of replicas to attempt recovery
+ * @param newPrimary The new primary to follow
+ * @param orchestrator Orchestrator client
+ * @returns Map of instance ID to recovery result
+ */
+export declare function recoverReplicas(replicas: MySQLInstance[], newPrimary: MySQLInstance, orchestrator: OrchestratorClient): Promise<Map<string, RecoveryResult>>;
+//# sourceMappingURL=replica-recovery.d.ts.map

package/dist/core/sync/replica-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replica-recovery.d.ts","sourceRoot":"","sources":["../../../src/core/sync/replica-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAiB,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAK9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,aAAa,EACzB,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAAC,cAAc,CAAC,CAoGzB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EAAE,EACzB,UAAU,EAAE,aAAa,EACzB,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CA+BtC"}

package/dist/core/sync/replica-recovery.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * ClawSQL - Replica Recovery
+ *
+ * Handles automatic recovery of replica instances after failover.
+ * - Starts replication on demoted primary
+ * - Ends maintenance mode when appropriate
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recoverReplica = recoverReplica;
+exports.recoverReplicas = recoverReplicas;
+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)('sync');
+/**
+ * Attempt to recover a replica instance
+ *
+ * This is called after failover/switchover when a replica is in maintenance
+ * or unhealthy state. It tries to:
+ * 1. Start replication on the replica
+ * 2. End maintenance mode if the replica is healthy
+ *
+ * @param replica The replica instance to recover
+ * @param newPrimary The new primary to follow
+ * @param orchestrator Orchestrator client for API calls
+ * @returns Recovery result indicating success or failure with reason
+ */
+async function recoverReplica(replica, newPrimary, orchestrator) {
+    const instanceId = `${replica.host}:${replica.port}`;
+    // Skip if replica is offline - can't recover
+    if (replica.state === index_js_1.InstanceState.OFFLINE) {
+        return {
+            recovered: false,
+            reason: `Instance ${instanceId} is offline, cannot recover`,
+        };
+    }
+    // Check if replica is in maintenance state
+    const inMaintenance = replica.state === index_js_1.InstanceState.MAINTENANCE;
+    logger.info({ instanceId, state: replica.state, inMaintenance }, 'Attempting replica recovery');
+    try {
+        // Step 1: Check if MySQL is actually reachable
+        const mysqlClient = (0, mysql_client_js_1.getMySQLClient)();
+        const replicationStatus = await mysqlClient.getReplicationStatus(replica.host, replica.port);
+        // If we can get replication status, MySQL is reachable
+        const isReachable = replicationStatus !== null;
+        if (!isReachable) {
+            // MySQL might be reachable but not configured as replica
+            // Try to check connectivity differently
+            logger.debug({ instanceId }, 'Could not get replication status, checking connectivity');
+        }
+        // Step 2: Start replication via Orchestrator
+        logger.info({ instanceId }, 'Starting replication via Orchestrator');
+        const started = await orchestrator.startSlave(replica.host, replica.port);
+        if (!started) {
+            return {
+                recovered: false,
+                reason: `Failed to start replication on ${instanceId} via Orchestrator`,
+            };
+        }
+        // Wait briefly for replication to start
+        await new Promise(resolve => {
+            const timer = setTimeout(resolve, 1000);
+            timer.unref();
+        });
+        // Step 3: Verify replication is running
+        const status = await mysqlClient.getReplicationStatus(replica.host, replica.port);
+        if (!status) {
+            return {
+                recovered: false,
+                reason: `Could not verify replication status on ${instanceId}`,
+            };
+        }
+        if (!status.ioRunning || !status.sqlRunning) {
+            const ioStatus = status.ioRunning ? 'running' : 'stopped';
+            const sqlStatus = status.sqlRunning ? 'running' : 'stopped';
+            return {
+                recovered: false,
+                reason: `Replication not fully running on ${instanceId}: IO=${ioStatus}, SQL=${sqlStatus}`,
+            };
+        }
+        // Step 4: End maintenance mode if needed
+        if (inMaintenance) {
+            logger.info({ instanceId }, 'Ending maintenance mode via Orchestrator');
+            const endedMaintenance = await orchestrator.endMaintenance(replica.host, replica.port);
+            if (!endedMaintenance) {
+                logger.warn({ instanceId }, 'Replication started but failed to end maintenance mode');
+                // Still consider recovery successful if replication is running
+            }
+        }
+        logger.info({ instanceId, newPrimary: `${newPrimary.host}:${newPrimary.port}` }, 'Replica recovered successfully');
+        return {
+            recovered: true,
+            reason: `Instance ${instanceId} recovered: replication running, following ${newPrimary.host}:${newPrimary.port}`,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error({ error, instanceId }, 'Replica recovery failed');
+        return {
+            recovered: false,
+            reason: `Recovery failed for ${instanceId}: ${message}`,
+        };
+    }
+}
+/**
+ * Recover multiple replicas in parallel
+ *
+ * @param replicas List of replicas to attempt recovery
+ * @param newPrimary The new primary to follow
+ * @param orchestrator Orchestrator client
+ * @returns Map of instance ID to recovery result
+ */
+async function recoverReplicas(replicas, newPrimary, orchestrator) {
+    const results = new Map();
+    // Filter replicas that need recovery (maintenance or offline state)
+    const needsRecovery = replicas.filter(r => r.state === index_js_1.InstanceState.MAINTENANCE || r.state === index_js_1.InstanceState.OFFLINE);
+    if (needsRecovery.length === 0) {
+        logger.debug('No replicas need recovery');
+        return results;
+    }
+    logger.info({ count: needsRecovery.length, instances: needsRecovery.map(r => `${r.host}:${r.port}`) }, 'Attempting to recover replicas');
+    // Attempt recovery in parallel
+    const recoveryPromises = needsRecovery.map(async (replica) => {
+        const result = await recoverReplica(replica, newPrimary, orchestrator);
+        return { instanceId: `${replica.host}:${replica.port}`, result };
+    });
+    const recoveryResults = await Promise.all(recoveryPromises);
+    for (const { instanceId, result } of recoveryResults) {
+        results.set(instanceId, result);
+    }
+    return results;
+}
+//# sourceMappingURL=replica-recovery.js.map

package/dist/core/sync/replica-recovery.js.map

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

package/dist/core/sync/sync-coordinator.d.ts

@@ -0,0 +1,83 @@
+/**
+ * ClawSQL - Sync Coordinator
+ *
+ * Central coordinator for ProxySQL synchronization.
+ * Handles deduplication, rate limiting, and idempotent operations.
+ */
+import { MySQLCluster } from '../../types/index.js';
+import { SyncResult, SyncStats } from './types.js';
+/**
+ * Sync Coordinator
+ * Manages synchronization between Orchestrator topology and ProxySQL routing.
+ */
+export declare class SyncCoordinator {
+    private lastSyncTime;
+    private lastTopologyHash;
+    private locks;
+    private pendingDebounces;
+    private stats;
+    private readonly cooldownMs;
+    private readonly debounceMs;
+    private readonly maxRetries;
+    private readonly enabled;
+    private readonly writerHostgroup;
+    private readonly readerHostgroup;
+    constructor(options?: {
+        cooldownMs?: number;
+        debounceMs?: number;
+        maxRetries?: number;
+        enabled?: boolean;
+        writerHostgroup?: number;
+        readerHostgroup?: number;
+    });
+    /**
+     * Sync ProxySQL with the given cluster topology
+     * Uses lock and debounce mechanisms to prevent concurrent syncs
+     */
+    sync(cluster: MySQLCluster, source?: 'webhook' | 'poll' | 'manual', force?: boolean): Promise<SyncResult>;
+    /**
+     * Validate cluster input
+     */
+    private validateCluster;
+    /**
+     * Execute the actual sync with lock protection
+     */
+    private executeSync;
+    /**
+     * Perform the actual sync operation
+     */
+    private doSync;
+    /**
+     * Compute a hash of the cluster topology for change detection
+     */
+    private computeTopologyHash;
+    /**
+     * Get sync statistics
+     */
+    getStats(): SyncStats;
+    /**
+     * Reset cooldown for a specific cluster
+     */
+    resetCooldown(clusterId: string): void;
+    /**
+     * Clear all cached topology hashes
+     */
+    clearCache(): void;
+    /**
+     * Get the last sync time for a cluster
+     */
+    getLastSyncTime(clusterId: string): Date | null;
+    /**
+     * Check if a cluster is within cooldown period
+     */
+    isInCooldown(clusterId: string): boolean;
+}
+/**
+ * Get the sync coordinator instance
+ */
+export declare function getSyncCoordinator(): SyncCoordinator;
+/**
+ * Reset the sync coordinator (for testing)
+ */
+export declare function resetSyncCoordinator(): void;
+//# sourceMappingURL=sync-coordinator.d.ts.map

package/dist/core/sync/sync-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-coordinator.d.ts","sourceRoot":"","sources":["../../../src/core/sync/sync-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAKnD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,gBAAgB,CAA0C;IAClE,OAAO,CAAC,KAAK,CAKX;IAEF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,OAAO,CAAC,EAAE;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B;IASD;;;OAGG;IACG,IAAI,CACR,OAAO,EAAE,YAAY,EACrB,MAAM,GAAE,SAAS,GAAG,MAAM,GAAG,QAAmB,EAChD,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,UAAU,CAAC;IAsCtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;YACW,WAAW;IAuBzB;;OAEG;YACW,MAAM;IA6FpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,QAAQ,IAAI,SAAS;IAIrB;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAK/C;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAKzC;AAKD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAWpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/core/sync/sync-coordinator.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * ClawSQL - Sync Coordinator
+ *
+ * Central coordinator for ProxySQL synchronization.
+ * Handles deduplication, rate limiting, and idempotent operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncCoordinator = void 0;
+exports.getSyncCoordinator = getSyncCoordinator;
+exports.resetSyncCoordinator = resetSyncCoordinator;
+const logger_js_1 = require("../../utils/logger.js");
+const proxysql_manager_js_1 = require("../routing/proxysql-manager.js");
+const settings_js_1 = require("../../config/settings.js");
+const logger = (0, logger_js_1.getLogger)('sync');
+/**
+ * Sync Coordinator
+ * Manages synchronization between Orchestrator topology and ProxySQL routing.
+ */
+class SyncCoordinator {
+    lastSyncTime = new Map();
+    lastTopologyHash = new Map();
+    locks = new Map();
+    pendingDebounces = new Map();
+    stats = {
+        totalSyncs: 0,
+        successfulSyncs: 0,
+        failedSyncs: 0,
+        skippedSyncs: 0,
+    };
+    cooldownMs;
+    debounceMs;
+    maxRetries;
+    enabled;
+    writerHostgroup;
+    readerHostgroup;
+    constructor(options) {
+        this.cooldownMs = options?.cooldownMs ?? 5000;
+        this.debounceMs = options?.debounceMs ?? 1000;
+        this.maxRetries = options?.maxRetries ?? 2;
+        this.enabled = options?.enabled ?? true;
+        this.writerHostgroup = options?.writerHostgroup ?? 10;
+        this.readerHostgroup = options?.readerHostgroup ?? 20;
+    }
+    /**
+     * Sync ProxySQL with the given cluster topology
+     * Uses lock and debounce mechanisms to prevent concurrent syncs
+     */
+    async sync(cluster, source = 'manual', force = false) {
+        // Input validation
+        const validation = this.validateCluster(cluster);
+        if (!validation.valid) {
+            logger.warn({ error: validation.error }, 'Sync rejected - invalid input');
+            return { skipped: true, reason: 'invalid_input', error: validation.error };
+        }
+        const clusterId = cluster.clusterId;
+        // Clear any pending debounce timer
+        const pendingTimer = this.pendingDebounces.get(clusterId);
+        if (pendingTimer) {
+            clearTimeout(pendingTimer);
+            this.pendingDebounces.delete(clusterId);
+        }
+        // If sync is already in progress, return that promise (lock mechanism)
+        const existingLock = this.locks.get(clusterId);
+        if (existingLock) {
+            logger.debug({ clusterId, source }, 'Returning existing sync promise');
+            return existingLock;
+        }
+        // Debounce: wait briefly before executing
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.pendingDebounces.delete(clusterId);
+                void this.executeSync(cluster, source, force).then(resolve);
+            }, force ? 0 : this.debounceMs); // Skip debounce if forced
+            // Don't keep the process alive just for this timer
+            timer.unref();
+            this.pendingDebounces.set(clusterId, timer);
+        });
+    }
+    /**
+     * Validate cluster input
+     */
+    validateCluster(cluster) {
+        if (!cluster) {
+            return { valid: false, error: 'Cluster is null or undefined' };
+        }
+        if (!cluster.clusterId) {
+            return { valid: false, error: 'Missing cluster ID' };
+        }
+        // If no primary and no replicas, nothing to sync
+        if (!cluster.primary && cluster.replicas.length === 0) {
+            return { valid: false, error: 'Cluster has no instances' };
+        }
+        return { valid: true };
+    }
+    /**
+     * Execute the actual sync with lock protection
+     */
+    async executeSync(cluster, source, force) {
+        const clusterId = cluster.clusterId;
+        if (!this.enabled) {
+            logger.debug({ clusterId }, 'Sync is disabled');
+            return { skipped: true, reason: 'disabled', clusterId, source };
+        }
+        // Create the sync promise and acquire lock
+        const syncPromise = this.doSync(cluster, source, force);
+        this.locks.set(clusterId, syncPromise);
+        try {
+            return await syncPromise;
+        }
+        finally {
+            this.locks.delete(clusterId);
+        }
+    }
+    /**
+     * Perform the actual sync operation
+     */
+    async doSync(cluster, source, force) {
+        const clusterId = cluster.clusterId;
+        const now = Date.now();
+        const lastSync = this.lastSyncTime.get(clusterId) || 0;
+        // Check cooldown (unless forced)
+        if (!force && now - lastSync < this.cooldownMs) {
+            logger.debug({ clusterId, source, timeSinceLastSync: now - lastSync }, 'Sync skipped due to cooldown');
+            this.stats.skippedSyncs++;
+            return { skipped: true, reason: 'cooldown', clusterId, source };
+        }
+        // Check for topology changes (unless forced)
+        const topologyHash = this.computeTopologyHash(cluster);
+        if (!force && this.lastTopologyHash.get(clusterId) === topologyHash) {
+            logger.debug({ clusterId, source }, 'Sync skipped - no topology change');
+            this.stats.skippedSyncs++;
+            return { skipped: true, reason: 'no_change', clusterId, source };
+        }
+        // Perform the sync with retry
+        logger.info({ clusterId, source }, 'Syncing ProxySQL with cluster topology');
+        this.stats.totalSyncs++;
+        let lastError = null;
+        for (let attempt = 1; attempt <= this.maxRetries; attempt++) {
+            try {
+                const proxysql = (0, proxysql_manager_js_1.getProxySQLManager)();
+                const result = await proxysql.syncCluster(cluster, this.writerHostgroup, this.readerHostgroup);
+                if (result.success) {
+                    // Only update state on success
+                    this.lastSyncTime.set(clusterId, Date.now());
+                    this.lastTopologyHash.set(clusterId, topologyHash);
+                    this.stats.successfulSyncs++;
+                    this.stats.lastSyncAt = new Date();
+                    this.stats.lastSyncCluster = clusterId;
+                    logger.info({ clusterId, source, serversSynced: result.serversAdded }, 'ProxySQL sync completed successfully');
+                    return {
+                        skipped: false,
+                        clusterId,
+                        source,
+                        serversSynced: result.serversAdded,
+                    };
+                }
+                else {
+                    lastError = result.errors.join(', ');
+                    logger.warn({ clusterId, attempt, errors: result.errors }, 'Sync attempt failed');
+                }
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error.message : String(error);
+                logger.error({ clusterId, attempt, error: lastError }, 'Sync attempt threw an error');
+            }
+        }
+        // All retries exhausted
+        this.stats.failedSyncs++;
+        logger.error({ clusterId, source, attempts: this.maxRetries, error: lastError }, 'All sync attempts failed');
+        return {
+            skipped: false,
+            reason: 'failed',
+            clusterId,
+            source,
+            error: lastError || 'Unknown error',
+        };
+    }
+    /**
+     * Compute a hash of the cluster topology for change detection
+     */
+    computeTopologyHash(cluster) {
+        const parts = [
+            cluster.clusterId,
+            cluster.primary ? `${cluster.primary.host}:${cluster.primary.port}:${cluster.primary.state}` : 'null',
+            ...cluster.replicas
+                .map(r => `${r.host}:${r.port}:${r.state}`)
+                .sort(),
+        ];
+        return parts.join('|');
+    }
+    /**
+     * Get sync statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Reset cooldown for a specific cluster
+     */
+    resetCooldown(clusterId) {
+        this.lastSyncTime.delete(clusterId);
+        logger.debug({ clusterId }, 'Cooldown reset for cluster');
+    }
+    /**
+     * Clear all cached topology hashes
+     */
+    clearCache() {
+        this.lastTopologyHash.clear();
+        this.lastSyncTime.clear();
+        logger.debug('Sync coordinator cache cleared');
+    }
+    /**
+     * Get the last sync time for a cluster
+     */
+    getLastSyncTime(clusterId) {
+        const timestamp = this.lastSyncTime.get(clusterId);
+        return timestamp ? new Date(timestamp) : null;
+    }
+    /**
+     * Check if a cluster is within cooldown period
+     */
+    isInCooldown(clusterId) {
+        const lastSync = this.lastSyncTime.get(clusterId);
+        if (!lastSync)
+            return false;
+        return Date.now() - lastSync < this.cooldownMs;
+    }
+}
+exports.SyncCoordinator = SyncCoordinator;
+// Singleton instance
+let syncCoordinator = null;
+/**
+ * Get the sync coordinator instance
+ */
+function getSyncCoordinator() {
+    if (!syncCoordinator) {
+        const settings = (0, settings_js_1.getSettings)();
+        syncCoordinator = new SyncCoordinator({
+            cooldownMs: settings.sync?.syncCooldownMs ?? 5000,
+            debounceMs: settings.sync?.debounceMs ?? 1000,
+            maxRetries: settings.sync?.maxRetries ?? 2,
+            enabled: settings.sync?.enabled ?? true,
+        });
+    }
+    return syncCoordinator;
+}
+/**
+ * Reset the sync coordinator (for testing)
+ */
+function resetSyncCoordinator() {
+    syncCoordinator = null;
+}
+//# sourceMappingURL=sync-coordinator.js.map

package/dist/core/sync/sync-coordinator.js.map

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

package/dist/core/sync/topology-watcher.d.ts

@@ -0,0 +1,76 @@
+/**
+ * ClawSQL - Topology Watcher
+ *
+ * Polls Orchestrator for topology changes and triggers ProxySQL sync.
+ * Acts as a fallback mechanism when webhooks are not received.
+ * Also attempts to recover replicas stuck in maintenance state.
+ */
+/**
+ * Topology Watcher
+ * Periodically checks for topology changes and syncs ProxySQL.
+ */
+export declare class TopologyWatcher {
+    private interval;
+    private running;
+    private lastTopologyHashes;
+    private pollIntervalMs;
+    private enabled;
+    constructor(options?: {
+        pollIntervalMs?: number;
+        enabled?: boolean;
+    });
+    /**
+     * Start watching for topology changes
+     */
+    start(): Promise<void>;
+    /**
+     * Stop watching for topology changes
+     */
+    stop(): void;
+    /**
+     * Check if the watcher is running
+     */
+    isRunning(): boolean;
+    /**
+     * Perform a single poll of all clusters
+     */
+    private poll;
+    /**
+     * Compute a hash of the cluster topology
+     */
+    private computeTopologyHash;
+    /**
+     * Force a poll cycle
+     */
+    forcePoll(): Promise<void>;
+    /**
+     * Clear cached topology hashes
+     */
+    clearCache(): void;
+    /**
+     * Get the current poll interval
+     */
+    getPollInterval(): number;
+    /**
+     * Update the poll interval
+     */
+    setPollInterval(intervalMs: number): void;
+    /**
+     * Check if any replicas need recovery (maintenance or offline state)
+     */
+    private hasReplicasNeedingRecovery;
+    /**
+     * Attempt to recover replicas in maintenance state (non-blocking)
+     * If recovery succeeds, invalidates cache to trigger re-sync on next poll
+     */
+    private attemptReplicaRecovery;
+}
+/**
+ * Get the topology watcher instance
+ */
+export declare function getTopologyWatcher(): TopologyWatcher;
+/**
+ * Reset the topology watcher (for testing)
+ */
+export declare function resetTopologyWatcher(): void;
+//# sourceMappingURL=topology-watcher.d.ts.map

package/dist/core/sync/topology-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-watcher.d.ts","sourceRoot":"","sources":["../../../src/core/sync/topology-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,kBAAkB,CAAkC;IAC5D,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;IAKpE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;YACW,IAAI;IAmElB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAUzC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAMlC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CAiC/B;AAKD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CASpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}