@miller-tech/uap 1.0.0

package/dist/utils/config-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.js","sourceRoot":"","sources":["../../src/utils/config-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,QAAQ,CAAgB;IAC/B,MAAM,CAAmB;IAEjC;;OAEG;IACH;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAe,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC5B,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,GAAW,EAAE,KAAU;QAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/utils/fetch-with-retry.d.ts

@@ -0,0 +1,5 @@
+export declare function fetchWithRetry(url: string, retryConfig?: {
+    maxRetries: number;
+    backoffMs: number;
+}): Promise<Response>;
+//# sourceMappingURL=fetch-with-retry.d.ts.map

package/dist/utils/fetch-with-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-retry.d.ts","sourceRoot":"","sources":["../../src/utils/fetch-with-retry.ts"],"names":[],"mappings":"AAAA,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtD,OAAO,CAAC,QAAQ,CAAC,CA0FnB"}

package/dist/utils/fetch-with-retry.js

@@ -0,0 +1,61 @@
+export async function fetchWithRetry(url, retryConfig) {
+    const config = {
+        maxRetries: retryConfig?.maxRetries ?? 3,
+        backoffMs: retryConfig?.backoffMs ?? 1000,
+    };
+    let lastError = null;
+    let lastStatusCode;
+    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+        try {
+            if (attempt > 0) {
+                const delay = config.backoffMs * Math.pow(2, attempt - 1);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+            const response = await fetch(url);
+            if (!response.ok) {
+                lastStatusCode = response.status;
+                const isRetryable = response.status >= 500 ||
+                    response.status === 408 ||
+                    response.status === 429;
+                if (isRetryable && attempt < config.maxRetries) {
+                    lastError = new Error(`HTTP ${response.status}: ${response.statusText}`);
+                    continue;
+                }
+                const httpError = new Error(`HTTP error ${response.status}: ${response.statusText}`);
+                httpError.name = 'FetchRetryError';
+                httpError.url = url;
+                httpError.attempts = attempt + 1;
+                httpError.statusCode = response.status;
+                httpError.lastError = null;
+                throw httpError;
+            }
+            return response;
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'FetchRetryError') {
+                throw error;
+            }
+            if (error instanceof Error) {
+                lastError = error;
+                if (attempt < config.maxRetries) {
+                    continue;
+                }
+            }
+            const finalError = new Error(`Fetch failed after ${attempt + 1} attempts: ${error instanceof Error ? error.message : String(error)}`);
+            finalError.name = 'FetchRetryError';
+            finalError.url = url;
+            finalError.attempts = attempt + 1;
+            finalError.statusCode = lastStatusCode;
+            finalError.lastError = lastError;
+            throw finalError;
+        }
+    }
+    const exhaustedError = new Error(`All ${config.maxRetries + 1} attempts failed for ${url}`);
+    exhaustedError.name = 'FetchRetryError';
+    exhaustedError.url = url;
+    exhaustedError.attempts = config.maxRetries + 1;
+    exhaustedError.statusCode = lastStatusCode;
+    exhaustedError.lastError = lastError;
+    throw exhaustedError;
+}
+//# sourceMappingURL=fetch-with-retry.js.map

package/dist/utils/fetch-with-retry.js.map

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

package/dist/utils/merge-claude-md.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Intelligent merge of existing CLAUDE.md with newly generated content
+ *
+ * Strategy:
+ * - Preserves user customizations in standard sections
+ * - Extracts valuable content from existing file
+ * - Places extracted content in appropriate new sections
+ * - Never loses information
+ */
+/**
+ * Merge existing CLAUDE.md content with newly generated content
+ *
+ * Intelligent merge strategy:
+ * 1. Use new template structure and preamble
+ * 2. Replace standard sections with new versions
+ * 3. Extract valuable content from existing file
+ * 4. Inject extracted content into appropriate new sections
+ * 5. Append completely custom sections at the end
+ */
+export declare function mergeClaudeMd(existingContent: string, newContent: string): string;
+/**
+ * Validate merge result - ensure no significant content was lost
+ */
+export declare function validateMerge(original: string, merged: string): {
+    valid: boolean;
+    warnings: string[];
+};
+//# sourceMappingURL=merge-claude-md.d.ts.map

package/dist/utils/merge-claude-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-claude-md.d.ts","sourceRoot":"","sources":["../../src/utils/merge-claude-md.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkTH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAkDjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAoCtG"}

package/dist/utils/merge-claude-md.js

@@ -0,0 +1,342 @@
+/**
+ * Intelligent merge of existing CLAUDE.md with newly generated content
+ *
+ * Strategy:
+ * - Preserves user customizations in standard sections
+ * - Extracts valuable content from existing file
+ * - Places extracted content in appropriate new sections
+ * - Never loses information
+ */
+/**
+ * Parse markdown content into sections
+ */
+function parseSections(content) {
+    const lines = content.split('\n');
+    const sections = [];
+    let currentSection = null;
+    let currentContent = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Match ## headings, capturing optional emoji
+        const heading = line.match(/^##\s+([🔴⚡🤖📋🧠🌳🚀📁🏗️🔧🗄️🔐✅🔄📊⚙️🧪🏭⛔]\s*)?(.+)$/);
+        if (heading) {
+            if (currentSection) {
+                currentSection.content = currentContent.join('\n').trim();
+                currentSection.endLine = i - 1;
+                sections.push(currentSection);
+            }
+            currentSection = {
+                title: heading[2].trim(),
+                emoji: heading[1]?.trim(),
+                content: '',
+                startLine: i,
+                endLine: i,
+            };
+            currentContent = [];
+        }
+        else if (currentSection) {
+            currentContent.push(line);
+        }
+    }
+    if (currentSection) {
+        currentSection.content = currentContent.join('\n').trim();
+        currentSection.endLine = lines.length - 1;
+        sections.push(currentSection);
+    }
+    return sections;
+}
+/**
+ * Extract preamble (content before first ## heading)
+ */
+function extractPreamble(content) {
+    const lines = content.split('\n');
+    const preamble = [];
+    for (const line of lines) {
+        if (line.match(/^##\s+/)) {
+            break;
+        }
+        preamble.push(line);
+    }
+    return preamble.join('\n').trim();
+}
+/**
+ * Standard sections managed by the template (will be replaced)
+ */
+const STANDARD_SECTIONS = new Set([
+    'DIRECTIVE HIERARCHY',
+    'SESSION START PROTOCOL',
+    'MULTI-AGENT COORDINATION PROTOCOL',
+    'MANDATORY DECISION LOOP',
+    'MEMORY SYSTEM',
+    'FOUR-LAYER MEMORY SYSTEM',
+    'WORKTREE WORKFLOW',
+    'PARALLEL REVIEW PROTOCOL',
+    'AUTOMATIC TRIGGERS',
+    'REPOSITORY STRUCTURE',
+    'COMPLETION PROTOCOL',
+    'COMPLETION CHECKLIST',
+]);
+/**
+ * Sections that contain extractable content (we'll merge content intelligently)
+ */
+const EXTRACTABLE_SECTIONS = new Set([
+    'TROUBLESHOOTING',
+    'QUICK REFERENCE',
+    'CONFIG FILES',
+    'ARCHITECTURE',
+    'COMPONENTS',
+    'DATABASE',
+    'AUTHENTICATION',
+    'PROJECT KNOWLEDGE',
+    'INFRASTRUCTURE',
+]);
+function normalizeTitle(title) {
+    return title.toUpperCase()
+        .replace(/[🔴⚡🤖📋🧠🌳🚀📁🏗️🔧🗄️🔐✅🔄📊⚙️🧪🏭⛔]/g, '')
+        .trim();
+}
+function isStandardSection(title) {
+    const normalized = normalizeTitle(title);
+    for (const std of STANDARD_SECTIONS) {
+        if (normalized.includes(std) || std.includes(normalized)) {
+            return true;
+        }
+    }
+    return false;
+}
+function isExtractableSection(title) {
+    const normalized = normalizeTitle(title);
+    for (const ext of EXTRACTABLE_SECTIONS) {
+        if (normalized.includes(ext) || ext.includes(normalized)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Extract valuable content from existing sections
+ */
+function extractContent(sections) {
+    const result = {
+        customSections: [],
+        troubleshooting: [],
+        urls: [],
+        commands: [],
+        configFiles: [],
+        workflows: [],
+        clusters: [],
+        gotchas: [],
+        lessons: [],
+    };
+    for (const section of sections) {
+        const normalized = normalizeTitle(section.title);
+        const content = section.content;
+        // Completely custom sections - preserve entirely
+        if (!isStandardSection(section.title) && !isExtractableSection(section.title)) {
+            result.customSections.push(section);
+            continue;
+        }
+        // Extract troubleshooting entries (table rows)
+        if (normalized.includes('TROUBLESHOOTING')) {
+            const tableRows = content.match(/^\|[^|]+\|[^|]+\|$/gm) || [];
+            for (const row of tableRows) {
+                if (!row.includes('---') && !row.toLowerCase().includes('symptom') && !row.toLowerCase().includes('solution')) {
+                    result.troubleshooting.push(row);
+                }
+            }
+        }
+        // Extract URLs
+        if (normalized.includes('QUICK REFERENCE') || normalized.includes('URL')) {
+            const urls = content.match(/https?:\/\/[^\s)>]+/g) || [];
+            result.urls.push(...urls.filter(u => !u.includes('img.shields.io')));
+        }
+        // Extract kubectl contexts/clusters
+        if (content.includes('kubectl config use-context')) {
+            const contexts = content.match(/kubectl config use-context\s+\S+.*$/gm) || [];
+            result.clusters.push(...contexts);
+        }
+        // Extract workflow files
+        if (content.includes('.yml') || content.includes('.yaml')) {
+            const workflows = content.match(/├──\s+[\w-]+\.ya?ml.*$/gm) || [];
+            result.workflows.push(...workflows);
+        }
+        // Extract config file entries
+        if (normalized.includes('CONFIG')) {
+            const configRows = content.match(/^\|\s*`[^`]+`\s*\|[^|]+\|$/gm) || [];
+            result.configFiles.push(...configRows);
+        }
+        // Extract gotchas
+        if (normalized.includes('GOTCHA') || content.includes('⚠️')) {
+            const gotchas = content.match(/^-?\s*⚠️.*$/gm) || [];
+            result.gotchas.push(...gotchas);
+        }
+        // Extract lessons
+        if (normalized.includes('LESSON') || normalized.includes('KNOWLEDGE')) {
+            const lessons = content.match(/^-\s+\*\*[^*]+\*\*:.*$/gm) || [];
+            result.lessons.push(...lessons);
+        }
+    }
+    return result;
+}
+/**
+ * Inject extracted content into appropriate sections of new content
+ */
+function injectExtractedContent(newSections, extracted) {
+    const result = [...newSections];
+    for (const section of result) {
+        const normalized = normalizeTitle(section.title);
+        // Inject troubleshooting entries
+        if (normalized.includes('TROUBLESHOOTING') && extracted.troubleshooting.length > 0) {
+            const existingRows = section.content.match(/^\|[^|]+\|[^|]+\|$/gm) || [];
+            const existingSet = new Set(existingRows.map(r => r.toLowerCase()));
+            const newRows = extracted.troubleshooting.filter(r => !existingSet.has(r.toLowerCase()));
+            if (newRows.length > 0) {
+                // Find table end and append
+                const tableMatch = section.content.match(/(^\|.*\|$\n?)+/m);
+                if (tableMatch) {
+                    const tableEnd = tableMatch.index + tableMatch[0].length;
+                    section.content =
+                        section.content.slice(0, tableEnd) +
+                            newRows.join('\n') + '\n' +
+                            section.content.slice(tableEnd);
+                }
+            }
+        }
+        // Inject URLs
+        if (normalized.includes('QUICK REFERENCE') && extracted.urls.length > 0) {
+            const existingUrls = new Set((section.content.match(/https?:\/\/[^\s)>]+/g) || []).map(u => u.toLowerCase()));
+            const newUrls = extracted.urls.filter(u => !existingUrls.has(u.toLowerCase()));
+            if (newUrls.length > 0 && !section.content.includes('### URLs')) {
+                section.content += '\n\n### URLs\n' + newUrls.map(u => `- ${u}`).join('\n');
+            }
+        }
+        // Inject clusters
+        if (normalized.includes('QUICK REFERENCE') && extracted.clusters.length > 0) {
+            if (!section.content.includes('kubectl config use-context')) {
+                section.content += '\n\n### Clusters\n```bash\n' + extracted.clusters.join('\n') + '\n```';
+            }
+        }
+        // Inject workflows  
+        if (normalized.includes('QUICK REFERENCE') && extracted.workflows.length > 0) {
+            const existingWorkflows = new Set((section.content.match(/[\w-]+\.ya?ml/g) || []).map(w => w.toLowerCase()));
+            const newWorkflows = extracted.workflows.filter(w => {
+                const match = w.match(/[\w-]+\.ya?ml/);
+                return match && !existingWorkflows.has(match[0].toLowerCase());
+            });
+            if (newWorkflows.length > 0 && !section.content.includes('### Workflows')) {
+                section.content += '\n\n### Workflows\n```\n' + newWorkflows.join('\n') + '\n```';
+            }
+        }
+        // Inject config files
+        if (normalized.includes('CONFIG') && extracted.configFiles.length > 0) {
+            const existingFiles = new Set((section.content.match(/`[^`]+`/g) || []).map(f => f.toLowerCase()));
+            const newFiles = extracted.configFiles.filter(f => {
+                const match = f.match(/`([^`]+)`/);
+                return match && !existingFiles.has(match[0].toLowerCase());
+            });
+            if (newFiles.length > 0) {
+                section.content += '\n' + newFiles.join('\n');
+            }
+        }
+        // Inject gotchas into Project Knowledge
+        if (normalized.includes('PROJECT KNOWLEDGE') || normalized.includes('GOTCHA')) {
+            if (extracted.gotchas.length > 0 && !section.content.includes('### Gotchas')) {
+                section.content += '\n\n### Gotchas\n' + extracted.gotchas.join('\n');
+            }
+        }
+        // Inject lessons into Project Knowledge
+        if (normalized.includes('PROJECT KNOWLEDGE') || normalized.includes('LESSON')) {
+            if (extracted.lessons.length > 0 && !section.content.includes('### Lessons')) {
+                section.content += '\n\n### Lessons\n' + extracted.lessons.join('\n');
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Merge existing CLAUDE.md content with newly generated content
+ *
+ * Intelligent merge strategy:
+ * 1. Use new template structure and preamble
+ * 2. Replace standard sections with new versions
+ * 3. Extract valuable content from existing file
+ * 4. Inject extracted content into appropriate new sections
+ * 5. Append completely custom sections at the end
+ */
+export function mergeClaudeMd(existingContent, newContent) {
+    const existingSections = parseSections(existingContent);
+    const newSections = parseSections(newContent);
+    const newPreamble = extractPreamble(newContent);
+    // Extract valuable content from existing file
+    const extracted = extractContent(existingSections);
+    // Inject extracted content into new sections
+    const mergedSections = injectExtractedContent(newSections, extracted);
+    // Build final content
+    const merged = [];
+    merged.push(newPreamble);
+    merged.push('');
+    // Add all sections from new content (with injected data)
+    for (const section of mergedSections) {
+        const emoji = section.emoji ? `${section.emoji} ` : '';
+        merged.push(`## ${emoji}${section.title}`);
+        merged.push('');
+        merged.push(section.content);
+        merged.push('');
+        merged.push('---');
+        merged.push('');
+    }
+    // Append custom sections that weren't in the template
+    if (extracted.customSections.length > 0) {
+        merged.push('<!-- Custom Sections (preserved from existing file) -->');
+        merged.push('');
+        for (const section of extracted.customSections) {
+            const emoji = section.emoji ? `${section.emoji} ` : '';
+            merged.push(`## ${emoji}${section.title}`);
+            merged.push('');
+            merged.push(section.content);
+            merged.push('');
+            merged.push('---');
+            merged.push('');
+        }
+    }
+    // Clean up
+    let result = merged.join('\n');
+    result = result.replace(/\n{3,}/g, '\n\n');
+    result = result.replace(/---\n*$/, '');
+    result = result.trim();
+    return result;
+}
+/**
+ * Validate merge result - ensure no significant content was lost
+ */
+export function validateMerge(original, merged) {
+    const warnings = [];
+    // Check for URLs that might have been lost
+    const originalUrls = new Set((original.match(/https?:\/\/[^\s)>]+/g) || []).filter(u => !u.includes('img.shields.io')));
+    const mergedUrls = new Set((merged.match(/https?:\/\/[^\s)>]+/g) || []));
+    for (const url of originalUrls) {
+        if (!mergedUrls.has(url)) {
+            warnings.push(`URL may be missing: ${url.slice(0, 50)}...`);
+        }
+    }
+    // Check for kubectl contexts that might have been lost
+    const originalContexts = original.match(/kubectl config use-context\s+\S+/g) || [];
+    const mergedContexts = merged.match(/kubectl config use-context\s+\S+/g) || [];
+    if (originalContexts.length > mergedContexts.length) {
+        warnings.push(`Some kubectl contexts may be missing (had ${originalContexts.length}, now ${mergedContexts.length})`);
+    }
+    // Check for custom section headers
+    const originalSections = parseSections(original);
+    const mergedSections = parseSections(merged);
+    const mergedTitles = new Set(mergedSections.map(s => normalizeTitle(s.title)));
+    for (const section of originalSections) {
+        if (!isStandardSection(section.title) && !mergedTitles.has(normalizeTitle(section.title))) {
+            warnings.push(`Custom section may be missing: ${section.title}`);
+        }
+    }
+    return {
+        valid: warnings.length === 0,
+        warnings,
+    };
+}
+//# sourceMappingURL=merge-claude-md.js.map

package/dist/utils/merge-claude-md.js.map

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

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Configuration options for the RateLimiter.
+ */
+export interface RateLimiterConfig {
+    /** Maximum number of requests allowed within the time window */
+    maxRequests: number;
+    /** Time window in milliseconds */
+    windowMs: number;
+}
+/**
+ * A sliding-window rate limiter that tracks requests per client.
+ * Uses a Map to store request timestamps for each client and
+ * automatically cleans up expired entries.
+ */
+export declare class RateLimiter {
+    private readonly maxRequests;
+    private readonly windowMs;
+    private readonly clients;
+    /**
+     * Creates a new RateLimiter instance.
+     *
+     * @param config - Configuration for request limits and time window
+     * @throws Error if maxRequests or windowMs are not positive numbers
+     */
+    constructor(config: RateLimiterConfig);
+    /**
+     * Checks if a request from the given client is allowed.
+     * If allowed, records the request timestamp.
+     *
+     * @param clientId - Unique identifier for the client
+     * @returns True if the request is allowed, false if rate limited
+     */
+    isAllowed(clientId: string): boolean;
+    /**
+     * Returns the number of remaining requests for a client within the current window.
+     *
+     * @param clientId - Unique identifier for the client
+     * @returns Number of remaining allowed requests
+     */
+    getRemainingRequests(clientId: string): number;
+    /**
+     * Resets rate limiting state.
+     * If clientId is provided, resets only that client.
+     * Otherwise, resets all clients.
+     *
+     * @param clientId - Optional client identifier to reset
+     */
+    reset(clientId?: string): void;
+    /**
+     * Removes expired timestamps from a client's entry.
+     * Deletes the entry entirely if no valid timestamps remain.
+     *
+     * @param clientId - Client identifier to clean up
+     * @param now - Current timestamp for expiration calculation
+     */
+    private cleanupExpiredEntries;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D;;;;;OAKG;gBACS,MAAM,EAAE,iBAAiB;IAqBrC;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAmBpC;;;;;OAKG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAa9C;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ9B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CAgB9B"}

package/dist/utils/rate-limiter.js

@@ -0,0 +1,100 @@
+/**
+ * A sliding-window rate limiter that tracks requests per client.
+ * Uses a Map to store request timestamps for each client and
+ * automatically cleans up expired entries.
+ */
+export class RateLimiter {
+    maxRequests;
+    windowMs;
+    clients = new Map();
+    /**
+     * Creates a new RateLimiter instance.
+     *
+     * @param config - Configuration for request limits and time window
+     * @throws Error if maxRequests or windowMs are not positive numbers
+     */
+    constructor(config) {
+        if (typeof config.maxRequests !== 'number' ||
+            config.maxRequests <= 0 ||
+            !Number.isInteger(config.maxRequests)) {
+            throw new Error('maxRequests must be a positive integer');
+        }
+        if (typeof config.windowMs !== 'number' ||
+            config.windowMs <= 0 ||
+            !Number.isInteger(config.windowMs)) {
+            throw new Error('windowMs must be a positive integer');
+        }
+        this.maxRequests = config.maxRequests;
+        this.windowMs = config.windowMs;
+    }
+    /**
+     * Checks if a request from the given client is allowed.
+     * If allowed, records the request timestamp.
+     *
+     * @param clientId - Unique identifier for the client
+     * @returns True if the request is allowed, false if rate limited
+     */
+    isAllowed(clientId) {
+        const now = Date.now();
+        this.cleanupExpiredEntries(clientId, now);
+        const entry = this.clients.get(clientId);
+        if (!entry) {
+            this.clients.set(clientId, { timestamps: [now] });
+            return true;
+        }
+        if (entry.timestamps.length < this.maxRequests) {
+            entry.timestamps.push(now);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Returns the number of remaining requests for a client within the current window.
+     *
+     * @param clientId - Unique identifier for the client
+     * @returns Number of remaining allowed requests
+     */
+    getRemainingRequests(clientId) {
+        const now = Date.now();
+        this.cleanupExpiredEntries(clientId, now);
+        const entry = this.clients.get(clientId);
+        if (!entry) {
+            return this.maxRequests;
+        }
+        return Math.max(0, this.maxRequests - entry.timestamps.length);
+    }
+    /**
+     * Resets rate limiting state.
+     * If clientId is provided, resets only that client.
+     * Otherwise, resets all clients.
+     *
+     * @param clientId - Optional client identifier to reset
+     */
+    reset(clientId) {
+        if (clientId !== undefined) {
+            this.clients.delete(clientId);
+        }
+        else {
+            this.clients.clear();
+        }
+    }
+    /**
+     * Removes expired timestamps from a client's entry.
+     * Deletes the entry entirely if no valid timestamps remain.
+     *
+     * @param clientId - Client identifier to clean up
+     * @param now - Current timestamp for expiration calculation
+     */
+    cleanupExpiredEntries(clientId, now) {
+        const entry = this.clients.get(clientId);
+        if (!entry) {
+            return;
+        }
+        const cutoff = now - this.windowMs;
+        entry.timestamps = entry.timestamps.filter((timestamp) => timestamp > cutoff);
+        if (entry.timestamps.length === 0) {
+            this.clients.delete(clientId);
+        }
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/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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"}