db-mcp 2.0.0 → 3.0.0

package/dist/adapters/sqlite-native/native-sqlite-adapter.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Native SQLite Adapter using better-sqlite3
+ *
+ * Provides synchronous, native SQLite access with full FTS5, window functions,
+ * and SpatiaLite support.
+ */
+import type { Database as BetterSqliteDb } from "better-sqlite3";
+import { DatabaseAdapter } from "../database-adapter.js";
+import type { DatabaseConfig, DatabaseType, HealthStatus, IndexInfo, QueryResult, SchemaInfo, TableInfo, AdapterCapabilities, ToolDefinition, ResourceDefinition, PromptDefinition, ToolGroup } from "../../types/index.js";
+/**
+ * Native SQLite Adapter using better-sqlite3
+ */
+export declare class NativeSqliteAdapter extends DatabaseAdapter {
+    readonly type: DatabaseType;
+    readonly name = "Native SQLite Adapter (better-sqlite3)";
+    readonly version: string;
+    /**
+     * Check if this adapter uses native (better-sqlite3) backend.
+     * Returns true for native adapter.
+     */
+    isNativeBackend(): boolean;
+    /**
+     * Get the configured database file path.
+     * Returns the user-configured path, not internal WASM virtual filesystem paths.
+     */
+    getConfiguredPath(): string;
+    private db;
+    private schemaManager;
+    private cachedToolDefinitions;
+    /**
+     * Connect to a SQLite database using better-sqlite3
+     */
+    connect(config: DatabaseConfig): Promise<void>;
+    /**
+     * Apply SQLite PRAGMA options and load extensions
+     */
+    private applyOptions;
+    /**
+     * Disconnect from the database
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get health status
+     */
+    getHealth(): Promise<HealthStatus>;
+    /**
+     * Check if FTS5 is available via compile options.
+     * Uses PRAGMA compile_options instead of creating a virtual table probe,
+     * which can fail when SpatiaLite extensions are loaded.
+     */
+    private hasFts5;
+    /**
+     * Execute a read query
+     */
+    executeReadQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Execute a write query
+     */
+    executeWriteQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Execute any query
+     */
+    executeQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Execute a SQL script containing multiple statements
+     */
+    executeScript(sql: string): Promise<void>;
+    /**
+     * Get schema information (cached via SchemaManager)
+     */
+    getSchema(): Promise<SchemaInfo>;
+    /**
+     * List all tables (cached via SchemaManager)
+     */
+    listTables(): Promise<TableInfo[]>;
+    /**
+     * Describe a table (cached via SchemaManager)
+     */
+    describeTable(tableName: string): Promise<TableInfo>;
+    /**
+     * List schemas (SQLite only has one)
+     */
+    listSchemas(): Promise<string[]>;
+    /**
+     * Get indexes, optionally for a specific table (cached via SchemaManager)
+     */
+    getIndexes(table?: string): Promise<IndexInfo[]>;
+    /**
+     * Get all indexes in the database (cached via SchemaManager)
+     * Required by sqlite_indexes resource
+     */
+    getAllIndexes(): Promise<IndexInfo[]>;
+    /**
+     * Clear the schema metadata cache.
+     * Called automatically after DDL operations.
+     */
+    clearSchemaCache(): void;
+    /**
+     * Get capabilities
+     */
+    getCapabilities(): AdapterCapabilities;
+    /**
+     * Get supported tool groups
+     */
+    getSupportedToolGroups(): ToolGroup[];
+    /**
+     * Get all tool definitions (cached — immutable per adapter instance)
+     */
+    getToolDefinitions(): ToolDefinition[];
+    /**
+     * Get resource definitions
+     */
+    getResourceDefinitions(): ResourceDefinition[];
+    /**
+     * Get prompt definitions
+     */
+    getPromptDefinitions(): PromptDefinition[];
+    /**
+     * Ensure database is connected
+     */
+    protected ensureConnected(): void;
+    /**
+     * Ensure database is connected and return database instance
+     */
+    private ensureDb;
+    /**
+     * Get the raw database instance (for tools)
+     */
+    getDatabase(): BetterSqliteDb;
+    /**
+     * Execute raw SQL and return results (for tools)
+     */
+    rawQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Begin a transaction
+     */
+    beginTransaction(): void;
+    /**
+     * Commit a transaction
+     */
+    commitTransaction(): void;
+    /**
+     * Rollback a transaction
+     */
+    rollbackTransaction(): void;
+    /**
+     * Create a savepoint
+     */
+    savepoint(name: string): void;
+    /**
+     * Release a savepoint
+     */
+    releaseSavepoint(name: string): void;
+    /**
+     * Rollback to a savepoint
+     */
+    rollbackToSavepoint(name: string): void;
+}
+export declare function createNativeSqliteAdapter(): NativeSqliteAdapter;
+//# sourceMappingURL=native-sqlite-adapter.d.ts.map

package/dist/adapters/sqlite-native/native-sqlite-adapter.d.ts.map

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

package/dist/adapters/sqlite-native/registration/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tool Registration for Native SQLite Adapter
+ *
+ * Extracts the lengthy tool registration array from the main adapter class.
+ */
+import type { ToolDefinition } from "../../../types/index.js";
+import type { NativeSqliteAdapter } from "../native-sqlite-adapter.js";
+/**
+ * Build the full list of tool definitions for the native adapter.
+ */
+export declare function getNativeToolDefinitions(adapter: NativeSqliteAdapter): ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/sqlite-native/registration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/sqlite-native/registration/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAwBvE;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,EAAE,CAoClB"}

package/dist/adapters/sqlite-native/tools/spatialite/analysis.d.ts

@@ -0,0 +1,23 @@
+/**
+ * SpatiaLite Analysis & Import Tool Implementations
+ *
+ * Spatial analysis, geometry transforms, and data import tools.
+ * - sqlite_spatialite_analyze
+ * - sqlite_spatialite_transform
+ * - sqlite_spatialite_import
+ */
+import type { ToolDefinition } from "../../../../types/index.js";
+import type { NativeSqliteAdapter } from "../../native-sqlite-adapter.js";
+/**
+ * Spatial analysis
+ */
+export declare function createSpatialAnalysisTool(adapter: NativeSqliteAdapter): ToolDefinition;
+/**
+ * Geometry transformation operations
+ */
+export declare function createGeometryTransformTool(adapter: NativeSqliteAdapter): ToolDefinition;
+/**
+ * Import spatial data
+ */
+export declare function createSpatialImportTool(adapter: NativeSqliteAdapter): ToolDefinition;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/adapters/sqlite-native/tools/spatialite/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/sqlite-native/tools/spatialite/analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAsB1E;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CA+KhB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CAwIhB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CAiKhB"}

package/dist/adapters/sqlite-native/tools/spatialite/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SpatiaLite Geospatial Tools — Public Exports
+ *
+ * Provides true GIS capabilities via SpatiaLite extension.
+ * These tools gracefully fail if SpatiaLite is not installed.
+ * 7 tools total (Native-only).
+ */
+import type { ToolDefinition } from "../../../../types/index.js";
+import type { NativeSqliteAdapter } from "../../native-sqlite-adapter.js";
+export { isSpatialiteLoaded } from "./loader.js";
+/**
+ * Get all SpatiaLite tools
+ */
+export declare function getSpatialiteTools(adapter: NativeSqliteAdapter): ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/sqlite-native/tools/spatialite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/sqlite-native/tools/spatialite/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAa1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,EAAE,CAUlB"}

package/dist/adapters/sqlite-native/tools/spatialite/loader.d.ts

@@ -0,0 +1,22 @@
+import type { NativeSqliteAdapter } from "../../native-sqlite-adapter.js";
+declare const SPATIALITE_PATHS: string[];
+/** Exported for use by tool schemas */
+export { SPATIALITE_PATHS };
+/**
+ * Try to load SpatiaLite extension
+ */
+export declare function tryLoadSpatialite(adapter: NativeSqliteAdapter): {
+    success: boolean;
+    path?: string;
+    error?: string;
+};
+/**
+ * Check if SpatiaLite is loaded
+ * Exported for health check access
+ */
+export declare function isSpatialiteLoaded(adapter: NativeSqliteAdapter): boolean;
+/**
+ * Ensure SpatiaLite is loaded, throw if not
+ */
+export declare function ensureSpatialite(adapter: NativeSqliteAdapter): void;
+//# sourceMappingURL=loader.d.ts.map

package/dist/adapters/sqlite-native/tools/spatialite/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/sqlite-native/tools/spatialite/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAW1E,QAAA,MAAM,gBAAgB,UAQkB,CAAC;AAEzC,uCAAuC;AACvC,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAU5B;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA6DA;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAgBxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAUnE"}

package/dist/adapters/sqlite-native/tools/spatialite/schemas.d.ts

@@ -0,0 +1,78 @@
+/**
+ * SpatiaLite Zod Schemas
+ *
+ * Input validation schemas for all SpatiaLite tool parameters.
+ */
+import { z } from "zod";
+declare const VALID_ANALYSIS_TYPES: readonly ["nearest_neighbor", "point_in_polygon", "distance_matrix", "spatial_extent"];
+declare const VALID_INDEX_ACTIONS: readonly ["create", "drop", "check"];
+declare const VALID_FORMATS: readonly ["wkt", "geojson"];
+declare const VALID_OPERATIONS: readonly ["buffer", "intersection", "union", "difference", "centroid", "envelope", "simplify"];
+declare const VALID_COLUMN_TYPES: readonly ["TEXT", "INTEGER", "REAL", "BLOB", "NUMERIC", "VARCHAR", "BOOLEAN", "DATE", "DATETIME", "TIMESTAMP"];
+export { VALID_ANALYSIS_TYPES, VALID_INDEX_ACTIONS, VALID_FORMATS, VALID_OPERATIONS, VALID_COLUMN_TYPES, };
+export declare const LoadSpatialiteSchema: z.ZodObject<{
+    forceReload: z.ZodPreprocess<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+}, z.core.$strip>;
+export declare const CreateSpatialTableSchema: z.ZodObject<{
+    tableName: z.ZodString;
+    geometryColumn: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    geometryType: z.ZodPreprocess<z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        POINT: "POINT";
+        LINESTRING: "LINESTRING";
+        POLYGON: "POLYGON";
+        MULTIPOINT: "MULTIPOINT";
+        MULTILINESTRING: "MULTILINESTRING";
+        MULTIPOLYGON: "MULTIPOLYGON";
+        GEOMETRY: "GEOMETRY";
+    }>>>>;
+    srid: z.ZodPreprocess<z.ZodDefault<z.ZodOptional<z.ZodNumber>>>;
+    additionalColumns: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            BOOLEAN: "BOOLEAN";
+            TEXT: "TEXT";
+            INTEGER: "INTEGER";
+            REAL: "REAL";
+            BLOB: "BLOB";
+            NUMERIC: "NUMERIC";
+            VARCHAR: "VARCHAR";
+            DATE: "DATE";
+            DATETIME: "DATETIME";
+            TIMESTAMP: "TIMESTAMP";
+        }>>>;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+export declare const SpatialQuerySchema: z.ZodObject<{
+    query: z.ZodString;
+    params: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+}, z.core.$strip>;
+export declare const SpatialAnalysisSchema: z.ZodObject<{
+    analysisType: z.ZodString;
+    sourceTable: z.ZodString;
+    targetTable: z.ZodOptional<z.ZodString>;
+    geometryColumn: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    limit: z.ZodPreprocess<z.ZodDefault<z.ZodOptional<z.ZodNumber>>>;
+    excludeSelf: z.ZodPreprocess<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+    includeGeometry: z.ZodPreprocess<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+}, z.core.$strip>;
+export declare const SpatialIndexSchema: z.ZodObject<{
+    tableName: z.ZodString;
+    geometryColumn: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    action: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export declare const GeometryTransformSchema: z.ZodObject<{
+    operation: z.ZodString;
+    geometry1: z.ZodString;
+    geometry2: z.ZodOptional<z.ZodString>;
+    distance: z.ZodPreprocess<z.ZodDefault<z.ZodOptional<z.ZodNumber>>>;
+    srid: z.ZodPreprocess<z.ZodDefault<z.ZodOptional<z.ZodNumber>>>;
+    simplifyTolerance: z.ZodPreprocess<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export declare const SpatialImportSchema: z.ZodObject<{
+    tableName: z.ZodString;
+    format: z.ZodString;
+    data: z.ZodString;
+    srid: z.ZodPreprocess<z.ZodDefault<z.ZodOptional<z.ZodNumber>>>;
+    additionalData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/adapters/sqlite-native/tools/spatialite/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/sqlite-native/tools/spatialite/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkDxB,QAAA,MAAM,oBAAoB,wFAKhB,CAAC;AACX,QAAA,MAAM,mBAAmB,sCAAuC,CAAC;AACjE,QAAA,MAAM,aAAa,6BAA8B,CAAC;AAClD,QAAA,MAAM,gBAAgB,gGAQZ,CAAC;AAEX,QAAA,MAAM,kBAAkB,gHAWd,CAAC;AASX,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GACnB,CAAC;AAEF,eAAO,MAAM,oBAAoB;;iBAS/B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyCnC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;iBAO7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;iBA0ChC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;iBAY7B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;iBA6BlC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;iBAY9B,CAAC"}

package/dist/adapters/sqlite-native/tools/spatialite/tools.d.ts

@@ -0,0 +1,30 @@
+/**
+ * SpatiaLite Core Tool Implementations
+ *
+ * Core SpatiaLite tool creator functions:
+ * - sqlite_spatialite_load
+ * - sqlite_spatialite_create_table
+ * - sqlite_spatialite_query
+ * - sqlite_spatialite_index
+ *
+ * Analysis, transform, and import tools are in analysis.ts.
+ */
+import type { ToolDefinition } from "../../../../types/index.js";
+import type { NativeSqliteAdapter } from "../../native-sqlite-adapter.js";
+/**
+ * Load SpatiaLite extension
+ */
+export declare function createLoadSpatialiteTool(adapter: NativeSqliteAdapter): ToolDefinition;
+/**
+ * Create spatial table
+ */
+export declare function createSpatialTableTool(adapter: NativeSqliteAdapter): ToolDefinition;
+/**
+ * Execute spatial query
+ */
+export declare function createSpatialQueryTool(adapter: NativeSqliteAdapter): ToolDefinition;
+/**
+ * Spatial index management
+ */
+export declare function createSpatialIndexTool(adapter: NativeSqliteAdapter): ToolDefinition;
+//# sourceMappingURL=tools.d.ts.map

package/dist/adapters/sqlite-native/tools/spatialite/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/sqlite-native/tools/spatialite/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AA2B1E;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CA6ChB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CAkHhB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CAuChB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CA2MhB"}

package/dist/adapters/sqlite-native/tools/transactions.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Transaction Tools for Native SQLite Adapter
+ *
+ * Provides transaction control tools for complex multi-statement operations.
+ */
+import type { ToolDefinition } from "../../../types/index.js";
+import type { NativeSqliteAdapter } from "../native-sqlite-adapter.js";
+/**
+ * Get all transaction tools
+ */
+export declare function getTransactionTools(adapter: NativeSqliteAdapter): ToolDefinition[];
+//# sourceMappingURL=transactions.d.ts.map

package/dist/adapters/sqlite-native/tools/transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../../../src/adapters/sqlite-native/tools/transactions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AA2CvE;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,EAAE,CAWlB"}

package/dist/adapters/sqlite-native/tools/window.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from "../../../types/index.js";
+import type { NativeSqliteAdapter } from "../native-sqlite-adapter.js";
+/**
+ * Get all window function tools
+ */
+export declare function getWindowTools(adapter: NativeSqliteAdapter): ToolDefinition[];
+//# sourceMappingURL=window.d.ts.map

package/dist/adapters/sqlite-native/tools/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../../../src/adapters/sqlite-native/tools/window.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAybvE;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,EAAE,CAS7E"}

package/dist/adapters/sqlite-native/transaction-methods.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Native SQLite Transaction Methods
+ *
+ * Transaction management utilities extracted from NativeSqliteAdapter
+ * to keep the main adapter file under the 500-line limit.
+ */
+import type { Database as BetterSqliteDb } from "better-sqlite3";
+/**
+ * Transaction-related helpers. Callers catch thrown errors via `instanceof Error`
+ * and wrap with `formatHandlerError`.
+ */
+/**
+ * Begin a transaction
+ */
+export declare function beginTransaction(db: BetterSqliteDb): void;
+/**
+ * Commit a transaction
+ */
+export declare function commitTransaction(db: BetterSqliteDb): void;
+/**
+ * Rollback a transaction
+ */
+export declare function rollbackTransaction(db: BetterSqliteDb): void;
+/**
+ * Create a savepoint
+ */
+export declare function savepoint(db: BetterSqliteDb, name: string): void;
+/**
+ * Release a savepoint
+ */
+export declare function releaseSavepoint(db: BetterSqliteDb, name: string): void;
+/**
+ * Rollback to a savepoint
+ */
+export declare function rollbackToSavepoint(db: BetterSqliteDb, name: string): void;
+//# sourceMappingURL=transaction-methods.d.ts.map

package/dist/adapters/sqlite-native/transaction-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-methods.d.ts","sourceRoot":"","sources":["../../../src/adapters/sqlite-native/transaction-methods.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGjE;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAE5D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAShE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAOvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAO1E"}

package/dist/audit/backup-manager.d.ts

@@ -0,0 +1,90 @@
+/**
+ * db-mcp — Backup Manager
+ *
+ * Pre-mutation snapshot capture for the audit trail.
+ * Creates DDL snapshots (+ optional data) of database objects
+ * before write/admin tools modify them. Snapshots are stored
+ * as gzip-compressed JSON files in a `snapshots/` directory
+ * alongside the audit log.
+ *
+ * DDL is captured from sqlite_master (`SELECT sql FROM sqlite_master`).
+ * Volume metadata uses `COUNT(*)` and page-count pragmas.
+ *
+ * Non-throwing by design: snapshot failures log to stderr
+ * but never block tool execution.
+ */
+import type { BackupConfig, SnapshotMetadata, SnapshotContent } from "./types.js";
+/**
+ * Interface for database queries needed by the backup manager.
+ * Avoids circular imports from the full adapter.
+ */
+export interface SnapshotQueryAdapter {
+    executeQuery(sql: string, params?: unknown[]): Promise<{
+        rows?: Record<string, unknown>[];
+    }>;
+}
+export declare class BackupManager {
+    readonly config: BackupConfig;
+    private readonly snapshotDir;
+    private dirEnsured;
+    private readonly pendingWrites;
+    constructor(config: BackupConfig, auditLogPath: string);
+    /**
+     * Check if a tool should receive a pre-mutation snapshot.
+     */
+    shouldSnapshot(toolName: string): boolean;
+    /**
+     * Create a pre-mutation snapshot of the target object.
+     *
+     * @returns Relative path to the snapshot file, or undefined if skipped/failed
+     */
+    createSnapshot(toolName: string, args: Record<string, unknown>, requestId: string, adapter: SnapshotQueryAdapter, logAs?: string): Promise<string | undefined>;
+    /**
+     * List available snapshots with metadata.
+     */
+    listSnapshots(limit?: number, offset?: number): Promise<{
+        snapshots: SnapshotMetadata[];
+        total: number;
+    }>;
+    /**
+     * Read a specific snapshot by filename.
+     */
+    getSnapshot(filename: string): Promise<SnapshotContent | null>;
+    /**
+     * Apply retention policy — delete oldest snapshots that exceed limits.
+     */
+    cleanup(): Promise<number>;
+    /**
+     * Flush all pending async snapshot writes.
+     * Call during graceful shutdown to ensure all snapshots are persisted.
+     */
+    flush(): Promise<void>;
+    getStats(): Promise<{
+        count: number;
+        oldestAge?: string;
+        totalSizeKB: number;
+    }>;
+    private captureObjectSnapshot;
+    /**
+     * Build a DDL string from sqlite_master for the given object.
+     * Works for tables, views, indexes, and triggers.
+     */
+    private buildDdl;
+    /**
+     * Capture row count using COUNT(*).
+     * Near-zero cost for small tables; failures are silently ignored (best-effort).
+     */
+    private captureVolumeMetadata;
+    /**
+     * Capture row data as INSERT statements, subject to config limits.
+     * Returns empty output when `includeData` is disabled.
+     */
+    private captureTableData;
+    private writeSnapshot;
+    /**
+     * Read and decompress a snapshot file (supports both gzip and legacy JSON).
+     */
+    private readSnapshotFile;
+    private ensureDirectory;
+}
+//# sourceMappingURL=backup-manager.d.ts.map

package/dist/audit/backup-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-manager.d.ts","sourceRoot":"","sources":["../../src/audit/backup-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAmBH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AA4BpB;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,CACV,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC;QACT,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;KAClC,CAAC,CAAC;CACJ;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4B;gBAE9C,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM;IAOtD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;OAIG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oBAAoB,EAC7B,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAyB9B;;OAEG;IACG,aAAa,CACjB,KAAK,SAAK,EACV,MAAM,SAAI,GACT,OAAO,CAAC;QAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAkC5D;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAWpE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IA0DhC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,QAAQ,IAAI,OAAO,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;YAoCY,qBAAqB;IAkBnC;;;OAGG;YACW,QAAQ;IAyBtB;;;OAGG;YACW,qBAAqB;IA0BnC;;;OAGG;YACW,gBAAgB;YAkFhB,aAAa;IA0E3B;;OAEG;YACW,gBAAgB;YAgBhB,eAAe;CAU9B"}

package/dist/audit/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * db-mcp — Audit Subsystem
+ *
+ * Provides forensic-grade JSONL logging and pre-mutation DDL
+ * snapshot capabilities for all write/admin operations.
+ */
+export * from "./types.js";
+export * from "./logger.js";
+export * from "./backup-manager.js";
+export * from "./interceptor.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/audit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audit/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/dist/audit/interceptor.d.ts

@@ -0,0 +1,54 @@
+/**
+ * db-mcp — Audit Interceptor
+ *
+ * Wraps tool execution to produce audit entries for all tool
+ * invocations. Write/admin tools are always logged; read-scoped
+ * tools are logged only when `--audit-reads` is enabled.
+ *
+ * Each entry includes a `tokenEstimate` (~4 bytes per token)
+ * computed from the serialized result size.
+ *
+ * When a BackupManager is provided, captures pre-mutation
+ * snapshots of target objects before destructive tool execution.
+ *
+ * The interceptor is injected into the registration layer
+ * so that all tool handlers are audited without per-handler changes.
+ *
+ * OAuth identity (`user`/`scopes`) is read from AsyncLocalStorage
+ * via `getAuthContext()`. When OAuth is configured, the HTTP
+ * transport binds the validated auth context before MCP dispatch.
+ * When OAuth is not configured (stdio, no auth), fields are `null`/`[]`.
+ */
+import type { AuditLogger } from "./logger.js";
+import type { BackupManager, SnapshotQueryAdapter } from "./backup-manager.js";
+/**
+ * Audit interceptor interface — used by the registration layer.
+ */
+export interface AuditInterceptor {
+    /**
+     * Wrap a tool invocation with audit logging.
+     * Returns the tool result unchanged; re-throws any errors.
+     *
+     * @param toolName  MCP tool name
+     * @param args      Tool input arguments
+     * @param requestId Request ID from RequestContext
+     * @param fn        The actual tool handler to execute
+     * @param options   Optional configuration, such as overriding the recorded tool name
+     */
+    around<T>(toolName: string, args: unknown, requestId: string, fn: () => Promise<T>, options?: {
+        logAs?: string;
+    }): Promise<T>;
+    /**
+     * Dynamically wire the query adapter used for DDL snapshot capture.
+     */
+    setQueryAdapter(adapter: SnapshotQueryAdapter): void;
+}
+/**
+ * Create an audit interceptor bound to the given logger.
+ *
+ * @param auditLogger  The JSONL audit logger
+ * @param backupManager Optional backup manager for pre-mutation snapshots
+ * @param queryAdapter  Optional query adapter for snapshot DDL capture
+ */
+export declare function createAuditInterceptor(auditLogger: AuditLogger, backupManager?: BackupManager): AuditInterceptor;
+//# sourceMappingURL=interceptor.d.ts.map

package/dist/audit/interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/audit/interceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAqE/E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,MAAM,CAAC,CAAC,EACN,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACtD;AAiBD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,WAAW,EACxB,aAAa,CAAC,EAAE,aAAa,GAC5B,gBAAgB,CA6IlB"}