db-mcp 2.0.0 → 3.0.1

package/dist/utils/validate-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-path.d.ts","sourceRoot":"","sources":["../../src/utils/validate-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,oBAAoB,CAqGtB"}

package/dist/utils/where-clause.d.ts

@@ -0,0 +1,42 @@
+/**
+ * db-mcp - WHERE Clause Validation
+ *
+ * Validates WHERE clause parameters to prevent SQL injection.
+ * Uses a blocklist approach to reject dangerous patterns while
+ * allowing legitimate complex conditions.
+ *
+ * Applies Unicode NFC normalization and full-width character
+ * mapping before pattern matching to prevent homoglyph-based
+ * blocklist bypasses (CWE-20).
+ *
+ * Adapted from postgres-mcp reference implementation for SQLite.
+ */
+/**
+ * Error thrown when an unsafe WHERE clause is detected
+ */
+export declare class UnsafeWhereClauseError extends Error {
+    constructor(reason: string);
+}
+/**
+ * Normalize a WHERE clause string for pattern matching.
+ *
+ * Applies two transformations:
+ * 1. Unicode NFC normalization — collapses composed characters
+ * 2. Full-width Latin → ASCII mapping — converts U+FF01..FF5E to U+0021..007E
+ *
+ * The original input is NOT modified; this returns a copy for blocklist matching.
+ * This prevents attackers from using visually-similar Unicode characters
+ * (e.g., "ＵＮＩＯＮ ＳＥＬＥＣＴ") to bypass ASCII-only regex patterns.
+ */
+export declare function normalizeForPatternMatching(input: string): string;
+export declare function sanitizeWhereClause(where: string): string;
+export interface WhereCondition {
+    column: string;
+    operator: string;
+    value?: unknown;
+}
+export declare function buildWhereClause(conditions?: WhereCondition[], whereClause?: string): {
+    sql: string;
+    params: unknown[];
+};
+//# sourceMappingURL=where-clause.d.ts.map

package/dist/utils/where-clause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"where-clause.d.ts","sourceRoot":"","sources":["../../src/utils/where-clause.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,MAAM,EAAE,MAAM;CAI3B;AA8MD;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA8BjE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA2BzD;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,CAAC,EAAE,cAAc,EAAE,EAC7B,WAAW,CAAC,EAAE,MAAM,GACnB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAmDpC"}

package/dist/version.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Version Constants
+ *
+ * Single source of truth — reads from package.json at runtime.
+ */
+/** Server version from package.json */
+export declare const VERSION: string;
+/** Package name from package.json */
+export declare const NAME: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,uCAAuC;AACvC,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC;AAE3C,qCAAqC;AACrC,eAAO,MAAM,IAAI,EAAE,MAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "db-mcp",
-  "version": "2.0.0",
+  "version": "3.0.1",
   "description": "SQLite MCP server with OAuth 2.1 authentication, HTTP/SSE transport, and smart tool filtering",
   "mcpName": "io.github.neverinfamous/db-mcp",
   "type": "module",
@@ -9,8 +9,15 @@
   "bin": {
     "db-mcp": "./dist/cli.js"
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
-    "build": "tsup",
+    "install": "echo \"Skipping automatic native build to preserve optional dependencies\"",
+    "build": "npm run build:native && npm run build:js && npm run build:types",
+    "build:native": "node-gyp rebuild",
+    "build:js": "tsup",
+    "build:types": "tsc --project tsconfig.build.json --emitDeclarationOnly",
     "dev": "tsx watch src/index.ts",
     "start": "node dist/index.js",
     "start:stdio": "node dist/cli.js --transport=stdio",
@@ -19,6 +26,7 @@
     "lint:fix": "eslint . --fix",
     "lint:json": "eslint . --format json --output-file eslint-results.json",
     "typecheck": "tsc --noEmit",
+    "typecheck:tests": "tsc --noEmit --project tsconfig.test.json",
     "check": "npm run lint && npm run typecheck",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -53,12 +61,18 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "cors": "^2.8.5",
-    "express": "^5.2.1",
-    "jose": "^6.2.1",
-    "sql.js": "^1.14.1",
-    "zod": "^3.25.0 || ^4.0.0"
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "cors": "2.8.6",
+    "express": "5.2.1",
+    "express-rate-limit": "8.5.2",
+    "isolated-vm": "6.1.2",
+    "jose": "6.2.3",
+    "rate-limit-redis": "^5.0.0",
+    "redis": "^6.0.0",
+    "sql.js": "1.14.1",
+    "sqlite-parser": "^1.0.1",
+    "zod": "^4.4.3",
+    "zod-to-json-schema": "3.25.2"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
@@ -71,19 +85,18 @@
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^10.0.2",
     "globals": "^17.4.0",
+    "node-addon-api": "^8.8.0",
     "rimraf": "^6.1.3",
     "tsup": "^8.5.1",
     "tsx": "^4.22.1",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.57.1",
+    "typescript-eslint": "^8.60.0",
     "vitest": "^4.0.17"
   },
-  "peerDependencies": {
-    "zod": "^3.25.0 || ^4.0.0"
-  },
   "optionalDependencies": {
-    "better-sqlite3": "^12.8.0"
+    "better-sqlite3": "^12.10.0"
   },
+  "//overrides": "Transitive CVE patches. Review quarterly or when dockerfile-patch-drift.yml flags staleness.",
   "overrides": {
     "diff": "9.0.0",
     "@isaacs/brace-expansion": "5.0.1",

package/.gitattributes

@@ -1,2 +0,0 @@
-# Normalize line endings to LF on all platforms
-* text=auto eol=lf

package/.gitleaks.toml

@@ -1,9 +0,0 @@
-# Gitleaks Configuration
-# https://github.com/gitleaks/gitleaks#configuration
-
-title = "db-mcp gitleaks config"
-
-# Allowlist for known false positives in test fixtures
-[allowlist]
-  description = "Test fixtures containing intentionally fake secrets"
-  paths = []

package/.trivyignore

@@ -1,8 +0,0 @@
-# Trivy CVE Ignore List for db-mcp
-# Add CVEs here that are:
-# 1. False positives
-# 2. Upstream issues with no fix available
-# 3. Not applicable to our use case
-
-# Format: CVE-YYYY-NNNNN
-tmp/

package/dist/chunk-OKOVZ5QE.js

@@ -1,28 +0,0 @@
-// src/codemode/auto-return.ts
-var NON_RETURNABLE = /^\s*(return|throw|const |let |var |if\b|else\b|for\b|while\b|do\b|switch\b|try\b|catch\b|finally\b|class |function |\/\/|\/\*|\{|\})/;
-function transformAutoReturn(code) {
-  const trimmed = code.trimEnd();
-  if (!trimmed) return code;
-  let depth = 0;
-  let splitIndex = -1;
-  for (let i = trimmed.length - 1; i >= 0; i--) {
-    const ch = trimmed.charAt(i);
-    if (ch === "}" || ch === "]" || ch === ")") depth++;
-    else if (ch === "{" || ch === "[" || ch === "(") depth--;
-    if (depth === 0 && (ch === ";" || ch === "\n")) {
-      splitIndex = i;
-      break;
-    }
-  }
-  const lastStmt = (splitIndex >= 0 ? trimmed.slice(splitIndex + 1) : trimmed).trim();
-  if (!lastStmt) return code;
-  if (NON_RETURNABLE.test(lastStmt)) return code;
-  if (splitIndex >= 0) {
-    const before = trimmed.slice(0, splitIndex + 1);
-    return `${before}
-return ${lastStmt}`;
-  }
-  return `return ${trimmed}`;
-}
-
-export { transformAutoReturn };

package/dist/chunk-SFJQCNG7.js

@@ -1,131 +0,0 @@
-import { AsyncLocalStorage } from 'async_hooks';
-
-// src/auth/auth-context.ts
-var authContextStorage = new AsyncLocalStorage();
-function runWithAuthContext(context, fn) {
-  return authContextStorage.run(context, fn);
-}
-function getAuthContext() {
-  return authContextStorage.getStore();
-}
-
-// src/auth/scopes/constants.ts
-var SCOPES = {
-  /** Read-only access to all databases */
-  READ: "read",
-  /** Read and write access to all databases */
-  WRITE: "write",
-  /** Administrative access */
-  ADMIN: "admin",
-  /** Unrestricted access to all operations */
-  FULL: "full"
-};
-var BASE_SCOPES = ["read", "write", "admin", "full"];
-var SCOPE_PATTERNS = {
-  /** Read-only access */
-  READ: "read",
-  /** Read and write access */
-  WRITE: "write",
-  /** Administrative access */
-  ADMIN: "admin",
-  /** Unrestricted access */
-  FULL: "full",
-  /** Database-specific access pattern */
-  DATABASE: /^db:([a-zA-Z0-9_-]+)$/,
-  /** Table-specific access pattern */
-  TABLE: /^table:([a-zA-Z0-9_-]+):([a-zA-Z0-9_-]+)$/
-};
-var SUPPORTED_SCOPES = [
-  "read",
-  "write",
-  "admin",
-  "full",
-  "db:{database}",
-  "table:{database}:{table}"
-];
-function parseScopes(scopeString) {
-  return scopeString.split(/\s+/).map((s) => s.trim()).filter((s) => s.length > 0);
-}
-
-// src/auth/scopes/mapping.ts
-var TOOL_GROUP_SCOPES = {
-  core: SCOPES.READ,
-  json: SCOPES.READ,
-  text: SCOPES.READ,
-  stats: SCOPES.READ,
-  vector: SCOPES.READ,
-  geo: SCOPES.READ,
-  introspection: SCOPES.READ,
-  migration: SCOPES.WRITE,
-  transactions: SCOPES.WRITE,
-  admin: SCOPES.ADMIN,
-  codemode: SCOPES.ADMIN
-};
-var groupsForScope = (maxScope) => {
-  const hierarchy = {
-    read: 0,
-    write: 1,
-    admin: 2,
-    full: 3
-  };
-  const maxLevel = hierarchy[maxScope];
-  return Object.entries(TOOL_GROUP_SCOPES).filter(([, scope]) => hierarchy[scope] <= maxLevel).map(([group]) => group);
-};
-groupsForScope(SCOPES.READ);
-groupsForScope(SCOPES.WRITE);
-groupsForScope(SCOPES.ADMIN);
-var READ_ONLY_TOOLS = /* @__PURE__ */ new Set([
-  "execute_query",
-  // If used with SELECT only
-  "read_query",
-  "list_tables",
-  "describe_table",
-  "list_schemas",
-  "get_schema",
-  "health_check",
-  "connection_status",
-  "database_stats",
-  "active_queries",
-  "resource_usage",
-  "analyze_query",
-  "explain_query",
-  "query_plan"
-]);
-var ADMIN_TOOLS = /* @__PURE__ */ new Set([
-  "vacuum_database",
-  "analyze_tables",
-  "pragma_get",
-  "pragma_set",
-  "extension_list",
-  "extension_install",
-  "optimize",
-  "backup_database",
-  "restore_database",
-  "backup_table",
-  "export_data"
-]);
-
-// src/auth/scopes/enforcement.ts
-function scopeGrantsToolAccess(scope, toolName) {
-  if (scope === "full") {
-    return true;
-  }
-  if (scope === "admin") {
-    return true;
-  }
-  if (scope === "write") {
-    if (ADMIN_TOOLS.has(toolName)) {
-      return false;
-    }
-    return true;
-  }
-  if (scope === "read") {
-    return READ_ONLY_TOOLS.has(toolName);
-  }
-  return false;
-}
-function scopesGrantToolAccess(scopes, toolName) {
-  return scopes.some((scope) => scopeGrantsToolAccess(scope, toolName));
-}
-
-export { BASE_SCOPES, SCOPES, SCOPE_PATTERNS, SUPPORTED_SCOPES, TOOL_GROUP_SCOPES, getAuthContext, parseScopes, runWithAuthContext, scopesGrantToolAccess };

package/dist/chunk-VIDSICEL.js

@@ -1,85 +0,0 @@
-import { createRequire } from 'module';
-
-// src/version.ts
-var _require = createRequire(import.meta.url);
-var pkg = _require("../package.json");
-var VERSION = pkg.version;
-var NAME = pkg.name;
-
-// src/utils/icons.ts
-var MDI_BASE = "https://cdn.jsdelivr.net/npm/@mdi/svg@7.4.47/svg";
-var SERVER_ICONS = [
-  {
-    src: `${MDI_BASE}/server.svg`,
-    mimeType: "image/svg+xml"
-  }
-];
-var TOOL_GROUP_ICONS = {
-  core: [{ src: `${MDI_BASE}/database.svg`, mimeType: "image/svg+xml" }],
-  json: [{ src: `${MDI_BASE}/code-json.svg`, mimeType: "image/svg+xml" }],
-  text: [{ src: `${MDI_BASE}/format-text.svg`, mimeType: "image/svg+xml" }],
-  stats: [{ src: `${MDI_BASE}/chart-bar.svg`, mimeType: "image/svg+xml" }],
-  vector: [
-    { src: `${MDI_BASE}/vector-polyline.svg`, mimeType: "image/svg+xml" }
-  ],
-  admin: [{ src: `${MDI_BASE}/cog.svg`, mimeType: "image/svg+xml" }],
-  transactions: [
-    { src: `${MDI_BASE}/swap-horizontal.svg`, mimeType: "image/svg+xml" }
-  ],
-  geo: [{ src: `${MDI_BASE}/earth.svg`, mimeType: "image/svg+xml" }],
-  introspection: [
-    { src: `${MDI_BASE}/graph-outline.svg`, mimeType: "image/svg+xml" }
-  ],
-  migration: [
-    { src: `${MDI_BASE}/source-branch.svg`, mimeType: "image/svg+xml" }
-  ],
-  codemode: [{ src: `${MDI_BASE}/code-braces.svg`, mimeType: "image/svg+xml" }]
-};
-function getToolGroupIcon(group) {
-  return TOOL_GROUP_ICONS[group];
-}
-
-// src/utils/annotations.ts
-var READ_ONLY = {
-  readOnlyHint: true,
-  destructiveHint: false,
-  openWorldHint: false
-};
-var WRITE = {
-  readOnlyHint: false,
-  destructiveHint: false,
-  openWorldHint: false
-};
-var DESTRUCTIVE = {
-  readOnlyHint: false,
-  destructiveHint: true,
-  openWorldHint: false
-};
-var IDEMPOTENT = {
-  readOnlyHint: false,
-  destructiveHint: false,
-  idempotentHint: true,
-  openWorldHint: false
-};
-var ADMIN = {
-  readOnlyHint: false,
-  destructiveHint: false,
-  openWorldHint: false
-};
-function readOnly(title) {
-  return { title, ...READ_ONLY };
-}
-function write(title) {
-  return { title, ...WRITE };
-}
-function destructive(title) {
-  return { title, ...DESTRUCTIVE };
-}
-function idempotent(title) {
-  return { title, ...IDEMPOTENT };
-}
-function admin(title) {
-  return { title, ...ADMIN };
-}
-
-export { NAME, READ_ONLY, SERVER_ICONS, VERSION, admin, destructive, getToolGroupIcon, idempotent, readOnly, write };

package/dist/chunk-X3MUUOWM.js

@@ -1,152 +0,0 @@
-import { DbMcpError, findSuggestion } from './chunk-645ZEFLA.js';
-
-// src/utils/errors/classes.ts
-var ValidationError = class extends DbMcpError {
-  constructor(message, code = "VALIDATION_ERROR", options) {
-    super(message, code, "validation" /* VALIDATION */, {
-      ...options,
-      recoverable: false
-    });
-  }
-};
-var ConnectionError = class extends DbMcpError {
-  constructor(message, code = "CONNECTION_ERROR", options) {
-    super(message, code, "connection" /* CONNECTION */, {
-      ...options,
-      recoverable: true
-      // Connection errors are often transient
-    });
-  }
-};
-var QueryError = class extends DbMcpError {
-  constructor(message, code = "QUERY_ERROR", options) {
-    super(message, code, "query" /* QUERY */, {
-      ...options,
-      details: {
-        ...options?.details,
-        sql: options?.sql
-      },
-      recoverable: false
-    });
-  }
-};
-var ResourceNotFoundError = class extends DbMcpError {
-  constructor(message, code = "RESOURCE_NOT_FOUND", options) {
-    super(message, code, "resource" /* RESOURCE */, {
-      ...options,
-      details: {
-        ...options?.details,
-        resourceType: options?.resourceType,
-        resourceName: options?.resourceName
-      },
-      recoverable: false
-    });
-  }
-};
-var ConfigurationError = class extends DbMcpError {
-  constructor(message, code = "CONFIG_ERROR", options) {
-    super(message, code, "config" /* CONFIGURATION */, {
-      ...options,
-      recoverable: false
-    });
-  }
-};
-var AuthenticationError = class extends DbMcpError {
-  constructor(message, code = "AUTHENTICATION_ERROR", options) {
-    super(message, code, "authentication" /* AUTHENTICATION */, {
-      ...options,
-      recoverable: false
-    });
-  }
-};
-var AuthorizationError = class extends DbMcpError {
-  constructor(message, code = "AUTHORIZATION_ERROR", options) {
-    super(message, code, "authorization" /* AUTHORIZATION */, {
-      ...options,
-      recoverable: false
-    });
-  }
-};
-var ExtensionNotAvailableError = class extends DbMcpError {
-  constructor(extensionName, options) {
-    const isWasm = options?.wasmLimitation ?? options?.details?.["wasmLimitation"] ?? false;
-    const baseMessage = `Extension '${extensionName}' is not installed or available`;
-    const message = isWasm === true ? `${baseMessage} in WASM mode` : baseMessage;
-    super(message, "EXTENSION_MISSING", "config" /* CONFIGURATION */, {
-      suggestion: options?.suggestion ?? `Install or enable the '${extensionName}' extension. Check environment variable or CLI flag configuration.`,
-      details: {
-        extension: extensionName,
-        ...options?.details,
-        ...isWasm === true ? { wasmLimitation: true } : {}
-      },
-      recoverable: false,
-      cause: options?.cause
-    });
-  }
-};
-
-// src/utils/errors/format.ts
-var CATEGORY_DEFAULT_CODES = {
-  ["validation" /* VALIDATION */]: "VALIDATION_ERROR",
-  ["connection" /* CONNECTION */]: "CONNECTION_ERROR",
-  ["query" /* QUERY */]: "QUERY_ERROR",
-  ["permission" /* PERMISSION */]: "PERMISSION_ERROR",
-  ["config" /* CONFIGURATION */]: "CONFIG_ERROR",
-  ["resource" /* RESOURCE */]: "RESOURCE_ERROR",
-  ["authentication" /* AUTHENTICATION */]: "AUTHENTICATION_ERROR",
-  ["authorization" /* AUTHORIZATION */]: "AUTHORIZATION_ERROR",
-  ["internal" /* INTERNAL */]: "UNKNOWN_ERROR"
-};
-function formatZodError(error) {
-  if (!("issues" in error) || !Array.isArray(error["issues"])) {
-    return null;
-  }
-  const issues = error["issues"];
-  return issues.map((issue) => {
-    const pathStr = Array.isArray(issue.path) && issue.path.length > 0 ? `${issue.path.join(".")}: ` : "";
-    return `${pathStr}${issue.message ?? "Unknown validation error"}`;
-  }).join("; ");
-}
-function formatHandlerError(error, _context) {
-  if (error instanceof DbMcpError) {
-    return error.toResponse();
-  }
-  if (error instanceof Error) {
-    const zodMessage = formatZodError(error);
-    if (zodMessage !== null) {
-      return {
-        success: false,
-        error: zodMessage,
-        code: "VALIDATION_ERROR",
-        category: "validation" /* VALIDATION */,
-        suggestion: void 0,
-        recoverable: false,
-        details: void 0
-      };
-    }
-  }
-  if (error instanceof Error) {
-    const match = findSuggestion(error.message);
-    const category = match?.category ?? "internal" /* INTERNAL */;
-    return {
-      success: false,
-      error: error.message,
-      code: match?.code ?? CATEGORY_DEFAULT_CODES[category],
-      category,
-      suggestion: match?.suggestion,
-      recoverable: false,
-      details: void 0
-    };
-  }
-  return {
-    success: false,
-    error: String(error),
-    code: "UNKNOWN_ERROR",
-    category: "internal" /* INTERNAL */,
-    suggestion: void 0,
-    recoverable: false,
-    details: void 0
-  };
-}
-
-export { AuthenticationError, AuthorizationError, ConfigurationError, ConnectionError, ExtensionNotAvailableError, QueryError, ResourceNotFoundError, ValidationError, formatHandlerError };

package/dist/worker-script.d.ts

@@ -1,2 +0,0 @@
-
-export {  }