@aifabrix/miso-client 3.4.2 → 3.8.0

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

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * Method chaining class for fluent logging API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerChain = void 0;
+const request_context_1 = require("../../utils/request-context");
+/**
+ * Method chaining class for fluent logging API
+ */
+class LoggerChain {
+    constructor(logger, context = {}, options = {}) {
+        this.logger = logger;
+        this.context = context;
+        this.options = options;
+    }
+    addContext(key, value) {
+        this.context[key] = value;
+        return this;
+    }
+    addUser(userId) {
+        this.options.userId = userId;
+        return this;
+    }
+    addApplication(applicationId) {
+        this.options.applicationId = applicationId;
+        return this;
+    }
+    addCorrelation(correlationId) {
+        this.options.correlationId = correlationId;
+        return this;
+    }
+    withToken(token) {
+        this.options.token = token;
+        return this;
+    }
+    withoutMasking() {
+        this.options.maskSensitiveData = false;
+        return this;
+    }
+    /**
+     * Add indexed logging context fields for fast queries
+     *
+     * @param context - Indexed logging context with source, external system, and record fields
+     * @returns LoggerChain instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * await logger
+     *   .withIndexedContext({
+     *     sourceKey: 'datasource-1',
+     *     sourceDisplayName: 'PostgreSQL DB',
+     *     externalSystemKey: 'system-1',
+     *     recordKey: 'record-123'
+     *   })
+     *   .info('Sync completed');
+     * ```
+     */
+    withIndexedContext(context) {
+        this.options.sourceKey = context.sourceKey;
+        this.options.sourceDisplayName = context.sourceDisplayName;
+        this.options.externalSystemKey = context.externalSystemKey;
+        this.options.externalSystemDisplayName = context.externalSystemDisplayName;
+        this.options.recordKey = context.recordKey;
+        this.options.recordDisplayName = context.recordDisplayName;
+        return this;
+    }
+    /**
+     * Add credential context for audit logging
+     *
+     * @param credentialId - Optional credential identifier
+     * @param credentialType - Optional credential type (e.g., 'oauth2', 'api-key')
+     * @returns LoggerChain instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * await logger
+     *   .withCredentialContext('cred-123', 'oauth2')
+     *   .info('API call completed');
+     * ```
+     */
+    withCredentialContext(credentialId, credentialType) {
+        this.options.credentialId = credentialId;
+        this.options.credentialType = credentialType;
+        return this;
+    }
+    /**
+     * Add request/response metrics for performance logging
+     *
+     * @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
+     *
+     * @example
+     * ```typescript
+     * await logger
+     *   .withRequestMetrics(1024, 2048, 150)
+     *   .info('Upstream API call completed');
+     * ```
+     */
+    withRequestMetrics(requestSize, responseSize, durationMs) {
+        this.options.requestSize = requestSize;
+        this.options.responseSize = responseSize;
+        this.options.durationMs = durationMs;
+        return this;
+    }
+    /**
+     * Auto-extract logging context from Express Request
+     * Extracts: IP, method, path, user-agent, correlation ID, user from JWT
+     *
+     * @param req - Express Request object
+     * @returns LoggerChain instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * await miso.log
+     *   .withRequest(req)
+     *   .info("Processing request");
+     * ```
+     */
+    withRequest(req) {
+        const ctx = (0, request_context_1.extractRequestContext)(req);
+        // Merge into options (these become top-level LogEntry fields)
+        if (ctx.userId) {
+            this.options.userId = ctx.userId;
+        }
+        if (ctx.sessionId) {
+            this.options.sessionId = ctx.sessionId;
+        }
+        if (ctx.correlationId) {
+            this.options.correlationId = ctx.correlationId;
+        }
+        if (ctx.requestId) {
+            this.options.requestId = ctx.requestId;
+        }
+        if (ctx.ipAddress) {
+            this.options.ipAddress = ctx.ipAddress;
+        }
+        if (ctx.userAgent) {
+            this.options.userAgent = ctx.userAgent;
+        }
+        // Merge into context (additional request info, not top-level LogEntry fields)
+        if (ctx.method) {
+            this.context.method = ctx.method;
+        }
+        if (ctx.path) {
+            this.context.path = ctx.path;
+        }
+        if (ctx.referer) {
+            this.context.referer = ctx.referer;
+        }
+        if (ctx.requestSize !== undefined) {
+            this.context.requestSize = ctx.requestSize;
+        }
+        return this;
+    }
+    async error(message, stackTrace) {
+        await this.logger.error(message, this.context, stackTrace, this.options);
+    }
+    async info(message) {
+        await this.logger.info(message, this.context, this.options);
+    }
+    async audit(action, resource) {
+        await this.logger.audit(action, resource, this.context, this.options);
+    }
+}
+exports.LoggerChain = LoggerChain;
+//# sourceMappingURL=logger-chain.js.map

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

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

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

@@ -0,0 +1,73 @@
+/**
+ * Logger context storage using AsyncLocalStorage
+ * Provides thread-safe context storage per async execution context
+ * Context is automatically isolated per async execution context
+ */
+/**
+ * Logger context interface
+ * Contains all fields that can be automatically extracted from requests or manually set
+ */
+export interface LoggerContext {
+    ipAddress?: string;
+    userAgent?: string;
+    correlationId?: string;
+    userId?: string;
+    sessionId?: string;
+    method?: string;
+    path?: string;
+    hostname?: string;
+    applicationId?: string;
+    requestId?: string;
+    token?: string;
+}
+/**
+ * Logger context storage singleton
+ * Uses AsyncLocalStorage to store context per async execution context
+ */
+declare class LoggerContextStorage {
+    private static instance;
+    private readonly asyncLocalStorage;
+    private constructor();
+    /**
+     * Get singleton instance
+     * @returns LoggerContextStorage instance
+     */
+    static getInstance(): LoggerContextStorage;
+    /**
+     * Get current context from AsyncLocalStorage
+     * @returns Current context or null if not set
+     */
+    getContext(): LoggerContext | null;
+    /**
+     * Set context for current async execution context
+     * @param context - Context to set (partial, will be merged with existing)
+     */
+    setContext(context: Partial<LoggerContext>): void;
+    /**
+     * Clear context for current async execution context
+     */
+    clearContext(): void;
+    /**
+     * Merge additional fields into existing context
+     * @param additional - Additional context fields to merge
+     */
+    mergeContext(additional: Partial<LoggerContext>): void;
+    /**
+     * 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<T>(context: Partial<LoggerContext>, fn: () => T): T;
+    /**
+     * 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
+     */
+    runWithContextAsync<T>(context: Partial<LoggerContext>, fn: () => Promise<T>): Promise<T>;
+}
+export { LoggerContextStorage };
+//# sourceMappingURL=logger-context-storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger-context-storage.d.ts","sourceRoot":"","sources":["../../../src/services/logger/logger-context-storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmC;IAErE,OAAO;IAIP;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,oBAAoB;IAO1C;;;OAGG;IACH,UAAU,IAAI,aAAa,GAAG,IAAI;IAQlC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAKjD;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAKtD;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAKlE;;;;;;OAMG;IACG,mBAAmB,CAAC,CAAC,EACzB,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;CAId;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

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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"}