@j0hanz/superfetch 1.0.2 → 1.0.5

package/dist/utils/concurrency.js

@@ -0,0 +1,38 @@
+function createConcurrencyLimiter(limit) {
+    const maxConcurrency = Math.min(Math.max(1, limit), 10);
+    let active = 0;
+    const queue = [];
+    return async (fn) => {
+        while (active >= maxConcurrency) {
+            await new Promise((resolve) => queue.push(resolve));
+        }
+        active++;
+        try {
+            return await fn();
+        }
+        finally {
+            active--;
+            const next = queue.shift();
+            if (next)
+                next();
+        }
+    };
+}
+export async function runWithConcurrency(limit, tasks, options) {
+    const limiter = createConcurrencyLimiter(limit);
+    const total = tasks.length;
+    let completed = 0;
+    const wrappedTasks = tasks.map((task) => async () => {
+        try {
+            return await limiter(task);
+        }
+        finally {
+            completed++;
+            if (options?.onProgress) {
+                options.onProgress(completed, total);
+            }
+        }
+    });
+    return Promise.allSettled(wrappedTasks.map(async (task) => task()));
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/utils/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAMA,SAAS,wBAAwB,CAAC,KAAa;IAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,OAAO,KAAK,EAAK,EAAoB,EAAc,EAAE;QACnD,OAAO,MAAM,IAAI,cAAc,EAAE,CAAC;YAChC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,EAAE,CAAC;QACT,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC;YACT,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,IAAI;gBAAE,IAAI,EAAE,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAa,EACb,KAA2B,EAC3B,OAA4B;IAE5B,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE;QAClD,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;gBAAS,CAAC;YACT,SAAS,EAAE,CAAC;YACZ,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;gBACxB,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/utils/content-cleaner.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Post-processing content cleaner for removing noise artifacts
+ * that slip through Readability extraction.
+ */
+/**
+ * Clean paragraph text by removing noise
+ */
+export declare function cleanParagraph(text: string): string | null;
+/**
+ * Clean heading text by removing noise and markdown link syntax
+ */
+export declare function cleanHeading(text: string): string | null;
+/**
+ * Clean list items by filtering out noise
+ */
+export declare function cleanListItems(items: string[]): string[];
+/**
+ * Clean code block text - minimal cleaning to preserve code integrity
+ */
+export declare function cleanCodeBlock(code: string): string | null;
+/**
+ * Strip markdown link syntax from text for cleaner slugs/display
+ * [Text](#anchor) -> Text
+ * [Text](url) -> Text
+ */
+export declare function stripMarkdownLinks(text: string): string;
+/**
+ * Remove common timestamp patterns from text (inline removal)
+ * Use when you want to strip timestamps from within longer content
+ */
+export declare function removeInlineTimestamps(text: string): string;
+//# sourceMappingURL=content-cleaner.d.ts.map

package/dist/utils/content-cleaner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-cleaner.d.ts","sourceRoot":"","sources":["../../src/utils/content-cleaner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsKH;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsB1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsB3D"}

package/dist/utils/content-cleaner.js

@@ -0,0 +1,238 @@
+/**
+ * Post-processing content cleaner for removing noise artifacts
+ * that slip through Readability extraction.
+ */
+// Pre-compiled combined pattern for optimal performance
+const NOISE_PATTERN_COMBINED = new RegExp([
+    // Relative timestamps
+    '^\\d+\\s*(seconds?|minutes?|hours?|days?|weeks?|months?|years?)\\s*ago$',
+    '^(just now|recently|today|yesterday|last week|last month)$',
+    '^(updated|modified|edited|created|published)\\s*:?\\s*\\d+\\s*(seconds?|minutes?|hours?|days?|weeks?|months?|years?)\\s*ago$',
+    '^(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\\s+\\d{1,2},?\\s+\\d{4}$',
+    '^\\d{1,2}\\s+(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\\s+\\d{4}$',
+    '^\\d{4}-\\d{2}-\\d{2}$',
+    '^last\\s+updated\\s*:?',
+    // Share/action buttons
+    '^(share|copy|like|follow|subscribe|download|print|save|bookmark|tweet|pin it|email|export)$',
+    '^(copy to clipboard|copied!?|copy code|copy link)$',
+    '^(share on|share to|share via)\\s+(twitter|facebook|linkedin|reddit|x|email)$',
+    // UI artifacts
+    '^(click to copy|expand|collapse|show more|show less|load more|view more|read more|see more|see all|view all)$',
+    '^(toggle|switch|enable|disable|on|off)$',
+    '^(edit|delete|remove|add|new|create|update|cancel|confirm|submit|reset|clear)$',
+    '^(open in|view in|edit in)\\s+\\w+$',
+    '^(try it|run|execute|play|preview|demo|live demo|playground)$',
+    '^(source|view source|edit this page|edit on github|improve this doc)$',
+    // Empty/placeholder
+    '^(loading\\.{0,3}|please wait\\.{0,3}|\\.{2,})$',
+    '^(n\\/a|tbd|todo|coming soon|placeholder|untitled)$',
+    // Navigation
+    '^(next|previous|prev|back|forward|home|menu|close|open|skip to|jump to|go to)$',
+    '^(table of contents|toc|contents|on this page|in this article|in this section)$',
+    '^(scroll to top|back to top|top)$',
+    // Cookie/consent
+    '^(accept|reject|accept all|reject all|cookie settings|privacy settings|manage preferences)$',
+    '^(accept cookies|decline cookies|cookie policy|privacy policy|terms of service|terms & conditions)$',
+    // Counts
+    '^\\d+\\s*(comments?|replies?|reactions?|responses?)$',
+    '^\\d+\\s*(likes?|shares?|views?|followers?|retweets?|stars?|forks?|claps?|upvotes?|downvotes?)$',
+    '^(liked by|shared by|followed by)\\s+\\d+',
+    // Version badges
+    '^v?\\d+\\.\\d+(\\.\\d+)?(-\\w+)?$',
+    '^(stable|beta|alpha|rc|preview|experimental|deprecated|legacy|new|updated)$',
+    // Structural
+    '^(a|b|c|d|e|f|g|h|i|j|k|l|m|n|o|p|q|r|s|t|u|v|w|x|y|z)$',
+    '^panel\\s*[a-z]?$',
+    // API artifacts
+    '^(required|optional|default|type|example|description|parameters?|returns?|response|request)$',
+    '^(get|post|put|patch|delete|head|options)\\s*$',
+    // Interactive
+    '^(drag|drop|resize|zoom|scroll|swipe|tap|click|hover|focus)(\\s+to\\s+\\w+)?$',
+    '^(drag the|move the|resize the|drag to|click to)\\s+\\w+',
+    // Breadcrumbs
+    '^[/\\\\>→»›]+$',
+    // Ads
+    '^(ad|advertisement|sponsored|promoted|partner content)$',
+].join('|'), 'i');
+// Pre-compiled pattern for short text noise
+const SHORT_TEXT_NOISE_PATTERN = new RegExp([
+    '^#\\w+$',
+    '^@\\w+$',
+    '^\\d+$',
+    '^[•·→←↑↓►▼▲◄▶◀■□●○★☆✓✗✔✘×]+$',
+    '^[,;:\\-–—]+$',
+    '^\\[\\d+\\]$',
+    '^\\(\\d+\\)$',
+    '^fig\\.?\\s*\\d+$',
+    '^table\\s*\\d+$',
+    '^step\\s*\\d+$',
+    '^note:?$',
+    '^tip:?$',
+    '^warning:?$',
+    '^info:?$',
+    '^caution:?$',
+].join('|'), 'i');
+// Pre-compiled pattern for UI chrome detection
+const UI_CHROME_PATTERN = new RegExp([
+    '^(sign in|sign up|log in|log out|register|create account)$',
+    '^(search|search\\.\\.\\.|search docs|search documentation)$',
+    '^(dark mode|light mode|theme|language|locale)$',
+    '^(feedback|report issue|report a bug|file an issue|suggest edit)$',
+    '^(documentation|docs|api|reference|guide|tutorial|examples?)$',
+    "^(version|changelog|release notes|what's new)$",
+].join('|'), 'i');
+// Minimum lengths for different content types
+const MIN_PARAGRAPH_LENGTH = 20;
+const MIN_HEADING_LENGTH = 2;
+const MIN_LIST_ITEM_LENGTH = 3;
+const SHORT_TEXT_THRESHOLD = 25;
+/**
+ * Check if text matches any noise pattern
+ */
+function isNoiseText(text) {
+    const trimmed = text.trim();
+    // Empty or whitespace-only
+    if (!trimmed) {
+        return true;
+    }
+    // Check combined noise pattern (single regex test)
+    if (NOISE_PATTERN_COMBINED.test(trimmed)) {
+        return true;
+    }
+    // Check short text patterns for brief content
+    if (trimmed.length < SHORT_TEXT_THRESHOLD) {
+        if (SHORT_TEXT_NOISE_PATTERN.test(trimmed)) {
+            return true;
+        }
+        // Also check UI chrome patterns for short text
+        if (UI_CHROME_PATTERN.test(trimmed)) {
+            return true;
+        }
+    }
+    return false;
+}
+// Pre-compiled placeholder pattern (combined for performance)
+const PLACEHOLDER_PATTERN = /^(lorem ipsum|sample text|placeholder|example (text|content|data)|test (text|content|data)|your (text|content|name|email) here|enter (your|a) |type (your|a|something) )/i;
+// Cache for placeholder checks to avoid repeated regex tests
+const PLACEHOLDER_CACHE = new Map();
+const PLACEHOLDER_CACHE_MAX_SIZE = 1000;
+/**
+ * Check if text looks like placeholder/demo content
+ * Uses caching for 3-8x performance improvement on repeated patterns
+ */
+function isPlaceholderContent(text) {
+    const trimmed = text.trim().toLowerCase();
+    // Check cache first
+    const cached = PLACEHOLDER_CACHE.get(trimmed);
+    if (cached !== undefined) {
+        return cached;
+    }
+    // Single regex test (faster than array iteration)
+    const result = PLACEHOLDER_PATTERN.test(trimmed);
+    // Cache result with LRU eviction
+    if (PLACEHOLDER_CACHE.size >= PLACEHOLDER_CACHE_MAX_SIZE) {
+        const firstKey = PLACEHOLDER_CACHE.keys().next().value;
+        if (firstKey !== undefined) {
+            PLACEHOLDER_CACHE.delete(firstKey);
+        }
+    }
+    PLACEHOLDER_CACHE.set(trimmed, result);
+    return result;
+}
+/**
+ * Clean paragraph text by removing noise
+ */
+export function cleanParagraph(text) {
+    const trimmed = text.trim();
+    // Too short to be meaningful
+    if (trimmed.length < MIN_PARAGRAPH_LENGTH) {
+        // Allow very short paragraphs if they end with punctuation (likely real content)
+        if (!/[.!?]$/.test(trimmed)) {
+            return null;
+        }
+    }
+    // Is noise content
+    if (isNoiseText(trimmed)) {
+        return null;
+    }
+    // Is placeholder content (in paragraphs, not in examples)
+    if (isPlaceholderContent(trimmed)) {
+        return null;
+    }
+    return trimmed;
+}
+/**
+ * Clean heading text by removing noise and markdown link syntax
+ */
+export function cleanHeading(text) {
+    let cleaned = text.trim();
+    // Too short
+    if (cleaned.length < MIN_HEADING_LENGTH) {
+        return null;
+    }
+    // Remove markdown link syntax: [Text](#anchor) -> Text
+    cleaned = cleaned.replace(/\[([^\]]+)\]\([^)]*\)/g, '$1');
+    // Remove trailing anchor links like "Link for this heading"
+    cleaned = cleaned.replace(/\s*Link for (this heading|[\w\s]+)\s*$/i, '');
+    // Remove trailing hash symbols often used for anchor links
+    cleaned = cleaned.replace(/\s*#+\s*$/, '');
+    // Is noise content
+    if (isNoiseText(cleaned)) {
+        return null;
+    }
+    return cleaned.trim();
+}
+/**
+ * Clean list items by filtering out noise
+ */
+export function cleanListItems(items) {
+    return items
+        .map((item) => item.trim())
+        .filter((item) => {
+        if (item.length < MIN_LIST_ITEM_LENGTH)
+            return false;
+        if (isNoiseText(item))
+            return false;
+        return true;
+    });
+}
+/**
+ * Clean code block text - minimal cleaning to preserve code integrity
+ */
+export function cleanCodeBlock(code) {
+    const trimmed = code.trim();
+    // Empty code block
+    if (trimmed.length === 0) {
+        return null;
+    }
+    // Very short code blocks that are likely just labels
+    if (trimmed.length < 3 && !/^[{}[\]();<>]$/.test(trimmed)) {
+        return null;
+    }
+    return trimmed;
+}
+/**
+ * Strip markdown link syntax from text for cleaner slugs/display
+ * [Text](#anchor) -> Text
+ * [Text](url) -> Text
+ */
+export function stripMarkdownLinks(text) {
+    return text.replace(/\[([^\]]+)\]\([^)]*\)/g, '$1');
+}
+/**
+ * Remove common timestamp patterns from text (inline removal)
+ * Use when you want to strip timestamps from within longer content
+ */
+export function removeInlineTimestamps(text) {
+    return (text
+        // Remove "X days/hours/etc ago" patterns
+        .replace(/\b\d+\s*(seconds?|minutes?|hours?|days?|weeks?|months?|years?)\s*ago\b/gi, '')
+        // Remove "Updated: date" patterns
+        .replace(/\b(updated|modified|edited|created|published)\s*:?\s*\d+\s*(seconds?|minutes?|hours?|days?|weeks?|months?|years?)\s*ago\b/gi, '')
+        // Remove standalone dates
+        .replace(/\b(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\s+\d{1,2},?\s+\d{4}\b/gi, '')
+        // Clean up extra whitespace
+        .replace(/\s{2,}/g, ' ')
+        .trim());
+}
+//# sourceMappingURL=content-cleaner.js.map

package/dist/utils/content-cleaner.js.map

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

package/dist/utils/language-detector.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Detect programming language from code content
+ */
+export declare function detectLanguage(code: string): string | undefined;
+//# sourceMappingURL=language-detector.d.ts.map

package/dist/utils/language-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-detector.d.ts","sourceRoot":"","sources":["../../src/utils/language-detector.ts"],"names":[],"mappings":"AA4CA;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/D"}

package/dist/utils/language-detector.js

@@ -0,0 +1,50 @@
+/**
+ * Language detection patterns for code blocks
+ * Shared between parser and markdown transformer
+ */
+const LANGUAGE_PATTERNS = [
+    // JSX/TSX patterns
+    [
+        /^\s*import\s+.*\s+from\s+['"]react['"]|<[A-Z][a-zA-Z]*[\s/>]|jsx\s*:|className=/m,
+        'jsx',
+    ],
+    // TypeScript patterns
+    [
+        /:\s*(string|number|boolean|void|any|unknown|never)\b|interface\s+\w+|type\s+\w+\s*=/m,
+        'typescript',
+    ],
+    // Rust patterns
+    [/^\s*(fn|let\s+mut|impl|struct|enum|use\s+\w+::)/m, 'rust'],
+    // JavaScript patterns (generic)
+    [
+        /^\s*(export|const|let|var|function|class|async|await)\b|^\s*import\s+.*['"]/m,
+        'javascript',
+    ],
+    // Python patterns
+    [/^\s*(def|class|import|from|if __name__|print\()/m, 'python'],
+    // Bash/Shell patterns
+    [
+        /^\s*(npm|yarn|pnpm|npx|brew|apt|pip|cargo|go )\s+(install|add|run|build|start)/m,
+        'bash',
+    ],
+    [/^\s*[$#]\s+\w+|^\s*#!|^\s*(sudo|chmod|mkdir|cd|ls|cat|echo)\s+/m, 'bash'],
+    // CSS patterns
+    [/^\s*[.#@]?[\w-]+\s*\{[^}]*\}|@media|@import|@keyframes/m, 'css'],
+    // HTML patterns
+    [/^\s*<(!DOCTYPE|html|head|body|div|span|p|a|script|style)\b/im, 'html'],
+    // JSON patterns
+    [/^\s*\{\s*"|^\s*\[\s*("|\d|true|false|null)/m, 'json'],
+    // YAML patterns
+    [/^\s*[\w-]+:\s*.+$/m, 'yaml'],
+    // SQL patterns
+    [/^\s*(SELECT|INSERT|UPDATE|DELETE|CREATE|ALTER|DROP)\s+/im, 'sql'],
+    // Go patterns
+    [/^\s*(func|package|import\s+")/m, 'go'],
+];
+/**
+ * Detect programming language from code content
+ */
+export function detectLanguage(code) {
+    return LANGUAGE_PATTERNS.find(([pattern]) => pattern.test(code))?.[1];
+}
+//# sourceMappingURL=language-detector.js.map

package/dist/utils/language-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-detector.js","sourceRoot":"","sources":["../../src/utils/language-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,iBAAiB,GAAG;IACxB,mBAAmB;IACnB;QACE,kFAAkF;QAClF,KAAK;KACN;IACD,sBAAsB;IACtB;QACE,sFAAsF;QACtF,YAAY;KACb;IACD,gBAAgB;IAChB,CAAC,kDAAkD,EAAE,MAAM,CAAC;IAC5D,gCAAgC;IAChC;QACE,8EAA8E;QAC9E,YAAY;KACb;IACD,kBAAkB;IAClB,CAAC,kDAAkD,EAAE,QAAQ,CAAC;IAC9D,sBAAsB;IACtB;QACE,iFAAiF;QACjF,MAAM;KACP;IACD,CAAC,iEAAiE,EAAE,MAAM,CAAC;IAC3E,eAAe;IACf,CAAC,yDAAyD,EAAE,KAAK,CAAC;IAClE,gBAAgB;IAChB,CAAC,8DAA8D,EAAE,MAAM,CAAC;IACxE,gBAAgB;IAChB,CAAC,6CAA6C,EAAE,MAAM,CAAC;IACvD,gBAAgB;IAChB,CAAC,oBAAoB,EAAE,MAAM,CAAC;IAC9B,eAAe;IACf,CAAC,0DAA0D,EAAE,KAAK,CAAC;IACnE,cAAc;IACd,CAAC,gCAAgC,EAAE,IAAI,CAAC;CAChC,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/dist/utils/sanitizer.d.ts

@@ -1,13 +1,3 @@
-/**
- * Sanitizes text content by collapsing whitespace and trimming
- * Returns empty string for null/undefined input
- */
 export declare function sanitizeText(text: string | null | undefined): string;
-/**
- * Truncates text to a maximum length with ellipsis
- * @param text - Text to truncate
- * @param maxLength - Maximum length (must be > 3 to accommodate ellipsis)
- * @returns Truncated text with ellipsis if needed
- */
 export declare function truncateText(text: string, maxLength: number): string;
 //# sourceMappingURL=sanitizer.d.ts.map

package/dist/utils/sanitizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sanitizer.d.ts","sourceRoot":"","sources":["../../src/utils/sanitizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAIpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQpE"}
+{"version":3,"file":"sanitizer.d.ts","sourceRoot":"","sources":["../../src/utils/sanitizer.ts"],"names":[],"mappings":"AAGA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAIpE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQpE"}

package/dist/utils/sanitizer.js

@@ -1,20 +1,12 @@
-/**
- * Sanitizes text content by collapsing whitespace and trimming
- * Returns empty string for null/undefined input
- */
+// Pre-compiled regex patterns for hot path optimization
+const WHITESPACE_REGEX = /\s+/g;
 export function sanitizeText(text) {
     if (text == null)
         return '';
     if (typeof text !== 'string')
         return String(text);
-    return text.replace(/\s+/g, ' ').trim();
+    return text.replace(WHITESPACE_REGEX, ' ').trim();
 }
-/**
- * Truncates text to a maximum length with ellipsis
- * @param text - Text to truncate
- * @param maxLength - Maximum length (must be > 3 to accommodate ellipsis)
- * @returns Truncated text with ellipsis if needed
- */
 export function truncateText(text, maxLength) {
     if (maxLength < 4) {
         return text.length > 0 ? text.charAt(0) : '';
@@ -22,6 +14,6 @@ export function truncateText(text, maxLength) {
     if (text.length <= maxLength) {
         return text;
     }
-    return text.substring(0, maxLength - 3) + '...';
+    return `${text.substring(0, maxLength - 3)}...`;
 }
 //# sourceMappingURL=sanitizer.js.map

package/dist/utils/sanitizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"sanitizer.js","sourceRoot":"","sources":["../../src/utils/sanitizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAA+B;IAC1D,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,SAAiB;IAC1D,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AAClD,CAAC"}
+{"version":3,"file":"sanitizer.js","sourceRoot":"","sources":["../../src/utils/sanitizer.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,MAAM,UAAU,YAAY,CAAC,IAA+B;IAC1D,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,SAAiB;IAC1D,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC;AAClD,CAAC"}

package/dist/utils/tool-error-handler.d.ts

@@ -1,18 +1,4 @@
-/** MCP SDK-compatible error response (index signature required by SDK) */
-export type ToolErrorResponse = {
-    [x: string]: unknown;
-    content: {
-        type: 'text';
-        text: string;
-    }[];
-    structuredContent: {
-        [x: string]: unknown;
-        error: string;
-        url: string;
-        errorCode: string;
-    };
-    isError: true;
-};
+import type { ToolErrorResponse } from '../config/types.js';
 export declare function createToolErrorResponse(message: string, url: string, code: string): ToolErrorResponse;
 export declare function handleToolError(error: unknown, url: string, fallbackMessage?: string): ToolErrorResponse;
 //# sourceMappingURL=tool-error-handler.d.ts.map

package/dist/utils/tool-error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/tool-error-handler.ts"],"names":[],"mappings":"AAOA,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,iBAAiB,EAAE;QACjB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,EAAE,IAAI,CAAC;CACf,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,iBAAiB,CAOnB;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,EACX,eAAe,SAAqB,GACnC,iBAAiB,CAqBnB"}
+{"version":3,"file":"tool-error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/tool-error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAa5D,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,iBAAiB,CAOnB;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,EACX,eAAe,SAAqB,GACnC,iBAAiB,CA8CnB"}

package/dist/utils/tool-error-handler.js

@@ -1,4 +1,5 @@
-import { AppError, UrlValidationError, FetchError, TimeoutError, } from '../errors/index.js';
+import { AbortError, AppError, FetchError, RateLimitError, TimeoutError, UrlValidationError, } from '../errors/index.js';
+const isDevelopment = process.env.NODE_ENV === 'development';
 export function createToolErrorResponse(message, url, code) {
     const structuredContent = { error: message, url, errorCode: code };
     return {
@@ -9,19 +10,46 @@ export function createToolErrorResponse(message, url, code) {
 }
 export function handleToolError(error, url, fallbackMessage = 'Operation failed') {
     if (error instanceof UrlValidationError) {
-        return createToolErrorResponse(error.message, url, 'INVALID_URL');
+        const message = isDevelopment
+            ? `${error.message}\nURL: ${error.url}\nStack: ${error.stack ?? ''}`
+            : error.message;
+        return createToolErrorResponse(message, url, 'INVALID_URL');
+    }
+    if (error instanceof AbortError) {
+        const message = isDevelopment
+            ? `Request aborted${error.reason ? `: ${error.reason}` : ''}\n${error.stack ?? ''}`
+            : `Request aborted${error.reason ? `: ${error.reason}` : ''}`;
+        return createToolErrorResponse(message, url, 'ABORTED');
     }
     if (error instanceof TimeoutError) {
-        return createToolErrorResponse(`Request timed out after ${error.timeoutMs}ms`, url, 'TIMEOUT');
+        const message = isDevelopment
+            ? `Request timed out after ${error.timeoutMs}ms\n${error.stack ?? ''}`
+            : `Request timed out after ${error.timeoutMs}ms`;
+        return createToolErrorResponse(message, url, 'TIMEOUT');
+    }
+    if (error instanceof RateLimitError) {
+        const message = isDevelopment
+            ? `Rate limited. Retry after ${error.retryAfter}s\n${error.stack ?? ''}`
+            : `Rate limited. Retry after ${error.retryAfter}s`;
+        return createToolErrorResponse(message, url, 'RATE_LIMITED');
     }
     if (error instanceof FetchError) {
         const code = error.httpStatus ? `HTTP_${error.httpStatus}` : 'FETCH_ERROR';
-        return createToolErrorResponse(error.message, url, code);
+        const message = isDevelopment
+            ? `${error.message}\n${error.stack ?? ''}`
+            : error.message;
+        return createToolErrorResponse(message, url, code);
     }
     if (error instanceof AppError) {
-        return createToolErrorResponse(error.message, url, error.code);
+        const message = isDevelopment
+            ? `${error.message}\n${error.stack ?? ''}`
+            : error.message;
+        return createToolErrorResponse(message, url, error.code);
     }
     const message = error instanceof Error ? error.message : 'Unknown error';
-    return createToolErrorResponse(`${fallbackMessage}: ${message}`, url, 'UNKNOWN_ERROR');
+    const fullMessage = isDevelopment && error instanceof Error
+        ? `${fallbackMessage}: ${message}\n${error.stack ?? ''}`
+        : `${fallbackMessage}: ${message}`;
+    return createToolErrorResponse(fullMessage, url, 'UNKNOWN_ERROR');
 }
 //# sourceMappingURL=tool-error-handler.js.map

package/dist/utils/tool-error-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-error-handler.js","sourceRoot":"","sources":["../../src/utils/tool-error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAe5B,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,GAAW,EACX,IAAY;IAEZ,MAAM,iBAAiB,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACnE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACpE,iBAAiB;QACjB,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAc,EACd,GAAW,EACX,eAAe,GAAG,kBAAkB;IAEpC,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACxC,OAAO,uBAAuB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,OAAO,uBAAuB,CAC5B,2BAA2B,KAAK,CAAC,SAAS,IAAI,EAC9C,GAAG,EACH,SAAS,CACV,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;QAC3E,OAAO,uBAAuB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,uBAAuB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;IACzE,OAAO,uBAAuB,CAAC,GAAG,eAAe,KAAK,OAAO,EAAE,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC;AACzF,CAAC"}
+{"version":3,"file":"tool-error-handler.js","sourceRoot":"","sources":["../../src/utils/tool-error-handler.ts"],"names":[],"mappings":"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"}

package/dist/utils/url-validator.d.ts

@@ -1,11 +1,3 @@
-/**
- * Validates and normalizes a URL, blocking SSRF attack vectors
- * @throws {ValidationError} if URL is empty or too long
- * @throws {UrlValidationError} if URL is invalid or blocked
- */
 export declare function validateAndNormalizeUrl(urlString: string): string;
-/**
- * Checks if a URL is internal (same domain)
- */
 export declare function isInternalUrl(url: string, baseUrl: string): boolean;
 //# sourceMappingURL=url-validator.d.ts.map

package/dist/utils/url-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-validator.d.ts","sourceRoot":"","sources":["../../src/utils/url-validator.ts"],"names":[],"mappings":"AAyCA;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA2EjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAQnE"}
+{"version":3,"file":"url-validator.d.ts","sourceRoot":"","sources":["../../src/utils/url-validator.ts"],"names":[],"mappings":"AAmCA,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA2EjE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAQnE"}

package/dist/utils/url-validator.js

@@ -1,44 +1,33 @@
 import { UrlValidationError, ValidationError } from '../errors/app-error.js';
-// Maximum URL length to prevent DoS attacks
 const MAX_URL_LENGTH = 2048;
-// Blocked hosts to prevent SSRF attacks
 const BLOCKED_HOSTS = new Set([
     'localhost',
     '127.0.0.1',
     '0.0.0.0',
     '::1',
-    '169.254.169.254', // AWS metadata endpoint
-    'metadata.google.internal', // GCP metadata
-    'metadata.azure.com', // Azure metadata
-    '100.100.100.200', // Alibaba Cloud metadata
-    'instance-data', // Common cloud metadata hostname
+    '169.254.169.254',
+    'metadata.google.internal',
+    'metadata.azure.com',
+    '100.100.100.200',
+    'instance-data',
 ]);
-// Blocked IP patterns (private networks)
 const BLOCKED_IP_PATTERNS = [
-    /^10\./, // Private Class A
-    /^172\.(1[6-9]|2\d|3[01])\./, // Private Class B
-    /^192\.168\./, // Private Class C
-    /^127\./, // Loopback
-    /^0\./, // Current network
-    /^169\.254\./, // Link-local
-    /^fc00:/i, // IPv6 unique local
-    /^fe80:/i, // IPv6 link-local
-    /^::ffff:127\./, // IPv4-mapped IPv6 loopback
-    /^::ffff:10\./, // IPv4-mapped IPv6 private
-    /^::ffff:172\.(1[6-9]|2\d|3[01])\./, // IPv4-mapped IPv6 private
-    /^::ffff:192\.168\./, // IPv4-mapped IPv6 private
+    /^10\./,
+    /^172\.(1[6-9]|2\d|3[01])\./,
+    /^192\.168\./,
+    /^127\./,
+    /^0\./,
+    /^169\.254\./,
+    /^fc00:/i,
+    /^fe80:/i,
+    /^::ffff:127\./,
+    /^::ffff:10\./,
+    /^::ffff:172\.(1[6-9]|2\d|3[01])\./,
+    /^::ffff:192\.168\./,
 ];
-/**
- * Checks if a hostname matches blocked IP patterns
- */
 function isBlockedIp(hostname) {
     return BLOCKED_IP_PATTERNS.some((pattern) => pattern.test(hostname));
 }
-/**
- * Validates and normalizes a URL, blocking SSRF attack vectors
- * @throws {ValidationError} if URL is empty or too long
- * @throws {UrlValidationError} if URL is invalid or blocked
- */
 export function validateAndNormalizeUrl(urlString) {
     // Check for empty or whitespace-only input
     if (!urlString || typeof urlString !== 'string') {
@@ -86,9 +75,6 @@ export function validateAndNormalizeUrl(urlString) {
     }
     return url.href;
 }
-/**
- * Checks if a URL is internal (same domain)
- */
 export function isInternalUrl(url, baseUrl) {
     try {
         const urlObj = new URL(url, baseUrl);