@j0hanz/fetch-url-mcp 1.12.4 → 1.12.5

package/dist/lib/config.js

@@ -16,16 +16,16 @@ function hasPackageJsonVersion(value) {
 function readServerVersion(moduleUrl) {
     const packageJsonPath = findPackageJSON(moduleUrl);
     if (!packageJsonPath)
-        throw new Error('package.json not found');
+        throw Error('package.json not found');
     let packageJson;
     try {
         packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
     }
     catch (error) {
-        throw new Error(`Failed to parse package.json at ${packageJsonPath}: ${getErrorMessage(error)}`, { cause: error });
+        throw Error(`Failed to parse package.json at ${packageJsonPath}: ${getErrorMessage(error)}`, { cause: error });
     }
     if (!hasPackageJsonVersion(packageJson)) {
-        throw new Error(`package.json version is missing at ${packageJsonPath}`);
+        throw Error(`package.json version is missing at ${packageJsonPath}`);
     }
     return packageJson.version;
 }
@@ -184,14 +184,17 @@ const EnvParser = {
         if (!value)
             return undefined;
         const parsed = URL.parse(value);
-        if (!parsed)
-            throw new ConfigError(`Invalid ${name} value: ${value}`);
+        if (!parsed) {
+            const error = new ConfigError(`Invalid ${name} value: ${value}`);
+            throw error;
+        }
         return parsed;
     },
     allowedHosts(envValue) {
-        return new Set(EnvParser.list(envValue)
+        const hosts = new Set(EnvParser.list(envValue)
             .map((h) => EnvParser.normalizeHostValue(h))
             .filter((h) => h !== null));
+        return hosts;
     },
     optionalFilePath(value) {
         const trimmed = value?.trim();
@@ -303,7 +306,8 @@ function buildHttpsConfig() {
     const certFile = EnvParser.optionalFilePath(env['SERVER_TLS_CERT_FILE']);
     const caFile = EnvParser.optionalFilePath(env['SERVER_TLS_CA_FILE']);
     if ((keyFile && !certFile) || (!keyFile && certFile)) {
-        throw new ConfigError('Both SERVER_TLS_KEY_FILE and SERVER_TLS_CERT_FILE must be set together');
+        const error = new ConfigError('Both SERVER_TLS_KEY_FILE and SERVER_TLS_CERT_FILE must be set together');
+        throw error;
     }
     return {
         enabled: Boolean(keyFile && certFile),

package/dist/lib/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/lib/core.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAOjD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAYpE,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,UAAU,cAAc;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AA6BD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAKpD;AACD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,GAChB,IAAI,CAGN;AACD,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,IAAI,CAGN;AACD,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAKlE;AACD,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAO1E;AACD,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAEpB;AACD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,GAChB,MAAM,GAAG,SAAS,CAKpB;AACD,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,cAAc,EACvB,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAEH;AAID,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAGjD;AACD,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD;AACD,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AAqcD,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,WAAW,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAEN;AACD,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,WAAW,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAEN;AACD,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,WAAW,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAEN;AACD,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,WAAW,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAEN;AAcD,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,GAAG,WAAW,EAC3B,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAIN;AACD,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,GAAG,WAAW,EAC3B,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAIN;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAUnE;AACD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQhD;AACD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AA2KtB,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GACA,eAAe,CAOjB"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/lib/core.ts"],"names":[],"mappings":"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"}

package/dist/lib/core.js

@@ -3,6 +3,7 @@ import process from 'node:process';
 import { getSystemErrorMessage, inspect, stripVTControlCharacters, } from 'node:util';
 import {} from '@modelcontextprotocol/sdk/server/mcp.js';
 import { config } from './config.js';
+import { LOG_SESSION } from './logger-names.js';
 import { getErrorMessage, isAbortError, startAbortableIntervalLoop, } from './utils.js';
 export { config, enableHttpMode, serverVersion } from './config.js';
 const requestContext = new AsyncLocalStorage({
@@ -225,7 +226,8 @@ function formatMetadata(meta) {
     return ` ${inspect(merged, { breakLength: Infinity, colors: false, compact: true, sorted: true })}`;
 }
 function createTimestamp() {
-    return new Date().toISOString();
+    const now = new Date();
+    return now.toISOString();
 }
 function formatLogEntry(level, message, meta, logger) {
     if (config.logging.format === 'json') {
@@ -511,12 +513,12 @@ function getCleanupIntervalMs(sessionTtlMs) {
 function handleSessionCleanupError(error) {
     if (isAbortError(error))
         return;
-    logWarn('Session cleanup loop failed', { error: getErrorMessage(error) }, 'session');
+    logWarn('Session cleanup loop failed', { error: getErrorMessage(error) }, LOG_SESSION);
 }
 function logRejectedSettledResults(results, message) {
     for (const result of results) {
         if (result.status === 'rejected') {
-            logWarn(message, { error: getErrorMessage(result.reason) }, 'session');
+            logWarn(message, { error: getErrorMessage(result.reason) }, LOG_SESSION);
         }
     }
 }
@@ -556,7 +558,7 @@ class SessionCleanupLoop {
             logInfo('Expired sessions evicted', {
                 evicted: evicted.length,
                 timestamp: new Date(now).toISOString(),
-            }, 'session');
+            }, LOG_SESSION);
         }
     }
     async closeExpiredSession(sessionId, session) {
@@ -567,7 +569,7 @@ class SessionCleanupLoop {
             catch (error) {
                 logWarn('Expired session pre-close hook failed', {
                     error: getErrorMessage(error),
-                }, 'session');
+                }, LOG_SESSION);
             }
         }
         const closePromise = Promise.allSettled([
@@ -596,7 +598,7 @@ class SessionCleanupLoop {
         catch (error) {
             logWarn('Session close operation failed or timed out', {
                 error: getErrorMessage(error),
-            }, 'session');
+            }, LOG_SESSION);
         }
         finally {
             if (timeoutId) {
@@ -609,7 +611,7 @@ class SessionCleanupLoop {
         catch (error) {
             logWarn('Failed to unregister session server', {
                 error: getErrorMessage(error),
-            }, 'session');
+            }, LOG_SESSION);
         }
     }
     logCloseFailure(target, error) {
@@ -617,9 +619,10 @@ class SessionCleanupLoop {
             return;
         logWarn(`Failed to close expired session ${target}`, {
             error: getErrorMessage(error),
-        }, 'session');
+        }, LOG_SESSION);
     }
 }
 export function startSessionCleanupLoop(store, sessionTtlMs, options) {
-    return new SessionCleanupLoop(store, sessionTtlMs, options?.onEvictSession, options?.cleanupIntervalMs).start();
+    const loop = new SessionCleanupLoop(store, sessionTtlMs, options?.onEvictSession, options?.cleanupIntervalMs);
+    return loop.start();
 }

package/dist/lib/error-codes.d.ts

@@ -0,0 +1,11 @@
+export declare const EBLOCKED = "EBLOCKED";
+export declare const ETIMEOUT = "ETIMEOUT";
+export declare const EINVAL = "EINVAL";
+export declare const ENODATA = "ENODATA";
+export declare const EBADREDIRECT = "EBADREDIRECT";
+export declare const EUNSUPPORTEDPROTOCOL = "EUNSUPPORTEDPROTOCOL";
+export declare const FETCH_ERROR = "FETCH_ERROR";
+export declare const ABORTED = "ABORTED";
+export declare const QUEUE_FULL = "queue_full";
+export declare const VALIDATION_ERROR = "VALIDATION_ERROR";
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/lib/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/lib/error-codes.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,MAAM,WAAW,CAAC;AAC/B,eAAO,MAAM,OAAO,YAAY,CAAC;AAGjC,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAC3C,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAG3D,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,OAAO,YAAY,CAAC;AACjC,eAAO,MAAM,UAAU,eAAe,CAAC;AAGvC,eAAO,MAAM,gBAAgB,qBAAqB,CAAC"}

package/dist/lib/error-codes.js

@@ -0,0 +1,15 @@
+// ── Error codes ────────────────────────────────
+// DNS / network resolution
+export const EBLOCKED = 'EBLOCKED';
+export const ETIMEOUT = 'ETIMEOUT';
+export const EINVAL = 'EINVAL';
+export const ENODATA = 'ENODATA';
+// HTTP redirect
+export const EBADREDIRECT = 'EBADREDIRECT';
+export const EUNSUPPORTEDPROTOCOL = 'EUNSUPPORTEDPROTOCOL';
+// Fetch pipeline
+export const FETCH_ERROR = 'FETCH_ERROR';
+export const ABORTED = 'ABORTED';
+export const QUEUE_FULL = 'queue_full';
+// Validation
+export const VALIDATION_ERROR = 'VALIDATION_ERROR';

package/dist/lib/error-messages.d.ts

@@ -0,0 +1,13 @@
+import { CodedError } from './utils.js';
+export declare function blockedIpError(target: string, reason: 'cloud-metadata' | 'private'): CodedError;
+export declare function blockedHostError(hostname: string): CodedError;
+export declare function blockedCnameError(hostname: string, cname: string): CodedError;
+export declare function dnsTimeoutError(hostname: string): CodedError;
+export declare function dnsNoResultsError(hostname: string): CodedError;
+export declare function invalidAddressFamilyError(hostname: string): CodedError;
+export declare function invalidHostnameError(): CodedError;
+export declare function invalidUrlError(): CodedError;
+export declare function invalidRedirectError(): CodedError;
+export declare function redirectCredentialsError(): CodedError;
+export declare function unsupportedProtocolError(protocol: string): CodedError;
+//# sourceMappingURL=error-messages.d.ts.map

package/dist/lib/error-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-messages.d.ts","sourceRoot":"","sources":["../../src/lib/error-messages.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIxC,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,UAAU,CAUZ;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAM7D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAM7E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAM5D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAM9D;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAMtE;AAED,wBAAgB,oBAAoB,IAAI,UAAU,CAGjD;AAED,wBAAgB,eAAe,IAAI,UAAU,CAG5C;AAID,wBAAgB,oBAAoB,IAAI,UAAU,CAGjD;AAED,wBAAgB,wBAAwB,IAAI,UAAU,CAMrD;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAMrE"}

package/dist/lib/error-messages.js

@@ -0,0 +1,51 @@
+import { EBADREDIRECT, EBLOCKED, EINVAL, ENODATA, ETIMEOUT, EUNSUPPORTEDPROTOCOL, } from './error-codes.js';
+import { CodedError } from './utils.js';
+// ── DNS / Network ──────────────────────────────────────────────────
+export function blockedIpError(target, reason) {
+    const detail = reason === 'cloud-metadata'
+        ? 'Cloud metadata endpoints are not allowed'
+        : 'Private IPs are not allowed';
+    const error = new CodedError(`Blocked IP range: ${target}. ${detail}`, EBLOCKED);
+    return error;
+}
+export function blockedHostError(hostname) {
+    const error = new CodedError(`Blocked host: ${hostname}. Internal hosts are not allowed`, EBLOCKED);
+    return error;
+}
+export function blockedCnameError(hostname, cname) {
+    const error = new CodedError(`Blocked DNS CNAME detected for ${hostname}: ${cname}`, EBLOCKED);
+    return error;
+}
+export function dnsTimeoutError(hostname) {
+    const error = new CodedError(`DNS lookup timed out for ${hostname}`, ETIMEOUT);
+    return error;
+}
+export function dnsNoResultsError(hostname) {
+    const error = new CodedError(`No DNS results returned for ${hostname}`, ENODATA);
+    return error;
+}
+export function invalidAddressFamilyError(hostname) {
+    const error = new CodedError(`Invalid address family returned for ${hostname}`, EINVAL);
+    return error;
+}
+export function invalidHostnameError() {
+    const error = new CodedError('Invalid hostname provided', EINVAL);
+    return error;
+}
+export function invalidUrlError() {
+    const error = new CodedError('Invalid URL', EINVAL);
+    return error;
+}
+// ── HTTP Redirect ──────────────────────────────────────────────────
+export function invalidRedirectError() {
+    const error = new CodedError('Invalid redirect target', EBADREDIRECT);
+    return error;
+}
+export function redirectCredentialsError() {
+    const error = new CodedError('Redirect target includes credentials', EBADREDIRECT);
+    return error;
+}
+export function unsupportedProtocolError(protocol) {
+    const error = new CodedError(`Unsupported redirect protocol: ${protocol}`, EUNSUPPORTEDPROTOCOL);
+    return error;
+}

package/dist/lib/fetch-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-pipeline.d.ts","sourceRoot":"","sources":["../../src/lib/fetch-pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAOrE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,UAAU,EAAE,CAAC;AAGtB,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AACD,UAAU,mBAAmB;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAmGD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,MAAM,GAAG,SAAS,CAQpB;AAyBD,UAAU,oBAAoB,CAAC,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,SAAS,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACxE;AACD,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC;IACR,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,cAAc,GACd,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,CAAC;AAmBtB,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAiD5B;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAwBF,eAAO,MAAM,iBAAiB,GAC5B,OAAO,mBAAmB,EAC1B,KAAK,MAAM,EACX,SAAS,WAAW,KACnB,OAAO,CAAC,sBAAsB,CAchC,CAAC;AAEF,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,CAClB,KAAK,EAAE,mBAAmB,EAC1B,aAAa,EAAE,MAAM,KAClB,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC/D;AACD,UAAU,eAAe;IACvB,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,oBAAoB,CAAC;CAC7D;AAMD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC;IACT,QAAQ,EAAE,cAAc,CAAC,sBAAsB,CAAC,CAAC;IACjD,YAAY,EAAE,mBAAmB,CAAC;CACnC,CAAC,CAyBD"}
+{"version":3,"file":"fetch-pipeline.d.ts","sourceRoot":"","sources":["../../src/lib/fetch-pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAQrE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,UAAU,EAAE,CAAC;AAGtB,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AACD,UAAU,mBAAmB;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAmGD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,MAAM,GAAG,SAAS,CAQpB;AAyBD,UAAU,oBAAoB,CAAC,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,SAAS,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACxE;AACD,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC;IACR,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,cAAc,GACd,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,CAAC;AAmBtB,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAiD5B;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAwBF,eAAO,MAAM,iBAAiB,GAC5B,OAAO,mBAAmB,EAC1B,KAAK,MAAM,EACX,SAAS,WAAW,KACnB,OAAO,CAAC,sBAAsB,CAchC,CAAC;AAEF,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,CAClB,KAAK,EAAE,mBAAmB,EAC1B,aAAa,EAAE,MAAM,KAClB,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC/D;AACD,UAAU,eAAe;IACvB,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,oBAAoB,CAAC;CAC7D;AAMD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC;IACT,QAAQ,EAAE,cAAc,CAAC,sBAAsB,CAAC,CAAC;IACjD,YAAY,EAAE,mBAAmB,CAAC;CACnC,CAAC,CAyBD"}

package/dist/lib/fetch-pipeline.js

@@ -2,6 +2,7 @@ import { transformBufferToMarkdown } from '../transform/transform.js';
 import {} from '../transform/types.js';
 import { config, logDebug } from './core.js';
 import { fetchNormalizedUrlBuffer, normalizeUrl, transformToRawUrl, } from './http.js';
+import { LOG_FETCH } from './logger-names.js';
 import { withSignal } from './utils.js';
 export { withSignal };
 const TRUNCATION_MARKER = '...[truncated]';
@@ -116,16 +117,16 @@ export async function executeFetchPipeline(options) {
     if (resolvedUrl.transformed) {
         logDebug('Using transformed raw content URL', {
             original: resolvedUrl.originalUrl,
-        }, 'fetch');
+        }, LOG_FETCH);
     }
     options.onStage?.('fetch_remote');
-    logDebug('Fetching URL', { url: resolvedUrl.normalizedUrl }, 'fetch');
+    logDebug('Fetching URL', { url: resolvedUrl.normalizedUrl }, LOG_FETCH);
     const { buffer, encoding, truncated, finalUrl } = await fetchNormalizedUrlBuffer(resolvedUrl.normalizedUrl, withSignal(options.signal));
     if (finalUrl && finalUrl !== resolvedUrl.normalizedUrl) {
         logDebug('Fetch redirected', {
             fromUrl: resolvedUrl.normalizedUrl,
             toUrl: finalUrl,
-        }, 'fetch');
+        }, LOG_FETCH);
     }
     options.onStage?.('response_ready');
     options.onStage?.('transform_start');
@@ -177,7 +178,7 @@ export async function performSharedFetch(options, deps = {}) {
             url: pipeline.finalUrl ?? pipeline.url,
             contentSize: inlineResult.contentSize,
             maxInlineChars: config.constants.maxInlineContentChars,
-        }, 'fetch');
+        }, LOG_FETCH);
     }
     return { pipeline, inlineResult };
 }

package/dist/lib/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,EAAmB,MAAM,QAAQ,CAAC;AAYhD,OAAO,EAOL,KAAK,eAAe,EAGrB,MAAM,UAAU,CAAC;AAsvClB,UAAU,qBAAqB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAoKD,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA6ND,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE/C;AACD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAEA;AACD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AACD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAE9D;AACD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD;AACD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,qBAAqB,CAEvB;AACD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,QAAQ,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAEN;AACD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAEN;AACD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAE7D;AACD,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CASzC;AACD,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,CAEjB;AACD,wBAAsB,wBAAwB,CAC5C,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC;IACT,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAED"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,EAAmB,MAAM,QAAQ,CAAC;AAyBhD,OAAO,EAOL,KAAK,eAAe,EAErB,MAAM,UAAU,CAAC;AAkxClB,UAAU,qBAAqB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAoKD,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA6ND,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE/C;AACD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAEA;AACD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AACD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAE9D;AACD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD;AACD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,qBAAqB,CAEvB;AACD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,QAAQ,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAEN;AACD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAEN;AACD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAE7D;AACD,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CASzC;AACD,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,CAEjB;AACD,wBAAsB,wBAAwB,CAC5C,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC;IACT,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAED"}

package/dist/lib/http.js

@@ -8,9 +8,12 @@ import tls from 'node:tls';
 import { createBrotliDecompress, createGunzip, createInflate } from 'node:zlib';
 import { Agent } from 'undici';
 import { config, getOperationId, getRequestId, logDebug, logError, logWarn, redactUrl, } from './core.js';
+import { EBADREDIRECT, EBLOCKED, EINVAL, ENODATA, VALIDATION_ERROR, } from './error-codes.js';
+import { invalidRedirectError, redirectCredentialsError, unsupportedProtocolError, } from './error-messages.js';
+import { LOG_FETCH } from './logger-names.js';
 import { isIP } from './url.js';
-import { BLOCKED_HOST_SUFFIXES, createDnsPreflight, IpBlocker, RawUrlTransformer, SafeDnsResolver, UrlNormalizer, VALIDATION_ERROR_CODE, } from './url.js';
-import { composeAbortSignal, createErrorWithCode, FetchError, isAbortError, isError, isObject, isSystemError, toError, } from './utils.js';
+import { BLOCKED_HOST_SUFFIXES, createDnsPreflight, IpBlocker, RawUrlTransformer, SafeDnsResolver, UrlNormalizer, } from './url.js';
+import { composeAbortSignal, FetchError, isAbortError, isError, isObject, isSystemError, toError, } from './utils.js';
 // ═══════════════════════════════════════════════════════════════════
 // ENCODING DETECTION
 // ═══════════════════════════════════════════════════════════════════
@@ -234,9 +237,10 @@ function isBinaryContent(buffer, encoding) {
     return hasNullByte(buffer, BINARY_SCAN_LIMIT);
 }
 function createBinaryContentError(url) {
-    return new FetchError('Binary content detected', url, 500, {
+    const error = new FetchError('Binary content detected', url, 500, {
         reason: 'binary_content_detected',
     });
+    return error;
 }
 // ═══════════════════════════════════════════════════════════════════
 // FETCH ERRORS
@@ -259,32 +263,50 @@ function parseRetryAfter(header) {
 }
 function createFetchError(input, url) {
     switch (input.kind) {
-        case 'canceled':
-            return new FetchError('Request canceled', url, 499, {
+        case 'canceled': {
+            const error = new FetchError('Request canceled', url, 499, {
                 reason: 'aborted',
             });
-        case 'aborted':
-            return new FetchError('Request aborted during response read', url, 499, {
+            return error;
+        }
+        case 'aborted': {
+            const error = new FetchError('Request aborted during response read', url, 499, {
                 reason: 'aborted',
             });
-        case 'timeout':
-            return new FetchError(`Request timed out after ${input.timeout}ms`, url, 504, { timeout: input.timeout });
-        case 'rate-limited':
-            return new FetchError('Too many requests', url, 429, {
+            return error;
+        }
+        case 'timeout': {
+            const error = new FetchError(`Request timed out after ${input.timeout}ms`, url, 504, { timeout: input.timeout });
+            return error;
+        }
+        case 'rate-limited': {
+            const error = new FetchError('Too many requests', url, 429, {
                 retryAfter: parseRetryAfter(input.retryAfter),
             });
-        case 'http':
-            return new FetchError(`HTTP ${input.status}: ${input.statusText}`, url, input.status);
-        case 'too-many-redirects':
-            return new FetchError('Too many redirects', url);
-        case 'missing-redirect-location':
-            return new FetchError('Redirect missing Location header', url);
-        case 'network':
-            return new FetchError('Network error', url, undefined, {
+            return error;
+        }
+        case 'http': {
+            const error = new FetchError(`HTTP ${input.status}: ${input.statusText}`, url, input.status);
+            return error;
+        }
+        case 'too-many-redirects': {
+            const error = new FetchError('Too many redirects', url);
+            return error;
+        }
+        case 'missing-redirect-location': {
+            const error = new FetchError('Redirect missing Location header', url);
+            return error;
+        }
+        case 'network': {
+            const error = new FetchError('Network error', url, undefined, {
                 message: input.message,
             });
-        case 'unknown':
-            return new FetchError(input.message ?? 'Unexpected error', url);
+            return error;
+        }
+        case 'unknown': {
+            const error = new FetchError(input.message ?? 'Unexpected error', url);
+            return error;
+        }
         default: {
             const _exhaustive = input;
             return _exhaustive;
@@ -303,11 +325,11 @@ function resolveErrorUrl(error, fallback) {
     return typeof requestUrl === 'string' ? requestUrl : fallback;
 }
 const CLIENT_ERROR_CODES = new Set([
-    VALIDATION_ERROR_CODE,
-    'EBADREDIRECT',
-    'EBLOCKED',
-    'ENODATA',
-    'EINVAL',
+    VALIDATION_ERROR,
+    EBADREDIRECT,
+    EBLOCKED,
+    ENODATA,
+    EINVAL,
 ]);
 function mapAbortError(error, timeoutMs, url) {
     return isTimeoutError(error)
@@ -317,10 +339,12 @@ function mapAbortError(error, timeoutMs, url) {
 function mapSystemError(error, url) {
     const { code, message } = error;
     if (code === 'ETIMEOUT') {
-        return new FetchError(message, url, 504, { code });
+        const fetchError = new FetchError(message, url, 504, { code });
+        return fetchError;
     }
     if (code && CLIENT_ERROR_CODES.has(code)) {
-        return new FetchError(message, url, 400, { code });
+        const fetchError = new FetchError(message, url, 400, { code });
+        return fetchError;
     }
     return createFetchError({ kind: 'network', message }, url);
 }
@@ -360,7 +384,7 @@ class MaxBytesError extends Error {
 }
 function createPinnedAgent(ipAddress) {
     const ca = tls.rootCertificates.length > 0 ? tls.rootCertificates : undefined;
-    return new Agent({
+    const agent = new Agent({
         connect: {
             lookup: (hostname, options, callback) => {
                 const family = isIP(ipAddress) === 6 ? 6 : 4;
@@ -379,6 +403,7 @@ function createPinnedAgent(ipAddress) {
         keepAliveTimeout: 1000,
         keepAliveMaxTimeout: 1000,
     });
+    return agent;
 }
 class RedirectFollower {
     fetchFn;
@@ -463,10 +488,10 @@ class RedirectFollower {
     resolveRedirectTarget(baseUrl, location) {
         const resolved = URL.parse(location, baseUrl);
         if (!resolved) {
-            throw createErrorWithCode('Invalid redirect target', 'EBADREDIRECT');
+            throw invalidRedirectError();
         }
         if (resolved.username || resolved.password) {
-            throw createErrorWithCode('Redirect target includes credentials', 'EBADREDIRECT');
+            throw redirectCredentialsError();
         }
         return this.normalizeUrl(resolved.href);
     }
@@ -478,7 +503,7 @@ class RedirectFollower {
     assertHttpProtocol(url) {
         const parsed = new URL(url);
         if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
-            throw createErrorWithCode(`Unsupported redirect protocol: ${parsed.protocol}`, 'EUNSUPPORTEDPROTOCOL');
+            throw unsupportedProtocolError(parsed.protocol);
         }
     }
     async withRedirectErrorContext(url, fn) {
@@ -542,11 +567,12 @@ function assertSupportedContentType(contentType, url) {
     if (!mediaType) {
         logDebug('No Content-Type header; relying on binary-content detection', {
             url: redactUrl(url),
-        }, 'fetch');
+        }, LOG_FETCH);
         return;
     }
     if (!isTextLikeMediaType(mediaType)) {
-        throw new FetchError(`Unsupported content type: ${mediaType}`, url);
+        const error = new FetchError(`Unsupported content type: ${mediaType}`, url);
+        throw error;
     }
 }
 function extractEncodingTokens(value) {
@@ -567,10 +593,11 @@ function isSupportedContentEncoding(encoding) {
     return encoding === 'gzip' || encoding === 'deflate' || encoding === 'br';
 }
 function createUnsupportedContentEncodingError(url, encodingHeader) {
-    return new FetchError(`Unsupported Content-Encoding: ${encodingHeader}`, url, 415, {
+    const error = new FetchError(`Unsupported Content-Encoding: ${encodingHeader}`, url, 415, {
         reason: 'unsupported_content_encoding',
         encoding: encodingHeader,
     });
+    return error;
 }
 function createDecompressor(encoding) {
     const options = { chunkSize: 64 * 1024 };
@@ -584,7 +611,7 @@ function createDecompressor(encoding) {
     }
 }
 function createPumpedStream(initialChunk, reader) {
-    return new ReadableStream({
+    const stream = new ReadableStream({
         start(controller) {
             if (initialChunk && initialChunk.byteLength > 0) {
                 controller.enqueue(initialChunk);
@@ -608,6 +635,7 @@ function createPumpedStream(initialChunk, reader) {
             void reader.cancel(reason).catch(() => undefined);
         },
     });
+    return stream;
 }
 function buildDecodePipeline(body, encodings, url, response, signal) {
     const decodeOrder = encodings.slice().reverse();
@@ -662,11 +690,12 @@ async function primeDecodedResponse(pipe, response, url, signal) {
         const first = await pipe.decodedReader.read();
         if (first.done) {
             clearAbortListener();
-            return new Response(null, {
+            const result = new Response(null, {
                 status: response.status,
                 statusText: response.statusText,
                 headers: pipe.headers,
             });
+            return result;
         }
         const body = createPumpedStream(first.value, pipe.decodedReader);
         if (signal) {
@@ -676,17 +705,19 @@ async function primeDecodedResponse(pipe, response, url, signal) {
                 clearAbortListener();
             });
         }
-        return new Response(body, {
+        const result = new Response(body, {
             status: response.status,
             statusText: response.statusText,
             headers: pipe.headers,
         });
+        return result;
     }
     catch (error) {
         clearAbortListener();
         pipe.cleanup();
         void pipe.decodedReader.cancel(error).catch(() => undefined);
-        throw new FetchError(`Content-Encoding decode failed for ${redactUrl(url)}: ${isError(error) ? error.message : String(error)}`, url);
+        const fetchError = new FetchError(`Content-Encoding decode failed for ${redactUrl(url)}: ${isError(error) ? error.message : String(error)}`, url);
+        throw fetchError;
     }
 }
 async function decodeResponseIfNeeded(response, url, signal) {
@@ -786,7 +817,8 @@ class ResponseTextReader {
                         total += remaining;
                         yield slice;
                     }
-                    throw new MaxBytesError();
+                    const error = new MaxBytesError();
+                    throw error;
                 }
                 total = newTotal;
                 yield buf;
@@ -866,10 +898,11 @@ function isReadableStreamLike(value) {
 function assertReadableStreamLike(stream, url, stage) {
     if (isReadableStreamLike(stream))
         return;
-    throw new FetchError('Invalid response stream', url, 500, {
+    const error = new FetchError('Invalid response stream', url, 500, {
         reason: 'invalid_stream',
         stage,
     });
+    throw error;
 }
 function toNodeReadableStream(stream, url, stage) {
     assertReadableStreamLike(stream, url, stage);

package/dist/lib/logger-names.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Logger names for different components of the application.
+ */
+export declare const LOG_AUTH = "auth";
+export declare const LOG_HTTP = "http";
+export declare const LOG_SESSION = "session";
+export declare const LOG_SERVER = "server";
+export declare const LOG_FETCH = "fetch";
+export declare const LOG_TRANSFORM = "transform";
+export declare const LOG_TASKS = "tasks";
+export declare const LOG_RATE_LIMIT = "rate-limit";
+export declare const LOG_MCP = "mcp";
+export declare const LOG_FETCH_URL = "fetch-url";
+//# sourceMappingURL=logger-names.d.ts.map

package/dist/lib/logger-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-names.d.ts","sourceRoot":"","sources":["../../src/lib/logger-names.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,QAAQ,SAAS,CAAC;AAC/B,eAAO,MAAM,QAAQ,SAAS,CAAC;AAC/B,eAAO,MAAM,WAAW,YAAY,CAAC;AACrC,eAAO,MAAM,UAAU,WAAW,CAAC;AACnC,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,eAAO,MAAM,aAAa,cAAc,CAAC;AACzC,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,eAAO,MAAM,cAAc,eAAe,CAAC;AAC3C,eAAO,MAAM,OAAO,QAAQ,CAAC;AAC7B,eAAO,MAAM,aAAa,cAAc,CAAC"}

package/dist/lib/logger-names.js

@@ -0,0 +1,13 @@
+/**
+ * Logger names for different components of the application.
+ */
+export const LOG_AUTH = 'auth';
+export const LOG_HTTP = 'http';
+export const LOG_SESSION = 'session';
+export const LOG_SERVER = 'server';
+export const LOG_FETCH = 'fetch';
+export const LOG_TRANSFORM = 'transform';
+export const LOG_TASKS = 'tasks';
+export const LOG_RATE_LIMIT = 'rate-limit';
+export const LOG_MCP = 'mcp';
+export const LOG_FETCH_URL = 'fetch-url';

package/dist/lib/mcp-interop.d.ts

@@ -1,5 +1,5 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { type CallToolResult, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { McpError } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod';
 export declare function createMcpError(code: number, message: string, data?: unknown): McpError;
 export type JsonRpcId = string | number | null;
@@ -53,16 +53,6 @@ export declare function isJsonRpcResponseBody(body: unknown): body is JsonRpcRes
 export declare function isMcpMessageBody(body: unknown): body is JsonRpcMessageBody;
 export declare function acceptsEventStream(header: string | null | undefined): boolean;
 export declare function acceptsJsonAndEventStream(header: string | null | undefined): boolean;
-type ToolErrorResponse = CallToolResult & {
-    isError: true;
-};
-export declare function createToolErrorResponse(message: string, url: string, extra?: {
-    code?: string | number;
-    statusCode?: number;
-    details?: Record<string, unknown>;
-    data?: unknown;
-}): ToolErrorResponse;
-export declare function handleToolError(error: unknown, url: string, fallbackMessage?: string): ToolErrorResponse;
 type CleanupCallback = () => void;
 type RequestHandlerFn = (request: unknown, extra?: unknown) => Promise<unknown>;
 interface ToolPresentation {