@memberjunction/db-auto-doc 2.117.0 → 2.119.0

package/dist/core/GuardrailsManager.js

@@ -0,0 +1,367 @@
+"use strict";
+/**
+ * Manages granular guardrails enforcement for DBAutoDoc analysis
+ *
+ * Supports:
+ * - Per-phase token limits (discovery, analysis, sanity checks)
+ * - Per-iteration token and duration limits
+ * - Cost-based limits with configurable thresholds
+ * - Configurable warning thresholds at percentages of limits
+ * - Detailed tracking of exceedances and warnings
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuardrailsManager = void 0;
+class GuardrailsManager {
+    constructor(config) {
+        this.phaseStartTimes = new Map();
+        this.currentIteration = 0;
+        this.config = config || {};
+        this.startTime = Date.now();
+    }
+    /**
+     * Begin tracking a new phase
+     */
+    startPhase(phase) {
+        this.currentPhase = phase;
+        this.phaseStartTimes.set(phase, Date.now());
+    }
+    /**
+     * End tracking current phase and record metrics
+     */
+    endPhase(run, phase) {
+        if (!run.phaseMetrics) {
+            run.phaseMetrics = {};
+        }
+        const startTime = this.phaseStartTimes.get(phase);
+        if (startTime) {
+            const metric = {
+                startedAt: new Date(startTime).toISOString(),
+                completedAt: new Date().toISOString(),
+                tokensUsed: this.getPhaseTokens(run, phase),
+                estimatedCost: this.getPhaseCost(run, phase)
+            };
+            if (phase === 'discovery') {
+                run.phaseMetrics.discovery = metric;
+            }
+            else if (phase === 'analysis') {
+                run.phaseMetrics.analysis = metric;
+            }
+            else if (phase === 'sanityChecks') {
+                run.phaseMetrics.sanityChecks = metric;
+            }
+        }
+        this.currentPhase = undefined;
+    }
+    /**
+     * Start tracking a new iteration
+     */
+    startIteration(iteration) {
+        this.currentIteration = iteration;
+        this.iterationStartTime = Date.now();
+    }
+    /**
+     * End tracking current iteration and record metrics
+     */
+    endIteration(run, iteration) {
+        if (!run.iterationMetrics) {
+            run.iterationMetrics = [];
+        }
+        if (this.iterationStartTime) {
+            const metric = {
+                iterationNumber: iteration,
+                startedAt: new Date(this.iterationStartTime).toISOString(),
+                completedAt: new Date().toISOString(),
+                tokensUsed: run.totalTokensUsed || 0,
+                estimatedCost: run.estimatedCost || 0,
+                duration: Date.now() - this.iterationStartTime
+            };
+            run.iterationMetrics.push(metric);
+        }
+        this.iterationStartTime = undefined;
+    }
+    /**
+     * Check all guardrails and return enforcement status
+     */
+    checkGuardrails(run) {
+        // If guardrails disabled, allow continuation
+        if (this.config.enabled === false) {
+            return { canContinue: true };
+        }
+        const elapsedSeconds = (Date.now() - this.startTime) / 1000;
+        const totalTokens = run.totalTokensUsed || 0;
+        const totalCost = run.estimatedCost || 0;
+        // Get default thresholds
+        const warnThresholds = this.config.warnThresholds || {};
+        const tokenWarnPercent = warnThresholds.tokenPercentage ?? 80;
+        const durationWarnPercent = warnThresholds.durationPercentage ?? 80;
+        const costWarnPercent = warnThresholds.costPercentage ?? 80;
+        const iterationTokenWarnPercent = warnThresholds.iterationTokenPercentage ?? 80;
+        const phaseTokenWarnPercent = warnThresholds.phaseTokenPercentage ?? 80;
+        const warnings = [];
+        const exceedances = [];
+        // 1. Check hard limits - STOP
+        if (this.config.maxTokensPerRun && totalTokens >= this.config.maxTokensPerRun) {
+            exceedances.push({
+                type: 'tokens_per_run',
+                limit: this.config.maxTokensPerRun,
+                actual: totalTokens,
+                unit: 'tokens'
+            });
+            return this.createStopResult(`Token limit exceeded: ${totalTokens.toLocaleString()} / ${this.config.maxTokensPerRun.toLocaleString()} tokens`, warnings, exceedances);
+        }
+        if (this.config.maxDurationSeconds && elapsedSeconds >= this.config.maxDurationSeconds) {
+            exceedances.push({
+                type: 'duration',
+                limit: this.config.maxDurationSeconds,
+                actual: Math.round(elapsedSeconds),
+                unit: 'seconds'
+            });
+            return this.createStopResult(`Duration limit exceeded: ${Math.round(elapsedSeconds)}s / ${this.config.maxDurationSeconds}s`, warnings, exceedances);
+        }
+        if (this.config.maxCostDollars && totalCost >= this.config.maxCostDollars) {
+            exceedances.push({
+                type: 'cost',
+                limit: this.config.maxCostDollars,
+                actual: Number(totalCost.toFixed(2)),
+                unit: 'dollars'
+            });
+            return this.createStopResult(`Cost limit exceeded: $${totalCost.toFixed(2)} / $${this.config.maxCostDollars.toFixed(2)}`, warnings, exceedances);
+        }
+        // 2. Check phase-specific token limits
+        if (this.currentPhase && this.config.maxTokensPerPhase) {
+            const phaseLimits = this.config.maxTokensPerPhase;
+            let phaseLimit;
+            let phaseTokens;
+            if (this.currentPhase === 'discovery' && phaseLimits.discovery) {
+                phaseLimit = phaseLimits.discovery;
+                phaseTokens = this.getPhaseTokens(run, 'discovery');
+            }
+            else if (this.currentPhase === 'analysis' && phaseLimits.analysis) {
+                phaseLimit = phaseLimits.analysis;
+                phaseTokens = this.getPhaseTokens(run, 'analysis');
+            }
+            else if (this.currentPhase === 'sanityChecks' && phaseLimits.sanityChecks) {
+                phaseLimit = phaseLimits.sanityChecks;
+                phaseTokens = this.getPhaseTokens(run, 'sanityChecks');
+            }
+            if (phaseLimit && phaseTokens !== undefined && phaseTokens >= phaseLimit) {
+                if (this.config.stopOnExceeded !== false) {
+                    exceedances.push({
+                        type: 'tokens_per_phase',
+                        phase: this.currentPhase,
+                        limit: phaseLimit,
+                        actual: phaseTokens,
+                        unit: 'tokens'
+                    });
+                    return this.createStopResult(`Phase token limit exceeded (${this.currentPhase}): ${phaseTokens.toLocaleString()} / ${phaseLimit.toLocaleString()} tokens`, warnings, exceedances);
+                }
+            }
+        }
+        // 3. Check per-iteration limits
+        if (this.currentIteration > 0 && this.config.maxTokensPerIteration) {
+            const iterationTokens = this.getCurrentIterationTokens(run);
+            if (iterationTokens >= this.config.maxTokensPerIteration) {
+                if (this.config.stopOnExceeded !== false) {
+                    exceedances.push({
+                        type: 'tokens_per_iteration',
+                        iteration: this.currentIteration,
+                        limit: this.config.maxTokensPerIteration,
+                        actual: iterationTokens,
+                        unit: 'tokens'
+                    });
+                    return this.createStopResult(`Iteration token limit exceeded (iteration ${this.currentIteration}): ${iterationTokens.toLocaleString()} / ${this.config.maxTokensPerIteration.toLocaleString()} tokens`, warnings, exceedances);
+                }
+            }
+        }
+        if (this.currentIteration > 0 && this.iterationStartTime && this.config.maxIterationDurationSeconds) {
+            const iterationDuration = (Date.now() - this.iterationStartTime) / 1000;
+            if (iterationDuration >= this.config.maxIterationDurationSeconds) {
+                if (this.config.stopOnExceeded !== false) {
+                    exceedances.push({
+                        type: 'iteration_duration',
+                        iteration: this.currentIteration,
+                        limit: this.config.maxIterationDurationSeconds,
+                        actual: Math.round(iterationDuration),
+                        unit: 'seconds'
+                    });
+                    return this.createStopResult(`Iteration duration exceeded (iteration ${this.currentIteration}): ${Math.round(iterationDuration)}s / ${this.config.maxIterationDurationSeconds}s`, warnings, exceedances);
+                }
+            }
+        }
+        // 4. Check warning thresholds
+        if (this.config.maxTokensPerRun) {
+            const tokenPercent = (totalTokens / this.config.maxTokensPerRun) * 100;
+            if (tokenPercent >= tokenWarnPercent) {
+                warnings.push({
+                    type: 'tokens_per_run',
+                    percentage: Math.round(tokenPercent),
+                    message: `Token usage at ${Math.round(tokenPercent)}% (${totalTokens.toLocaleString()} / ${this.config.maxTokensPerRun.toLocaleString()})`
+                });
+            }
+        }
+        if (this.config.maxDurationSeconds) {
+            const durationPercent = (elapsedSeconds / this.config.maxDurationSeconds) * 100;
+            if (durationPercent >= durationWarnPercent) {
+                warnings.push({
+                    type: 'duration',
+                    percentage: Math.round(durationPercent),
+                    message: `Duration at ${Math.round(durationPercent)}% (${Math.round(elapsedSeconds)}s / ${this.config.maxDurationSeconds}s)`
+                });
+            }
+        }
+        if (this.config.maxCostDollars) {
+            const costPercent = (totalCost / this.config.maxCostDollars) * 100;
+            if (costPercent >= costWarnPercent) {
+                warnings.push({
+                    type: 'cost',
+                    percentage: Math.round(costPercent),
+                    message: `Cost at ${Math.round(costPercent)}% ($${totalCost.toFixed(2)} / $${this.config.maxCostDollars.toFixed(2)})`
+                });
+            }
+        }
+        if (this.currentPhase && this.config.maxTokensPerPhase) {
+            const phaseLimits = this.config.maxTokensPerPhase;
+            let phaseLimit;
+            let phaseTokens;
+            if (this.currentPhase === 'discovery' && phaseLimits.discovery) {
+                phaseLimit = phaseLimits.discovery;
+                phaseTokens = this.getPhaseTokens(run, 'discovery');
+            }
+            else if (this.currentPhase === 'analysis' && phaseLimits.analysis) {
+                phaseLimit = phaseLimits.analysis;
+                phaseTokens = this.getPhaseTokens(run, 'analysis');
+            }
+            else if (this.currentPhase === 'sanityChecks' && phaseLimits.sanityChecks) {
+                phaseLimit = phaseLimits.sanityChecks;
+                phaseTokens = this.getPhaseTokens(run, 'sanityChecks');
+            }
+            if (phaseLimit && phaseTokens !== undefined) {
+                const phaseTokenPercent = (phaseTokens / phaseLimit) * 100;
+                if (phaseTokenPercent >= phaseTokenWarnPercent) {
+                    warnings.push({
+                        type: 'tokens_per_phase',
+                        phase: this.currentPhase,
+                        percentage: Math.round(phaseTokenPercent),
+                        message: `Phase token usage at ${Math.round(phaseTokenPercent)}% (${phaseTokens.toLocaleString()} / ${phaseLimit.toLocaleString()})`
+                    });
+                }
+            }
+        }
+        if (this.currentIteration > 0 && this.config.maxTokensPerIteration) {
+            const iterationTokens = this.getCurrentIterationTokens(run);
+            const iterationTokenPercent = (iterationTokens / this.config.maxTokensPerIteration) * 100;
+            if (iterationTokenPercent >= iterationTokenWarnPercent) {
+                warnings.push({
+                    type: 'tokens_per_iteration',
+                    iteration: this.currentIteration,
+                    percentage: Math.round(iterationTokenPercent),
+                    message: `Iteration token usage at ${Math.round(iterationTokenPercent)}% (${iterationTokens.toLocaleString()} / ${this.config.maxTokensPerIteration.toLocaleString()})`
+                });
+            }
+        }
+        return {
+            canContinue: true,
+            warnings: warnings.length > 0 ? warnings : undefined,
+            exceedances: exceedances.length > 0 ? exceedances : undefined
+        };
+    }
+    /**
+     * Record guardrail enforcement in the run
+     */
+    recordEnforcement(run, result) {
+        if (!result.warnings && !result.exceedances && result.canContinue) {
+            return; // Nothing to record
+        }
+        if (!run.guardrailsEnforced) {
+            run.guardrailsEnforced = {
+                exceedances: [],
+                warnings: []
+            };
+        }
+        if (result.exceedances) {
+            run.guardrailsEnforced.exceedances.push(...result.exceedances);
+            run.guardrailsEnforced.stoppedDueToGuardrails = true;
+            run.guardrailsEnforced.stoppedReason = result.reason;
+        }
+        if (result.warnings) {
+            run.guardrailsEnforced.warnings.push(...result.warnings);
+        }
+    }
+    /**
+     * Get tokens used in a specific phase
+     */
+    getPhaseTokens(run, phase) {
+        if (!run.phaseMetrics)
+            return 0;
+        if (phase === 'discovery') {
+            return run.phaseMetrics.discovery?.tokensUsed || 0;
+        }
+        else if (phase === 'analysis') {
+            return run.phaseMetrics.analysis?.tokensUsed || 0;
+        }
+        else if (phase === 'sanityChecks') {
+            return run.phaseMetrics.sanityChecks?.tokensUsed || 0;
+        }
+        return 0;
+    }
+    /**
+     * Get estimated cost for a specific phase
+     */
+    getPhaseCost(run, phase) {
+        if (!run.phaseMetrics)
+            return 0;
+        if (phase === 'discovery') {
+            return run.phaseMetrics.discovery?.estimatedCost || 0;
+        }
+        else if (phase === 'analysis') {
+            return run.phaseMetrics.analysis?.estimatedCost || 0;
+        }
+        else if (phase === 'sanityChecks') {
+            return run.phaseMetrics.sanityChecks?.estimatedCost || 0;
+        }
+        return 0;
+    }
+    /**
+     * Get tokens used in current iteration
+     */
+    getCurrentIterationTokens(run) {
+        if (!run.iterationMetrics || run.iterationMetrics.length === 0) {
+            return 0;
+        }
+        // Return tokens for current iteration only (latest entry)
+        const currentMetric = run.iterationMetrics[run.iterationMetrics.length - 1];
+        return currentMetric.tokensUsed || 0;
+    }
+    /**
+     * Create a stop result with warnings and exceedances
+     */
+    createStopResult(reason, warnings, exceedances) {
+        return {
+            canContinue: false,
+            reason,
+            warnings: warnings.length > 0 ? warnings : undefined,
+            exceedances: exceedances.length > 0 ? exceedances : undefined
+        };
+    }
+    /**
+     * Get current elapsed time in seconds
+     */
+    getElapsedSeconds() {
+        return (Date.now() - this.startTime) / 1000;
+    }
+    /**
+     * Get current phase token budget (remaining tokens)
+     */
+    getPhaseTokenBudgetRemaining(phase) {
+        if (!this.config.maxTokensPerPhase)
+            return undefined;
+        const limit = this.config.maxTokensPerPhase[phase];
+        if (!limit)
+            return undefined;
+        // This would need access to the current run to calculate remaining
+        // For now, just return the limit
+        return limit;
+    }
+}
+exports.GuardrailsManager = GuardrailsManager;
+//# sourceMappingURL=GuardrailsManager.js.map

package/dist/core/GuardrailsManager.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Exports for core module
+ */
+export { AnalysisEngine } from './AnalysisEngine.js';
+export { BackpropagationEngine } from './BackpropagationEngine.js';
+export { ConvergenceDetector } from './ConvergenceDetector.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Exports for core module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConvergenceDetector = exports.BackpropagationEngine = exports.AnalysisEngine = void 0;
+var AnalysisEngine_js_1 = require("./AnalysisEngine.js");
+Object.defineProperty(exports, "AnalysisEngine", { enumerable: true, get: function () { return AnalysisEngine_js_1.AnalysisEngine; } });
+var BackpropagationEngine_js_1 = require("./BackpropagationEngine.js");
+Object.defineProperty(exports, "BackpropagationEngine", { enumerable: true, get: function () { return BackpropagationEngine_js_1.BackpropagationEngine; } });
+var ConvergenceDetector_js_1 = require("./ConvergenceDetector.js");
+Object.defineProperty(exports, "ConvergenceDetector", { enumerable: true, get: function () { return ConvergenceDetector_js_1.ConvergenceDetector; } });
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yDAAqD;AAA5C,mHAAA,cAAc,OAAA;AACvB,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAC9B,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA"}

package/dist/database/Database.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Database connection and introspection classes
+ * Primary interface for all database operations
+ */
+import { BaseAutoDocDriver } from '../drivers/BaseAutoDocDriver.js';
+import { AutoDocConnectionConfig } from '../types/driver.js';
+import { SchemaDefinition, ColumnDefinition } from '../types/state.js';
+import { SchemaFilterConfig, TableFilterConfig, AnalysisConfig } from '../types/config.js';
+import '../drivers/SQLServerDriver.js';
+import '../drivers/MySQLDriver.js';
+import '../drivers/PostgreSQLDriver.js';
+/**
+ * Create a database driver instance
+ */
+export declare function createDriver(config: AutoDocConnectionConfig): BaseAutoDocDriver;
+/**
+ * Database connection class
+ * Provides connection management and query execution
+ */
+export declare class DatabaseConnection {
+    private driver;
+    constructor(dbConfig: AutoDocConnectionConfig);
+    connect(): Promise<void>;
+    test(): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    query<T = any>(queryText: string, maxRetries?: number): Promise<{
+        success: boolean;
+        data?: T[];
+        errorMessage?: string;
+    }>;
+    close(): Promise<void>;
+    getDriver(): BaseAutoDocDriver;
+}
+/**
+ * Database introspector
+ * Retrieves schema and table information from the database
+ */
+export declare class Introspector {
+    private driver;
+    constructor(driver: BaseAutoDocDriver);
+    getSchemas(schemaFilter: SchemaFilterConfig, tableFilter: TableFilterConfig): Promise<SchemaDefinition[]>;
+    getExistingDescriptions(schemaName: string, tableName: string): Promise<Map<string, string>>;
+}
+/**
+ * Data sampler
+ * Analyzes table data and gathers column statistics
+ */
+export declare class DataSampler {
+    private driver;
+    private config;
+    constructor(driver: BaseAutoDocDriver, config: AnalysisConfig);
+    analyzeTable(schemaName: string, tableName: string, columns: ColumnDefinition[]): Promise<void>;
+}
+//# sourceMappingURL=Database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../../src/database/Database.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAmB,gBAAgB,EAAuB,MAAM,mBAAmB,CAAC;AAC7G,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,+BAA+B,CAAC;AACvC,OAAO,2BAA2B,CAAC;AACnC,OAAO,gCAAgC,CAAC;AAExC;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAiB/E;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAoB;gBAEtB,QAAQ,EAAE,uBAAuB;IAIhC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAItD,KAAK,CAAC,CAAC,GAAG,GAAG,EACxB,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAItD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,SAAS,IAAI,iBAAiB;CAGtC;AAED;;;GAGG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAEhC,UAAU,CACrB,YAAY,EAAE,kBAAkB,EAChC,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAuEjB,uBAAuB,CAClC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAWhC;AAED;;;GAGG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;gBADN,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,cAAc;IAGnB,YAAY,CACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,EAAE,GAC1B,OAAO,CAAC,IAAI,CAAC;CAkCjB"}

package/dist/database/Database.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * Database connection and introspection classes
+ * Primary interface for all database operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataSampler = exports.Introspector = exports.DatabaseConnection = exports.createDriver = void 0;
+const global_1 = require("@memberjunction/global");
+const BaseAutoDocDriver_js_1 = require("../drivers/BaseAutoDocDriver.js");
+require("../drivers/SQLServerDriver.js"); // Import to ensure registration
+require("../drivers/MySQLDriver.js"); // Import to ensure registration
+require("../drivers/PostgreSQLDriver.js"); // Import to ensure registration
+/**
+ * Create a database driver instance
+ */
+function createDriver(config) {
+    const providerKey = config.provider === 'sqlserver' || !config.provider ? 'SQLServer' :
+        config.provider === 'mysql' ? 'MySQL' :
+            config.provider === 'postgresql' ? 'PostgreSQL' :
+                config.provider === 'oracle' ? 'Oracle' : 'SQLServer';
+    const driver = global_1.MJGlobal.Instance.ClassFactory.CreateInstance(BaseAutoDocDriver_js_1.BaseAutoDocDriver, providerKey, config);
+    if (!driver) {
+        throw new Error(`Database provider '${providerKey}' is not registered`);
+    }
+    return driver;
+}
+exports.createDriver = createDriver;
+/**
+ * Database connection class
+ * Provides connection management and query execution
+ */
+class DatabaseConnection {
+    constructor(dbConfig) {
+        this.driver = createDriver(dbConfig);
+    }
+    async connect() {
+        await this.driver.connect();
+    }
+    async test() {
+        return await this.driver.test();
+    }
+    async query(queryText, maxRetries = 3) {
+        return await this.driver.executeQuery(queryText, maxRetries);
+    }
+    async close() {
+        await this.driver.close();
+    }
+    // Expose the underlying driver for advanced usage
+    getDriver() {
+        return this.driver;
+    }
+}
+exports.DatabaseConnection = DatabaseConnection;
+/**
+ * Database introspector
+ * Retrieves schema and table information from the database
+ */
+class Introspector {
+    constructor(driver) {
+        this.driver = driver;
+    }
+    async getSchemas(schemaFilter, tableFilter) {
+        const autoDocSchemas = await this.driver.getSchemas(schemaFilter, tableFilter);
+        // Convert AutoDocSchema[] to SchemaDefinition[]
+        const schemas = [];
+        for (const autoDocSchema of autoDocSchemas) {
+            const tables = [];
+            for (const autoDocTable of autoDocSchema.tables) {
+                // Convert foreign keys to dependsOn/dependents format
+                const dependsOn = autoDocTable.foreignKeys.map(fk => ({
+                    schema: fk.referencedSchema,
+                    table: fk.referencedTable,
+                    column: fk.columnName,
+                    referencedColumn: fk.referencedColumn
+                }));
+                // Convert columns
+                const columns = autoDocTable.columns.map(col => ({
+                    name: col.name,
+                    dataType: col.dataType,
+                    isNullable: col.isNullable,
+                    isPrimaryKey: col.isPrimaryKey,
+                    isForeignKey: col.isForeignKey,
+                    checkConstraint: col.checkConstraint,
+                    defaultValue: col.defaultValue,
+                    descriptionIterations: []
+                }));
+                tables.push({
+                    name: autoDocTable.tableName,
+                    rowCount: autoDocTable.rowCount,
+                    dependsOn,
+                    dependents: [], // Will be populated later
+                    columns,
+                    descriptionIterations: []
+                });
+            }
+            schemas.push({
+                name: autoDocSchema.name,
+                tables,
+                descriptionIterations: []
+            });
+        }
+        // Populate dependents (reverse FKs)
+        for (const schema of schemas) {
+            for (const table of schema.tables) {
+                for (const dep of table.dependsOn) {
+                    const parentSchema = schemas.find(s => s.name === dep.schema);
+                    if (parentSchema) {
+                        const parentTable = parentSchema.tables.find(t => t.name === dep.table);
+                        if (parentTable) {
+                            if (!parentTable.dependents.some(d => d.schema === schema.name && d.table === table.name)) {
+                                parentTable.dependents.push({
+                                    schema: schema.name,
+                                    table: table.name,
+                                    column: dep.referencedColumn,
+                                    referencedColumn: dep.column
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return schemas;
+    }
+    async getExistingDescriptions(schemaName, tableName) {
+        const descriptions = await this.driver.getExistingDescriptions(schemaName, tableName);
+        const map = new Map();
+        for (const desc of descriptions) {
+            const key = desc.target === 'table' ? '__TABLE__' : desc.targetName;
+            map.set(key, desc.description);
+        }
+        return map;
+    }
+}
+exports.Introspector = Introspector;
+/**
+ * Data sampler
+ * Analyzes table data and gathers column statistics
+ */
+class DataSampler {
+    constructor(driver, config) {
+        this.driver = driver;
+        this.config = config;
+    }
+    async analyzeTable(schemaName, tableName, columns) {
+        for (const column of columns) {
+            const stats = await this.driver.getColumnStatistics(schemaName, tableName, column.name, column.dataType, this.config.cardinalityThreshold, this.config.sampleSize);
+            // Convert AutoDocColumnStatistics to ColumnStatistics
+            column.statistics = {
+                totalRows: stats.totalRows,
+                distinctCount: stats.distinctCount,
+                uniquenessRatio: stats.uniquenessRatio,
+                nullCount: stats.nullCount,
+                nullPercentage: stats.nullPercentage,
+                sampleValues: stats.sampleValues,
+                min: stats.min,
+                max: stats.max,
+                avg: stats.avg,
+                stdDev: stats.stdDev,
+                avgLength: stats.avgLength,
+                maxLength: stats.maxLength,
+                minLength: stats.minLength
+            };
+            // Set possible values if low cardinality
+            if (stats.valueDistribution && stats.valueDistribution.length > 0) {
+                column.possibleValues = stats.valueDistribution.map(v => v.value);
+            }
+        }
+    }
+}
+exports.DataSampler = DataSampler;
+//# sourceMappingURL=Database.js.map

package/dist/database/Database.js.map

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