schema-navigator-mcp 0.2.0

package/dist/index.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createSchemaNavigator } from "./server.js";
+import { shutdownPool } from "./db/postgres.js";
+import { extractRefFromUrl } from "./db/supabase-adapter.js";
+function resolveConfig() {
+    // Priority 1: Direct database connection (any PostgreSQL)
+    const databaseUrl = process.env.DATABASE_URL;
+    if (databaseUrl) {
+        if (!/^postgres(ql)?:\/\//i.test(databaseUrl)) {
+            console.error("Error: DATABASE_URL must be a postgresql:// connection string");
+            process.exit(1);
+        }
+        return databaseUrl;
+    }
+    // Priority 2: Supabase Management API (no password needed)
+    const accessToken = process.env.SUPABASE_ACCESS_TOKEN;
+    if (accessToken) {
+        const projectRef = resolveProjectRef();
+        if (!projectRef) {
+            console.error("Error: SUPABASE_ACCESS_TOKEN is set but no project reference found.\n" +
+                "Set one of:\n" +
+                "  SUPABASE_PROJECT_REF=your-project-ref\n" +
+                "  SUPABASE_URL=https://your-project-ref.supabase.co\n" +
+                "  NEXT_PUBLIC_SUPABASE_URL=https://your-project-ref.supabase.co");
+            process.exit(1);
+        }
+        return { accessToken, projectRef };
+    }
+    // No config found — give context-aware error
+    const hasSupabaseVars = !!(process.env.SUPABASE_URL ||
+        process.env.NEXT_PUBLIC_SUPABASE_URL ||
+        process.env.SUPABASE_PROJECT_REF);
+    if (hasSupabaseVars) {
+        console.error("Error: Found Supabase project info but no credentials.\n" +
+            "Either:\n" +
+            "  1. Set DATABASE_URL for direct connection (requires db password)\n" +
+            "  2. Set SUPABASE_ACCESS_TOKEN for Management API (no password needed)\n" +
+            "     Get a token at: https://supabase.com/dashboard/account/tokens");
+    }
+    else {
+        console.error("Error: No database connection configured.\n\n" +
+            "Option 1 — Direct connection (any PostgreSQL):\n" +
+            "  DATABASE_URL=postgresql://user:pass@host:5432/db\n\n" +
+            "Option 2 — Supabase (no password needed):\n" +
+            "  SUPABASE_ACCESS_TOKEN=sbp_...  (from supabase.com/dashboard/account/tokens)\n" +
+            "  SUPABASE_PROJECT_REF=your-project-ref  (from your dashboard URL)");
+    }
+    process.exit(1);
+}
+/**
+ * Extract project ref from available env vars.
+ */
+function resolveProjectRef() {
+    if (process.env.SUPABASE_PROJECT_REF) {
+        return process.env.SUPABASE_PROJECT_REF;
+    }
+    const url = process.env.SUPABASE_URL || process.env.NEXT_PUBLIC_SUPABASE_URL;
+    if (url) {
+        return extractRefFromUrl(url);
+    }
+    return null;
+}
+async function main() {
+    const config = resolveConfig();
+    const server = await createSchemaNavigator(config);
+    const transport = new StdioServerTransport();
+    const shutdown = async () => {
+        await shutdownPool();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SupabaseAdapterConfig } from "./db/supabase-adapter.js";
+export type SchemaNavigatorConfig = string | SupabaseAdapterConfig;
+export declare function createSchemaNavigator(config: SchemaNavigatorConfig): Promise<McpServer>;

package/dist/server.js

@@ -0,0 +1,129 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { setAdapter, shutdownPool } from "./db/postgres.js";
+import { PgAdapter } from "./db/pg-adapter.js";
+import { SupabaseAdapter } from "./db/supabase-adapter.js";
+import { schemaOverview } from "./tools/overview.js";
+import { schemaTable } from "./tools/table-profile.js";
+import { schemaFind } from "./tools/search.js";
+import { schemaRelations } from "./tools/relations.js";
+import { schemaFunctions } from "./tools/functions.js";
+import { schemaConstraints } from "./tools/constraints.js";
+import { schemaPolicies } from "./tools/policies.js";
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function toolError(err) {
+    return {
+        content: [{ type: "text", text: JSON.stringify({ error: errorMessage(err) }) }],
+        isError: true,
+    };
+}
+export async function createSchemaNavigator(config) {
+    if (typeof config === "string") {
+        const pgAdapter = new PgAdapter(config);
+        await pgAdapter.detectVersion();
+        setAdapter(pgAdapter);
+    }
+    else {
+        setAdapter(new SupabaseAdapter(config));
+    }
+    const server = new McpServer({
+        name: "schema-navigator",
+        version: "0.2.0",
+    });
+    // 1. schema_overview — Database dashboard
+    server.tool("schema_overview", "List all tables, views, enums, extensions with sizes and health warnings", { schema: z.string().default("public").describe("Database schema name") }, async ({ schema }) => {
+        try {
+            const result = await schemaOverview(schema);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    // 2. schema_table — Complete object profile
+    server.tool("schema_table", "Profile a table/view/matview: columns, constraints, FKs, indexes, RLS, size", {
+        table_name: z.string().describe("Table, view, or materialized view name"),
+        schema: z.string().default("public").describe("Database schema name"),
+    }, async ({ table_name, schema }) => {
+        try {
+            const result = await schemaTable(table_name, schema);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    // 3. schema_find — Cross-schema search
+    server.tool("schema_find", "Search tables, columns, functions, views, policies, enums by name pattern", {
+        term: z.string().describe("Search term (case-insensitive partial match)"),
+        schema: z.string().default("public").describe("Database schema name"),
+    }, async ({ term, schema }) => {
+        try {
+            const result = await schemaFind(term, schema);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    // 4. schema_relations — FK graph
+    server.tool("schema_relations", "Show foreign key relationships: outbound and inbound references", {
+        table_name: z.string().describe("Table name to get relations for"),
+        schema: z.string().default("public").describe("Database schema name"),
+    }, async ({ table_name, schema }) => {
+        try {
+            const result = await schemaRelations(table_name, schema);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    // 5. schema_functions — Function inspector
+    server.tool("schema_functions", "Inspect function: args, return type, language, security, source code", {
+        function_name: z.string().describe("Function or procedure name"),
+        schema: z.string().default("public").describe("Database schema name"),
+    }, async ({ function_name, schema }) => {
+        try {
+            const result = await schemaFunctions(function_name, schema);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    // 6. schema_constraints — Value extractor (CHECK + ENUM)
+    server.tool("schema_constraints", "Extract allowed values from CHECK constraints and ENUM types on a table", {
+        table_name: z.string().describe("Table name"),
+        schema: z.string().default("public").describe("Database schema name"),
+    }, async ({ table_name, schema }) => {
+        try {
+            const result = await schemaConstraints(table_name, schema);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    // 7. schema_policies — RLS analyzer
+    server.tool("schema_policies", "Analyze RLS: enabled status, policies, role access matrix", {
+        table_name: z.string().describe("Table name"),
+        schema: z.string().default("public").describe("Database schema name"),
+    }, async ({ table_name, schema }) => {
+        try {
+            const result = await schemaPolicies(table_name, schema);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    // Cleanup on close
+    server.server.onclose = async () => {
+        await shutdownPool();
+    };
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/constraints.d.ts

@@ -0,0 +1,22 @@
+interface CheckConstraint {
+    constraint_name: string;
+    column: string | null;
+    type: "values" | "range" | "unknown";
+    allowed_values?: string[];
+    expression: string;
+}
+interface EnumColumn {
+    column: string;
+    enum_name: string;
+    values: string[];
+}
+interface ConstraintsResult {
+    table: string;
+    schema: string;
+    check_constraints: CheckConstraint[];
+    enum_columns: EnumColumn[];
+}
+export declare function schemaConstraints(tableName: string, schema: string): Promise<ConstraintsResult | {
+    error: string;
+}>;
+export {};

package/dist/tools/constraints.js

@@ -0,0 +1,80 @@
+import { readOnlyMultiQuery, getIsPostgres } from "../db/postgres.js";
+import { parseCheckExpression } from "../utils/check-parser.js";
+export async function schemaConstraints(tableName, schema) {
+    const isPg = getIsPostgres();
+    const queries = [
+        // Check table existence
+        {
+            sql: `SELECT 1 FROM information_schema.tables WHERE table_schema = $1 AND table_name = $2`,
+            params: [schema, tableName],
+        },
+        // CHECK constraints
+        {
+            sql: `
+        SELECT tc.constraint_name, cc.check_clause
+        FROM information_schema.table_constraints tc
+        JOIN information_schema.check_constraints cc
+          ON cc.constraint_name = tc.constraint_name AND cc.constraint_schema = tc.constraint_schema
+        WHERE tc.table_schema = $1 AND tc.table_name = $2 AND tc.constraint_type = 'CHECK'
+        ORDER BY tc.constraint_name
+      `,
+            params: [schema, tableName],
+        },
+    ];
+    // ENUM columns (Postgres only)
+    if (isPg) {
+        queries.push({
+            sql: `
+        SELECT
+          a.attname AS column_name,
+          t.typname AS enum_name,
+          array_agg(e.enumlabel ORDER BY e.enumsortorder) AS enum_values
+        FROM pg_attribute a
+        JOIN pg_class c ON c.oid = a.attrelid
+        JOIN pg_namespace n ON n.oid = c.relnamespace
+        JOIN pg_type t ON t.oid = a.atttypid
+        JOIN pg_enum e ON e.enumtypid = t.oid
+        WHERE n.nspname = $1 AND c.relname = $2
+          AND a.attnum > 0 AND NOT a.attisdropped
+        GROUP BY a.attname, t.typname
+        ORDER BY a.attname
+      `,
+            params: [schema, tableName],
+        });
+    }
+    const results = await readOnlyMultiQuery(queries);
+    if (results[0].rows.length === 0) {
+        return { error: `Table '${tableName}' not found in schema '${schema}'` };
+    }
+    // Parse CHECK constraints
+    const checkConstraints = results[1].rows
+        .map((r) => {
+        const parsed = parseCheckExpression(r.check_clause);
+        // Skip auto-generated NOT NULL checks
+        if (parsed.column === null && parsed.type === "unknown")
+            return null;
+        return {
+            constraint_name: r.constraint_name,
+            column: parsed.column,
+            type: parsed.type,
+            ...(parsed.allowed_values ? { allowed_values: parsed.allowed_values } : {}),
+            expression: r.check_clause,
+        };
+    })
+        .filter((c) => c !== null);
+    // ENUM columns
+    const enumColumns = isPg
+        ? results[2].rows.map((r) => ({
+            column: r.column_name,
+            enum_name: r.enum_name,
+            values: r.enum_values,
+        }))
+        : [];
+    return {
+        table: tableName,
+        schema,
+        check_constraints: checkConstraints,
+        enum_columns: enumColumns,
+    };
+}
+//# sourceMappingURL=constraints.js.map

package/dist/tools/constraints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.js","sourceRoot":"","sources":["../../src/tools/constraints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAuBhE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAiB,EACjB,MAAc;IAEd,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAE7B,MAAM,OAAO,GAA+C;QAC1D,wBAAwB;QACxB;YACE,GAAG,EAAE,qFAAqF;YAC1F,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;SAC5B;QACD,oBAAoB;QACpB;YACE,GAAG,EAAE;;;;;;;OAOJ;YACD,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;SAC5B;KACF,CAAC;IAEF,+BAA+B;IAC/B,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,EAAE;;;;;;;;;;;;;;OAcJ;YACD,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAElD,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,KAAK,EAAE,UAAU,SAAS,0BAA0B,MAAM,GAAG,EAAE,CAAC;IAC3E,CAAC;IAED,0BAA0B;IAC1B,MAAM,gBAAgB,GAAsB,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;SACxD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,MAAM,GAAG,oBAAoB,CAAC,CAAC,CAAC,YAAsB,CAAC,CAAC;QAC9D,sCAAsC;QACtC,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACrE,OAAO;YACL,eAAe,EAAE,CAAC,CAAC,eAAyB;YAC5C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,UAAU,EAAE,CAAC,CAAC,YAAsB;SACrC,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAEnD,eAAe;IACf,MAAM,WAAW,GAAiB,IAAI;QACpC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1B,MAAM,EAAE,CAAC,CAAC,WAAqB;YAC/B,SAAS,EAAE,CAAC,CAAC,SAAmB;YAChC,MAAM,EAAE,CAAC,CAAC,WAAuB;SAClC,CAAC,CAAC;QACL,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,MAAM;QACN,iBAAiB,EAAE,gBAAgB;QACnC,YAAY,EAAE,WAAW;KAC1B,CAAC;AACJ,CAAC"}

package/dist/tools/functions.d.ts

@@ -0,0 +1,20 @@
+interface FunctionArg {
+    name: string;
+    type: string;
+    mode: string;
+    default: string | null;
+}
+interface FunctionResult {
+    name: string;
+    schema: string;
+    args: FunctionArg[];
+    return_type: string;
+    language: string;
+    security_definer: boolean;
+    volatility: string | null;
+    source_code: string | null;
+}
+export declare function schemaFunctions(functionName: string, schema: string): Promise<FunctionResult[] | {
+    error: string;
+}>;
+export {};

package/dist/tools/functions.js

@@ -0,0 +1,118 @@
+import { readOnlyQuery, getIsPostgres } from "../db/postgres.js";
+export async function schemaFunctions(functionName, schema) {
+    const isPg = getIsPostgres();
+    if (isPg) {
+        // Full function details via pg_catalog
+        const result = await readOnlyQuery(`
+      SELECT
+        p.proname AS name,
+        pg_get_function_arguments(p.oid) AS args_text,
+        pg_get_function_result(p.oid) AS return_type,
+        l.lanname AS language,
+        p.prosecdef AS security_definer,
+        CASE p.provolatile
+          WHEN 'i' THEN 'immutable'
+          WHEN 's' THEN 'stable'
+          WHEN 'v' THEN 'volatile'
+        END AS volatility,
+        pg_get_functiondef(p.oid) AS source_code
+      FROM pg_proc p
+      JOIN pg_namespace n ON n.oid = p.pronamespace
+      JOIN pg_language l ON l.oid = p.prolang
+      WHERE n.nspname = $1 AND p.proname = $2
+      ORDER BY p.pronargs
+      `, [schema, functionName]);
+        if (result.rows.length === 0) {
+            return { error: `Function '${functionName}' not found in schema '${schema}'` };
+        }
+        return result.rows.map((r) => ({
+            name: r.name,
+            schema,
+            args: parseArgsText(r.args_text),
+            return_type: r.return_type,
+            language: r.language,
+            security_definer: r.security_definer,
+            volatility: r.volatility,
+            source_code: r.source_code,
+        }));
+    }
+    // Fallback: information_schema (signature only, no source)
+    const result = await readOnlyQuery(`
+    SELECT
+      r.routine_name AS name,
+      r.data_type AS return_type,
+      r.routine_body AS language,
+      r.security_type
+    FROM information_schema.routines r
+    WHERE r.routine_schema = $1 AND r.routine_name = $2
+    ORDER BY r.routine_name
+    `, [schema, functionName]);
+    if (result.rows.length === 0) {
+        return { error: `Function '${functionName}' not found in schema '${schema}'` };
+    }
+    // Get parameters
+    const paramsResult = await readOnlyQuery(`
+    SELECT
+      p.parameter_name, p.data_type, p.parameter_mode, p.parameter_default
+    FROM information_schema.parameters p
+    WHERE p.specific_schema = $1
+      AND p.specific_name LIKE $2
+    ORDER BY p.ordinal_position
+    `, [schema, `${functionName}%`]);
+    const args = paramsResult.rows.map((r) => ({
+        name: r.parameter_name ?? "",
+        type: r.data_type,
+        mode: r.parameter_mode ?? "IN",
+        default: r.parameter_default ?? null,
+    }));
+    return result.rows.map((r) => ({
+        name: r.name,
+        schema,
+        args,
+        return_type: r.return_type,
+        language: r.language,
+        security_definer: r.security_type === "DEFINER",
+        volatility: null,
+        source_code: null,
+    }));
+}
+function parseArgsText(argsText) {
+    if (!argsText || argsText.trim() === "")
+        return [];
+    return argsText.split(",").map((arg) => {
+        const trimmed = arg.trim();
+        // Format: [mode] [name] type [DEFAULT value]
+        const defaultMatch = trimmed.match(/\s+DEFAULT\s+(.+)$/i);
+        const withoutDefault = defaultMatch
+            ? trimmed.slice(0, -defaultMatch[0].length)
+            : trimmed;
+        const parts = withoutDefault.split(/\s+/);
+        let mode = "IN";
+        let name = "";
+        let type = "";
+        if (["IN", "OUT", "INOUT", "VARIADIC"].includes(parts[0].toUpperCase())) {
+            mode = parts[0].toUpperCase();
+            if (parts.length >= 3) {
+                name = parts[1];
+                type = parts.slice(2).join(" ");
+            }
+            else {
+                type = parts.slice(1).join(" ");
+            }
+        }
+        else if (parts.length >= 2) {
+            name = parts[0];
+            type = parts.slice(1).join(" ");
+        }
+        else {
+            type = parts[0];
+        }
+        return {
+            name,
+            type,
+            mode,
+            default: defaultMatch ? defaultMatch[1] : null,
+        };
+    });
+}
+//# sourceMappingURL=functions.js.map

package/dist/tools/functions.js.map

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

package/dist/tools/overview.d.ts

@@ -0,0 +1,29 @@
+interface TableInfo {
+    name: string;
+    type: string;
+    rows: number | null;
+    size: string | null;
+}
+interface EnumType {
+    name: string;
+    values: string[];
+}
+interface OverviewResult {
+    schema: string;
+    tables: TableInfo[];
+    views: string[];
+    materialized_views: string[];
+    enum_types: EnumType[];
+    extensions: string[];
+    counts: {
+        tables: number;
+        views: number;
+        materialized_views: number;
+        functions: number;
+        enum_types: number;
+        truncated?: boolean;
+    };
+    health_warnings: string[];
+}
+export declare function schemaOverview(schema: string): Promise<OverviewResult>;
+export {};

package/dist/tools/overview.js

@@ -0,0 +1,142 @@
+import { readOnlyMultiQuery, getIsPostgres } from "../db/postgres.js";
+export async function schemaOverview(schema) {
+    const isPg = getIsPostgres();
+    const queries = [];
+    // Q0: Tables with row estimates and sizes
+    if (isPg) {
+        queries.push({
+            sql: `
+        SELECT
+          c.relname AS name,
+          CASE c.relkind WHEN 'r' THEN 'table' WHEN 'p' THEN 'partitioned' END AS type,
+          c.reltuples::bigint AS rows,
+          pg_total_relation_size(c.oid)::bigint AS size_bytes
+        FROM pg_class c
+        JOIN pg_namespace n ON n.oid = c.relnamespace
+        WHERE n.nspname = $1
+          AND c.relkind IN ('r', 'p')
+        ORDER BY pg_total_relation_size(c.oid) DESC
+        LIMIT 100
+      `,
+            params: [schema],
+        });
+    }
+    else {
+        queries.push({
+            sql: `SELECT table_name AS name, 'table' AS type, NULL AS rows, NULL AS size_bytes
+            FROM information_schema.tables
+            WHERE table_schema = $1 AND table_type = 'BASE TABLE'
+            ORDER BY table_name LIMIT 100`,
+            params: [schema],
+        });
+    }
+    // Q1: Views
+    queries.push({
+        sql: `SELECT table_name FROM information_schema.views WHERE table_schema = $1 ORDER BY table_name`,
+        params: [schema],
+    });
+    // Q2: Materialized views (Postgres only, empty on others)
+    queries.push(isPg
+        ? { sql: `SELECT matviewname FROM pg_matviews WHERE schemaname = $1 ORDER BY matviewname`, params: [schema] }
+        : { sql: `SELECT null AS matviewname WHERE false` });
+    // Q3: ENUMs (Postgres only)
+    queries.push(isPg
+        ? {
+            sql: `SELECT t.typname AS name, array_agg(e.enumlabel ORDER BY e.enumsortorder) AS values
+                FROM pg_type t
+                JOIN pg_enum e ON e.enumtypid = t.oid
+                JOIN pg_namespace n ON n.oid = t.typnamespace
+                WHERE n.nspname = $1
+                GROUP BY t.typname ORDER BY t.typname`,
+            params: [schema],
+        }
+        : { sql: `SELECT null AS name, null AS values WHERE false` });
+    // Q4: Extensions (Postgres only, database-wide)
+    queries.push(isPg
+        ? { sql: `SELECT extname FROM pg_extension ORDER BY extname` }
+        : { sql: `SELECT null AS extname WHERE false` });
+    // Q5: Function count
+    queries.push({
+        sql: `SELECT COUNT(*)::int AS count FROM information_schema.routines WHERE routine_schema = $1`,
+        params: [schema],
+    });
+    // Q6: Total table count
+    queries.push({
+        sql: `SELECT COUNT(*)::int AS count FROM information_schema.tables WHERE table_schema = $1 AND table_type = 'BASE TABLE'`,
+        params: [schema],
+    });
+    // Q7: Health — tables without PK (Postgres only)
+    queries.push(isPg
+        ? {
+            sql: `SELECT c.relname FROM pg_class c
+                JOIN pg_namespace n ON n.oid = c.relnamespace
+                WHERE n.nspname = $1 AND c.relkind = 'r'
+                  AND NOT EXISTS (SELECT 1 FROM pg_constraint con WHERE con.conrelid = c.oid AND con.contype = 'p')
+                ORDER BY c.relname`,
+            params: [schema],
+        }
+        : { sql: `SELECT null AS relname WHERE false` });
+    // Q8: Health — RLS disabled count (Postgres only)
+    queries.push(isPg
+        ? {
+            sql: `SELECT COUNT(*)::int AS count FROM pg_class c
+                JOIN pg_namespace n ON n.oid = c.relnamespace
+                WHERE n.nspname = $1 AND c.relkind = 'r' AND NOT c.relrowsecurity`,
+            params: [schema],
+        }
+        : { sql: `SELECT 0 AS count` });
+    const results = await readOnlyMultiQuery(queries);
+    // Parse results
+    const tables = results[0].rows.map((r) => ({
+        name: r.name,
+        type: r.type,
+        rows: r.rows != null ? Number(r.rows) : null,
+        size: r.size_bytes != null ? formatBytes(Number(r.size_bytes)) : null,
+    }));
+    const views = results[1].rows.map((r) => r.table_name);
+    const matviews = results[2].rows.map((r) => r.matviewname);
+    const enumTypes = results[3].rows.map((r) => ({
+        name: r.name,
+        values: r.values,
+    }));
+    const extensions = results[4].rows.map((r) => r.extname);
+    const fnCount = results[5].rows[0]?.count ?? 0;
+    const totalTables = results[6].rows[0]?.count ?? 0;
+    // Health warnings
+    const warnings = [];
+    if (isPg) {
+        const noPkTables = results[7].rows.map((r) => r.relname);
+        if (noPkTables.length > 0) {
+            warnings.push(`Tables without primary key: ${noPkTables.join(", ")}`);
+        }
+        const noRlsCount = results[8].rows[0]?.count ?? 0;
+        if (noRlsCount > 0) {
+            warnings.push(`Tables with RLS disabled: ${noRlsCount} of ${totalTables}`);
+        }
+    }
+    return {
+        schema,
+        tables,
+        views,
+        materialized_views: matviews,
+        enum_types: enumTypes,
+        extensions,
+        counts: {
+            tables: totalTables,
+            views: views.length,
+            materialized_views: matviews.length,
+            functions: fnCount,
+            enum_types: enumTypes.length,
+            ...(totalTables > 100 ? { truncated: true } : {}),
+        },
+        health_warnings: warnings,
+    };
+}
+function formatBytes(bytes) {
+    if (bytes <= 0)
+        return "0 B";
+    const units = ["B", "KB", "MB", "GB", "TB"];
+    const i = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), units.length - 1);
+    return `${(bytes / Math.pow(1024, i)).toFixed(1)} ${units[i]}`;
+}
+//# sourceMappingURL=overview.js.map