@reaudit/mcp-server 1.0.0

package/dist/lib/offline-mode.js

@@ -0,0 +1,356 @@
+"use strict";
+/**
+ * Offline Mode Handler
+ *
+ * Provides graceful degradation when the API is unavailable,
+ * with request queuing for retry.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectionStatus = void 0;
+exports.initOfflineMode = initOfflineMode;
+exports.stopOfflineMode = stopOfflineMode;
+exports.getConnectionStatus = getConnectionStatus;
+exports.isOnline = isOnline;
+exports.onStatusChange = onStatusChange;
+exports.setConnectionStatus = setConnectionStatus;
+exports.queueRequest = queueRequest;
+exports.getQueuedRequests = getQueuedRequests;
+exports.getQueueSize = getQueueSize;
+exports.clearQueue = clearQueue;
+exports.removeFromQueue = removeFromQueue;
+exports.getOfflineModeStatus = getOfflineModeStatus;
+exports.formatOfflineStatus = formatOfflineStatus;
+exports.cacheForOffline = cacheForOffline;
+exports.getOfflineCache = getOfflineCache;
+exports.clearOfflineCache = clearOfflineCache;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+/**
+ * Connection status
+ */
+var ConnectionStatus;
+(function (ConnectionStatus) {
+    ConnectionStatus["ONLINE"] = "online";
+    ConnectionStatus["OFFLINE"] = "offline";
+    ConnectionStatus["DEGRADED"] = "degraded";
+})(ConnectionStatus || (exports.ConnectionStatus = ConnectionStatus = {}));
+const DEFAULT_CONFIG = {
+    queuePath: path.join(os.homedir(), '.reaudit', 'request-queue.json'),
+    maxQueueSize: 100,
+    maxRetries: 5,
+    checkInterval: 30000, // 30 seconds
+};
+/**
+ * Offline mode state
+ */
+let currentStatus = ConnectionStatus.ONLINE;
+let lastOnlineCheck = 0;
+let requestQueue = [];
+let checkTimer = null;
+/**
+ * Status change callbacks
+ */
+const statusCallbacks = [];
+/**
+ * Initialize offline mode
+ */
+function initOfflineMode(config = {}) {
+    const fullConfig = { ...DEFAULT_CONFIG, ...config };
+    // Load persisted queue
+    loadQueue(fullConfig.queuePath);
+    // Start periodic connectivity check
+    if (checkTimer) {
+        clearInterval(checkTimer);
+    }
+    checkTimer = setInterval(() => {
+        checkConnectivity();
+    }, fullConfig.checkInterval);
+}
+/**
+ * Stop offline mode
+ */
+function stopOfflineMode() {
+    if (checkTimer) {
+        clearInterval(checkTimer);
+        checkTimer = null;
+    }
+}
+/**
+ * Get current connection status
+ */
+function getConnectionStatus() {
+    return currentStatus;
+}
+/**
+ * Check if we're online
+ */
+function isOnline() {
+    return currentStatus === ConnectionStatus.ONLINE;
+}
+/**
+ * Register status change callback
+ */
+function onStatusChange(callback) {
+    statusCallbacks.push(callback);
+}
+/**
+ * Update connection status
+ */
+function setConnectionStatus(status) {
+    if (status !== currentStatus) {
+        currentStatus = status;
+        lastOnlineCheck = Date.now();
+        // Notify callbacks
+        for (const callback of statusCallbacks) {
+            try {
+                callback(status);
+            }
+            catch (e) {
+                console.error('Error in status callback:', e);
+            }
+        }
+        // If back online, process queue
+        if (status === ConnectionStatus.ONLINE) {
+            processQueue();
+        }
+    }
+}
+/**
+ * Check connectivity (called periodically)
+ */
+async function checkConnectivity() {
+    // This would make a lightweight health check request
+    // For now, we just update the timestamp
+    lastOnlineCheck = Date.now();
+}
+/**
+ * Queue a request for later retry
+ */
+function queueRequest(method, path, data, params) {
+    const id = `req_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+    const request = {
+        id,
+        method,
+        path,
+        data,
+        params,
+        queuedAt: Date.now(),
+        retryCount: 0,
+        maxRetries: DEFAULT_CONFIG.maxRetries,
+    };
+    // Add to queue (limit size)
+    requestQueue.push(request);
+    if (requestQueue.length > DEFAULT_CONFIG.maxQueueSize) {
+        requestQueue.shift(); // Remove oldest
+    }
+    // Persist queue
+    saveQueue(DEFAULT_CONFIG.queuePath);
+    return id;
+}
+/**
+ * Get queued requests
+ */
+function getQueuedRequests() {
+    return [...requestQueue];
+}
+/**
+ * Get queue size
+ */
+function getQueueSize() {
+    return requestQueue.length;
+}
+/**
+ * Clear the request queue
+ */
+function clearQueue() {
+    requestQueue = [];
+    saveQueue(DEFAULT_CONFIG.queuePath);
+}
+/**
+ * Remove a request from queue
+ */
+function removeFromQueue(requestId) {
+    const index = requestQueue.findIndex(r => r.id === requestId);
+    if (index >= 0) {
+        requestQueue.splice(index, 1);
+        saveQueue(DEFAULT_CONFIG.queuePath);
+        return true;
+    }
+    return false;
+}
+/**
+ * Process queued requests (called when back online)
+ */
+async function processQueue() {
+    if (requestQueue.length === 0) {
+        return;
+    }
+    console.error(`[Offline Mode] Processing ${requestQueue.length} queued requests...`);
+    // Process requests one at a time
+    const toProcess = [...requestQueue];
+    for (const request of toProcess) {
+        if (currentStatus !== ConnectionStatus.ONLINE) {
+            break; // Stop if we go offline again
+        }
+        try {
+            // Increment retry count
+            request.retryCount++;
+            // TODO: Actually retry the request using the API client
+            // For now, just remove from queue
+            removeFromQueue(request.id);
+            console.error(`[Offline Mode] Processed request ${request.id}`);
+        }
+        catch (error) {
+            if (request.retryCount >= request.maxRetries) {
+                // Max retries reached, remove from queue
+                removeFromQueue(request.id);
+                console.error(`[Offline Mode] Request ${request.id} failed after ${request.maxRetries} retries`);
+            }
+        }
+    }
+}
+/**
+ * Load queue from disk
+ */
+function loadQueue(queuePath) {
+    try {
+        if (fs.existsSync(queuePath)) {
+            const data = fs.readFileSync(queuePath, 'utf-8');
+            requestQueue = JSON.parse(data);
+        }
+    }
+    catch (error) {
+        console.error('[Offline Mode] Error loading queue:', error);
+        requestQueue = [];
+    }
+}
+/**
+ * Save queue to disk
+ */
+function saveQueue(queuePath) {
+    try {
+        const dir = path.dirname(queuePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(queuePath, JSON.stringify(requestQueue, null, 2));
+    }
+    catch (error) {
+        console.error('[Offline Mode] Error saving queue:', error);
+    }
+}
+/**
+ * Get offline mode status for display
+ */
+function getOfflineModeStatus() {
+    const lastCheckStr = lastOnlineCheck
+        ? new Date(lastOnlineCheck).toISOString()
+        : 'Never';
+    let message;
+    switch (currentStatus) {
+        case ConnectionStatus.ONLINE:
+            message = 'Connected to Reaudit';
+            break;
+        case ConnectionStatus.OFFLINE:
+            message = `Offline - ${requestQueue.length} requests queued`;
+            break;
+        case ConnectionStatus.DEGRADED:
+            message = 'Limited connectivity - some features may be unavailable';
+            break;
+    }
+    return {
+        status: currentStatus,
+        queueSize: requestQueue.length,
+        lastCheck: lastCheckStr,
+        message,
+    };
+}
+/**
+ * Format offline status for user display
+ */
+function formatOfflineStatus() {
+    const status = getOfflineModeStatus();
+    const statusEmoji = {
+        [ConnectionStatus.ONLINE]: '🟢',
+        [ConnectionStatus.OFFLINE]: '🔴',
+        [ConnectionStatus.DEGRADED]: '🟡',
+    };
+    let output = `## Connection Status\n\n`;
+    output += `${statusEmoji[status.status]} **${status.status.toUpperCase()}**\n\n`;
+    output += `${status.message}\n\n`;
+    if (status.queueSize > 0) {
+        output += `### Queued Requests\n`;
+        output += `${status.queueSize} request(s) waiting to be processed when back online.\n\n`;
+    }
+    output += `Last connectivity check: ${status.lastCheck}\n`;
+    return output;
+}
+const offlineCache = new Map();
+/**
+ * Cache data for offline access
+ */
+function cacheForOffline(key, data, ttlMs = 3600000) {
+    const now = Date.now();
+    offlineCache.set(key, {
+        key,
+        data,
+        cachedAt: now,
+        expiresAt: now + ttlMs,
+    });
+}
+/**
+ * Get cached data (for offline use)
+ */
+function getOfflineCache(key) {
+    const cached = offlineCache.get(key);
+    if (!cached) {
+        return null;
+    }
+    // Check expiration
+    if (Date.now() > cached.expiresAt) {
+        offlineCache.delete(key);
+        return null;
+    }
+    return cached.data;
+}
+/**
+ * Clear offline cache
+ */
+function clearOfflineCache() {
+    offlineCache.clear();
+}
+//# sourceMappingURL=offline-mode.js.map

package/dist/lib/offline-mode.js.map

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

package/dist/lib/progress-tracker.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Progress Tracker
+ *
+ * Tracks progress of long-running operations and supports cancellation.
+ */
+/**
+ * Progress status
+ */
+export declare enum ProgressStatus {
+    PENDING = "pending",
+    RUNNING = "running",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELLED = "cancelled"
+}
+/**
+ * Progress update
+ */
+export interface ProgressUpdate {
+    operationId: string;
+    status: ProgressStatus;
+    progress: number;
+    message: string;
+    startedAt: number;
+    updatedAt: number;
+    completedAt?: number;
+    error?: string;
+    result?: unknown;
+}
+/**
+ * Operation configuration
+ */
+interface OperationConfig {
+    operationId: string;
+    name: string;
+    totalSteps?: number;
+    onProgress?: (update: ProgressUpdate) => void;
+    onComplete?: (result: unknown) => void;
+    onError?: (error: Error) => void;
+    onCancel?: () => void;
+}
+/**
+ * Generate unique operation ID
+ */
+export declare function generateOperationId(): string;
+/**
+ * Start tracking a new operation
+ */
+export declare function startOperation(config: OperationConfig): ProgressUpdate;
+/**
+ * Update operation progress
+ */
+export declare function updateProgress(operationId: string, progress: number, message: string): ProgressUpdate | null;
+/**
+ * Complete an operation successfully
+ */
+export declare function completeOperation(operationId: string, result?: unknown): ProgressUpdate | null;
+/**
+ * Fail an operation
+ */
+export declare function failOperation(operationId: string, error: Error): ProgressUpdate | null;
+/**
+ * Request cancellation of an operation
+ */
+export declare function cancelOperation(operationId: string): boolean;
+/**
+ * Check if operation is cancelled
+ */
+export declare function isCancelled(operationId: string): boolean;
+/**
+ * Get operation status
+ */
+export declare function getOperationStatus(operationId: string): ProgressUpdate | null;
+/**
+ * Get all active operations
+ */
+export declare function getActiveOperations(): ProgressUpdate[];
+/**
+ * Format progress for display
+ */
+export declare function formatProgress(update: ProgressUpdate): string;
+/**
+ * Run an operation with progress tracking
+ */
+export declare function withProgress<T>(name: string, fn: (updateProgress: (progress: number, message: string) => void, checkCancelled: () => boolean) => Promise<T>, onProgress?: (update: ProgressUpdate) => void): Promise<T>;
+export {};
+//# sourceMappingURL=progress-tracker.d.ts.map

package/dist/lib/progress-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-tracker.d.ts","sourceRoot":"","sources":["../../src/lib/progress-tracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAWD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,CAsBtE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,cAAc,GAAG,IAAI,CAuBvB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO,GACf,cAAc,GAAG,IAAI,CA6BvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,KAAK,GACX,cAAc,GAAG,IAAI,CA4BvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CA6B5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAG7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAItD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAiB7D;AAWD;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CACF,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,EAC3D,cAAc,EAAE,MAAM,OAAO,KAC1B,OAAO,CAAC,CAAC,CAAC,EACf,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,GAC5C,OAAO,CAAC,CAAC,CAAC,CAwBZ"}

package/dist/lib/progress-tracker.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * Progress Tracker
+ *
+ * Tracks progress of long-running operations and supports cancellation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressStatus = void 0;
+exports.generateOperationId = generateOperationId;
+exports.startOperation = startOperation;
+exports.updateProgress = updateProgress;
+exports.completeOperation = completeOperation;
+exports.failOperation = failOperation;
+exports.cancelOperation = cancelOperation;
+exports.isCancelled = isCancelled;
+exports.getOperationStatus = getOperationStatus;
+exports.getActiveOperations = getActiveOperations;
+exports.formatProgress = formatProgress;
+exports.withProgress = withProgress;
+/**
+ * Progress status
+ */
+var ProgressStatus;
+(function (ProgressStatus) {
+    ProgressStatus["PENDING"] = "pending";
+    ProgressStatus["RUNNING"] = "running";
+    ProgressStatus["COMPLETED"] = "completed";
+    ProgressStatus["FAILED"] = "failed";
+    ProgressStatus["CANCELLED"] = "cancelled";
+})(ProgressStatus || (exports.ProgressStatus = ProgressStatus = {}));
+/**
+ * Active operations storage
+ */
+const activeOperations = new Map();
+/**
+ * Generate unique operation ID
+ */
+function generateOperationId() {
+    return `op_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+/**
+ * Start tracking a new operation
+ */
+function startOperation(config) {
+    const now = Date.now();
+    const update = {
+        operationId: config.operationId,
+        status: ProgressStatus.RUNNING,
+        progress: 0,
+        message: `Starting ${config.name}...`,
+        startedAt: now,
+        updatedAt: now,
+    };
+    activeOperations.set(config.operationId, {
+        config,
+        update,
+        cancelled: false,
+    });
+    // Notify progress callback
+    config.onProgress?.(update);
+    return update;
+}
+/**
+ * Update operation progress
+ */
+function updateProgress(operationId, progress, message) {
+    const operation = activeOperations.get(operationId);
+    if (!operation) {
+        return null;
+    }
+    // Check if cancelled
+    if (operation.cancelled) {
+        return operation.update;
+    }
+    operation.update = {
+        ...operation.update,
+        progress: Math.min(100, Math.max(0, progress)),
+        message,
+        updatedAt: Date.now(),
+    };
+    // Notify progress callback
+    operation.config.onProgress?.(operation.update);
+    return operation.update;
+}
+/**
+ * Complete an operation successfully
+ */
+function completeOperation(operationId, result) {
+    const operation = activeOperations.get(operationId);
+    if (!operation) {
+        return null;
+    }
+    const now = Date.now();
+    operation.update = {
+        ...operation.update,
+        status: ProgressStatus.COMPLETED,
+        progress: 100,
+        message: 'Completed',
+        updatedAt: now,
+        completedAt: now,
+        result,
+    };
+    // Notify callbacks
+    operation.config.onProgress?.(operation.update);
+    operation.config.onComplete?.(result);
+    // Clean up after a delay
+    setTimeout(() => {
+        activeOperations.delete(operationId);
+    }, 60000); // Keep for 1 minute
+    return operation.update;
+}
+/**
+ * Fail an operation
+ */
+function failOperation(operationId, error) {
+    const operation = activeOperations.get(operationId);
+    if (!operation) {
+        return null;
+    }
+    const now = Date.now();
+    operation.update = {
+        ...operation.update,
+        status: ProgressStatus.FAILED,
+        message: 'Failed',
+        updatedAt: now,
+        completedAt: now,
+        error: error.message,
+    };
+    // Notify callbacks
+    operation.config.onProgress?.(operation.update);
+    operation.config.onError?.(error);
+    // Clean up after a delay
+    setTimeout(() => {
+        activeOperations.delete(operationId);
+    }, 60000);
+    return operation.update;
+}
+/**
+ * Request cancellation of an operation
+ */
+function cancelOperation(operationId) {
+    const operation = activeOperations.get(operationId);
+    if (!operation) {
+        return false;
+    }
+    if (operation.update.status !== ProgressStatus.RUNNING) {
+        return false;
+    }
+    operation.cancelled = true;
+    operation.update = {
+        ...operation.update,
+        status: ProgressStatus.CANCELLED,
+        message: 'Cancelled by user',
+        updatedAt: Date.now(),
+    };
+    // Notify callbacks
+    operation.config.onProgress?.(operation.update);
+    operation.config.onCancel?.();
+    // Clean up after a delay
+    setTimeout(() => {
+        activeOperations.delete(operationId);
+    }, 60000);
+    return true;
+}
+/**
+ * Check if operation is cancelled
+ */
+function isCancelled(operationId) {
+    const operation = activeOperations.get(operationId);
+    return operation?.cancelled ?? false;
+}
+/**
+ * Get operation status
+ */
+function getOperationStatus(operationId) {
+    const operation = activeOperations.get(operationId);
+    return operation?.update ?? null;
+}
+/**
+ * Get all active operations
+ */
+function getActiveOperations() {
+    return Array.from(activeOperations.values())
+        .filter(op => op.update.status === ProgressStatus.RUNNING)
+        .map(op => op.update);
+}
+/**
+ * Format progress for display
+ */
+function formatProgress(update) {
+    const elapsed = Math.round((update.updatedAt - update.startedAt) / 1000);
+    const progressBar = createProgressBar(update.progress);
+    let output = `**${update.message}**\n\n`;
+    output += `${progressBar} ${update.progress}%\n`;
+    output += `Elapsed: ${elapsed}s\n`;
+    if (update.status === ProgressStatus.COMPLETED) {
+        output += `\n✅ Completed successfully`;
+    }
+    else if (update.status === ProgressStatus.FAILED) {
+        output += `\n❌ Failed: ${update.error}`;
+    }
+    else if (update.status === ProgressStatus.CANCELLED) {
+        output += `\n⚠️ Cancelled`;
+    }
+    return output;
+}
+/**
+ * Create ASCII progress bar
+ */
+function createProgressBar(progress, width = 20) {
+    const filled = Math.round((progress / 100) * width);
+    const empty = width - filled;
+    return `[${'█'.repeat(filled)}${'░'.repeat(empty)}]`;
+}
+/**
+ * Run an operation with progress tracking
+ */
+async function withProgress(name, fn, onProgress) {
+    const operationId = generateOperationId();
+    startOperation({
+        operationId,
+        name,
+        onProgress,
+    });
+    try {
+        const result = await fn((progress, message) => updateProgress(operationId, progress, message), () => isCancelled(operationId));
+        completeOperation(operationId, result);
+        return result;
+    }
+    catch (error) {
+        if (isCancelled(operationId)) {
+            throw new Error('Operation cancelled');
+        }
+        failOperation(operationId, error instanceof Error ? error : new Error(String(error)));
+        throw error;
+    }
+}
+//# sourceMappingURL=progress-tracker.js.map