dbgraph 0.1.3 → 0.1.5

package/dist/introspect/mongodb.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * MongoDB Introspector
+ *
+ * Extracts collections, views, indexes, and schema validation rules
+ * from a MongoDB database. No document sampling — field-level schema
+ * is inferred from $jsonSchema validation rules only.
+ *
+ * Connection: manages its own MongoClient lifecycle (does NOT use the
+ * SQL-centric createConnection() factory in connection.ts).
+ * The driver import is guarded so a missing `mongodb` is reported at
+ * connect() time, not at module load time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoDBIntrospector = void 0;
+const base_1 = require("./base");
+const connection_1 = require("./connection");
+// =============================================================================
+// Lazy MongoDB Driver Import
+// =============================================================================
+let mongoModule;
+try {
+    mongoModule = require('mongodb');
+}
+catch {
+    /* handled at connect() time — see private importMongoDriver() */
+}
+// =============================================================================
+// MongoDBIntrospector
+// =============================================================================
+class MongoDBIntrospector extends base_1.BaseIntrospector {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Override testConnection() — MongoDB does not use the
+     * SQL-centric createConnection() factory from connection.ts.
+     */
+    async testConnection() {
+        try {
+            const client = await this.connectClient();
+            await client.close();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Full schema introspection.
+     *
+     * 1. Connect to MongoDB
+     * 2. List collections (collecting regular collections and views)
+     * 3. For each collection: indexes + estimatedDocumentCount
+     * 4. Build Node[] + Edge[] with schema→collection→index hierarchy
+     * 5. Close connection and return IntrospectResult
+     */
+    async extractAll() {
+        const startTime = Date.now();
+        const errors = [];
+        const nodes = [];
+        const edges = [];
+        let client;
+        try {
+            client = await this.connectClient();
+        }
+        catch (err) {
+            return {
+                nodes: [],
+                edges: [],
+                durationMs: Date.now() - startTime,
+                errors: [err.message],
+            };
+        }
+        try {
+            const db = client.db(this.config.database);
+            const dbName = this.config.database;
+            // Warn if config.schemas is set — MongoDB has no schema layer
+            const hasSchemaFilter = this.config.schemas !== undefined &&
+                this.config.schemas.length > 0 &&
+                !this.config.schemas.includes('*');
+            if (hasSchemaFilter) {
+                errors.push(`Warning: "schemas" filter is set for MongoDB source "${this.config.alias}" ` +
+                    `but MongoDB does not have a schema layer. All collections will be introspected. ` +
+                    `To suppress this warning, remove "schemas" from this source's config.`);
+            }
+            // -----------------------------------------------------------------------
+            // 1. List all collections (non-system, user-accessible)
+            // -----------------------------------------------------------------------
+            const collectionsRaw = await db
+                .listCollections({}, { nameOnly: false, authorizedCollections: true })
+                .toArray();
+            // Separate regular collections, timeseries, and views;
+            // exclude system collections (system.*)
+            const collections = collectionsRaw.filter((c) => !c.name.startsWith('system.') &&
+                (!c.type || c.type === 'collection' || c.type === 'timeseries'));
+            const views = collectionsRaw.filter((c) => c.type === 'view');
+            if (collections.length === 0 && views.length === 0) {
+                errors.push('No collections or views found in database');
+                return { nodes, edges, durationMs: Date.now() - startTime, errors };
+            }
+            // -----------------------------------------------------------------------
+            // 2. Create schema (database) node
+            // -----------------------------------------------------------------------
+            const schemaNode = this.makeNode('schema', dbName, this.qn(dbName), this.schemaFilePath(dbName));
+            nodes.push(schemaNode);
+            // -----------------------------------------------------------------------
+            // 3. Process each collection
+            // -----------------------------------------------------------------------
+            for (const coll of collections) {
+                const collName = coll.name;
+                const collQual = this.qn(dbName, collName);
+                const collFp = this.schemaFilePath(dbName);
+                // Gather indexes and document count for this collection
+                let indexes = [];
+                let docCount;
+                const mongoColl = db.collection(collName);
+                try {
+                    indexes = await mongoColl.indexes();
+                }
+                catch (err) {
+                    errors.push(`Skipping indexes for ${collName}: ${err.message}`);
+                }
+                try {
+                    // estimatedDocumentCount() — fast metadata read.
+                    // NOTE: on sharded clusters this may be approximate.
+                    docCount = await mongoColl.estimatedDocumentCount();
+                }
+                catch (err) {
+                    errors.push(`Skipping document count for ${collName}: ${err.message}`);
+                }
+                // Build metadata from collection options and validator
+                const collOptions = coll.options || {};
+                const validator = collOptions.validator;
+                const validationSchema = validator && validator.$jsonSchema
+                    ? {
+                        $jsonSchema: validator.$jsonSchema,
+                        ...(collOptions.validationAction ? { validationAction: collOptions.validationAction } : {}),
+                        ...(collOptions.validationLevel ? { validationLevel: collOptions.validationLevel } : {}),
+                    }
+                    : undefined;
+                const collNode = this.makeNode('table', collName, collQual, collFp, {
+                    metadata: {
+                        documentCount: docCount,
+                        ...(validationSchema ? { validation: validationSchema } : {}),
+                        ...(collOptions.capped || collOptions.size || collOptions.max || collOptions.collation || collOptions.timeseries
+                            ? {
+                                collectionOptions: {
+                                    ...(collOptions.capped !== undefined ? { capped: collOptions.capped } : {}),
+                                    ...(collOptions.size !== undefined ? { size: collOptions.size } : {}),
+                                    ...(collOptions.max !== undefined ? { max: collOptions.max } : {}),
+                                    ...(collOptions.collation ? { collation: collOptions.collation } : {}),
+                                    ...(collOptions.timeseries ? { timeseries: collOptions.timeseries } : {}),
+                                },
+                            }
+                            : {}),
+                    },
+                });
+                nodes.push(collNode);
+                edges.push(this.containEdge(schemaNode.id, collNode.id));
+                // Create index nodes
+                for (const idx of indexes) {
+                    const idxName = idx.name;
+                    const idxQual = this.qn(dbName, collName, idxName);
+                    // Determine index type from key values
+                    const keyValues = Object.values(idx.key || {});
+                    const SPECIAL_KEY_TYPES = new Set(['text', '2dsphere', '2d', 'hashed']);
+                    const idxType = keyValues.find((v) => SPECIAL_KEY_TYPES.has(v)) || 'regular';
+                    const idxNode = this.makeNode('index', idxName, idxQual, collFp, {
+                        metadata: {
+                            key: idx.key,
+                            unique: idx.unique || false,
+                            sparse: idx.sparse || undefined,
+                            indexType: idxType,
+                            partialFilterExpression: idx.partialFilterExpression || undefined,
+                            ttl: idx.expireAfterSeconds || undefined,
+                            automatic: idxName === '_id_' ? true : undefined,
+                        },
+                    });
+                    nodes.push(idxNode);
+                    edges.push(this.containEdge(collNode.id, idxNode.id));
+                    edges.push(this.makeEdge(collNode.id, idxNode.id, 'indexed_by'));
+                }
+            }
+            // -----------------------------------------------------------------------
+            // 4. Process views
+            // -----------------------------------------------------------------------
+            for (const view of views) {
+                const viewName = view.name;
+                const viewQual = this.qn(dbName, viewName);
+                const viewFp = this.schemaFilePath(dbName);
+                const viewOptions = view.options || {};
+                const viewNode = this.makeNode('view', viewName, viewQual, viewFp, {
+                    signature: JSON.stringify(viewOptions.pipeline || [], null, 2),
+                    metadata: {
+                        viewOn: viewOptions.viewOn,
+                    },
+                });
+                nodes.push(viewNode);
+                edges.push(this.containEdge(schemaNode.id, viewNode.id));
+            }
+        }
+        catch (err) {
+            errors.push(`Introspection error: ${err.message}`);
+        }
+        finally {
+            if (client)
+                await client.close();
+        }
+        return {
+            nodes,
+            edges,
+            durationMs: Date.now() - startTime,
+            errors,
+        };
+    }
+    // ===========================================================================
+    // Private Helpers
+    // ===========================================================================
+    /**
+     * Lazy-import the mongodb driver and throw a helpful error if absent.
+     */
+    importMongoDriver() {
+        if (!mongoModule) {
+            throw new Error(`mongodb package is not installed.\n` +
+                `Connect to ${this.config.alias} (mongodb) by running: npm install mongodb`);
+        }
+        return mongoModule;
+    }
+    /**
+     * Build a MongoDB connection URI from the config.
+     * NOTE: encodeURIComponent() is required for passwords containing
+     * special characters (@, :, /, ?, #, %). parseAuth() does raw split only.
+     *
+     * When config.srv is true, uses mongodb+srv:// protocol (Atlas/cloud).
+     * SRV mode: port is forced to undefined (DNS-resolved), TLS is auto-enabled.
+     */
+    buildUri() {
+        const auth = (0, connection_1.parseAuth)(this.config.auth);
+        const host = this.config.host || 'localhost';
+        const port = this.config.port || 27017;
+        const protocol = this.config.srv ? 'mongodb+srv' : 'mongodb';
+        const encodedDb = encodeURIComponent(this.config.database);
+        // SRV protocol does not allow manual port — omit it
+        const hostPart = this.config.srv ? host : `${host}:${port}`;
+        if (auth.user && auth.password) {
+            return `${protocol}://${encodeURIComponent(auth.user)}:${encodeURIComponent(auth.password)}@${hostPart}/${encodedDb}`;
+        }
+        if (auth.user) {
+            return `${protocol}://${encodeURIComponent(auth.user)}@${hostPart}/${encodedDb}`;
+        }
+        return `${protocol}://${hostPart}/${encodedDb}`;
+    }
+    /**
+     * Connect to MongoDB and return the MongoClient.
+     * SRV protocol forces TLS — config.ssl is ignored when srv is true.
+     */
+    async connectClient() {
+        const mongodb = this.importMongoDriver();
+        const uri = this.buildUri();
+        const tls = this.config.srv ? true : (this.config.ssl ?? false);
+        return mongodb.MongoClient.connect(uri, {
+            tls,
+            tlsAllowInvalidCertificates: this.config.tlsInsecure ?? false,
+            connectTimeoutMS: 10_000,
+            serverSelectionTimeoutMS: 10_000,
+        });
+    }
+}
+exports.MongoDBIntrospector = MongoDBIntrospector;
+//# sourceMappingURL=mongodb.js.map

package/dist/introspect/mongodb.js.map

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

package/dist/introspect/mssql.d.ts

@@ -0,0 +1,69 @@
+/**
+ * MSSQL Introspector
+ *
+ * Extracts schemas, tables, columns, primary keys, foreign keys,
+ * indexes, and views from a Microsoft SQL Server database using
+ * INFORMATION_SCHEMA and sys catalog views.
+ *
+ * Connection: uses `connection.ts` which wraps the `mssql` package.
+ * The driver import is guarded so a missing `mssql` is reported at
+ * connect() time, not at module load time.
+ *
+ * MSSQL-specific metadata extracted:
+ *  - Identity columns (via COLUMNPROPERTY)
+ *  - Index metadata from sys.indexes / sys.index_columns / sys.columns
+ *  - Schema-based organization (like PostgreSQL, unlike MySQL)
+ */
+import { IntrospectResult, DbConnectionConfig } from '../types';
+import { BaseIntrospector } from './base';
+export declare class MSSQLIntrospector extends BaseIntrospector {
+    constructor(config: DbConnectionConfig);
+    /**
+     * Full schema introspection pipeline.
+     *
+     * 1. Connect to the MSSQL database
+     * 2. Query schemas and filter by config.schemas if provided
+     * 3. Query all structural metadata in parallel
+     * 4. Build Node[] + Edge[]
+     * 5. Close connection and return the result
+     */
+    extractAll(): Promise<IntrospectResult>;
+    /**
+     * Query: non-system schemas.
+     */
+    private querySchemas;
+    /**
+     * Query: tables and views (BASE TABLE or VIEW).
+     */
+    private queryTables;
+    /**
+     * Query: columns with identity detection via COLUMNPROPERTY.
+     */
+    private queryColumns;
+    /**
+     * Query: columns that are part of a PRIMARY KEY constraint.
+     */
+    private queryPrimaryKeys;
+    /**
+     * Query: foreign key columns + referential actions.
+     *
+     * Uses sys.foreign_keys / sys.foreign_key_columns catalog views
+     * (faster than the INFORMATION_SCHEMA 4-table join).
+     * Referential action codes are mapped via CASE:
+     *   0 = NO ACTION, 1 = CASCADE, 2 = SET_NULL, 3 = SET_DEFAULT
+     */
+    private queryForeignKeys;
+    /**
+     * Query: index columns from sys.indexes / sys.index_columns / sys.columns.
+     *
+     * MSSQL does NOT expose index metadata in INFORMATION_SCHEMA, so we query
+     * the sys catalog views instead. Returns one row per (index × column),
+     * grouped later in the build step.
+     */
+    private queryIndexes;
+    /**
+     * Query: view definitions.
+     */
+    private queryViews;
+}
+//# sourceMappingURL=mssql.d.ts.map

package/dist/introspect/mssql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mssql.d.ts","sourceRoot":"","sources":["../../src/introspect/mssql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAKnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAuE1C,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,MAAM,EAAE,kBAAkB;IAItC;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAyP7C;;OAEG;YACW,YAAY;IAU1B;;OAEG;YACW,WAAW;IAkBzB;;OAEG;YACW,YAAY;IAyB1B;;OAEG;YACW,gBAAgB;IAyB9B;;;;;;;OAOG;YACW,gBAAgB;IA2C9B;;;;;;OAMG;YACW,YAAY;IA0B1B;;OAEG;YACW,UAAU;CAgBzB"}