@mcp-consultant-tools/powerplatform-customization 2.0.0

package/build/utils/rate-limiter.js

@@ -0,0 +1,241 @@
+/**
+ * Rate Limiter Module
+ *
+ * Implements rate limiting with exponential backoff for PowerPlatform API calls.
+ * Prevents API throttling errors (429) and manages concurrent request limits.
+ */
+/**
+ * Rate Limiter Class
+ */
+export class RateLimiter {
+    options;
+    requestTimestamps = [];
+    activeRequests = 0;
+    queue = [];
+    processing = false;
+    constructor(options = {}) {
+        this.options = {
+            maxRequestsPerMinute: options.maxRequestsPerMinute || 60,
+            maxConcurrentRequests: options.maxConcurrentRequests || 10,
+            retryAttempts: options.retryAttempts || 3,
+            initialBackoffMs: options.initialBackoffMs || 1000,
+            maxBackoffMs: options.maxBackoffMs || 60000,
+            backoffMultiplier: options.backoffMultiplier || 2
+        };
+    }
+    /**
+     * Execute a function with rate limiting
+     */
+    async execute(fn) {
+        return new Promise((resolve, reject) => {
+            this.queue.push({
+                fn,
+                resolve,
+                reject,
+                retryCount: 0
+            });
+            this.processQueue();
+        });
+    }
+    /**
+     * Process the request queue
+     */
+    async processQueue() {
+        if (this.processing) {
+            return;
+        }
+        this.processing = true;
+        while (this.queue.length > 0) {
+            // Wait if we've hit the concurrent request limit
+            while (this.activeRequests >= this.options.maxConcurrentRequests) {
+                await this.sleep(100);
+            }
+            // Wait if we've hit the rate limit
+            while (!this.canMakeRequest()) {
+                await this.sleep(1000);
+            }
+            const item = this.queue.shift();
+            if (!item)
+                break;
+            // Execute the request
+            this.executeRequest(item);
+        }
+        this.processing = false;
+    }
+    /**
+     * Execute a single request with retry logic
+     */
+    async executeRequest(item) {
+        this.activeRequests++;
+        this.recordRequest();
+        try {
+            const result = await item.fn();
+            item.resolve(result);
+        }
+        catch (error) {
+            // Check if it's a rate limit error (429)
+            const isRateLimitError = this.isRateLimitError(error);
+            if (isRateLimitError && item.retryCount < this.options.retryAttempts) {
+                // Retry with exponential backoff
+                const backoffMs = this.calculateBackoff(item.retryCount);
+                console.error(`[RATE-LIMITER] Rate limit hit, retrying in ${backoffMs}ms (attempt ${item.retryCount + 1}/${this.options.retryAttempts})`);
+                await this.sleep(backoffMs);
+                // Re-queue the request
+                item.retryCount++;
+                this.queue.unshift(item);
+            }
+            else {
+                // Max retries exceeded or non-retriable error
+                item.reject(error);
+            }
+        }
+        finally {
+            this.activeRequests--;
+            // Continue processing queue
+            if (this.queue.length > 0) {
+                this.processQueue();
+            }
+        }
+    }
+    /**
+     * Check if we can make a request without exceeding rate limits
+     */
+    canMakeRequest() {
+        this.cleanupOldTimestamps();
+        return this.requestTimestamps.length < this.options.maxRequestsPerMinute;
+    }
+    /**
+     * Record a request timestamp
+     */
+    recordRequest() {
+        this.requestTimestamps.push(Date.now());
+    }
+    /**
+     * Remove timestamps older than 1 minute
+     */
+    cleanupOldTimestamps() {
+        const oneMinuteAgo = Date.now() - 60000;
+        this.requestTimestamps = this.requestTimestamps.filter(ts => ts > oneMinuteAgo);
+    }
+    /**
+     * Calculate backoff time for retry
+     */
+    calculateBackoff(retryCount) {
+        const backoff = this.options.initialBackoffMs * Math.pow(this.options.backoffMultiplier, retryCount);
+        return Math.min(backoff, this.options.maxBackoffMs);
+    }
+    /**
+     * Check if error is a rate limit error
+     */
+    isRateLimitError(error) {
+        // Check for 429 status code
+        if (error.status === 429 || error.statusCode === 429) {
+            return true;
+        }
+        // Check for rate limit in error message
+        const errorMessage = error.message?.toLowerCase() || '';
+        return (errorMessage.includes('rate limit') ||
+            errorMessage.includes('throttl') ||
+            errorMessage.includes('too many requests'));
+    }
+    /**
+     * Sleep helper
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Get current rate limiter stats
+     */
+    getStats() {
+        this.cleanupOldTimestamps();
+        return {
+            activeRequests: this.activeRequests,
+            queuedRequests: this.queue.length,
+            requestsLastMinute: this.requestTimestamps.length,
+            maxRequestsPerMinute: this.options.maxRequestsPerMinute,
+            maxConcurrentRequests: this.options.maxConcurrentRequests,
+            utilizationPercentage: (this.requestTimestamps.length / this.options.maxRequestsPerMinute) * 100
+        };
+    }
+    /**
+     * Wait until rate limiter has capacity
+     */
+    async waitForCapacity() {
+        while (!this.canMakeRequest() || this.activeRequests >= this.options.maxConcurrentRequests) {
+            await this.sleep(100);
+        }
+    }
+    /**
+     * Clear the queue
+     */
+    clearQueue() {
+        // Reject all queued requests
+        for (const item of this.queue) {
+            item.reject(new Error('Queue cleared'));
+        }
+        this.queue = [];
+    }
+    /**
+     * Reset rate limiter
+     */
+    reset() {
+        this.clearQueue();
+        this.requestTimestamps = [];
+        this.activeRequests = 0;
+        this.processing = false;
+    }
+    /**
+     * Update rate limiter options
+     */
+    updateOptions(options) {
+        this.options = {
+            ...this.options,
+            ...options
+        };
+    }
+}
+// Export singleton instance with default settings
+export const rateLimiter = new RateLimiter({
+    maxRequestsPerMinute: 60,
+    maxConcurrentRequests: 10,
+    retryAttempts: 3,
+    initialBackoffMs: 1000,
+    maxBackoffMs: 60000,
+    backoffMultiplier: 2
+});
+/**
+ * Helper function to wrap API calls with rate limiting
+ */
+export async function withRateLimit(fn) {
+    return rateLimiter.execute(fn);
+}
+/**
+ * Batch execution with rate limiting
+ * Processes an array of functions with rate limiting
+ */
+export async function batchExecute(fns, options) {
+    const results = [];
+    const errors = [];
+    for (let i = 0; i < fns.length; i++) {
+        try {
+            const result = await rateLimiter.execute(fns[i]);
+            results.push(result);
+            if (options?.onProgress) {
+                options.onProgress(i + 1, fns.length);
+            }
+        }
+        catch (error) {
+            errors.push({ index: i, error });
+            if (options?.onError) {
+                options.onError(error, i);
+            }
+            // Re-throw if all requests have failed
+            if (errors.length === fns.length) {
+                throw new Error(`All batch requests failed: ${errors.length} errors`);
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=rate-limiter.js.map

package/build/utils/rate-limiter.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@mcp-consultant-tools/powerplatform-customization",
+  "version": "2.0.0",
+  "description": "MCP server for PowerPlatform schema/metadata customizations (dev/config environments)",
+  "type": "module",
+  "main": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "bin": {
+    "mcp-powerplatform-customization": "./build/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "files": [
+    "build",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf build *.tsbuildinfo",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "powerplatform",
+    "dynamics",
+    "dataverse",
+    "customization"
+  ],
+  "author": "Michal Sobieraj",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/klemensms/mcp-consultant-tools.git",
+    "directory": "packages/powerplatform-customization"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "@azure/msal-node": "^3.3.0",
+    "@mcp-consultant-tools/core": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "axios": "^1.8.3",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "typescript": "^5.8.2"
+  }
+}