clawsql 0.1.0

package/dist/types/index.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * ClawSQL - Core Types and Models
+ *
+ * TypeScript interfaces and enums converted from Python dataclasses.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FailureType = exports.FailoverState = exports.AlertSeverity = exports.HealthStatus = exports.InstanceState = exports.InstanceRole = void 0;
+exports.createInstanceId = createInstanceId;
+exports.createMySQLInstance = createMySQLInstance;
+exports.createMySQLCluster = createMySQLCluster;
+exports.isPrimary = isPrimary;
+exports.isReplica = isReplica;
+exports.isOnline = isOnline;
+exports.isHealthy = isHealthy;
+exports.getInstanceCount = getInstanceCount;
+exports.getHealthyCount = getHealthyCount;
+exports.getClusterHealthStatus = getClusterHealthStatus;
+// =============================================================================
+// Enums
+// =============================================================================
+/** MySQL instance role in the cluster */
+var InstanceRole;
+(function (InstanceRole) {
+    InstanceRole["PRIMARY"] = "primary";
+    InstanceRole["REPLICA"] = "replica";
+    InstanceRole["UNKNOWN"] = "unknown";
+})(InstanceRole || (exports.InstanceRole = InstanceRole = {}));
+/** MySQL instance operational state */
+var InstanceState;
+(function (InstanceState) {
+    InstanceState["ONLINE"] = "online";
+    InstanceState["OFFLINE"] = "offline";
+    InstanceState["RECOVERING"] = "recovering";
+    InstanceState["FAILED"] = "failed";
+    InstanceState["MAINTENANCE"] = "maintenance";
+})(InstanceState || (exports.InstanceState = InstanceState = {}));
+/** Health status for instances and clusters */
+var HealthStatus;
+(function (HealthStatus) {
+    HealthStatus["HEALTHY"] = "healthy";
+    HealthStatus["DEGRADED"] = "degraded";
+    HealthStatus["UNHEALTHY"] = "unhealthy";
+    HealthStatus["UNKNOWN"] = "unknown";
+})(HealthStatus || (exports.HealthStatus = HealthStatus = {}));
+/** Alert severity levels */
+var AlertSeverity;
+(function (AlertSeverity) {
+    AlertSeverity["INFO"] = "info";
+    AlertSeverity["WARNING"] = "warning";
+    AlertSeverity["CRITICAL"] = "critical";
+})(AlertSeverity || (exports.AlertSeverity = AlertSeverity = {}));
+/** Failover operation states */
+var FailoverState;
+(function (FailoverState) {
+    FailoverState["IDLE"] = "idle";
+    FailoverState["DETECTING"] = "detecting";
+    FailoverState["CANDIDATE_SELECTION"] = "candidate_selection";
+    FailoverState["PROMOTING"] = "promoting";
+    FailoverState["RECONFIGURING"] = "reconfiguring";
+    FailoverState["COMPLETED"] = "completed";
+    FailoverState["FAILED"] = "failed";
+})(FailoverState || (exports.FailoverState = FailoverState = {}));
+/** Types of failures that can be detected */
+var FailureType;
+(function (FailureType) {
+    FailureType["PRIMARY_UNREACHABLE"] = "primary_unreachable";
+    FailureType["PRIMARY_NOT_WRITING"] = "primary_not_writing";
+    FailureType["REPLICATION_STOPPED"] = "replication_stopped";
+    FailureType["REPLICATION_LAG_HIGH"] = "replication_lag_high";
+    FailureType["DISK_FULL"] = "disk_full";
+    FailureType["MEMORY_EXHAUSTED"] = "memory_exhausted";
+})(FailureType || (exports.FailureType = FailureType = {}));
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/** Create a unique instance ID from host and port */
+function createInstanceId(host, port) {
+    return `${host}:${port}`;
+}
+/** Create a default MySQL instance */
+function createMySQLInstance(host, port, overrides) {
+    return {
+        host,
+        port,
+        serverId: overrides?.serverId,
+        role: overrides?.role ?? InstanceRole.UNKNOWN,
+        state: overrides?.state ?? InstanceState.OFFLINE,
+        version: overrides?.version,
+        replicationLag: overrides?.replicationLag,
+        lastSeen: overrides?.lastSeen ?? new Date(),
+        clusterId: overrides?.clusterId,
+        labels: overrides?.labels ?? {},
+        extra: overrides?.extra ?? {},
+    };
+}
+/** Create a default MySQL cluster */
+function createMySQLCluster(clusterId, name, overrides) {
+    return {
+        clusterId,
+        name,
+        primary: overrides?.primary,
+        replicas: overrides?.replicas ?? [],
+        createdAt: overrides?.createdAt ?? new Date(),
+        updatedAt: overrides?.updatedAt ?? new Date(),
+        description: overrides?.description,
+    };
+}
+/** Check if instance is a primary */
+function isPrimary(instance) {
+    return instance.role === InstanceRole.PRIMARY;
+}
+/** Check if instance is a replica */
+function isReplica(instance) {
+    return instance.role === InstanceRole.REPLICA;
+}
+/** Check if instance is online */
+function isOnline(instance) {
+    return instance.state === InstanceState.ONLINE;
+}
+/** Check if instance is healthy */
+function isHealthy(instance) {
+    return instance.state === InstanceState.ONLINE && instance.role !== InstanceRole.UNKNOWN;
+}
+/** Get instance count for a cluster */
+function getInstanceCount(cluster) {
+    let count = 0;
+    if (cluster.primary)
+        count += 1;
+    count += cluster.replicas.length;
+    return count;
+}
+/** Get healthy instance count for a cluster */
+function getHealthyCount(cluster) {
+    let count = 0;
+    if (cluster.primary && isHealthy(cluster.primary))
+        count += 1;
+    count += cluster.replicas.filter(isHealthy).length;
+    return count;
+}
+/** Get overall cluster health status */
+function getClusterHealthStatus(cluster) {
+    const instanceCount = getInstanceCount(cluster);
+    if (instanceCount === 0)
+        return HealthStatus.UNKNOWN;
+    const healthyRatio = getHealthyCount(cluster) / instanceCount;
+    if (healthyRatio >= 1.0)
+        return HealthStatus.HEALTHY;
+    if (healthyRatio >= 0.5)
+        return HealthStatus.DEGRADED;
+    return HealthStatus.UNHEALTHY;
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/utils/database.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ClawSQL - Database Utility
+ *
+ * MySQL database connection for metadata storage.
+ * Shared with Orchestrator - extends Orchestrator's schema with ClawSQL-specific tables.
+ */
+import mysql from 'mysql2/promise';
+/**
+ * MySQL connection pool
+ */
+export type MySQLConnection = mysql.Pool;
+/**
+ * Database manager for MySQL metadata storage
+ */
+export declare class DatabaseManager {
+    private pool;
+    /**
+     * Initialize the database connection
+     */
+    connect(): Promise<void>;
+    /**
+     * Initialize ClawSQL-specific tables
+     * Note: Orchestrator creates its own tables automatically
+     */
+    private initializeSchema;
+    /**
+     * Execute a query and return results
+     */
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
+    /**
+     * Execute a statement (INSERT, UPDATE, DELETE)
+     */
+    execute(sql: string, params?: unknown[]): Promise<{
+        changes: number;
+        lastId: unknown;
+    }>;
+    /**
+     * Get a single row
+     */
+    get<T = unknown>(sql: string, params?: unknown[]): Promise<T | undefined>;
+    /**
+     * Get a connection from the pool for transactions
+     */
+    getConnection(): Promise<mysql.PoolConnection>;
+    /**
+     * Close the database connection
+     */
+    close(): Promise<void>;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+}
+/**
+ * Get the database manager instance
+ */
+export declare function getDatabase(): DatabaseManager;
+/**
+ * Initialize database connection
+ */
+export declare function initDatabase(): Promise<DatabaseManager>;
+//# sourceMappingURL=database.d.ts.map

package/dist/utils/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/utils/database.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,gBAAgB,CAAC;AAMnC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC;AAEzC;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAgC;IAE5C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC9B;;;OAGG;YACW,gBAAgB;IA4H9B;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAS3E;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAUjG;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAUnF;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;IAOpD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB;AAKD;;GAEG;AACH,wBAAgB,WAAW,IAAI,eAAe,CAK7C;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAM7D"}

package/dist/utils/database.js

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * ClawSQL - Database Utility
+ *
+ * MySQL database connection for metadata storage.
+ * Shared with Orchestrator - extends Orchestrator's schema with ClawSQL-specific tables.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseManager = void 0;
+exports.getDatabase = getDatabase;
+exports.initDatabase = initDatabase;
+const promise_1 = __importDefault(require("mysql2/promise"));
+const settings_js_1 = require("../config/settings.js");
+const logger_js_1 = require("./logger.js");
+const logger = (0, logger_js_1.getLogger)('database');
+/**
+ * Database manager for MySQL metadata storage
+ */
+class DatabaseManager {
+    pool = null;
+    /**
+     * Initialize the database connection
+     */
+    async connect() {
+        const settings = (0, settings_js_1.getSettings)();
+        const metadataDb = settings.metadataDb;
+        const host = metadataDb.host || 'metadata-mysql';
+        logger.info({ host, port: metadataDb.port, database: metadataDb.name }, 'Connecting to MySQL metadata database');
+        this.pool = promise_1.default.createPool({
+            host,
+            port: metadataDb.port,
+            database: metadataDb.name,
+            user: metadataDb.user,
+            password: metadataDb.password,
+            connectionLimit: metadataDb.poolSize,
+            waitForConnections: true,
+        });
+        // Test connection
+        const conn = await this.pool.getConnection();
+        await conn.ping();
+        conn.release();
+        logger.info('MySQL connection established');
+        // Initialize ClawSQL-specific tables
+        await this.initializeSchema();
+    }
+    /**
+     * Initialize ClawSQL-specific tables
+     * Note: Orchestrator creates its own tables automatically
+     */
+    async initializeSchema() {
+        const schema = `
+      -- Alerts table for ClawSQL alerting
+      CREATE TABLE IF NOT EXISTS alerts (
+        alert_id VARCHAR(36) PRIMARY KEY,
+        severity ENUM('info', 'warning', 'critical') NOT NULL,
+        instance_id VARCHAR(128),
+        cluster_id VARCHAR(128),
+        message TEXT NOT NULL,
+        details JSON,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        acknowledged BOOLEAN DEFAULT FALSE,
+        acknowledged_at TIMESTAMP NULL,
+        acknowledged_by VARCHAR(128),
+        INDEX idx_alerts_severity (severity),
+        INDEX idx_alerts_instance (instance_id),
+        INDEX idx_alerts_cluster (cluster_id),
+        INDEX idx_alerts_created (created_at)
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+      -- Schema metadata for NL2SQL processing
+      CREATE TABLE IF NOT EXISTS schema_metadata (
+        schema_id VARCHAR(36) PRIMARY KEY,
+        instance_id VARCHAR(128) NOT NULL,
+        database_name VARCHAR(64) NOT NULL,
+        table_name VARCHAR(64) NOT NULL,
+        column_name VARCHAR(64),
+        column_type VARCHAR(64),
+        is_nullable BOOLEAN,
+        column_comment TEXT,
+        table_comment TEXT,
+        sample_values JSON,
+        business_context TEXT,
+        last_updated TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+        UNIQUE KEY uk_schema (instance_id, database_name, table_name, column_name),
+        INDEX idx_schema_instance (instance_id),
+        INDEX idx_schema_database (database_name),
+        INDEX idx_schema_table (table_name)
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+      -- Instance metadata (labels, extra fields extending Orchestrator's database_instance)
+      CREATE TABLE IF NOT EXISTS instance_metadata (
+        instance_id VARCHAR(128) PRIMARY KEY,
+        labels JSON DEFAULT ('{}'),
+        extra JSON DEFAULT ('{}'),
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+      -- Configuration snapshots for version control
+      CREATE TABLE IF NOT EXISTS config_snapshots (
+        snapshot_id VARCHAR(36) PRIMARY KEY,
+        config_type VARCHAR(64) NOT NULL,
+        config_data JSON NOT NULL,
+        version VARCHAR(64) NOT NULL,
+        description TEXT,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        created_by VARCHAR(128),
+        INDEX idx_config_type (config_type),
+        INDEX idx_config_version (version)
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+      -- ProxySQL server configuration mirror
+      CREATE TABLE IF NOT EXISTS proxysql_servers (
+        id INT AUTO_INCREMENT PRIMARY KEY,
+        hostgroup_id INT NOT NULL,
+        hostname VARCHAR(255) NOT NULL,
+        port INT NOT NULL,
+        status ENUM('ONLINE', 'OFFLINE_SOFT', 'OFFLINE_HARD') DEFAULT 'ONLINE',
+        weight INT DEFAULT 1,
+        max_connections INT DEFAULT 1000,
+        max_replication_lag INT DEFAULT 0,
+        use_ssl TINYINT DEFAULT 0,
+        comment VARCHAR(255),
+        synced_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+        UNIQUE KEY uk_server (hostgroup_id, hostname, port),
+        INDEX idx_hostgroup (hostgroup_id)
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+      -- ProxySQL replication hostgroups mirror
+      CREATE TABLE IF NOT EXISTS proxysql_hostgroups (
+        writer_hostgroup INT PRIMARY KEY,
+        reader_hostgroup INT NOT NULL,
+        cluster_id VARCHAR(128),
+        comment VARCHAR(255),
+        synced_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+      -- ProxySQL query rules mirror
+      CREATE TABLE IF NOT EXISTS proxysql_query_rules (
+        rule_id INT PRIMARY KEY,
+        active TINYINT DEFAULT 1,
+        match_pattern VARCHAR(2048),
+        replace_pattern VARCHAR(2048),
+        destination_hostgroup INT,
+        apply TINYINT DEFAULT 1,
+        comment VARCHAR(255),
+        synced_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+      -- ProxySQL configuration change audit log
+      CREATE TABLE IF NOT EXISTS proxysql_audit_log (
+        id INT AUTO_INCREMENT PRIMARY KEY,
+        action VARCHAR(32) NOT NULL,
+        entity_type VARCHAR(32) NOT NULL,
+        entity_id VARCHAR(128),
+        old_value JSON,
+        new_value JSON,
+        changed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        changed_by VARCHAR(128),
+        INDEX idx_audit_action (action),
+        INDEX idx_audit_entity (entity_type, entity_id),
+        INDEX idx_audit_time (changed_at)
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+    `;
+        const statements = schema.split(';').filter(s => s.trim());
+        for (const statement of statements) {
+            await this.pool.execute(statement);
+        }
+        logger.info('ClawSQL schema initialized');
+    }
+    /**
+     * Execute a query and return results
+     */
+    async query(sql, params = []) {
+        if (!this.pool) {
+            throw new Error('Database not connected');
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const [rows] = await this.pool.execute(sql, params);
+        return rows;
+    }
+    /**
+     * Execute a statement (INSERT, UPDATE, DELETE)
+     */
+    async execute(sql, params = []) {
+        if (!this.pool) {
+            throw new Error('Database not connected');
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const [result] = await this.pool.execute(sql, params);
+        const r = result;
+        return { changes: r.affectedRows, lastId: r.insertId };
+    }
+    /**
+     * Get a single row
+     */
+    async get(sql, params = []) {
+        if (!this.pool) {
+            throw new Error('Database not connected');
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const [rows] = await this.pool.execute(sql, params);
+        const r = rows;
+        return r[0];
+    }
+    /**
+     * Get a connection from the pool for transactions
+     */
+    async getConnection() {
+        if (!this.pool) {
+            throw new Error('Database not connected');
+        }
+        return this.pool.getConnection();
+    }
+    /**
+     * Close the database connection
+     */
+    async close() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+            logger.info('MySQL connection closed');
+        }
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        return this.pool !== null;
+    }
+}
+exports.DatabaseManager = DatabaseManager;
+// Singleton instance
+let dbManager = null;
+/**
+ * Get the database manager instance
+ */
+function getDatabase() {
+    if (!dbManager) {
+        dbManager = new DatabaseManager();
+    }
+    return dbManager;
+}
+/**
+ * Initialize database connection
+ */
+async function initDatabase() {
+    const db = getDatabase();
+    if (!db.isConnected()) {
+        await db.connect();
+    }
+    return db;
+}
+//# sourceMappingURL=database.js.map

package/dist/utils/database.js.map

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

package/dist/utils/exceptions.d.ts

@@ -0,0 +1,69 @@
+/**
+ * ClawSQL - Custom Exceptions
+ *
+ * Custom error classes for ClawSQL.
+ */
+/**
+ * Base ClawSQL error class
+ */
+export declare class ClawSQLError extends Error {
+    readonly code: string;
+    readonly details: Record<string, unknown>;
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Validation error
+ */
+export declare class ValidationError extends ClawSQLError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Not found error
+ */
+export declare class NotFoundError extends ClawSQLError {
+    constructor(resource: string, identifier: string);
+}
+/**
+ * Already exists error
+ */
+export declare class AlreadyExistsError extends ClawSQLError {
+    constructor(resource: string, identifier: string);
+}
+/**
+ * Connection error
+ */
+export declare class ConnectionError extends ClawSQLError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Orchestrator error
+ */
+export declare class OrchestratorError extends ClawSQLError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * ProxySQL error
+ */
+export declare class ProxySQLError extends ClawSQLError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Failover error
+ */
+export declare class FailoverError extends ClawSQLError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Authentication error
+ */
+export declare class AuthenticationError extends ClawSQLError {
+    constructor(message?: string);
+}
+/**
+ * Authorization error
+ */
+export declare class AuthorizationError extends ClawSQLError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=exceptions.d.ts.map

package/dist/utils/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../src/utils/exceptions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAG/C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IASvC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOlC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;gBACjC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAIjD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAIjD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,OAAO,GAAE,MAAgC;CAItD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,OAAO,GAAE,MAAwB;CAI9C"}

package/dist/utils/exceptions.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * ClawSQL - Custom Exceptions
+ *
+ * Custom error classes for ClawSQL.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthorizationError = exports.AuthenticationError = exports.FailoverError = exports.ProxySQLError = exports.OrchestratorError = exports.ConnectionError = exports.AlreadyExistsError = exports.NotFoundError = exports.ValidationError = exports.ClawSQLError = void 0;
+/**
+ * Base ClawSQL error class
+ */
+class ClawSQLError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = 'ClawSQLError';
+        this.code = code;
+        this.details = details;
+        Error.captureStackTrace(this, this.constructor);
+    }
+    toJSON() {
+        return {
+            error: this.code,
+            message: this.message,
+            details: this.details,
+        };
+    }
+}
+exports.ClawSQLError = ClawSQLError;
+/**
+ * Validation error
+ */
+class ValidationError extends ClawSQLError {
+    constructor(message, details = {}) {
+        super('VALIDATION_ERROR', message, details);
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Not found error
+ */
+class NotFoundError extends ClawSQLError {
+    constructor(resource, identifier) {
+        super('NOT_FOUND', `${resource} not found: ${identifier}`, { resource, identifier });
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+/**
+ * Already exists error
+ */
+class AlreadyExistsError extends ClawSQLError {
+    constructor(resource, identifier) {
+        super('ALREADY_EXISTS', `${resource} already exists: ${identifier}`, { resource, identifier });
+        this.name = 'AlreadyExistsError';
+    }
+}
+exports.AlreadyExistsError = AlreadyExistsError;
+/**
+ * Connection error
+ */
+class ConnectionError extends ClawSQLError {
+    constructor(message, details = {}) {
+        super('CONNECTION_ERROR', message, details);
+        this.name = 'ConnectionError';
+    }
+}
+exports.ConnectionError = ConnectionError;
+/**
+ * Orchestrator error
+ */
+class OrchestratorError extends ClawSQLError {
+    constructor(message, details = {}) {
+        super('ORCHESTRATOR_ERROR', message, details);
+        this.name = 'OrchestratorError';
+    }
+}
+exports.OrchestratorError = OrchestratorError;
+/**
+ * ProxySQL error
+ */
+class ProxySQLError extends ClawSQLError {
+    constructor(message, details = {}) {
+        super('PROXYSQL_ERROR', message, details);
+        this.name = 'ProxySQLError';
+    }
+}
+exports.ProxySQLError = ProxySQLError;
+/**
+ * Failover error
+ */
+class FailoverError extends ClawSQLError {
+    constructor(message, details = {}) {
+        super('FAILOVER_ERROR', message, details);
+        this.name = 'FailoverError';
+    }
+}
+exports.FailoverError = FailoverError;
+/**
+ * Authentication error
+ */
+class AuthenticationError extends ClawSQLError {
+    constructor(message = 'Authentication failed') {
+        super('AUTHENTICATION_ERROR', message, {});
+        this.name = 'AuthenticationError';
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+/**
+ * Authorization error
+ */
+class AuthorizationError extends ClawSQLError {
+    constructor(message = 'Access denied') {
+        super('AUTHORIZATION_ERROR', message, {});
+        this.name = 'AuthorizationError';
+    }
+}
+exports.AuthorizationError = AuthorizationError;
+//# sourceMappingURL=exceptions.js.map