@frontmcp/sdk 0.6.1 → 0.6.2

package/src/context/frontmcp-context.js

@@ -1,360 +0,0 @@
-"use strict";
-/**
- * FrontMcpContext - Unified context for FrontMCP
- *
- * Single point of truth for all request-related data, combining session and request state.
- * Flows through the entire async execution chain via AsyncLocalStorage.
- *
- * Access via DI using the FRONTMCP_CONTEXT token:
- * ```typescript
- * const ctx = this.get(FRONTMCP_CONTEXT);
- * console.log(ctx.requestId, ctx.sessionId, ctx.authInfo);
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Context = exports.FrontMcpContext = void 0;
-const node_crypto_1 = require("node:crypto");
-const trace_context_1 = require("./trace-context");
-const mcp_error_1 = require("../errors/mcp.error");
-/**
- * Session key validation rules.
- */
-const SESSION_KEY_MAX_LENGTH = 2048;
-const SESSION_KEY_VALID_PATTERN = /^[a-zA-Z0-9\-_.:]+$/;
-/**
- * Validate a session key string.
- *
- * @param value - The session key to validate
- * @throws InvalidInputError if validation fails
- */
-function validateSessionKey(value) {
-    if (!value || value.length === 0) {
-        throw new mcp_error_1.InvalidInputError('Session ID cannot be empty');
-    }
-    if (value.length > SESSION_KEY_MAX_LENGTH) {
-        throw new mcp_error_1.InvalidInputError(`Session ID exceeds maximum length of ${SESSION_KEY_MAX_LENGTH} characters`);
-    }
-    if (!SESSION_KEY_VALID_PATTERN.test(value)) {
-        throw new mcp_error_1.InvalidInputError('Session ID contains invalid characters. Allowed: alphanumeric, hyphen, underscore, period, colon');
-    }
-}
-/**
- * FrontMcpContext - Unified context for FrontMCP
- *
- * Provides a single point of truth for all request-related data:
- * - Identity: requestId, sessionId, scopeId
- * - Tracing: W3C trace context
- * - Auth: authentication information (progressively populated)
- * - References: transport, flow, scope (pointers, not copies)
- * - Store: key/value storage for context-scoped data
- * - Fetch: context-aware fetch with auto-injection
- */
-class FrontMcpContext {
-    // =====================
-    // Identity
-    // =====================
-    /** Unique request identifier (UUID v4) */
-    requestId;
-    /** Session identifier (validated) */
-    sessionId;
-    /** Scope identifier */
-    scopeId;
-    // =====================
-    // Tracing
-    // =====================
-    /** W3C Trace Context or generated trace ID */
-    traceContext;
-    /** Request start timestamp */
-    timestamp;
-    // =====================
-    // Configuration
-    // =====================
-    /** Context configuration */
-    config;
-    // =====================
-    // Metadata
-    // =====================
-    /** Request metadata (headers, user-agent, etc.) */
-    metadata;
-    // =====================
-    // Auth (mutable, progressively populated)
-    // =====================
-    _authInfo;
-    _sessionMetadata;
-    // =====================
-    // References (pointers)
-    // =====================
-    _transport;
-    _flow;
-    _scope;
-    // =====================
-    // Storage
-    // =====================
-    marks = new Map();
-    store = new Map();
-    constructor(args) {
-        // Validate session ID
-        validateSessionKey(args.sessionId);
-        this.requestId = args.requestId ?? (0, node_crypto_1.randomUUID)();
-        this.sessionId = args.sessionId;
-        this.scopeId = args.scopeId;
-        this.traceContext = args.traceContext ?? (0, trace_context_1.generateTraceContext)();
-        this.timestamp = args.timestamp ?? Date.now();
-        this._authInfo = args.authInfo ?? {};
-        // Configuration with defaults
-        this.config = {
-            autoInjectAuthHeaders: args.config?.autoInjectAuthHeaders ?? true,
-            autoInjectTracingHeaders: args.config?.autoInjectTracingHeaders ?? true,
-            requestTimeout: args.config?.requestTimeout ?? 30000,
-        };
-        // Defensive normalization: ensure customHeaders is always an object
-        const metadata = args.metadata;
-        this.metadata = {
-            ...metadata,
-            customHeaders: metadata?.customHeaders ?? {},
-        };
-        // Initial mark
-        this.marks.set('init', this.timestamp);
-    }
-    // =====================
-    // Auth Accessors
-    // =====================
-    /**
-     * Get authentication information.
-     * Returns Partial<AuthInfo> because auth info is progressively populated.
-     */
-    get authInfo() {
-        return this._authInfo;
-    }
-    /**
-     * Update auth info after authorization is verified.
-     * Can be called multiple times to progressively add fields.
-     *
-     * @param authInfo - The auth info fields to set/update
-     * @internal
-     */
-    updateAuthInfo(authInfo) {
-        this._authInfo = { ...this._authInfo, ...authInfo };
-    }
-    /**
-     * Get session metadata (protocol, platform type, node info).
-     * Only available after session verification.
-     */
-    get sessionMetadata() {
-        return this._sessionMetadata;
-    }
-    /**
-     * Update session metadata after session verification.
-     *
-     * @param metadata - Session metadata from verified session
-     * @internal
-     */
-    updateSessionMetadata(metadata) {
-        this._sessionMetadata = metadata;
-    }
-    // =====================
-    // Reference Accessors
-    // =====================
-    /**
-     * Get transport accessor for elicit support.
-     * Returns undefined if no transport is registered.
-     */
-    get transport() {
-        if (!this._transport)
-            return undefined;
-        const transportRef = this._transport;
-        return {
-            supportsElicit: true,
-            elicit: (message, schema) => transportRef.sendElicitRequest(message, schema),
-        };
-    }
-    /**
-     * Set transport reference (internal use).
-     * @internal
-     */
-    setTransport(transport) {
-        this._transport = transport;
-    }
-    /**
-     * Get current flow reference.
-     */
-    get flow() {
-        return this._flow;
-    }
-    /**
-     * Set flow reference (internal use).
-     * @internal
-     */
-    setFlow(flow) {
-        this._flow = flow;
-    }
-    /**
-     * Get scope reference.
-     */
-    get scope() {
-        return this._scope;
-    }
-    /**
-     * Set scope reference (internal use).
-     * @internal
-     */
-    setScope(scope) {
-        this._scope = scope;
-    }
-    // =====================
-    // Store Operations
-    // =====================
-    /**
-     * Store context-scoped data.
-     *
-     * @param key - Storage key
-     * @param value - Value to store
-     */
-    set(key, value) {
-        this.store.set(key, value);
-    }
-    /**
-     * Retrieve context-scoped data.
-     *
-     * @param key - Storage key
-     * @returns Stored value or undefined
-     */
-    get(key) {
-        return this.store.get(key);
-    }
-    /**
-     * Check if a key exists in the context store.
-     *
-     * @param key - Storage key
-     * @returns True if key exists
-     */
-    has(key) {
-        return this.store.has(key);
-    }
-    /**
-     * Delete a key from the context store.
-     *
-     * @param key - Storage key
-     * @returns True if key was deleted
-     */
-    delete(key) {
-        return this.store.delete(key);
-    }
-    // =====================
-    // Timing & Performance
-    // =====================
-    /**
-     * Mark a timing point for performance tracking.
-     *
-     * @param name - Name of the timing mark
-     */
-    mark(name) {
-        this.marks.set(name, Date.now());
-    }
-    /**
-     * Get elapsed time in milliseconds between two marks.
-     *
-     * @param from - Start mark name (defaults to 'init')
-     * @param to - End mark name (defaults to current time)
-     * @returns Elapsed time in milliseconds
-     */
-    elapsed(from, to) {
-        const fromTime = this.marks.get(from ?? 'init') ?? this.timestamp;
-        const toTime = to ? this.marks.get(to) ?? Date.now() : Date.now();
-        return toTime - fromTime;
-    }
-    /**
-     * Get all timing marks.
-     *
-     * @returns Read-only map of mark names to timestamps
-     */
-    getMarks() {
-        return this.marks;
-    }
-    // =====================
-    // Logging
-    // =====================
-    /**
-     * Get a child logger with context attached.
-     *
-     * Creates a child logger with a prefix containing the request ID and trace ID
-     * for easy request tracing in logs.
-     *
-     * @param parentLogger - The parent logger to create a child from
-     * @returns A logger with requestId and traceId in the prefix
-     */
-    getLogger(parentLogger) {
-        const prefix = `[${this.requestId.slice(0, 8)}:${this.traceContext.traceId.slice(0, 8)}]`;
-        return parentLogger.child(prefix);
-    }
-    /**
-     * Get a summary of the context for logging.
-     *
-     * Note: sessionId is hashed to prevent accidental exposure of user-identifying
-     * session identifiers in logs while still allowing correlation.
-     *
-     * @returns Object with key context fields
-     */
-    toLogContext() {
-        return {
-            requestId: this.requestId,
-            traceId: this.traceContext.traceId,
-            parentId: this.traceContext.parentId,
-            // Hash sessionId to prevent logging user-identifying information
-            sessionIdHash: (0, node_crypto_1.createHash)('sha256').update(this.sessionId).digest('hex').slice(0, 12),
-            scopeId: this.scopeId,
-            flowName: this._flow?.name,
-            elapsed: this.elapsed(),
-        };
-    }
-    // =====================
-    // Context-Aware Fetch
-    // =====================
-    /**
-     * Perform a fetch request with automatic header injection.
-     *
-     * Injects:
-     * - Authorization header (if authInfo.token is available and autoInjectAuthHeaders is true)
-     * - W3C traceparent header (if autoInjectTracingHeaders is true)
-     * - x-request-id header
-     * - Custom headers from request metadata
-     *
-     * @param input - Request URL or Request object
-     * @param init - Request options
-     * @returns Fetch response
-     */
-    async fetch(input, init) {
-        const headers = new Headers(init?.headers);
-        // Auto-inject auth headers
-        if (this.config.autoInjectAuthHeaders && this._authInfo.token) {
-            if (!headers.has('Authorization')) {
-                headers.set('Authorization', `Bearer ${this._authInfo.token}`);
-            }
-        }
-        // Auto-inject tracing headers
-        if (this.config.autoInjectTracingHeaders) {
-            if (!headers.has('traceparent')) {
-                headers.set('traceparent', this.traceContext.raw);
-            }
-            if (!headers.has('x-request-id')) {
-                headers.set('x-request-id', this.requestId);
-            }
-        }
-        // Inject custom headers from request metadata
-        for (const [key, value] of Object.entries(this.metadata.customHeaders)) {
-            if (!headers.has(key)) {
-                headers.set(key, value);
-            }
-        }
-        // Use AbortSignal.timeout if no signal provided
-        const signal = init?.signal ?? AbortSignal.timeout(this.config.requestTimeout ?? 30000);
-        return fetch(input, {
-            ...init,
-            headers,
-            signal,
-        });
-    }
-}
-exports.FrontMcpContext = FrontMcpContext;
-exports.Context = FrontMcpContext;
-//# sourceMappingURL=frontmcp-context.js.map

package/src/context/frontmcp-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"frontmcp-context.js","sourceRoot":"","sources":["../../../src/context/frontmcp-context.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FrontMcpContext - Unified context for FrontMCP\n *\n * Single point of truth for all request-related data, combining session and request state.\n * Flows through the entire async execution chain via AsyncLocalStorage.\n *\n * Access via DI using the FRONTMCP_CONTEXT token:\n * ```typescript\n * const ctx = this.get(FRONTMCP_CONTEXT);\n * console.log(ctx.requestId, ctx.sessionId, ctx.authInfo);\n * ```\n */\n\nimport { randomUUID, createHash } from 'node:crypto';\nimport { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';\nimport { FrontMcpLogger } from '../common/interfaces/logger.interface';\nimport { TraceContext, generateTraceContext } from './trace-context';\nimport type { SessionIdPayload } from '../common/types';\nimport { InvalidInputError } from '../errors/mcp.error';\n\n/**\n * Request metadata extracted from HTTP headers.\n */\nexport interface RequestMetadata {\n  /** User-Agent header */\n  userAgent?: string;\n  /** Content-Type header */\n  contentType?: string;\n  /** Accept header */\n  accept?: string;\n  /** Client IP address (from x-forwarded-for or socket) */\n  clientIp?: string;\n  /** Custom headers matching x-frontmcp-* pattern */\n  customHeaders: Record<string, string>;\n}\n\n/**\n * Configuration for the context.\n */\nexport interface FrontMcpContextConfig {\n  /** Auto-inject auth headers in fetch requests (default: true) */\n  autoInjectAuthHeaders?: boolean;\n  /** Auto-inject tracing headers in fetch requests (default: true) */\n  autoInjectTracingHeaders?: boolean;\n  /** Default fetch request timeout in milliseconds (default: 30000) */\n  requestTimeout?: number;\n}\n\n/**\n * Arguments for creating a FrontMcpContext.\n */\nexport interface FrontMcpContextArgs {\n  /** Optional request ID (generated if not provided) */\n  requestId?: string;\n  /** Optional trace context (generated if not provided) */\n  traceContext?: TraceContext;\n  /** Session identifier (required) */\n  sessionId: string;\n  /** Authentication information (can be partial, progressively populated) */\n  authInfo?: Partial<AuthInfo>;\n  /** Scope identifier (required) */\n  scopeId: string;\n  /** Optional timestamp (defaults to Date.now()) */\n  timestamp?: number;\n  /** Optional request metadata */\n  metadata?: RequestMetadata;\n  /** Optional configuration */\n  config?: FrontMcpContextConfig;\n}\n\n/**\n * Interface for transport access (elicit support).\n * Provides clean API for accessing transport capabilities.\n */\nexport interface TransportAccessor {\n  /**\n   * Check if transport supports elicit requests.\n   */\n  readonly supportsElicit: boolean;\n\n  /**\n   * Send an elicit request to the client for interactive input.\n   *\n   * @param message - Message to display to the user\n   * @param requestedSchema - Zod schema for validating the response\n   * @returns Typed elicit result with action and validated content\n   */\n  elicit<T>(message: string, requestedSchema: T): Promise<{ action: string; content: unknown }>;\n}\n\n// Forward declaration for type reference (avoid circular imports)\ntype FlowBaseRef = { readonly name: string };\ntype ScopeRef = { readonly id: string; readonly logger: FrontMcpLogger };\ntype TransportRef = { sendElicitRequest: TransportAccessor['elicit']; readonly type: string };\n\n/**\n * Session key validation rules.\n */\nconst SESSION_KEY_MAX_LENGTH = 2048;\nconst SESSION_KEY_VALID_PATTERN = /^[a-zA-Z0-9\\-_.:]+$/;\n\n/**\n * Validate a session key string.\n *\n * @param value - The session key to validate\n * @throws InvalidInputError if validation fails\n */\nfunction validateSessionKey(value: string): void {\n  if (!value || value.length === 0) {\n    throw new InvalidInputError('Session ID cannot be empty');\n  }\n  if (value.length > SESSION_KEY_MAX_LENGTH) {\n    throw new InvalidInputError(`Session ID exceeds maximum length of ${SESSION_KEY_MAX_LENGTH} characters`);\n  }\n  if (!SESSION_KEY_VALID_PATTERN.test(value)) {\n    throw new InvalidInputError(\n      'Session ID contains invalid characters. Allowed: alphanumeric, hyphen, underscore, period, colon',\n    );\n  }\n}\n\n/**\n * FrontMcpContext - Unified context for FrontMCP\n *\n * Provides a single point of truth for all request-related data:\n * - Identity: requestId, sessionId, scopeId\n * - Tracing: W3C trace context\n * - Auth: authentication information (progressively populated)\n * - References: transport, flow, scope (pointers, not copies)\n * - Store: key/value storage for context-scoped data\n * - Fetch: context-aware fetch with auto-injection\n */\nexport class FrontMcpContext {\n  // =====================\n  // Identity\n  // =====================\n\n  /** Unique request identifier (UUID v4) */\n  readonly requestId: string;\n\n  /** Session identifier (validated) */\n  readonly sessionId: string;\n\n  /** Scope identifier */\n  readonly scopeId: string;\n\n  // =====================\n  // Tracing\n  // =====================\n\n  /** W3C Trace Context or generated trace ID */\n  readonly traceContext: TraceContext;\n\n  /** Request start timestamp */\n  readonly timestamp: number;\n\n  // =====================\n  // Configuration\n  // =====================\n\n  /** Context configuration */\n  readonly config: FrontMcpContextConfig;\n\n  // =====================\n  // Metadata\n  // =====================\n\n  /** Request metadata (headers, user-agent, etc.) */\n  readonly metadata: RequestMetadata;\n\n  // =====================\n  // Auth (mutable, progressively populated)\n  // =====================\n\n  private _authInfo: Partial<AuthInfo>;\n  private _sessionMetadata?: SessionIdPayload;\n\n  // =====================\n  // References (pointers)\n  // =====================\n\n  private _transport?: TransportRef;\n  private _flow?: FlowBaseRef;\n  private _scope?: ScopeRef;\n\n  // =====================\n  // Storage\n  // =====================\n\n  private readonly marks: Map<string, number> = new Map();\n  private readonly store: Map<string | symbol, unknown> = new Map();\n\n  constructor(args: FrontMcpContextArgs) {\n    // Validate session ID\n    validateSessionKey(args.sessionId);\n\n    this.requestId = args.requestId ?? randomUUID();\n    this.sessionId = args.sessionId;\n    this.scopeId = args.scopeId;\n    this.traceContext = args.traceContext ?? generateTraceContext();\n    this.timestamp = args.timestamp ?? Date.now();\n    this._authInfo = args.authInfo ?? {};\n\n    // Configuration with defaults\n    this.config = {\n      autoInjectAuthHeaders: args.config?.autoInjectAuthHeaders ?? true,\n      autoInjectTracingHeaders: args.config?.autoInjectTracingHeaders ?? true,\n      requestTimeout: args.config?.requestTimeout ?? 30000,\n    };\n\n    // Defensive normalization: ensure customHeaders is always an object\n    const metadata = args.metadata;\n    this.metadata = {\n      ...metadata,\n      customHeaders: metadata?.customHeaders ?? {},\n    };\n\n    // Initial mark\n    this.marks.set('init', this.timestamp);\n  }\n\n  // =====================\n  // Auth Accessors\n  // =====================\n\n  /**\n   * Get authentication information.\n   * Returns Partial<AuthInfo> because auth info is progressively populated.\n   */\n  get authInfo(): Partial<AuthInfo> {\n    return this._authInfo;\n  }\n\n  /**\n   * Update auth info after authorization is verified.\n   * Can be called multiple times to progressively add fields.\n   *\n   * @param authInfo - The auth info fields to set/update\n   * @internal\n   */\n  updateAuthInfo(authInfo: Partial<AuthInfo>): void {\n    this._authInfo = { ...this._authInfo, ...authInfo };\n  }\n\n  /**\n   * Get session metadata (protocol, platform type, node info).\n   * Only available after session verification.\n   */\n  get sessionMetadata(): SessionIdPayload | undefined {\n    return this._sessionMetadata;\n  }\n\n  /**\n   * Update session metadata after session verification.\n   *\n   * @param metadata - Session metadata from verified session\n   * @internal\n   */\n  updateSessionMetadata(metadata: SessionIdPayload): void {\n    this._sessionMetadata = metadata;\n  }\n\n  // =====================\n  // Reference Accessors\n  // =====================\n\n  /**\n   * Get transport accessor for elicit support.\n   * Returns undefined if no transport is registered.\n   */\n  get transport(): TransportAccessor | undefined {\n    if (!this._transport) return undefined;\n    const transportRef = this._transport;\n    return {\n      supportsElicit: true,\n      elicit: (message, schema) => transportRef.sendElicitRequest(message, schema),\n    };\n  }\n\n  /**\n   * Set transport reference (internal use).\n   * @internal\n   */\n  setTransport(transport: TransportRef): void {\n    this._transport = transport;\n  }\n\n  /**\n   * Get current flow reference.\n   */\n  get flow(): FlowBaseRef | undefined {\n    return this._flow;\n  }\n\n  /**\n   * Set flow reference (internal use).\n   * @internal\n   */\n  setFlow(flow: FlowBaseRef): void {\n    this._flow = flow;\n  }\n\n  /**\n   * Get scope reference.\n   */\n  get scope(): ScopeRef | undefined {\n    return this._scope;\n  }\n\n  /**\n   * Set scope reference (internal use).\n   * @internal\n   */\n  setScope(scope: ScopeRef): void {\n    this._scope = scope;\n  }\n\n  // =====================\n  // Store Operations\n  // =====================\n\n  /**\n   * Store context-scoped data.\n   *\n   * @param key - Storage key\n   * @param value - Value to store\n   */\n  set<T>(key: string | symbol, value: T): void {\n    this.store.set(key, value);\n  }\n\n  /**\n   * Retrieve context-scoped data.\n   *\n   * @param key - Storage key\n   * @returns Stored value or undefined\n   */\n  get<T>(key: string | symbol): T | undefined {\n    return this.store.get(key) as T | undefined;\n  }\n\n  /**\n   * Check if a key exists in the context store.\n   *\n   * @param key - Storage key\n   * @returns True if key exists\n   */\n  has(key: string | symbol): boolean {\n    return this.store.has(key);\n  }\n\n  /**\n   * Delete a key from the context store.\n   *\n   * @param key - Storage key\n   * @returns True if key was deleted\n   */\n  delete(key: string | symbol): boolean {\n    return this.store.delete(key);\n  }\n\n  // =====================\n  // Timing & Performance\n  // =====================\n\n  /**\n   * Mark a timing point for performance tracking.\n   *\n   * @param name - Name of the timing mark\n   */\n  mark(name: string): void {\n    this.marks.set(name, Date.now());\n  }\n\n  /**\n   * Get elapsed time in milliseconds between two marks.\n   *\n   * @param from - Start mark name (defaults to 'init')\n   * @param to - End mark name (defaults to current time)\n   * @returns Elapsed time in milliseconds\n   */\n  elapsed(from?: string, to?: string): number {\n    const fromTime = this.marks.get(from ?? 'init') ?? this.timestamp;\n    const toTime = to ? this.marks.get(to) ?? Date.now() : Date.now();\n    return toTime - fromTime;\n  }\n\n  /**\n   * Get all timing marks.\n   *\n   * @returns Read-only map of mark names to timestamps\n   */\n  getMarks(): ReadonlyMap<string, number> {\n    return this.marks;\n  }\n\n  // =====================\n  // Logging\n  // =====================\n\n  /**\n   * Get a child logger with context attached.\n   *\n   * Creates a child logger with a prefix containing the request ID and trace ID\n   * for easy request tracing in logs.\n   *\n   * @param parentLogger - The parent logger to create a child from\n   * @returns A logger with requestId and traceId in the prefix\n   */\n  getLogger(parentLogger: FrontMcpLogger): FrontMcpLogger {\n    const prefix = `[${this.requestId.slice(0, 8)}:${this.traceContext.traceId.slice(0, 8)}]`;\n    return parentLogger.child(prefix);\n  }\n\n  /**\n   * Get a summary of the context for logging.\n   *\n   * Note: sessionId is hashed to prevent accidental exposure of user-identifying\n   * session identifiers in logs while still allowing correlation.\n   *\n   * @returns Object with key context fields\n   */\n  toLogContext(): Record<string, unknown> {\n    return {\n      requestId: this.requestId,\n      traceId: this.traceContext.traceId,\n      parentId: this.traceContext.parentId,\n      // Hash sessionId to prevent logging user-identifying information\n      sessionIdHash: createHash('sha256').update(this.sessionId).digest('hex').slice(0, 12),\n      scopeId: this.scopeId,\n      flowName: this._flow?.name,\n      elapsed: this.elapsed(),\n    };\n  }\n\n  // =====================\n  // Context-Aware Fetch\n  // =====================\n\n  /**\n   * Perform a fetch request with automatic header injection.\n   *\n   * Injects:\n   * - Authorization header (if authInfo.token is available and autoInjectAuthHeaders is true)\n   * - W3C traceparent header (if autoInjectTracingHeaders is true)\n   * - x-request-id header\n   * - Custom headers from request metadata\n   *\n   * @param input - Request URL or Request object\n   * @param init - Request options\n   * @returns Fetch response\n   */\n  async fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {\n    const headers = new Headers(init?.headers);\n\n    // Auto-inject auth headers\n    if (this.config.autoInjectAuthHeaders && this._authInfo.token) {\n      if (!headers.has('Authorization')) {\n        headers.set('Authorization', `Bearer ${this._authInfo.token}`);\n      }\n    }\n\n    // Auto-inject tracing headers\n    if (this.config.autoInjectTracingHeaders) {\n      if (!headers.has('traceparent')) {\n        headers.set('traceparent', this.traceContext.raw);\n      }\n      if (!headers.has('x-request-id')) {\n        headers.set('x-request-id', this.requestId);\n      }\n    }\n\n    // Inject custom headers from request metadata\n    for (const [key, value] of Object.entries(this.metadata.customHeaders)) {\n      if (!headers.has(key)) {\n        headers.set(key, value);\n      }\n    }\n\n    // Use AbortSignal.timeout if no signal provided\n    const signal = init?.signal ?? AbortSignal.timeout(this.config.requestTimeout ?? 30000);\n\n    return fetch(input, {\n      ...init,\n      headers,\n      signal,\n    });\n  }\n}\n\n/**\n * Alias for FrontMcpContext.\n * Use when you want a shorter name.\n */\nexport { FrontMcpContext as Context };\n"]}

package/src/context/frontmcp-context.provider.js

@@ -1,61 +0,0 @@
-"use strict";
-/**
- * FRONTMCP_CONTEXT Provider
- *
- * Defines the DI token and factory provider for accessing FrontMcpContext.
- * The context is retrieved from AsyncLocalStorage via FrontMcpContextStorage.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RequestContextProvider = exports.FrontMcpContextProvider = exports.REQUEST_CONTEXT = exports.FRONTMCP_CONTEXT = void 0;
-const metadata_1 = require("../common/metadata");
-const provider_interface_1 = require("../common/interfaces/provider.interface");
-const frontmcp_context_storage_1 = require("./frontmcp-context-storage");
-/**
- * DI token for accessing the current FrontMcpContext.
- *
- * Use this token to inject the current context in any provider or context:
- *
- * @example
- * ```typescript
- * // In a tool/resource/prompt
- * const ctx = this.get(FRONTMCP_CONTEXT);
- * console.log(ctx.requestId, ctx.sessionId, ctx.authInfo);
- *
- * // Access transport for elicit
- * const result = await ctx.transport?.elicit('Choose an option', schema);
- *
- * // Context-aware fetch
- * const response = await ctx.fetch('https://api.example.com/data');
- * ```
- */
-exports.FRONTMCP_CONTEXT = Symbol.for('frontmcp:CONTEXT');
-/**
- * @deprecated Use FRONTMCP_CONTEXT instead
- */
-exports.REQUEST_CONTEXT = exports.FRONTMCP_CONTEXT;
-/**
- * Factory provider for FrontMcpContext.
- *
- * This provider is marked as CONTEXT scope and retrieves the current
- * FrontMcpContext from AsyncLocalStorage via FrontMcpContextStorage.
- *
- * Note: This provider will throw if called outside of a context scope
- * (i.e., without first calling FrontMcpContextStorage.run or runFromHeaders).
- */
-exports.FrontMcpContextProvider = (0, provider_interface_1.AsyncProvider)({
-    provide: exports.FRONTMCP_CONTEXT,
-    inject: () => [frontmcp_context_storage_1.FrontMcpContextStorage],
-    useFactory: (storage) => {
-        return storage.getStoreOrThrow();
-    },
-    metadata: {
-        name: 'FrontMcpContext',
-        description: 'Current unified context from AsyncLocalStorage',
-        scope: metadata_1.ProviderScope.CONTEXT,
-    },
-}); // Type assertion needed: normalizeProvider expects nested metadata structure
-/**
- * @deprecated Use FrontMcpContextProvider instead
- */
-exports.RequestContextProvider = exports.FrontMcpContextProvider;
-//# sourceMappingURL=frontmcp-context.provider.js.map

package/src/context/frontmcp-context.provider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"frontmcp-context.provider.js","sourceRoot":"","sources":["../../../src/context/frontmcp-context.provider.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iDAAmD;AACnD,gFAAwE;AAExE,yEAAoE;AAEpE;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAE/D;;GAEG;AACU,QAAA,eAAe,GAAG,wBAAgB,CAAC;AAEhD;;;;;;;;GAQG;AACU,QAAA,uBAAuB,GAAG,IAAA,kCAAa,EAAC;IACnD,OAAO,EAAE,wBAAgB;IACzB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,iDAAsB,CAAU;IAC/C,UAAU,EAAE,CAAC,OAA+B,EAAmB,EAAE;QAC/D,OAAO,OAAO,CAAC,eAAe,EAAE,CAAC;IACnC,CAAC;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,gDAAgD;QAC7D,KAAK,EAAE,wBAAa,CAAC,OAAO;KAC7B;CACK,CAAC,CAAC,CAAC,6EAA6E;AAExF;;GAEG;AACU,QAAA,sBAAsB,GAAG,+BAAuB,CAAC","sourcesContent":["/**\n * FRONTMCP_CONTEXT Provider\n *\n * Defines the DI token and factory provider for accessing FrontMcpContext.\n * The context is retrieved from AsyncLocalStorage via FrontMcpContextStorage.\n */\n\nimport { ProviderScope } from '../common/metadata';\nimport { AsyncProvider } from '../common/interfaces/provider.interface';\nimport { FrontMcpContext } from './frontmcp-context';\nimport { FrontMcpContextStorage } from './frontmcp-context-storage';\n\n/**\n * DI token for accessing the current FrontMcpContext.\n *\n * Use this token to inject the current context in any provider or context:\n *\n * @example\n * ```typescript\n * // In a tool/resource/prompt\n * const ctx = this.get(FRONTMCP_CONTEXT);\n * console.log(ctx.requestId, ctx.sessionId, ctx.authInfo);\n *\n * // Access transport for elicit\n * const result = await ctx.transport?.elicit('Choose an option', schema);\n *\n * // Context-aware fetch\n * const response = await ctx.fetch('https://api.example.com/data');\n * ```\n */\nexport const FRONTMCP_CONTEXT = Symbol.for('frontmcp:CONTEXT');\n\n/**\n * @deprecated Use FRONTMCP_CONTEXT instead\n */\nexport const REQUEST_CONTEXT = FRONTMCP_CONTEXT;\n\n/**\n * Factory provider for FrontMcpContext.\n *\n * This provider is marked as CONTEXT scope and retrieves the current\n * FrontMcpContext from AsyncLocalStorage via FrontMcpContextStorage.\n *\n * Note: This provider will throw if called outside of a context scope\n * (i.e., without first calling FrontMcpContextStorage.run or runFromHeaders).\n */\nexport const FrontMcpContextProvider = AsyncProvider({\n  provide: FRONTMCP_CONTEXT,\n  inject: () => [FrontMcpContextStorage] as const,\n  useFactory: (storage: FrontMcpContextStorage): FrontMcpContext => {\n    return storage.getStoreOrThrow();\n  },\n  metadata: {\n    name: 'FrontMcpContext',\n    description: 'Current unified context from AsyncLocalStorage',\n    scope: ProviderScope.CONTEXT,\n  },\n} as any); // Type assertion needed: normalizeProvider expects nested metadata structure\n\n/**\n * @deprecated Use FrontMcpContextProvider instead\n */\nexport const RequestContextProvider = FrontMcpContextProvider;\n"]}

package/src/context/index.js

@@ -1,64 +0,0 @@
-"use strict";
-/**
- * Context Module
- *
- * Provides unified context management for production-ready request handling.
- *
- * Key exports:
- * - FrontMcpContext (alias: Context): Unified context with session + request data
- * - FrontMcpContextStorage: AsyncLocalStorage wrapper for context propagation
- * - FRONTMCP_CONTEXT: DI token for accessing current context
- * - TraceContext utilities: W3C Trace Context parsing and generation
- *
- * @deprecated exports (backward compatibility):
- * - RequestContext: Use FrontMcpContext instead
- * - RequestContextStorage: Use FrontMcpContextStorage instead
- * - REQUEST_CONTEXT: Use FRONTMCP_CONTEXT instead
- * - SessionKey: No longer needed with unified context
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionKey = exports.RequestContextStorage = exports.RequestContext = exports.createChildSpanContext = exports.generateTraceContext = exports.parseTraceContext = exports.RequestContextProvider = exports.REQUEST_CONTEXT = exports.FrontMcpContextProvider = exports.FRONTMCP_CONTEXT = exports.ContextStorage = exports.FrontMcpContextStorage = exports.Context = exports.FrontMcpContext = void 0;
-// =====================
-// New Unified Context (Primary exports)
-// =====================
-// FrontMcpContext - unified context class
-var frontmcp_context_1 = require("./frontmcp-context");
-Object.defineProperty(exports, "FrontMcpContext", { enumerable: true, get: function () { return frontmcp_context_1.FrontMcpContext; } });
-Object.defineProperty(exports, "Context", { enumerable: true, get: function () { return frontmcp_context_1.Context; } });
-// FrontMcpContextStorage - AsyncLocalStorage wrapper
-var frontmcp_context_storage_1 = require("./frontmcp-context-storage");
-Object.defineProperty(exports, "FrontMcpContextStorage", { enumerable: true, get: function () { return frontmcp_context_storage_1.FrontMcpContextStorage; } });
-Object.defineProperty(exports, "ContextStorage", { enumerable: true, get: function () { return frontmcp_context_storage_1.ContextStorage; } });
-// DI token and provider
-var frontmcp_context_provider_1 = require("./frontmcp-context.provider");
-Object.defineProperty(exports, "FRONTMCP_CONTEXT", { enumerable: true, get: function () { return frontmcp_context_provider_1.FRONTMCP_CONTEXT; } });
-Object.defineProperty(exports, "FrontMcpContextProvider", { enumerable: true, get: function () { return frontmcp_context_provider_1.FrontMcpContextProvider; } });
-// Backward compatibility
-Object.defineProperty(exports, "REQUEST_CONTEXT", { enumerable: true, get: function () { return frontmcp_context_provider_1.REQUEST_CONTEXT; } });
-Object.defineProperty(exports, "RequestContextProvider", { enumerable: true, get: function () { return frontmcp_context_provider_1.RequestContextProvider; } });
-// =====================
-// Trace Context (unchanged)
-// =====================
-var trace_context_1 = require("./trace-context");
-Object.defineProperty(exports, "parseTraceContext", { enumerable: true, get: function () { return trace_context_1.parseTraceContext; } });
-Object.defineProperty(exports, "generateTraceContext", { enumerable: true, get: function () { return trace_context_1.generateTraceContext; } });
-Object.defineProperty(exports, "createChildSpanContext", { enumerable: true, get: function () { return trace_context_1.createChildSpanContext; } });
-// =====================
-// Backward Compatibility (deprecated)
-// =====================
-/**
- * @deprecated Use FrontMcpContext instead
- */
-var request_context_1 = require("./request-context");
-Object.defineProperty(exports, "RequestContext", { enumerable: true, get: function () { return request_context_1.RequestContext; } });
-/**
- * @deprecated Use FrontMcpContextStorage instead
- */
-var request_context_storage_1 = require("./request-context-storage");
-Object.defineProperty(exports, "RequestContextStorage", { enumerable: true, get: function () { return request_context_storage_1.RequestContextStorage; } });
-/**
- * @deprecated SessionKey is no longer needed. Use ctx.sessionId directly.
- */
-var session_key_provider_1 = require("./session-key.provider");
-Object.defineProperty(exports, "SessionKey", { enumerable: true, get: function () { return session_key_provider_1.SessionKey; } });
-//# sourceMappingURL=index.js.map

package/src/context/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,wBAAwB;AACxB,wCAAwC;AACxC,wBAAwB;AAExB,0CAA0C;AAC1C,uDAO4B;AAN1B,mHAAA,eAAe,OAAA;AACf,2GAAA,OAAO,OAAA;AAOT,qDAAqD;AACrD,uEAAoF;AAA3E,kIAAA,sBAAsB,OAAA;AAAE,0HAAA,cAAc,OAAA;AAE/C,wBAAwB;AACxB,yEAMqC;AALnC,6HAAA,gBAAgB,OAAA;AAChB,oIAAA,uBAAuB,OAAA;AACvB,yBAAyB;AACzB,4HAAA,eAAe,OAAA;AACf,mIAAA,sBAAsB,OAAA;AAGxB,wBAAwB;AACxB,4BAA4B;AAC5B,wBAAwB;AAExB,iDAAgH;AAAzF,kHAAA,iBAAiB,OAAA;AAAE,qHAAA,oBAAoB,OAAA;AAAE,uHAAA,sBAAsB,OAAA;AAEtF,wBAAwB;AACxB,sCAAsC;AACtC,wBAAwB;AAExB;;GAEG;AACH,qDAAmG;AAA1F,iHAAA,cAAc,OAAA;AAEvB;;GAEG;AACH,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAE9B;;GAEG;AACH,+DAAoD;AAA3C,kHAAA,UAAU,OAAA","sourcesContent":["/**\n * Context Module\n *\n * Provides unified context management for production-ready request handling.\n *\n * Key exports:\n * - FrontMcpContext (alias: Context): Unified context with session + request data\n * - FrontMcpContextStorage: AsyncLocalStorage wrapper for context propagation\n * - FRONTMCP_CONTEXT: DI token for accessing current context\n * - TraceContext utilities: W3C Trace Context parsing and generation\n *\n * @deprecated exports (backward compatibility):\n * - RequestContext: Use FrontMcpContext instead\n * - RequestContextStorage: Use FrontMcpContextStorage instead\n * - REQUEST_CONTEXT: Use FRONTMCP_CONTEXT instead\n * - SessionKey: No longer needed with unified context\n */\n\n// =====================\n// New Unified Context (Primary exports)\n// =====================\n\n// FrontMcpContext - unified context class\nexport {\n  FrontMcpContext,\n  Context, // Short alias\n  FrontMcpContextArgs,\n  FrontMcpContextConfig,\n  RequestMetadata,\n  TransportAccessor,\n} from './frontmcp-context';\n\n// FrontMcpContextStorage - AsyncLocalStorage wrapper\nexport { FrontMcpContextStorage, ContextStorage } from './frontmcp-context-storage';\n\n// DI token and provider\nexport {\n  FRONTMCP_CONTEXT,\n  FrontMcpContextProvider,\n  // Backward compatibility\n  REQUEST_CONTEXT,\n  RequestContextProvider,\n} from './frontmcp-context.provider';\n\n// =====================\n// Trace Context (unchanged)\n// =====================\n\nexport { TraceContext, parseTraceContext, generateTraceContext, createChildSpanContext } from './trace-context';\n\n// =====================\n// Backward Compatibility (deprecated)\n// =====================\n\n/**\n * @deprecated Use FrontMcpContext instead\n */\nexport { RequestContext, RequestContextArgs as LegacyRequestContextArgs } from './request-context';\n\n/**\n * @deprecated Use FrontMcpContextStorage instead\n */\nexport { RequestContextStorage } from './request-context-storage';\n\n/**\n * @deprecated SessionKey is no longer needed. Use ctx.sessionId directly.\n */\nexport { SessionKey } from './session-key.provider';\n"]}