@eamonboyle/mssql-mcp 1.1.0 → 1.3.0

package/README.md

@@ -4,8 +4,8 @@
 [![npm version](https://img.shields.io/npm/v/@eamonboyle/mssql-mcp.svg)](https://www.npmjs.com/package/@eamonboyle/mssql-mcp)
 [![Node.js 18+](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
 
-[![Add to Cursor](https://img.shields.io/badge/Add_to-Cursor-000000?style=for-the-badge&logo=cursor&logoColor=white)](https://cursor.com/en/install-mcp?name=MSSQL&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBlYW1vbmJveWxlL21zc3FsLW1jcCJdLCJlbnYiOnsiU0VSVkVSX05BTUUiOiJsb2NhbGhvc3QiLCJEQVRBQkFTRV9OQU1FIjoiWW91ckRhdGFiYXNlIiwiREJfVVNFUiI6IiIsIkRCX1BBU1NXT1JEIjoiIiwiUkVBRE9OTFkiOiJmYWxzZSJ9fQ==)
-[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://intradeus.github.io/http-protocol-redirector?r=vscode%3A%2F%2Fmcp%2Finstall%3F%257B%2522name%2522%253A%2522mssql%2522%252C%2522type%2522%253A%2522stdio%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540eamonboyle%252Fmssql-mcp%2522%255D%252C%2522env%2522%253A%257B%2522SERVER_NAME%2522%253A%2522localhost%2522%252C%2522DATABASE_NAME%2522%253A%2522YourDatabase%2522%252C%2522DB_USER%2522%253A%2522%2522%252C%2522DB_PASSWORD%2522%253A%2522%2522%252C%2522READONLY%2522%253A%2522false%2522%257D%257D)
+[![Add to Cursor](https://img.shields.io/badge/Add_to-Cursor-000000?style=for-the-badge&logo=cursor&logoColor=white)](https://cursor.com/en/install-mcp?name=MSSQL&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBlYW1vbmJveWxlL21zc3FsLW1jcCJdLCJlbnYiOnsiU0VSVkVSX05BTUUiOiJsb2NhbGhvc3QiLCJEQVRBQkFTRV9OQU1FIjoiWW91ckRhdGFiYXNlIiwiREFUQUJBU0VTIjoiIiwiREJfVVNFUiI6IiIsIkRCX1BBU1NXT1JEIjoiIiwiUkVBRE9OTFkiOiJmYWxzZSIsIkNPTk5FQ1RJT05fVElNRU9VVCI6IjMwIiwiUVVFUllfVElNRU9VVF9NUyI6IjMwMDAwIiwiTUFYX1JPV1MiOiIxMDAwMCIsIlRSVVNUX1NFUlZFUl9DRVJUSUZJQ0FURSI6ImZhbHNlIiwiTUNQX1RSQU5TUE9SVCI6InN0ZGlvIiwiTUNQX0hUVFBfSE9TVCI6IjEyNy4wLjAuMSIsIk1DUF9IVFRQX1BPUlQiOiIzMzMzIiwiTUNQX0JBU0VfVVJMIjoiIiwiRU5BQkxFX0RETCI6ImZhbHNlIiwiTUFYX1dSSVRFX1JPV1MiOiIxMDAiLCJSRVFVSVJFX1dSSVRFX1BSRVZJRVciOiJ0cnVlIn19)
+[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://intradeus.github.io/http-protocol-redirector?r=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522mssql%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540eamonboyle%252Fmssql-mcp%2522%255D%252C%2522env%2522%253A%257B%2522SERVER_NAME%2522%253A%2522localhost%2522%252C%2522DATABASE_NAME%2522%253A%2522YourDatabase%2522%252C%2522DATABASES%2522%253A%2522%2522%252C%2522DB_USER%2522%253A%2522%2522%252C%2522DB_PASSWORD%2522%253A%2522%2522%252C%2522READONLY%2522%253A%2522false%2522%252C%2522CONNECTION_TIMEOUT%2522%253A%252230%2522%252C%2522QUERY_TIMEOUT_MS%2522%253A%252230000%2522%252C%2522MAX_ROWS%2522%253A%252210000%2522%252C%2522TRUST_SERVER_CERTIFICATE%2522%253A%2522false%2522%252C%2522MCP_TRANSPORT%2522%253A%2522stdio%2522%252C%2522MCP_HTTP_HOST%2522%253A%2522127.0.0.1%2522%252C%2522MCP_HTTP_PORT%2522%253A%25223333%2522%252C%2522MCP_BASE_URL%2522%253A%2522%2522%252C%2522ENABLE_DDL%2522%253A%2522false%2522%252C%2522MAX_WRITE_ROWS%2522%253A%2522100%2522%252C%2522REQUIRE_WRITE_PREVIEW%2522%253A%2522true%2522%257D%257D)
 
 > ⚠️ **EXPERIMENTAL USE ONLY** — This MCP Server is provided for educational and experimental purposes. It is NOT intended for production use. Use appropriate security measures and test thoroughly before any deployment.
 
@@ -23,11 +23,16 @@ AI: *queries your MSSQL database and returns the results in plain English*
 ## Features 📊
 
 - **Natural language to SQL** — Ask questions in plain English
-- **CRUD operations** — Create, read, update, and delete data
-- **Schema management** — Create tables, indexes; describe and drop tables
+- **Row-level CRUD support** — Read, insert, update, and delete rows with dedicated tools
+- **Schema discovery** — Inspect tables, views, procedures, functions, and triggers
+- **Safer write workflows** — `preview_update` and `preview_delete` plus confirmation gating for destructive tools
+- **Rich text tool results** — Concise summaries with JSON inlined in the primary text block when helpful, plus resource links for large artifacts
+- **Query analysis** — Generate estimated execution plans with `explain_query`
+- **MCP resources and prompts** — Expose schema snapshots, query artifacts, and prompt templates to capable clients
+- **Remote transport support** — Run locally over `stdio` or remotely over Streamable HTTP
 - **Multi-database support** — Connect to multiple databases on the same server
-- **Read-only mode** — Restrict to SELECT-only for safer environments
-- **Secure by default** — WHERE clauses required for reads/updates; SQL injection safeguards
+- **Read-only mode** — Restrict to inspection, search, read, and explain tools for safer environments
+- **Secure by default** — WHERE clauses required for updates/deletes; SQL injection safeguards for reads; DDL tools off unless `ENABLE_DDL=true`
 
 ## Supported AI Clients
 
@@ -40,7 +45,11 @@ AI: *queries your MSSQL database and returns the results in plain English*
 
 ### One-Click Install (Cursor / VS Code)
 
-Click **Add to Cursor** or **Install in VS Code** above to add the MCP server. Edit the config to add your database credentials (`DB_USER`, `DB_PASSWORD`, etc.). No cloning required—runs via `npx`.
+Click **Add to Cursor** or **Install in VS Code** above to add the MCP server—no cloning required; it runs via `npx`.
+
+**Cursor** opens a dedicated install page that lists env vars you can edit before saving (similar to a short form). The **Add to Cursor** preset includes every variable from the table below (connection, timeouts, **`ENABLE_DDL`** defaulting to **`false`**, write caps, **`MCP_TRANSPORT`** / HTTP settings, **`MCP_BASE_URL`**, etc.); set **`ENABLE_DDL`** to **`true`** there if you want schema tools.
+
+**VS Code** only applies the JSON embedded in the `vscode:mcp/install` link: you get static placeholder values, not an interactive database wizard. To be prompted for host, database, and credentials when the server starts, add [`inputs`](https://code.visualstudio.com/docs/copilot/reference/mcp-configuration#_input-variables-for-sensitive-data) to `.vscode/mcp.json` as in the **Prompted inputs** example under **VS Code (`mcp.json`)** below.
 
 ### Prerequisites
 
@@ -80,15 +89,24 @@ npm run build
 | `READONLY`                 | No       | `"true"` for read-only mode, `"false"` for full access (default: `"false"`)          |
 | `DATABASES`                | No       | Comma-separated allowlist for multi-database access (e.g., `ProdDB,StagingDB`)       |
 | `CONNECTION_TIMEOUT`       | No       | Timeout in seconds (default: `30`)                                                   |
+| `QUERY_TIMEOUT_MS`         | No       | Query timeout in milliseconds (default: `30000`)                                     |
+| `MAX_ROWS`                 | No       | Maximum rows returned by read tools (default: `10000`)                               |
 | `TRUST_SERVER_CERTIFICATE` | No       | `"true"` for self-signed certs (e.g., local dev) (default: `"false"`)                |
+| `MCP_TRANSPORT`            | No       | `stdio` (default) or `http`                                                          |
+| `MCP_HTTP_HOST`            | No       | Bind host for Streamable HTTP mode (default: `127.0.0.1`)                            |
+| `MCP_HTTP_PORT`            | No       | Bind port for Streamable HTTP mode (default: `3333`)                                 |
+| `MCP_BASE_URL`             | No       | Optional externally visible base URL for remote deployments                          |
+| `ENABLE_DDL`               | No       | `"true"` enables `create_table`, `create_index`, and `drop_table` (default: `false`) |
+| `MAX_WRITE_ROWS`           | No       | Maximum rows a single write tool may affect before it is blocked (default: `100`)    |
+| `REQUIRE_WRITE_PREVIEW`    | No       | `"true"` (default): call `preview_update` / `preview_delete`, then pass the returned `previewToken` with `confirmed=true` on `update_data` / `delete_data`. Set `"false"` to skip the token (confirmation still applies). |
 
 \* Required for SQL authentication. For Windows/Integrated authentication, consult the [mssql](https://www.npmjs.com/package/mssql) package documentation.
 
 \*\* Required for single-database setups. When `DATABASES` is provided, `DATABASE_NAME` becomes optional and is used as the default database if set.
 
-### Option 1: Cursor / VS Code Setup
+### Cursor (`mcp.json`)
 
-1. Create or edit `.vscode/mcp.json` in your workspace:
+Use [global or project MCP config](https://cursor.com/docs/context/mcp): e.g. `~/.cursor/mcp.json` or `.cursor/mcp.json` in your repo.
 
 ```json
 {
@@ -109,9 +127,113 @@ npm run build
 }
 ```
 
-2. Restart Cursor/VS Code.
+Restart Cursor after changes.
+
+### Cursor HTTP MCP
+
+To expose the server remotely over Streamable HTTP:
+
+```json
+{
+  "mcpServers": {
+    "mssql-http": {
+      "url": "http://127.0.0.1:3333"
+    }
+  }
+}
+```
+
+Run the server with:
+
+```bash
+MCP_TRANSPORT=http MCP_HTTP_HOST=127.0.0.1 MCP_HTTP_PORT=3333 npx -y @eamonboyle/mssql-mcp
+```
+
+### VS Code (`mcp.json`)
+
+VS Code uses `.vscode/mcp.json` (or **MCP: Open User Configuration**) with a top-level [`servers`](https://code.visualstudio.com/docs/copilot/reference/mcp-configuration) object—**not** `mcpServers`.
 
-### Option 2: Claude Desktop Setup
+**Static env** (same idea as the one-click link; edit values in the file):
+
+```json
+{
+  "servers": {
+    "mssql": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@eamonboyle/mssql-mcp"],
+      "env": {
+        "SERVER_NAME": "localhost",
+        "DATABASE_NAME": "AppDB",
+        "DATABASES": "AppDB,ReportingDB",
+        "DB_USER": "your_username",
+        "DB_PASSWORD": "your_password",
+        "READONLY": "false",
+        "CONNECTION_TIMEOUT": "30",
+        "QUERY_TIMEOUT_MS": "30000",
+        "MAX_ROWS": "10000",
+        "TRUST_SERVER_CERTIFICATE": "false"
+      }
+    }
+  }
+}
+```
+
+**Prompted inputs** (closest to Cursor’s hosted form: VS Code asks on first start, then stores values). Use `${input:…}` in `env` and define matching entries under `inputs`:
+
+```json
+{
+  "inputs": [
+    {
+      "type": "promptString",
+      "id": "mssql-server",
+      "description": "SQL Server host (e.g. localhost or my-server.database.windows.net)"
+    },
+    {
+      "type": "promptString",
+      "id": "mssql-database",
+      "description": "Default database name"
+    },
+    {
+      "type": "promptString",
+      "id": "mssql-databases",
+      "description": "Optional: comma-separated DB allowlist (e.g. AppDB,ReportingDB). Leave empty for a single database."
+    },
+    {
+      "type": "promptString",
+      "id": "mssql-user",
+      "description": "SQL Server login (SQL authentication)"
+    },
+    {
+      "type": "promptString",
+      "id": "mssql-password",
+      "description": "SQL Server password",
+      "password": true
+    }
+  ],
+  "servers": {
+    "mssql": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@eamonboyle/mssql-mcp"],
+      "env": {
+        "SERVER_NAME": "${input:mssql-server}",
+        "DATABASE_NAME": "${input:mssql-database}",
+        "DATABASES": "${input:mssql-databases}",
+        "DB_USER": "${input:mssql-user}",
+        "DB_PASSWORD": "${input:mssql-password}",
+        "READONLY": "false",
+        "CONNECTION_TIMEOUT": "30",
+        "QUERY_TIMEOUT_MS": "30000",
+        "MAX_ROWS": "10000",
+        "TRUST_SERVER_CERTIFICATE": "false"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop Setup
 
 1. Open **File → Settings → Developer → Edit Config**
 2. Add the MCP server configuration:
@@ -166,30 +288,55 @@ See `src/samples/` for example configs:
 Once configured, you can ask things like:
 
 - "Show me all users from New York"
+- "List the configured databases this MCP can access"
+- "Preview the rows that would be updated before changing status to archived"
+- "Explain this query and open the execution plan viewer"
+- "Show the foreign keys and relationships around dbo.Orders"
+- "Search the customers table for email addresses containing acme.com"
 - "Create a new table called products with columns for id, name, and price"
 - "Update all pending orders to completed status"
+- "Delete inactive sessions older than 30 days"
 - "List all tables in the database"
 - "Describe the schema of the customers table"
+- "List all views and procedures in the reporting database"
+- "Explain why this SELECT query is slow"
 
 ## Available Tools
 
-| Tool             | Read-only | Description                  |
-| ---------------- | --------- | ---------------------------- |
-| `read_data`      | ✓         | Execute SELECT queries       |
-| `list_table`     | ✓         | List tables in a database    |
-| `describe_table` | ✓         | Get table schema             |
-| `insert_data`    |           | Insert rows                  |
-| `update_data`    |           | Update rows (requires WHERE) |
-| `create_table`   |           | Create tables                |
-| `create_index`   |           | Create indexes               |
-| `drop_table`     |           | Drop tables                  |
+| Tool              | Read-only | Description                                             |
+| ----------------- | --------- | ------------------------------------------------------- |
+| `read_data`       | ✓         | Execute validated SELECT queries                        |
+| `search_data`     | ✓         | Search one or more columns with parameterized `LIKE`    |
+| `explain_query`   | ✓         | Get an estimated execution plan for a SELECT query      |
+| `list_table`      | ✓         | List tables in a database                               |
+| `describe_table`  | ✓         | Get table schema (optional `schemaName`)                |
+| `list_objects`    | ✓         | List tables, views, procedures, functions, and triggers |
+| `describe_object` | ✓         | Describe an object definition and metadata              |
+| `insert_data`     |           | Insert rows                                             |
+| `update_data`     |           | Update rows (requires WHERE; optional `schemaName`)     |
+| `delete_data`     |           | Delete rows (requires WHERE; optional `schemaName`)     |
+| `create_table`    |           | Create tables                                           |
+| `create_index`    |           | Create indexes                                          |
+| `drop_table`      |           | Drop tables                                             |
+
+## Resources And Prompts
+
+Clients that support MCP resources and prompts can use additional discovery surfaces:
+
+- **Resources** — Server config, prompt catalog, per-database table lists, per-database object lists, and dynamic table/object resources
+- **Prompts** — `explore_schema`, `draft_safe_select`, and `review_write_operation`
+
+## Changelog
+
+Release notes: [CHANGELOG.md](https://github.com/eamonboyle/mssql-mcp/blob/main/CHANGELOG.md).
 
 ## Security Notes
 
 - **Credentials** — Never commit `DB_USER`/`DB_PASSWORD` or config files with secrets. Use environment variables or a secrets manager.
 - **Read-only mode** — Set `READONLY: "true"` when you only need queries.
-- **WHERE clauses** — Read and update operations require explicit WHERE clauses to reduce accidental full-table operations.
+- **WHERE clauses** — Update and delete operations require explicit WHERE clauses to reduce accidental full-table changes.
 - **SQL injection** — The server validates and restricts dangerous SQL patterns.
+- **DDL tools** — Disabled by default (`ENABLE_DDL` unset or `false`). Set `ENABLE_DDL=true` only if the assistant should create/drop tables or indexes.
 
 ## Contributing
 

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+export type McpTransportMode = "stdio" | "http";
+export declare function getMaxRows(): number;
+export declare function getQueryTimeoutMs(): number;
+export declare function getDefaultSearchLimit(): number;
+export declare function clampRowLimit(limit: unknown, fallback?: number): number;
+export declare function getMcpTransport(): McpTransportMode;
+export declare function getMcpHttpPort(): number;
+export declare function getMcpHttpHost(): string;
+export declare function getMcpBaseUrl(): string | undefined;
+export declare function isDdlEnabled(): boolean;
+export declare function getMaxWriteRows(): number;
+export declare function isWritePreviewRequired(): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AA4CA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEhD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAe,GAAG,MAAM,CAa7E;AAED,wBAAgB,eAAe,IAAI,gBAAgB,CAIlD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAGlD;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD"}

package/dist/config.js

@@ -0,0 +1,74 @@
+const DEFAULT_MAX_ROWS = 10000;
+const DEFAULT_QUERY_TIMEOUT_MS = 30000;
+const DEFAULT_SEARCH_LIMIT = 100;
+const DEFAULT_HTTP_PORT = 3333;
+const DEFAULT_HTTP_HOST = "127.0.0.1";
+const DEFAULT_MAX_WRITE_ROWS = 100;
+function parsePositiveInt(value, fallback, minimum = 1) {
+    if (!value) {
+        return fallback;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed < minimum) {
+        return fallback;
+    }
+    return parsed;
+}
+function parseBoolean(value, fallback) {
+    if (!value) {
+        return fallback;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true") {
+        return true;
+    }
+    if (normalized === "false") {
+        return false;
+    }
+    return fallback;
+}
+export function getMaxRows() {
+    return parsePositiveInt(process.env.MAX_ROWS, DEFAULT_MAX_ROWS);
+}
+export function getQueryTimeoutMs() {
+    return parsePositiveInt(process.env.QUERY_TIMEOUT_MS, DEFAULT_QUERY_TIMEOUT_MS);
+}
+export function getDefaultSearchLimit() {
+    return Math.min(getMaxRows(), DEFAULT_SEARCH_LIMIT);
+}
+export function clampRowLimit(limit, fallback = getMaxRows()) {
+    const parsed = typeof limit === "number"
+        ? limit
+        : typeof limit === "string"
+            ? Number.parseInt(limit, 10)
+            : Number.NaN;
+    if (!Number.isFinite(parsed) || parsed < 1) {
+        return Math.min(fallback, getMaxRows());
+    }
+    return Math.min(Math.floor(parsed), getMaxRows());
+}
+export function getMcpTransport() {
+    return process.env.MCP_TRANSPORT?.trim().toLowerCase() === "http"
+        ? "http"
+        : "stdio";
+}
+export function getMcpHttpPort() {
+    return parsePositiveInt(process.env.MCP_HTTP_PORT, DEFAULT_HTTP_PORT);
+}
+export function getMcpHttpHost() {
+    return process.env.MCP_HTTP_HOST?.trim() || DEFAULT_HTTP_HOST;
+}
+export function getMcpBaseUrl() {
+    const value = process.env.MCP_BASE_URL?.trim();
+    return value ? value : undefined;
+}
+export function isDdlEnabled() {
+    return parseBoolean(process.env.ENABLE_DDL, false);
+}
+export function getMaxWriteRows() {
+    return parsePositiveInt(process.env.MAX_WRITE_ROWS, DEFAULT_MAX_WRITE_ROWS);
+}
+export function isWritePreviewRequired() {
+    return parseBoolean(process.env.REQUIRE_WRITE_PREVIEW, true);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/db.d.ts

@@ -1,25 +1,30 @@
-import sql from "mssql";
-/**
- * Returns the list of allowed database names.
- * If DATABASES is set, returns those; otherwise returns only DATABASE_NAME.
- */
-export declare function getAllowedDatabases(): string[];
-/**
- * Resolves the database name to use (param or default).
- * Returns null if invalid.
- */
-export declare function resolveDatabaseName(databaseName?: string): string | null;
-/**
- * Ensures a connection pool exists for the given database.
- */
-export declare function ensureSqlConnection(databaseName: string): Promise<sql.ConnectionPool>;
-/**
- * Returns a sql.Request for the given database.
- * Resolves database name (param or default), validates against allowed list,
- * ensures connection, and returns pool.request().
- */
-export declare function getSqlRequest(databaseName?: string): Promise<{
-    request: sql.Request;
-    error?: string;
-}>;
+import sql from "mssql";
+export declare function getDefaultDatabaseName(): string | null;
+/**
+ * Returns the list of allowed database names.
+ * If DATABASES is set, returns those; otherwise returns only DATABASE_NAME.
+ */
+export declare function getAllowedDatabases(): string[];
+/**
+ * Resolves the database name to use (param or default).
+ * Returns null if invalid.
+ */
+export declare function resolveDatabaseName(databaseName?: string): string | null;
+/**
+ * Ensures a connection pool exists for the given database.
+ */
+export declare function ensureSqlConnection(databaseName: string): Promise<sql.ConnectionPool>;
+/**
+ * Returns a sql.Request for the given database.
+ * Resolves database name (param or default), validates against allowed list,
+ * ensures connection, and returns pool.request().
+ */
+export declare function getSqlRequest(databaseName?: string): Promise<{
+    request: sql.Request;
+    error?: string;
+}>;
+export declare function getDedicatedSqlPool(databaseName?: string): Promise<{
+    pool: sql.ConnectionPool;
+    error?: string;
+}>;
 //# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,OAAO,CAAC;AA+BxB;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAQ9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQxE;AAwBD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAoB7B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBnD"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,OAAO,CAAC;AAiBxB,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAatD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAQ9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQxE;AA6CD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAoB7B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAWnD;AAED,wBAAsB,mBAAmB,CACvC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,IAAI,EAAE,GAAG,CAAC,cAAc,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBvD"}