@mapbox/mcp-server 0.5.4 → 0.6.1

package/dist/esm/tools/version-tool/VersionTool.output.schema.js

@@ -0,0 +1,12 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { z } from 'zod';
+// Schema for version tool output - matches the VersionInfo interface
+export const VersionResponseSchema = z.object({
+    name: z.string(),
+    version: z.string(),
+    sha: z.string(),
+    tag: z.string(),
+    branch: z.string()
+});
+//# sourceMappingURL=VersionTool.output.schema.js.map

package/dist/esm/tools/version-tool/VersionTool.output.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/version-tool/VersionTool.output.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC"}

package/dist/esm/{tools/directions-tool/formatIsoDateTime.d.ts → utils/dateUtils.d.ts}

@@ -5,4 +5,4 @@
  * Other valid formats are left unchanged.
  */
 export declare const formatIsoDateTime: (dateTime: string) => string;
-//# sourceMappingURL=formatIsoDateTime.d.ts.map
+//# sourceMappingURL=dateUtils.d.ts.map

package/dist/esm/utils/dateUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/dateUtils.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,MAWpD,CAAC"}

package/dist/esm/{tools/directions-tool/formatIsoDateTime.js → utils/dateUtils.js}

@@ -1,3 +1,5 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
 /**
  * Helper function to format ISO datetime strings according to Mapbox API requirements.
  * It converts the format YYYY-MM-DDThh:mm:ss (with seconds but no timezone) to
@@ -14,4 +16,4 @@ export const formatIsoDateTime = (dateTime) => {
     // Return unchanged if it's already in a valid format
     return dateTime;
 };
-//# sourceMappingURL=formatIsoDateTime.js.map
+//# sourceMappingURL=dateUtils.js.map

package/dist/esm/utils/dateUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateUtils.js","sourceRoot":"","sources":["../../../src/utils/dateUtils.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAU,EAAE;IAC5D,+EAA+E;IAC/E,MAAM,mBAAmB,GAAG,uCAAuC,CAAC;IAEpE,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,4DAA4D;QAC5D,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,qDAAqD;IACrD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/esm/utils/httpPipeline.d.ts

@@ -0,0 +1,39 @@
+import { type HttpRequest } from './types.js';
+export interface HttpPolicy {
+    id: string;
+    handle(input: string | URL | Request, init: RequestInit, next: HttpRequest): Promise<Response>;
+}
+export declare class HttpPipeline {
+    private policies;
+    private httpRequestImpl;
+    constructor(httpRequestImpl?: HttpRequest);
+    usePolicy(policy: HttpPolicy): void;
+    removePolicy(policyOrId: HttpPolicy | string): void;
+    findPolicyById(id: string): HttpPolicy | undefined;
+    listPolicies(): HttpPolicy[];
+    execute(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+}
+export declare class UserAgentPolicy implements HttpPolicy {
+    private userAgent;
+    id: string;
+    constructor(userAgent: string, id?: string);
+    handle(input: string | URL | Request, init: RequestInit, next: HttpRequest): Promise<Response>;
+    static fromVersionInfo(versionInfo: {
+        name: string;
+        version: string;
+        sha: string;
+        tag: string;
+        branch: string;
+    }, id?: string): UserAgentPolicy;
+}
+export declare class RetryPolicy implements HttpPolicy {
+    private maxRetries;
+    private baseDelayMs;
+    private maxDelayMs;
+    id: string;
+    constructor(maxRetries?: number, baseDelayMs?: number, maxDelayMs?: number, id?: string);
+    handle(input: string | URL | Request, init: RequestInit, next: HttpRequest): Promise<Response>;
+}
+export declare const httpRequest: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export declare const systemHttpPipeline: HttpPipeline;
+//# sourceMappingURL=httpPipeline.d.ts.map

package/dist/esm/utils/httpPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpPipeline.d.ts","sourceRoot":"","sources":["../../../src/utils/httpPipeline.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CACJ,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,eAAe,CAAc;gBAEzB,eAAe,CAAC,EAAE,WAAW;IAIzC,SAAS,CAAC,MAAM,EAAE,UAAU;IAI5B,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAQ5C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIlD,YAAY;IAIN,OAAO,CACX,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,QAAQ,CAAC;CAkBrB;AAED,qBAAa,eAAgB,YAAW,UAAU;IAI9C,OAAO,CAAC,SAAS;IAHnB,EAAE,EAAE,MAAM,CAAC;gBAGD,SAAS,EAAE,MAAM,EACzB,EAAE,CAAC,EAAE,MAAM;IAIP,MAAM,CACV,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC;IAmBpB,MAAM,CAAC,eAAe,CACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;KAChB,EACD,EAAE,CAAC,EAAE,MAAM,GACV,eAAe;CAInB;AAED,qBAAa,WAAY,YAAW,UAAU;IAI1C,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,UAAU;IALpB,EAAE,EAAE,MAAM,CAAC;gBAGD,UAAU,GAAE,MAAU,EACtB,WAAW,GAAE,MAAY,EACzB,UAAU,GAAE,MAAa,EACjC,EAAE,CAAC,EAAE,MAAM;IAKP,MAAM,CACV,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC;CA2BrB;AASD,eAAO,MAAM,WAAW,UAzHb,MAAM,GAAG,GAAG,GAAG,OAAO,SACvB,WAAW,KAChB,OAAO,CAAC,QAAQ,CAuHqC,CAAC;AAC3D,eAAO,MAAM,kBAAkB,cAAW,CAAC"}

package/dist/esm/utils/{fetchRequest.js → httpPipeline.js}

@@ -1,12 +1,14 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
 import { getVersionInfo } from './versionUtils.js';
 function createRandomId(prefix) {
     return `${prefix}${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
 }
-export class PolicyPipeline {
+export class HttpPipeline {
     policies = [];
-    fetchImpl;
-    constructor(fetchImpl) {
-        this.fetchImpl = fetchImpl ?? fetch;
+    httpRequestImpl;
+    constructor(httpRequestImpl) {
+        this.httpRequestImpl = httpRequestImpl ?? fetch;
     }
     usePolicy(policy) {
         this.policies.push(policy);
@@ -25,12 +27,12 @@ export class PolicyPipeline {
     listPolicies() {
         return this.policies;
     }
-    async fetch(input, init = {}) {
+    async execute(input, init = {}) {
         const dispatch = async (i, req, options) => {
             if (i < this.policies.length) {
-                return this.policies[i].handle(req, options, (nextReq, nextOptions) => dispatch(i + 1, nextReq, nextOptions));
+                return this.policies[i].handle(req, options, (nextReq, nextOptions) => dispatch(i + 1, nextReq, nextOptions || {}));
             }
-            return this.fetchImpl(req, options); // Use injected fetch
+            return this.httpRequestImpl(req, options); // Use injected httpRequest
         };
         return dispatch(0, input, init);
     }
@@ -95,10 +97,10 @@ export class RetryPolicy {
         return lastError;
     }
 }
-const pipeline = new PolicyPipeline();
+const pipeline = new HttpPipeline();
 const versionInfo = getVersionInfo();
 pipeline.usePolicy(UserAgentPolicy.fromVersionInfo(versionInfo, 'system-user-agent-policy'));
 pipeline.usePolicy(new RetryPolicy(3, 200, 2000, 'system-retry-policy'));
-export const fetchClient = pipeline.fetch.bind(pipeline);
-export const systemFetchPipeline = pipeline;
-//# sourceMappingURL=fetchRequest.js.map
+export const httpRequest = pipeline.execute.bind(pipeline);
+export const systemHttpPipeline = pipeline;
+//# sourceMappingURL=httpPipeline.js.map

package/dist/esm/utils/httpPipeline.js.map

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

package/dist/esm/utils/tracing.d.ts

@@ -0,0 +1,99 @@
+import { type Span } from '@opentelemetry/api';
+import { type HttpRequest } from './types.js';
+/**
+ * Tool execution context providing dependencies via options bag pattern
+ */
+export interface LocalToolExecutionContext {
+    span: Span;
+    tracingContext: {
+        parentSpan?: Span;
+        sessionId?: string;
+        userId?: string;
+        accountId?: string;
+        chatSessionId?: string;
+        promptId?: string;
+    };
+    extra?: Record<string, unknown>;
+}
+/**
+ * Tool execution context providing dependencies via options bag pattern
+ */
+export interface ToolExecutionContext {
+    span: Span;
+    tracingContext: {
+        parentSpan?: Span;
+        sessionId?: string;
+        userId?: string;
+        accountId?: string;
+        chatSessionId?: string;
+        promptId?: string;
+    };
+    httpRequest: HttpRequest;
+    extra?: Record<string, unknown>;
+}
+/**
+ * Create a tool execution context with all necessary dependencies
+ */
+export declare function createLocalToolExecutionContext(toolName: string, inputSize: number, extra?: Record<string, unknown>): LocalToolExecutionContext;
+/**
+ * Create a tool execution context with all necessary dependencies
+ */
+export declare function createToolExecutionContext(toolName: string, inputSize: number, httpRequest: HttpRequest, extra?: Record<string, unknown>): ToolExecutionContext;
+/**
+ * Initialize OpenTelemetry tracing
+ * Should be called once at application startup
+ *
+ * For MCP servers using stdio transport, console output should be avoided.
+ * This implementation automatically detects and handles MCP compatibility.
+ */
+export declare function initializeTracing(): Promise<void>;
+/**
+ * Shutdown tracing gracefully
+ */
+export declare function shutdownTracing(): Promise<void>;
+/**
+ * Check if tracing is enabled
+ */
+export declare function isTracingInitialized(): boolean;
+/**
+ * Get the default tracer for the MCP server
+ */
+export declare function getTracer(): import("@opentelemetry/api").Tracer;
+/**
+ * Create a span for tool execution with comprehensive attributes
+ */
+export declare function createToolSpan(toolName: string, inputSize: number, extra?: {
+    sessionId?: string;
+    userId?: string;
+    accountId?: string;
+    chatSessionId?: string;
+    promptId?: string;
+}): Span;
+/**
+ * Create a span for HTTP requests with comprehensive attributes
+ */
+export declare function createHttpSpan(method: string, url: string, extra?: {
+    userAgent?: string;
+    contentLength?: number;
+    sessionId?: string;
+}): Span;
+/**
+ * Mark a span as successful and end it
+ */
+export declare function markSpanSuccess(span: Span, attributes?: Record<string, string | number | boolean>): void;
+/**
+ * Mark a span as failed with error information and end it
+ */
+export declare function markSpanError(span: Span, error: Error | string, attributes?: Record<string, string | number | boolean>): void;
+/**
+ * Validate JWT token format for tracing (basic format check only)
+ */
+export declare function validateJwtForTracing(token?: string): {
+    isValid: boolean;
+    error?: string;
+};
+/**
+ * Helper function to get size of an object in bytes (approximate)
+ */
+export declare function getObjectSize(obj: unknown): number;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/esm/utils/tracing.d.ts.map

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

package/dist/esm/utils/tracing.js

@@ -0,0 +1,269 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
+import { Resource } from '@opentelemetry/resources';
+import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { trace, SpanStatusCode, SpanKind } from '@opentelemetry/api';
+import { getVersionInfo } from './versionUtils.js';
+import { ATTR_SERVICE_INSTANCE_ID } from '@opentelemetry/semantic-conventions/incubating';
+// Global SDK instance
+let sdk = null;
+let isTracingEnabled = false;
+/**
+ * Create a tool execution context with all necessary dependencies
+ */
+export function createLocalToolExecutionContext(toolName, inputSize, extra) {
+    const span = createToolSpan(toolName, inputSize, {
+        sessionId: extra?.sessionId,
+        userId: extra?.userId,
+        accountId: extra?.accountId,
+        chatSessionId: extra?.chatSessionId,
+        promptId: extra?.promptId
+    });
+    return {
+        span,
+        tracingContext: {
+            parentSpan: span,
+            sessionId: extra?.sessionId,
+            userId: extra?.userId,
+            accountId: extra?.accountId,
+            chatSessionId: extra?.chatSessionId,
+            promptId: extra?.promptId
+        },
+        extra
+    };
+}
+/**
+ * Create a tool execution context with all necessary dependencies
+ */
+export function createToolExecutionContext(toolName, inputSize, httpRequest, extra) {
+    const span = createToolSpan(toolName, inputSize, {
+        sessionId: extra?.sessionId,
+        userId: extra?.userId,
+        accountId: extra?.accountId,
+        chatSessionId: extra?.chatSessionId,
+        promptId: extra?.promptId
+    });
+    return {
+        span,
+        tracingContext: {
+            parentSpan: span,
+            sessionId: extra?.sessionId,
+            userId: extra?.userId,
+            accountId: extra?.accountId,
+            chatSessionId: extra?.chatSessionId,
+            promptId: extra?.promptId
+        },
+        httpRequest,
+        extra
+    };
+}
+/**
+ * Initialize OpenTelemetry tracing
+ * Should be called once at application startup
+ *
+ * For MCP servers using stdio transport, console output should be avoided.
+ * This implementation automatically detects and handles MCP compatibility.
+ */
+export async function initializeTracing() {
+    // Skip initialization if already initialized or if running in test environment
+    if (sdk || process.env.NODE_ENV === 'test' || process.env.VITEST) {
+        return;
+    }
+    // Skip if tracing is explicitly disabled
+    if (process.env.OTEL_TRACING_ENABLED === 'false') {
+        return;
+    }
+    const versionInfo = getVersionInfo();
+    try {
+        // Create resource with service information
+        const resource = new Resource({
+            [ATTR_SERVICE_NAME]: process.env.OTEL_SERVICE_NAME || versionInfo.name,
+            [ATTR_SERVICE_VERSION]: versionInfo.version,
+            [ATTR_SERVICE_INSTANCE_ID]: process.env.HOSTNAME || 'unknown',
+            'service.git.sha': versionInfo.sha,
+            'service.git.branch': versionInfo.branch,
+            'service.git.tag': versionInfo.tag
+        });
+        // Configure exporters
+        const exporters = [];
+        // Console exporter for development (avoid in stdio transport)
+        if (process.env.OTEL_EXPORTER_CONSOLE_ENABLED === 'true') {
+            const { ConsoleSpanExporter } = await import('@opentelemetry/sdk-trace-base');
+            exporters.push(new ConsoleSpanExporter());
+        }
+        // OTLP HTTP exporter for production
+        const otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+        if (otlpEndpoint) {
+            exporters.push(new OTLPTraceExporter({
+                url: `${otlpEndpoint}/v1/traces`,
+                headers: process.env.OTEL_EXPORTER_OTLP_HEADERS
+                    ? JSON.parse(process.env.OTEL_EXPORTER_OTLP_HEADERS)
+                    : {}
+            }));
+        }
+        // Skip tracing if no exporters configured
+        if (exporters.length === 0) {
+            return;
+        }
+        // Create SDK instance
+        sdk = new NodeSDK({
+            resource,
+            traceExporter: exporters[0],
+            instrumentations: [
+                getNodeAutoInstrumentations({
+                    // Disable instrumentations that might be too noisy
+                    '@opentelemetry/instrumentation-fs': {
+                        enabled: false
+                    },
+                    '@opentelemetry/instrumentation-dns': {
+                        enabled: false
+                    },
+                    // Ensure HTTP instrumentation is enabled for HTTP requests
+                    '@opentelemetry/instrumentation-http': {
+                        enabled: true
+                    },
+                    // Enable fetch instrumentation for HTTP requests
+                    '@opentelemetry/instrumentation-undici': {
+                        enabled: true
+                    }
+                })
+            ]
+        });
+        // Start the SDK
+        sdk.start();
+        isTracingEnabled = true;
+    }
+    catch {
+        // Silently handle initialization errors to avoid breaking MCP stdio
+        isTracingEnabled = false;
+    }
+}
+/**
+ * Shutdown tracing gracefully
+ */
+export async function shutdownTracing() {
+    if (sdk) {
+        await sdk.shutdown();
+        sdk = null;
+        isTracingEnabled = false;
+    }
+}
+/**
+ * Check if tracing is enabled
+ */
+export function isTracingInitialized() {
+    return isTracingEnabled;
+}
+/**
+ * Get the default tracer for the MCP server
+ */
+export function getTracer() {
+    return trace.getTracer('mapbox-mcp-server');
+}
+/**
+ * Create a span for tool execution with comprehensive attributes
+ */
+export function createToolSpan(toolName, inputSize, extra) {
+    const tracer = getTracer();
+    const span = tracer.startSpan(`tool.${toolName}`, {
+        kind: SpanKind.INTERNAL,
+        attributes: {
+            'tool.name': toolName,
+            'tool.input.size': inputSize,
+            'operation.type': 'tool_execution',
+            ...(extra?.sessionId && { 'session.id': extra.sessionId }),
+            ...(extra?.userId && { 'user.id': extra.userId }),
+            ...(extra?.accountId && { 'account.id': extra.accountId }),
+            ...(extra?.chatSessionId && { 'chat.session.id': extra.chatSessionId }),
+            ...(extra?.promptId && { 'prompt.id': extra.promptId })
+        }
+    });
+    return span;
+}
+/**
+ * Create a span for HTTP requests with comprehensive attributes
+ */
+export function createHttpSpan(method, url, extra) {
+    const tracer = getTracer();
+    const span = tracer.startSpan(`http.${method.toLowerCase()}`, {
+        kind: SpanKind.CLIENT,
+        attributes: {
+            'http.method': method,
+            'http.url': url,
+            'operation.type': 'http_request',
+            ...(extra?.userAgent && { 'http.user_agent': extra.userAgent }),
+            ...(extra?.contentLength && {
+                'http.request.content_length': extra.contentLength
+            }),
+            ...(extra?.sessionId && { 'session.id': extra.sessionId })
+        }
+    });
+    return span;
+}
+/**
+ * Mark a span as successful and end it
+ */
+export function markSpanSuccess(span, attributes) {
+    if (attributes) {
+        span.setAttributes(attributes);
+    }
+    span.setStatus({ code: SpanStatusCode.OK });
+    span.end();
+}
+/**
+ * Mark a span as failed with error information and end it
+ */
+export function markSpanError(span, error, attributes) {
+    const errorMessage = typeof error === 'string' ? error : error.message;
+    const errorType = typeof error === 'string' ? 'Error' : error.constructor.name;
+    span.setAttributes({
+        'error.type': errorType,
+        'error.message': errorMessage,
+        ...(attributes || {})
+    });
+    if (typeof error !== 'string') {
+        span.recordException(error);
+    }
+    span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: errorMessage
+    });
+    span.end();
+}
+/**
+ * Validate JWT token format for tracing (basic format check only)
+ */
+export function validateJwtForTracing(token) {
+    if (!token) {
+        return { isValid: true }; // No token is valid (optional)
+    }
+    // Basic JWT format validation (header.payload.signature)
+    const parts = token.split('.');
+    if (parts.length !== 3) {
+        return { isValid: false, error: 'Invalid JWT format' };
+    }
+    try {
+        // Try to decode the header and payload (just to validate base64 format)
+        JSON.parse(Buffer.from(parts[0], 'base64url').toString());
+        JSON.parse(Buffer.from(parts[1], 'base64url').toString());
+        return { isValid: true };
+    }
+    catch {
+        return { isValid: false, error: 'Invalid JWT encoding' };
+    }
+}
+/**
+ * Helper function to get size of an object in bytes (approximate)
+ */
+export function getObjectSize(obj) {
+    try {
+        return JSON.stringify(obj).length;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=tracing.js.map

package/dist/esm/utils/tracing.js.map

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

package/dist/esm/utils/types.d.ts

@@ -0,0 +1,18 @@
+import type { Span } from '@opentelemetry/api';
+/**
+ * Enhanced RequestInit with tracing context
+ */
+export interface TracedRequestInit extends RequestInit {
+    tracingContext?: {
+        parentSpan?: Span;
+        sessionId?: string;
+        userId?: string;
+    };
+}
+/**
+ * HttpRequest interface that includes tracing information
+ */
+export interface HttpRequest {
+    (input: string | URL | Request, init?: TracedRequestInit): Promise<Response>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,cAAc,CAAC,EAAE;QACf,UAAU,CAAC,EAAE,IAAI,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC9E"}

package/dist/esm/utils/types.js

@@ -0,0 +1,4 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC"}

package/dist/esm/utils/versionUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"versionUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/versionUtils.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,IAAI,WAAW,CA4C5C"}
+{"version":3,"file":"versionUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/versionUtils.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,IAAI,WAAW,CA4C5C"}

package/dist/esm/utils/versionUtils.js

@@ -1,3 +1,5 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
 import { readFileSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -8,7 +10,7 @@ export function getVersionInfo() {
         // @ts-ignore CJS build will fail with this line, but ESM needs it
         const dirname = path.dirname(fileURLToPath(import.meta.url));
         // Try to read from version.json first (for build artifacts)
-        const versionJsonPath = path.resolve(dirname, '..', '..', 'version.json');
+        const versionJsonPath = path.resolve(dirname, '..', 'version.json');
         try {
             const versionData = readFileSync(versionJsonPath, 'utf-8');
             const info = JSON.parse(versionData);

package/dist/esm/utils/versionUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"versionUtils.js","sourceRoot":"","sources":["../../../src/utils/versionUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAUzC,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAG,mBAAmB,CAAC;IACjC,IAAI,CAAC;QACH,gEAAgE;QAChE,kEAAkE;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAE7D,4DAA4D;QAC5D,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC1E,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAgB,CAAC;YACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;YAC5B,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAClC,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,cAAc,CACf,CAAC;YACF,MAAM,WAAW,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAE5C,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,OAAO;gBACvC,GAAG,EAAE,SAAS;gBACd,GAAG,EAAE,SAAS;gBACd,MAAM,EAAE,SAAS;aAClB,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;QACtD,OAAO;YACL,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,OAAO;YAChB,GAAG,EAAE,SAAS;YACd,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"versionUtils.js","sourceRoot":"","sources":["../../../src/utils/versionUtils.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAUzC,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAG,mBAAmB,CAAC;IACjC,IAAI,CAAC;QACH,gEAAgE;QAChE,kEAAkE;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAE7D,4DAA4D;QAC5D,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAgB,CAAC;YACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;YAC5B,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAClC,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,cAAc,CACf,CAAC;YACF,MAAM,WAAW,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAE5C,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,OAAO;gBACvC,GAAG,EAAE,SAAS;gBACd,GAAG,EAAE,SAAS;gBACd,MAAM,EAAE,SAAS;aAClB,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;QACtD,OAAO;YACL,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,OAAO;YAChB,GAAG,EAAE,SAAS;YACd,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/esm/version.json

@@ -1,6 +1,6 @@
 {
-  "sha": "b425c047efcc11d353b3c2ddfeb5419739fef31a",
-  "tag": "v0.5.3-2-gb425c04",
+  "sha": "4a101fdec2d4cbcea4badc6c407d83d6fcafd4cd",
+  "tag": "v0.5.5-5-g4a101fd",
   "branch": "main",
-  "version": "0.5.4"
+  "version": "0.6.1"
 }