clawsql 0.1.0

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

@@ -0,0 +1,54 @@
+/**
+ * ClawSQL - Failover Types
+ *
+ * Type definitions for failover operations.
+ */
+import { MySQLCluster, MySQLInstance, FailoverOperation } from '../../types/index.js';
+/**
+ * Pre/Post failover hook type
+ */
+export type FailoverHook = (operation: FailoverOperation, cluster: MySQLCluster) => Promise<void>;
+/**
+ * Old primary awaiting recovery
+ */
+export interface PendingRecovery {
+    clusterId: string;
+    instanceId: string;
+    host: string;
+    port: number;
+    newPrimaryId: string;
+    failedAt: Date;
+    recoveredAt?: Date;
+}
+/**
+ * Recovery result
+ */
+export interface RecoveryResult {
+    success: boolean;
+    message: string;
+}
+/**
+ * Batch recovery result
+ */
+export interface BatchRecoveryResult {
+    recovered: string[];
+    stillPending: string[];
+    errors: string[];
+}
+/**
+ * Promotion result
+ */
+export interface PromotionResult {
+    success: boolean;
+    error?: string;
+}
+/**
+ * Operation context passed through execution steps
+ */
+export interface OperationContext {
+    operation: FailoverOperation;
+    cluster: MySQLCluster;
+    newPrimary: MySQLInstance | null;
+    addStep: (step: string) => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/failover/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAElG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,IAAI,CAAC;IACf,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,aAAa,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC"}

package/dist/core/failover/types.js

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

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

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

package/dist/core/monitoring/collector.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ClawSQL - Metrics Collector
+ *
+ * Collects metrics from MySQL instances.
+ */
+import { MySQLInstance, InstanceMetrics } from '../../types/index.js';
+/**
+ * Metrics Collector
+ */
+export declare class MetricsCollector {
+    private settings;
+    /**
+     * Collect metrics from a MySQL instance
+     */
+    collectMetrics(instance: MySQLInstance): Promise<InstanceMetrics>;
+    /**
+     * Parse SHOW STATUS rows into a key-value object
+     */
+    private parseStatusRows;
+}
+/**
+ * Get the metrics collector instance
+ */
+export declare function getMetricsCollector(): MetricsCollector;
+//# sourceMappingURL=collector.d.ts.map

package/dist/core/monitoring/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../../src/core/monitoring/collector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,aAAa,EACb,eAAe,EAEhB,MAAM,sBAAsB,CAAC;AAK9B;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAiB;IAEjC;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IA6EvE;;OAEG;IACH,OAAO,CAAC,eAAe;CAOxB;AAKD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD"}

package/dist/core/monitoring/collector.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * ClawSQL - Metrics Collector
+ *
+ * Collects metrics from MySQL instances.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsCollector = void 0;
+exports.getMetricsCollector = getMetricsCollector;
+const promise_1 = __importDefault(require("mysql2/promise"));
+const logger_js_1 = require("../../utils/logger.js");
+const index_js_1 = require("../../types/index.js");
+const settings_js_1 = require("../../config/settings.js");
+const logger = (0, logger_js_1.getLogger)('collector');
+/**
+ * Metrics Collector
+ */
+class MetricsCollector {
+    settings = (0, settings_js_1.getSettings)();
+    /**
+     * Collect metrics from a MySQL instance
+     */
+    async collectMetrics(instance) {
+        const instanceId = (0, index_js_1.createInstanceId)(instance.host, instance.port);
+        try {
+            const connection = await promise_1.default.createConnection({
+                host: instance.host,
+                port: instance.port,
+                user: this.settings.mysql.adminUser,
+                password: this.settings.mysql.adminPassword,
+                connectTimeout: 5000,
+            });
+            // Get replication status
+            const [slaveStatus] = await connection.execute('SHOW SLAVE STATUS');
+            const slaveStatusRow = slaveStatus[0];
+            // Get status variables
+            const [statusVars] = await connection.execute('SHOW GLOBAL STATUS WHERE Variable_name IN (?, ?, ?, ?, ?, ?, ?, ?)', [
+                'Threads_connected',
+                'max_connections',
+                'Queries',
+                'Uptime',
+                'Innodb_buffer_pool_read_requests',
+                'Innodb_buffer_pool_reads',
+                'Bytes_received',
+                'Bytes_sent',
+            ]);
+            const status = this.parseStatusRows(statusVars);
+            await connection.end();
+            // Calculate derived metrics
+            const bufferPoolReads = Number(status.Innodb_buffer_pool_reads) || 0;
+            const bufferPoolRequests = Number(status.Innodb_buffer_pool_read_requests) || 1;
+            const bufferPoolHitRate = bufferPoolRequests > 0
+                ? ((bufferPoolRequests - bufferPoolReads) / bufferPoolRequests) * 100
+                : 100;
+            return {
+                instanceId,
+                timestamp: new Date(),
+                replicationLagSeconds: slaveStatusRow
+                    ? Number(slaveStatusRow.Seconds_Behind_Master)
+                    : undefined,
+                replicationIoRunning: slaveStatusRow
+                    ? slaveStatusRow.Slave_IO_Running === 'Yes'
+                    : false,
+                replicationSqlRunning: slaveStatusRow
+                    ? slaveStatusRow.Slave_SQL_Running === 'Yes'
+                    : false,
+                connectionsCurrent: Number(status.Threads_connected) || 0,
+                connectionsMax: Number(status.max_connections) || 1000,
+                queriesPerSecond: Number(status.Queries) / (Number(status.Uptime) || 1),
+                innodbBufferPoolHitRate: bufferPoolHitRate,
+                uptimeSeconds: Number(status.Uptime) || 0,
+            };
+        }
+        catch (error) {
+            logger.error({ error, instanceId }, 'Failed to collect metrics');
+            return {
+                instanceId,
+                timestamp: new Date(),
+                replicationIoRunning: false,
+                replicationSqlRunning: false,
+                connectionsCurrent: 0,
+                connectionsMax: 0,
+                queriesPerSecond: 0,
+                innodbBufferPoolHitRate: 0,
+                uptimeSeconds: 0,
+            };
+        }
+    }
+    /**
+     * Parse SHOW STATUS rows into a key-value object
+     */
+    parseStatusRows(rows) {
+        const result = {};
+        for (const row of rows) {
+            result[row.Variable_name] = row.Value;
+        }
+        return result;
+    }
+}
+exports.MetricsCollector = MetricsCollector;
+// Singleton instance
+let metricsCollector = null;
+/**
+ * Get the metrics collector instance
+ */
+function getMetricsCollector() {
+    if (!metricsCollector) {
+        metricsCollector = new MetricsCollector();
+    }
+    return metricsCollector;
+}
+//# sourceMappingURL=collector.js.map

package/dist/core/monitoring/collector.js.map

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

package/dist/core/monitoring/exporters.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ClawSQL - Prometheus Exporter
+ *
+ * Exports metrics in Prometheus format.
+ */
+/**
+ * Prometheus Exporter
+ */
+export declare class PrometheusExporter {
+    private registry;
+    constructor();
+    /**
+     * Get metrics in Prometheus format
+     */
+    getMetrics(): Promise<string>;
+    /**
+     * Get content type for HTTP response
+     */
+    getContentType(): string;
+    /**
+     * Record a failover operation
+     */
+    recordFailover(clusterId: string, success: boolean, durationSeconds: number): void;
+    /**
+     * Set failover in progress status
+     */
+    setFailoverInProgress(clusterId: string, inProgress: boolean): void;
+    /**
+     * Update instance health metric
+     */
+    updateInstanceHealth(instanceId: string, clusterId: string, role: string, healthy: boolean): void;
+    /**
+     * Update replication lag metric
+     */
+    updateReplicationLag(instanceId: string, clusterId: string, lagSeconds: number): void;
+    /**
+     * Update connections metric
+     */
+    updateConnections(instanceId: string, clusterId: string, total: number): void;
+    /**
+     * Update QPS metric
+     */
+    updateQPS(instanceId: string, clusterId: string, qps: number): void;
+}
+/**
+ * Get the Prometheus exporter instance
+ */
+export declare function getPrometheusExporter(): PrometheusExporter;
+//# sourceMappingURL=exporters.d.ts.map

package/dist/core/monitoring/exporters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporters.d.ts","sourceRoot":"","sources":["../../../src/core/monitoring/exporters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsDH;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAkB;;IAMlC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAMlF;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAInE;;OAEG;IACH,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,IAAI;IAOP;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAIrF;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7E;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAGpE;AAKD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D"}

package/dist/core/monitoring/exporters.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * ClawSQL - Prometheus Exporter
+ *
+ * Exports metrics in Prometheus format.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrometheusExporter = void 0;
+exports.getPrometheusExporter = getPrometheusExporter;
+const prom_client_1 = __importDefault(require("prom-client"));
+const logger_js_1 = require("../../utils/logger.js");
+const logger = (0, logger_js_1.getLogger)('prometheus');
+// Initialize default metrics
+prom_client_1.default.collectDefaultMetrics();
+// Custom metrics
+const failoverTotal = new prom_client_1.default.Counter({
+    name: 'clawsql_failover_total',
+    help: 'Total number of failover operations',
+    labelNames: ['cluster_id', 'success'],
+});
+const failoverDuration = new prom_client_1.default.Histogram({
+    name: 'clawsql_failover_duration_seconds',
+    help: 'Duration of failover operations',
+    labelNames: ['cluster_id'],
+    buckets: [1, 5, 10, 20, 30, 60],
+});
+const failoverInProgress = new prom_client_1.default.Gauge({
+    name: 'clawsql_failover_in_progress',
+    help: 'Whether a failover is in progress',
+    labelNames: ['cluster_id'],
+});
+const instanceHealth = new prom_client_1.default.Gauge({
+    name: 'clawsql_instance_health',
+    help: 'Health status of MySQL instances (1=healthy, 0=unhealthy)',
+    labelNames: ['instance_id', 'cluster_id', 'role'],
+});
+const replicationLag = new prom_client_1.default.Gauge({
+    name: 'clawsql_replication_lag_seconds',
+    help: 'Replication lag in seconds',
+    labelNames: ['instance_id', 'cluster_id'],
+});
+const connectionsTotal = new prom_client_1.default.Gauge({
+    name: 'clawsql_connections_total',
+    help: 'Total connections to MySQL instance',
+    labelNames: ['instance_id', 'cluster_id'],
+});
+const queriesPerSecond = new prom_client_1.default.Gauge({
+    name: 'clawsql_queries_per_second',
+    help: 'Queries per second on MySQL instance',
+    labelNames: ['instance_id', 'cluster_id'],
+});
+/**
+ * Prometheus Exporter
+ */
+class PrometheusExporter {
+    registry;
+    constructor() {
+        this.registry = prom_client_1.default.register;
+    }
+    /**
+     * Get metrics in Prometheus format
+     */
+    async getMetrics() {
+        return this.registry.metrics();
+    }
+    /**
+     * Get content type for HTTP response
+     */
+    getContentType() {
+        return this.registry.contentType;
+    }
+    /**
+     * Record a failover operation
+     */
+    recordFailover(clusterId, success, durationSeconds) {
+        failoverTotal.inc({ cluster_id: clusterId, success: success.toString() });
+        failoverDuration.observe({ cluster_id: clusterId }, durationSeconds);
+        logger.debug({ clusterId, success, durationSeconds }, 'Failover recorded');
+    }
+    /**
+     * Set failover in progress status
+     */
+    setFailoverInProgress(clusterId, inProgress) {
+        failoverInProgress.set({ cluster_id: clusterId }, inProgress ? 1 : 0);
+    }
+    /**
+     * Update instance health metric
+     */
+    updateInstanceHealth(instanceId, clusterId, role, healthy) {
+        instanceHealth.set({ instance_id: instanceId, cluster_id: clusterId, role }, healthy ? 1 : 0);
+    }
+    /**
+     * Update replication lag metric
+     */
+    updateReplicationLag(instanceId, clusterId, lagSeconds) {
+        replicationLag.set({ instance_id: instanceId, cluster_id: clusterId }, lagSeconds);
+    }
+    /**
+     * Update connections metric
+     */
+    updateConnections(instanceId, clusterId, total) {
+        connectionsTotal.set({ instance_id: instanceId, cluster_id: clusterId }, total);
+    }
+    /**
+     * Update QPS metric
+     */
+    updateQPS(instanceId, clusterId, qps) {
+        queriesPerSecond.set({ instance_id: instanceId, cluster_id: clusterId }, qps);
+    }
+}
+exports.PrometheusExporter = PrometheusExporter;
+// Singleton instance
+let prometheusExporter = null;
+/**
+ * Get the Prometheus exporter instance
+ */
+function getPrometheusExporter() {
+    if (!prometheusExporter) {
+        prometheusExporter = new PrometheusExporter();
+    }
+    return prometheusExporter;
+}
+//# sourceMappingURL=exporters.js.map

package/dist/core/monitoring/exporters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporters.js","sourceRoot":"","sources":["../../../src/core/monitoring/exporters.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAyIH,sDAKC;AA5ID,8DAAiC;AACjC,qDAAkD;AAElD,MAAM,MAAM,GAAG,IAAA,qBAAS,EAAC,YAAY,CAAC,CAAC;AAEvC,6BAA6B;AAC7B,qBAAM,CAAC,qBAAqB,EAAE,CAAC;AAE/B,iBAAiB;AACjB,MAAM,aAAa,GAAG,IAAI,qBAAM,CAAC,OAAO,CAAC;IACvC,IAAI,EAAE,wBAAwB;IAC9B,IAAI,EAAE,qCAAqC;IAC3C,UAAU,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC;CACtC,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,IAAI,qBAAM,CAAC,SAAS,CAAC;IAC5C,IAAI,EAAE,mCAAmC;IACzC,IAAI,EAAE,iCAAiC;IACvC,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;CAChC,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,IAAI,qBAAM,CAAC,KAAK,CAAC;IAC1C,IAAI,EAAE,8BAA8B;IACpC,IAAI,EAAE,mCAAmC;IACzC,UAAU,EAAE,CAAC,YAAY,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,qBAAM,CAAC,KAAK,CAAC;IACtC,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,2DAA2D;IACjE,UAAU,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,CAAC;CAClD,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,qBAAM,CAAC,KAAK,CAAC;IACtC,IAAI,EAAE,iCAAiC;IACvC,IAAI,EAAE,4BAA4B;IAClC,UAAU,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC;CAC1C,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,IAAI,qBAAM,CAAC,KAAK,CAAC;IACxC,IAAI,EAAE,2BAA2B;IACjC,IAAI,EAAE,qCAAqC;IAC3C,UAAU,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC;CAC1C,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,IAAI,qBAAM,CAAC,KAAK,CAAC;IACxC,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE,sCAAsC;IAC5C,UAAU,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC;CAC1C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAa,kBAAkB;IACrB,QAAQ,CAAkB;IAElC;QACE,IAAI,CAAC,QAAQ,GAAG,qBAAM,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,SAAiB,EAAE,OAAgB,EAAE,eAAuB;QACzE,aAAa,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC1E,gBAAgB,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,eAAe,CAAC,CAAC;QACrE,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,mBAAmB,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,SAAiB,EAAE,UAAmB;QAC1D,kBAAkB,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,oBAAoB,CAClB,UAAkB,EAClB,SAAiB,EACjB,IAAY,EACZ,OAAgB;QAEhB,cAAc,CAAC,GAAG,CAChB,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,EACxD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,UAAkB,EAAE,SAAiB,EAAE,UAAkB;QAC5E,cAAc,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC;IACrF,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,UAAkB,EAAE,SAAiB,EAAE,KAAa;QACpE,gBAAgB,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,CAAC;IAClF,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,UAAkB,EAAE,SAAiB,EAAE,GAAW;QAC1D,gBAAgB,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,GAAG,CAAC,CAAC;IAChF,CAAC;CACF;AAxED,gDAwEC;AAED,qBAAqB;AACrB,IAAI,kBAAkB,GAA8B,IAAI,CAAC;AAEzD;;GAEG;AACH,SAAgB,qBAAqB;IACnC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/core/routing/proxysql-manager.d.ts

@@ -0,0 +1,213 @@
+/**
+ * ClawSQL - ProxySQL Manager
+ *
+ * Manages ProxySQL configuration and routing.
+ */
+import { MySQLInstance, MySQLCluster } from '../../types/index.js';
+import { ProxySQLSettings } from '../../config/settings.js';
+/**
+ * ProxySQL hostgroup
+ */
+export interface ProxySQLHostGroup {
+    hostgroupId: number;
+    name: string;
+    instances: MySQLInstance[];
+    isWriter: boolean;
+}
+/**
+ * ProxySQL server
+ */
+export interface ProxySQLServer {
+    hostgroupId: number;
+    hostname: string;
+    port: number;
+    weight: number;
+    status: 'ONLINE' | 'OFFLINE_SOFT' | 'OFFLINE_HARD';
+    maxConnections: number;
+    comment?: string;
+}
+/**
+ * ProxySQL server runtime statistics
+ */
+export interface ProxySQLServerStats {
+    hostgroupId: number;
+    host: string;
+    port: number;
+    status: string;
+    connUsed: number;
+    connFree: number;
+    connOk: number;
+    connErr: number;
+    queries: number;
+}
+/**
+ * ProxySQL replication hostgroup mapping
+ */
+export interface ProxySQLReplicationHostgroup {
+    writerHostgroup: number;
+    readerHostgroup: number;
+    clusterId?: string;
+    comment?: string;
+}
+/**
+ * ProxySQL query rule
+ */
+export interface ProxySQLRule {
+    ruleId: number;
+    matchPattern: string;
+    destinationHostgroup: number;
+    apply: boolean;
+    active: boolean;
+    comment?: string;
+}
+/**
+ * ProxySQL Manager
+ */
+export declare class ProxySQLManager {
+    private connection;
+    private settings;
+    private hostgroups;
+    private servers;
+    private rules;
+    static readonly DEFAULT_WRITER_HOSTGROUP = 10;
+    static readonly DEFAULT_READER_HOSTGROUP = 20;
+    constructor(settings?: ProxySQLSettings);
+    /**
+     * Connect to ProxySQL admin interface
+     */
+    connect(): Promise<void>;
+    /**
+     * Close the connection
+     */
+    close(): Promise<void>;
+    /**
+     * Execute a query on ProxySQL admin interface
+     * Note: ProxySQL admin doesn't support prepared statements, so we use query() instead
+     */
+    private execute;
+    /**
+     * Set monitor credentials
+     */
+    setMonitorCredentials(user: string, password: string): Promise<boolean>;
+    /**
+     * Add a MySQL server to ProxySQL
+     */
+    addServer(instance: MySQLInstance, hostgroupId: number, weight?: number, maxConnections?: number): Promise<boolean>;
+    /**
+     * Register a MySQL instance with ProxySQL
+     */
+    registerInstance(instance: MySQLInstance, isPrimary?: boolean, writerHostgroup?: number, readerHostgroup?: number): Promise<boolean>;
+    /**
+     * Remove a MySQL server from ProxySQL
+     */
+    removeServer(instance: MySQLInstance, hostgroupId: number): Promise<boolean>;
+    /**
+     * Setup read/write split routing rules
+     */
+    setupReadWriteSplit(_cluster: MySQLCluster, writerHostgroup?: number, readerHostgroup?: number): Promise<boolean>;
+    /**
+     * Sync an entire cluster to ProxySQL
+     */
+    syncCluster(cluster: MySQLCluster, writerHostgroup?: number, readerHostgroup?: number, adminUser?: string, adminPassword?: string): Promise<{
+        clusterId: string;
+        serversAdded: number;
+        serversRemoved: number;
+        hostgroups: {
+            writer: number;
+            reader: number;
+        };
+        success: boolean;
+        errors: string[];
+    }>;
+    /**
+     * Remove all servers for a cluster from ProxySQL
+     */
+    removeCluster(cluster: MySQLCluster, _writerHostgroup?: number, _readerHostgroup?: number): Promise<boolean>;
+    /**
+     * Load configuration changes to runtime
+     */
+    loadConfigToRuntime(): Promise<boolean>;
+    /**
+     * Save current configuration to disk
+     */
+    saveConfigToDisk(): Promise<boolean>;
+    /**
+     * Get servers configured in ProxySQL (queries live from mysql_servers table)
+     */
+    getServers(hostgroupId?: number): Promise<ProxySQLServer[]>;
+    /**
+     * Get live server statistics from ProxySQL stats_mysql_connection_pool
+     */
+    getServerStats(): Promise<ProxySQLServerStats[]>;
+    /**
+     * Get replication hostgroup mappings
+     */
+    getReplicationHostgroups(): Promise<ProxySQLReplicationHostgroup[]>;
+    /**
+     * Get the MySQL port that clients connect to
+     */
+    getMySQLPort(): number;
+    /**
+     * Get the ProxySQL host
+     */
+    getHost(): string;
+    /**
+     * Relocate a replica to follow a new primary
+     * This is used after failover to reconfigure replicas
+     */
+    relocateReplica(replica: MySQLInstance, newPrimary: MySQLInstance): Promise<boolean>;
+    /**
+     * Get configuration summary
+     */
+    getConfigSummary(): {
+        hostgroups: number;
+        servers: number;
+        rules: number;
+    };
+    /**
+     * Mirror server configuration to metadata database
+     */
+    private mirrorServer;
+    /**
+     * Mirror hostgroup configuration to metadata database
+     */
+    private mirrorHostgroup;
+    /**
+     * Mirror query rule to metadata database
+     */
+    private mirrorQueryRule;
+    /**
+     * Log action to audit table
+     */
+    private auditLog;
+    /**
+     * Restore ProxySQL configuration from metadata database
+     * Called on startup to sync ProxySQL with stored config
+     */
+    restoreFromDatabase(): Promise<{
+        servers: number;
+        hostgroups: number;
+        rules: number;
+    }>;
+    /**
+     * Get all mirrored servers from database
+     */
+    getMirroredServers(): Promise<ProxySQLServer[]>;
+    /**
+     * Get audit log entries
+     */
+    getAuditLog(limit?: number): Promise<{
+        id: number;
+        action: string;
+        entity_type: string;
+        entity_id: string;
+        old_value: unknown;
+        new_value: unknown;
+        changed_at: Date;
+    }[]>;
+}
+/**
+ * Get the ProxySQL manager instance
+ */
+export declare function getProxySQLManager(): ProxySQLManager;
+//# sourceMappingURL=proxysql-manager.d.ts.map

package/dist/core/routing/proxysql-manager.d.ts.map

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