@neverinfamous/mysql-mcp 2.1.0

package/dist/logging/McpLogging.js.map

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

package/dist/logging/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Logging Module Index
+ *
+ * Re-exports logging utilities.
+ */
+export { mcpLogger, type McpLogLevel } from './McpLogging.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,7 @@
+/**
+ * Logging Module Index
+ *
+ * Re-exports logging utilities.
+ */
+export { mcpLogger } from './McpLogging.js';
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAoB,MAAM,iBAAiB,CAAC"}

package/dist/pool/ConnectionPool.d.ts

@@ -0,0 +1,76 @@
+/**
+ * mysql-mcp - Connection Pool Manager
+ *
+ * Wraps mysql2 connection pooling with health monitoring,
+ * statistics tracking, and graceful shutdown support.
+ */
+import mysql from 'mysql2/promise';
+import type { PoolConnection } from 'mysql2/promise';
+import type { PoolConfig, PoolStats, HealthStatus } from '../types/index.js';
+/**
+ * Connection pool configuration with defaults
+ */
+export interface ConnectionPoolConfig {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+    pool?: PoolConfig;
+    ssl?: boolean | mysql.SslOptions;
+    charset?: string;
+    timezone?: string;
+    connectTimeout?: number;
+}
+/**
+ * Connection pool wrapper with statistics and health monitoring
+ */
+export declare class ConnectionPool {
+    private pool;
+    private config;
+    private stats;
+    private isShuttingDown;
+    constructor(config: ConnectionPoolConfig);
+    /**
+     * Initialize the connection pool
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get a connection from the pool
+     */
+    getConnection(): Promise<PoolConnection>;
+    /**
+     * Release a connection back to the pool
+     */
+    releaseConnection(connection: PoolConnection): void;
+    /**
+     * Execute a query using a pooled connection
+     * Returns full result tuple [rows, fields] for compatibility with rawQuery
+     */
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<[T, mysql.FieldPacket[]]>;
+    /**
+     * Execute a query and return full result with metadata
+     */
+    execute<T = unknown>(sql: string, params?: unknown[]): Promise<[T, mysql.FieldPacket[]]>;
+    /**
+     * Get pool statistics
+     */
+    getStats(): PoolStats;
+    /**
+     * Check pool health
+     */
+    checkHealth(): Promise<HealthStatus>;
+    /**
+     * Gracefully shutdown the pool
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Check if pool is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Check if pool is shutting down
+     */
+    isClosing(): boolean;
+}
+//# sourceMappingURL=ConnectionPool.d.ts.map

package/dist/pool/ConnectionPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionPool.d.ts","sourceRoot":"","sources":["../../src/pool/ConnectionPool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,gBAAgB,CAAC;AACnC,OAAO,KAAK,EAAQ,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAI7E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAMX;IACF,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,EAAE,oBAAoB;IAIxC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+DjC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC;IAmB9C;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IASnD;;;OAGG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAgB5F;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAgB9F;;OAEG;IACH,QAAQ,IAAI,SAAS;IAcrB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IA0C1C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB/B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,SAAS,IAAI,OAAO;CAGvB"}

package/dist/pool/ConnectionPool.js

@@ -0,0 +1,238 @@
+/**
+ * mysql-mcp - Connection Pool Manager
+ *
+ * Wraps mysql2 connection pooling with health monitoring,
+ * statistics tracking, and graceful shutdown support.
+ */
+import mysql from 'mysql2/promise';
+import { PoolError, ConnectionError } from '../types/index.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Connection pool wrapper with statistics and health monitoring
+ */
+export class ConnectionPool {
+    pool = null;
+    config;
+    stats = {
+        total: 0,
+        active: 0,
+        idle: 0,
+        waiting: 0,
+        totalQueries: 0
+    };
+    isShuttingDown = false;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Initialize the connection pool
+     */
+    async initialize() {
+        if (this.pool) {
+            logger.warn('Connection pool already initialized');
+            return;
+        }
+        const poolConfig = this.config.pool ?? {};
+        try {
+            this.pool = mysql.createPool({
+                host: this.config.host,
+                port: this.config.port,
+                user: this.config.user,
+                password: this.config.password,
+                database: this.config.database,
+                // Pool options with defaults
+                connectionLimit: poolConfig.connectionLimit ?? 10,
+                waitForConnections: poolConfig.waitForConnections ?? true,
+                queueLimit: poolConfig.queueLimit ?? 0,
+                // Connection options
+                connectTimeout: this.config.connectTimeout ?? 10000,
+                charset: this.config.charset ?? 'utf8mb4',
+                timezone: this.config.timezone ?? 'local',
+                // SSL - convert boolean to mysql2 compatible format
+                // mysql2 expects string | SslOptions | undefined, not boolean
+                ssl: typeof this.config.ssl === 'boolean'
+                    ? (this.config.ssl ? {} : undefined)
+                    : this.config.ssl,
+                // Other options
+                enableKeepAlive: poolConfig.enableKeepAlive ?? true,
+                keepAliveInitialDelay: poolConfig.keepAliveInitialDelay ?? 0,
+                // Namedplaceholders for better parameter handling
+                namedPlaceholders: false,
+                // Promise wrapper
+                Promise: Promise
+            });
+            // Test the connection
+            const connection = await this.pool.getConnection();
+            connection.release();
+            logger.info('Connection pool initialized', {
+                host: this.config.host,
+                port: this.config.port,
+                database: this.config.database,
+                connectionLimit: poolConfig.connectionLimit ?? 10
+            });
+        }
+        catch (error) {
+            const err = error;
+            throw new ConnectionError(`Failed to initialize connection pool: ${err.message}`, {
+                host: this.config.host,
+                port: this.config.port,
+                database: this.config.database
+            });
+        }
+    }
+    /**
+     * Get a connection from the pool
+     */
+    async getConnection() {
+        if (!this.pool) {
+            throw new PoolError('Connection pool not initialized');
+        }
+        if (this.isShuttingDown) {
+            throw new PoolError('Connection pool is shutting down');
+        }
+        try {
+            const connection = await this.pool.getConnection();
+            this.stats.active++;
+            return connection;
+        }
+        catch (error) {
+            const err = error;
+            throw new PoolError(`Failed to get connection: ${err.message}`);
+        }
+    }
+    /**
+     * Release a connection back to the pool
+     */
+    releaseConnection(connection) {
+        try {
+            connection.release();
+            this.stats.active = Math.max(0, this.stats.active - 1);
+        }
+        catch (error) {
+            logger.error('Error releasing connection', { error: String(error) });
+        }
+    }
+    /**
+     * Execute a query using a pooled connection
+     * Returns full result tuple [rows, fields] for compatibility with rawQuery
+     */
+    async query(sql, params) {
+        if (!this.pool) {
+            throw new PoolError('Connection pool not initialized');
+        }
+        this.stats.totalQueries++;
+        try {
+            const result = await this.pool.query(sql, params);
+            return result;
+        }
+        catch (error) {
+            const err = error;
+            throw new PoolError(`Query failed: ${err.message}`, { sql }, err.code);
+        }
+    }
+    /**
+     * Execute a query and return full result with metadata
+     */
+    async execute(sql, params) {
+        if (!this.pool) {
+            throw new PoolError('Connection pool not initialized');
+        }
+        this.stats.totalQueries++;
+        try {
+            const result = await this.pool.execute(sql, params);
+            return result;
+        }
+        catch (error) {
+            const err = error;
+            throw new PoolError(`Execute failed: ${err.message}`, { sql }, err.code);
+        }
+    }
+    /**
+     * Get pool statistics
+     */
+    getStats() {
+        if (!this.pool) {
+            return this.stats;
+        }
+        // mysql2 pool doesn't expose detailed stats directly
+        // We track what we can
+        return {
+            ...this.stats,
+            total: this.config.pool?.connectionLimit ?? 10,
+            idle: (this.config.pool?.connectionLimit ?? 10) - this.stats.active
+        };
+    }
+    /**
+     * Check pool health
+     */
+    async checkHealth() {
+        if (!this.pool) {
+            return {
+                connected: false,
+                error: 'Pool not initialized'
+            };
+        }
+        const startTime = Date.now();
+        try {
+            const connection = await this.pool.getConnection();
+            try {
+                // Ping to verify connection
+                await connection.ping();
+                // Get server version
+                const [rows] = await connection.query('SELECT VERSION() as version');
+                const result = rows;
+                const version = result[0]?.version;
+                const latencyMs = Date.now() - startTime;
+                return {
+                    connected: true,
+                    latencyMs,
+                    version,
+                    poolStats: this.getStats()
+                };
+            }
+            finally {
+                connection.release();
+            }
+        }
+        catch (error) {
+            return {
+                connected: false,
+                latencyMs: Date.now() - startTime,
+                error: String(error),
+                poolStats: this.getStats()
+            };
+        }
+    }
+    /**
+     * Gracefully shutdown the pool
+     */
+    async shutdown() {
+        if (!this.pool) {
+            return;
+        }
+        this.isShuttingDown = true;
+        logger.info('Shutting down connection pool...');
+        try {
+            await this.pool.end();
+            this.pool = null;
+            logger.info('Connection pool shut down successfully');
+        }
+        catch (error) {
+            logger.error('Error shutting down connection pool', { error: String(error) });
+            throw error;
+        }
+    }
+    /**
+     * Check if pool is initialized
+     */
+    isInitialized() {
+        return this.pool !== null;
+    }
+    /**
+     * Check if pool is shutting down
+     */
+    isClosing() {
+        return this.isShuttingDown;
+    }
+}
+//# sourceMappingURL=ConnectionPool.js.map

package/dist/pool/ConnectionPool.js.map

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

package/dist/progress/ProgressReporter.d.ts

@@ -0,0 +1,101 @@
+/**
+ * MCP Protocol Progress Notifications
+ *
+ * Reports progress for long-running operations to MCP clients.
+ * Clients can use this to display progress bars or status updates.
+ *
+ * MCP Spec Reference:
+ * https://modelcontextprotocol.io/specification/2025-11-25/server/utilities/progress
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Progress token type as defined in MCP spec
+ */
+export type ProgressToken = string | number;
+/**
+ * ProgressReporter wraps progress notification sending for a specific operation
+ *
+ * Usage:
+ *   const reporter = new ProgressReporter(server, progressToken);
+ *   reporter.report(10, 100, 'Processing rows...');
+ *   reporter.report(50, 100, 'Halfway done...');
+ *   reporter.complete('Done!');
+ */
+export declare class ProgressReporter {
+    private server;
+    private progressToken;
+    private completed;
+    constructor(server: McpServer, progressToken: ProgressToken);
+    /**
+     * Get the progress token for this reporter
+     */
+    getToken(): ProgressToken;
+    /**
+     * Send a progress notification to the client
+     */
+    private sendProgress;
+    /**
+     * Report progress to the client
+     *
+     * @param progress - Current progress value (e.g., rows processed, bytes transferred)
+     * @param total - Optional total expected value for percentage calculation
+     * @param message - Optional human-readable status message
+     */
+    report(progress: number, total?: number, message?: string): void;
+    /**
+     * Report completion with optional final message
+     */
+    complete(message?: string): void;
+    /**
+     * Report an error condition
+     */
+    error(message: string): void;
+    /**
+     * Check if this reporter is still active
+     */
+    isActive(): boolean;
+}
+/**
+ * Progress reporter factory
+ *
+ * Use this when you need to create progress reporters across the application.
+ * Initialize with the SDK server instance at startup.
+ */
+declare class ProgressReporterFactory {
+    private server;
+    /**
+     * Initialize the factory with the SDK server
+     */
+    setServer(server: McpServer): void;
+    /**
+     * Create a new progress reporter for an operation
+     *
+     * @param progressToken - Token from the client request (if provided)
+     * @returns ProgressReporter if token provided and server available, null otherwise
+     */
+    create(progressToken: ProgressToken | undefined): ProgressReporter | null;
+    /**
+     * Check if progress reporting is available
+     */
+    isAvailable(): boolean;
+}
+/**
+ * Singleton factory instance
+ *
+ * Usage:
+ *   import { progressFactory } from './progress/ProgressReporter.js';
+ *
+ *   // In server startup:
+ *   progressFactory.setServer(sdkServer);
+ *
+ *   // In tool handler:
+ *   const reporter = progressFactory.create(context.progressToken);
+ *   if (reporter) {
+ *     reporter.report(0, totalRows, 'Starting export...');
+ *     // ... do work ...
+ *     reporter.complete('Export finished');
+ *   }
+ */
+export declare const progressFactory: ProgressReporterFactory;
+export {};
+//# sourceMappingURL=ProgressReporter.d.ts.map

package/dist/progress/ProgressReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressReporter.d.ts","sourceRoot":"","sources":["../../src/progress/ProgressReporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAY5C;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAIrB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,aAAa;IAJzB,OAAO,CAAC,SAAS,CAAS;gBAGd,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,aAAa;IAGxC;;OAEG;IACH,QAAQ,IAAI,aAAa;IAIzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAWhE;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAYhC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAW5B;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGtB;AAED;;;;;GAKG;AACH,cAAM,uBAAuB;IACzB,OAAO,CAAC,MAAM,CAA0B;IAExC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAIlC;;;;;OAKG;IACH,MAAM,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI;IAOzE;;OAEG;IACH,WAAW,IAAI,OAAO;CAGzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,yBAAgC,CAAC"}

package/dist/progress/ProgressReporter.js

@@ -0,0 +1,153 @@
+/**
+ * MCP Protocol Progress Notifications
+ *
+ * Reports progress for long-running operations to MCP clients.
+ * Clients can use this to display progress bars or status updates.
+ *
+ * MCP Spec Reference:
+ * https://modelcontextprotocol.io/specification/2025-11-25/server/utilities/progress
+ */
+/**
+ * ProgressReporter wraps progress notification sending for a specific operation
+ *
+ * Usage:
+ *   const reporter = new ProgressReporter(server, progressToken);
+ *   reporter.report(10, 100, 'Processing rows...');
+ *   reporter.report(50, 100, 'Halfway done...');
+ *   reporter.complete('Done!');
+ */
+export class ProgressReporter {
+    server;
+    progressToken;
+    completed = false;
+    constructor(server, progressToken) {
+        this.server = server;
+        this.progressToken = progressToken;
+    }
+    /**
+     * Get the progress token for this reporter
+     */
+    getToken() {
+        return this.progressToken;
+    }
+    /**
+     * Send a progress notification to the client
+     */
+    sendProgress(params) {
+        try {
+            // Access the underlying Server instance and use its notification method
+            // The McpServer wraps Server, which has notification() for raw notifications
+            const underlyingServer = this.server.server;
+            void underlyingServer.notification({
+                method: 'notifications/progress',
+                params
+            });
+        }
+        catch {
+            // Silently fail - progress is non-critical
+            // Transport might not support progress or not be connected yet
+        }
+    }
+    /**
+     * Report progress to the client
+     *
+     * @param progress - Current progress value (e.g., rows processed, bytes transferred)
+     * @param total - Optional total expected value for percentage calculation
+     * @param message - Optional human-readable status message
+     */
+    report(progress, total, message) {
+        if (this.completed)
+            return;
+        this.sendProgress({
+            progressToken: this.progressToken,
+            progress,
+            total,
+            message
+        });
+    }
+    /**
+     * Report completion with optional final message
+     */
+    complete(message) {
+        if (this.completed)
+            return;
+        this.completed = true;
+        this.sendProgress({
+            progressToken: this.progressToken,
+            progress: 1,
+            total: 1,
+            message: message ?? 'Complete'
+        });
+    }
+    /**
+     * Report an error condition
+     */
+    error(message) {
+        if (this.completed)
+            return;
+        this.completed = true;
+        this.sendProgress({
+            progressToken: this.progressToken,
+            progress: 0,
+            message: `Error: ${message}`
+        });
+    }
+    /**
+     * Check if this reporter is still active
+     */
+    isActive() {
+        return !this.completed;
+    }
+}
+/**
+ * Progress reporter factory
+ *
+ * Use this when you need to create progress reporters across the application.
+ * Initialize with the SDK server instance at startup.
+ */
+class ProgressReporterFactory {
+    server = null;
+    /**
+     * Initialize the factory with the SDK server
+     */
+    setServer(server) {
+        this.server = server;
+    }
+    /**
+     * Create a new progress reporter for an operation
+     *
+     * @param progressToken - Token from the client request (if provided)
+     * @returns ProgressReporter if token provided and server available, null otherwise
+     */
+    create(progressToken) {
+        if (!this.server || progressToken === undefined) {
+            return null;
+        }
+        return new ProgressReporter(this.server, progressToken);
+    }
+    /**
+     * Check if progress reporting is available
+     */
+    isAvailable() {
+        return this.server !== null;
+    }
+}
+/**
+ * Singleton factory instance
+ *
+ * Usage:
+ *   import { progressFactory } from './progress/ProgressReporter.js';
+ *
+ *   // In server startup:
+ *   progressFactory.setServer(sdkServer);
+ *
+ *   // In tool handler:
+ *   const reporter = progressFactory.create(context.progressToken);
+ *   if (reporter) {
+ *     reporter.report(0, totalRows, 'Starting export...');
+ *     // ... do work ...
+ *     reporter.complete('Export finished');
+ *   }
+ */
+export const progressFactory = new ProgressReporterFactory();
+//# sourceMappingURL=ProgressReporter.js.map

package/dist/progress/ProgressReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressReporter.js","sourceRoot":"","sources":["../../src/progress/ProgressReporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IAIb;IACA;IAJJ,SAAS,GAAG,KAAK,CAAC;IAE1B,YACY,MAAiB,EACjB,aAA4B;QAD5B,WAAM,GAAN,MAAM,CAAW;QACjB,kBAAa,GAAb,aAAa,CAAe;IACpC,CAAC;IAEL;;OAEG;IACH,QAAQ;QACJ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,MAAkC;QACnD,IAAI,CAAC;YACD,wEAAwE;YACxE,6EAA6E;YAC7E,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YAC5C,KAAK,gBAAgB,CAAC,YAAY,CAAC;gBAC/B,MAAM,EAAE,wBAAwB;gBAChC,MAAM;aACT,CAAC,CAAC;QACP,CAAC;QAAC,MAAM,CAAC;YACL,2CAA2C;YAC3C,+DAA+D;QACnE,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,QAAgB,EAAE,KAAc,EAAE,OAAgB;QACrD,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAE3B,IAAI,CAAC,YAAY,CAAC;YACd,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ;YACR,KAAK;YACL,OAAO;SACV,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAAgB;QACrB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,IAAI,CAAC,YAAY,CAAC;YACd,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,OAAO,IAAI,UAAU;SACjC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe;QACjB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,IAAI,CAAC,YAAY,CAAC;YACd,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,UAAU,OAAO,EAAE;SAC/B,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;IAC3B,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,uBAAuB;IACjB,MAAM,GAAqB,IAAI,CAAC;IAExC;;OAEG;IACH,SAAS,CAAC,MAAiB;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAwC;QAC3C,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,WAAW;QACP,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAChC,CAAC;CACJ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,uBAAuB,EAAE,CAAC"}

package/dist/progress/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Progress Module Index
+ *
+ * Re-exports progress notification utilities.
+ */
+export { ProgressReporter, progressFactory, type ProgressToken } from './ProgressReporter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/progress/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/progress/index.js

@@ -0,0 +1,7 @@
+/**
+ * Progress Module Index
+ *
+ * Re-exports progress notification utilities.
+ */
+export { ProgressReporter, progressFactory } from './ProgressReporter.js';
+//# sourceMappingURL=index.js.map

package/dist/progress/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/progress/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAsB,MAAM,uBAAuB,CAAC"}