@memberjunction/db-auto-doc 2.117.0 → 2.118.0

package/dist/state/StateManager.js

@@ -0,0 +1,348 @@
+"use strict";
+/**
+ * State file management
+ * Handles loading, saving, and updating the state file
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateManager = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+class StateManager {
+    constructor(stateFilePath) {
+        this.stateFilePath = stateFilePath;
+    }
+    /**
+     * Load state from file
+     */
+    async load() {
+        try {
+            const exists = await this.fileExists();
+            if (!exists) {
+                return null;
+            }
+            const content = await fs.readFile(this.stateFilePath, 'utf-8');
+            const state = JSON.parse(content);
+            // Migrate old structure to new phases structure (backward compatibility)
+            if (!state.phases) {
+                state.phases = {
+                    descriptionGeneration: state.analysisRuns || []
+                };
+                if (state.relationshipDiscoveryPhase) {
+                    state.phases.keyDetection = state.relationshipDiscoveryPhase;
+                }
+            }
+            // Initialize summary if it doesn't exist (backward compatibility)
+            if (!state.summary) {
+                state.summary = {
+                    createdAt: state.createdAt || new Date().toISOString(),
+                    lastModified: state.lastModified || new Date().toISOString(),
+                    totalIterations: state.totalIterations || 0,
+                    totalPromptsRun: 0,
+                    totalInputTokens: 0,
+                    totalOutputTokens: 0,
+                    totalTokens: 0,
+                    totalSchemas: 0,
+                    totalTables: 0,
+                    totalColumns: 0,
+                    estimatedCost: 0
+                };
+                this.updateSummary(state);
+            }
+            else {
+                // Migrate timing fields into summary if they exist at top level
+                if (state.createdAt && !state.summary.createdAt) {
+                    state.summary.createdAt = state.createdAt;
+                }
+                if (state.lastModified && !state.summary.lastModified) {
+                    state.summary.lastModified = state.lastModified;
+                }
+                if (state.totalIterations !== undefined && !state.summary.totalIterations) {
+                    state.summary.totalIterations = state.totalIterations;
+                }
+            }
+            return state;
+        }
+        catch (error) {
+            throw new Error(`Failed to load state file: ${error.message}`);
+        }
+    }
+    /**
+     * Save state to file
+     */
+    async save(state) {
+        try {
+            // Update lastModified timestamp in summary
+            state.summary.lastModified = new Date().toISOString();
+            // Ensure output directory exists
+            const dir = path.dirname(this.stateFilePath);
+            await fs.mkdir(dir, { recursive: true });
+            // Write state file
+            const content = JSON.stringify(state, null, 2);
+            await fs.writeFile(this.stateFilePath, content, 'utf-8');
+        }
+        catch (error) {
+            throw new Error(`Failed to save state file: ${error.message}`);
+        }
+    }
+    /**
+     * Create initial empty state
+     */
+    createInitialState(databaseName, serverName) {
+        const now = new Date().toISOString();
+        return {
+            version: '1.0.0',
+            summary: {
+                createdAt: now,
+                lastModified: now,
+                totalIterations: 0,
+                totalPromptsRun: 0,
+                totalInputTokens: 0,
+                totalOutputTokens: 0,
+                totalTokens: 0,
+                totalSchemas: 0,
+                totalTables: 0,
+                totalColumns: 0,
+                estimatedCost: 0
+            },
+            database: {
+                name: databaseName,
+                server: serverName,
+                analyzedAt: now
+            },
+            phases: {
+                descriptionGeneration: []
+            },
+            schemas: []
+        };
+    }
+    /**
+     * Start a new analysis run
+     */
+    createAnalysisRun(state, modelUsed, vendor, temperature, topP, topK) {
+        const run = {
+            runId: this.generateRunId(),
+            startedAt: new Date().toISOString(),
+            status: 'in_progress',
+            levelsProcessed: 0,
+            iterationsPerformed: 0,
+            backpropagationCount: 0,
+            sanityCheckCount: 0,
+            converged: false,
+            modelUsed,
+            vendor,
+            temperature,
+            topP,
+            topK,
+            totalTokensUsed: 0,
+            estimatedCost: 0,
+            warnings: [],
+            errors: [],
+            processingLog: [],
+            sanityChecks: []
+        };
+        state.phases.descriptionGeneration.push(run);
+        return run;
+    }
+    /**
+     * Update table description with new iteration
+     */
+    updateTableDescription(table, description, reasoning, confidence, modelUsed, triggeredBy) {
+        const iteration = {
+            description,
+            reasoning,
+            generatedAt: new Date().toISOString(),
+            modelUsed,
+            confidence,
+            triggeredBy,
+            changedFrom: table.description
+        };
+        table.descriptionIterations.push(iteration);
+        table.description = description;
+    }
+    /**
+     * Update column description with new iteration
+     */
+    updateColumnDescription(column, description, reasoning, modelUsed) {
+        const iteration = {
+            description,
+            reasoning,
+            generatedAt: new Date().toISOString(),
+            modelUsed
+        };
+        column.descriptionIterations.push(iteration);
+        column.description = description;
+    }
+    /**
+     * Update schema description
+     */
+    updateSchemaDescription(schema, description, reasoning, modelUsed) {
+        const iteration = {
+            description,
+            reasoning,
+            generatedAt: new Date().toISOString(),
+            modelUsed,
+            triggeredBy: 'schema_sanity_check'
+        };
+        schema.descriptionIterations.push(iteration);
+        schema.description = description;
+    }
+    /**
+     * Find a table in the state
+     */
+    findTable(state, schemaName, tableName) {
+        const schema = state.schemas.find(s => s.name === schemaName);
+        if (!schema) {
+            return null;
+        }
+        return schema.tables.find(t => t.name === tableName) || null;
+    }
+    /**
+     * Get all unapproved tables
+     */
+    getUnapprovedTables(state) {
+        const unapproved = [];
+        for (const schema of state.schemas) {
+            for (const table of schema.tables) {
+                if (!table.userApproved) {
+                    unapproved.push(table);
+                }
+            }
+        }
+        return unapproved;
+    }
+    /**
+     * Get low-confidence tables
+     */
+    getLowConfidenceTables(state, threshold) {
+        const lowConfidence = [];
+        for (const schema of state.schemas) {
+            for (const table of schema.tables) {
+                if (table.descriptionIterations.length > 0) {
+                    const latest = table.descriptionIterations[table.descriptionIterations.length - 1];
+                    const confidence = latest.confidence ?? 0;
+                    if (confidence < threshold) {
+                        lowConfidence.push({
+                            schema: schema.name,
+                            table: table.name,
+                            confidence,
+                            description: latest.description,
+                            reasoning: latest.reasoning
+                        });
+                    }
+                }
+            }
+        }
+        return lowConfidence;
+    }
+    /**
+     * Get tables that need processing (no descriptions yet)
+     */
+    getUnprocessedTables(state) {
+        const unprocessed = [];
+        for (const schema of state.schemas) {
+            for (const table of schema.tables) {
+                if (table.descriptionIterations.length === 0) {
+                    unprocessed.push({
+                        schema: schema.name,
+                        table: table.name
+                    });
+                }
+            }
+        }
+        return unprocessed;
+    }
+    /**
+     * Check if state file exists
+     */
+    async fileExists() {
+        try {
+            await fs.access(this.stateFilePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Generate unique run ID
+     */
+    generateRunId() {
+        return `run_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Update summary statistics from current state and analysis runs
+     */
+    updateSummary(state) {
+        // Count schemas, tables, columns
+        let totalTables = 0;
+        let totalColumns = 0;
+        for (const schema of state.schemas) {
+            totalTables += schema.tables.length;
+            for (const table of schema.tables) {
+                totalColumns += table.columns.length;
+            }
+        }
+        // Aggregate from all analysis runs
+        let totalPromptsRun = 0;
+        let totalTokens = 0;
+        let estimatedCost = 0;
+        for (const run of state.phases.descriptionGeneration) {
+            // Count prompts from processing log
+            totalPromptsRun += run.processingLog.filter(log => log.tokensUsed && log.tokensUsed > 0).length;
+            // Sum tokens and cost
+            totalTokens += run.totalTokensUsed;
+            estimatedCost += run.estimatedCost;
+        }
+        // Update summary (preserve timing fields)
+        state.summary = {
+            ...state.summary,
+            totalPromptsRun,
+            totalInputTokens: 0, // TODO: Will need to track separately when available
+            totalOutputTokens: 0, // TODO: Will need to track separately when available
+            totalTokens,
+            totalSchemas: state.schemas.length,
+            totalTables,
+            totalColumns,
+            estimatedCost
+        };
+    }
+    /**
+     * Delete state file
+     */
+    async delete() {
+        try {
+            const exists = await this.fileExists();
+            if (exists) {
+                await fs.unlink(this.stateFilePath);
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to delete state file: ${error.message}`);
+        }
+    }
+}
+exports.StateManager = StateManager;
+//# sourceMappingURL=StateManager.js.map

package/dist/state/StateManager.js.map

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

package/dist/state/StateValidator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Validates state file integrity
+ */
+import { DatabaseDocumentation } from '../types/state.js';
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare class StateValidator {
+    /**
+     * Validate state file
+     */
+    validate(state: DatabaseDocumentation): ValidationResult;
+    /**
+     * Check if a table exists in the state
+     */
+    private tableExists;
+    /**
+     * Validate and repair if possible
+     */
+    validateAndRepair(state: DatabaseDocumentation): ValidationResult;
+}
+//# sourceMappingURL=StateValidator.d.ts.map

package/dist/state/StateValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateValidator.d.ts","sourceRoot":"","sources":["../../src/state/StateValidator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,gBAAgB;IA4G/D;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;OAEG;IACI,iBAAiB,CAAC,KAAK,EAAE,qBAAqB,GAAG,gBAAgB;CAoCzE"}

package/dist/state/StateValidator.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * Validates state file integrity
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateValidator = void 0;
+class StateValidator {
+    /**
+     * Validate state file
+     */
+    validate(state) {
+        const errors = [];
+        const warnings = [];
+        // Check required fields
+        if (!state.version) {
+            errors.push('Missing version field');
+        }
+        if (!state.database) {
+            errors.push('Missing database field');
+        }
+        else {
+            if (!state.database.name) {
+                errors.push('Missing database.name');
+            }
+            if (!state.database.server) {
+                errors.push('Missing database.server');
+            }
+        }
+        if (!state.schemas) {
+            errors.push('Missing schemas array');
+        }
+        else if (!Array.isArray(state.schemas)) {
+            errors.push('schemas must be an array');
+        }
+        if (!state.phases.descriptionGeneration) {
+            errors.push('Missing analysisRuns array');
+        }
+        else if (!Array.isArray(state.phases.descriptionGeneration)) {
+            errors.push('analysisRuns must be an array');
+        }
+        // Validate schemas
+        if (Array.isArray(state.schemas)) {
+            for (let i = 0; i < state.schemas.length; i++) {
+                const schema = state.schemas[i];
+                if (!schema.name) {
+                    errors.push(`Schema at index ${i} missing name`);
+                }
+                if (!schema.tables || !Array.isArray(schema.tables)) {
+                    errors.push(`Schema "${schema.name}" missing or invalid tables array`);
+                    continue;
+                }
+                // Validate tables
+                for (let j = 0; j < schema.tables.length; j++) {
+                    const table = schema.tables[j];
+                    if (!table.name) {
+                        errors.push(`Table at index ${j} in schema "${schema.name}" missing name`);
+                    }
+                    if (!table.columns || !Array.isArray(table.columns)) {
+                        errors.push(`Table "${table.name}" in schema "${schema.name}" missing or invalid columns array`);
+                    }
+                    if (!table.descriptionIterations || !Array.isArray(table.descriptionIterations)) {
+                        errors.push(`Table "${table.name}" in schema "${schema.name}" missing or invalid descriptionIterations array`);
+                    }
+                    // Validate foreign key references
+                    if (table.dependsOn && Array.isArray(table.dependsOn)) {
+                        for (const dep of table.dependsOn) {
+                            if (!this.tableExists(state, dep.schema, dep.table)) {
+                                warnings.push(`Table "${schema.name}.${table.name}" references non-existent table "${dep.schema}.${dep.table}"`);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        // Validate analysis runs
+        if (Array.isArray(state.phases.descriptionGeneration)) {
+            for (let i = 0; i < state.phases.descriptionGeneration.length; i++) {
+                const run = state.phases.descriptionGeneration[i];
+                if (!run.runId) {
+                    errors.push(`Analysis run at index ${i} missing runId`);
+                }
+                if (!run.startedAt) {
+                    errors.push(`Analysis run at index ${i} missing startedAt`);
+                }
+                if (!run.status) {
+                    errors.push(`Analysis run at index ${i} missing status`);
+                }
+                else if (!['in_progress', 'completed', 'failed', 'converged'].includes(run.status)) {
+                    errors.push(`Analysis run at index ${i} has invalid status: ${run.status}`);
+                }
+                if (!run.processingLog || !Array.isArray(run.processingLog)) {
+                    errors.push(`Analysis run at index ${i} missing or invalid processingLog array`);
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+    /**
+     * Check if a table exists in the state
+     */
+    tableExists(state, schemaName, tableName) {
+        const schema = state.schemas.find(s => s.name === schemaName);
+        if (!schema) {
+            return false;
+        }
+        return schema.tables.some(t => t.name === tableName);
+    }
+    /**
+     * Validate and repair if possible
+     */
+    validateAndRepair(state) {
+        const result = this.validate(state);
+        // Attempt simple repairs
+        if (!state.phases.descriptionGeneration) {
+            state.phases.descriptionGeneration = [];
+            result.warnings.push('Repaired: Created missing analysisRuns array');
+        }
+        if (!state.schemas) {
+            state.schemas = [];
+            result.warnings.push('Repaired: Created missing schemas array');
+        }
+        // Initialize missing iteration arrays
+        for (const schema of state.schemas) {
+            if (!schema.descriptionIterations) {
+                schema.descriptionIterations = [];
+            }
+            for (const table of schema.tables) {
+                if (!table.descriptionIterations) {
+                    table.descriptionIterations = [];
+                }
+                for (const column of table.columns) {
+                    if (!column.descriptionIterations) {
+                        column.descriptionIterations = [];
+                    }
+                }
+            }
+        }
+        // Re-validate after repairs
+        return this.validate(state);
+    }
+}
+exports.StateValidator = StateValidator;
+//# sourceMappingURL=StateValidator.js.map

package/dist/state/StateValidator.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Exports for state module
+ */
+export { StateManager } from './StateManager.js';
+export { IterationTracker } from './IterationTracker.js';
+export { StateValidator, ValidationResult } from './StateValidator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/state/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Exports for state module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateValidator = exports.IterationTracker = exports.StateManager = void 0;
+var StateManager_js_1 = require("./StateManager.js");
+Object.defineProperty(exports, "StateManager", { enumerable: true, get: function () { return StateManager_js_1.StateManager; } });
+var IterationTracker_js_1 = require("./IterationTracker.js");
+Object.defineProperty(exports, "IterationTracker", { enumerable: true, get: function () { return IterationTracker_js_1.IterationTracker; } });
+var StateValidator_js_1 = require("./StateValidator.js");
+Object.defineProperty(exports, "StateValidator", { enumerable: true, get: function () { return StateValidator_js_1.StateValidator; } });
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AACrB,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AACzB,yDAAuE;AAA9D,mHAAA,cAAc,OAAA"}

package/dist/types/analysis.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Analysis-related types for DBAutoDoc
+ */
+import { TableDefinition } from './state.js';
+export interface DependencyGraph {
+    nodes: Map<string, TableNode>;
+    levels: TableNode[][];
+}
+export interface TableNode {
+    schema: string;
+    table: string;
+    fullName: string;
+    dependsOn: TableNode[];
+    dependents: TableNode[];
+    level: number;
+    tableDefinition?: TableDefinition;
+}
+export interface BackpropagationTrigger {
+    sourceTable: string;
+    targetTable: string;
+    insight: string;
+    confidence: number;
+}
+export interface ConvergenceResult {
+    converged: boolean;
+    reason: string;
+    iterationsPerformed: number;
+    suggestions?: string[];
+}
+export interface AnalysisMetrics {
+    tablesAnalyzed: number;
+    columnsAnalyzed: number;
+    totalTokensUsed: number;
+    totalCost: number;
+    averageConfidence: number;
+    lowConfidenceCount: number;
+    backpropagationCount: number;
+    iterationCount: number;
+}
+export interface TableAnalysisContext {
+    schema: string;
+    table: string;
+    rowCount: number;
+    columns: any[];
+    dependsOn: any[];
+    dependents: any[];
+    sampleData: any[];
+    parentDescriptions?: ParentTableDescription[];
+    userNotes?: string;
+    seedContext?: any;
+    allTables?: Array<{
+        schema: string;
+        name: string;
+    }>;
+}
+export interface ParentTableDescription {
+    schema: string;
+    table: string;
+    description: string;
+}
+export interface AnalysisResult {
+    success: boolean;
+    tableDescription?: string;
+    reasoning?: string;
+    confidence?: number;
+    columnDescriptions?: ColumnDescriptionResult[];
+    inferredBusinessDomain?: string;
+    errorMessage?: string;
+    tokensUsed: number;
+}
+export interface ColumnDescriptionResult {
+    columnName: string;
+    description: string;
+    reasoning: string;
+}
+//# sourceMappingURL=analysis.d.ts.map

package/dist/types/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/types/analysis.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9B,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,SAAS,EAAE,GAAG,EAAE,CAAC;IACjB,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,kBAAkB,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC/C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/analysis.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Analysis-related types for DBAutoDoc
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=analysis.js.map

package/dist/types/analysis.js.map

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