@memberjunction/db-auto-doc 2.116.0 → 2.118.0

package/dist/drivers/BaseAutoDocDriver.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Base database driver for DBAutoDoc
+ * Defines abstract interface for all database providers
+ */
+import { AutoDocSchema, AutoDocTable, AutoDocColumn, AutoDocConnectionConfig, AutoDocQueryResult, AutoDocConnectionTestResult, AutoDocSchemaFilter, AutoDocTableFilter, AutoDocColumnStatistics, AutoDocExistingDescription } from '../types/driver.js';
+/**
+ * Abstract base class for database drivers
+ * All provider-specific implementations must extend this class
+ */
+export declare abstract class BaseAutoDocDriver {
+    protected config: AutoDocConnectionConfig;
+    constructor(config: AutoDocConnectionConfig);
+    /**
+     * Connect to the database
+     */
+    abstract connect(): Promise<void>;
+    /**
+     * Test database connectivity
+     */
+    abstract test(): Promise<AutoDocConnectionTestResult>;
+    /**
+     * Close database connection
+     */
+    abstract close(): Promise<void>;
+    /**
+     * Get all schemas with filtered tables
+     */
+    abstract getSchemas(schemaFilter: AutoDocSchemaFilter, tableFilter: AutoDocTableFilter): Promise<AutoDocSchema[]>;
+    /**
+     * Get all tables in a schema
+     */
+    protected abstract getTables(schemaName: string, tableFilter: AutoDocTableFilter): Promise<AutoDocTable[]>;
+    /**
+     * Get all columns for a table
+     */
+    protected abstract getColumns(schemaName: string, tableName: string): Promise<AutoDocColumn[]>;
+    /**
+     * Get existing descriptions from database metadata
+     * (e.g., MS_Description for SQL Server, COMMENT for MySQL/PostgreSQL)
+     */
+    abstract getExistingDescriptions(schemaName: string, tableName: string): Promise<AutoDocExistingDescription[]>;
+    /**
+     * Get column statistics (cardinality, null count, etc.)
+     */
+    abstract getColumnStatistics(schemaName: string, tableName: string, columnName: string, dataType: string, cardinalityThreshold: number, sampleSize: number): Promise<AutoDocColumnStatistics>;
+    /**
+     * Get distinct value count for a column
+     */
+    protected abstract getDistinctCount(schemaName: string, tableName: string, columnName: string): Promise<number>;
+    /**
+     * Get value distribution for low-cardinality columns
+     */
+    protected abstract getValueDistribution(schemaName: string, tableName: string, columnName: string, limit: number): Promise<Array<{
+        value: any;
+        frequency: number;
+    }>>;
+    /**
+     * Get sample values from a column
+     */
+    protected abstract getSampleValues(schemaName: string, tableName: string, columnName: string, sampleSize: number): Promise<any[]>;
+    /**
+     * Get simplified column statistics for discovery
+     * Uses existing getColumnStatistics but with simpler parameters
+     */
+    getColumnStatisticsForDiscovery(schemaName: string, tableName: string, columnName: string, columnType: string, maxSampleSize?: number): Promise<import('../types/discovery.js').ColumnStatistics>;
+    /**
+     * Get column information (for FK detection)
+     */
+    abstract getColumnInfo(schemaName: string, tableName: string, columnName: string): Promise<{
+        name: string;
+        type: string;
+        nullable: boolean;
+    }>;
+    /**
+     * Test value overlap between two columns (for FK detection)
+     * Returns percentage of source values that exist in target (0-1)
+     */
+    abstract testValueOverlap(sourceTable: string, // format: "schema.table"
+    sourceColumn: string, targetTable: string, // format: "schema.table"
+    targetColumn: string, sampleSize: number): Promise<number>;
+    /**
+     * Check if a combination of columns is unique (for composite PK detection)
+     */
+    abstract checkColumnCombinationUniqueness(schemaName: string, tableName: string, columnNames: string[], sampleSize: number): Promise<boolean>;
+    /**
+     * Execute a raw SQL query
+     * @param query SQL query to execute
+     * @param maxRetries Number of retry attempts for transient errors
+     */
+    abstract executeQuery<T = any>(query: string, maxRetries?: number): Promise<AutoDocQueryResult<T>>;
+    /**
+     * Escape identifier (schema, table, column names)
+     * Each provider has different quoting rules
+     */
+    protected abstract escapeIdentifier(identifier: string): string;
+    /**
+     * Get SQL for limiting result set
+     * Different providers use different syntax (TOP, LIMIT, ROWNUM)
+     */
+    protected abstract getLimitClause(limit: number): string;
+    /**
+     * Check if data type is numeric
+     */
+    protected isNumericType(dataType: string): boolean;
+    /**
+     * Check if data type is date/time
+     */
+    protected isDateType(dataType: string): boolean;
+    /**
+     * Check if data type is string/text
+     */
+    protected isStringType(dataType: string): boolean;
+    /**
+     * Sleep for specified milliseconds (for retry logic)
+     */
+    protected sleep(ms: number): Promise<void>;
+    /**
+     * Build schema filter WHERE clause
+     * Helper method for constructing SQL filters
+     */
+    protected buildSchemaFilterClause(filter: AutoDocSchemaFilter, schemaColumnName: string): string;
+    /**
+     * Build table filter WHERE clause
+     * Helper method for constructing SQL filters
+     */
+    protected buildTableFilterClause(filter: AutoDocTableFilter, tableColumnName: string): string;
+    /**
+     * Get database provider name
+     */
+    getProviderName(): string;
+}
+//# sourceMappingURL=BaseAutoDocDriver.d.ts.map

package/dist/drivers/BaseAutoDocDriver.d.ts.map

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

package/dist/drivers/BaseAutoDocDriver.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Base database driver for DBAutoDoc
+ * Defines abstract interface for all database providers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseAutoDocDriver = void 0;
+/**
+ * Abstract base class for database drivers
+ * All provider-specific implementations must extend this class
+ */
+class BaseAutoDocDriver {
+    constructor(config) {
+        this.config = config;
+    }
+    // ============================================================================
+    // RELATIONSHIP DISCOVERY METHODS
+    // ============================================================================
+    /**
+     * Get simplified column statistics for discovery
+     * Uses existing getColumnStatistics but with simpler parameters
+     */
+    async getColumnStatisticsForDiscovery(schemaName, tableName, columnName, columnType, maxSampleSize = 1000) {
+        const stats = await this.getColumnStatistics(schemaName, tableName, columnName, columnType, 100, // cardinalityThreshold
+        maxSampleSize);
+        // Calculate total rows from null percentage if available
+        const totalRows = stats.nullCount > 0 && stats.nullPercentage > 0
+            ? Math.round(stats.nullCount / stats.nullPercentage)
+            : stats.nullCount + stats.distinctCount; // Estimate
+        return {
+            columnName,
+            dataType: columnType,
+            totalRows,
+            nullCount: stats.nullCount,
+            distinctCount: stats.distinctCount,
+            minValue: stats.min,
+            maxValue: stats.max,
+            avgLength: stats.avgLength,
+            sampleValues: stats.sampleValues || []
+        };
+    }
+    /**
+     * Check if data type is numeric
+     */
+    isNumericType(dataType) {
+        const numericTypes = [
+            'int', 'integer', 'bigint', 'smallint', 'tinyint',
+            'decimal', 'numeric', 'float', 'real', 'double',
+            'money', 'smallmoney', 'number'
+        ];
+        return numericTypes.some(type => dataType.toLowerCase().includes(type));
+    }
+    /**
+     * Check if data type is date/time
+     */
+    isDateType(dataType) {
+        const dateTypes = [
+            'date', 'time', 'datetime', 'datetime2', 'timestamp',
+            'smalldatetime', 'datetimeoffset', 'timestamptz'
+        ];
+        return dateTypes.some(type => dataType.toLowerCase().includes(type));
+    }
+    /**
+     * Check if data type is string/text
+     */
+    isStringType(dataType) {
+        const stringTypes = [
+            'char', 'varchar', 'text', 'nchar', 'nvarchar', 'ntext',
+            'string', 'clob', 'mediumtext', 'longtext'
+        ];
+        return stringTypes.some(type => dataType.toLowerCase().includes(type));
+    }
+    // ============================================================================
+    // UTILITY METHODS
+    // ============================================================================
+    /**
+     * Sleep for specified milliseconds (for retry logic)
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Build schema filter WHERE clause
+     * Helper method for constructing SQL filters
+     */
+    buildSchemaFilterClause(filter, schemaColumnName) {
+        const conditions = [];
+        // If include list is provided, only include those schemas
+        // If not provided or empty, include all schemas (except those in exclude list)
+        if (filter.include && filter.include.length > 0) {
+            const schemaList = filter.include.map(s => `'${s}'`).join(',');
+            conditions.push(`${schemaColumnName} IN (${schemaList})`);
+        }
+        // Always apply exclude list if provided
+        if (filter.exclude && filter.exclude.length > 0) {
+            const schemaList = filter.exclude.map(s => `'${s}'`).join(',');
+            conditions.push(`${schemaColumnName} NOT IN (${schemaList})`);
+        }
+        return conditions.length > 0 ? `AND ${conditions.join(' AND ')}` : '';
+    }
+    /**
+     * Build table filter WHERE clause
+     * Helper method for constructing SQL filters
+     */
+    buildTableFilterClause(filter, tableColumnName) {
+        const conditions = [];
+        if (filter.exclude && filter.exclude.length > 0) {
+            const tableList = filter.exclude.map(t => `'${t}'`).join(',');
+            conditions.push(`${tableColumnName} NOT IN (${tableList})`);
+        }
+        return conditions.length > 0 ? `AND ${conditions.join(' AND ')}` : '';
+    }
+    /**
+     * Get database provider name
+     */
+    getProviderName() {
+        return this.config.provider;
+    }
+}
+exports.BaseAutoDocDriver = BaseAutoDocDriver;
+//# sourceMappingURL=BaseAutoDocDriver.js.map

package/dist/drivers/BaseAutoDocDriver.js.map

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

package/dist/drivers/MySQLDriver.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MySQL implementation of the BaseAutoDocDriver
+ * Uses mysql2 driver for database connectivity
+ */
+import { BaseAutoDocDriver } from './BaseAutoDocDriver.js';
+import { AutoDocSchema, AutoDocTable, AutoDocColumn, AutoDocConnectionConfig, AutoDocQueryResult, AutoDocConnectionTestResult, AutoDocSchemaFilter, AutoDocTableFilter, AutoDocColumnStatistics, AutoDocExistingDescription } from '../types/driver.js';
+/**
+ * MySQL driver implementation
+ * Registered with MJGlobal for factory instantiation
+ */
+export declare class MySQLDriver extends BaseAutoDocDriver {
+    private pool;
+    private mysqlConfig;
+    constructor(config: AutoDocConnectionConfig);
+    connect(): Promise<void>;
+    test(): Promise<AutoDocConnectionTestResult>;
+    close(): Promise<void>;
+    getSchemas(schemaFilter: AutoDocSchemaFilter, tableFilter: AutoDocTableFilter): Promise<AutoDocSchema[]>;
+    protected getTables(schemaName: string, tableFilter: AutoDocTableFilter): Promise<AutoDocTable[]>;
+    protected getColumns(schemaName: string, tableName: string): Promise<AutoDocColumn[]>;
+    getExistingDescriptions(schemaName: string, tableName: string): Promise<AutoDocExistingDescription[]>;
+    getColumnStatistics(schemaName: string, tableName: string, columnName: string, dataType: string, cardinalityThreshold: number, sampleSize: number): Promise<AutoDocColumnStatistics>;
+    protected getDistinctCount(schemaName: string, tableName: string, columnName: string): Promise<number>;
+    protected getValueDistribution(schemaName: string, tableName: string, columnName: string, limit: number): Promise<Array<{
+        value: any;
+        frequency: number;
+    }>>;
+    protected getSampleValues(schemaName: string, tableName: string, columnName: string, sampleSize: number): Promise<any[]>;
+    executeQuery<T = any>(query: string, maxRetries?: number, params?: any[]): Promise<AutoDocQueryResult<T>>;
+    protected escapeIdentifier(identifier: string): string;
+    protected getLimitClause(limit: number): string;
+    private buildTablesQuery;
+    private getForeignKeys;
+    private getPrimaryKeys;
+    private getCardinalityStats;
+    private getNumericStats;
+    private getDateStats;
+    private getStringStats;
+    private isTransientError;
+    /**
+     * Get column information for relationship discovery
+     */
+    getColumnInfo(schemaName: string, tableName: string, columnName: string): Promise<{
+        name: string;
+        type: string;
+        nullable: boolean;
+    }>;
+    /**
+     * Test value overlap between source and target columns
+     */
+    testValueOverlap(sourceTable: string, sourceColumn: string, targetTable: string, targetColumn: string, sampleSize: number): Promise<number>;
+    /**
+     * Check if combination of columns is unique
+     */
+    checkColumnCombinationUniqueness(schemaName: string, tableName: string, columnNames: string[], sampleSize: number): Promise<boolean>;
+    /**
+     * Parse table identifier in format "schema.table"
+     */
+    private parseTableIdentifier;
+}
+//# sourceMappingURL=MySQLDriver.d.ts.map

package/dist/drivers/MySQLDriver.d.ts.map

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