mcp-server-framework 1.0.0

package/build/logger/core/context.js

@@ -0,0 +1,237 @@
+/**
+ * Logger Context Management Module
+ *
+ * Provides robust context management for correlated logging using AsyncLocalStorage.
+ * Enables automatic log enrichment with request/session context across async boundaries.
+ *
+ * Key features:
+ * - Automatic context propagation through async operations
+ * - Hierarchical context support (parent/child relationships)
+ * - Thread-safe context isolation (depth tracked per-context, not globally)
+ * - Memory-efficient context management
+ *
+ * @module logger/core/context
+ */
+import { AsyncLocalStorage } from "async_hooks";
+import { MAX_CONTEXT_DEPTH, COMPONENT_SEPARATOR } from "./constants.js";
+// ============================================================================
+// Context Storage
+// ============================================================================
+/**
+ * AsyncLocalStorage instance for maintaining logging context.
+ * This allows context to flow through async operations automatically
+ * without explicit passing of context objects.
+ *
+ * @internal
+ */
+const contextStorage = new AsyncLocalStorage();
+// ============================================================================
+// Core Context Functions
+// ============================================================================
+/**
+ * Run a function within a logging context.
+ *
+ * All logs within the function (and any async operations it spawns)
+ * will automatically include the provided context. This is the primary
+ * way to establish context for a request or operation.
+ *
+ * Thread-safety: Depth is tracked within the context object itself,
+ * making it safe for concurrent operations across different async contexts.
+ *
+ * @param context - The context to use for logging
+ * @param fn - The function to execute within the context
+ * @returns The result of the function
+ * @throws Error if maximum context depth is exceeded
+ *
+ * @example
+ * ```typescript
+ * const result = runWithContext(
+ *   { requestId: 'req-123', sessionId: 'sess-456' },
+ *   async () => {
+ *     logger.info('Processing request'); // Includes requestId and sessionId
+ *     return await processRequest();
+ *   }
+ * );
+ * ```
+ */
+export function runWithContext(context, fn) {
+    // Get current depth from parent context (if any) or start at 0
+    const parentContext = contextStorage.getStore();
+    const parentDepth = parentContext?._depth ?? 0;
+    const newDepth = parentDepth + 1;
+    if (newDepth > MAX_CONTEXT_DEPTH) {
+        throw new Error(`Maximum context depth (${MAX_CONTEXT_DEPTH}) exceeded. Possible infinite recursion.`);
+    }
+    // Create new context with incremented depth (thread-safe: each context has its own depth)
+    const contextWithDepth = {
+        ...context,
+        _depth: newDepth,
+    };
+    return contextStorage.run(contextWithDepth, fn);
+}
+/**
+ * Get the current logging context.
+ *
+ * Returns undefined if called outside of a context established by `runWithContext`.
+ *
+ * @returns The current context or undefined
+ *
+ * @example
+ * ```typescript
+ * const context = getContext();
+ * if (context?.requestId) {
+ *   console.log(`Request: ${context.requestId}`);
+ * }
+ * ```
+ */
+export function getContext() {
+    return contextStorage.getStore();
+}
+/**
+ * Get a specific value from the current context.
+ *
+ * Convenience function for accessing individual context properties
+ * without retrieving the entire context object.
+ *
+ * @param key - The context property to retrieve
+ * @returns The value or undefined if not in context or key doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const requestId = getContextValue('requestId');
+ * const component = getContextValue('component') ?? 'unknown';
+ * ```
+ */
+export function getContextValue(key) {
+    return contextStorage.getStore()?.[key];
+}
+/**
+ * Check if currently running within a logging context.
+ *
+ * @returns true if inside a context established by `runWithContext`
+ *
+ * @example
+ * ```typescript
+ * if (hasContext()) {
+ *   // Safe to access context values
+ * }
+ * ```
+ */
+export function hasContext() {
+    return contextStorage.getStore() !== undefined;
+}
+// ============================================================================
+// Context Manipulation Functions
+// ============================================================================
+/**
+ * Create a new context by merging additional values with the current context.
+ *
+ * This is useful for adding context without losing existing values.
+ * If called outside a context, returns only the additional context.
+ *
+ * @param additionalContext - Context values to add/override
+ * @returns A new merged context (does not modify current context)
+ *
+ * @example
+ * ```typescript
+ * const newContext = mergeContext({ component: 'api', traceId: 'trace-123' });
+ * runWithContext(newContext, () => {
+ *   // Has both original context + new values
+ * });
+ * ```
+ */
+export function mergeContext(additionalContext) {
+    const current = contextStorage.getStore() ?? {};
+    return { ...current, ...additionalContext };
+}
+/**
+ * Create a child context that inherits from the current context.
+ *
+ * The child context inherits all parent values but can override specific ones.
+ * Component names are automatically concatenated with a separator.
+ *
+ * @param childContext - Context values for the child
+ * @returns A new child context
+ *
+ * @example
+ * ```typescript
+ * // Parent has component: 'api'
+ * const childCtx = createChildContext({ component: 'handlers' });
+ * // childCtx.component = 'api.handlers'
+ * ```
+ */
+export function createChildContext(childContext) {
+    const parent = contextStorage.getStore() ?? {};
+    // Merge component names if both exist
+    let component;
+    if (parent.component && childContext.component) {
+        component = `${parent.component}${COMPONENT_SEPARATOR}${childContext.component}`;
+    }
+    else {
+        component = childContext.component ?? parent.component;
+    }
+    return {
+        ...parent,
+        ...childContext,
+        ...(component !== undefined && { component }),
+    };
+}
+/**
+ * Execute a function with an extended context (adds to current context).
+ *
+ * Combines `mergeContext` and `runWithContext` for convenience.
+ * This is the preferred way to add context for a sub-operation.
+ *
+ * @param additionalContext - Context values to add
+ * @param fn - The function to execute
+ * @returns The result of the function
+ *
+ * @example
+ * ```typescript
+ * await withExtendedContext({ operation: 'create' }, async () => {
+ *   logger.info('Creating resource'); // Includes operation: 'create'
+ *   return await createResource();
+ * });
+ * ```
+ */
+export function withExtendedContext(additionalContext, fn) {
+    const merged = mergeContext(additionalContext);
+    return runWithContext(merged, fn);
+}
+/**
+ * Execute a function with a child context.
+ *
+ * Combines `createChildContext` and `runWithContext` for convenience.
+ * Useful for creating hierarchical logging scopes.
+ *
+ * @param childContext - Context values for the child scope
+ * @param fn - The function to execute
+ * @returns The result of the function
+ *
+ * @example
+ * ```typescript
+ * await withChildContext({ component: 'validation' }, async () => {
+ *   logger.info('Validating input'); // component: 'api.validation'
+ *   return await validateInput();
+ * });
+ * ```
+ */
+export function withChildContext(childContext, fn) {
+    const child = createChildContext(childContext);
+    return runWithContext(child, fn);
+}
+// ============================================================================
+// Context Utilities
+// ============================================================================
+/**
+ * Get the current context depth.
+ *
+ * Thread-safe: reads depth from the current async context.
+ * Returns 0 if called outside of any context.
+ *
+ * @returns The current context nesting depth
+ */
+export function getContextDepth() {
+    return contextStorage.getStore()?._depth ?? 0;
+}
+//# sourceMappingURL=context.js.map

package/build/logger/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/logger/core/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAExE,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,cAAc,GAAG,IAAI,iBAAiB,EAAc,CAAC;AAE3D,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,cAAc,CAAI,OAAmB,EAAE,EAAW;IAChE,+DAA+D;IAC/D,MAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC;IAChD,MAAM,WAAW,GAAG,aAAa,EAAE,MAAM,IAAI,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,WAAW,GAAG,CAAC,CAAC;IAEjC,IAAI,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,iBAAiB,0CAA0C,CAAC,CAAC;IACzG,CAAC;IAED,0FAA0F;IAC1F,MAAM,gBAAgB,GAAe;QACnC,GAAG,OAAO;QACV,MAAM,EAAE,QAAQ;KACjB,CAAC;IAEF,OAAO,cAAc,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAA6B,GAAM;IAChE,OAAO,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,cAAc,CAAC,QAAQ,EAAE,KAAK,SAAS,CAAC;AACjD,CAAC;AAED,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,iBAAsC;IACjE,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IAChD,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAiC;IAClE,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IAE/C,sCAAsC;IACtC,IAAI,SAA6B,CAAC;IAClC,IAAI,MAAM,CAAC,SAAS,IAAI,YAAY,CAAC,SAAS,EAAE,CAAC;QAC/C,SAAS,GAAG,GAAG,MAAM,CAAC,SAAS,GAAG,mBAAmB,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC;IACnF,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,YAAY,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC;IACzD,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,GAAG,YAAY;QACf,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CAAI,iBAAsC,EAAE,EAAW;IACxF,MAAM,MAAM,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAC/C,OAAO,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAAI,YAAiC,EAAE,EAAW;IAChF,MAAM,KAAK,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC/C,OAAO,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,cAAc,CAAC,QAAQ,EAAE,EAAE,MAAM,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/build/logger/core/errors.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Logger Error Classes Module
+ *
+ * Provides typed error classes for the logging system. Standalone
+ * implementation with no dependencies on framework error classes
+ * or external packages — the logger module must remain dependency-free.
+ *
+ * @module logger/core/errors
+ */
+/**
+ * Logger-specific error codes.
+ */
+export declare const LoggerErrorCode: {
+    /** Generic logger error */
+    readonly LOGGER_ERROR: "LOGGER_ERROR";
+    /** Logger resource initialization failed */
+    readonly LOGGER_INIT_ERROR: "LOGGER_INIT_ERROR";
+    /** Context depth exceeded */
+    readonly CONTEXT_DEPTH_EXCEEDED: "CONTEXT_DEPTH_EXCEEDED";
+    /** Writer operation failed */
+    readonly WRITER_ERROR: "WRITER_ERROR";
+    /** Formatter operation failed */
+    readonly FORMATTER_ERROR: "FORMATTER_ERROR";
+    /** Scrubbing operation failed */
+    readonly SCRUBBER_ERROR: "SCRUBBER_ERROR";
+};
+export type LoggerErrorCodeType = (typeof LoggerErrorCode)[keyof typeof LoggerErrorCode];
+/** Options accepted by all logger error constructors. */
+interface LoggerErrorOptions {
+    code?: LoggerErrorCodeType | undefined;
+    cause?: Error | undefined;
+    context?: Record<string, unknown> | undefined;
+}
+/**
+ * Base error class for all logger-related errors.
+ *
+ * Standalone implementation extending native `Error` — no dependency on
+ * the framework's `AppError` hierarchy. This ensures the logger module
+ * has zero cross-module imports.
+ *
+ * @example
+ * ```typescript
+ * throw new LoggerError('Failed to initialize logger', {
+ *   code: LoggerErrorCode.LOGGER_INIT_ERROR,
+ *   cause: originalError,
+ *   context: { format: 'json' }
+ * });
+ * ```
+ */
+export declare class LoggerError extends Error {
+    /** Logger-specific error code. */
+    readonly code: LoggerErrorCodeType;
+    /** Additional context for debugging. */
+    readonly context?: Record<string, unknown> | undefined;
+    readonly cause?: Error | undefined;
+    constructor(message: string, options?: LoggerErrorOptions);
+    /**
+     * Check if an error is a LoggerError instance.
+     */
+    static isLoggerError(error: unknown): error is LoggerError;
+}
+/**
+ * Error thrown when logger resources fail to initialize.
+ */
+export declare class LoggerInitError extends LoggerError {
+    constructor(message: string, options?: {
+        cause?: Error | undefined;
+        context?: Record<string, unknown> | undefined;
+    });
+}
+/**
+ * Error thrown when a log writer operation fails.
+ */
+export declare class WriterError extends LoggerError {
+    readonly writerName: string;
+    constructor(writerName: string, message: string, options?: {
+        cause?: Error | undefined;
+        context?: Record<string, unknown> | undefined;
+    });
+}
+/**
+ * Error thrown when log formatting fails.
+ */
+export declare class FormatterError extends LoggerError {
+    readonly formatterName: string;
+    constructor(formatterName: string, message: string, options?: {
+        cause?: Error | undefined;
+        context?: Record<string, unknown> | undefined;
+    });
+}
+/**
+ * Error thrown when secret scrubbing fails.
+ */
+export declare class ScrubberError extends LoggerError {
+    constructor(message: string, options?: {
+        cause?: Error | undefined;
+        context?: Record<string, unknown> | undefined;
+    });
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/build/logger/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/logger/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B,2BAA2B;;IAE3B,4CAA4C;;IAE5C,6BAA6B;;IAE7B,8BAA8B;;IAE9B,iCAAiC;;IAEjC,iCAAiC;;CAEzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEzF,yDAAyD;AACzD,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACvC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC/C;AAMD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAEnC,wCAAwC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAEvD,SAAkB,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;gBAEhC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IAQ7D;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW;CAG3D;AAMD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAE5C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;KAC1C;CAST;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAG1B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;KAC1C;CAUT;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAG7B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;KAC1C;CAUT;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;gBAE1C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;KAC1C;CAST"}

package/build/logger/core/errors.js

@@ -0,0 +1,128 @@
+/**
+ * Logger Error Classes Module
+ *
+ * Provides typed error classes for the logging system. Standalone
+ * implementation with no dependencies on framework error classes
+ * or external packages — the logger module must remain dependency-free.
+ *
+ * @module logger/core/errors
+ */
+// ============================================================================
+// Logger Error Codes
+// ============================================================================
+/**
+ * Logger-specific error codes.
+ */
+export const LoggerErrorCode = {
+    /** Generic logger error */
+    LOGGER_ERROR: "LOGGER_ERROR",
+    /** Logger resource initialization failed */
+    LOGGER_INIT_ERROR: "LOGGER_INIT_ERROR",
+    /** Context depth exceeded */
+    CONTEXT_DEPTH_EXCEEDED: "CONTEXT_DEPTH_EXCEEDED",
+    /** Writer operation failed */
+    WRITER_ERROR: "WRITER_ERROR",
+    /** Formatter operation failed */
+    FORMATTER_ERROR: "FORMATTER_ERROR",
+    /** Scrubbing operation failed */
+    SCRUBBER_ERROR: "SCRUBBER_ERROR",
+};
+// ============================================================================
+// Base Logger Error
+// ============================================================================
+/**
+ * Base error class for all logger-related errors.
+ *
+ * Standalone implementation extending native `Error` — no dependency on
+ * the framework's `AppError` hierarchy. This ensures the logger module
+ * has zero cross-module imports.
+ *
+ * @example
+ * ```typescript
+ * throw new LoggerError('Failed to initialize logger', {
+ *   code: LoggerErrorCode.LOGGER_INIT_ERROR,
+ *   cause: originalError,
+ *   context: { format: 'json' }
+ * });
+ * ```
+ */
+export class LoggerError extends Error {
+    /** Logger-specific error code. */
+    code;
+    /** Additional context for debugging. */
+    context;
+    cause;
+    constructor(message, options = {}) {
+        super(message);
+        this.name = "LoggerError";
+        this.code = options.code ?? LoggerErrorCode.LOGGER_ERROR;
+        this.cause = options.cause;
+        this.context = options.context;
+    }
+    /**
+     * Check if an error is a LoggerError instance.
+     */
+    static isLoggerError(error) {
+        return error instanceof LoggerError;
+    }
+}
+// ============================================================================
+// Specialized Logger Errors
+// ============================================================================
+/**
+ * Error thrown when logger resources fail to initialize.
+ */
+export class LoggerInitError extends LoggerError {
+    constructor(message, options = {}) {
+        super(message, {
+            code: LoggerErrorCode.LOGGER_INIT_ERROR,
+            cause: options.cause,
+            context: options.context,
+        });
+        this.name = "LoggerInitError";
+    }
+}
+/**
+ * Error thrown when a log writer operation fails.
+ */
+export class WriterError extends LoggerError {
+    writerName;
+    constructor(writerName, message, options = {}) {
+        super(message, {
+            code: LoggerErrorCode.WRITER_ERROR,
+            cause: options.cause,
+            context: { ...options.context, writerName },
+        });
+        this.name = "WriterError";
+        this.writerName = writerName;
+    }
+}
+/**
+ * Error thrown when log formatting fails.
+ */
+export class FormatterError extends LoggerError {
+    formatterName;
+    constructor(formatterName, message, options = {}) {
+        super(message, {
+            code: LoggerErrorCode.FORMATTER_ERROR,
+            cause: options.cause,
+            context: { ...options.context, formatterName },
+        });
+        this.name = "FormatterError";
+        this.formatterName = formatterName;
+    }
+}
+/**
+ * Error thrown when secret scrubbing fails.
+ */
+export class ScrubberError extends LoggerError {
+    constructor(message, options = {}) {
+        super(message, {
+            code: LoggerErrorCode.SCRUBBER_ERROR,
+            cause: options.cause,
+            context: options.context,
+        });
+        this.name = "ScrubberError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/build/logger/core/errors.js.map

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

package/build/logger/core/format.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Logger Formatting Utilities
+ *
+ * Provides formatting functions for log output, such as truncating
+ * session IDs for readability and security.
+ *
+ * @module logger/core/format
+ */
+/**
+ * Formats a session ID for logging purposes.
+ *
+ * Truncates the session ID to keep logs readable while providing
+ * enough uniqueness for debugging. Also avoids exposing full
+ * session tokens in logs for security.
+ *
+ * @param sessionId - The full session ID
+ * @returns Truncated session ID (first 8 chars by default)
+ *
+ * @example
+ * ```typescript
+ * formatSessionId('a1b2c3d4-e5f6-7890-abcd-ef1234567890')
+ * // Returns: 'a1b2c3d4'
+ * ```
+ */
+export declare function formatSessionId(sessionId: string): string;
+/**
+ * Formats a request ID for logging purposes.
+ *
+ * @param requestId - The full request ID
+ * @returns Truncated request ID
+ */
+export declare function formatRequestId(requestId: string): string;
+/**
+ * Formats a trace ID for logging purposes.
+ *
+ * @param traceId - The full trace ID
+ * @returns Truncated trace ID
+ */
+export declare function formatTraceId(traceId: string): string;
+//# sourceMappingURL=format.d.ts.map

package/build/logger/core/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/logger/core/format.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/build/logger/core/format.js

@@ -0,0 +1,47 @@
+/**
+ * Logger Formatting Utilities
+ *
+ * Provides formatting functions for log output, such as truncating
+ * session IDs for readability and security.
+ *
+ * @module logger/core/format
+ */
+import { truncateId } from "../../utils/string-helpers.js";
+/**
+ * Formats a session ID for logging purposes.
+ *
+ * Truncates the session ID to keep logs readable while providing
+ * enough uniqueness for debugging. Also avoids exposing full
+ * session tokens in logs for security.
+ *
+ * @param sessionId - The full session ID
+ * @returns Truncated session ID (first 8 chars by default)
+ *
+ * @example
+ * ```typescript
+ * formatSessionId('a1b2c3d4-e5f6-7890-abcd-ef1234567890')
+ * // Returns: 'a1b2c3d4'
+ * ```
+ */
+export function formatSessionId(sessionId) {
+    return truncateId(sessionId);
+}
+/**
+ * Formats a request ID for logging purposes.
+ *
+ * @param requestId - The full request ID
+ * @returns Truncated request ID
+ */
+export function formatRequestId(requestId) {
+    return truncateId(requestId);
+}
+/**
+ * Formats a trace ID for logging purposes.
+ *
+ * @param traceId - The full trace ID
+ * @returns Truncated trace ID
+ */
+export function formatTraceId(traceId) {
+    return truncateId(traceId);
+}
+//# sourceMappingURL=format.js.map

package/build/logger/core/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/logger/core/format.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC"}

package/build/logger/core/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Logger Core Module
+ *
+ * Exports the fundamental types, constants, and context management
+ * for the logging system. This is the foundation that all other
+ * logger components build upon.
+ *
+ * @module logger/core
+ */
+export type { LogLevel, McpLogLevel, TransportMode, HttpContext, EventContext, LogContext, LoggerInterface, LogWriter, LogFormatter, LogEntryParams, LoggerConfig, LogNotificationHandler, } from "./types.js";
+export { LOG_LEVELS, LOG_SEVERITY, LOG_LEVEL_TO_MCP, MCP_LEVEL_ORDER, DEFAULT_LOG_LEVEL, DEFAULT_LOG_FORMAT, DEFAULT_SERVICE_NAME, ID_DISPLAY_LENGTH, LEVEL_PAD_LENGTH, LOG_FILE_EXTENSION, DEFAULT_LOG_COMPONENTS, LOGGER_COMPONENTS, SENSITIVE_KEYS, SENSITIVE_KEY_BLOCKLIST, REDACTED_VALUE, JWT_PREFIX, CONTROL_CHAR_REPLACEMENTS, CONTROL_CHAR_PATTERN, ANSI_ESCAPE_PATTERN, MAX_CONTEXT_DEPTH, COMPONENT_SEPARATOR, MAX_CHILD_LOGGER_CACHE_SIZE, MAX_MESSAGE_LENGTH, TRUNCATION_SUFFIX, } from "./constants.js";
+export type { SensitiveKey } from "./constants.js";
+export { runWithContext, getContext, getContextValue, hasContext, mergeContext, createChildContext, withExtendedContext, withChildContext, getContextDepth, } from "./context.js";
+export type { TraceContext, TraceContextExtractor } from "./trace-context.js";
+export { setTraceContextExtractor, extractTraceContext } from "./trace-context.js";
+export { LoggerErrorCode, LoggerError, LoggerInitError, WriterError, FormatterError, ScrubberError } from "./errors.js";
+export type { LoggerErrorCodeType } from "./errors.js";
+export { formatSessionId, formatRequestId, formatTraceId } from "./format.js";
+//# sourceMappingURL=index.d.ts.map

package/build/logger/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/logger/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,YAAY,EACV,QAAQ,EACR,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAEL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAEf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EAEpB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EAEjB,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,UAAU,EAEV,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EAEnB,iBAAiB,EACjB,mBAAmB,EAEnB,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAMnD,OAAO,EAEL,cAAc,EACd,UAAU,EACV,eAAe,EACf,UAAU,EAEV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAEhB,eAAe,GAChB,MAAM,cAAc,CAAC;AAMtB,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAMnF,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAExH,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMvD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/build/logger/core/index.js

@@ -0,0 +1,47 @@
+/**
+ * Logger Core Module
+ *
+ * Exports the fundamental types, constants, and context management
+ * for the logging system. This is the foundation that all other
+ * logger components build upon.
+ *
+ * @module logger/core
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+export { 
+// Log level configuration
+LOG_LEVELS, LOG_SEVERITY, LOG_LEVEL_TO_MCP, MCP_LEVEL_ORDER, 
+// Default configuration
+DEFAULT_LOG_LEVEL, DEFAULT_LOG_FORMAT, DEFAULT_SERVICE_NAME, 
+// Formatting constants
+ID_DISPLAY_LENGTH, LEVEL_PAD_LENGTH, LOG_FILE_EXTENSION, DEFAULT_LOG_COMPONENTS, LOGGER_COMPONENTS, 
+// Security constants (scrubbing)
+SENSITIVE_KEYS, SENSITIVE_KEY_BLOCKLIST, REDACTED_VALUE, JWT_PREFIX, 
+// Security constants (injection prevention)
+CONTROL_CHAR_REPLACEMENTS, CONTROL_CHAR_PATTERN, ANSI_ESCAPE_PATTERN, 
+// Context constants
+MAX_CONTEXT_DEPTH, COMPONENT_SEPARATOR, 
+// Performance constants
+MAX_CHILD_LOGGER_CACHE_SIZE, MAX_MESSAGE_LENGTH, TRUNCATION_SUFFIX, } from "./constants.js";
+// ============================================================================
+// Context Management
+// ============================================================================
+export { 
+// Core context functions
+runWithContext, getContext, getContextValue, hasContext, 
+// Context manipulation
+mergeContext, createChildContext, withExtendedContext, withChildContext, 
+// Utilities
+getContextDepth, } from "./context.js";
+export { setTraceContextExtractor, extractTraceContext } from "./trace-context.js";
+// ============================================================================
+// Errors
+// ============================================================================
+export { LoggerErrorCode, LoggerError, LoggerInitError, WriterError, FormatterError, ScrubberError } from "./errors.js";
+// ============================================================================
+// Formatting Utilities
+// ============================================================================
+export { formatSessionId, formatRequestId, formatTraceId } from "./format.js";
+//# sourceMappingURL=index.js.map

package/build/logger/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logger/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqBH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO;AACL,0BAA0B;AAC1B,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe;AACf,wBAAwB;AACxB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB;AACpB,uBAAuB;AACvB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB;AACjB,iCAAiC;AACjC,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,UAAU;AACV,4CAA4C;AAC5C,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB;AACnB,oBAAoB;AACpB,iBAAiB,EACjB,mBAAmB;AACnB,wBAAwB;AACxB,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAKxB,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,OAAO;AACL,yBAAyB;AACzB,cAAc,EACd,UAAU,EACV,eAAe,EACf,UAAU;AACV,uBAAuB;AACvB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB;AAChB,YAAY;AACZ,eAAe,GAChB,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEnF,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIxH,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}