clawsql 0.1.0

package/dist/core/sync/topology-watcher.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopologyWatcher = void 0;
+exports.getTopologyWatcher = getTopologyWatcher;
+exports.resetTopologyWatcher = resetTopologyWatcher;
+const logger_js_1 = require("../../utils/logger.js");
+const index_js_1 = require("../../types/index.js");
+const topology_js_1 = require("../discovery/topology.js");
+const sync_coordinator_js_1 = require("./sync-coordinator.js");
+const replica_recovery_js_1 = require("./replica-recovery.js");
+const settings_js_1 = require("../../config/settings.js");
+const logger = (0, logger_js_1.getLogger)('sync');
+/**
+ * Topology Watcher
+ * Periodically checks for topology changes and syncs ProxySQL.
+ */
+class TopologyWatcher {
+    interval = null;
+    running = false;
+    lastTopologyHashes = new Map();
+    pollIntervalMs;
+    enabled;
+    constructor(options) {
+        this.pollIntervalMs = options?.pollIntervalMs ?? 30000;
+        this.enabled = options?.enabled ?? true;
+    }
+    /**
+     * Start watching for topology changes
+     */
+    async start() {
+        if (this.running || !this.enabled) {
+            logger.debug({ running: this.running, enabled: this.enabled }, 'Topology watcher not started');
+            return;
+        }
+        this.running = true;
+        logger.info({ pollIntervalMs: this.pollIntervalMs }, 'Topology watcher started');
+        // Do initial poll
+        await this.poll();
+        // Schedule periodic polls
+        this.interval = setInterval(() => { void this.poll(); }, this.pollIntervalMs);
+        // Don't keep the process alive just for this timer
+        this.interval.unref();
+    }
+    /**
+     * Stop watching for topology changes
+     */
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+        this.running = false;
+        logger.info('Topology watcher stopped');
+    }
+    /**
+     * Check if the watcher is running
+     */
+    isRunning() {
+        return this.running;
+    }
+    /**
+     * Perform a single poll of all clusters
+     */
+    async poll() {
+        logger.debug('Polling for topology changes');
+        try {
+            const orchestrator = (0, topology_js_1.getOrchestratorClient)();
+            const syncCoordinator = (0, sync_coordinator_js_1.getSyncCoordinator)();
+            // Get all clusters
+            const clusters = await orchestrator.getClusters();
+            for (const clusterName of clusters) {
+                try {
+                    const topology = await orchestrator.getTopology(clusterName);
+                    if (!topology) {
+                        logger.debug({ clusterName }, 'Could not get topology for cluster');
+                        continue;
+                    }
+                    const hash = this.computeTopologyHash(topology);
+                    const lastHash = this.lastTopologyHashes.get(topology.clusterId);
+                    // Check if topology changed
+                    if (lastHash !== hash) {
+                        logger.info({ clusterId: topology.clusterId, oldHash: lastHash, newHash: hash }, 'Topology change detected');
+                        // Attempt to recover replicas in maintenance state (non-blocking)
+                        // This handles cases where webhook recovery failed or was skipped
+                        if (topology.primary) {
+                            this.attemptReplicaRecovery(topology, orchestrator);
+                        }
+                        // Sync ProxySQL
+                        await syncCoordinator.sync(topology, 'poll');
+                        // Update hash
+                        this.lastTopologyHashes.set(topology.clusterId, hash);
+                    }
+                    else {
+                        // Even if topology hasn't changed, check for replicas needing recovery
+                        // This handles cases where recovery was deferred earlier
+                        if (topology.primary && this.hasReplicasNeedingRecovery(topology)) {
+                            logger.info({ clusterId: topology.clusterId }, 'Checking for replicas needing recovery');
+                            this.attemptReplicaRecovery(topology, orchestrator);
+                        }
+                        logger.debug({ clusterId: topology.clusterId }, 'No topology change detected');
+                    }
+                }
+                catch (error) {
+                    logger.error({ error, clusterName }, 'Error polling cluster topology');
+                }
+            }
+        }
+        catch (error) {
+            logger.error({ error }, 'Error during topology poll');
+        }
+    }
+    /**
+     * Compute a hash of the cluster topology
+     */
+    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}:${r.replicationLag ?? 0}`)
+                .sort(),
+        ];
+        return parts.join('|');
+    }
+    /**
+     * Force a poll cycle
+     */
+    async forcePoll() {
+        await this.poll();
+    }
+    /**
+     * Clear cached topology hashes
+     */
+    clearCache() {
+        this.lastTopologyHashes.clear();
+        logger.debug('Topology cache cleared');
+    }
+    /**
+     * Get the current poll interval
+     */
+    getPollInterval() {
+        return this.pollIntervalMs;
+    }
+    /**
+     * Update the poll interval
+     */
+    setPollInterval(intervalMs) {
+        this.pollIntervalMs = intervalMs;
+        if (this.running && this.interval) {
+            clearInterval(this.interval);
+            this.interval = setInterval(() => { void this.poll(); }, this.pollIntervalMs);
+            this.interval.unref();
+            logger.info({ pollIntervalMs: this.pollIntervalMs }, 'Poll interval updated');
+        }
+    }
+    /**
+     * Check if any replicas need recovery (maintenance or offline state)
+     */
+    hasReplicasNeedingRecovery(cluster) {
+        return cluster.replicas.some(r => r.state === index_js_1.InstanceState.MAINTENANCE || r.state === index_js_1.InstanceState.OFFLINE);
+    }
+    /**
+     * Attempt to recover replicas in maintenance state (non-blocking)
+     * If recovery succeeds, invalidates cache to trigger re-sync on next poll
+     */
+    attemptReplicaRecovery(cluster, orchestrator) {
+        if (!cluster.primary)
+            return;
+        const replicasNeedingRecovery = cluster.replicas.filter(r => r.state === index_js_1.InstanceState.MAINTENANCE || r.state === index_js_1.InstanceState.OFFLINE);
+        if (replicasNeedingRecovery.length === 0)
+            return;
+        // Attempt recovery in background (non-blocking)
+        for (const replica of replicasNeedingRecovery) {
+            (0, replica_recovery_js_1.recoverReplica)(replica, cluster.primary, orchestrator)
+                .then(result => {
+                if (result.recovered) {
+                    logger.info({ instanceId: `${replica.host}:${replica.port}` }, 'Replica auto-recovered during poll');
+                    // Invalidate cache to force re-sync on next poll
+                    this.lastTopologyHashes.delete(cluster.clusterId);
+                }
+            })
+                .catch(error => {
+                logger.debug({ error, instanceId: `${replica.host}:${replica.port}` }, 'Recovery attempt failed (will retry)');
+            });
+        }
+    }
+}
+exports.TopologyWatcher = TopologyWatcher;
+// Singleton instance
+let topologyWatcher = null;
+/**
+ * Get the topology watcher instance
+ */
+function getTopologyWatcher() {
+    if (!topologyWatcher) {
+        const settings = (0, settings_js_1.getSettings)();
+        topologyWatcher = new TopologyWatcher({
+            pollIntervalMs: settings.sync?.pollIntervalMs ?? 30000,
+            enabled: settings.sync?.enabled ?? true,
+        });
+    }
+    return topologyWatcher;
+}
+/**
+ * Reset the topology watcher (for testing)
+ */
+function resetTopologyWatcher() {
+    if (topologyWatcher) {
+        topologyWatcher.stop();
+    }
+    topologyWatcher = null;
+}
+//# sourceMappingURL=topology-watcher.js.map

package/dist/core/sync/topology-watcher.js.map

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

package/dist/core/sync/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * ClawSQL - Sync Types
+ *
+ * Type definitions for synchronization operations.
+ */
+import { MySQLCluster } from '../../types/index.js';
+/**
+ * Orchestrator failover webhook payload
+ * Sent by Orchestrator after failover completion
+ */
+export interface OrchestratorFailoverPayload {
+    /** Cluster alias/name */
+    cluster: string;
+    /** Old master (host:port) */
+    master: string;
+    /** New master (host:port) */
+    successor: string;
+    /** New master hostname */
+    successorHost?: string;
+    /** New master port */
+    successorPort?: number;
+    /** Whether the failover succeeded */
+    isSuccessful: boolean;
+    /** Type of failover */
+    failoverType: 'master' | 'intermediate-master';
+    /** Reason for failover */
+    reason?: string;
+    /** Timestamp of the event */
+    timestamp?: string;
+}
+/**
+ * Sync result
+ */
+export interface SyncResult {
+    /** Whether the sync was skipped */
+    skipped: boolean;
+    /** Reason for skipping (if applicable) */
+    reason?: 'cooldown' | 'disabled' | 'no_change' | 'failed' | 'invalid_input';
+    /** Cluster ID that was synced */
+    clusterId?: string;
+    /** Number of servers synced */
+    serversSynced?: number;
+    /** Error message if sync failed */
+    error?: string;
+    /** Source of the sync trigger */
+    source?: 'webhook' | 'poll' | 'manual';
+}
+/**
+ * Topology hash for change detection
+ */
+export interface TopologyHash {
+    clusterId: string;
+    hash: string;
+    updatedAt: Date;
+}
+/**
+ * Sync context passed through the sync pipeline
+ */
+export interface SyncContext {
+    cluster: MySQLCluster;
+    source: 'webhook' | 'poll' | 'manual';
+    webhookPayload?: OrchestratorFailoverPayload;
+    force?: boolean;
+}
+/**
+ * Sync coordinator stats
+ */
+export interface SyncStats {
+    totalSyncs: number;
+    successfulSyncs: number;
+    failedSyncs: number;
+    skippedSyncs: number;
+    lastSyncAt?: Date;
+    lastSyncCluster?: string;
+}
+/**
+ * Webhook handler result
+ */
+export interface WebhookResult {
+    received: boolean;
+    processed: boolean;
+    message?: string;
+    syncResult?: SyncResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/sync/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/sync/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,uBAAuB;IACvB,YAAY,EAAE,QAAQ,GAAG,qBAAqB,CAAC;IAC/C,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,eAAe,CAAC;IAC5E,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACtC,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB"}

package/dist/core/sync/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * ClawSQL - Sync Types
+ *
+ * Type definitions for synchronization operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/sync/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/sync/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * ClawSQL - Main Entry Point
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * ClawSQL - Main Entry Point
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const app_js_1 = require("./app.js");
+// Start the server
+(0, app_js_1.startServer)();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAEH,qCAAuC;AAEvC,mBAAmB;AACnB,IAAA,oBAAW,GAAE,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,212 @@
+/**
+ * ClawSQL - Core Types and Models
+ *
+ * TypeScript interfaces and enums converted from Python dataclasses.
+ */
+/** MySQL instance role in the cluster */
+export declare enum InstanceRole {
+    PRIMARY = "primary",
+    REPLICA = "replica",
+    UNKNOWN = "unknown"
+}
+/** MySQL instance operational state */
+export declare enum InstanceState {
+    ONLINE = "online",
+    OFFLINE = "offline",
+    RECOVERING = "recovering",
+    FAILED = "failed",
+    MAINTENANCE = "maintenance"
+}
+/** Health status for instances and clusters */
+export declare enum HealthStatus {
+    HEALTHY = "healthy",
+    DEGRADED = "degraded",
+    UNHEALTHY = "unhealthy",
+    UNKNOWN = "unknown"
+}
+/** Alert severity levels */
+export declare enum AlertSeverity {
+    INFO = "info",
+    WARNING = "warning",
+    CRITICAL = "critical"
+}
+/** Failover operation states */
+export declare enum FailoverState {
+    IDLE = "idle",
+    DETECTING = "detecting",
+    CANDIDATE_SELECTION = "candidate_selection",
+    PROMOTING = "promoting",
+    RECONFIGURING = "reconfiguring",
+    COMPLETED = "completed",
+    FAILED = "failed"
+}
+/** Types of failures that can be detected */
+export declare enum FailureType {
+    PRIMARY_UNREACHABLE = "primary_unreachable",
+    PRIMARY_NOT_WRITING = "primary_not_writing",
+    REPLICATION_STOPPED = "replication_stopped",
+    REPLICATION_LAG_HIGH = "replication_lag_high",
+    DISK_FULL = "disk_full",
+    MEMORY_EXHAUSTED = "memory_exhausted"
+}
+/** Represents a discovered MySQL instance */
+export interface MySQLInstance {
+    host: string;
+    port: number;
+    serverId?: number;
+    role: InstanceRole;
+    state: InstanceState;
+    version?: string;
+    replicationLag?: number;
+    lastSeen: Date;
+    clusterId?: string;
+    labels: Record<string, string>;
+    extra: Record<string, unknown>;
+}
+/** Represents a MySQL cluster topology */
+export interface MySQLCluster {
+    clusterId: string;
+    name: string;
+    primary?: MySQLInstance;
+    replicas: MySQLInstance[];
+    createdAt: Date;
+    updatedAt: Date;
+    description?: string;
+}
+/** Failover operation record */
+export interface FailoverOperation {
+    operationId: string;
+    clusterId: string;
+    oldPrimaryId: string;
+    newPrimaryId?: string;
+    state: FailoverState;
+    startedAt?: Date;
+    completedAt?: Date;
+    steps: string[];
+    error?: string;
+    manual: boolean;
+    reason: string;
+    triggeredBy?: string;
+}
+/** Failure event detected by the system */
+export interface FailureEvent {
+    eventId: string;
+    failureType: FailureType;
+    instanceId: string;
+    clusterId: string;
+    detectedAt: Date;
+    confirmed: boolean;
+    confirmationCount: number;
+    details: Record<string, unknown>;
+}
+/** Alert generated by the monitoring system */
+export interface Alert {
+    alertId: string;
+    severity: AlertSeverity;
+    instanceId?: string;
+    clusterId?: string;
+    message: string;
+    details: Record<string, unknown>;
+    createdAt: Date;
+    acknowledged: boolean;
+    acknowledgedAt?: Date;
+    acknowledgedBy?: string;
+}
+/** Instance metrics collected from MySQL */
+export interface InstanceMetrics {
+    instanceId: string;
+    timestamp: Date;
+    replicationLagSeconds?: number;
+    replicationIoRunning: boolean;
+    replicationSqlRunning: boolean;
+    connectionsCurrent: number;
+    connectionsMax: number;
+    queriesPerSecond: number;
+    innodbBufferPoolHitRate: number;
+    uptimeSeconds: number;
+    diskUsagePercent?: number;
+    memoryUsagePercent?: number;
+}
+/** Health check result */
+export interface HealthCheckResult {
+    checkName: string;
+    status: HealthStatus;
+    value: number;
+    message: string;
+    threshold?: number;
+}
+/** Create a unique instance ID from host and port */
+export declare function createInstanceId(host: string, port: number): string;
+/** Create a default MySQL instance */
+export declare function createMySQLInstance(host: string, port: number, overrides?: Partial<MySQLInstance>): MySQLInstance;
+/** Create a default MySQL cluster */
+export declare function createMySQLCluster(clusterId: string, name: string, overrides?: Partial<MySQLCluster>): MySQLCluster;
+/** Check if instance is a primary */
+export declare function isPrimary(instance: MySQLInstance): boolean;
+/** Check if instance is a replica */
+export declare function isReplica(instance: MySQLInstance): boolean;
+/** Check if instance is online */
+export declare function isOnline(instance: MySQLInstance): boolean;
+/** Check if instance is healthy */
+export declare function isHealthy(instance: MySQLInstance): boolean;
+/** Get instance count for a cluster */
+export declare function getInstanceCount(cluster: MySQLCluster): number;
+/** Get healthy instance count for a cluster */
+export declare function getHealthyCount(cluster: MySQLCluster): number;
+/** Get overall cluster health status */
+export declare function getClusterHealthStatus(cluster: MySQLCluster): HealthStatus;
+/** Instance with merged Orchestrator and ProxySQL data */
+export interface MergedInstanceInfo {
+    host: string;
+    port: number;
+    state: InstanceState;
+    role: InstanceRole;
+    version?: string;
+    serverId?: number;
+    replicationLag?: number;
+    /** ProxySQL hostgroup (10=writer, 20=reader) */
+    hostgroup?: number;
+    /** ProxySQL server status (ONLINE, OFFLINE_SOFT, etc.) */
+    proxysqlStatus?: string;
+    /** Active connections from ProxySQL connection pool */
+    connections?: number;
+}
+/** ProxySQL endpoint information */
+export interface ProxySQLEndpoint {
+    host: string;
+    port: number;
+}
+/** Hostgroup routing configuration */
+export interface HostgroupConfig {
+    writer: number;
+    reader: number;
+}
+/** Sync warning type */
+export interface SyncWarning {
+    /** Warning type: missing_in_proxysql, wrong_hostgroup, unknown_in_orchestrator */
+    type: 'missing_in_proxysql' | 'wrong_hostgroup' | 'unknown_in_orchestrator';
+    /** Instance identifier */
+    instance: string;
+    /** Human-readable description */
+    message: string;
+}
+/** Merged cluster view combining Orchestrator topology with ProxySQL routing */
+export interface MergedClusterView {
+    /** Cluster identifier from Orchestrator */
+    clusterId: string;
+    /** User-friendly cluster name */
+    displayName: string;
+    /** ProxySQL endpoint for client connections */
+    endpoint?: ProxySQLEndpoint;
+    /** Hostgroup routing configuration */
+    hostgroups?: HostgroupConfig;
+    /** Primary instance with merged data */
+    primary: MergedInstanceInfo | null;
+    /** Replica instances with merged data */
+    replicas: MergedInstanceInfo[];
+    /** Overall cluster health */
+    health: HealthStatus;
+    /** Sync warnings when ProxySQL and Orchestrator are out of sync */
+    syncWarnings?: SyncWarning[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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