db-mcp 1.0.1

package/dist/types/index.d.ts

@@ -0,0 +1,380 @@
+/**
+ * db-mcp - SQLite MCP Server
+ *
+ * Core type definitions for the MCP server, database adapters,
+ * OAuth 2.0 authentication, and tool filtering.
+ */
+/**
+ * Supported database types
+ *
+ * Note: This MCP server only supports SQLite. Other database types are listed
+ * here for type compatibility but would require separate MCP server projects.
+ */
+export type DatabaseType = "sqlite" | "postgresql" | "mysql" | "mongodb" | "redis" | "sqlserver";
+/**
+ * Database connection configuration
+ */
+export interface DatabaseConfig {
+    /** Database type identifier */
+    type: DatabaseType;
+    /** Connection string (format varies by database type) */
+    connectionString?: string;
+    /** Individual connection parameters (alternative to connectionString) */
+    host?: string;
+    port?: number;
+    database?: string;
+    username?: string;
+    password?: string;
+    /** Additional database-specific options */
+    options?: Record<string, unknown>;
+}
+/**
+ * Database connection health status
+ */
+export interface HealthStatus {
+    connected: boolean;
+    latencyMs?: number;
+    version?: string;
+    details?: Record<string, unknown>;
+    error?: string;
+}
+/**
+ * Query execution result
+ */
+export interface QueryResult {
+    /** Rows returned (for SELECT queries) */
+    rows?: Record<string, unknown>[];
+    /** Number of rows affected (for INSERT/UPDATE/DELETE) */
+    rowsAffected?: number;
+    /** Last inserted ID (for INSERT with auto-increment) */
+    lastInsertId?: number | string;
+    /** Query execution time in milliseconds */
+    executionTimeMs?: number;
+    /** Column metadata */
+    columns?: ColumnInfo[];
+}
+/**
+ * Column metadata information
+ */
+export interface ColumnInfo {
+    name: string;
+    type: string;
+    nullable?: boolean;
+    primaryKey?: boolean;
+    defaultValue?: unknown;
+}
+/**
+ * Table information
+ */
+export interface TableInfo {
+    name: string;
+    schema?: string;
+    type: "table" | "view" | "materialized_view";
+    rowCount?: number;
+    columns?: ColumnInfo[];
+}
+/**
+ * Schema information for a database
+ */
+export interface SchemaInfo {
+    tables: TableInfo[];
+    views?: TableInfo[];
+    indexes?: IndexInfo[];
+    constraints?: ConstraintInfo[];
+}
+/**
+ * Index information
+ */
+export interface IndexInfo {
+    name: string;
+    tableName: string;
+    columns: string[];
+    unique: boolean;
+    type?: string;
+}
+/**
+ * Constraint information
+ */
+export interface ConstraintInfo {
+    name: string;
+    tableName: string;
+    type: "primary_key" | "foreign_key" | "unique" | "check";
+    columns: string[];
+    referencedTable?: string;
+    referencedColumns?: string[];
+}
+/**
+ * Transport type for MCP communication
+ */
+export type TransportType = "stdio" | "http" | "sse";
+/**
+ * MCP Server configuration
+ */
+export interface McpServerConfig {
+    /** Server name */
+    name: string;
+    /** Server version */
+    version: string;
+    /** Transport configuration */
+    transport: TransportType;
+    /** HTTP port (for http/sse transports) */
+    port?: number;
+    /** Database configurations */
+    databases: DatabaseConfig[];
+    /** OAuth configuration */
+    oauth?: OAuthConfig;
+    /** Tool filtering configuration */
+    toolFilter?: string;
+    /**
+     * Enable stateless HTTP mode (no session management, no SSE streaming).
+     * Ideal for serverless deployments (Lambda, Workers, Vercel).
+     * Default: false (stateful mode with session management and SSE support)
+     */
+    statelessHttp?: boolean;
+}
+/**
+ * OAuth 2.0 configuration
+ */
+export interface OAuthConfig {
+    /** Enable OAuth authentication */
+    enabled: boolean;
+    /** Authorization server URL */
+    authorizationServerUrl?: string;
+    /** Token validation endpoint */
+    tokenEndpoint?: string;
+    /** JWKS URI for token verification */
+    jwksUri?: string;
+    /** Expected audience in tokens */
+    audience?: string;
+    /** Expected issuer in tokens */
+    issuer?: string;
+    /** Clock tolerance for token validation (seconds) */
+    clockTolerance?: number;
+    /** JWKS cache TTL (seconds) */
+    jwksCacheTtl?: number;
+    /** Paths that bypass authentication */
+    publicPaths?: string[];
+}
+/**
+ * OAuth scopes for access control
+ */
+export type OAuthScope = "read" | "write" | "admin" | `db:${string}` | `table:${string}:${string}`;
+/**
+ * Validated OAuth token claims
+ */
+export interface TokenClaims {
+    /** Subject (user ID) */
+    sub: string;
+    /** Granted scopes */
+    scopes: OAuthScope[];
+    /** Token expiration time */
+    exp: number;
+    /** Token issued at time */
+    iat: number;
+    /** Token issuer */
+    iss?: string;
+    /** Token audience */
+    aud?: string | string[];
+    /** Additional claims */
+    [key: string]: unknown;
+}
+/**
+ * Request context with authentication info
+ */
+export interface RequestContext {
+    /** Validated token claims (if authenticated) */
+    auth?: TokenClaims;
+    /** Raw access token */
+    accessToken?: string;
+    /** Request timestamp */
+    timestamp: Date;
+    /** Request ID for tracing */
+    requestId: string;
+    /**
+     * MCP Server instance for sending progress notifications.
+     * Only available when running in HTTP/SSE transport with stateful sessions.
+     */
+    server?: unknown;
+    /**
+     * Progress token from client request _meta (MCP 2025-11-25).
+     * If present, the client has requested progress updates.
+     */
+    progressToken?: string | number;
+}
+/**
+ * Tool group identifiers
+ */
+export type ToolGroup = "core" | "json" | "text" | "stats" | "vector" | "admin" | "geo";
+/**
+ * Meta-group identifiers for common multi-group selections.
+ * These are shortcuts that expand to multiple ToolGroups.
+ */
+export type MetaGroup = "starter" | "analytics" | "search" | "spatial" | "minimal" | "full";
+/**
+ * Tool filter rule
+ */
+export interface ToolFilterRule {
+    /** Rule type: include or exclude */
+    type: "include" | "exclude";
+    /** Target: group name or tool name */
+    target: string;
+    /** Whether target is a group (true) or individual tool (false) */
+    isGroup: boolean;
+}
+/**
+ * Parsed tool filter configuration
+ */
+export interface ToolFilterConfig {
+    /** Original filter string */
+    raw: string;
+    /** Parsed rules in order */
+    rules: ToolFilterRule[];
+    /** Set of enabled tool groups after applying rules */
+    enabledGroups: Set<ToolGroup>;
+    /** Set of explicitly excluded tool names (base names without prefix) */
+    excludedTools: Set<string>;
+    /** Set of explicitly included tool names (base names without prefix) */
+    includedTools: Set<string>;
+}
+/**
+ * Tool annotations provide behavioral hints to clients
+ * following the MCP 2025-11-25 specification.
+ */
+export interface ToolAnnotations {
+    /** Human-readable title for the tool */
+    title?: string;
+    /** If true, the tool is guaranteed not to modify any state */
+    readOnlyHint?: boolean;
+    /** If true, multiple identical requests have the same effect as a single request */
+    idempotentHint?: boolean;
+    /** If true, the operation is irreversible or causes significant data loss */
+    destructiveHint?: boolean;
+}
+/**
+ * Capabilities supported by a database adapter
+ */
+export interface AdapterCapabilities {
+    /** Supports JSON operations */
+    json: boolean;
+    /** Supports full-text search */
+    fullTextSearch: boolean;
+    /** Supports vector/embedding operations */
+    vector: boolean;
+    /** Supports geospatial operations */
+    geospatial: boolean;
+    /** Supports transactions */
+    transactions: boolean;
+    /** Supports prepared statements */
+    preparedStatements: boolean;
+    /** Supports connection pooling */
+    connectionPooling: boolean;
+    /** Additional capability flags */
+    [key: string]: boolean;
+}
+/**
+ * Tool definition for registration
+ */
+export interface ToolDefinition {
+    /** Unique tool name */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Tool group for filtering */
+    group: ToolGroup;
+    /** Zod schema for input validation */
+    inputSchema: unknown;
+    /** Zod schema for output validation (MCP 2025-11-25) */
+    outputSchema?: unknown;
+    /** Required OAuth scopes */
+    requiredScopes?: OAuthScope[];
+    /** MCP tool annotations (behavioral hints) */
+    annotations?: ToolAnnotations;
+    /** Tool handler function */
+    handler: (params: unknown, context: RequestContext) => Promise<unknown>;
+}
+/**
+ * MCP Resource Annotations (SDK 1.25+)
+ * Provides metadata hints about resource content to help clients
+ * manage and display resources appropriately.
+ */
+export interface ResourceAnnotations {
+    /** Intended audience for the resource content */
+    audience?: ("user" | "assistant")[];
+    /** Priority hint for display ordering (0-1 range) */
+    priority?: number;
+    /** ISO 8601 timestamp of last modification for cache invalidation */
+    lastModified?: string;
+}
+/**
+ * Resource definition for MCP
+ */
+export interface ResourceDefinition {
+    /** Resource URI template */
+    uri: string;
+    /** Human-readable name */
+    name: string;
+    /** Description */
+    description: string;
+    /** MIME type */
+    mimeType?: string;
+    /** MCP Resource Annotations for behavior hints */
+    annotations?: ResourceAnnotations;
+    /** Resource handler */
+    handler: (uri: string, context: RequestContext) => Promise<unknown>;
+}
+/**
+ * Prompt definition for MCP
+ */
+export interface PromptDefinition {
+    /** Prompt name */
+    name: string;
+    /** Description */
+    description: string;
+    /** Argument definitions */
+    arguments?: {
+        name: string;
+        description: string;
+        required?: boolean;
+    }[];
+    /** Prompt handler */
+    handler: (args: Record<string, string>, context: RequestContext) => Promise<unknown>;
+}
+/**
+ * Base error class for db-mcp
+ */
+export declare class DbMcpError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Database connection error
+ */
+export declare class ConnectionError extends DbMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Query execution error
+ */
+export declare class QueryError extends DbMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Authentication error
+ */
+export declare class AuthenticationError extends DbMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Authorization error (insufficient permissions)
+ */
+export declare class AuthorizationError extends DbMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Validation error for input parameters
+ */
+export declare class ValidationError extends DbMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,SAAS,GACT,OAAO,GACP,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,IAAI,EAAE,YAAY,CAAC;IAEnB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAEjC,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE/B,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,sBAAsB;IACtB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAMD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,SAAS,EAAE,aAAa,CAAC;IAEzB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,8BAA8B;IAC9B,SAAS,EAAE,cAAc,EAAE,CAAC;IAE5B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,MAAM,EAAE,GACd,SAAS,MAAM,IAAI,MAAM,EAAE,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IAEZ,qBAAqB;IACrB,MAAM,EAAE,UAAU,EAAE,CAAC;IAErB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IAEZ,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IAEZ,mBAAmB;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,wBAAwB;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAC;IAEhB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAMD;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,GACP,QAAQ,GACR,OAAO,GACP,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,SAAS,GACT,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAE5B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IAEZ,4BAA4B;IAC5B,KAAK,EAAE,cAAc,EAAE,CAAC;IAExB,sDAAsD;IACtD,aAAa,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAE9B,wEAAwE;IACxE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE3B,wEAAwE;IACxE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAMD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,oFAAoF;IACpF,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,IAAI,EAAE,OAAO,CAAC;IAEd,gCAAgC;IAChC,cAAc,EAAE,OAAO,CAAC;IAExB,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAC;IAEhB,qCAAqC;IACrC,UAAU,EAAE,OAAO,CAAC;IAEpB,4BAA4B;IAC5B,YAAY,EAAE,OAAO,CAAC;IAEtB,mCAAmC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAE5B,kCAAkC;IAClC,iBAAiB,EAAE,OAAO,CAAC;IAE3B,kCAAkC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IAEb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IAEpB,+BAA+B;IAC/B,KAAK,EAAE,SAAS,CAAC;IAEjB,sCAAsC;IACtC,WAAW,EAAE,OAAO,CAAC;IAErB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC;IAE9B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B,4BAA4B;IAC5B,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC;IAEpC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IAEZ,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,kDAAkD;IAClD,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAElC,uBAAuB;IACvB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IAEb,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,SAAS,CAAC,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,EAAE,CAAC;IAEJ,qBAAqB;IACrB,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAMD;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;aAGjB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,UAAU;gBAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D"}

package/dist/types/index.js

@@ -0,0 +1,68 @@
+/**
+ * db-mcp - SQLite MCP Server
+ *
+ * Core type definitions for the MCP server, database adapters,
+ * OAuth 2.0 authentication, and tool filtering.
+ */
+// =============================================================================
+// Error Types
+// =============================================================================
+/**
+ * Base error class for db-mcp
+ */
+export class DbMcpError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "DbMcpError";
+    }
+}
+/**
+ * Database connection error
+ */
+export class ConnectionError extends DbMcpError {
+    constructor(message, details) {
+        super(message, "CONNECTION_ERROR", details);
+        this.name = "ConnectionError";
+    }
+}
+/**
+ * Query execution error
+ */
+export class QueryError extends DbMcpError {
+    constructor(message, details) {
+        super(message, "QUERY_ERROR", details);
+        this.name = "QueryError";
+    }
+}
+/**
+ * Authentication error
+ */
+export class AuthenticationError extends DbMcpError {
+    constructor(message, details) {
+        super(message, "AUTHENTICATION_ERROR", details);
+        this.name = "AuthenticationError";
+    }
+}
+/**
+ * Authorization error (insufficient permissions)
+ */
+export class AuthorizationError extends DbMcpError {
+    constructor(message, details) {
+        super(message, "AUTHORIZATION_ERROR", details);
+        this.name = "AuthorizationError";
+    }
+}
+/**
+ * Validation error for input parameters
+ */
+export class ValidationError extends DbMcpError {
+    constructor(message, details) {
+        super(message, "VALIDATION_ERROR", details);
+        this.name = "ValidationError";
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+dH,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IACxC,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/utils/annotations.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Tool Annotations Presets
+ *
+ * Reusable annotation configurations for common tool behavior patterns.
+ * Used by all tool definition files for consistency.
+ *
+ * Follows MCP 2025-11-25 specification.
+ */
+import type { ToolAnnotations } from "../types/index.js";
+/** Read-only query tools (SELECT, schema retrieval, metadata) */
+export declare const READ_ONLY: ToolAnnotations;
+/** Standard write tools (INSERT, UPDATE, CREATE) */
+export declare const WRITE: ToolAnnotations;
+/** Destructive tools (DELETE, DROP, TRUNCATE) */
+export declare const DESTRUCTIVE: ToolAnnotations;
+/** Idempotent tools (CREATE IF NOT EXISTS, upserts) */
+export declare const IDEMPOTENT: ToolAnnotations;
+/** Admin/maintenance tools (VACUUM, ANALYZE, PRAGMA) */
+export declare const ADMIN: ToolAnnotations;
+/**
+ * Create annotations with a custom title
+ */
+export declare function withTitle(title: string, base?: ToolAnnotations): ToolAnnotations;
+/**
+ * Create read-only annotations with title
+ */
+export declare function readOnly(title: string): ToolAnnotations;
+/**
+ * Create write annotations with title
+ */
+export declare function write(title: string): ToolAnnotations;
+/**
+ * Create destructive annotations with title
+ */
+export declare function destructive(title: string): ToolAnnotations;
+/**
+ * Create idempotent annotations with title
+ */
+export declare function idempotent(title: string): ToolAnnotations;
+/**
+ * Create admin annotations with title
+ */
+export declare function admin(title: string): ToolAnnotations;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/utils/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/utils/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMzD,iEAAiE;AACjE,eAAO,MAAM,SAAS,EAAE,eAGvB,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,KAAK,EAAE,eAGnB,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,WAAW,EAAE,eAGzB,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,UAAU,EAAE,eAIxB,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,KAAK,EAAE,eAGnB,CAAC;AAMF;;GAEG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,eAA2B,GAChC,eAAe,CAEjB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAEvD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAEpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAE1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAEzD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAEpD"}

package/dist/utils/annotations.js

@@ -0,0 +1,77 @@
+/**
+ * Tool Annotations Presets
+ *
+ * Reusable annotation configurations for common tool behavior patterns.
+ * Used by all tool definition files for consistency.
+ *
+ * Follows MCP 2025-11-25 specification.
+ */
+// =============================================================================
+// Base Annotation Presets
+// =============================================================================
+/** Read-only query tools (SELECT, schema retrieval, metadata) */
+export const READ_ONLY = {
+    readOnlyHint: true,
+    destructiveHint: false,
+};
+/** Standard write tools (INSERT, UPDATE, CREATE) */
+export const WRITE = {
+    readOnlyHint: false,
+    destructiveHint: false,
+};
+/** Destructive tools (DELETE, DROP, TRUNCATE) */
+export const DESTRUCTIVE = {
+    readOnlyHint: false,
+    destructiveHint: true,
+};
+/** Idempotent tools (CREATE IF NOT EXISTS, upserts) */
+export const IDEMPOTENT = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+};
+/** Admin/maintenance tools (VACUUM, ANALYZE, PRAGMA) */
+export const ADMIN = {
+    readOnlyHint: false,
+    destructiveHint: false,
+};
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Create annotations with a custom title
+ */
+export function withTitle(title, base = READ_ONLY) {
+    return { title, ...base };
+}
+/**
+ * Create read-only annotations with title
+ */
+export function readOnly(title) {
+    return { title, ...READ_ONLY };
+}
+/**
+ * Create write annotations with title
+ */
+export function write(title) {
+    return { title, ...WRITE };
+}
+/**
+ * Create destructive annotations with title
+ */
+export function destructive(title) {
+    return { title, ...DESTRUCTIVE };
+}
+/**
+ * Create idempotent annotations with title
+ */
+export function idempotent(title) {
+    return { title, ...IDEMPOTENT };
+}
+/**
+ * Create admin annotations with title
+ */
+export function admin(title) {
+    return { title, ...ADMIN };
+}
+//# sourceMappingURL=annotations.js.map

package/dist/utils/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/utils/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,iEAAiE;AACjE,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,KAAK,GAAoB;IACpC,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF,iDAAiD;AACjD,MAAM,CAAC,MAAM,WAAW,GAAoB;IAC1C,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,IAAI;CACtB,CAAC;AAEF,uDAAuD;AACvD,MAAM,CAAC,MAAM,UAAU,GAAoB;IACzC,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF,wDAAwD;AACxD,MAAM,CAAC,MAAM,KAAK,GAAoB;IACpC,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,KAAa,EACb,OAAwB,SAAS;IAEjC,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,EAAE,KAAK,EAAE,GAAG,SAAS,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,EAAE,KAAK,EAAE,GAAG,WAAW,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC;AAC7B,CAAC"}