logiscout 1.0.0 → 1.0.1

package/dist/cjs/core/context/RequestContext.cjs

@@ -6,12 +6,42 @@ const crypto_1 = require("crypto");
 const storage = new async_hooks_1.AsyncLocalStorage();
 class RequestContext {
     static run(fn, correlationId) {
-        storage.run({
-            correlationId: correlationId ?? (0, crypto_1.randomUUID)(),
-        }, fn);
+        // Validate function parameter
+        if (typeof fn !== "function") {
+            throw new Error("RequestContext.run() requires a function as the first parameter. " +
+                "Usage: RequestContext.run(() => { ... }, correlationId?)");
+        }
+        // Validate correlationId if provided
+        if (correlationId !== undefined && typeof correlationId !== "string") {
+            throw new Error("RequestContext.run(): correlationId must be a string if provided. " +
+                `Received: ${typeof correlationId}`);
+        }
+        if (correlationId && correlationId.length > 100) {
+            throw new Error("RequestContext.run(): correlationId cannot exceed 100 characters.");
+        }
+        // Generate UUID if not provided
+        const id = correlationId ?? (0, crypto_1.randomUUID)();
+        try {
+            storage.run({
+                correlationId: id,
+            }, fn);
+        }
+        catch (error) {
+            throw new Error(`RequestContext.run(): Failed to run function in context. ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
     }
     static getCorrelationId() {
-        return storage.getStore()?.correlationId;
+        try {
+            const store = storage.getStore();
+            return store?.correlationId;
+        }
+        catch (error) {
+            // AsyncLocalStorage access failed - likely outside async context
+            console.warn("[RequestContext] Warning: Could not retrieve correlationId. " +
+                "This may occur outside of a RequestContext.run() block. " +
+                "Consider using createCorrelationMiddleware() for HTTP requests.");
+            return undefined;
+        }
     }
 }
 exports.RequestContext = RequestContext;

package/dist/cjs/core/context/RequestContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RequestContext.d.ts","sourceRoot":"","sources":["../../../../src/core/context/RequestContext.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB;AAID,qBAAa,cAAc;IACzB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IASxD,MAAM,CAAC,gBAAgB,IAAI,MAAM,GAAG,SAAS;CAG9C"}
+{"version":3,"file":"RequestContext.d.ts","sourceRoot":"","sources":["../../../../src/core/context/RequestContext.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB;AAID,qBAAa,cAAc;IACzB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IA0CxD,MAAM,CAAC,gBAAgB,IAAI,MAAM,GAAG,SAAS;CAc9C"}

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAGrD,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,WACvB,CAAC;AAGxB,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAGrD,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,WACvB,CAAC;AAGxB,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAA"}

package/dist/cjs/middlewares/correlationMiddleware.cjs

@@ -8,13 +8,61 @@ const RequestContext_js_1 = require("../core/context/RequestContext.cjs");
 const crypto_1 = __importDefault(require("crypto"));
 const createCorrelationMiddleware = () => {
     return (req, res, next) => {
-        const correlationId = crypto_1.default.randomUUID();
-        RequestContext_js_1.RequestContext.run(() => {
-            if (res?.setHeader) {
-                res.setHeader("x-correlation-id", correlationId);
+        // Validate request object
+        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_1.default.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;
             }
-            next();
-        }, correlationId);
+            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_js_1.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"));
+        }
     };
 };
 exports.createCorrelationMiddleware = createCorrelationMiddleware;

package/dist/cjs/middlewares/correlationMiddleware.d.ts

@@ -1,2 +1,17 @@
-export declare const createCorrelationMiddleware: () => (req: any, res: any, next: () => void) => void;
+interface RequestLike {
+    headers?: Record<string, string | string[] | undefined>;
+    get?: (header: string) => string | undefined;
+}
+interface ResponseLike {
+    setHeader?: (name: string, value: string) => void;
+    locals?: Record<string, unknown>;
+}
+interface NextFunction {
+    (err?: Error): void;
+}
+interface MiddlewareHandler {
+    (req: RequestLike, res: ResponseLike, next: NextFunction): void;
+}
+export declare const createCorrelationMiddleware: () => MiddlewareHandler;
+export {};
 //# sourceMappingURL=correlationMiddleware.d.ts.map

package/dist/cjs/middlewares/correlationMiddleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"correlationMiddleware.d.ts","sourceRoot":"","sources":["../../../src/middlewares/correlationMiddleware.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,2BAA2B,SAC9B,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,IAAI,SAU7C,CAAC"}
+{"version":3,"file":"correlationMiddleware.d.ts","sourceRoot":"","sources":["../../../src/middlewares/correlationMiddleware.ts"],"names":[],"mappings":"AAGA,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACxD,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC9C;AAED,UAAU,YAAY;IACpB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,UAAU,YAAY;IACpB,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,UAAU,iBAAiB;IACzB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CACjE;AAED,eAAO,MAAM,2BAA2B,QAAO,iBAkF9C,CAAC"}

package/dist/cjs/services/Levels/Levels.cjs

@@ -20,5 +20,9 @@ class Levels extends Logger_js_1.Logger {
         const entry = this.getLogEntry(message, LogLevels_js_1.LogLevels.DEBUG, meta);
         this.log(entry);
     }
+    critical(message, meta) {
+        const entry = this.getLogEntry(message, LogLevels_js_1.LogLevels.CRITICAL, meta);
+        this.log(entry);
+    }
 }
 exports.Levels = Levels;

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

@@ -5,5 +5,6 @@ export declare class Levels extends Logger implements LoggerInterface {
     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;
 }
 //# sourceMappingURL=Levels.d.ts.map

package/dist/cjs/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;IAM3D,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;CAI7D"}
+{"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"}

package/dist/cjs/services/Logger/Logger.cjs

@@ -35,42 +35,84 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Logger = void 0;
 const winston_1 = __importStar(require("winston"));
+const LogLevels_js_1 = require("../../core/enum/LogLevels.cjs");
 const RequestContext_js_1 = require("../../core/context/RequestContext.cjs");
 class Logger {
     winstonLogger;
     componentName;
     constructor(componentName) {
+        // 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)}...'`);
+        }
         this.componentName = componentName;
-        this.winstonLogger = winston_1.default.createLogger({
-            level: "debug",
-            levels: {
-                error: 0,
-                warn: 1,
-                info: 2,
-                debug: 3,
-            },
-            format: winston_1.format.combine(winston_1.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), winston_1.format.printf(({ timestamp, level, message, component, correlationId, ...meta }) => {
-                const metaString = Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
-                return `[${component}] [${timestamp}] [${level.toUpperCase()}] [${correlationId}] ${message}${metaString}`;
-            })),
-            transports: [
-                new winston_1.transports.Console({
-                    format: winston_1.format.combine(winston_1.format.colorize({ all: true }), winston_1.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), winston_1.format.printf(({ timestamp, level, message, ...meta }) => {
-                        const metaString = Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
-                        return `[${componentName}] [${timestamp}] [${level}] ${message}${metaString}`;
-                    })),
-                }),
-            ],
-        });
+        try {
+            this.winstonLogger = winston_1.default.createLogger({
+                level: "debug",
+                levels: {
+                    error: 0,
+                    warn: 1,
+                    info: 2,
+                    debug: 3,
+                },
+                format: winston_1.format.combine(winston_1.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), winston_1.format.printf(({ timestamp, level, message, component, correlationId, ...meta }) => {
+                    const metaString = Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
+                    return `[${component}] [${timestamp}] [${level.toUpperCase()}] [${correlationId}] ${message}${metaString}`;
+                })),
+                transports: [
+                    new winston_1.transports.Console({
+                        format: winston_1.format.combine(winston_1.format.colorize({ all: true }), winston_1.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), winston_1.format.printf(({ timestamp, level, message, ...meta }) => {
+                            const metaString = Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
+                            return `[${componentName}] [${timestamp}] [${level}] ${message}${metaString}`;
+                        })),
+                    }),
+                ],
+            });
+        }
+        catch (error) {
+            throw new Error(`Logger: Failed to initialize Winston logger. ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
     }
     log(entry) {
         try {
-            const correlationId = RequestContext_js_1.RequestContext.getCorrelationId();
-            const logMeta = {
-                component: this.componentName,
-                correlationId,
-                ...entry.meta,
-            };
+            // 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]";
+            }
+            const correlationId = RequestContext_js_1.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",
+                };
+            }
             this.winstonLogger.log(entry.level, entry.message, logMeta);
             // Send structured log to API (no formatting)
             // LogApi({
@@ -81,14 +123,27 @@ class Logger {
             //   },
             // });
         }
-        catch {
-            // never throw from logger
+        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}`);
         }
     }
     getWinstonLogger() {
         return this.winstonLogger;
     }
     getLogEntry(message, logLevel, meta) {
+        // 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}`);
+        }
+        // Validate log level
+        if (!Object.values(LogLevels_js_1.LogLevels).includes(logLevel)) {
+            throw new Error(`Logger: Invalid log level '${logLevel}'. ` +
+                `Valid levels: ${Object.values(LogLevels_js_1.LogLevels).join(", ")}`);
+        }
         const entry = {
             message,
             meta,

package/dist/cjs/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;AAGzD,8BAAsB,MAAM;IAC1B,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,OAAO,CAAC,aAAa,CAAS;gBAGlB,aAAa,EAAE,MAAM;IA4CjC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAyBpC,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;CASZ"}
+{"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;AAGzD,8BAAsB,MAAM;IAC1B,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,OAAO,CAAC,aAAa,CAAS;gBAElB,aAAa,EAAE,MAAM;IAkEjC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAgEpC,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;CAyBZ"}

package/dist/esm/core/context/RequestContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RequestContext.d.ts","sourceRoot":"","sources":["../../../../src/core/context/RequestContext.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB;AAID,qBAAa,cAAc;IACzB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IASxD,MAAM,CAAC,gBAAgB,IAAI,MAAM,GAAG,SAAS;CAG9C"}
+{"version":3,"file":"RequestContext.d.ts","sourceRoot":"","sources":["../../../../src/core/context/RequestContext.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB;AAID,qBAAa,cAAc;IACzB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IA0CxD,MAAM,CAAC,gBAAgB,IAAI,MAAM,GAAG,SAAS;CAc9C"}

package/dist/esm/core/context/RequestContext.js

@@ -3,11 +3,41 @@ import { randomUUID } from "crypto";
 const storage = new AsyncLocalStorage();
 export class RequestContext {
     static run(fn, correlationId) {
-        storage.run({
-            correlationId: correlationId ?? randomUUID(),
-        }, fn);
+        // Validate function parameter
+        if (typeof fn !== "function") {
+            throw new Error("RequestContext.run() requires a function as the first parameter. " +
+                "Usage: RequestContext.run(() => { ... }, correlationId?)");
+        }
+        // Validate correlationId if provided
+        if (correlationId !== undefined && typeof correlationId !== "string") {
+            throw new Error("RequestContext.run(): correlationId must be a string if provided. " +
+                `Received: ${typeof correlationId}`);
+        }
+        if (correlationId && correlationId.length > 100) {
+            throw new Error("RequestContext.run(): correlationId cannot exceed 100 characters.");
+        }
+        // Generate UUID if not provided
+        const id = correlationId ?? randomUUID();
+        try {
+            storage.run({
+                correlationId: id,
+            }, fn);
+        }
+        catch (error) {
+            throw new Error(`RequestContext.run(): Failed to run function in context. ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
     }
     static getCorrelationId() {
-        return storage.getStore()?.correlationId;
+        try {
+            const store = storage.getStore();
+            return store?.correlationId;
+        }
+        catch (error) {
+            // AsyncLocalStorage access failed - likely outside async context
+            console.warn("[RequestContext] Warning: Could not retrieve correlationId. " +
+                "This may occur outside of a RequestContext.run() block. " +
+                "Consider using createCorrelationMiddleware() for HTTP requests.");
+            return undefined;
+        }
     }
 }

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAGrD,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,WACvB,CAAC;AAGxB,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAGrD,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,WACvB,CAAC;AAGxB,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAA"}

package/dist/esm/middlewares/correlationMiddleware.d.ts

@@ -1,2 +1,17 @@
-export declare const createCorrelationMiddleware: () => (req: any, res: any, next: () => void) => void;
+interface RequestLike {
+    headers?: Record<string, string | string[] | undefined>;
+    get?: (header: string) => string | undefined;
+}
+interface ResponseLike {
+    setHeader?: (name: string, value: string) => void;
+    locals?: Record<string, unknown>;
+}
+interface NextFunction {
+    (err?: Error): void;
+}
+interface MiddlewareHandler {
+    (req: RequestLike, res: ResponseLike, next: NextFunction): void;
+}
+export declare const createCorrelationMiddleware: () => MiddlewareHandler;
+export {};
 //# sourceMappingURL=correlationMiddleware.d.ts.map

package/dist/esm/middlewares/correlationMiddleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"correlationMiddleware.d.ts","sourceRoot":"","sources":["../../../src/middlewares/correlationMiddleware.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,2BAA2B,SAC9B,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,IAAI,SAU7C,CAAC"}
+{"version":3,"file":"correlationMiddleware.d.ts","sourceRoot":"","sources":["../../../src/middlewares/correlationMiddleware.ts"],"names":[],"mappings":"AAGA,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACxD,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC9C;AAED,UAAU,YAAY;IACpB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,UAAU,YAAY;IACpB,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,UAAU,iBAAiB;IACzB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CACjE;AAED,eAAO,MAAM,2BAA2B,QAAO,iBAkF9C,CAAC"}

package/dist/esm/middlewares/correlationMiddleware.js

@@ -2,12 +2,60 @@ import { RequestContext } from "../core/context/RequestContext.js";
 import crypto from "crypto";
 export const createCorrelationMiddleware = () => {
     return (req, res, next) => {
-        const correlationId = crypto.randomUUID();
-        RequestContext.run(() => {
-            if (res?.setHeader) {
-                res.setHeader("x-correlation-id", correlationId);
+        // Validate request object
+        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;
             }
-            next();
-        }, correlationId);
+            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"));
+        }
     };
 };

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

@@ -5,5 +5,6 @@ export declare class Levels extends Logger implements LoggerInterface {
     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;
 }
 //# 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;IAM3D,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;CAI7D"}
+{"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"}

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

@@ -17,4 +17,8 @@ export class Levels extends Logger {
         const entry = this.getLogEntry(message, LogLevels.DEBUG, meta);
         this.log(entry);
     }
+    critical(message, meta) {
+        const entry = this.getLogEntry(message, LogLevels.CRITICAL, meta);
+        this.log(entry);
+    }
 }

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;AAGzD,8BAAsB,MAAM;IAC1B,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,OAAO,CAAC,aAAa,CAAS;gBAGlB,aAAa,EAAE,MAAM;IA4CjC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAyBpC,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;CASZ"}
+{"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;AAGzD,8BAAsB,MAAM;IAC1B,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,OAAO,CAAC,aAAa,CAAS;gBAElB,aAAa,EAAE,MAAM;IAkEjC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAgEpC,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;CAyBZ"}

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

@@ -1,40 +1,82 @@
 import winston, { format, transports } from "winston";
+import { LogLevels } from "../../core/enum/LogLevels.js";
 import { RequestContext } from "../../core/context/RequestContext.js";
 export class Logger {
     winstonLogger;
     componentName;
     constructor(componentName) {
+        // 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)}...'`);
+        }
         this.componentName = componentName;
-        this.winstonLogger = winston.createLogger({
-            level: "debug",
-            levels: {
-                error: 0,
-                warn: 1,
-                info: 2,
-                debug: 3,
-            },
-            format: format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.printf(({ timestamp, level, message, component, correlationId, ...meta }) => {
-                const metaString = Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
-                return `[${component}] [${timestamp}] [${level.toUpperCase()}] [${correlationId}] ${message}${metaString}`;
-            })),
-            transports: [
-                new transports.Console({
-                    format: format.combine(format.colorize({ all: true }), format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.printf(({ timestamp, level, message, ...meta }) => {
-                        const metaString = Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
-                        return `[${componentName}] [${timestamp}] [${level}] ${message}${metaString}`;
-                    })),
-                }),
-            ],
-        });
+        try {
+            this.winstonLogger = winston.createLogger({
+                level: "debug",
+                levels: {
+                    error: 0,
+                    warn: 1,
+                    info: 2,
+                    debug: 3,
+                },
+                format: format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.printf(({ timestamp, level, message, component, correlationId, ...meta }) => {
+                    const metaString = Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
+                    return `[${component}] [${timestamp}] [${level.toUpperCase()}] [${correlationId}] ${message}${metaString}`;
+                })),
+                transports: [
+                    new transports.Console({
+                        format: format.combine(format.colorize({ all: true }), format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.printf(({ timestamp, level, message, ...meta }) => {
+                            const metaString = Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
+                            return `[${componentName}] [${timestamp}] [${level}] ${message}${metaString}`;
+                        })),
+                    }),
+                ],
+            });
+        }
+        catch (error) {
+            throw new Error(`Logger: Failed to initialize Winston logger. ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
     }
     log(entry) {
         try {
-            const correlationId = RequestContext.getCorrelationId();
-            const logMeta = {
-                component: this.componentName,
-                correlationId,
-                ...entry.meta,
-            };
+            // 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]";
+            }
+            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",
+                };
+            }
             this.winstonLogger.log(entry.level, entry.message, logMeta);
             // Send structured log to API (no formatting)
             // LogApi({
@@ -45,14 +87,27 @@ export class Logger {
             //   },
             // });
         }
-        catch {
-            // never throw from logger
+        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}`);
         }
     }
     getWinstonLogger() {
         return this.winstonLogger;
     }
     getLogEntry(message, logLevel, meta) {
+        // 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}`);
+        }
+        // Validate log level
+        if (!Object.values(LogLevels).includes(logLevel)) {
+            throw new Error(`Logger: Invalid log level '${logLevel}'. ` +
+                `Valid levels: ${Object.values(LogLevels).join(", ")}`);
+        }
         const entry = {
             message,
             meta,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "logiscout",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Logiscout — a structured logger library",
   "type": "module",
   "main": "./dist/cjs/index.cjs",
@@ -26,22 +26,18 @@
   "keywords": [
     "logger",
     "logging",
-    "correlation-id",
-    "async-context",
     "structured-logging",
-    "nodejs",
-    "express",
-    "winston"
+    "nodejs"
   ],
-  "author": "YOUR_NAME",
+  "author": "Logiscout",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/YOUR_GITHUB_USERNAME/logicout"
+    "url": "https://github.com/saadakmal460/Logiscout.git"
   },
-  "homepage": "https://github.com/YOUR_GITHUB_USERNAME/logicout#readme",
+  "homepage": "https://github.com/saadakmal460/Logiscout#readme",
   "bugs": {
-    "url": "https://github.com/YOUR_GITHUB_USERNAME/logicout/issues"
+    "url": "https://github.com/saadakmal460/Logiscout/issues"
   },
   "engines": {
     "node": ">=18"