db-mcp 1.1.1 → 3.0.0

package/dist/adapters/database-adapter.d.ts

@@ -0,0 +1,173 @@
+/**
+ * db-mcp - Database Adapter Interface
+ *
+ * Abstract base class for SQLite database adapters.
+ * Provides a consistent interface for SQLite database operations
+ * across WASM and native backend variants.
+ *
+ * Includes concrete default implementations for MCP registration
+ * (registerTool, registerResource, registerPrompt) that subclasses
+ * inherit. Override only if the adapter needs custom behavior.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DatabaseConfig, DatabaseType, HealthStatus, QueryResult, SchemaInfo, TableInfo, AdapterCapabilities, ToolDefinition, ResourceDefinition, PromptDefinition, RequestContext, ToolGroup, ToolFilterConfig } from "../types/index.js";
+import type { AuditInterceptor } from "../audit/interceptor.js";
+import type { BackupManager } from "../audit/backup-manager.js";
+/**
+ * Abstract base class for database adapters
+ */
+export declare abstract class DatabaseAdapter {
+    /** Database type identifier */
+    abstract readonly type: DatabaseType;
+    /** Human-readable adapter name */
+    abstract readonly name: string;
+    /** Adapter version */
+    abstract readonly version: string;
+    /** Connection status */
+    protected connected: boolean;
+    /** Database configuration */
+    protected config: DatabaseConfig | null;
+    /**
+     * Connect to the database
+     * @param config - Database connection configuration
+     */
+    abstract connect(config: DatabaseConfig): Promise<void>;
+    /**
+     * Disconnect from the database
+     */
+    abstract disconnect(): Promise<void>;
+    /**
+     * Check if connected to the database
+     */
+    isConnected(): boolean;
+    /**
+     * Get health status of the database connection
+     */
+    abstract getHealth(): Promise<HealthStatus>;
+    /**
+     * Execute a read-only query (SELECT)
+     * @param sql - SQL query string
+     * @param params - Query parameters for prepared statements
+     */
+    abstract executeReadQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Execute a write query (INSERT, UPDATE, DELETE)
+     * @param sql - SQL query string
+     * @param params - Query parameters for prepared statements
+     * @param skipValidation - Skip security validation (for trusted internal operations)
+     */
+    abstract executeWriteQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    abstract executeQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /**
+     * Execute a SQL script containing multiple statements (for migrations).
+     * Bypasses standard query validation as scripts are validated separately.
+     * @param sql - SQL script string
+     */
+    abstract executeScript(sql: string): Promise<void>;
+    /**
+     * Get full database schema information
+     */
+    abstract getSchema(): Promise<SchemaInfo>;
+    /**
+     * List all tables in the database
+     */
+    abstract listTables(): Promise<TableInfo[]>;
+    /**
+     * Describe a specific table's structure
+     * @param tableName - Name of the table
+     */
+    abstract describeTable(tableName: string): Promise<TableInfo>;
+    /**
+     * List available schemas/databases
+     */
+    abstract listSchemas(): Promise<string[]>;
+    /**
+     * Get adapter capabilities
+     */
+    abstract getCapabilities(): AdapterCapabilities;
+    /**
+     * Get supported tool groups for this adapter
+     */
+    abstract getSupportedToolGroups(): ToolGroup[];
+    protected auditInterceptor: AuditInterceptor | null;
+    protected backupManager: BackupManager | null;
+    /**
+     * Inject the audit interceptor.
+     */
+    setAuditInterceptor(interceptor: AuditInterceptor): void;
+    /**
+     * Inject the backup manager for tools to use natively.
+     */
+    setBackupManager(manager: BackupManager): void;
+    /**
+     * Get the audit interceptor (used by registration layer and Code Mode).
+     */
+    getAuditInterceptor(): AuditInterceptor | null;
+    /**
+     * Get all tool definitions for this adapter
+     */
+    abstract getToolDefinitions(): ToolDefinition[];
+    /**
+     * Get all resource definitions for this adapter
+     */
+    abstract getResourceDefinitions(): ResourceDefinition[];
+    /**
+     * Get all prompt definitions for this adapter
+     */
+    abstract getPromptDefinitions(): PromptDefinition[];
+    /**
+     * Register tools with the MCP server
+     * @param server - MCP server instance
+     * @param filterConfig - Tool filter configuration
+     */
+    registerTools(server: McpServer, filterConfig: ToolFilterConfig): void;
+    /**
+     * Register a single tool with the MCP server.
+     * Uses modern registerTool() API for MCP 2025-11-25 compliance.
+     * Subclasses may override for custom behavior.
+     */
+    protected registerTool(server: McpServer, tool: ToolDefinition): void;
+    /**
+     * Register resources with the MCP server
+     */
+    registerResources(server: McpServer): void;
+    /**
+     * Register a single resource with the MCP server.
+     * Handles both static resources and URI templates.
+     * Subclasses may override for custom behavior.
+     */
+    protected registerResource(server: McpServer, resource: ResourceDefinition): void;
+    /**
+     * Register prompts with the MCP server
+     */
+    registerPrompts(server: McpServer): void;
+    /**
+     * Register a single prompt with the MCP server.
+     * Subclasses may override for custom behavior.
+     */
+    protected registerPrompt(server: McpServer, prompt: PromptDefinition): void;
+    /**
+     * Validate query for safety (SQL injection prevention)
+     * @param sql - SQL query to validate
+     * @param isReadOnly - Whether to enforce read-only restrictions
+     */
+    protected validateQuery(sql: string, isReadOnly: boolean): void;
+    /**
+     * Create a request context for tool execution
+     * @param requestId Optional request ID for tracing
+     * @param server Optional MCP Server instance for progress notifications
+     * @param progressToken Optional progress token from client request _meta
+     */
+    createContext(requestId?: string, server?: unknown, progressToken?: string | number): RequestContext;
+    /**
+     * Ensure the adapter is connected to the database.
+     * Throws ConnectionError if not connected.
+     * Subclasses may override to add additional checks (e.g., db instance null).
+     */
+    protected ensureConnected(): void;
+    /**
+     * Get adapter info for logging/debugging
+     */
+    getInfo(): Record<string, unknown>;
+}
+//# sourceMappingURL=database-adapter.d.ts.map

package/dist/adapters/database-adapter.d.ts.map

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

package/dist/adapters/query-validation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * SQL Query Validation
+ *
+ * Security utilities for SQL injection detection and read-only enforcement.
+ * Extracted from DatabaseAdapter for modularity.
+ */
+/**
+ * Security-sensitive PRAGMAs that must be blocked globally.
+ */
+export declare const BLOCKED_PRAGMAS: Set<string>;
+/**
+ * Validate query for safety (SQL injection prevention) using strict structural validation.
+ * Strips comments and strings to reliably detect stacked queries and disallowed keywords.
+ *
+ * @param sql - SQL query to validate
+ * @param isReadOnly - Whether to enforce read-only restrictions
+ * @throws ValidationError if query violates safety rules
+ */
+export declare function validateQuery(sql: string, isReadOnly: boolean): void;
+//# sourceMappingURL=query-validation.d.ts.map

package/dist/adapters/query-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-validation.d.ts","sourceRoot":"","sources":["../../src/adapters/query-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;GAEG;AACH,eAAO,MAAM,eAAe,aAe1B,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CA6JpE"}

package/dist/adapters/registration/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./tools.js";
+export * from "./resources.js";
+export * from "./prompts.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/registration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/registration/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/adapters/registration/prompts.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PromptDefinition, RequestContext } from "../../types/index.js";
+export interface PromptRegistrationAdapter {
+    createContext(requestId?: string, server?: unknown, progressToken?: string | number): RequestContext;
+}
+export declare function registerPromptImpl(adapter: PromptRegistrationAdapter, server: McpServer, prompt: PromptDefinition): void;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/adapters/registration/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/adapters/registration/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG7E,MAAM,WAAW,yBAAyB;IACxC,aAAa,CACX,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,OAAO,EAChB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAC9B,cAAc,CAAC;CACnB;AA4BD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,EAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,GACvB,IAAI,CA6DN"}

package/dist/adapters/registration/resources.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ResourceDefinition, RequestContext } from "../../types/index.js";
+export interface ResourceRegistrationAdapter {
+    createContext(requestId?: string, server?: unknown, progressToken?: string | number): RequestContext;
+}
+export declare function registerResourceImpl(adapter: ResourceRegistrationAdapter, server: McpServer, resource: ResourceDefinition): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/adapters/registration/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/adapters/registration/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG/E,MAAM,WAAW,2BAA2B;IAC1C,aAAa,CACX,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,OAAO,EAChB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAC9B,cAAc,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,EACpC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,kBAAkB,GAC3B,IAAI,CA6DN"}

package/dist/adapters/registration/tools.d.ts

@@ -0,0 +1,9 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolDefinition, RequestContext } from "../../types/index.js";
+import type { AuditInterceptor } from "../../audit/interceptor.js";
+export interface ToolRegistrationAdapter {
+    createContext(requestId?: string, server?: unknown, progressToken?: string | number): RequestContext;
+    getAuditInterceptor?(): AuditInterceptor | null;
+}
+export declare function registerToolImpl(adapter: ToolRegistrationAdapter, server: McpServer, tool: ToolDefinition): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/adapters/registration/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/adapters/registration/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAUnE,MAAM,WAAW,uBAAuB;IACtC,aAAa,CACX,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,OAAO,EAChB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAC9B,cAAc,CAAC;IAClB,mBAAmB,CAAC,IAAI,gBAAgB,GAAG,IAAI,CAAC;CACjD;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,EAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,cAAc,GACnB,IAAI,CA6MN"}

package/dist/adapters/sqlite/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SQLite Adapter Module
+ *
+ * Public exports for the SQLite database adapter.
+ */
+export { SqliteAdapter, createSqliteAdapter } from "./sqlite-adapter.js";
+export type { SqliteConfig, SqliteOptions, SqliteQueryResult, JsonValue, } from "./types.js";
+export { getAllToolDefinitions, getToolsByGroup, getCoreTools, } from "./tools/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/sqlite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/sqlite/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,YAAY,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,YAAY,GACb,MAAM,kBAAkB,CAAC"}

package/dist/adapters/sqlite/json-utils.d.ts

@@ -0,0 +1,100 @@
+/**
+ * SQLite JSON Utilities
+ *
+ * Provides JSON normalization and JSONB binary storage support for SQLite 3.45+.
+ * Features:
+ * - Deep key sorting for consistent storage
+ * - Whitespace normalization (compact format)
+ * - Unicode normalization (NFC)
+ * - Optional type coercion
+ * - JSONB format detection and conversion
+ */
+import type { JsonNormalizationResult, JsonValue } from "./types.js";
+/**
+ * Options for JSON normalization
+ */
+export interface NormalizationOptions {
+    /** Sort object keys alphabetically (deep) */
+    sortKeys?: boolean;
+    /** Remove unnecessary whitespace */
+    compact?: boolean;
+    /** Apply Unicode NFC normalization to strings */
+    unicodeNormalize?: boolean;
+    /** Coerce string values to numbers/booleans when possible */
+    typeCoercion?: boolean;
+    /** How to handle duplicate keys: 'last' (default), 'first', 'error' */
+    duplicateKeys?: "last" | "first" | "error";
+}
+/**
+ * Default normalization options
+ */
+export declare const DEFAULT_NORMALIZATION_OPTIONS: Required<NormalizationOptions>;
+/**
+ * Normalize a JSON value for consistent storage
+ *
+ * @param value - The value to normalize (can be any JSON-compatible value)
+ * @param options - Normalization options
+ * @returns Normalization result with the normalized string and change details
+ */
+export declare function normalizeJson(value: unknown, options?: NormalizationOptions): JsonNormalizationResult;
+/**
+ * Check if SQLite version supports JSONB (3.45.0+)
+ *
+ * @param versionString - SQLite version string (e.g., "3.45.0")
+ * @returns true if JSONB is supported
+ */
+export declare function isJsonbSupportedVersion(versionString: string): boolean;
+/**
+ * Check if JSONB is supported (uses cached value)
+ */
+export declare function isJsonbSupported(): boolean;
+/**
+ * Set JSONB support status (called by adapter on connect)
+ */
+export declare function setJsonbSupported(supported: boolean): void;
+/**
+ * Wrap JSON in jsonb() for storage
+ * Returns SQL fragment that converts JSON to JSONB
+ *
+ * @param jsonValue - JSON string value
+ * @returns SQL expression for JSONB storage
+ */
+export declare function toJsonbSql(jsonValue: string): string;
+/**
+ * Wrap JSON in json() for text storage
+ *
+ * @param jsonValue - JSON string value
+ * @returns SQL expression for text JSON storage
+ */
+export declare function toJsonSql(jsonValue: string): string;
+/**
+ * Get SQL function name for JSONB-aware operations
+ * Falls back to text JSON functions if JSONB not supported
+ */
+export declare function getJsonFunction(baseName: string, useJsonb: boolean): string;
+/**
+ * Detect storage format of a JSON value from SQLite
+ *
+ * @param value - Value from SQLite query result
+ * @returns 'jsonb' if BLOB, 'text' if string, 'unknown' otherwise
+ */
+export declare function detectJsonStorageFormat(value: unknown): "jsonb" | "text" | "unknown";
+/**
+ * Parse JSON from various storage formats
+ *
+ * @param value - Value from SQLite (could be string, Buffer, or already parsed)
+ * @returns Parsed JSON value
+ */
+export declare function parseJsonValue(value: unknown): JsonValue;
+/**
+ * Validate JSON path syntax
+ *
+ * @param path - JSON path (e.g., "$.foo.bar[0]")
+ * @returns true if valid
+ */
+export declare function isValidJsonPath(path: string): boolean;
+/**
+ * Check if a string is valid JSON
+ */
+export declare function isValidJson(str: string): boolean;
+//# sourceMappingURL=json-utils.d.ts.map

package/dist/adapters/sqlite/json-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-utils.d.ts","sourceRoot":"","sources":["../../../src/adapters/sqlite/json-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOrE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;CAC5C;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAAC,oBAAoB,CAMxE,CAAC;AAMF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,oBAAyB,GACjC,uBAAuB,CAsCzB;AA4FD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAUtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAE1D;AAMD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAK3E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,OAAO,GAAG,MAAM,GAAG,SAAS,CAQ9B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAqCxD;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQrD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOhD"}

package/dist/adapters/sqlite/prompts/analysis.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Analysis & Workflow Prompts
+ *
+ * Prompts for data analysis, table summarization, hybrid search workflow, and demos.
+ */
+import type { PromptDefinition } from "../../../types/index.js";
+/**
+ * Data analysis prompt
+ */
+export declare function createDataAnalysisPrompt(): PromptDefinition;
+/**
+ * Summarize table prompt - Intelligent table analysis
+ */
+export declare function createSummarizeTablePrompt(): PromptDefinition;
+/**
+ * Hybrid search workflow prompt - FTS5 + Vector search
+ */
+export declare function createHybridSearchWorkflowPrompt(): PromptDefinition;
+/**
+ * Interactive MCP demo prompt
+ */
+export declare function createDemoPrompt(): PromptDefinition;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/adapters/sqlite/prompts/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../../../src/adapters/sqlite/prompts/analysis.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQhE;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,gBAAgB,CA0C3D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,gBAAgB,CAiF7D;AAED;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,gBAAgB,CAuGnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CA+EnD"}

package/dist/adapters/sqlite/prompts/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * SQLite Prompt Definitions — Barrel Re-export
+ *
+ * MCP prompts for common database operations and analysis.
+ * 10 prompts total.
+ */
+import type { SqliteAdapter } from "../sqlite-adapter.js";
+import type { PromptDefinition } from "../../../types/index.js";
+/**
+ * Get all prompt definitions for the SQLite adapter
+ */
+export declare function getPromptDefinitions(adapter: SqliteAdapter): PromptDefinition[];
+export { createExplainSchemaPrompt, createOptimizationPrompt, createDocumentationPrompt, } from "./schema.js";
+export { createQueryBuilderPrompt, createMigrationPrompt, createDebugQueryPrompt, } from "./query.js";
+export { createDataAnalysisPrompt, createSummarizeTablePrompt, createHybridSearchWorkflowPrompt, createDemoPrompt, } from "./analysis.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/sqlite/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/sqlite/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAkBhE;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,GACrB,gBAAgB,EAAE,CAapB;AAGD,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,gCAAgC,EAChC,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/adapters/sqlite/prompts/query.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Query-focused Prompts
+ *
+ * Prompts for SQL query building, debugging, and migration.
+ */
+import type { PromptDefinition } from "../../../types/index.js";
+/**
+ * Help build SQL queries
+ */
+export declare function createQueryBuilderPrompt(): PromptDefinition;
+/**
+ * Migration helper prompt
+ */
+export declare function createMigrationPrompt(): PromptDefinition;
+/**
+ * Debug query prompt
+ */
+export declare function createDebugQueryPrompt(): PromptDefinition;
+//# sourceMappingURL=query.d.ts.map

package/dist/adapters/sqlite/prompts/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../src/adapters/sqlite/prompts/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,gBAAgB,CAkD3D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,CA8CxD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAqDzD"}

package/dist/adapters/sqlite/prompts/schema.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Schema-focused Prompts
+ *
+ * Prompts for database schema explanation, optimization, and documentation.
+ */
+import type { SqliteAdapter } from "../sqlite-adapter.js";
+import type { PromptDefinition } from "../../../types/index.js";
+/**
+ * Explain the database schema
+ */
+export declare function createExplainSchemaPrompt(adapter: SqliteAdapter): PromptDefinition;
+/**
+ * Database optimization prompt
+ */
+export declare function createOptimizationPrompt(adapter: SqliteAdapter): PromptDefinition;
+/**
+ * Documentation generator prompt
+ */
+export declare function createDocumentationPrompt(adapter: SqliteAdapter): PromptDefinition;
+//# sourceMappingURL=schema.d.ts.map

package/dist/adapters/sqlite/prompts/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/adapters/sqlite/prompts/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,GACrB,gBAAgB,CAkClB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,aAAa,GACrB,gBAAgB,CAuClB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,GACrB,gBAAgB,CAqClB"}

package/dist/adapters/sqlite/query-executor.d.ts

@@ -0,0 +1,38 @@
+/**
+ * SQLite Query Executor
+ *
+ * Core query execution logic extracted from SqliteAdapter for modularity.
+ * All functions operate on a sql.js Database instance passed as an argument.
+ */
+import type { Database } from "sql.js";
+import type { QueryResult } from "../../types/index.js";
+import type { ModuleLogger } from "../../utils/logger/index.js";
+/**
+ * Helper to translate raw SQLite errors into typed db-mcp errors with better messages.
+ */
+export declare function translateSqliteError(error: unknown, sql: string, operation: string, overrideLog?: ModuleLogger): never;
+/**
+ * Convert sql.js query results to row objects.
+ * Shared between executeRead and executeGeneral to eliminate duplication.
+ */
+export declare function rowsFromSqlJsResult(result: {
+    columns: string[];
+    values: unknown[][];
+}): Record<string, unknown>[];
+/**
+ * Execute a read-only query against a sql.js Database.
+ */
+export declare function executeRead(db: Database, sql: string, params?: unknown[]): Promise<QueryResult>;
+/**
+ * Execute a write query against a sql.js Database.
+ *
+ * @returns QueryResult with rowsAffected count
+ */
+export declare function executeWrite(db: Database, sql: string, params?: unknown[]): Promise<QueryResult>;
+/**
+ * Execute any query (for admin operations) against a sql.js Database.
+ *
+ * Returns rows if the statement produces results, otherwise rowsAffected.
+ */
+export declare function executeGeneral(db: Database, sql: string, params?: unknown[]): Promise<QueryResult>;
+//# sourceMappingURL=query-executor.d.ts.map

package/dist/adapters/sqlite/query-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-executor.d.ts","sourceRoot":"","sources":["../../../src/adapters/sqlite/query-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,sBAAsB,CAAC;AAOpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAKhE;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,YAAY,GACzB,KAAK,CAoDP;AAKD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;CACrB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAoB5B;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,QAAQ,EACZ,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,WAAW,CAAC,CAsCtB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,EACZ,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,WAAW,CAAC,CAiDtB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,EACZ,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,WAAW,CAAC,CAiCtB"}

package/dist/adapters/sqlite/resources.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SQLite Resource Definitions
+ *
+ * MCP resources for schema introspection, data access, and metadata.
+ * 8 resources total.
+ */
+import type { SqliteAdapter } from "./sqlite-adapter.js";
+import type { ResourceDefinition } from "../../types/index.js";
+/**
+ * Get all resource definitions for the SQLite adapter
+ */
+export declare function getResourceDefinitions(adapter: SqliteAdapter): ResourceDefinition[];
+//# sourceMappingURL=resources.d.ts.map

package/dist/adapters/sqlite/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/adapters/sqlite/resources.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAe/D;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,GACrB,kBAAkB,EAAE,CAatB"}

package/dist/adapters/sqlite/schema-manager.d.ts

@@ -0,0 +1,69 @@
+/**
+ * SQLite Schema Manager
+ *
+ * Provides TTL-based caching for schema metadata operations.
+ * Ported from mysql-mcp's SchemaManager pattern.
+ */
+import type { QueryResult, TableInfo, SchemaInfo, IndexInfo } from "../../types/index.js";
+export interface QueryExecutor {
+    executeReadQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+}
+/**
+ * SchemaManager provides cached access to database schema metadata.
+ * Reduces repeated schema queries during tool/resource invocations.
+ */
+export declare class SchemaManager {
+    private executor;
+    private metadataCache;
+    private cacheTtlMs;
+    constructor(executor: QueryExecutor);
+    /**
+     * Get cached value if not expired
+     */
+    private getCached;
+    /**
+     * Set cache value
+     */
+    private setCache;
+    /**
+     * Clear all cached metadata (useful after DDL operations)
+     */
+    clearCache(): void;
+    /**
+     * Clear cache for a specific table
+     */
+    clearTableCache(tableName: string): void;
+    /**
+     * Get the current cache TTL in milliseconds
+     */
+    getCacheTtl(): number;
+    /**
+     * Get all raw user table names (cached, skips sqlite_master metadata)
+     */
+    getRawTableNames(): Promise<string[]>;
+    /**
+     * Get full database schema (cached)
+     */
+    getSchema(): Promise<SchemaInfo>;
+    /**
+     * List all tables (cached)
+     */
+    listTables(): Promise<TableInfo[]>;
+    /**
+     * Describe a table's structure (cached per table)
+     */
+    describeTable(tableName: string): Promise<TableInfo>;
+    /**
+     * Get all indexes in a single query (cached)
+     * Performance: Fetches all index metadata from sqlite_master in one query,
+     * then resolves column info per-index via PRAGMA index_info. True batching
+     * isn't possible since SQLite PRAGMAs don't support multi-index queries,
+     * but the cache ensures this N+1 pattern only runs once per TTL window.
+     */
+    getAllIndexes(): Promise<IndexInfo[]>;
+    /**
+     * Get indexes for a specific table (uses cached all_indexes)
+     */
+    getTableIndexes(tableName: string): Promise<IndexInfo[]>;
+}
+//# sourceMappingURL=schema-manager.d.ts.map

package/dist/adapters/sqlite/schema-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-manager.d.ts","sourceRoot":"","sources":["../../../src/adapters/sqlite/schema-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,SAAS,EAEV,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACzE;AAgBD;;;GAGG;AACH,qBAAa,aAAa;IAIZ,OAAO,CAAC,QAAQ;IAH5B,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,UAAU,CAAwB;gBAEtB,QAAQ,EAAE,aAAa;IAE3C;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAa3C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAYtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAoCxC;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAqE1D;;;;;;OAMG;IACG,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAyC3C;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAI/D"}