@eamonboyle/mssql-mcp 1.1.0 → 1.3.0

package/dist/schema.js

@@ -0,0 +1,390 @@
+import sql from "mssql";
+import { getAllowedDatabases, getDefaultDatabaseName, getSqlRequest, } from "./db.js";
+import { getFriendlyObjectType, getObjectTypeCodes } from "./sql.js";
+export async function listDatabaseTables(databaseName, schemaName) {
+    const { request, error } = await getSqlRequest(databaseName);
+    if (error) {
+        throw new Error(error);
+    }
+    if (schemaName) {
+        request.input("schemaName", sql.NVarChar, schemaName);
+    }
+    const schemaFilter = schemaName ? "AND TABLE_SCHEMA = @schemaName" : "";
+    const result = await request.query(`
+    SELECT
+      TABLE_SCHEMA AS schemaName,
+      TABLE_NAME AS tableName
+    FROM INFORMATION_SCHEMA.TABLES
+    WHERE TABLE_TYPE = 'BASE TABLE'
+      ${schemaFilter}
+    ORDER BY TABLE_SCHEMA, TABLE_NAME
+  `);
+    return result.recordset;
+}
+export async function describeTableSchema(tableName, databaseName, schemaName) {
+    const { request, error } = await getSqlRequest(databaseName);
+    if (error) {
+        throw new Error(error);
+    }
+    request.input("tableName", sql.NVarChar, tableName);
+    if (schemaName) {
+        request.input("schemaName", sql.NVarChar, schemaName);
+    }
+    const schemaFilter = schemaName ? "AND c.TABLE_SCHEMA = @schemaName" : "";
+    const result = await request.query(`
+    SELECT
+      c.TABLE_SCHEMA AS schemaName,
+      c.COLUMN_NAME AS name,
+      c.DATA_TYPE AS type,
+      c.IS_NULLABLE AS isNullable,
+      c.COLUMN_DEFAULT AS defaultValue,
+      c.CHARACTER_MAXIMUM_LENGTH AS maxLength,
+      c.NUMERIC_PRECISION AS numericPrecision,
+      c.NUMERIC_SCALE AS numericScale
+    FROM INFORMATION_SCHEMA.COLUMNS c
+    WHERE c.TABLE_NAME = @tableName
+      ${schemaFilter}
+    ORDER BY c.ORDINAL_POSITION
+  `);
+    return result.recordset;
+}
+export async function listDatabaseObjects(databaseName, objectTypes, schemaName) {
+    const { request, error } = await getSqlRequest(databaseName);
+    if (error) {
+        throw new Error(error);
+    }
+    const typeCodes = getObjectTypeCodes(objectTypes);
+    const typePlaceholders = typeCodes
+        .map((code, index) => {
+        const parameterName = `typeCode${index}`;
+        request.input(parameterName, sql.NVarChar, code);
+        return `@${parameterName}`;
+    })
+        .join(", ");
+    if (schemaName) {
+        request.input("schemaName", sql.NVarChar, schemaName);
+    }
+    const schemaFilter = schemaName ? "AND s.name = @schemaName" : "";
+    const result = await request.query(`
+    SELECT
+      o.name,
+      s.name AS schemaName,
+      o.type AS typeCode,
+      o.type_desc AS typeDescription,
+      o.create_date AS createdAt,
+      o.modify_date AS modifiedAt
+    FROM sys.objects o
+    INNER JOIN sys.schemas s ON s.schema_id = o.schema_id
+    WHERE o.is_ms_shipped = 0
+      AND o.type IN (${typePlaceholders})
+      ${schemaFilter}
+    ORDER BY s.name, o.name
+  `);
+    return result.recordset.map((row) => ({
+        ...row,
+        objectType: getFriendlyObjectType(row.typeCode),
+    }));
+}
+export async function describeDatabaseObject(objectName, databaseName, schemaName, objectTypes) {
+    const { request, error } = await getSqlRequest(databaseName);
+    if (error) {
+        throw new Error(error);
+    }
+    request.input("objectName", sql.NVarChar, objectName);
+    if (schemaName) {
+        request.input("schemaName", sql.NVarChar, schemaName);
+    }
+    let typeFilter = "";
+    if (objectTypes && objectTypes.length > 0) {
+        const typeCodes = getObjectTypeCodes(objectTypes);
+        const typePlaceholders = typeCodes
+            .map((code, index) => {
+            const parameterName = `describeTypeCode${index}`;
+            request.input(parameterName, sql.NVarChar, code);
+            return `@${parameterName}`;
+        })
+            .join(", ");
+        typeFilter = `AND o.type IN (${typePlaceholders})`;
+    }
+    const schemaFilter = schemaName ? "AND s.name = @schemaName" : "";
+    const objectResult = await request.query(`
+    SELECT TOP (2)
+      o.object_id AS objectId,
+      o.name,
+      s.name AS schemaName,
+      o.type AS typeCode,
+      o.type_desc AS typeDescription,
+      o.create_date AS createdAt,
+      o.modify_date AS modifiedAt,
+      sm.definition
+    FROM sys.objects o
+    INNER JOIN sys.schemas s ON s.schema_id = o.schema_id
+    LEFT JOIN sys.sql_modules sm ON sm.object_id = o.object_id
+    WHERE o.is_ms_shipped = 0
+      AND o.name = @objectName
+      ${schemaFilter}
+      ${typeFilter}
+    ORDER BY s.name, o.type, o.name
+  `);
+    const objectRows = objectResult.recordset;
+    if (objectRows.length > 1) {
+        const matches = objectRows
+            .map((row) => `${row.schemaName}.${row.name} (${getFriendlyObjectType(row.typeCode)})`)
+            .join(", ");
+        throw new Error(`Multiple objects named '${objectName}' matched the request. Specify schemaName or objectTypes to disambiguate. Matches: ${matches}.`);
+    }
+    const objectRow = objectRows[0];
+    if (!objectRow) {
+        return null;
+    }
+    request.input("objectId", sql.Int, objectRow.objectId);
+    const detailsResult = await request.query(`
+    SELECT
+      c.name,
+      t.name AS dataType,
+      c.max_length AS maxLength,
+      c.precision,
+      c.scale,
+      c.is_nullable AS isNullable,
+      c.is_identity AS isIdentity,
+      dc.definition AS defaultValue
+    FROM sys.columns c
+    INNER JOIN sys.types t ON t.user_type_id = c.user_type_id
+    LEFT JOIN sys.default_constraints dc
+      ON dc.parent_object_id = c.object_id
+      AND dc.parent_column_id = c.column_id
+    WHERE c.object_id = @objectId
+    ORDER BY c.column_id;
+
+    SELECT
+      i.name,
+      i.type_desc AS type,
+      i.is_unique AS isUnique,
+      c.name AS columnName,
+      ic.key_ordinal AS keyOrdinal
+    FROM sys.indexes i
+    INNER JOIN sys.index_columns ic
+      ON ic.object_id = i.object_id
+      AND ic.index_id = i.index_id
+    INNER JOIN sys.columns c
+      ON c.object_id = ic.object_id
+      AND c.column_id = ic.column_id
+    WHERE i.object_id = @objectId
+      AND i.is_hypothetical = 0
+      AND i.name IS NOT NULL
+    ORDER BY i.name, ic.key_ordinal
+  `);
+    const detailRecordsets = Array.isArray(detailsResult.recordsets)
+        ? detailsResult.recordsets
+        : [];
+    const columnsRecordset = (Array.isArray(detailRecordsets[0])
+        ? detailRecordsets[0]
+        : []);
+    const indexesRecordset = (Array.isArray(detailRecordsets[1])
+        ? detailRecordsets[1]
+        : []);
+    const indexes = new Map();
+    for (const row of indexesRecordset) {
+        if (!indexes.has(row.name)) {
+            indexes.set(row.name, {
+                name: row.name,
+                type: row.type,
+                isUnique: row.isUnique,
+                columns: [],
+            });
+        }
+        indexes.get(row.name)?.columns.push(row.columnName);
+    }
+    return {
+        name: objectRow.name,
+        schemaName: objectRow.schemaName,
+        objectType: getFriendlyObjectType(objectRow.typeCode),
+        typeCode: objectRow.typeCode,
+        typeDescription: objectRow.typeDescription,
+        createdAt: objectRow.createdAt,
+        modifiedAt: objectRow.modifiedAt,
+        definition: objectRow.definition,
+        columns: columnsRecordset,
+        indexes: [...indexes.values()],
+    };
+}
+export function listConfiguredDatabases() {
+    const defaultName = getDefaultDatabaseName();
+    return getAllowedDatabases().map((name) => ({
+        name,
+        isDefault: defaultName === name,
+    }));
+}
+export async function getDatabaseSchemaSummary(databaseName) {
+    const { request, error } = await getSqlRequest(databaseName);
+    if (error) {
+        throw new Error(error);
+    }
+    const result = await request.query(`
+    SELECT
+      CASE
+        WHEN o.type = 'U' THEN 'table'
+        WHEN o.type = 'V' THEN 'view'
+        WHEN o.type = 'P' THEN 'procedure'
+        WHEN o.type IN ('FN', 'IF', 'TF', 'FS', 'FT') THEN 'function'
+        WHEN o.type = 'TR' THEN 'trigger'
+        ELSE 'other'
+      END AS objectType,
+      COUNT(*) AS objectCount
+    FROM sys.objects o
+    WHERE o.is_ms_shipped = 0
+    GROUP BY CASE
+      WHEN o.type = 'U' THEN 'table'
+      WHEN o.type = 'V' THEN 'view'
+      WHEN o.type = 'P' THEN 'procedure'
+      WHEN o.type IN ('FN', 'IF', 'TF', 'FS', 'FT') THEN 'function'
+      WHEN o.type = 'TR' THEN 'trigger'
+      ELSE 'other'
+    END;
+
+    SELECT
+      s.name AS schemaName,
+      COUNT(*) AS objectCount
+    FROM sys.objects o
+    INNER JOIN sys.schemas s ON s.schema_id = o.schema_id
+    WHERE o.is_ms_shipped = 0
+    GROUP BY s.name
+    ORDER BY objectCount DESC, s.name;
+  `);
+    const recordsets = Array.isArray(result.recordsets) ? result.recordsets : [];
+    return {
+        objectCounts: recordsets[0] ?? [],
+        schemaCounts: recordsets[1] ?? [],
+    };
+}
+export async function listForeignKeys(databaseName, schemaName) {
+    const { request, error } = await getSqlRequest(databaseName);
+    if (error) {
+        throw new Error(error);
+    }
+    if (schemaName) {
+        request.input("schemaName", sql.NVarChar, schemaName);
+    }
+    const schemaFilter = schemaName
+        ? "AND (ps.name = @schemaName OR rs.name = @schemaName)"
+        : "";
+    const result = await request.query(`
+    SELECT
+      fk.name AS foreignKeyName,
+      ps.name AS parentSchemaName,
+      pt.name AS parentTableName,
+      pc.name AS parentColumnName,
+      rs.name AS referencedSchemaName,
+      rt.name AS referencedTableName,
+      rc.name AS referencedColumnName,
+      fk.delete_referential_action_desc AS onDelete,
+      fk.update_referential_action_desc AS onUpdate
+    FROM sys.foreign_keys fk
+    INNER JOIN sys.foreign_key_columns fkc
+      ON fkc.constraint_object_id = fk.object_id
+    INNER JOIN sys.tables pt
+      ON pt.object_id = fk.parent_object_id
+    INNER JOIN sys.schemas ps
+      ON ps.schema_id = pt.schema_id
+    INNER JOIN sys.columns pc
+      ON pc.object_id = pt.object_id
+      AND pc.column_id = fkc.parent_column_id
+    INNER JOIN sys.tables rt
+      ON rt.object_id = fk.referenced_object_id
+    INNER JOIN sys.schemas rs
+      ON rs.schema_id = rt.schema_id
+    INNER JOIN sys.columns rc
+      ON rc.object_id = rt.object_id
+      AND rc.column_id = fkc.referenced_column_id
+    WHERE 1 = 1
+      ${schemaFilter}
+    ORDER BY ps.name, pt.name, fk.name, fkc.constraint_column_id
+  `);
+    return result.recordset;
+}
+export async function describeRelationships(tableName, databaseName, schemaName) {
+    const foreignKeys = await listForeignKeys(databaseName, schemaName);
+    return foreignKeys.filter((row) => row.parentTableName === tableName || row.referencedTableName === tableName);
+}
+export async function describeObjectDependencies(objectName, databaseName, schemaName) {
+    const { request, error } = await getSqlRequest(databaseName);
+    if (error) {
+        throw new Error(error);
+    }
+    request.input("objectName", sql.NVarChar, objectName);
+    if (schemaName) {
+        request.input("schemaName", sql.NVarChar, schemaName);
+    }
+    const schemaFilter = schemaName ? "AND s.name = @schemaName" : "";
+    const result = await request.query(`
+    SELECT
+      referencingSchema.name AS referencingSchemaName,
+      referencing.name AS referencingObjectName,
+      referencing.type_desc AS referencingType,
+      referenced.referenced_schema_name AS referencedSchemaName,
+      referenced.referenced_entity_name AS referencedEntityName
+    FROM sys.objects target
+    INNER JOIN sys.schemas s ON s.schema_id = target.schema_id
+    INNER JOIN sys.sql_expression_dependencies referenced
+      ON referenced.referenced_id = target.object_id
+    INNER JOIN sys.objects referencing
+      ON referencing.object_id = referenced.referencing_id
+    INNER JOIN sys.schemas referencingSchema
+      ON referencingSchema.schema_id = referencing.schema_id
+    WHERE target.name = @objectName
+      ${schemaFilter}
+    ORDER BY referencingSchema.name, referencing.name;
+  `);
+    return result.recordset;
+}
+export async function analyzeTable(tableName, databaseName, schemaName) {
+    const { request, error } = await getSqlRequest(databaseName);
+    if (error) {
+        throw new Error(error);
+    }
+    request.input("tableName", sql.NVarChar, tableName);
+    if (schemaName) {
+        request.input("schemaName", sql.NVarChar, schemaName);
+    }
+    const schemaFilter = schemaName ? "AND s.name = @schemaName" : "";
+    const result = await request.query(`
+    SELECT TOP (1)
+      s.name AS schemaName,
+      t.name AS tableName,
+      SUM(p.row_count) AS [rowCount],
+      CAST(SUM(a.total_pages) * 8.0 / 1024 AS DECIMAL(12, 2)) AS reservedMB,
+      CAST(SUM(a.used_pages) * 8.0 / 1024 AS DECIMAL(12, 2)) AS usedMB
+    FROM sys.tables t
+    INNER JOIN sys.schemas s ON s.schema_id = t.schema_id
+    INNER JOIN sys.dm_db_partition_stats p ON p.object_id = t.object_id
+    INNER JOIN sys.partitions sp ON sp.partition_id = p.partition_id
+    INNER JOIN sys.allocation_units a ON a.container_id = sp.hobt_id
+    WHERE t.name = @tableName
+      ${schemaFilter}
+    GROUP BY s.name, t.name
+    ORDER BY s.name, t.name;
+
+    SELECT
+      i.name,
+      i.type_desc AS type,
+      i.is_unique AS isUnique,
+      i.is_primary_key AS isPrimaryKey
+    FROM sys.indexes i
+    INNER JOIN sys.tables t ON t.object_id = i.object_id
+    INNER JOIN sys.schemas s ON s.schema_id = t.schema_id
+    WHERE t.name = @tableName
+      ${schemaFilter}
+      AND i.index_id > 0
+    ORDER BY i.name;
+  `);
+    const recordsets = Array.isArray(result.recordsets) ? result.recordsets : [];
+    const rawRows = recordsets[1];
+    const indexes = rawRows !== undefined && rawRows !== null
+        ? Array.from(rawRows)
+        : [];
+    return {
+        summary: recordsets[0]?.[0] ?? null,
+        indexes,
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/serverState.d.ts

@@ -0,0 +1,28 @@
+interface StoredQueryPlan {
+    id: string;
+    databaseName: string | null;
+    query: string;
+    planXml: string;
+    createdAt: string;
+}
+interface StoredQueryResult {
+    id: string;
+    databaseName: string | null;
+    label: string;
+    payload: unknown;
+    createdAt: string;
+}
+export declare class ServerState {
+    private readonly queryPlans;
+    private readonly queryResults;
+    private purgeExpiredQueryArtifacts;
+    private evictOldestByCreatedAt;
+    storeQueryPlan(databaseName: string | undefined, query: string, planXml: string): StoredQueryPlan;
+    getQueryPlan(id: string): StoredQueryPlan | undefined;
+    listQueryPlans(): StoredQueryPlan[];
+    storeQueryResult(databaseName: string | undefined, label: string, payload: unknown): StoredQueryResult;
+    getQueryResult(id: string): StoredQueryResult | undefined;
+    listQueryResults(): StoredQueryResult[];
+}
+export {};
+//# sourceMappingURL=serverState.d.ts.map

package/dist/serverState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverState.d.ts","sourceRoot":"","sources":["../src/serverState.ts"],"names":[],"mappings":"AAEA,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAoBD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;IAErE,OAAO,CAAC,0BAA0B;IAalC,OAAO,CAAC,sBAAsB;IAkB9B,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAiB/E,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAKrD,cAAc,IAAI,eAAe,EAAE;IAOnC,gBAAgB,CACd,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO;IAwBlB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAKzD,gBAAgB,IAAI,iBAAiB,EAAE;CAMxC"}

package/dist/serverState.js

@@ -0,0 +1,99 @@
+import { createHash } from "node:crypto";
+const DEFAULT_MAX_QUERY_PLANS = 100;
+const DEFAULT_MAX_QUERY_RESULTS = 100;
+const QUERY_ARTIFACT_TTL_MS = 60 * 60 * 1000;
+function hashParts(parts) {
+    const hash = createHash("sha256");
+    for (const part of parts) {
+        hash.update(part ?? "");
+        hash.update("\0");
+    }
+    return hash.digest("hex").slice(0, 16);
+}
+function parseIsoMs(iso) {
+    const t = Date.parse(iso);
+    return Number.isFinite(t) ? t : 0;
+}
+export class ServerState {
+    constructor() {
+        this.queryPlans = new Map();
+        this.queryResults = new Map();
+    }
+    purgeExpiredQueryArtifacts(now) {
+        for (const [id, plan] of this.queryPlans) {
+            if (parseIsoMs(plan.createdAt) + QUERY_ARTIFACT_TTL_MS < now) {
+                this.queryPlans.delete(id);
+            }
+        }
+        for (const [id, result] of this.queryResults) {
+            if (parseIsoMs(result.createdAt) + QUERY_ARTIFACT_TTL_MS < now) {
+                this.queryResults.delete(id);
+            }
+        }
+    }
+    evictOldestByCreatedAt(map, maxEntries) {
+        if (map.size <= maxEntries) {
+            return;
+        }
+        const sorted = [...map.values()].sort((a, b) => parseIsoMs(a.createdAt) - parseIsoMs(b.createdAt));
+        while (map.size > maxEntries && sorted.length > 0) {
+            const oldest = sorted.shift();
+            if (oldest) {
+                map.delete(oldest.id);
+            }
+        }
+    }
+    storeQueryPlan(databaseName, query, planXml) {
+        const now = Date.now();
+        this.purgeExpiredQueryArtifacts(now);
+        const createdAt = new Date().toISOString();
+        const id = hashParts([databaseName, query, planXml]);
+        const entry = {
+            id,
+            databaseName: databaseName ?? null,
+            query,
+            planXml,
+            createdAt,
+        };
+        this.queryPlans.set(id, entry);
+        this.evictOldestByCreatedAt(this.queryPlans, DEFAULT_MAX_QUERY_PLANS);
+        return entry;
+    }
+    getQueryPlan(id) {
+        this.purgeExpiredQueryArtifacts(Date.now());
+        return this.queryPlans.get(id);
+    }
+    listQueryPlans() {
+        this.purgeExpiredQueryArtifacts(Date.now());
+        return [...this.queryPlans.values()].sort((a, b) => a.createdAt < b.createdAt ? 1 : -1);
+    }
+    storeQueryResult(databaseName, label, payload) {
+        const now = Date.now();
+        this.purgeExpiredQueryArtifacts(now);
+        const createdAt = new Date().toISOString();
+        const id = hashParts([
+            databaseName,
+            label,
+            JSON.stringify(payload, (_key, value) => value instanceof Date ? value.toISOString() : value),
+        ]);
+        const entry = {
+            id,
+            databaseName: databaseName ?? null,
+            label,
+            payload,
+            createdAt,
+        };
+        this.queryResults.set(id, entry);
+        this.evictOldestByCreatedAt(this.queryResults, DEFAULT_MAX_QUERY_RESULTS);
+        return entry;
+    }
+    getQueryResult(id) {
+        this.purgeExpiredQueryArtifacts(Date.now());
+        return this.queryResults.get(id);
+    }
+    listQueryResults() {
+        this.purgeExpiredQueryArtifacts(Date.now());
+        return [...this.queryResults.values()].sort((a, b) => a.createdAt < b.createdAt ? 1 : -1);
+    }
+}
+//# sourceMappingURL=serverState.js.map

package/dist/serverState.js.map

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

package/dist/sql.d.ts

@@ -0,0 +1,7 @@
+export declare function isSafeSqlIdentifier(value: string): boolean;
+export declare function assertSafeSqlIdentifier(value: string, label?: string): void;
+export declare function quoteIdentifier(value: string): string;
+export declare function buildQualifiedName(objectName: string, schemaName?: string): string;
+export declare function getFriendlyObjectType(typeCode: string): string;
+export declare function getObjectTypeCodes(objectTypes?: string[]): string[];
+//# sourceMappingURL=sql.d.ts.map

package/dist/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../src/sql.ts"],"names":[],"mappings":"AAWA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAM1D;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,KAAK,SAAe,GACnB,IAAI,CAIN;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAQR;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmB9D;AAED,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CA0BnE"}

package/dist/sql.js

@@ -0,0 +1,73 @@
+function containsControlCharacters(value) {
+    for (const character of value) {
+        const codePoint = character.charCodeAt(0);
+        if (codePoint < 32 || codePoint === 127) {
+            return true;
+        }
+    }
+    return false;
+}
+export function isSafeSqlIdentifier(value) {
+    return (typeof value === "string" &&
+        value.trim().length > 0 &&
+        !containsControlCharacters(value));
+}
+export function assertSafeSqlIdentifier(value, label = "identifier") {
+    if (!isSafeSqlIdentifier(value)) {
+        throw new Error(`Invalid ${label}.`);
+    }
+}
+export function quoteIdentifier(value) {
+    assertSafeSqlIdentifier(value);
+    return `[${value.replace(/\]/g, "]]")}]`;
+}
+export function buildQualifiedName(objectName, schemaName) {
+    assertSafeSqlIdentifier(objectName, "object name");
+    if (!schemaName) {
+        return quoteIdentifier(objectName);
+    }
+    assertSafeSqlIdentifier(schemaName, "schema name");
+    return `${quoteIdentifier(schemaName)}.${quoteIdentifier(objectName)}`;
+}
+export function getFriendlyObjectType(typeCode) {
+    switch (typeCode) {
+        case "U":
+            return "table";
+        case "V":
+            return "view";
+        case "P":
+            return "procedure";
+        case "FN":
+        case "IF":
+        case "TF":
+        case "FS":
+        case "FT":
+            return "function";
+        case "TR":
+            return "trigger";
+        default:
+            return "object";
+    }
+}
+export function getObjectTypeCodes(objectTypes) {
+    if (!objectTypes || objectTypes.length === 0) {
+        return ["U", "V", "P", "FN", "IF", "TF", "FS", "FT", "TR"];
+    }
+    const typeMap = {
+        table: ["U"],
+        view: ["V"],
+        procedure: ["P"],
+        function: ["FN", "IF", "TF", "FS", "FT"],
+        trigger: ["TR"],
+    };
+    const resolvedCodes = objectTypes.flatMap((objectType) => {
+        const normalized = objectType.trim().toLowerCase();
+        const codes = typeMap[normalized];
+        if (!codes) {
+            throw new Error(`Unsupported object type '${objectType}'. Expected one of: ${Object.keys(typeMap).join(", ")}.`);
+        }
+        return codes;
+    });
+    return [...new Set(resolvedCodes)];
+}
+//# sourceMappingURL=sql.js.map

package/dist/sql.js.map

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

package/dist/toolRegistry.d.ts

@@ -0,0 +1,20 @@
+import type { ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+export interface RunnableTool {
+    name: string;
+    description?: string;
+    run(params: unknown): Promise<unknown>;
+}
+export interface ToolDefinition {
+    tool: RunnableTool;
+    inputSchema: z.ZodType;
+    outputSchema: z.ZodRawShape;
+    annotations: ToolAnnotations;
+    readOnly: boolean;
+    requiresConfirmation?: boolean;
+    requiresDdl?: boolean;
+    writePreviewTool?: string;
+}
+export declare const toolDefinitions: ToolDefinition[];
+export declare function getAvailableTools(isReadOnly: boolean): ToolDefinition[];
+//# sourceMappingURL=toolRegistry.d.ts.map

package/dist/toolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolRegistry.d.ts","sourceRoot":"","sources":["../src/toolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,YAAY,EAAE,CAAC,CAAC,WAAW,CAAC;IAC5B,WAAW,EAAE,eAAe,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAoHD,eAAO,MAAM,eAAe,EAAE,cAAc,EAwd3C,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,OAAO,GAAG,cAAc,EAAE,CAIvE"}