db-mcp 3.0.0 → 3.0.2

package/dist/{chunk-THATOQRT.js → chunk-37G4DLL6.js}

@@ -31,7 +31,9 @@ Read \`sqlite://help\` for gotchas and critical usage patterns.
 Read \`sqlite://help/{group}\` for group-specific tool reference (core, json, text, stats, vector, geo, admin, transactions, introspection, migration).
 Only help resources for your enabled tool groups are registered.`;
 var HELP_CONTENT = /* @__PURE__ */ new Map([
-  ["admin", `# db-mcp Help \u2014 Database Administration (32N/31W tools) + Server Audit (5 tools)
+  [
+    "admin",
+    `# db-mcp Help \u2014 Database Administration (32N/31W tools) + Server Audit (5 tools)
 
 ## Maintenance
 
@@ -144,8 +146,11 @@ sqlite_create_csv_table({
 
 \`\`\`javascript
 sqlite_append_insight({ insight: "Q4 revenue increased 23% YoY" }); // add to memo://insights
-\`\`\``],
-  ["core", `# db-mcp Help \u2014 Core Operations (21 tools)
+\`\`\``
+  ],
+  [
+    "core",
+    `# db-mcp Help \u2014 Core Operations (21 tools)
 
 ## Basic Queries
 
@@ -178,8 +183,11 @@ sqlite_append_insight({ insight: "Q4 revenue increased 23% YoY" }); // add to me
 - \`sqlite_exists({ table: "users", where: "email = 'test@example.com'" })\` \u2014 check if a row exists (stops at first match)
 - \`sqlite_truncate({ table: "users" })\` \u2014 quickly delete all rows from a table (executes \`DELETE FROM table\`)
 - \`sqlite_date_add({ table: "users", column: "created_at", amount: 7, unit: "days", whereClause: "id = 1" })\` \u2014 add or subtract time intervals from a date column. By default returns only the computed column; use \`selectColumns\` to return additional context.
-- \`sqlite_date_diff({ table: "users", column1: "ended_at", column2: "started_at", unit: "days", whereClause: "id = 1" })\` \u2014 calculate the difference between two date columns. By default returns only the computed column; use \`selectColumns\` to return additional context.`],
-  ["geo", `# db-mcp Help \u2014 Geospatial Operations (11N/4W: 4 basic + 7 SpatiaLite [NATIVE ONLY])
+- \`sqlite_date_diff({ table: "users", column1: "ended_at", column2: "started_at", unit: "days", whereClause: "id = 1" })\` \u2014 calculate the difference between two date columns. By default returns only the computed column; use \`selectColumns\` to return additional context.`
+  ],
+  [
+    "geo",
+    `# db-mcp Help \u2014 Geospatial Operations (11N/4W: 4 basic + 7 SpatiaLite [NATIVE ONLY])
 
 ## Basic Geo (always available \u2014 Haversine formula)
 
@@ -284,8 +292,11 @@ sqlite_spatialite_index({
   geometryColumn: "geom",
   action: "create",
 }); // create, drop, or check
-\`\`\``],
-  ["gotchas", `# db-mcp Help \u2014 Gotchas & Code Mode
+\`\`\``
+  ],
+  [
+    "gotchas",
+    `# db-mcp Help \u2014 Gotchas & Code Mode
 
 ## \u26A0\uFE0F Critical Gotchas
 
@@ -346,8 +357,11 @@ sqlite_spatialite_index({
 
 **Positional args work**: \`sqlite.core.readQuery("SELECT...")\`, \`sqlite.json.insert("docs", "data", {...})\`
 
-**Discovery**: \`sqlite.help()\` returns all groups and methods. \`sqlite.core.help()\`, \`sqlite.json.help()\` for group-specific methods.`],
-  ["introspection", `# db-mcp Help \u2014 Schema Introspection (10 tools)
+**Discovery**: \`sqlite.help()\` returns all groups and methods. \`sqlite.core.help()\`, \`sqlite.json.help()\` for group-specific methods.`
+  ],
+  [
+    "introspection",
+    `# db-mcp Help \u2014 Schema Introspection (10 tools)
 
 All introspection tools are **read-only** \u2014 they query PRAGMAs and sqlite_master, never modify data.
 
@@ -428,8 +442,11 @@ sqlite_query_plan({ sql: "SELECT * FROM orders WHERE status = 'active'" });
 ## \u26A0\uFE0F Gotchas
 
 - \`excludeSystemTables\` defaults to \`true\` \u2014 SpatiaLite system tables are hidden for cleaner output. Pass \`false\` to include them
-- \`sqlite_migration_risks\` analyzes DDL text statically \u2014 it does NOT execute the statements`],
-  ["json", `# db-mcp Help \u2014 JSON Operations (25 tools)
+- \`sqlite_migration_risks\` analyzes DDL text statically \u2014 it does NOT execute the statements`
+  ],
+  [
+    "json",
+    `# db-mcp Help \u2014 JSON Operations (25 tools)
 
 ## Collection & CRUD
 
@@ -503,8 +520,11 @@ sqlite_json_group_object({
 
 - \`sqlite_json_storage_info({ table, column })\` \u2014 check text vs JSONB format
 - \`sqlite_jsonb_convert({ table, column })\` \u2014 convert to JSONB for faster queries
-- \`sqlite_json_normalize_column({ table, column, outputFormat? })\` \u2014 normalize JSON (sort keys, compact). \u26A0\uFE0F Defaults to \`"preserve"\` (maintains original format); use \`outputFormat: "text"\` to force text output`],
-  ["migration", `# db-mcp Help \u2014 Migration Tracking (6 tools)
+- \`sqlite_json_normalize_column({ table, column, outputFormat? })\` \u2014 normalize JSON (sort keys, compact). \u26A0\uFE0F Defaults to \`"preserve"\` (maintains original format); use \`outputFormat: "text"\` to force text output`
+  ],
+  [
+    "migration",
+    `# db-mcp Help \u2014 Migration Tracking (6 tools)
 
 \u26A0\uFE0F Must call \`sqlite_migration_init()\` before using any other migration tool \u2014 it creates the tracking table.
 
@@ -546,8 +566,11 @@ sqlite_migration_status();
 ## \u26A0\uFE0F Gotchas
 
 - Rollback requires \`rollbackSql\` to have been provided when the migration was recorded/applied
-- Migration group is **opt-in** \u2014 not included by default. Enable via \`--tool-filter\` flag: use \`dev-schema\` (core+introspection+migration+codemode) or \`full\` (all groups)`],
-  ["stats", `# db-mcp Help \u2014 Statistical Analysis (23N/17W: 17 core + 6 window [NATIVE ONLY])
+- Migration group is **opt-in** \u2014 not included by default. Enable via \`--tool-filter\` flag: use \`dev-schema\` (core+introspection+migration+codemode) or \`full\` (all groups)`
+  ],
+  [
+    "stats",
+    `# db-mcp Help \u2014 Statistical Analysis (23N/17W: 17 core + 6 window [NATIVE ONLY])
 
 ## Core Statistics (always available)
 
@@ -666,8 +689,11 @@ sqlite_window_moving_avg({
   windowSize: 7,
   selectColumns: ["date"],
 });
-\`\`\``],
-  ["text", `# db-mcp Help \u2014 Text Processing & FTS5 (19N/14W: 14 text + 5 FTS5 [NATIVE ONLY])
+\`\`\``
+  ],
+  [
+    "text",
+    `# db-mcp Help \u2014 Text Processing & FTS5 (19N/14W: 14 text + 5 FTS5 [NATIVE ONLY])
 
 ## Full-Text Search / FTS5 (5 tools, Native only)
 
@@ -805,8 +831,11 @@ sqlite_text_sentiment({
   returnWords: true,
 });
 // \u2192 { sentiment: "neutral", score: 0, matchedPositive: ["great"], matchedNegative: ["slow"] }
-\`\`\``],
-  ["transactions", `# db-mcp Help \u2014 Transactions (8 tools, Native only)
+\`\`\``
+  ],
+  [
+    "transactions",
+    `# db-mcp Help \u2014 Transactions (8 tools, Native only)
 
 ## Atomic Execution (preferred for simple cases)
 
@@ -837,8 +866,11 @@ sqlite_transaction_status(); // \u2192 { status: "active" | "none", active: true
 
 - Transaction tools are **Native only** \u2014 WASM adapter does not support transactions
 - Use \`sqlite_transaction_execute\` for simple multi-statement operations; manual \`begin\`/\`commit\` for complex flows with savepoints
-- \`sqlite_transaction_status\` is read-only and requires only \`read\` scope; all other transaction tools require \`write\` scope`],
-  ["vector", `# db-mcp Help \u2014 Vector/Semantic Search (11 tools)
+- \`sqlite_transaction_status\` is read-only and requires only \`read\` scope; all other transaction tools require \`write\` scope`
+  ],
+  [
+    "vector",
+    `# db-mcp Help \u2014 Vector/Semantic Search (11 tools)
 
 \`\`\`javascript
 // Create vector table with metadata columns
@@ -864,7 +896,8 @@ sqlite_vector_stats({ table: "docs", vectorColumn: "emb" }); // returns sampleSi
 // Utility tools for preprocessing
 sqlite_vector_normalize({ vector: [3, 4, 0, 0] }); // returns unit vector [0.6, 0.8, 0, 0]
 sqlite_vector_distance({ vector1: [...], vector2: [...], metric: "cosine" }); // returns { value: <number> }
-\`\`\``]
+\`\`\``
+  ]
 ]);
 var BUFFER_HIGH_WATER = 50;
 var FLUSH_INTERVAL_MS = 100;
@@ -1819,7 +1852,6 @@ function registerAuditBackupTools(server, backupManager, adaptersMap) {
         destructiveHint: false,
         idempotentHint: true,
         openWorldHint: false
-        // Requires admin scope
       }
     },
     async (args) => {
@@ -1887,7 +1919,6 @@ function registerAuditBackupTools(server, backupManager, adaptersMap) {
         destructiveHint: false,
         idempotentHint: true,
         openWorldHint: false
-        // Requires admin scope
       }
     },
     async (args) => {
@@ -1993,7 +2024,6 @@ function registerAuditBackupTools(server, backupManager, adaptersMap) {
         destructiveHint: false,
         idempotentHint: true,
         openWorldHint: false
-        // Requires admin scope
       }
     },
     async (args) => {

package/dist/{chunk-FR65YPAH.js → chunk-NV34JSQM.js}

@@ -13572,7 +13572,7 @@ function createPragmaSettingsTool(adapter) {
     inputSchema: PragmaSettingsSchema,
     outputSchema: PragmaSettingsOutputSchema,
     requiredScopes: ["admin"],
-    annotations: { ...admin("PRAGMA Settings"), openWorldHint: true },
+    annotations: admin("PRAGMA Settings"),
     handler: async (_params, _context) => {
       let input;
       try {

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { DEFAULT_CONFIG, createServer } from './chunk-THATOQRT.js';
+import { DEFAULT_CONFIG, createServer } from './chunk-37G4DLL6.js';
 import { VERSION } from './chunk-E5IESRTK.js';
 import { logger } from './chunk-L552U3QS.js';
 
@@ -344,11 +344,11 @@ async function main() {
       if (dbConfig.type === "sqlite") {
         const options = dbConfig.options;
         if (options?.backend === "better-sqlite3") {
-          const { NativeSqliteAdapter } = await import('./sqlite-native-ZSSWCTYC.js');
+          const { NativeSqliteAdapter } = await import('./sqlite-native-IF75BB3O.js');
           const adapter = new NativeSqliteAdapter();
           await server.registerAdapter(adapter, dbConfig);
         } else {
-          const { SqliteAdapter } = await import('./sqlite-6C3AJI4I.js');
+          const { SqliteAdapter } = await import('./sqlite-TB56Z7G3.js');
           const adapter = new SqliteAdapter();
           await server.registerAdapter(adapter, dbConfig);
         }

package/dist/constants/server-instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-instructions.d.ts","sourceRoot":"","sources":["../../src/constants/server-instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,yxBAmBwC,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAm0BnD,CAAC"}
+{"version":3,"file":"server-instructions.d.ts","sourceRoot":"","sources":["../../src/constants/server-instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,yxBAmBwC,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAo2BnD,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
-export { DEFAULT_CONFIG, DbMcpServer, createServer } from './chunk-THATOQRT.js';
+export { DEFAULT_CONFIG, DbMcpServer, createServer } from './chunk-37G4DLL6.js';
 export { DatabaseAdapter } from './chunk-W5WQVNVX.js';
 export { NAME, VERSION } from './chunk-E5IESRTK.js';
 export { ALL_TOOL_GROUPS, AuthenticationError, AuthorizationError, ConnectionError, DbMcpError, META_GROUPS, QueryError, TOOL_GROUPS, ValidationError, filterTools, getFilterSummary, getToolFilterFromEnv, isToolEnabled, parseToolFilter } from './chunk-L552U3QS.js';

package/dist/{sqlite-6C3AJI4I.js → sqlite-TB56Z7G3.js}

@@ -1,5 +1,5 @@
-import { getCoreTools, getJsonHelperTools, getJsonOperationTools, getTextTools, getStatsTools, getVirtualTools, getVectorTools, getGeoTools, getAdminTools, getIntrospectionTools, getMigrationTools, getCodeModeTools, executeRead, executeWrite, isDDL, executeGeneral, getResourceDefinitions, getPromptDefinitions, applyCommonPragmas, autoEnableWal, detectAndSetJsonbSupport, SchemaManager } from './chunk-FR65YPAH.js';
-export { getCoreTools } from './chunk-FR65YPAH.js';
+import { getCoreTools, getJsonHelperTools, getJsonOperationTools, getTextTools, getStatsTools, getVirtualTools, getVectorTools, getGeoTools, getAdminTools, getIntrospectionTools, getMigrationTools, getCodeModeTools, executeRead, executeWrite, isDDL, executeGeneral, getResourceDefinitions, getPromptDefinitions, applyCommonPragmas, autoEnableWal, detectAndSetJsonbSupport, SchemaManager } from './chunk-NV34JSQM.js';
+export { getCoreTools } from './chunk-NV34JSQM.js';
 import { DatabaseAdapter } from './chunk-W5WQVNVX.js';
 import { getToolGroupIcon, VERSION } from './chunk-E5IESRTK.js';
 import { createModuleLogger, ConnectionError, ConfigurationError, ERROR_CODES, DbMcpError } from './chunk-L552U3QS.js';

package/dist/{sqlite-native-ZSSWCTYC.js → sqlite-native-IF75BB3O.js}

@@ -1,4 +1,4 @@
-import { RowRecordSchema, WhereConditionSchema, sanitizeIdentifier, buildWhereClause, resolveAliases, autoEnableWal, detectAndSetJsonbSupport, SchemaManager, applyCommonPragmas, isDDL, getResourceDefinitions, getPromptDefinitions, validateIdentifier, normalizeSqliteParams, translateSqliteError, getCoreTools, getJsonOperationTools, getJsonHelperTools, getTextTools, getStatsTools, getVirtualTools, getVectorTools, getGeoTools, getAdminTools, getIntrospectionTools, getMigrationTools, getCodeModeTools, validateTableExists, FtsHeadlineSchema } from './chunk-FR65YPAH.js';
+import { RowRecordSchema, WhereConditionSchema, sanitizeIdentifier, buildWhereClause, resolveAliases, autoEnableWal, detectAndSetJsonbSupport, SchemaManager, applyCommonPragmas, isDDL, getResourceDefinitions, getPromptDefinitions, validateIdentifier, normalizeSqliteParams, translateSqliteError, getCoreTools, getJsonOperationTools, getJsonHelperTools, getTextTools, getStatsTools, getVirtualTools, getVectorTools, getGeoTools, getAdminTools, getIntrospectionTools, getMigrationTools, getCodeModeTools, validateTableExists, FtsHeadlineSchema } from './chunk-NV34JSQM.js';
 import { DatabaseAdapter } from './chunk-W5WQVNVX.js';
 import { ErrorResponseFields, write, readOnly, VERSION, admin, writeFs, getToolGroupIcon, idempotent } from './chunk-E5IESRTK.js';
 import { logger, formatHandlerError, ValidationError, ConfigurationError, ERROR_CODES, ConnectionError, DbMcpError, ResourceNotFoundError, ExtensionNotAvailableError } from './chunk-L552U3QS.js';

package/dist/transports/http/sessions/stateful.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stateful.d.ts","sourceRoot":"","sources":["../../../../src/transports/http/sessions/stateful.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAUtD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAOT;AAYD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CA0QtE"}
+{"version":3,"file":"stateful.d.ts","sourceRoot":"","sources":["../../../../src/transports/http/sessions/stateful.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAUtD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAOT;AAYD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CA4QtE"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "db-mcp",
-  "version": "3.0.0",
-  "description": "SQLite MCP server with OAuth 2.1 authentication, HTTP/SSE transport, and smart tool filtering",
+  "version": "3.0.2",
+  "description": "SQLite MCP Server — Secure Database Administration & Observability with Code Mode. True V8 Isolate Sandbox Unifying 170+ Specialized Tools with Highly Optimized Payloads for 70–90% Token Savings. Includes Dynamic Tool Filtering, Dual-Transport HTTP/SSE, OAuth 2.1 Auth, Granular Access Control, Audit Logging, & Deterministic Error Handling.",
   "mcpName": "io.github.neverinfamous/db-mcp",
   "type": "module",
   "main": "dist/index.js",
@@ -26,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",
@@ -60,6 +61,7 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
+    "acorn": "^8.16.0",
     "@modelcontextprotocol/sdk": "1.29.0",
     "cors": "2.8.6",
     "express": "5.2.1",