@j0hanz/superfetch 1.0.2 → 1.0.3

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCT,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCT,CAAC"}

package/dist/config/index.js

@@ -1,7 +1,3 @@
-/**
- * Safely parses an integer from environment variable with validation
- * Environment variables can still be used for deployment overrides (e.g., PORT=8080 npm start)
- */
 function parseIntEnv(value, defaultValue, min = 0, max = Number.MAX_SAFE_INTEGER) {
     if (!value)
         return defaultValue;
@@ -15,17 +11,17 @@ export const config = {
         name: 'superFetch',
         version: '1.0.0',
         port: parseIntEnv(process.env.PORT, 3000, 1, 65535),
-        host: process.env.HOST || '127.0.0.1',
+        host: process.env.HOST ?? '127.0.0.1',
     },
     fetcher: {
-        timeout: parseIntEnv(process.env.FETCH_TIMEOUT, 30000, 1000, 120000), // 1s-120s
+        timeout: parseIntEnv(process.env.FETCH_TIMEOUT, 30000, 1000, 120000),
         maxRedirects: parseIntEnv(process.env.MAX_REDIRECTS, 5, 0, 20),
-        userAgent: process.env.USER_AGENT || 'superFetch-MCP/1.0',
-        maxContentLength: parseIntEnv(process.env.MAX_CONTENT_LENGTH, 10485760, 1024, 52428800), // 1KB-50MB
+        userAgent: process.env.USER_AGENT ?? 'superFetch-MCP/1.0',
+        maxContentLength: parseIntEnv(process.env.MAX_CONTENT_LENGTH, 10485760, 1024, 52428800),
     },
     cache: {
         enabled: process.env.CACHE_ENABLED !== 'false',
-        ttl: parseIntEnv(process.env.CACHE_TTL, 3600, 60, 86400), // 1min-24hr
+        ttl: parseIntEnv(process.env.CACHE_TTL, 3600, 60, 86400),
         maxKeys: parseIntEnv(process.env.CACHE_MAX_KEYS, 100, 10, 10000),
     },
     extraction: {
@@ -35,7 +31,7 @@ export const config = {
         minParagraphLength: parseIntEnv(process.env.MIN_PARAGRAPH_LENGTH, 10, 0, 1000),
     },
     logging: {
-        level: process.env.LOG_LEVEL || 'info',
+        level: process.env.LOG_LEVEL ?? 'info',
         enabled: process.env.ENABLE_LOGGING !== 'false',
     },
 };

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,SAAS,WAAW,CAClB,KAAyB,EACzB,YAAoB,EACpB,GAAG,GAAG,CAAC,EACP,GAAG,GAAG,MAAM,CAAC,gBAAgB;IAE7B,IAAI,CAAC,KAAK;QAAE,OAAO,YAAY,CAAC;IAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,YAAY,CAAC;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC;QACnD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,WAAW;KACtC;IACD,OAAO,EAAE;QACP,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,UAAU;QAChF,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9D,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,oBAAoB;QACzD,gBAAgB,EAAE,WAAW,CAC3B,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAC9B,QAAQ,EACR,IAAI,EACJ,QAAQ,CACT,EAAE,WAAW;KACf;IACD,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,OAAO;QAC9C,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,YAAY;QACtE,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC;KACjE;IACD,UAAU,EAAE;QACV,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,OAAO;QAChE,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,OAAO;QACzD,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC;QAC3E,kBAAkB,EAAE,WAAW,CAC7B,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAChC,EAAE,EACF,CAAC,EACD,IAAI,CACL;KACF;IACD,OAAO,EAAE;QACP,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,OAAO;KAChD;CACO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,SAAS,WAAW,CAClB,KAAyB,EACzB,YAAoB,EACpB,GAAG,GAAG,CAAC,EACP,GAAG,GAAG,MAAM,CAAC,gBAAgB;IAE7B,IAAI,CAAC,KAAK;QAAE,OAAO,YAAY,CAAC;IAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,YAAY,CAAC;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC;QACnD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,WAAW;KACtC;IACD,OAAO,EAAE;QACP,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC;QACpE,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9D,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,oBAAoB;QACzD,gBAAgB,EAAE,WAAW,CAC3B,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAC9B,QAAQ,EACR,IAAI,EACJ,QAAQ,CACT;KACF;IACD,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,OAAO;QAC9C,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC;QACxD,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC;KACjE;IACD,UAAU,EAAE;QACV,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,OAAO;QAChE,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,OAAO;QACzD,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC;QAC3E,kBAAkB,EAAE,WAAW,CAC7B,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAChC,EAAE,EACF,CAAC,EACD,IAAI,CACL;KACF;IACD,OAAO,EAAE;QACP,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,OAAO;KAChD;CACO,CAAC"}

package/dist/config/types.d.ts

@@ -0,0 +1,251 @@
+type ContentBlockType = 'metadata' | 'heading' | 'paragraph' | 'list' | 'code' | 'table' | 'image' | 'blockquote';
+interface ContentBlock {
+    type: ContentBlockType;
+}
+export interface MetadataBlock extends ContentBlock {
+    type: 'metadata';
+    title?: string | undefined;
+    description?: string | undefined;
+    author?: string | undefined;
+    url: string;
+    fetchedAt: string;
+}
+export interface HeadingBlock extends ContentBlock {
+    type: 'heading';
+    level: number;
+    text: string;
+}
+export interface ParagraphBlock extends ContentBlock {
+    type: 'paragraph';
+    text: string;
+}
+export interface ListBlock extends ContentBlock {
+    type: 'list';
+    ordered: boolean;
+    items: string[];
+}
+export interface CodeBlock extends ContentBlock {
+    type: 'code';
+    language?: string | undefined;
+    text: string;
+}
+export interface TableBlock extends ContentBlock {
+    type: 'table';
+    headers?: string[] | undefined;
+    rows: string[][];
+}
+export interface ImageBlock extends ContentBlock {
+    type: 'image';
+    src: string;
+    alt?: string | undefined;
+}
+export interface BlockquoteBlock extends ContentBlock {
+    type: 'blockquote';
+    text: string;
+}
+export type ContentBlockUnion = MetadataBlock | HeadingBlock | ParagraphBlock | ListBlock | CodeBlock | TableBlock | ImageBlock | BlockquoteBlock;
+export interface ExtractedArticle {
+    title?: string | undefined;
+    byline?: string | undefined;
+    content: string;
+    textContent: string;
+    excerpt?: string | undefined;
+    siteName?: string | undefined;
+}
+export interface CacheEntry {
+    url: string;
+    content: string;
+    fetchedAt: string;
+    expiresAt: string;
+}
+export interface ExtractedLink {
+    href: string;
+    text: string;
+    type: 'internal' | 'external' | 'image';
+}
+interface RequestOptions {
+    /** Custom HTTP headers for the request */
+    customHeaders?: Record<string, string> | undefined;
+    /** Request timeout in milliseconds (1000-60000) */
+    timeout?: number | undefined;
+    /** Number of retry attempts (1-10) */
+    retries?: number | undefined;
+}
+export interface FetchUrlInput extends RequestOptions {
+    url: string;
+    extractMainContent?: boolean | undefined;
+    includeMetadata?: boolean | undefined;
+    maxContentLength?: number | undefined;
+    format?: 'jsonl' | 'markdown' | undefined;
+}
+export interface FetchLinksInput extends RequestOptions {
+    url: string;
+    includeExternal?: boolean | undefined;
+    includeInternal?: boolean | undefined;
+    maxLinks?: number | undefined;
+    filterPattern?: string | undefined;
+    includeImages?: boolean | undefined;
+}
+export interface FetchMarkdownInput extends RequestOptions {
+    url: string;
+    extractMainContent?: boolean | undefined;
+    includeMetadata?: boolean | undefined;
+    maxContentLength?: number | undefined;
+    generateToc?: boolean | undefined;
+}
+export interface FetchUrlsInput extends RequestOptions {
+    urls: string[];
+    extractMainContent?: boolean | undefined;
+    includeMetadata?: boolean | undefined;
+    maxContentLength?: number | undefined;
+    format?: 'jsonl' | 'markdown' | undefined;
+    concurrency?: number | undefined;
+    continueOnError?: boolean | undefined;
+}
+export interface ErrorResponse {
+    error: {
+        message: string;
+        code: string;
+        statusCode: number;
+        details?: Record<string, unknown> | undefined;
+        stack?: string | undefined;
+    };
+}
+export interface RateLimitEntry {
+    count: number;
+    resetTime: number;
+}
+export interface RateLimiterOptions {
+    maxRequests: number;
+    windowMs: number;
+    cleanupIntervalMs: number;
+}
+export interface ExtractedMetadata {
+    title?: string | undefined;
+    description?: string | undefined;
+    author?: string | undefined;
+}
+export interface ExtractionResult {
+    article: ExtractedArticle | null;
+    metadata: ExtractedMetadata;
+}
+export type ParseableTagName = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'ul' | 'ol' | 'pre' | 'code' | 'table' | 'img' | 'blockquote';
+export interface LinksTransformResult {
+    links: ExtractedLink[];
+    linkCount: number;
+    filtered: number;
+    truncated: boolean;
+}
+export interface ExtractLinksOptions {
+    includeInternal: boolean;
+    includeExternal: boolean;
+    includeImages: boolean;
+    maxLinks?: number | undefined;
+    filterPattern?: RegExp | undefined;
+}
+export interface TocEntry {
+    level: number;
+    text: string;
+    slug: string;
+}
+export interface MarkdownTransformResult {
+    markdown: string;
+    title: string | undefined;
+    toc: TocEntry[] | undefined;
+    truncated: boolean;
+}
+export interface TransformOptions {
+    extractMainContent: boolean;
+    includeMetadata: boolean;
+    generateToc: boolean;
+    maxContentLength?: number | undefined;
+}
+export interface JsonlTransformResult {
+    content: string;
+    contentBlocks: number;
+    title: string | undefined;
+}
+export interface SingleUrlResult {
+    url: string;
+    success: boolean;
+    title?: string | undefined;
+    content?: string | undefined;
+    contentBlocks?: number | undefined;
+    cached: boolean;
+    error?: string | undefined;
+    errorCode?: string | undefined;
+}
+export interface FetchPipelineOptions<T> {
+    /** URL to fetch */
+    url: string;
+    /** Cache namespace (e.g., 'url', 'links', 'markdown') */
+    cacheNamespace: string;
+    /** Optional custom HTTP headers */
+    customHeaders?: Record<string, string> | undefined;
+    /** Optional: number of retry attempts (1-10, defaults to 3) */
+    retries?: number | undefined;
+    /** Transform function to process HTML into desired format */
+    transform: (html: string, url: string) => T;
+    /** Optional: serialize result for caching (defaults to JSON.stringify) */
+    serialize?: ((result: T) => string) | undefined;
+    /** Optional: deserialize cached content */
+    deserialize?: ((cached: string) => T) | undefined;
+}
+/** Result from the fetch pipeline */
+export interface PipelineResult<T> {
+    /** The transformed data */
+    data: T;
+    /** Whether result came from cache */
+    fromCache: boolean;
+    /** The normalized URL that was fetched */
+    url: string;
+    /** Timestamp of when content was fetched/cached */
+    fetchedAt: string;
+}
+export interface ToolResponse<T = Record<string, unknown>> {
+    [x: string]: unknown;
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    structuredContent: T & Record<string, unknown>;
+}
+export interface BatchUrlResult {
+    url: string;
+    success: boolean;
+    title?: string | undefined;
+    content?: string | undefined;
+    contentBlocks?: number | undefined;
+    cached?: boolean | undefined;
+    error?: string | undefined;
+    errorCode?: string | undefined;
+}
+export interface BatchSummary {
+    total: number;
+    successful: number;
+    failed: number;
+    cached: number;
+    totalContentBlocks: number;
+}
+export interface BatchResponseContent {
+    [x: string]: unknown;
+    results: BatchUrlResult[];
+    summary: BatchSummary;
+    fetchedAt: string;
+}
+export interface ToolErrorResponse {
+    [x: string]: unknown;
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    structuredContent: {
+        [x: string]: unknown;
+        error: string;
+        url: string;
+        errorCode: string;
+    };
+    isError: true;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

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

package/dist/config/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":""}

package/dist/errors/app-error.d.ts

@@ -1,44 +1,26 @@
-/**
- * Base application error class with status code support
- */
 export declare class AppError extends Error {
     readonly statusCode: number;
     readonly isOperational: boolean;
     readonly code: string;
     constructor(message: string, statusCode?: number, code?: string, isOperational?: boolean);
 }
-/**
- * Validation error (400)
- */
 export declare class ValidationError extends AppError {
-    readonly details?: Record<string, unknown>;
+    readonly details: Record<string, unknown> | undefined;
     constructor(message: string, details?: Record<string, unknown>);
 }
-/**
- * URL validation error (400)
- */
 export declare class UrlValidationError extends AppError {
     readonly url: string;
     constructor(message: string, url: string);
 }
-/**
- * Fetch error - network/HTTP errors during URL fetching
- */
 export declare class FetchError extends AppError {
     readonly url: string;
-    readonly httpStatus?: number;
+    readonly httpStatus: number | undefined;
     constructor(message: string, url: string, httpStatus?: number);
 }
-/**
- * Rate limit error (429)
- */
 export declare class RateLimitError extends AppError {
     readonly retryAfter: number;
     constructor(retryAfter: number);
 }
-/**
- * Timeout error (408/504)
- */
 export declare class TimeoutError extends AppError {
     readonly timeoutMs: number;
     constructor(timeoutMs: number, isGateway?: boolean);

package/dist/errors/app-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-error.d.ts","sourceRoot":"","sources":["../../src/errors/app-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,aAAa,EAAE,OAAO,CAAC;IACvC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAG3B,OAAO,EAAE,MAAM,EACf,UAAU,SAAM,EAChB,IAAI,SAAmB,EACvB,aAAa,UAAO;CASvB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAIzC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,QAAQ;IACtC,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAK9D;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,MAAM;CAI/B;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ;CAQjD"}
+{"version":3,"file":"app-error.d.ts","sourceRoot":"","sources":["../../src/errors/app-error.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,aAAa,EAAE,OAAO,CAAC;IACvC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAG3B,OAAO,EAAE,MAAM,EACf,UAAU,SAAM,EAChB,IAAI,SAAmB,EACvB,aAAa,UAAO;CASvB;AAED,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;gBAEjD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAIzC;AAED,qBAAa,UAAW,SAAQ,QAAQ;IACtC,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEnC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAK9D;AAED,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,MAAM;CAI/B;AAED,qBAAa,YAAa,SAAQ,QAAQ;IACxC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ;CAQjD"}

package/dist/errors/app-error.js

@@ -1,6 +1,3 @@
-/**
- * Base application error class with status code support
- */
 export class AppError extends Error {
     statusCode;
     isOperational;
@@ -14,9 +11,6 @@ export class AppError extends Error {
         Error.captureStackTrace(this, this.constructor);
     }
 }
-/**
- * Validation error (400)
- */
 export class ValidationError extends AppError {
     details;
     constructor(message, details) {
@@ -24,9 +18,6 @@ export class ValidationError extends AppError {
         this.details = details;
     }
 }
-/**
- * URL validation error (400)
- */
 export class UrlValidationError extends AppError {
     url;
     constructor(message, url) {
@@ -34,9 +25,6 @@ export class UrlValidationError extends AppError {
         this.url = url;
     }
 }
-/**
- * Fetch error - network/HTTP errors during URL fetching
- */
 export class FetchError extends AppError {
     url;
     httpStatus;
@@ -46,9 +34,6 @@ export class FetchError extends AppError {
         this.httpStatus = httpStatus;
     }
 }
-/**
- * Rate limit error (429)
- */
 export class RateLimitError extends AppError {
     retryAfter;
     constructor(retryAfter) {
@@ -56,9 +41,6 @@ export class RateLimitError extends AppError {
         this.retryAfter = retryAfter;
     }
 }
-/**
- * Timeout error (408/504)
- */
 export class TimeoutError extends AppError {
     timeoutMs;
     constructor(timeoutMs, isGateway = false) {

package/dist/errors/app-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-error.js","sourceRoot":"","sources":["../../src/errors/app-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,UAAU,CAAS;IACnB,aAAa,CAAU;IACvB,IAAI,CAAS;IAE7B,YACE,OAAe,EACf,UAAU,GAAG,GAAG,EAChB,IAAI,GAAG,gBAAgB,EACvB,aAAa,GAAG,IAAI;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3B,OAAO,CAA2B;IAElD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9B,GAAG,CAAS;IAE5B,YAAY,OAAe,EAAE,GAAW;QACtC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,QAAQ;IACtB,GAAG,CAAS;IACZ,UAAU,CAAU;IAEpC,YAAY,OAAe,EAAE,GAAW,EAAE,UAAmB;QAC3D,KAAK,CAAC,OAAO,EAAE,UAAU,IAAI,GAAG,EAAE,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1B,UAAU,CAAS;IAEnC,YAAY,UAAkB;QAC5B,KAAK,CAAC,mBAAmB,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxB,SAAS,CAAS;IAElC,YAAY,SAAiB,EAAE,SAAS,GAAG,KAAK;QAC9C,KAAK,CACH,yBAAyB,SAAS,IAAI,EACtC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EACrB,SAAS,CACV,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}
+{"version":3,"file":"app-error.js","sourceRoot":"","sources":["../../src/errors/app-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,UAAU,CAAS;IACnB,aAAa,CAAU;IACvB,IAAI,CAAS;IAE7B,YACE,OAAe,EACf,UAAU,GAAG,GAAG,EAChB,IAAI,GAAG,gBAAgB,EACvB,aAAa,GAAG,IAAI;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3B,OAAO,CAAsC;IAE7D,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9B,GAAG,CAAS;IAE5B,YAAY,OAAe,EAAE,GAAW;QACtC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,QAAQ;IACtB,GAAG,CAAS;IACZ,UAAU,CAAqB;IAE/C,YAAY,OAAe,EAAE,GAAW,EAAE,UAAmB;QAC3D,KAAK,CAAC,OAAO,EAAE,UAAU,IAAI,GAAG,EAAE,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1B,UAAU,CAAS;IAEnC,YAAY,UAAkB;QAC5B,KAAK,CAAC,mBAAmB,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxB,SAAS,CAAS;IAElC,YAAY,SAAiB,EAAE,SAAS,GAAG,KAAK;QAC9C,KAAK,CACH,yBAAyB,SAAS,IAAI,EACtC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EACrB,SAAS,CACV,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}

package/dist/index.js

@@ -1,14 +1,13 @@
 #!/usr/bin/env node
-import express from 'express';
+import express, {} from 'express';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
 import { config } from './config/index.js';
-import { createMcpServer } from './server.js';
+import { destroyAgents } from './services/fetcher.js';
+import { logError, logInfo } from './services/logger.js';
 import { errorHandler } from './middleware/error-handler.js';
 import { rateLimiter } from './middleware/rate-limiter.js';
-import { logInfo, logError } from './services/logger.js';
-import { destroyAgents } from './services/fetcher.js';
-// Global error handlers for uncaught exceptions and rejections
+import { createMcpServer } from './server.js';
 process.on('uncaughtException', (error) => {
     logError('Uncaught exception', error);
     process.stderr.write(`Uncaught exception: ${error.message}\n`);
@@ -19,32 +18,24 @@ process.on('unhandledRejection', (reason) => {
     logError('Unhandled rejection', error);
     process.stderr.write(`Unhandled rejection: ${error.message}\n`);
 });
-// Check if running in stdio mode
 const isStdioMode = process.argv.includes('--stdio');
-// CORS allowlist - empty means allow all origins
-// For production, configure this in the CORS middleware below
 const ALLOWED_ORIGINS = [];
-/**
- * Async error wrapper for Express route handlers
- * Catches promise rejections and forwards to error middleware
- */
+function getSessionId(req) {
+    const header = req.headers['mcp-session-id'];
+    return Array.isArray(header) ? header[0] : header;
+}
 const asyncHandler = (fn) => {
     return (req, res, next) => {
         Promise.resolve(fn(req, res, next)).catch(next);
     };
 };
 if (isStdioMode) {
-    // Run in stdio mode for direct integration
     const { startStdioServer } = await import('./server.js');
     await startStdioServer();
 }
 else {
-    // Run HTTP server mode
     const app = express();
-    // Middleware
-    // Limit request body size to prevent DoS
     app.use(express.json({ limit: '1mb' }));
-    // Handle JSON parsing errors
     app.use((err, _req, res, next) => {
         if (err instanceof SyntaxError && 'body' in err) {
             res.status(400).json({
@@ -59,30 +50,25 @@ else {
         }
         next(err);
     });
-    // Rate limiting for HTTP mode
     app.use(rateLimiter.middleware());
-    // CORS headers for MCP clients
     app.use((req, res, next) => {
         const origin = req.headers.origin;
-        // Validate origin format if provided
         if (origin) {
             try {
                 new URL(origin);
             }
             catch {
-                // Invalid origin format - skip CORS headers
                 next();
                 return;
             }
         }
-        // Allow if no origin (same-origin/non-browser), no allowlist configured, or origin in allowlist
         if (!origin ||
             ALLOWED_ORIGINS.length === 0 ||
             ALLOWED_ORIGINS.includes(origin)) {
             res.header('Access-Control-Allow-Origin', origin ?? '*');
             res.header('Access-Control-Allow-Methods', 'GET, POST, DELETE, OPTIONS');
             res.header('Access-Control-Allow-Headers', 'Content-Type, mcp-session-id');
-            res.header('Access-Control-Max-Age', '86400'); // Cache preflight for 24 hours
+            res.header('Access-Control-Max-Age', '86400');
         }
         if (req.method === 'OPTIONS') {
             res.sendStatus(200);
@@ -90,7 +76,6 @@ else {
         }
         next();
     });
-    // Health check endpoint
     app.get('/health', (_req, res) => {
         res.json({
             status: 'healthy',
@@ -100,9 +85,7 @@ else {
         });
     });
     const sessions = new Map();
-    // Session TTL: 30 minutes (sessions without activity will be cleaned up)
     const SESSION_TTL_MS = 30 * 60 * 1000;
-    // Cleanup stale sessions periodically (every 5 minutes)
     const sessionCleanupInterval = setInterval(() => {
         const now = Date.now();
         for (const [sessionId, entry] of sessions) {
@@ -114,11 +97,9 @@ else {
         }
     }, 5 * 60 * 1000);
     sessionCleanupInterval.unref();
-    // MCP Streamable HTTP endpoint (modern replacement for SSE)
     app.post('/mcp', asyncHandler(async (req, res) => {
-        const sessionId = req.headers['mcp-session-id'];
+        const sessionId = getSessionId(req);
         let transport;
-        // Debug logging
         const body = req.body;
         logInfo('[MCP POST]', {
             method: body?.method,
@@ -129,12 +110,10 @@ else {
         });
         const existingSession = sessionId ? sessions.get(sessionId) : undefined;
         if (existingSession) {
-            // Reuse existing session and update timestamp
             transport = existingSession.transport;
-            existingSession.createdAt = Date.now(); // Refresh TTL on activity
+            existingSession.createdAt = Date.now();
         }
         else if (!sessionId && isInitializeRequest(req.body)) {
-            // New session initialization
             transport = new StreamableHTTPServerTransport({
                 sessionIdGenerator: () => crypto.randomUUID(),
                 onsessioninitialized: (id) => {
@@ -155,7 +134,6 @@ else {
             await mcpServer.connect(transport);
         }
         else {
-            // Invalid request - no session and not an initialize request
             res.status(400).json({
                 jsonrpc: '2.0',
                 error: {
@@ -168,9 +146,8 @@ else {
         }
         await transport.handleRequest(req, res, req.body);
     }));
-    // GET endpoint for SSE stream (for server-initiated messages)
     app.get('/mcp', asyncHandler(async (req, res) => {
-        const sessionId = req.headers['mcp-session-id'];
+        const sessionId = getSessionId(req);
         if (!sessionId) {
             res.status(400).json({ error: 'Missing mcp-session-id header' });
             return;
@@ -180,14 +157,11 @@ else {
             res.status(404).json({ error: 'Session not found' });
             return;
         }
-        // Refresh TTL on activity
         session.createdAt = Date.now();
-        // Handle SSE stream for server-initiated messages
         await session.transport.handleRequest(req, res);
     }));
-    // DELETE endpoint for session cleanup
     app.delete('/mcp', asyncHandler(async (req, res) => {
-        const sessionId = req.headers['mcp-session-id'];
+        const sessionId = getSessionId(req);
         const session = sessionId ? sessions.get(sessionId) : undefined;
         if (session) {
             await session.transport.handleRequest(req, res);
@@ -196,9 +170,7 @@ else {
             res.status(204).end();
         }
     }));
-    // Error handling middleware (must be last)
     app.use(errorHandler);
-    // Start server
     const server = app
         .listen(config.server.port, config.server.host, () => {
         logInfo(`superFetch MCP server started`, {
@@ -214,25 +186,19 @@ else {
         logError('Failed to start server', err);
         process.exit(1);
     });
-    // Graceful shutdown for HTTP mode
     const shutdown = (signal) => {
         process.stdout.write(`\n${signal} received, shutting down gracefully...\n`);
-        // Stop accepting new sessions
         clearInterval(sessionCleanupInterval);
-        // Destroy rate limiter to stop cleanup interval
         rateLimiter.destroy();
-        // Close all MCP transport sessions
         for (const session of sessions.values()) {
             void session.transport.close();
         }
         sessions.clear();
-        // Destroy HTTP agents to close all connections
         destroyAgents();
         server.close(() => {
             logInfo('HTTP server closed');
             process.exit(0);
         });
-        // Force exit after timeout
         setTimeout(() => {
             logError('Forced shutdown after timeout');
             process.exit(1);