logiscout 1.0.0 → 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Muhammad Saad Akmal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# Logiscout

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/core/types/LogEntry.d.ts

@@ -5,5 +5,6 @@ export interface LogEntry {
     timestamp: string;
     level: LogLevels;
     correlationId?: string;
+    send?: boolean;
 }
 //# sourceMappingURL=LogEntry.d.ts.map

package/dist/cjs/core/types/LogEntry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LogEntry.d.ts","sourceRoot":"","sources":["../../../../src/core/types/LogEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"LogEntry.d.ts","sourceRoot":"","sources":["../../../../src/core/types/LogEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAC,OAAO,CAAA;CACd"}

package/dist/cjs/index.cjs

@@ -1,15 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCorrelationMiddleware = exports.createLogger = exports.BaseLogger = exports.Levels = exports.LogLevels = void 0;
+exports.createCorrelationMiddleware = exports.createLogger = exports.initLogiscout = exports.BaseLogger = exports.Levels = exports.LogLevels = void 0;
 var LogLevels_js_1 = require("./core/enum/LogLevels.cjs");
 Object.defineProperty(exports, "LogLevels", { enumerable: true, get: function () { return LogLevels_js_1.LogLevels; } });
 var Levels_js_1 = require("./services/Levels/Levels.cjs");
 Object.defineProperty(exports, "Levels", { enumerable: true, get: function () { return Levels_js_1.Levels; } });
 var Logger_js_1 = require("./services/Logger/Logger.cjs");
 Object.defineProperty(exports, "BaseLogger", { enumerable: true, get: function () { return Logger_js_1.Logger; } });
+const state_js_1 = require("./initiator/state.cjs");
 const Levels_js_2 = require("./services/Levels/Levels.cjs");
 // const Logger = new Levels();
-const createLogger = (component) => new Levels_js_2.Levels(component);
+// export const createLogger = (component: string) =>
+//   new Levels(component);
+var init_js_1 = require("./init.cjs");
+Object.defineProperty(exports, "initLogiscout", { enumerable: true, get: function () { return init_js_1.initLogiscout; } });
+const createLogger = (component) => {
+    const config = (0, state_js_1.getLogiScouConfig)();
+    return new Levels_js_2.Levels(component, {
+        projectName: config.projectName,
+        environment: config.environment,
+    });
+};
 exports.createLogger = createLogger;
 var correlationMiddleware_js_1 = require("./middlewares/correlationMiddleware.cjs");
 Object.defineProperty(exports, "createCorrelationMiddleware", { enumerable: true, get: function () { return correlationMiddleware_js_1.createCorrelationMiddleware; } });

package/dist/cjs/index.d.ts

@@ -4,6 +4,7 @@ export { LogEntry } from "./core/types/LogEntry.js";
 export { Levels } from "./services/Levels/Levels.js";
 export { Logger as BaseLogger } from "./services/Logger/Logger.js";
 import { Levels } from "./services/Levels/Levels.js";
+export { initLogiscout } from "./init.js";
 export declare const createLogger: (component: string) => Levels;
 export { createCorrelationMiddleware } from "./middlewares/correlationMiddleware.js";
 //# sourceMappingURL=index.d.ts.map

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;AAOrD,OAAO,EAAC,aAAa,EAAC,MAAM,WAAW,CAAA;AACvC,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,WAO7C,CAAC;AAEF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/cjs/init.cjs

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initLogiscout = initLogiscout;
+const state_js_1 = require("./initiator/state.cjs");
+function initLogiscout(config) {
+    if (!config.projectName) {
+        throw new Error("projectName is required");
+    }
+    if (!config.environment) {
+        throw new Error("environment is required");
+    }
+    (0, state_js_1.setConfig)(config);
+}

package/dist/cjs/init.d.ts

@@ -0,0 +1,3 @@
+import { LogiscoutConfig } from "./initiator/state.js";
+export declare function initLogiscout(config: LogiscoutConfig): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAa,MAAM,sBAAsB,CAAC;AAIlE,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,QAUpD"}

package/dist/cjs/initiator/state.cjs

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setConfig = setConfig;
+exports.getLogiScouConfig = getLogiScouConfig;
+let config = null;
+function setConfig(c) {
+    if (config) {
+        throw new Error("Logiscout has already been initialized");
+    }
+    config = c;
+}
+function getLogiScouConfig() {
+    if (!config) {
+        throw new Error("Logiscout is not initialized. Call initLogiscout() before using the SDK.");
+    }
+    return config;
+}

package/dist/cjs/initiator/state.d.ts

@@ -0,0 +1,8 @@
+export type LogiscoutConfig = {
+    projectName: string;
+    environment: "dev" | "staging" | "prod" | string;
+    apiKey?: string;
+};
+export declare function setConfig(c: LogiscoutConfig): void;
+export declare function getLogiScouConfig(): LogiscoutConfig;
+//# sourceMappingURL=state.d.ts.map

package/dist/cjs/initiator/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/initiator/state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,wBAAgB,SAAS,CAAC,CAAC,EAAE,eAAe,QAK3C;AAED,wBAAgB,iBAAiB,IAAI,eAAe,CAOnD"}

package/dist/cjs/middlewares/correlationMiddleware.cjs

@@ -6,15 +6,65 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCorrelationMiddleware = void 0;
 const RequestContext_js_1 = require("../core/context/RequestContext.cjs");
 const crypto_1 = __importDefault(require("crypto"));
+const state_js_1 = require("../initiator/state.cjs");
 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
+        const { projectName, environment } = (0, state_js_1.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_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":"AAIA,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,iBAmF9C,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,65 +35,148 @@ 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");
+const ConsoleFormatter_js_1 = require("../formatters/ConsoleFormatter.cjs");
 class Logger {
     winstonLogger;
     componentName;
-    constructor(componentName) {
+    projectName;
+    environment;
+    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)}...'`);
+        }
         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}`;
-                    })),
-                }),
-            ],
-        });
+        this.projectName = config.projectName;
+        this.environment = config.environment;
+        try {
+            // Create structlog-style formatter instance
+            const consoleFormatter = new ConsoleFormatter_js_1.ConsoleFormatter();
+            this.winstonLogger = winston_1.default.createLogger({
+                level: "debug",
+                levels: {
+                    error: 0,
+                    warn: 1,
+                    info: 2,
+                    debug: 3,
+                },
+                // File transport format (non-colorized)
+                format: winston_1.format.combine(winston_1.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), winston_1.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 winston_1.transports.Console({
+                        // Console transport with structlog-style formatting and colors
+                        format: winston_1.format.combine(winston_1.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), winston_1.format.printf(({ timestamp, level, message, component, ...meta }) => {
+                            const formatted = consoleFormatter.format({
+                                level: level,
+                                message: String(message),
+                                timestamp: String(timestamp),
+                                component: component,
+                                ...meta,
+                            });
+                            return formatted;
+                        })),
+                    }),
+                ],
+            });
+        }
+        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({
-            //   logs: {
-            //     ...entry,
-            //     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")
+            }
         }
-        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,
             timestamp: new Date().toISOString(),
             level: logLevel,
+            send: true
         };
         return entry;
     }

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

@@ -1,10 +1,13 @@
 import { Logger as WinstonLogger } from "winston";
 import { LogEntry } from "../../core/types/LogEntry.js";
 import { LogLevels } from "../../core/enum/LogLevels.js";
+import { LogiscoutConfig } from "../../initiator/state.js";
 export declare abstract class Logger {
     protected winstonLogger: WinstonLogger;
     private componentName;
-    constructor(componentName: string);
+    private projectName;
+    private environment;
+    constructor(componentName: string, config: LogiscoutConfig);
     protected log(entry: LogEntry): void;
     getWinstonLogger(): WinstonLogger;
     protected getLogEntry(message: string, logLevel: LogLevels, meta?: Record<string, unknown>): LogEntry;

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

package/dist/cjs/services/formatters/ConsoleFormatter.cjs

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleFormatter = void 0;
+const LogLevels_js_1 = require("../../core/enum/LogLevels.cjs");
+const LEVEL_COLORS = {
+    [LogLevels_js_1.LogLevels.DEBUG]: "\x1b[90m", // gray
+    [LogLevels_js_1.LogLevels.INFO]: "\x1b[32m", // green
+    [LogLevels_js_1.LogLevels.WARN]: "\x1b[33m", // yellow
+    [LogLevels_js_1.LogLevels.ERROR]: "\x1b[31m", // red
+    [LogLevels_js_1.LogLevels.CRITICAL]: "\x1b[35m" // magenta
+};
+const RESET = "\x1b[0m";
+class ConsoleFormatter {
+    format(data) {
+        const { level, message, timestamp, component, meta } = data;
+        const color = LEVEL_COLORS[level] ?? "";
+        const levelLabel = `${color}${level.toUpperCase()}${RESET}`;
+        const componentLabel = component ?? "App";
+        let output = `${timestamp} ` +
+            `[${levelLabel}] ` +
+            `[${componentLabel}] ` +
+            `${message}`;
+        if (meta && Object.keys(meta).length > 0) {
+            output += `\n${this.prettyJson(meta)}`;
+        }
+        return output;
+    }
+    prettyJson(obj) {
+        try {
+            return JSON.stringify(obj, null, 2);
+        }
+        catch {
+            return "{ \"error\": \"Failed to serialize metadata\" }";
+        }
+    }
+}
+exports.ConsoleFormatter = ConsoleFormatter;

package/dist/cjs/services/formatters/ConsoleFormatter.d.ts

@@ -0,0 +1,12 @@
+import { LogLevels } from "../../core/enum/LogLevels.js";
+export declare class ConsoleFormatter {
+    format(data: {
+        level: LogLevels;
+        message: string;
+        timestamp: string;
+        component?: string;
+        meta?: Record<string, unknown>;
+    }): string;
+    private prettyJson;
+}
+//# sourceMappingURL=ConsoleFormatter.d.ts.map

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

@@ -0,0 +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"}

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/core/types/LogEntry.d.ts

@@ -5,5 +5,6 @@ export interface LogEntry {
     timestamp: string;
     level: LogLevels;
     correlationId?: string;
+    send?: boolean;
 }
 //# sourceMappingURL=LogEntry.d.ts.map

package/dist/esm/core/types/LogEntry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LogEntry.d.ts","sourceRoot":"","sources":["../../../../src/core/types/LogEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"LogEntry.d.ts","sourceRoot":"","sources":["../../../../src/core/types/LogEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAC,OAAO,CAAA;CACd"}

package/dist/esm/index.d.ts

@@ -4,6 +4,7 @@ export { LogEntry } from "./core/types/LogEntry.js";
 export { Levels } from "./services/Levels/Levels.js";
 export { Logger as BaseLogger } from "./services/Logger/Logger.js";
 import { Levels } from "./services/Levels/Levels.js";
+export { initLogiscout } from "./init.js";
 export declare const createLogger: (component: string) => Levels;
 export { createCorrelationMiddleware } from "./middlewares/correlationMiddleware.js";
 //# sourceMappingURL=index.d.ts.map

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;AAOrD,OAAO,EAAC,aAAa,EAAC,MAAM,WAAW,CAAA;AACvC,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,WAO7C,CAAC;AAEF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/esm/index.js

@@ -1,8 +1,18 @@
 export { LogLevels } from "./core/enum/LogLevels.js";
 export { Levels } from "./services/Levels/Levels.js";
 export { Logger as BaseLogger } from "./services/Logger/Logger.js";
+import { getLogiScouConfig } from "./initiator/state.js";
 import { Levels } from "./services/Levels/Levels.js";
 // const Logger = new Levels();
-export const createLogger = (component) => new Levels(component);
+// export const createLogger = (component: string) =>
+//   new Levels(component);
+export { initLogiscout } from "./init.js";
+export const createLogger = (component) => {
+    const config = getLogiScouConfig();
+    return new Levels(component, {
+        projectName: config.projectName,
+        environment: config.environment,
+    });
+};
 export { createCorrelationMiddleware } from "./middlewares/correlationMiddleware.js";
 // export { Logger };

package/dist/esm/init.d.ts

@@ -0,0 +1,3 @@
+import { LogiscoutConfig } from "./initiator/state.js";
+export declare function initLogiscout(config: LogiscoutConfig): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAa,MAAM,sBAAsB,CAAC;AAIlE,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,QAUpD"}

package/dist/esm/init.js

@@ -0,0 +1,10 @@
+import { setConfig } from "./initiator/state.js";
+export function initLogiscout(config) {
+    if (!config.projectName) {
+        throw new Error("projectName is required");
+    }
+    if (!config.environment) {
+        throw new Error("environment is required");
+    }
+    setConfig(config);
+}

package/dist/esm/initiator/state.d.ts

@@ -0,0 +1,8 @@
+export type LogiscoutConfig = {
+    projectName: string;
+    environment: "dev" | "staging" | "prod" | string;
+    apiKey?: string;
+};
+export declare function setConfig(c: LogiscoutConfig): void;
+export declare function getLogiScouConfig(): LogiscoutConfig;
+//# sourceMappingURL=state.d.ts.map

package/dist/esm/initiator/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/initiator/state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,wBAAgB,SAAS,CAAC,CAAC,EAAE,eAAe,QAK3C;AAED,wBAAgB,iBAAiB,IAAI,eAAe,CAOnD"}

package/dist/esm/initiator/state.js

@@ -0,0 +1,13 @@
+let config = null;
+export function setConfig(c) {
+    if (config) {
+        throw new Error("Logiscout has already been initialized");
+    }
+    config = c;
+}
+export function getLogiScouConfig() {
+    if (!config) {
+        throw new Error("Logiscout is not initialized. Call initLogiscout() before using the SDK.");
+    }
+    return config;
+}

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":"AAIA,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,iBAmF9C,CAAC"}

package/dist/esm/middlewares/correlationMiddleware.js

@@ -1,13 +1,63 @@
 import { RequestContext } from "../core/context/RequestContext.js";
 import crypto from "crypto";
+import { getLogiScouConfig } from "../initiator/state.js";
 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
+        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;
             }
-            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

@@ -1,10 +1,13 @@
 import { Logger as WinstonLogger } from "winston";
 import { LogEntry } from "../../core/types/LogEntry.js";
 import { LogLevels } from "../../core/enum/LogLevels.js";
+import { LogiscoutConfig } from "../../initiator/state.js";
 export declare abstract class Logger {
     protected winstonLogger: WinstonLogger;
     private componentName;
-    constructor(componentName: string);
+    private projectName;
+    private environment;
+    constructor(componentName: string, config: LogiscoutConfig);
     protected log(entry: LogEntry): void;
     getWinstonLogger(): WinstonLogger;
     protected getLogEntry(message: string, logLevel: LogLevels, meta?: Record<string, unknown>): LogEntry;

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

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

@@ -1,63 +1,146 @@
 import winston, { format, transports } from "winston";
+import { LogLevels } from "../../core/enum/LogLevels.js";
 import { RequestContext } from "../../core/context/RequestContext.js";
+import { ConsoleFormatter } from "../formatters/ConsoleFormatter.js";
 export class Logger {
     winstonLogger;
     componentName;
-    constructor(componentName) {
+    projectName;
+    environment;
+    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)}...'`);
+        }
         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}`;
-                    })),
-                }),
-            ],
-        });
+        this.projectName = config.projectName;
+        this.environment = config.environment;
+        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;
+                        })),
+                    }),
+                ],
+            });
+        }
+        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({
-            //   logs: {
-            //     ...entry,
-            //     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")
+            }
         }
-        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,
             timestamp: new Date().toISOString(),
             level: logLevel,
+            send: true
         };
         return entry;
     }

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

@@ -0,0 +1,12 @@
+import { LogLevels } from "../../core/enum/LogLevels.js";
+export declare class ConsoleFormatter {
+    format(data: {
+        level: LogLevels;
+        message: string;
+        timestamp: string;
+        component?: string;
+        meta?: Record<string, unknown>;
+    }): string;
+    private prettyJson;
+}
+//# sourceMappingURL=ConsoleFormatter.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,33 @@
+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
+};
+const RESET = "\x1b[0m";
+export class ConsoleFormatter {
+    format(data) {
+        const { level, message, timestamp, component, meta } = data;
+        const color = LEVEL_COLORS[level] ?? "";
+        const levelLabel = `${color}${level.toUpperCase()}${RESET}`;
+        const componentLabel = component ?? "App";
+        let output = `${timestamp} ` +
+            `[${levelLabel}] ` +
+            `[${componentLabel}] ` +
+            `${message}`;
+        if (meta && Object.keys(meta).length > 0) {
+            output += `\n${this.prettyJson(meta)}`;
+        }
+        return output;
+    }
+    prettyJson(obj) {
+        try {
+            return JSON.stringify(obj, null, 2);
+        }
+        catch {
+            return "{ \"error\": \"Failed to serialize metadata\" }";
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "logiscout",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "Logiscout — a structured logger library",
   "type": "module",
   "main": "./dist/cjs/index.cjs",
@@ -26,31 +26,29 @@
   "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"
   },
   "dependencies": {
+    "axios": "^1.13.2",
     "winston": "^3.11.0"
   },
   "devDependencies": {
-    "typescript": "^5.3.3",
-    "@types/node": "^20.10.0"
+    "@types/node": "^20.10.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
   }
 }