mcp-image 0.1.0

package/dist/business/secureFileManager.js

@@ -0,0 +1,185 @@
+/**
+ * Secure File Manager for handling image file operations with enhanced security
+ * Extends FileManager with security features, temporary file management, and cleanup
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { Err, Ok } from '../types/result';
+import { FileOperationError } from '../utils/errors';
+import { Logger } from '../utils/logger';
+import { SecurityManager } from '../utils/security';
+import { FileManager } from './fileManager';
+/**
+ * Secure file manager with enhanced security features and temporary file management
+ */
+export class SecureFileManager extends FileManager {
+    constructor() {
+        super(...arguments);
+        this.tempFiles = new Set();
+        this.securityManager = new SecurityManager();
+        this.logger = new Logger();
+    }
+    /**
+     * Securely save image data with comprehensive security checks
+     * @param imageData Buffer containing the image data
+     * @param outputPath Path where the image should be saved
+     * @param format Image format for validation (optional)
+     * @returns Result containing the saved file path or an error
+     */
+    async saveImageSecure(imageData, outputPath, format) {
+        try {
+            // Security validation
+            const sanitizedPath = this.securityManager.sanitizeFilePath(outputPath);
+            if (!sanitizedPath.success) {
+                return sanitizedPath;
+            }
+            const validationResult = this.securityManager.validateImageFile(sanitizedPath.data);
+            if (!validationResult.success) {
+                return validationResult;
+            }
+            // Ensure secure directory creation
+            const dirPath = path.dirname(sanitizedPath.data);
+            const dirResult = await this.ensureSecureDirectory(dirPath);
+            if (!dirResult.success) {
+                return dirResult;
+            }
+            // Atomic file operation using temporary file
+            const tempPath = `${sanitizedPath.data}.tmp`;
+            this.tempFiles.add(tempPath);
+            this.logger.debug('secure-file-manager', 'Starting atomic file save', {
+                outputPath: sanitizedPath.data,
+                tempPath,
+                fileSize: imageData.length,
+                format,
+            });
+            // Write to temporary file first
+            await fs.writeFile(tempPath, imageData);
+            // Atomic move to final destination
+            await fs.rename(tempPath, sanitizedPath.data);
+            this.tempFiles.delete(tempPath);
+            this.logger.info('secure-file-manager', 'Image saved successfully', {
+                outputPath: sanitizedPath.data,
+                fileSize: imageData.length,
+                format,
+                securityChecks: 'passed',
+            });
+            return Ok(sanitizedPath.data);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            this.logger.error('secure-file-manager', 'Failed to save image securely', error, {
+                outputPath,
+                format,
+                errorType: 'file-operation',
+            });
+            return Err(new FileOperationError(`Failed to save image: ${errorMessage}`));
+        }
+    }
+    /**
+     * Ensure secure directory creation with security validation
+     * @param dirPath Directory path to create
+     * @returns Result indicating success or failure
+     */
+    async ensureSecureDirectory(dirPath) {
+        try {
+            // Validate directory path security
+            const validationResult = this.securityManager.validateDirectoryPath(dirPath);
+            if (!validationResult.success) {
+                return validationResult;
+            }
+            // Use parent class method for actual directory creation
+            const createResult = this.ensureDirectoryExists(dirPath);
+            if (!createResult.success) {
+                return createResult;
+            }
+            this.logger.debug('secure-file-manager', 'Secure directory created', {
+                directoryPath: dirPath,
+            });
+            return Ok(undefined);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            this.logger.error('secure-file-manager', 'Failed to create secure directory', error, {
+                directoryPath: dirPath,
+            });
+            return Err(new FileOperationError(`Failed to create secure directory: ${errorMessage}`));
+        }
+    }
+    /**
+     * Cleanup all tracked temporary files
+     */
+    async cleanup() {
+        const cleanupPromises = Array.from(this.tempFiles).map(async (tempFile) => {
+            try {
+                await fs.unlink(tempFile);
+                this.tempFiles.delete(tempFile);
+                this.logger.debug('secure-file-manager', 'Temporary file cleaned up', {
+                    file: tempFile,
+                });
+            }
+            catch (error) {
+                this.logger.warn('secure-file-manager', 'Failed to cleanup temporary file', {
+                    file: tempFile,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                });
+            }
+        });
+        await Promise.all(cleanupPromises);
+        if (this.tempFiles.size > 0) {
+            this.logger.warn('secure-file-manager', 'Some temporary files could not be cleaned', {
+                remainingCount: this.tempFiles.size,
+            });
+        }
+    }
+    /**
+     * Setup process cleanup handlers for graceful shutdown
+     */
+    setupProcessCleanup() {
+        const cleanup = () => {
+            this.logger.info('secure-file-manager', 'Process cleanup initiated');
+            this.cleanup().catch((error) => {
+                console.error('Failed to cleanup temporary files:', error);
+            });
+        };
+        // Setup cleanup on various process exit scenarios
+        process.on('exit', cleanup);
+        process.on('SIGINT', cleanup);
+        process.on('SIGTERM', cleanup);
+        process.on('uncaughtException', (error) => {
+            this.logger.error('secure-file-manager', 'Uncaught exception during cleanup', error);
+            cleanup();
+        });
+        this.logger.info('secure-file-manager', 'Process cleanup handlers registered');
+    }
+    /**
+     * Generate secure filename with validation
+     * @param baseName Base name for the file
+     * @param extension File extension (with dot)
+     * @returns Secure filename
+     */
+    generateSecureFileName(baseName, extension) {
+        const sanitizedBase = baseName
+            ? this.securityManager.sanitizeFilename(baseName)
+            : 'gemini-image';
+        const safeExtension = extension || '.png';
+        const timestamp = Date.now();
+        const random = Math.floor(Math.random() * 1000);
+        return `${sanitizedBase}-${timestamp}-${random}${safeExtension}`;
+    }
+    /**
+     * Get count of tracked temporary files
+     * @returns Number of temporary files being tracked
+     */
+    getTempFileCount() {
+        return this.tempFiles.size;
+    }
+    /**
+     * Check if a specific temporary file is being tracked
+     * @param filePath Path to check
+     * @returns True if file is being tracked as temporary
+     */
+    isTempFileTracked(filePath) {
+        return this.tempFiles.has(filePath);
+    }
+}
+//# sourceMappingURL=secureFileManager.js.map

package/dist/business/secureFileManager.js.map

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

package/dist/business/urlExtractor.d.ts

@@ -0,0 +1,60 @@
+/**
+ * URL extraction logic for processing URLs in prompts
+ * Provides functionality to extract, validate, and manipulate URLs in text
+ */
+import { type Result } from '../types/result';
+import { InvalidUrlError } from '../utils/errors';
+/**
+ * Extract URLs from a given prompt text
+ * @param prompt The text to extract URLs from
+ * @returns Array of unique URLs found in the prompt (max 10)
+ */
+export declare function extractUrls(prompt: string): string[];
+/**
+ * Check if the prompt contains any URLs
+ * @param prompt The text to check for URLs
+ * @returns True if URLs are found, false otherwise
+ */
+export declare function hasUrls(prompt: string): boolean;
+/**
+ * Remove all URLs from the prompt text
+ * @param prompt The text to remove URLs from
+ * @returns The prompt with URLs removed and extra spaces trimmed
+ */
+export declare function removeUrls(prompt: string): string;
+/**
+ * Validate a single URL using built-in URL constructor
+ * @param url The URL string to validate
+ * @returns Result containing validation success or error
+ */
+export declare function validateUrl(url: string): Result<string, InvalidUrlError>;
+/**
+ * Extract and validate URLs from prompt with detailed error reporting
+ * @param prompt The text to extract URLs from
+ * @returns Result containing valid URLs or validation error
+ */
+export declare function extractValidUrls(prompt: string): Result<string[], InvalidUrlError>;
+/**
+ * Get URL statistics for analysis
+ * @param prompt The text to analyze
+ * @returns Statistics about URLs in the prompt
+ */
+export declare function getUrlStats(prompt: string): {
+    totalFound: number;
+    validUrls: number;
+    httpUrls: number;
+    httpsUrls: number;
+    uniqueDomains: string[];
+};
+/**
+ * URL extractor utilities - backward compatibility object
+ */
+export declare const URLExtractor: {
+    extractUrls: typeof extractUrls;
+    hasUrls: typeof hasUrls;
+    removeUrls: typeof removeUrls;
+    validateUrl: typeof validateUrl;
+    extractValidUrls: typeof extractValidUrls;
+    getUrlStats: typeof getUrlStats;
+};
+//# sourceMappingURL=urlExtractor.d.ts.map

package/dist/business/urlExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlExtractor.d.ts","sourceRoot":"","sources":["../../src/business/urlExtractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAcjD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CASpD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CA4BxE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAuBlF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB,CAwBA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;CAOxB,CAAA"}

package/dist/business/urlExtractor.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * URL extraction logic for processing URLs in prompts
+ * Provides functionality to extract, validate, and manipulate URLs in text
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.URLExtractor = void 0;
+exports.extractUrls = extractUrls;
+exports.hasUrls = hasUrls;
+exports.removeUrls = removeUrls;
+exports.validateUrl = validateUrl;
+exports.extractValidUrls = extractValidUrls;
+exports.getUrlStats = getUrlStats;
+const result_1 = require("../types/result");
+const errors_1 = require("../utils/errors");
+/**
+ * Enhanced regular expression pattern for matching HTTP and HTTPS URLs
+ * Supports complex URLs with query parameters, fragments, and various domains
+ * More precise pattern to avoid false positives
+ */
+const URL_PATTERN = /https?:\/\/(?:[-\w.])+(?:\.[a-zA-Z]{2,})+(?:\/[-\w._~:/?#[\]@!$&'()*+,;=]*)?/g;
+/**
+ * Maximum number of URLs to extract (performance consideration)
+ */
+const MAX_URLS = 10;
+/**
+ * Extract URLs from a given prompt text
+ * @param prompt The text to extract URLs from
+ * @returns Array of unique URLs found in the prompt (max 10)
+ */
+function extractUrls(prompt) {
+    const matches = prompt.match(URL_PATTERN);
+    if (!matches) {
+        return [];
+    }
+    // Remove duplicates using Set and limit to MAX_URLS
+    const uniqueUrls = [...new Set(matches)];
+    return uniqueUrls.slice(0, MAX_URLS);
+}
+/**
+ * Check if the prompt contains any URLs
+ * @param prompt The text to check for URLs
+ * @returns True if URLs are found, false otherwise
+ */
+function hasUrls(prompt) {
+    return extractUrls(prompt).length > 0;
+}
+/**
+ * Remove all URLs from the prompt text
+ * @param prompt The text to remove URLs from
+ * @returns The prompt with URLs removed and extra spaces trimmed
+ */
+function removeUrls(prompt) {
+    return prompt.replace(URL_PATTERN, '').replace(/\s+/g, ' ').trim();
+}
+/**
+ * Validate a single URL using built-in URL constructor
+ * @param url The URL string to validate
+ * @returns Result containing validation success or error
+ */
+function validateUrl(url) {
+    try {
+        const urlObj = new URL(url);
+        // Only allow HTTP and HTTPS protocols
+        if (!['http:', 'https:'].includes(urlObj.protocol)) {
+            return (0, result_1.Err)(new errors_1.InvalidUrlError(`Invalid protocol: ${urlObj.protocol}`, 'Only HTTP and HTTPS URLs are supported', url));
+        }
+        // Basic hostname validation
+        if (!urlObj.hostname || urlObj.hostname.length === 0) {
+            return (0, result_1.Err)(new errors_1.InvalidUrlError('Invalid hostname in URL', 'URL must have a valid hostname', url));
+        }
+        return (0, result_1.Ok)(url);
+    }
+    catch (error) {
+        return (0, result_1.Err)(new errors_1.InvalidUrlError(`Malformed URL: ${url}`, 'Please check the URL format and try again', url));
+    }
+}
+/**
+ * Extract and validate URLs from prompt with detailed error reporting
+ * @param prompt The text to extract URLs from
+ * @returns Result containing valid URLs or validation error
+ */
+function extractValidUrls(prompt) {
+    const extractedUrls = extractUrls(prompt);
+    const validUrls = [];
+    const errors = [];
+    for (const url of extractedUrls) {
+        const validation = validateUrl(url);
+        if (validation.success) {
+            validUrls.push(validation.data);
+        }
+        else {
+            errors.push(validation.error);
+        }
+    }
+    // If there are validation errors and no valid URLs, return first error
+    if (errors.length > 0 && validUrls.length === 0) {
+        const firstError = errors[0];
+        if (firstError) {
+            return (0, result_1.Err)(firstError);
+        }
+    }
+    return (0, result_1.Ok)(validUrls);
+}
+/**
+ * Get URL statistics for analysis
+ * @param prompt The text to analyze
+ * @returns Statistics about URLs in the prompt
+ */
+function getUrlStats(prompt) {
+    const urls = extractUrls(prompt);
+    const httpUrls = urls.filter((url) => url.startsWith('http:')).length;
+    const httpsUrls = urls.filter((url) => url.startsWith('https:')).length;
+    const domains = urls
+        .map((url) => {
+        try {
+            return new URL(url).hostname;
+        }
+        catch {
+            return null;
+        }
+    })
+        .filter((domain) => domain !== null);
+    const uniqueDomains = [...new Set(domains)];
+    return {
+        totalFound: urls.length,
+        validUrls: domains.length,
+        httpUrls,
+        httpsUrls,
+        uniqueDomains,
+    };
+}
+/**
+ * URL extractor utilities - backward compatibility object
+ */
+exports.URLExtractor = {
+    extractUrls,
+    hasUrls,
+    removeUrls,
+    validateUrl,
+    extractValidUrls,
+    getUrlStats,
+};
+//# sourceMappingURL=urlExtractor.js.map

package/dist/business/urlExtractor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+export { createMCPServer, MCPServerImpl } from './server/mcpServer';
+export type { GenerateImageParams, MCPServerConfig } from './types/mcp';
+export type { GeneratedImageResult } from './api/geminiClient';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA+CA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACnE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPServerImpl = exports.createMCPServer = void 0;
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+/**
+ * MCP Image Generator entry point
+ * MCP server startup process
+ */
+const mcpServer_1 = require("./server/mcpServer");
+const logger_1 = require("./utils/logger");
+const logger = new logger_1.Logger();
+/**
+ * Application startup
+ */
+async function main() {
+    try {
+        logger.info('mcp-startup', 'Starting MCP Image Generator initialization', {
+            nodeVersion: process.version,
+            platform: process.platform,
+            env: process.env['NODE_ENV'] || 'development',
+        });
+        const mcpServerImpl = new mcpServer_1.MCPServerImpl();
+        const server = mcpServerImpl.initialize();
+        const transport = new stdio_js_1.StdioServerTransport();
+        await server.connect(transport);
+        logger.info('mcp-startup', 'Image Generator MCP Server started successfully');
+    }
+    catch (error) {
+        logger.error('mcp-startup', 'Failed to start MCP server', error, {
+            errorType: error?.constructor?.name,
+            stack: error?.stack,
+        });
+        process.exit(1);
+    }
+}
+// Run main function
+main().catch((error) => {
+    logger.error('mcp-startup', 'Fatal error during startup', error);
+    process.exit(1);
+});
+var mcpServer_2 = require("./server/mcpServer");
+Object.defineProperty(exports, "createMCPServer", { enumerable: true, get: function () { return mcpServer_2.createMCPServer; } });
+Object.defineProperty(exports, "MCPServerImpl", { enumerable: true, get: function () { return mcpServer_2.MCPServerImpl; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAEA,wEAAgF;AAChF;;;GAGG;AACH,kDAAkD;AAClD,2CAAuC;AAEvC,MAAM,MAAM,GAAG,IAAI,eAAM,EAAE,CAAA;AAE3B;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,6CAA6C,EAAE;YACxE,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,aAAa;SAC9C,CAAC,CAAA;QAEF,MAAM,aAAa,GAAG,IAAI,yBAAa,EAAE,CAAA;QAEzC,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,CAAA;QAEzC,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAA;QAE5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAE/B,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,iDAAiD,CAAC,CAAA;IAC/E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,4BAA4B,EAAE,KAAc,EAAE;YACxE,SAAS,EAAG,KAAe,EAAE,WAAW,EAAE,IAAI;YAC9C,KAAK,EAAG,KAAe,EAAE,KAAK;SAC/B,CAAC,CAAA;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED,oBAAoB;AACpB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,4BAA4B,EAAE,KAAc,CAAC,CAAA;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA;AAEF,gDAAmE;AAA1D,4GAAA,eAAe,OAAA;AAAE,0GAAA,aAAa,OAAA"}

package/dist/server/concurrencyManager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Concurrency Manager - Controls concurrent request execution
+ * Implements singleton pattern with queue management
+ */
+/**
+ * Concurrency manager for limiting concurrent requests
+ */
+export declare class ConcurrencyManager {
+    private static instance;
+    private activeRequests;
+    private readonly maxConcurrent;
+    private requestQueue;
+    private readonly queueTimeout;
+    /**
+     * Get singleton instance of ConcurrencyManager
+     * @returns ConcurrencyManager instance
+     */
+    static getInstance(): ConcurrencyManager;
+    /**
+     * Acquire a concurrency lock
+     * @returns Promise that resolves when lock is acquired
+     */
+    acquireLock(): Promise<void>;
+    /**
+     * Release a concurrency lock
+     */
+    releaseLock(): void;
+    /**
+     * Process the next request in the queue
+     */
+    private processNextRequest;
+    /**
+     * Clean up expired requests from the queue
+     */
+    private cleanupExpiredRequests;
+    /**
+     * Check if concurrency limit is reached
+     * @returns True if at limit
+     */
+    isAtLimit(): boolean;
+    /**
+     * Get current queue length
+     * @returns Number of queued requests
+     */
+    getQueueLength(): number;
+    /**
+     * Get current active request count
+     * @returns Number of active requests
+     */
+    getActiveRequestCount(): number;
+    /**
+     * Reset the concurrency manager (for testing purposes)
+     */
+    reset(): void;
+}
+//# sourceMappingURL=concurrencyManager.d.ts.map

package/dist/server/concurrencyManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrencyManager.d.ts","sourceRoot":"","sources":["../../src/server/concurrencyManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAC3C,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAI;IAClC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IAErC;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAOxC;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAuClC;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoB9B;;;OAGG;IACH,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACH,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/server/concurrencyManager.js

@@ -0,0 +1,133 @@
+/**
+ * Concurrency Manager - Controls concurrent request execution
+ * Implements singleton pattern with queue management
+ */
+/**
+ * Concurrency manager for limiting concurrent requests
+ */
+export class ConcurrencyManager {
+    constructor() {
+        this.activeRequests = 0;
+        this.maxConcurrent = 1;
+        this.requestQueue = [];
+        this.queueTimeout = 30000; // 30 seconds
+    }
+    /**
+     * Get singleton instance of ConcurrencyManager
+     * @returns ConcurrencyManager instance
+     */
+    static getInstance() {
+        if (!ConcurrencyManager.instance) {
+            ConcurrencyManager.instance = new ConcurrencyManager();
+        }
+        return ConcurrencyManager.instance;
+    }
+    /**
+     * Acquire a concurrency lock
+     * @returns Promise that resolves when lock is acquired
+     */
+    async acquireLock() {
+        if (this.activeRequests < this.maxConcurrent) {
+            this.activeRequests++;
+            return Promise.resolve();
+        }
+        return new Promise((resolve, reject) => {
+            const request = {
+                resolve,
+                reject,
+                timestamp: Date.now(),
+            };
+            this.requestQueue.push(request);
+            // Set timeout for this request
+            const timeoutId = setTimeout(() => {
+                const index = this.requestQueue.findIndex((req) => req === request);
+                if (index >= 0) {
+                    this.requestQueue.splice(index, 1);
+                    reject(new Error('Concurrency limit timeout'));
+                }
+            }, this.queueTimeout);
+            // Clear timeout when request resolves
+            const originalResolve = request.resolve;
+            request.resolve = () => {
+                clearTimeout(timeoutId);
+                originalResolve(undefined);
+            };
+            const originalReject = request.reject;
+            request.reject = (error) => {
+                clearTimeout(timeoutId);
+                originalReject(error);
+            };
+        });
+    }
+    /**
+     * Release a concurrency lock
+     */
+    releaseLock() {
+        this.activeRequests = Math.max(0, this.activeRequests - 1);
+        // Process next request in queue
+        this.processNextRequest();
+    }
+    /**
+     * Process the next request in the queue
+     */
+    processNextRequest() {
+        // Clean up expired requests first
+        this.cleanupExpiredRequests();
+        if (this.requestQueue.length > 0 && this.activeRequests < this.maxConcurrent) {
+            const next = this.requestQueue.shift();
+            if (next) {
+                this.activeRequests++;
+                next.resolve(undefined);
+            }
+        }
+    }
+    /**
+     * Clean up expired requests from the queue
+     */
+    cleanupExpiredRequests() {
+        const now = Date.now();
+        const initialLength = this.requestQueue.length;
+        this.requestQueue = this.requestQueue.filter((request) => {
+            const isExpired = now - request.timestamp > this.queueTimeout;
+            if (isExpired) {
+                request.reject(new Error('Request expired in queue'));
+                return false;
+            }
+            return true;
+        });
+        // Log cleanup if any requests were removed
+        const removedCount = initialLength - this.requestQueue.length;
+        if (removedCount > 0) {
+            console.warn(`[ConcurrencyManager] Cleaned up ${removedCount} expired requests from queue`);
+        }
+    }
+    /**
+     * Check if concurrency limit is reached
+     * @returns True if at limit
+     */
+    isAtLimit() {
+        return this.activeRequests >= this.maxConcurrent;
+    }
+    /**
+     * Get current queue length
+     * @returns Number of queued requests
+     */
+    getQueueLength() {
+        return this.requestQueue.length;
+    }
+    /**
+     * Get current active request count
+     * @returns Number of active requests
+     */
+    getActiveRequestCount() {
+        return this.activeRequests;
+    }
+    /**
+     * Reset the concurrency manager (for testing purposes)
+     */
+    reset() {
+        this.activeRequests = 0;
+        this.requestQueue = [];
+    }
+}
+//# sourceMappingURL=concurrencyManager.js.map