@aifabrix/miso-client 3.5.0 → 3.8.0

package/dist/services/logger/logger-context-storage.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Logger context storage using AsyncLocalStorage
+ * Provides thread-safe context storage per async execution context
+ * Context is automatically isolated per async execution context
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerContextStorage = void 0;
+const async_hooks_1 = require("async_hooks");
+/**
+ * Logger context storage singleton
+ * Uses AsyncLocalStorage to store context per async execution context
+ */
+class LoggerContextStorage {
+    constructor() {
+        this.asyncLocalStorage = new async_hooks_1.AsyncLocalStorage();
+    }
+    /**
+     * Get singleton instance
+     * @returns LoggerContextStorage instance
+     */
+    static getInstance() {
+        if (!LoggerContextStorage.instance) {
+            LoggerContextStorage.instance = new LoggerContextStorage();
+        }
+        return LoggerContextStorage.instance;
+    }
+    /**
+     * Get current context from AsyncLocalStorage
+     * @returns Current context or null if not set
+     */
+    getContext() {
+        const store = this.asyncLocalStorage.getStore();
+        if (store === undefined) {
+            return null;
+        }
+        return store;
+    }
+    /**
+     * Set context for current async execution context
+     * @param context - Context to set (partial, will be merged with existing)
+     */
+    setContext(context) {
+        const current = this.asyncLocalStorage.getStore() || {};
+        this.asyncLocalStorage.enterWith({ ...current, ...context });
+    }
+    /**
+     * Clear context for current async execution context
+     */
+    clearContext() {
+        this.asyncLocalStorage.enterWith({});
+    }
+    /**
+     * Merge additional fields into existing context
+     * @param additional - Additional context fields to merge
+     */
+    mergeContext(additional) {
+        const current = this.asyncLocalStorage.getStore() || {};
+        this.asyncLocalStorage.enterWith({ ...current, ...additional });
+    }
+    /**
+     * Run function with context set
+     * Useful for setting context at the start of an async operation
+     * @param context - Context to set
+     * @param fn - Function to run with context
+     * @returns Result of function execution
+     */
+    runWithContext(context, fn) {
+        const merged = { ...(this.asyncLocalStorage.getStore() || {}), ...context };
+        return this.asyncLocalStorage.run(merged, fn);
+    }
+    /**
+     * Run async function with context set
+     * Useful for setting context at the start of an async operation
+     * @param context - Context to set
+     * @param fn - Async function to run with context
+     * @returns Promise resolving to result of function execution
+     */
+    async runWithContextAsync(context, fn) {
+        const merged = { ...(this.asyncLocalStorage.getStore() || {}), ...context };
+        return this.asyncLocalStorage.run(merged, fn);
+    }
+}
+exports.LoggerContextStorage = LoggerContextStorage;
+LoggerContextStorage.instance = null;
+//# sourceMappingURL=logger-context-storage.js.map

package/dist/services/logger/logger-context-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-context-storage.js","sourceRoot":"","sources":["../../../src/services/logger/logger-context-storage.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6CAAgD;AAoBhD;;;GAGG;AACH,MAAM,oBAAoB;IAIxB;QACE,IAAI,CAAC,iBAAiB,GAAG,IAAI,+BAAiB,EAAiB,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,CAAC;YACnC,oBAAoB,CAAC,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7D,CAAC;QACD,OAAO,oBAAoB,CAAC,QAAQ,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC;QAChD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,OAA+B;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,UAAkC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAI,OAA+B,EAAE,EAAW;QAC5D,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB,CACvB,OAA+B,EAC/B,EAAoB;QAEpB,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;;AAGM,oDAAoB;AAnFZ,6BAAQ,GAAgC,IAAI,CAAC"}

package/dist/services/logger/logger-context.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Logger context extraction utilities
+ * Provides functions for extracting JWT context, environment metadata, and building LogEntry objects
+ */
+import { Request } from "express";
+import { LogEntry, MisoClientConfig } from "../../types/config.types";
+/**
+ * Extract JWT token information
+ * @param token - JWT token string
+ * @returns Extracted context with userId, applicationId, sessionId, roles, permissions
+ */
+export declare function extractJwtContext(token?: string): {
+    userId?: string;
+    applicationId?: string;
+    sessionId?: string;
+    roles?: string[];
+    permissions?: string[];
+};
+/**
+ * Extract metadata from environment (browser or Node.js)
+ * @returns Partial LogEntry with environment metadata
+ */
+export declare function extractEnvironmentMetadata(): Partial<LogEntry>;
+/**
+ * Get LogEntry object with request context extracted
+ * Extracts IP, method, path, userAgent, correlationId, userId from Express Request
+ * Returns structured LogEntry object ready for external logger tables
+ *
+ * @param req - Express Request object
+ * @param message - Log message
+ * @param level - Optional log level (defaults to 'info')
+ * @param context - Optional additional context
+ * @param config - MisoClientConfig for application identifier
+ * @param generateCorrelationId - Function to generate correlation ID
+ * @param maskSensitiveData - Whether to mask sensitive data
+ * @returns Complete LogEntry object with all request context extracted
+ *
+ * @example
+ * ```typescript
+ * const logEntry = getLogWithRequest(req, 'User action', 'info', { action: 'login' }, config, generateCorrelationId, true);
+ * await myCustomLogger.save(logEntry);
+ * ```
+ */
+export declare function getLogWithRequest(req: Request, message: string, level: LogEntry["level"] | undefined, context: Record<string, unknown> | undefined, config: MisoClientConfig, generateCorrelationId: () => string, maskSensitiveData: boolean): LogEntry;
+/**
+ * Get LogEntry object with provided context
+ * Generates correlation ID automatically and extracts metadata from environment
+ *
+ * @param context - Context object to include in logs
+ * @param message - Log message
+ * @param level - Optional log level (defaults to 'info')
+ * @param config - MisoClientConfig for application identifier
+ * @param generateCorrelationId - Function to generate correlation ID
+ * @param maskSensitiveData - Whether to mask sensitive data
+ * @returns Complete LogEntry object
+ *
+ * @example
+ * ```typescript
+ * const logEntry = getWithContext({ operation: 'sync' }, 'Sync started', 'info', config, generateCorrelationId, true);
+ * await myCustomLogger.save(logEntry);
+ * ```
+ */
+export declare function getWithContext(context: Record<string, unknown>, message: string, level: LogEntry["level"] | undefined, config: MisoClientConfig, generateCorrelationId: () => string, maskSensitiveData: boolean): LogEntry;
+/**
+ * Get LogEntry object with token context extracted
+ * Extracts userId, sessionId, applicationId from JWT token
+ * Generates correlation ID automatically
+ *
+ * @param token - JWT token to extract user context from
+ * @param message - Log message
+ * @param level - Optional log level (defaults to 'info')
+ * @param context - Optional additional context
+ * @param config - MisoClientConfig for application identifier
+ * @param generateCorrelationId - Function to generate correlation ID
+ * @param maskSensitiveData - Whether to mask sensitive data
+ * @returns Complete LogEntry object with user context
+ *
+ * @example
+ * ```typescript
+ * const logEntry = getWithToken(token, 'Token validated', 'audit', undefined, config, generateCorrelationId, true);
+ * await myCustomLogger.save(logEntry);
+ * ```
+ */
+export declare function getWithToken(token: string, message: string, level: LogEntry["level"] | undefined, context: Record<string, unknown> | undefined, config: MisoClientConfig, generateCorrelationId: () => string, maskSensitiveData: boolean): LogEntry;
+//# sourceMappingURL=logger-context.d.ts.map

package/dist/services/logger/logger-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-context.d.ts","sourceRoot":"","sources":["../../../src/services/logger/logger-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAItE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CA0BA;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAAC,QAAQ,CAAC,CAuB9D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,YAAS,EACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5C,MAAM,EAAE,gBAAgB,EACxB,qBAAqB,EAAE,MAAM,MAAM,EACnC,iBAAiB,EAAE,OAAO,GACzB,QAAQ,CAgCV;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,YAAS,EACjC,MAAM,EAAE,gBAAgB,EACxB,qBAAqB,EAAE,MAAM,MAAM,EACnC,iBAAiB,EAAE,OAAO,GACzB,QAAQ,CAoBV;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,YAAS,EACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5C,MAAM,EAAE,gBAAgB,EACxB,qBAAqB,EAAE,MAAM,MAAM,EACnC,iBAAiB,EAAE,OAAO,GACzB,QAAQ,CAwBV"}

package/dist/services/logger/logger-context.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * Logger context extraction utilities
+ * Provides functions for extracting JWT context, environment metadata, and building LogEntry objects
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractJwtContext = extractJwtContext;
+exports.extractEnvironmentMetadata = extractEnvironmentMetadata;
+exports.getLogWithRequest = getLogWithRequest;
+exports.getWithContext = getWithContext;
+exports.getWithToken = getWithToken;
+const jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
+const data_masker_1 = require("../../utils/data-masker");
+const request_context_1 = require("../../utils/request-context");
+/**
+ * Extract JWT token information
+ * @param token - JWT token string
+ * @returns Extracted context with userId, applicationId, sessionId, roles, permissions
+ */
+function extractJwtContext(token) {
+    if (!token)
+        return {};
+    try {
+        const decoded = jsonwebtoken_1.default.decode(token);
+        if (!decoded)
+            return {};
+        return {
+            userId: (decoded.sub || decoded.userId || decoded.user_id),
+            applicationId: (decoded.applicationId || decoded.app_id),
+            sessionId: (decoded.sessionId || decoded.sid),
+            roles: (decoded.roles ||
+                decoded.realm_access?.roles ||
+                []),
+            permissions: (decoded.permissions ||
+                decoded.scope?.split(" ") ||
+                []),
+        };
+    }
+    catch (error) {
+        // JWT parsing failed, return empty context
+        return {};
+    }
+}
+/**
+ * Extract metadata from environment (browser or Node.js)
+ * @returns Partial LogEntry with environment metadata
+ */
+function extractEnvironmentMetadata() {
+    const metadata = {};
+    // Try to extract browser metadata
+    if (typeof globalThis !== "undefined" && "window" in globalThis) {
+        const win = globalThis;
+        const navigator = win.window?.navigator;
+        const location = win.window?.location;
+        metadata.userAgent = navigator?.userAgent;
+        metadata.hostname = location?.hostname;
+    }
+    // Try to extract Node.js metadata
+    if (typeof process !== "undefined" && process.env) {
+        metadata.hostname = process.env["HOSTNAME"] || "unknown";
+    }
+    return metadata;
+}
+/**
+ * Get LogEntry object with request context extracted
+ * Extracts IP, method, path, userAgent, correlationId, userId from Express Request
+ * Returns structured LogEntry object ready for external logger tables
+ *
+ * @param req - Express Request object
+ * @param message - Log message
+ * @param level - Optional log level (defaults to 'info')
+ * @param context - Optional additional context
+ * @param config - MisoClientConfig for application identifier
+ * @param generateCorrelationId - Function to generate correlation ID
+ * @param maskSensitiveData - Whether to mask sensitive data
+ * @returns Complete LogEntry object with all request context extracted
+ *
+ * @example
+ * ```typescript
+ * const logEntry = getLogWithRequest(req, 'User action', 'info', { action: 'login' }, config, generateCorrelationId, true);
+ * await myCustomLogger.save(logEntry);
+ * ```
+ */
+function getLogWithRequest(req, message, level = "info", context, config, generateCorrelationId, maskSensitiveData) {
+    const requestContext = (0, request_context_1.extractRequestContext)(req);
+    const jwtContext = extractJwtContext(req.headers.authorization?.replace("Bearer ", ""));
+    const metadata = extractEnvironmentMetadata();
+    const correlationId = requestContext.correlationId || generateCorrelationId();
+    // Mask sensitive data in context if enabled
+    const maskedContext = maskSensitiveData && context
+        ? data_masker_1.DataMasker.maskSensitiveData(context)
+        : context;
+    return {
+        timestamp: new Date().toISOString(),
+        level,
+        environment: "unknown", // Backend extracts from client credentials
+        application: config.clientId,
+        applicationId: jwtContext.applicationId || "",
+        message,
+        context: maskedContext,
+        correlationId,
+        userId: requestContext.userId || jwtContext.userId,
+        sessionId: requestContext.sessionId || jwtContext.sessionId,
+        requestId: requestContext.requestId,
+        ipAddress: requestContext.ipAddress || metadata.ipAddress,
+        userAgent: requestContext.userAgent || metadata.userAgent,
+        ...metadata,
+    };
+}
+/**
+ * Get LogEntry object with provided context
+ * Generates correlation ID automatically and extracts metadata from environment
+ *
+ * @param context - Context object to include in logs
+ * @param message - Log message
+ * @param level - Optional log level (defaults to 'info')
+ * @param config - MisoClientConfig for application identifier
+ * @param generateCorrelationId - Function to generate correlation ID
+ * @param maskSensitiveData - Whether to mask sensitive data
+ * @returns Complete LogEntry object
+ *
+ * @example
+ * ```typescript
+ * const logEntry = getWithContext({ operation: 'sync' }, 'Sync started', 'info', config, generateCorrelationId, true);
+ * await myCustomLogger.save(logEntry);
+ * ```
+ */
+function getWithContext(context, message, level = "info", config, generateCorrelationId, maskSensitiveData) {
+    const metadata = extractEnvironmentMetadata();
+    const correlationId = generateCorrelationId();
+    // Mask sensitive data in context if enabled
+    const maskedContext = maskSensitiveData
+        ? data_masker_1.DataMasker.maskSensitiveData(context)
+        : context;
+    return {
+        timestamp: new Date().toISOString(),
+        level,
+        environment: "unknown", // Backend extracts from client credentials
+        application: config.clientId,
+        applicationId: "",
+        message,
+        context: maskedContext,
+        correlationId,
+        ...metadata,
+    };
+}
+/**
+ * Get LogEntry object with token context extracted
+ * Extracts userId, sessionId, applicationId from JWT token
+ * Generates correlation ID automatically
+ *
+ * @param token - JWT token to extract user context from
+ * @param message - Log message
+ * @param level - Optional log level (defaults to 'info')
+ * @param context - Optional additional context
+ * @param config - MisoClientConfig for application identifier
+ * @param generateCorrelationId - Function to generate correlation ID
+ * @param maskSensitiveData - Whether to mask sensitive data
+ * @returns Complete LogEntry object with user context
+ *
+ * @example
+ * ```typescript
+ * const logEntry = getWithToken(token, 'Token validated', 'audit', undefined, config, generateCorrelationId, true);
+ * await myCustomLogger.save(logEntry);
+ * ```
+ */
+function getWithToken(token, message, level = "info", context, config, generateCorrelationId, maskSensitiveData) {
+    const jwtContext = extractJwtContext(token);
+    const metadata = extractEnvironmentMetadata();
+    const correlationId = generateCorrelationId();
+    // Mask sensitive data in context if enabled
+    const maskedContext = maskSensitiveData && context
+        ? data_masker_1.DataMasker.maskSensitiveData(context)
+        : context;
+    return {
+        timestamp: new Date().toISOString(),
+        level,
+        environment: "unknown", // Backend extracts from client credentials
+        application: config.clientId,
+        applicationId: jwtContext.applicationId || "",
+        message,
+        context: maskedContext,
+        correlationId,
+        userId: jwtContext.userId,
+        sessionId: jwtContext.sessionId,
+        ...metadata,
+    };
+}
+//# sourceMappingURL=logger-context.js.map

package/dist/services/logger/logger-context.js.map

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

package/dist/services/{logger.service.d.ts → logger/logger.service.d.ts}

@@ -3,10 +3,11 @@
  */
 import { EventEmitter } from "events";
 import { Request } from "express";
-import { HttpClient } from "../utils/http-client";
-import { ApiClient } from "../api";
-import { RedisService } from "./redis.service";
-import { IndexedLoggingContext } from "../utils/logging-helpers";
+import { HttpClient } from "../../utils/http-client";
+import { ApiClient } from "../../api";
+import { RedisService } from "../redis.service";
+import { LogEntry } from "../../types/config.types";
+import { LoggerChain } from "./logger-chain";
 export interface ClientLoggingOptions {
     applicationId?: string;
     userId?: string;
@@ -55,16 +56,16 @@ export declare class LoggerService extends EventEmitter {
     setMasking(enabled: boolean): void;
     /**
      * Generate unique correlation ID for request tracking
+     * Public method to allow other modules to generate consistent correlation IDs
+     *
+     * @returns Unique correlation ID string
+     *
+     * @example
+     * ```typescript
+     * const correlationId = loggerService.generateCorrelationId();
+     * ```
      */
-    private generateCorrelationId;
-    /**
-     * Extract JWT token information
-     */
-    private extractJWTContext;
-    /**
-     * Extract metadata from environment (browser or Node.js)
-     */
-    private extractMetadata;
+    generateCorrelationId(): string;
     /**
      * Log error message with optional stack trace and enhanced options
      */
@@ -92,100 +93,86 @@ export declare class LoggerService extends EventEmitter {
     withToken(token: string): LoggerChain;
     withoutMasking(): LoggerChain;
     /**
-     * Create logger chain with request context pre-populated
-     * Auto-extracts: IP, method, path, user-agent, correlation ID, user from JWT
+     * Get LogEntry object with request context extracted
+     * Extracts IP, method, path, userAgent, correlationId, userId from Express Request
+     * Returns structured LogEntry object ready for external logger tables
      *
      * @param req - Express Request object
-     * @returns LoggerChain with request context pre-populated
+     * @param message - Log message
+     * @param level - Optional log level (defaults to 'info')
+     * @param context - Optional additional context
+     * @returns Complete LogEntry object with all request context extracted
      *
      * @example
      * ```typescript
-     * await miso.log.forRequest(req).info("Processing request");
+     * const logEntry = client.log.getLogWithRequest(req, 'User action', 'info', { action: 'login' });
+     * await myCustomLogger.save(logEntry); // Save to own logger table
      * ```
      */
-    forRequest(req: Request): LoggerChain;
-}
-/**
- * Method chaining class for fluent logging API
- */
-export declare class LoggerChain {
-    private logger;
-    private context;
-    private options;
-    constructor(logger: LoggerService, context?: Record<string, unknown>, options?: ClientLoggingOptions);
-    addContext(key: string, value: unknown): LoggerChain;
-    addUser(userId: string): LoggerChain;
-    addApplication(applicationId: string): LoggerChain;
-    addCorrelation(correlationId: string): LoggerChain;
-    withToken(token: string): LoggerChain;
-    withoutMasking(): LoggerChain;
+    getLogWithRequest(req: Request, message: string, level?: LogEntry["level"], context?: Record<string, unknown>): LogEntry;
     /**
-     * Add indexed logging context fields for fast queries
+     * Get LogEntry object with provided context
+     * Generates correlation ID automatically and extracts metadata from environment
      *
-     * @param context - Indexed logging context with source, external system, and record fields
-     * @returns LoggerChain instance for method chaining
+     * @param context - Context object to include in logs
+     * @param message - Log message
+     * @param level - Optional log level (defaults to 'info')
+     * @returns Complete LogEntry object
      *
      * @example
      * ```typescript
-     * await logger
-     *   .withIndexedContext({
-     *     sourceKey: 'datasource-1',
-     *     sourceDisplayName: 'PostgreSQL DB',
-     *     externalSystemKey: 'system-1',
-     *     recordKey: 'record-123'
-     *   })
-     *   .info('Sync completed');
+     * const logEntry = client.log.getWithContext({ operation: 'sync' }, 'Sync started');
+     * await myCustomLogger.save(logEntry);
      * ```
      */
-    withIndexedContext(context: IndexedLoggingContext): LoggerChain;
+    getWithContext(context: Record<string, unknown>, message: string, level?: LogEntry["level"]): LogEntry;
     /**
-     * Add credential context for audit logging
+     * Get LogEntry object with token context extracted
+     * Extracts userId, sessionId, applicationId from JWT token
+     * Generates correlation ID automatically
      *
-     * @param credentialId - Optional credential identifier
-     * @param credentialType - Optional credential type (e.g., 'oauth2', 'api-key')
-     * @returns LoggerChain instance for method chaining
+     * @param token - JWT token to extract user context from
+     * @param message - Log message
+     * @param level - Optional log level (defaults to 'info')
+     * @param context - Optional additional context
+     * @returns Complete LogEntry object with user context
      *
      * @example
      * ```typescript
-     * await logger
-     *   .withCredentialContext('cred-123', 'oauth2')
-     *   .info('API call completed');
+     * const logEntry = client.log.getWithToken(token, 'Token validated', 'audit');
+     * await myCustomLogger.save(logEntry);
      * ```
      */
-    withCredentialContext(credentialId?: string, credentialType?: string): LoggerChain;
+    getWithToken(token: string, message: string, level?: LogEntry["level"], context?: Record<string, unknown>): LogEntry;
     /**
-     * Add request/response metrics for performance logging
+     * Get LogEntry object with request context extracted (alias for getLogWithRequest)
+     * Alias for getLogWithRequest() for consistency with existing forRequest() pattern
      *
-     * @param requestSize - Optional request size in bytes
-     * @param responseSize - Optional response size in bytes
-     * @param durationMs - Optional request duration in milliseconds
-     * @returns LoggerChain instance for method chaining
+     * @param req - Express Request object
+     * @param message - Log message
+     * @param level - Optional log level (defaults to 'info')
+     * @param context - Optional additional context
+     * @returns Complete LogEntry object
      *
      * @example
      * ```typescript
-     * await logger
-     *   .withRequestMetrics(1024, 2048, 150)
-     *   .info('Upstream API call completed');
+     * const logEntry = client.log.getForRequest(req, 'User action', 'info', { action: 'login' });
+     * await myCustomLogger.save(logEntry);
      * ```
      */
-    withRequestMetrics(requestSize?: number, responseSize?: number, durationMs?: number): LoggerChain;
+    getForRequest(req: Request, message: string, level?: LogEntry["level"], context?: Record<string, unknown>): LogEntry;
     /**
-     * Auto-extract logging context from Express Request
-     * Extracts: IP, method, path, user-agent, correlation ID, user from JWT
+     * Create logger chain with request context pre-populated
+     * Auto-extracts: IP, method, path, user-agent, correlation ID, user from JWT
      *
      * @param req - Express Request object
-     * @returns LoggerChain instance for method chaining
+     * @returns LoggerChain with request context pre-populated
      *
      * @example
      * ```typescript
-     * await miso.log
-     *   .withRequest(req)
-     *   .info("Processing request");
+     * await miso.log.forRequest(req).info("Processing request");
      * ```
      */
-    withRequest(req: Request): LoggerChain;
-    error(message: string, stackTrace?: string): Promise<void>;
-    info(message: string): Promise<void>;
-    audit(action: string, resource: string): Promise<void>;
+    forRequest(req: Request): LoggerChain;
 }
 //# sourceMappingURL=logger.service.d.ts.map

package/dist/services/logger/logger.service.d.ts.map

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