@memberjunction/db-auto-doc 2.117.0 → 2.118.0

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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"}

package/dist/database/TopologicalSorter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Topological sorting of database tables based on foreign key dependencies
+ * Implements Kahn's algorithm
+ */
+import { SchemaDefinition } from '../types/state.js';
+import { DependencyGraph, TableNode } from '../types/analysis.js';
+export declare class TopologicalSorter {
+    /**
+     * Build dependency graph and sort topologically
+     */
+    buildAndSort(schemas: SchemaDefinition[]): DependencyGraph;
+    /**
+     * Build dependency graph from schemas
+     */
+    private buildGraph;
+    /**
+     * Perform topological sort using Kahn's algorithm
+     */
+    private sort;
+    /**
+     * Detect cycles in the dependency graph
+     */
+    detectCycles(nodes: Map<string, TableNode>): string[][];
+}
+//# sourceMappingURL=TopologicalSorter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TopologicalSorter.d.ts","sourceRoot":"","sources":["../../src/database/TopologicalSorter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAmB,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAElE,qBAAa,iBAAiB;IAC5B;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,eAAe;IAUjE;;OAEG;IACH,OAAO,CAAC,UAAU;IAyClB;;OAEG;IACH,OAAO,CAAC,IAAI;IAsEZ;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,EAAE,EAAE;CAiC/D"}

package/dist/database/TopologicalSorter.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * Topological sorting of database tables based on foreign key dependencies
+ * Implements Kahn's algorithm
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopologicalSorter = void 0;
+class TopologicalSorter {
+    /**
+     * Build dependency graph and sort topologically
+     */
+    buildAndSort(schemas) {
+        // Build graph from schemas
+        const nodes = this.buildGraph(schemas);
+        // Perform topological sort
+        const levels = this.sort(nodes);
+        return { nodes, levels };
+    }
+    /**
+     * Build dependency graph from schemas
+     */
+    buildGraph(schemas) {
+        const nodes = new Map();
+        // Create all nodes first
+        for (const schema of schemas) {
+            for (const table of schema.tables) {
+                const fullName = `${schema.name}.${table.name}`;
+                nodes.set(fullName, {
+                    schema: schema.name,
+                    table: table.name,
+                    fullName,
+                    dependsOn: [],
+                    dependents: [],
+                    level: -1,
+                    tableDefinition: table
+                });
+            }
+        }
+        // Wire up dependencies
+        for (const schema of schemas) {
+            for (const table of schema.tables) {
+                const fullName = `${schema.name}.${table.name}`;
+                const node = nodes.get(fullName);
+                // Add dependencies
+                for (const dep of table.dependsOn) {
+                    const depFullName = `${dep.schema}.${dep.table}`;
+                    const depNode = nodes.get(depFullName);
+                    if (depNode) {
+                        node.dependsOn.push(depNode);
+                        depNode.dependents.push(node);
+                    }
+                }
+            }
+        }
+        return nodes;
+    }
+    /**
+     * Perform topological sort using Kahn's algorithm
+     */
+    sort(nodes) {
+        const levels = [];
+        const inDegree = new Map();
+        const processed = new Set();
+        // Calculate in-degrees
+        for (const [fullName, node] of nodes) {
+            inDegree.set(fullName, node.dependsOn.length);
+        }
+        let currentLevel = 0;
+        while (processed.size < nodes.size) {
+            // Find all nodes with in-degree 0 (no unprocessed dependencies)
+            const currentLevelNodes = [];
+            for (const [fullName, node] of nodes) {
+                if (!processed.has(fullName) && inDegree.get(fullName) === 0) {
+                    currentLevelNodes.push(node);
+                    node.level = currentLevel;
+                }
+            }
+            // Check for cycles
+            if (currentLevelNodes.length === 0 && processed.size < nodes.size) {
+                // We have a cycle - find remaining nodes and assign them to current level
+                const remaining = [];
+                for (const [fullName, node] of nodes) {
+                    if (!processed.has(fullName)) {
+                        node.level = currentLevel;
+                        remaining.push(node);
+                    }
+                }
+                if (remaining.length > 0) {
+                    levels.push(remaining);
+                }
+                break;
+            }
+            // Add current level to results
+            if (currentLevelNodes.length > 0) {
+                levels.push(currentLevelNodes);
+                // Mark nodes as processed
+                for (const node of currentLevelNodes) {
+                    processed.add(node.fullName);
+                    // Decrement in-degree for dependents
+                    for (const dependent of node.dependents) {
+                        const currentInDegree = inDegree.get(dependent.fullName);
+                        inDegree.set(dependent.fullName, currentInDegree - 1);
+                    }
+                }
+            }
+            currentLevel++;
+        }
+        // Update table definitions with dependency level
+        for (const [fullName, node] of nodes) {
+            if (node.tableDefinition) {
+                node.tableDefinition.dependencyLevel = node.level;
+            }
+        }
+        return levels;
+    }
+    /**
+     * Detect cycles in the dependency graph
+     */
+    detectCycles(nodes) {
+        const cycles = [];
+        const visited = new Set();
+        const recursionStack = new Set();
+        const dfs = (node, path) => {
+            visited.add(node.fullName);
+            recursionStack.add(node.fullName);
+            path.push(node.fullName);
+            for (const dep of node.dependsOn) {
+                if (!visited.has(dep.fullName)) {
+                    dfs(dep, [...path]);
+                }
+                else if (recursionStack.has(dep.fullName)) {
+                    // Found a cycle
+                    const cycleStart = path.indexOf(dep.fullName);
+                    const cycle = path.slice(cycleStart);
+                    cycle.push(dep.fullName);
+                    cycles.push(cycle);
+                }
+            }
+            recursionStack.delete(node.fullName);
+        };
+        for (const [fullName, node] of nodes) {
+            if (!visited.has(fullName)) {
+                dfs(node, []);
+            }
+        }
+        return cycles;
+    }
+}
+exports.TopologicalSorter = TopologicalSorter;
+//# sourceMappingURL=TopologicalSorter.js.map

package/dist/database/TopologicalSorter.js.map

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

package/dist/database/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Exports for database module
+ */
+export { DatabaseConnection, Introspector, DataSampler, createDriver } from './Database.js';
+export { TopologicalSorter } from './TopologicalSorter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/database/index.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Exports for database module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopologicalSorter = exports.createDriver = exports.DataSampler = exports.Introspector = exports.DatabaseConnection = void 0;
+var Database_js_1 = require("./Database.js");
+Object.defineProperty(exports, "DatabaseConnection", { enumerable: true, get: function () { return Database_js_1.DatabaseConnection; } });
+Object.defineProperty(exports, "Introspector", { enumerable: true, get: function () { return Database_js_1.Introspector; } });
+Object.defineProperty(exports, "DataSampler", { enumerable: true, get: function () { return Database_js_1.DataSampler; } });
+Object.defineProperty(exports, "createDriver", { enumerable: true, get: function () { return Database_js_1.createDriver; } });
+var TopologicalSorter_js_1 = require("./TopologicalSorter.js");
+Object.defineProperty(exports, "TopologicalSorter", { enumerable: true, get: function () { return TopologicalSorter_js_1.TopologicalSorter; } });
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6CAA4F;AAAnF,iHAAA,kBAAkB,OAAA;AAAE,2GAAA,YAAY,OAAA;AAAE,0GAAA,WAAW,OAAA;AAAE,2GAAA,YAAY,OAAA;AACpE,+DAA2D;AAAlD,yHAAA,iBAAiB,OAAA"}

package/dist/discovery/ColumnStatsCache.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Column Statistics Cache
+ * Stores pre-computed column statistics to avoid redundant database queries
+ * Used across discovery and analysis phases
+ */
+import { CachedColumnStats, TableStatsCache } from '../types/discovery.js';
+export declare class ColumnStatsCache {
+    private tableCache;
+    /**
+     * Get table key for cache lookup
+     */
+    private getTableKey;
+    /**
+     * Get column key for cache lookup
+     */
+    private getColumnKey;
+    /**
+     * Store column statistics
+     */
+    setColumnStats(stats: CachedColumnStats): void;
+    /**
+     * Get column statistics
+     */
+    getColumnStats(schemaName: string, tableName: string, columnName: string): CachedColumnStats | undefined;
+    /**
+     * Get all column statistics for a table
+     */
+    getTableStats(schemaName: string, tableName: string): TableStatsCache | undefined;
+    /**
+     * Get all columns in a table
+     */
+    getTableColumns(schemaName: string, tableName: string): CachedColumnStats[];
+    /**
+     * Check if column stats exist
+     */
+    hasColumnStats(schemaName: string, tableName: string, columnName: string): boolean;
+    /**
+     * Check if table stats exist
+     */
+    hasTableStats(schemaName: string, tableName: string): boolean;
+    /**
+     * Get all tables with cached stats
+     */
+    getAllTables(): TableStatsCache[];
+    /**
+     * Find columns matching a pattern across all tables
+     * Useful for finding potential FK relationships
+     */
+    findColumnsMatching(predicate: (stats: CachedColumnStats) => boolean): CachedColumnStats[];
+    /**
+     * Find columns with similar names across tables
+     * Example: Find all columns named "*_id" or "*ID"
+     */
+    findColumnsByNamePattern(pattern: RegExp): CachedColumnStats[];
+    /**
+     * Find highly unique columns (potential PKs)
+     */
+    findUniqueColumns(minUniqueness?: number): CachedColumnStats[];
+    /**
+     * Find columns with same name across multiple tables
+     * Returns Map of columnName -> array of CachedColumnStats
+     */
+    findDuplicateColumnNames(): Map<string, CachedColumnStats[]>;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        totalTables: number;
+        totalColumns: number;
+        totalStatsBytes: number;
+        avgColumnsPerTable: number;
+    };
+    /**
+     * Clear all cached stats
+     */
+    clear(): void;
+    /**
+     * Export cache to JSON for persistence in state file
+     */
+    toStateJSON(): import('../types/state.js').ColumnStatisticsCache;
+    /**
+     * Import cache from state JSON
+     */
+    fromStateJSON(data: import('../types/state.js').ColumnStatisticsCache): void;
+    /**
+     * Merge cached stats into schema column definitions
+     * Replaces separate columnStatistics cache with embedded stats
+     */
+    mergeIntoSchemas(schemas: import('../types/state.js').SchemaDefinition[]): void;
+}
+//# sourceMappingURL=ColumnStatsCache.d.ts.map

package/dist/discovery/ColumnStatsCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnStatsCache.d.ts","sourceRoot":"","sources":["../../src/discovery/ColumnStatsCache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE3E,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAA2C;IAE7D;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACI,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAkBrD;;OAEG;IACI,cAAc,CACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,iBAAiB,GAAG,SAAS;IAMhC;;OAEG;IACI,aAAa,CAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,eAAe,GAAG,SAAS;IAK9B;;OAEG;IACI,eAAe,CACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,iBAAiB,EAAE;IAKtB;;OAEG;IACI,cAAc,CACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO;IAIV;;OAEG;IACI,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAIpE;;OAEG;IACI,YAAY,IAAI,eAAe,EAAE;IAIxC;;;OAGG;IACI,mBAAmB,CACxB,SAAS,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,GAC/C,iBAAiB,EAAE;IActB;;;OAGG;IACI,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAIrE;;OAEG;IACI,iBAAiB,CAAC,aAAa,GAAE,MAAa,GAAG,iBAAiB,EAAE;IAM3E;;;OAGG;IACI,wBAAwB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAiBnE;;OAEG;IACI,aAAa,IAAI;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,MAAM,CAAC;KAC5B;IAmBD;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,WAAW,IAAI,OAAO,mBAAmB,EAAE,qBAAqB;IA2BvE;;OAEG;IACI,aAAa,CAAC,IAAI,EAAE,OAAO,mBAAmB,EAAE,qBAAqB,GAAG,IAAI;IAmBnF;;;OAGG;IACI,gBAAgB,CAAC,OAAO,EAAE,OAAO,mBAAmB,EAAE,gBAAgB,EAAE,GAAG,IAAI;CAgCvF"}