logiscout 1.0.3 → 1.0.4

package/dist/esm/middlewares/correlationMiddleware.js

@@ -1,63 +1,31 @@
 import { RequestContext } from "../core/context/RequestContext.js";
-import crypto from "crypto";
+import { endSession, getOrCreateSession, removeSession, } from "../core/store/CorrelationStore.js";
 import { getLogiScouConfig } from "../initiator/state.js";
-export const createCorrelationMiddleware = () => {
+import { ServerTransporter } from "../services/transporter/ServerTransporter.js";
+const serverTransporter = new ServerTransporter();
+export function createCorrelationMiddleware() {
     return (req, res, next) => {
-        // Validate request object
-        const { projectName, environment } = getLogiScouConfig(); // 🔒 guard
-        if (!req || typeof req !== "object") {
-            console.error("[CorrelationMiddleware] Error: Invalid request object. " +
-                "Usage: createCorrelationMiddleware()(req, res, next)");
-            next?.(new Error("Invalid request object in correlation middleware"));
-            return;
-        }
-        // Validate response object
-        if (!res || typeof res !== "object") {
-            console.error("[CorrelationMiddleware] Error: Invalid response object. " +
-                "Usage: createCorrelationMiddleware()(req, res, next)");
-            next?.(new Error("Invalid response object in correlation middleware"));
-            return;
-        }
-        try {
-            // Check for existing correlation ID in headers (case-insensitive)
-            const headers = req.headers || {};
-            const existingId = headers["x-correlation-id"] ||
-                headers["X-Correlation-ID"] ||
-                req.get?.("x-correlation-id") ||
-                req.get?.("X-Correlation-ID");
-            const correlationId = (typeof existingId === "string" && existingId.trim()) || crypto.randomUUID();
-            // Validate correlation ID
-            if (!correlationId || typeof correlationId !== "string") {
-                console.error("[CorrelationMiddleware] Error: Failed to generate or retrieve correlation ID");
-                next?.(new Error("Correlation ID generation failed"));
-                return;
-            }
-            if (correlationId.length > 100) {
-                console.warn("[CorrelationMiddleware] Warning: Correlation ID exceeds 100 characters and will be truncated");
-            }
-            // Run the remaining middleware in the request context
-            RequestContext.run(() => {
-                // Safely set the correlation ID header
-                try {
-                    if (res.setHeader) {
-                        res.setHeader("x-correlation-id", correlationId);
-                    }
-                }
-                catch (headerError) {
-                    // setHeader might fail in some edge cases, don't block the request
-                    console.warn("[CorrelationMiddleware] Warning: Could not set x-correlation-id header", headerError instanceof Error ? headerError.message : "Unknown error");
-                }
-                // Store correlation ID in response locals for downstream access
-                if (res.locals) {
-                    res.locals.correlationId = correlationId;
-                }
-                next?.();
-            }, correlationId);
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : "Unknown error";
-            console.error(`[CorrelationMiddleware] Error: Failed to initialize request context. ${errorMessage}`);
-            next?.(error instanceof Error ? error : new Error("Request context initialization failed"));
-        }
+        const correlationId = req.headers["x-correlation-id"] ?? crypto.randomUUID();
+        RequestContext.run(() => {
+            const session = getOrCreateSession(correlationId, {
+                projectName: getLogiScouConfig().projectName,
+                environment: getLogiScouConfig().environment,
+                correlationId,
+                request: {
+                    method: req.method,
+                    path: req.originalUrl || req.url,
+                },
+            });
+            res.setHeader("x-correlation-id", correlationId);
+            console.log("----- SENDING TO THE SERVER-----------");
+            res.on("finish", () => {
+                session.request.statusCode = res.statusCode;
+                const payload = endSession(correlationId);
+                if (payload)
+                    serverTransporter.transport(payload);
+                removeSession(correlationId);
+            });
+            next();
+        }, correlationId);
     };
-};
+}

package/dist/esm/services/Levels/Levels.d.ts

@@ -1,10 +1,20 @@
 import { Logger } from "../Logger/Logger.js";
 import { LoggerInterface } from "../../core/interface/LoggerInterface.js";
 export declare class Levels extends Logger implements LoggerInterface {
-    info(message: string, meta?: Record<string, unknown>): void;
-    warn(message: string, meta?: Record<string, unknown>): void;
-    error(message: string, meta?: Record<string, unknown>): void;
-    debug(message: string, meta?: Record<string, unknown>): void;
-    critical(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>, options?: {
+        send?: boolean;
+    }): void;
+    warn(message: string, meta?: Record<string, unknown>, options?: {
+        send?: boolean;
+    }): void;
+    error(message: string, meta?: Record<string, unknown>, options?: {
+        send?: boolean;
+    }): void;
+    debug(message: string, meta?: Record<string, unknown>, options?: {
+        send?: boolean;
+    }): void;
+    critical(message: string, meta?: Record<string, unknown>, options?: {
+        send?: boolean;
+    }): void;
 }
 //# sourceMappingURL=Levels.d.ts.map

package/dist/esm/services/Levels/Levels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Levels.d.ts","sourceRoot":"","sources":["../../../../src/services/Levels/Levels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE1E,qBAAa,MAAO,SAAQ,MAAO,YAAW,eAAe;IAC3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK5D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAKhE"}
+{"version":3,"file":"Levels.d.ts","sourceRoot":"","sources":["../../../../src/services/Levels/Levels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE1E,qBAAa,MAAO,SAAQ,MAAO,YAAW,eAAe;IAC3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAG,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAK1F,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAKzF,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAK1F,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAG,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAK3F,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAG,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;CAK/F"}

package/dist/esm/services/Levels/Levels.js

@@ -1,24 +1,24 @@
 import { Logger } from "../Logger/Logger.js";
 import { LogLevels } from "../../core/enum/LogLevels.js";
 export class Levels extends Logger {
-    info(message, meta) {
-        const entry = this.getLogEntry(message, LogLevels.INFO, meta);
+    info(message, meta, options) {
+        const entry = this.getLogEntry(message, LogLevels.INFO, meta, options);
         this.log(entry);
     }
-    warn(message, meta) {
-        const entry = this.getLogEntry(message, LogLevels.WARN, meta);
+    warn(message, meta, options) {
+        const entry = this.getLogEntry(message, LogLevels.WARN, meta, options);
         this.log(entry);
     }
-    error(message, meta) {
-        const entry = this.getLogEntry(message, LogLevels.ERROR, meta);
+    error(message, meta, options) {
+        const entry = this.getLogEntry(message, LogLevels.ERROR, meta, options);
         this.log(entry);
     }
-    debug(message, meta) {
-        const entry = this.getLogEntry(message, LogLevels.DEBUG, meta);
+    debug(message, meta, options) {
+        const entry = this.getLogEntry(message, LogLevels.DEBUG, meta, options);
         this.log(entry);
     }
-    critical(message, meta) {
-        const entry = this.getLogEntry(message, LogLevels.CRITICAL, meta);
+    critical(message, meta, options) {
+        const entry = this.getLogEntry(message, LogLevels.CRITICAL, meta, options);
         this.log(entry);
     }
 }

package/dist/esm/services/Logger/Logger.d.ts

@@ -7,9 +7,14 @@ export declare abstract class Logger {
     private componentName;
     private projectName;
     private environment;
+    private readonly jsonizer;
+    private readonly serverTransporter;
+    private readonly consoleTransporter;
     constructor(componentName: string, config: LogiscoutConfig);
     protected log(entry: LogEntry): void;
     getWinstonLogger(): WinstonLogger;
-    protected getLogEntry(message: string, logLevel: LogLevels, meta?: Record<string, unknown>): LogEntry;
+    protected getLogEntry(message: string, logLevel: LogLevels, meta?: Record<string, unknown>, options?: {
+        send?: boolean;
+    }): LogEntry;
 }
 //# sourceMappingURL=Logger.d.ts.map

package/dist/esm/services/Logger/Logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../../src/services/Logger/Logger.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,MAAM,IAAI,aAAa,EAAsB,MAAM,SAAS,CAAC;AAE/E,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAGxD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAI3D,8BAAsB,MAAM;IAC1B,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,WAAW,CAAQ;gBAEf,aAAa,EAAE,MAAM,EAAG,MAAM,EAAC,eAAe;IAwE1D,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAsEpC,gBAAgB,IAAI,aAAa;IAIjC,SAAS,CAAC,WAAW,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,SAAS,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,QAAQ;CA0BZ"}
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../../src/services/Logger/Logger.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,MAAM,IAAI,aAAa,EAAsB,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAW3D,8BAAsB,MAAM;IAC1B,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAmB;gBAE1C,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe;IA6B1D,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IA0CpC,gBAAgB,IAAI,aAAa;IAIjC,SAAS,CAAC,WAAW,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,SAAS,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3B,QAAQ;CAgBZ"}

package/dist/esm/services/Logger/Logger.js

@@ -1,122 +1,75 @@
-import winston, { format, transports } from "winston";
+import winston from "winston";
 import { LogLevels } from "../../core/enum/LogLevels.js";
 import { RequestContext } from "../../core/context/RequestContext.js";
-import { ConsoleFormatter } from "../formatters/ConsoleFormatter.js";
+import { ConsoleTransporter } from "../transporter/ConsoleTranspoter.js";
+import { LOG_LEVEL_SEVERITY } from "../../core/constants/Levels/LevelsSeverity.js";
+import validateComponentName from "../../validator/ValidateComponentName.js";
+import { throwError } from "../../errors/ThrowError.js";
+import validateLogEntry from "../../validator/ValidateLogEntry.js";
+import validateLogMessage from "../../validator/ValidateLogMessage.js";
+import validateLogLevel from "../../validator/ValidateLogLevel.js";
+import { Jsonizer } from "../processors/Jsonizer.js";
+import { ServerTransporter } from "../transporter/ServerTransporter.js";
 export class Logger {
     winstonLogger;
     componentName;
     projectName;
     environment;
+    jsonizer;
+    serverTransporter;
+    consoleTransporter;
     constructor(componentName, config) {
-        // Validate component name
-        if (!componentName || typeof componentName !== "string") {
-            throw new Error("Logger: Component name must be a non-empty string. " +
-                "Usage: createLogger('ComponentName')");
-        }
-        if (componentName.length > 100) {
-            throw new Error("Logger: Component name cannot exceed 100 characters. " +
-                `Received: '${componentName.substring(0, 20)}...'`);
-        }
+        validateComponentName(componentName);
         this.componentName = componentName;
         this.projectName = config.projectName;
         this.environment = config.environment;
+        this.jsonizer = new Jsonizer({
+            projectName: this.projectName,
+            environment: this.environment,
+            componentName: this.componentName,
+        });
+        this.serverTransporter = new ServerTransporter();
+        this.consoleTransporter = new ConsoleTransporter();
         try {
-            // Create structlog-style formatter instance
-            const consoleFormatter = new ConsoleFormatter();
             this.winstonLogger = winston.createLogger({
-                level: "debug",
-                levels: {
-                    error: 0,
-                    warn: 1,
-                    info: 2,
-                    debug: 3,
-                },
-                // File transport format (non-colorized)
-                format: format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.printf(({ timestamp, level, message, component, ...meta }) => {
-                    const formatted = consoleFormatter.format({
-                        level: level,
-                        message: String(message),
-                        timestamp: String(timestamp),
-                        component: component,
-                        ...meta,
-                    });
-                    return `[${config.projectName}] ${formatted}`;
-                })),
-                transports: [
-                    new transports.Console({
-                        // Console transport with structlog-style formatting and colors
-                        format: format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.printf(({ timestamp, level, message, component, ...meta }) => {
-                            const formatted = consoleFormatter.format({
-                                level: level,
-                                message: String(message),
-                                timestamp: String(timestamp),
-                                component: component,
-                                ...meta,
-                            });
-                            return formatted;
-                        })),
-                    }),
-                ],
+                level: LogLevels.DEBUG,
+                levels: LOG_LEVEL_SEVERITY,
+                transports: [this.consoleTransporter.transport()],
             });
         }
         catch (error) {
-            throw new Error(`Logger: Failed to initialize Winston logger. ${error instanceof Error ? error.message : "Unknown error"}`);
+            throwError(`Logger: Failed to initialize Winston logger. ${error instanceof Error ? error.message : "Unknown error"}`);
         }
     }
     log(entry) {
         try {
             // Validate log entry
-            if (!entry) {
-                console.error("[Logiscout] Error: Log entry is undefined or null");
-                return;
-            }
-            if (!entry.message || typeof entry.message !== "string") {
-                console.error("[Logiscout] Error: Log message must be a non-empty string. " +
-                    `Usage: logiscout.${entry.level}('Your message', { meta })`);
-                return;
-            }
-            if (entry.message.length > 10000) {
-                console.error("[Logiscout] Error: Log message exceeds 10000 characters. " +
-                    "Message truncated for logging.");
-                entry.message = entry.message.substring(0, 10000) + "... [truncated]";
-            }
+            validateLogEntry(entry);
             const correlationId = RequestContext.getCorrelationId() ?? "no-correlation-id";
-            // Safely handle metadata - prevent circular reference issues
-            let logMeta;
-            try {
-                logMeta = {
-                    component: this.componentName,
-                    correlationId,
-                    ...entry.meta,
-                };
-            }
-            catch (metaError) {
-                console.error("[Logiscout] Error: Failed to process metadata. Logging without metadata.", metaError instanceof Error ? metaError.message : "Unknown error");
-                logMeta = {
-                    component: this.componentName,
-                    correlationId,
-                    _metaError: "Failed to process metadata",
-                };
-            }
+            let logMeta = {
+                component: this.componentName,
+                correlationId,
+                ...(entry.meta ?? {}),
+            };
             this.winstonLogger.log(entry.level, entry.message, logMeta);
+            this.jsonizer.appendLog(correlationId, {
+                timestamp: new Date().toISOString(),
+                level: entry.level,
+                message: entry.message,
+                meta: logMeta,
+            });
+            const logs = {
+                ...entry,
+                projectName: this.projectName,
+                component: this.componentName,
+                correlationId,
+            };
             if (entry.send && this.environment == "prod") {
                 // console.log("sending to he server")
-                // Send structured log to API (no formatting)
-                // LogApi({
-                //   logs: {
-                //     ...entry,
-                //     component: this.componentName,
-                //     correlationId,
-                //   },
-                // });
-            }
-            else {
-                // console.log("Showed to the user")
+                this.serverTransporter.transport(logs);
             }
         }
         catch (error) {
-            // Silent failure - logger should never crash the application
-            // Log to console as last resort
             const errorMessage = error instanceof Error ? error.message : "Unknown error";
             console.error(`[Logiscout] Critical: Logger failed to write log: ${errorMessage}`);
         }
@@ -124,23 +77,17 @@ export class Logger {
     getWinstonLogger() {
         return this.winstonLogger;
     }
-    getLogEntry(message, logLevel, meta) {
+    getLogEntry(message, logLevel, meta, options) {
         // Validate message
-        if (!message || typeof message !== "string") {
-            throw new Error(`Logger: Message must be a non-empty string. ` +
-                `Received: ${typeof message === "undefined" ? "undefined" : typeof message}`);
-        }
+        validateLogMessage(message);
         // Validate log level
-        if (!Object.values(LogLevels).includes(logLevel)) {
-            throw new Error(`Logger: Invalid log level '${logLevel}'. ` +
-                `Valid levels: ${Object.values(LogLevels).join(", ")}`);
-        }
+        validateLogLevel(logLevel);
         const entry = {
             message,
             meta,
             timestamp: new Date().toISOString(),
             level: logLevel,
-            send: true
+            send: options?.send ?? true,
         };
         return entry;
     }

package/dist/esm/services/formatters/ConsoleFormatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConsoleFormatter.d.ts","sourceRoot":"","sources":["../../../../src/services/formatters/ConsoleFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAazD,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,IAAI,EAAE;QACX,KAAK,EAAE,SAAS,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,GAAG,MAAM;IAoBV,OAAO,CAAC,UAAU;CAOnB"}
+{"version":3,"file":"ConsoleFormatter.d.ts","sourceRoot":"","sources":["../../../../src/services/formatters/ConsoleFormatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAIzD,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,IAAI,EAAE;QACX,KAAK,EAAE,SAAS,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,GAAG,MAAM;IAoBV,OAAO,CAAC,UAAU;CAOnB"}

package/dist/esm/services/formatters/ConsoleFormatter.js

@@ -1,11 +1,4 @@
-import { LogLevels } from "../../core/enum/LogLevels.js";
-const LEVEL_COLORS = {
-    [LogLevels.DEBUG]: "\x1b[90m", // gray
-    [LogLevels.INFO]: "\x1b[32m", // green
-    [LogLevels.WARN]: "\x1b[33m", // yellow
-    [LogLevels.ERROR]: "\x1b[31m", // red
-    [LogLevels.CRITICAL]: "\x1b[35m" // magenta
-};
+import { LEVEL_COLORS } from "../../core/constants/Levels/LevelsColors.js";
 const RESET = "\x1b[0m";
 export class ConsoleFormatter {
     format(data) {

package/dist/esm/services/processors/Jsonizer.d.ts

@@ -0,0 +1,11 @@
+import { CorrelationSession } from "../../core/interface/CorrelationSession.js";
+import { JsonizerConfig } from "../../core/interface/JsonzierConfig.js";
+import { LogEntry } from "../../core/types/LogEntry.js";
+export declare class Jsonizer {
+    private readonly projectName;
+    private readonly environment;
+    private readonly componentName;
+    constructor(config: JsonizerConfig);
+    appendLog(correlationId: string, entry: LogEntry): CorrelationSession;
+}
+//# sourceMappingURL=Jsonizer.d.ts.map

package/dist/esm/services/processors/Jsonizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Jsonizer.d.ts","sourceRoot":"","sources":["../../../../src/services/processors/Jsonizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAKxD,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,MAAM,EAAE,cAAc;IAM3B,SAAS,CACd,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,QAAQ,GACd,kBAAkB;CAkBtB"}

package/dist/esm/services/processors/Jsonizer.js

@@ -0,0 +1,27 @@
+import { getOrCreateSession } from "../../core/store/CorrelationStore.js";
+export class Jsonizer {
+    projectName;
+    environment;
+    componentName;
+    constructor(config) {
+        this.projectName = config.projectName;
+        this.environment = config.environment;
+        this.componentName = config.componentName;
+    }
+    appendLog(correlationId, entry) {
+        const session = getOrCreateSession(correlationId, {
+            projectName: this.projectName,
+            environment: this.environment,
+            correlationId,
+            component: this.componentName,
+        });
+        session.logs.push({
+            timestamp: new Date().toISOString(),
+            level: entry.level,
+            message: entry.message,
+            meta: entry.meta ?? {},
+            component: this.componentName,
+        });
+        return session;
+    }
+}

package/dist/esm/services/transporter/ConsoleTranspoter.d.ts

@@ -0,0 +1,5 @@
+import { transport } from "winston";
+export declare class ConsoleTransporter {
+    transport(): transport;
+}
+//# sourceMappingURL=ConsoleTranspoter.d.ts.map

package/dist/esm/services/transporter/ConsoleTranspoter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleTranspoter.d.ts","sourceRoot":"","sources":["../../../../src/services/transporter/ConsoleTranspoter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,SAAS,EAAE,MAAM,SAAS,CAAC;AAGhD,qBAAa,kBAAkB;IAC7B,SAAS,IAAI,SAAS;CAKvB"}

package/dist/esm/services/transporter/ConsoleTranspoter.js

@@ -0,0 +1,9 @@
+import { transports } from "winston";
+import formatLogs from "../../core/formatters/winston/FormatLogs.js";
+export class ConsoleTransporter {
+    transport() {
+        return new transports.Console({
+            format: formatLogs(),
+        });
+    }
+}

package/dist/esm/services/transporter/ServerTransporter.d.ts

@@ -0,0 +1,10 @@
+import { CorrelationSession, NonCorrelationSession } from "../../core/interface/CorrelationSession.js";
+type AnySession = CorrelationSession | NonCorrelationSession;
+export declare class ServerTransporter {
+    transport(session: AnySession): void;
+    private sendCorrelation;
+    private sendSingle;
+    private isFrontendSession;
+}
+export {};
+//# sourceMappingURL=ServerTransporter.d.ts.map

package/dist/esm/services/transporter/ServerTransporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerTransporter.d.ts","sourceRoot":"","sources":["../../../../src/services/transporter/ServerTransporter.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,4CAA4C,CAAC;AAEpD,KAAK,UAAU,GAAG,kBAAkB,GAAG,qBAAqB,CAAC;AAE7D,qBAAa,iBAAiB;IAC5B,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IASpC,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,iBAAiB;CAM1B"}

package/dist/esm/services/transporter/ServerTransporter.js

@@ -0,0 +1,27 @@
+import { LogApi } from "../../api/LogApi.js";
+import { LogPayloadType } from "../../core/enum/LogPayLoads.js";
+export class ServerTransporter {
+    transport(session) {
+        if (this.isFrontendSession(session)) {
+            this.sendSingle(session);
+            return;
+        }
+        this.sendCorrelation(session);
+    }
+    sendCorrelation(session) {
+        LogApi({
+            type: LogPayloadType.SESSION,
+            data: session,
+        });
+    }
+    sendSingle(session) {
+        LogApi({
+            type: LogPayloadType.SINGLE,
+            data: session,
+        });
+    }
+    isFrontendSession(session) {
+        // Decide ONLY based on session shape/data
+        return session.correlationId === "no-correlation-id";
+    }
+}

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

@@ -0,0 +1,2 @@
+export declare function generateCorrelationId(projectName: string, componentName: string): string;
+//# sourceMappingURL=GenerateCorrelationId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GenerateCorrelationId.d.ts","sourceRoot":"","sources":["../../../src/utils/GenerateCorrelationId.ts"],"names":[],"mappings":"AAEA,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,MAAM,CAER"}

package/dist/esm/utils/GenerateCorrelationId.js

@@ -0,0 +1,4 @@
+import crypto from "crypto";
+export function generateCorrelationId(projectName, componentName) {
+    return `${projectName}-${componentName}-${crypto.randomUUID()}`;
+}

package/dist/esm/validator/ValidateComponentName.d.ts

@@ -0,0 +1,2 @@
+export default function validateComponentName(componentName: string): void;
+//# sourceMappingURL=ValidateComponentName.d.ts.map

package/dist/esm/validator/ValidateComponentName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateComponentName.d.ts","sourceRoot":"","sources":["../../../src/validator/ValidateComponentName.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,aAAa,EAAC,MAAM,QAajE"}

package/dist/esm/validator/ValidateComponentName.js

@@ -0,0 +1,11 @@
+import { throwError } from "../errors/ThrowError.js";
+export default function validateComponentName(componentName) {
+    if (!componentName || typeof componentName !== "string") {
+        throwError("Logger: Component name must be a non-empty string. " +
+            "Usage: createLogger('ComponentName')");
+    }
+    if (componentName.length > 100) {
+        throwError("Logger: Component name cannot exceed 100 characters. " +
+            `Received: '${componentName.substring(0, 20)}...'`);
+    }
+}

package/dist/esm/validator/ValidateLogEntry.d.ts

@@ -0,0 +1,3 @@
+import { LogEntry } from "../core/types/LogEntry.js";
+export default function validateLogEntry(entry: LogEntry): void;
+//# sourceMappingURL=ValidateLogEntry.d.ts.map

package/dist/esm/validator/ValidateLogEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateLogEntry.d.ts","sourceRoot":"","sources":["../../../src/validator/ValidateLogEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAoB9D"}

package/dist/esm/validator/ValidateLogEntry.js

@@ -0,0 +1,15 @@
+import { throwError } from "../errors/ThrowError.js";
+export default function validateLogEntry(entry) {
+    if (!entry) {
+        throwError("[Logiscout] Log entry is undefined or null");
+    }
+    if (!entry.message || typeof entry.message !== "string") {
+        throwError("[Logiscout] Log message must be a non-empty string. " +
+            `Usage: logiscout.${entry.level}('Your message', { meta })`);
+    }
+    if (entry.message.length > 10000) {
+        console.error("[Logiscout] Log message exceeds 10000 characters. Message truncated.");
+        entry.message =
+            entry.message.substring(0, 10000) + "... [truncated]";
+    }
+}

package/dist/esm/validator/ValidateLogLevel.d.ts

@@ -0,0 +1,2 @@
+export default function validateLogLevel(logLevel: any): void;
+//# sourceMappingURL=ValidateLogLevel.d.ts.map

package/dist/esm/validator/ValidateLogLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateLogLevel.d.ts","sourceRoot":"","sources":["../../../src/validator/ValidateLogLevel.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAO5D"}

package/dist/esm/validator/ValidateLogLevel.js

@@ -0,0 +1,8 @@
+import { LogLevels } from "../core/enum/LogLevels.js";
+import { throwError } from "../errors/ThrowError.js";
+export default function validateLogLevel(logLevel) {
+    if (!Object.values(LogLevels).includes(logLevel)) {
+        throwError(`Logger: Invalid log level '${logLevel}'. ` +
+            `Valid levels: ${Object.values(LogLevels).join(", ")}`);
+    }
+}

package/dist/esm/validator/ValidateLogMessage.d.ts

@@ -0,0 +1,2 @@
+export default function validateLogMessage(message: string): void;
+//# sourceMappingURL=ValidateLogMessage.d.ts.map

package/dist/esm/validator/ValidateLogMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateLogMessage.d.ts","sourceRoot":"","sources":["../../../src/validator/ValidateLogMessage.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAShE"}

package/dist/esm/validator/ValidateLogMessage.js

@@ -0,0 +1,7 @@
+import { throwError } from "../errors/ThrowError.js";
+export default function validateLogMessage(message) {
+    if (!message || typeof message !== "string") {
+        throwError(`Logger: Message must be a non-empty string. ` +
+            `Received: ${typeof message === "undefined" ? "undefined" : typeof message}`);
+    }
+}

package/dist/esm/validator/ValidateRequestContext.d.ts

@@ -0,0 +1,2 @@
+export declare function validateRequestContext(fn: () => void, correlationId: string | undefined): void;
+//# sourceMappingURL=ValidateRequestContext.d.ts.map

package/dist/esm/validator/ValidateRequestContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateRequestContext.d.ts","sourceRoot":"","sources":["../../../src/validator/ValidateRequestContext.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,MAAM,IAAI,EACd,aAAa,EAAE,MAAM,GAAC,SAAS,GAC9B,IAAI,CAqBN"}

package/dist/esm/validator/ValidateRequestContext.js

@@ -0,0 +1,15 @@
+import { throwError } from "../errors/ThrowError.js";
+export function validateRequestContext(fn, correlationId) {
+    if (typeof fn !== "function") {
+        throwError("RequestContext.run() requires a function as the first parameter. " +
+            "Usage: RequestContext.run(() => { ... }, correlationId?)");
+    }
+    // Validate correlationId if provided
+    if (correlationId !== undefined && typeof correlationId !== "string") {
+        throwError("RequestContext.run(): correlationId must be a string if provided. " +
+            `Received: ${typeof correlationId}`);
+    }
+    if (correlationId && correlationId.length > 100) {
+        throwError("RequestContext.run(): correlationId cannot exceed 100 characters.");
+    }
+}