hi-secure 1.0.15 → 1.0.17

package/dist/managers/RateLimitManager.js

@@ -1,31 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RateLimitManager = void 0;
-const AdapterError_js_1 = require("../core/errors/AdapterError.js");
+const AdapterError_1 = require("../core/errors/AdapterError");
 const logging_1 = require("../logging");
 class RateLimitManager {
     constructor(config, primaryAdapter, fallbackAdapter) {
         this.config = config;
         this.primaryAdapter = primaryAdapter;
         this.fallbackAdapter = fallbackAdapter;
+        logging_1.logger.info("RateLimitManager initialized", {
+            layer: "rate-limit-manager",
+            primaryConfigured: true,
+            fallbackConfigured: !!fallbackAdapter
+        });
     }
     middleware(opts) {
         let finalOptions = {};
-        if (opts?.mode === "strict") {
+        const mode = opts?.mode || "default";
+        if (mode === "strict") {
             finalOptions = {
                 windowMs: 10000,
                 max: 5,
                 message: "Too many requests, please slow down."
             };
         }
-        else if (opts?.mode === "relaxed") {
+        else if (mode === "relaxed") {
             finalOptions = {
                 windowMs: 60000,
                 max: 100,
                 message: "Rate limit exceeded."
             };
         }
-        else if (opts?.mode === "api") {
+        else if (mode === "api") {
             finalOptions = {
                 windowMs: 15 * 60 * 1000,
                 max: 100,
@@ -42,50 +48,65 @@ class RateLimitManager {
             };
         }
         if (opts?.options) {
-            const allowedOverrides = ['message', 'skipFailedRequests', 'standardHeaders', 'legacyHeaders'];
+            const allowedOverrides = [
+                "message",
+                "skipFailedRequests",
+                "standardHeaders",
+                "legacyHeaders"
+            ];
             for (const key of allowedOverrides) {
                 if (opts.options[key] !== undefined) {
                     finalOptions[key] = opts.options[key];
                 }
             }
-            const attemptedOverrides = Object.keys(opts.options).filter(k => !allowedOverrides.includes(k) && k !== 'mode');
+            const attemptedOverrides = Object.keys(opts.options).filter(k => !allowedOverrides.includes(k) && k !== "mode");
             if (attemptedOverrides.length > 0) {
                 logging_1.logger.warn("Rate limit overrides ignored", {
-                    preset: opts?.mode || 'default',
+                    layer: "rate-limit-manager",
+                    operation: "configure",
+                    mode,
                     ignoredOptions: attemptedOverrides
                 });
             }
         }
-        if (finalOptions.standardHeaders === undefined) {
-            finalOptions.standardHeaders = true;
-        }
-        if (finalOptions.legacyHeaders === undefined) {
-            finalOptions.legacyHeaders = false;
-        }
+        finalOptions.standardHeaders ?? (finalOptions.standardHeaders = true);
+        finalOptions.legacyHeaders ?? (finalOptions.legacyHeaders = false);
         try {
-            logging_1.logger.info("Applying rate limiting", {
-                mode: opts?.mode || 'default',
+            logging_1.logger.info("Rate limiting applied", {
+                layer: "rate-limit-manager",
+                operation: "apply",
+                mode,
                 windowMs: finalOptions.windowMs,
                 max: finalOptions.max
             });
             return this.primaryAdapter.getMiddleware(finalOptions);
         }
         catch (err) {
-            logging_1.logger.warn("Primary rate limiter failed → fallback", {
-                error: err?.message
+            logging_1.logger.warn("Primary rate limiter failed", {
+                layer: "rate-limit-manager",
+                operation: "apply",
+                mode,
+                reason: err?.message
             });
             if (!this.fallbackAdapter) {
-                throw new AdapterError_js_1.AdapterError("Rate limiters failed; no fallback adapter.");
+                throw new AdapterError_1.AdapterError("Rate limiters failed; no fallback adapter configured.");
             }
             try {
-                logging_1.logger.info("Using fallback rate limiter");
+                logging_1.logger.warn("Using fallback rate limiter", {
+                    layer: "rate-limit-manager",
+                    operation: "fallback",
+                    mode
+                });
                 return this.fallbackAdapter.getMiddleware(finalOptions);
             }
             catch (fallbackErr) {
-                logging_1.logger.error("Fallback limiter also failed", {
-                    error: fallbackErr?.message
+                logging_1.logger.error("Fallback rate limiter failed", {
+                    layer: "rate-limit-manager",
+                    operation: "fallback",
+                    mode,
+                    reason: fallbackErr?.message
                 });
-                throw new AdapterError_js_1.AdapterError("Both primary and fallback limiters failed.");
+                throw new AdapterError_1.AdapterError("Both primary and fallback rate limiters failed.");
             }
         }
     }

package/dist/managers/RateLimitManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"RateLimitManager.js","sourceRoot":"","sources":["../../src/managers/RateLimitManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { HiSecureConfig } from \"../core/types/HiSecureConfig.js\";\r\nimport { AdapterError } from \"../core/errors/AdapterError.js\";\r\nimport { logger } from \"../logging\";\r\n\r\ninterface RateLimiterAdapter {\r\n    getMiddleware: (options?: any) => any;\r\n}\r\n\r\nexport class RateLimitManager {\r\n    private config: HiSecureConfig[\"rateLimiter\"];\r\n    private primaryAdapter: RateLimiterAdapter;\r\n    private fallbackAdapter: RateLimiterAdapter | null;\r\n\r\n    constructor(\r\n        config: HiSecureConfig[\"rateLimiter\"],\r\n        primaryAdapter: RateLimiterAdapter,\r\n        fallbackAdapter: RateLimiterAdapter | null\r\n    ) {\r\n        this.config = config;\r\n        this.primaryAdapter = primaryAdapter;\r\n        this.fallbackAdapter = fallbackAdapter;\r\n    }\r\n\r\n    middleware(opts?: { mode?: \"strict\" | \"relaxed\" | \"api\"; options?: any }) {\r\n        let finalOptions: any = {};\r\n\r\n        if (opts?.mode === \"strict\") {\r\n            finalOptions = {\r\n                windowMs: 10_000,\r\n                max: 5,\r\n                message: \"Too many requests, please slow down.\"\r\n            };\r\n        } else if (opts?.mode === \"relaxed\") {\r\n            finalOptions = {\r\n                windowMs: 60_000,\r\n                max: 100,\r\n                message: \"Rate limit exceeded.\"\r\n            };\r\n        } else if (opts?.mode === \"api\") {\r\n            finalOptions = {\r\n                windowMs: 15 * 60 * 1000, \r\n                max: 100,\r\n                message: \"API rate limit exceeded.\"\r\n            };\r\n        } else {\r\n            finalOptions = {\r\n                windowMs: this.config.windowMs,\r\n                max: this.config.maxRequests,\r\n                message: this.config.message,\r\n                standardHeaders: true,      \r\n                legacyHeaders: false        \r\n            };\r\n        }\r\n\r\n        if (opts?.options) {\r\n            const allowedOverrides = ['message', 'skipFailedRequests', 'standardHeaders', 'legacyHeaders'];\r\n            for (const key of allowedOverrides) {\r\n                if (opts.options[key] !== undefined) {\r\n                    finalOptions[key] = opts.options[key];\r\n                }\r\n            }\r\n            \r\n            const attemptedOverrides = Object.keys(opts.options).filter(\r\n                k => !allowedOverrides.includes(k) && k !== 'mode'\r\n            );\r\n            if (attemptedOverrides.length > 0) {\r\n                logger.warn(\"Rate limit overrides ignored\", {\r\n                    preset: opts?.mode || 'default',\r\n                    ignoredOptions: attemptedOverrides\r\n                });\r\n            }\r\n        }\r\n\r\n        if (finalOptions.standardHeaders === undefined) {\r\n            finalOptions.standardHeaders = true;\r\n        }\r\n        if (finalOptions.legacyHeaders === undefined) {\r\n            finalOptions.legacyHeaders = false;\r\n        }\r\n\r\n        try {\r\n            logger.info(\"Applying rate limiting\", {\r\n                mode: opts?.mode || 'default',\r\n                windowMs: finalOptions.windowMs,\r\n                max: finalOptions.max\r\n            });\r\n            \r\n            return this.primaryAdapter.getMiddleware(finalOptions);\r\n        } catch (err: any) {\r\n            logger.warn(\"Primary rate limiter failed → fallback\", {\r\n                error: err?.message\r\n            });\r\n\r\n            if (!this.fallbackAdapter) {\r\n                throw new AdapterError(\"Rate limiters failed; no fallback adapter.\");\r\n            }\r\n\r\n            try {\r\n                logger.info(\"Using fallback rate limiter\");\r\n                return this.fallbackAdapter.getMiddleware(finalOptions);\r\n            } catch (fallbackErr: any) {\r\n                logger.error(\"Fallback limiter also failed\", {\r\n                    error: fallbackErr?.message\r\n                });\r\n                throw new AdapterError(\"Both primary and fallback limiters failed.\");\r\n            }\r\n        }\r\n    }\r\n}"]}
+{"version":3,"file":"RateLimitManager.js","sourceRoot":"","sources":["../../src/managers/RateLimitManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { HiSecureConfig } from \"../core/types/HiSecureConfig\";\r\nimport { AdapterError } from \"../core/errors/AdapterError\";\r\nimport { logger } from \"../logging\";\r\n\r\ninterface RateLimiterAdapter {\r\n    getMiddleware: (options?: any) => any;\r\n}\r\n\r\nexport class RateLimitManager {\r\n    private config: HiSecureConfig[\"rateLimiter\"];\r\n    private primaryAdapter: RateLimiterAdapter;\r\n    private fallbackAdapter: RateLimiterAdapter | null;\r\n\r\n    constructor(\r\n        config: HiSecureConfig[\"rateLimiter\"],\r\n        primaryAdapter: RateLimiterAdapter,\r\n        fallbackAdapter: RateLimiterAdapter | null\r\n    ) {\r\n        this.config = config;\r\n        this.primaryAdapter = primaryAdapter;\r\n        this.fallbackAdapter = fallbackAdapter;\r\n\r\n        logger.info(\"RateLimitManager initialized\", {\r\n            layer: \"rate-limit-manager\",\r\n            primaryConfigured: true,\r\n            fallbackConfigured: !!fallbackAdapter\r\n        });\r\n    }\r\n\r\n    middleware(opts?: { mode?: \"strict\" | \"relaxed\" | \"api\"; options?: any }) {\r\n        let finalOptions: any = {};\r\n        const mode = opts?.mode || \"default\";\r\n\r\n        if (mode === \"strict\") {\r\n            finalOptions = {\r\n                windowMs: 10_000,\r\n                max: 5,\r\n                message: \"Too many requests, please slow down.\"\r\n            };\r\n        } else if (mode === \"relaxed\") {\r\n            finalOptions = {\r\n                windowMs: 60_000,\r\n                max: 100,\r\n                message: \"Rate limit exceeded.\"\r\n            };\r\n        } else if (mode === \"api\") {\r\n            finalOptions = {\r\n                windowMs: 15 * 60 * 1000,\r\n                max: 100,\r\n                message: \"API rate limit exceeded.\"\r\n            };\r\n        } else {\r\n            finalOptions = {\r\n                windowMs: this.config.windowMs,\r\n                max: this.config.maxRequests,\r\n                message: this.config.message,\r\n                standardHeaders: true,\r\n                legacyHeaders: false\r\n            };\r\n        }\r\n\r\n        if (opts?.options) {\r\n            const allowedOverrides = [\r\n                \"message\",\r\n                \"skipFailedRequests\",\r\n                \"standardHeaders\",\r\n                \"legacyHeaders\"\r\n            ];\r\n\r\n            for (const key of allowedOverrides) {\r\n                if (opts.options[key] !== undefined) {\r\n                    finalOptions[key] = opts.options[key];\r\n                }\r\n            }\r\n\r\n            const attemptedOverrides = Object.keys(opts.options).filter(\r\n                k => !allowedOverrides.includes(k) && k !== \"mode\"\r\n            );\r\n\r\n            if (attemptedOverrides.length > 0) {\r\n                logger.warn(\"Rate limit overrides ignored\", {\r\n                    layer: \"rate-limit-manager\",\r\n                    operation: \"configure\",\r\n                    mode,\r\n                    ignoredOptions: attemptedOverrides\r\n                });\r\n            }\r\n        }\r\n\r\n        finalOptions.standardHeaders ??= true;\r\n        finalOptions.legacyHeaders ??= false;\r\n\r\n        try {\r\n            logger.info(\"Rate limiting applied\", {\r\n                layer: \"rate-limit-manager\",\r\n                operation: \"apply\",\r\n                mode,\r\n                windowMs: finalOptions.windowMs,\r\n                max: finalOptions.max\r\n            });\r\n\r\n            return this.primaryAdapter.getMiddleware(finalOptions);\r\n\r\n        } catch (err: any) {\r\n            logger.warn(\"Primary rate limiter failed\", {\r\n                layer: \"rate-limit-manager\",\r\n                operation: \"apply\",\r\n                mode,\r\n                reason: err?.message\r\n            });\r\n\r\n            if (!this.fallbackAdapter) {\r\n                throw new AdapterError(\r\n                    \"Rate limiters failed; no fallback adapter configured.\"\r\n                );\r\n            }\r\n\r\n            try {\r\n                logger.warn(\"Using fallback rate limiter\", {\r\n                    layer: \"rate-limit-manager\",\r\n                    operation: \"fallback\",\r\n                    mode\r\n                });\r\n\r\n                return this.fallbackAdapter.getMiddleware(finalOptions);\r\n\r\n            } catch (fallbackErr: any) {\r\n                logger.error(\"Fallback rate limiter failed\", {\r\n                    layer: \"rate-limit-manager\",\r\n                    operation: \"fallback\",\r\n                    mode,\r\n                    reason: fallbackErr?.message\r\n                });\r\n\r\n                throw new AdapterError(\r\n                    \"Both primary and fallback rate limiters failed.\"\r\n                );\r\n            }\r\n        }\r\n    }\r\n}\r\n"]}

package/dist/managers/SanitizerManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SanitizerManager.d.ts","sourceRoot":"","sources":["../../src/managers/SanitizerManager.ts"],"names":[],"mappings":"AAGA,UAAU,gBAAgB;IACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,MAAM,CAAC;CACtD;AAED,qBAAa,gBAAgB;IACzB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,QAAQ,CAA0B;gBAE9B,OAAO,EAAE,gBAAgB,EAAE,QAAQ,GAAE,gBAAgB,GAAG,IAAW;IAK/E,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,MAAM;IAqB9C,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,IACZ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE,MAAM,GAAG;CA6D7C"}
+{"version":3,"file":"SanitizerManager.d.ts","sourceRoot":"","sources":["../../src/managers/SanitizerManager.ts"],"names":[],"mappings":"AAGA,UAAU,gBAAgB;IACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,MAAM,CAAC;CACtD;AAED,qBAAa,gBAAgB;IACzB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,QAAQ,CAA0B;gBAE9B,OAAO,EAAE,gBAAgB,EAAE,QAAQ,GAAE,gBAAgB,GAAG,IAAW;IAU/E,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,MAAM;IA6B9C,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,IACZ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE,MAAM,GAAG;CAsE7C"}

package/dist/managers/SanitizerManager.js

@@ -1,26 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SanitizerManager = void 0;
-const SanitizerError_js_1 = require("../core/errors/SanitizerError.js");
+const SanitizerError_1 = require("../core/errors/SanitizerError");
 const logging_1 = require("../logging");
 class SanitizerManager {
     constructor(primary, fallback = null) {
         this.primary = primary;
         this.fallback = fallback;
+        logging_1.logger.info("SanitizerManager initialized", {
+            layer: "sanitizer-manager",
+            fallbackEnabled: !!fallback
+        });
     }
     sanitize(value, options) {
-        if (typeof value !== 'string') {
+        if (typeof value !== "string") {
             return value;
         }
         try {
             return this.primary.sanitize(value, options);
         }
         catch (err) {
-            logging_1.logger.warn("Primary sanitizer failed", { error: err?.message });
+            logging_1.logger.warn("Primary sanitizer failed", {
+                layer: "sanitizer-manager",
+                operation: "sanitize",
+                reason: err?.message
+            });
             if (!this.fallback) {
-                throw new SanitizerError_js_1.SanitizerError("Primary sanitizer failed and no fallback available.");
+                throw new SanitizerError_1.SanitizerError("Primary sanitizer failed and no fallback available.");
             }
-            logging_1.logger.info("Using fallback sanitizer");
+            logging_1.logger.warn("Sanitizer fallback used", {
+                layer: "sanitizer-manager",
+                operation: "sanitize"
+            });
             return this.fallback.sanitize(value, options);
         }
     }
@@ -39,7 +50,10 @@ class SanitizerManager {
                         throw err;
                     }
                     fallbackTriggered = true;
-                    logging_1.logger.warn("Switching to fallback sanitizer for this request");
+                    logging_1.logger.warn("Switching to fallback sanitizer for request", {
+                        layer: "sanitizer-manager",
+                        operation: "middleware"
+                    });
                     return this.fallback.sanitize(value, options);
                 }
             };
@@ -53,19 +67,20 @@ class SanitizerManager {
                             sanitizedBody[key] = safeSanitize(value);
                         }
                         else if (Array.isArray(value)) {
-                            sanitizedBody[key] = value.map(item => typeof item === "string" ? safeSanitize(item) : item);
-                        }
-                        else if (value && typeof value === "object") {
-                            sanitizedBody[key] = value;
+                            sanitizedBody[key] = value.map(item => typeof item === "string"
+                                ? safeSanitize(item)
+                                : item);
                         }
                         else {
                             sanitizedBody[key] = value;
                         }
                     }
                     req.sanitizedBody = sanitizedBody;
-                    logging_1.logger.debug("Request body sanitized", {
-                        originalKeys: Object.keys(originalBody),
-                        sanitizedKeys: Object.keys(sanitizedBody),
+                    // ✅ visible + safe info
+                    logging_1.logger.info("Request body sanitized", {
+                        layer: "sanitizer-manager",
+                        operation: "middleware",
+                        fieldCount: Object.keys(sanitizedBody).length,
                         usedFallback: fallbackTriggered
                     });
                 }
@@ -73,9 +88,11 @@ class SanitizerManager {
             }
             catch (err) {
                 logging_1.logger.error("Sanitizer middleware failed", {
-                    error: err?.message
+                    layer: "sanitizer-manager",
+                    operation: "middleware",
+                    reason: err?.message
                 });
-                next(new SanitizerError_js_1.SanitizerError("Sanitizer middleware failure"));
+                next(new SanitizerError_1.SanitizerError("Sanitizer middleware failure"));
             }
         };
     }

package/dist/managers/SanitizerManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"SanitizerManager.js","sourceRoot":"","sources":["../../src/managers/SanitizerManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { SanitizerError } from \"../core/errors/SanitizerError.js\";\r\nimport { logger } from \"../logging\";\r\n\r\ninterface SanitizerAdapter {\r\n    sanitize: (value: string, options?: any) => string;\r\n}\r\n\r\nexport class SanitizerManager {\r\n    private primary: SanitizerAdapter;\r\n    private fallback: SanitizerAdapter | null;\r\n\r\n    constructor(primary: SanitizerAdapter, fallback: SanitizerAdapter | null = null) {\r\n        this.primary = primary;\r\n        this.fallback = fallback;\r\n    }\r\n\r\n    sanitize(value: string, options?: any): string {\r\n    \r\n        if (typeof value !== 'string') {\r\n            return value;\r\n        }\r\n\r\n        try {\r\n            return this.primary.sanitize(value, options);\r\n        } catch (err: any) {\r\n            logger.warn(\"Primary sanitizer failed\", { error: err?.message });\r\n\r\n            if (!this.fallback) {\r\n                throw new SanitizerError(\"Primary sanitizer failed and no fallback available.\");\r\n            }\r\n\r\n            logger.info(\"Using fallback sanitizer\");\r\n            return this.fallback.sanitize(value, options);\r\n        }\r\n    }\r\n\r\n   \r\n    middleware(options?: any) {\r\n        return (req: any, _res: any, next: any) => {\r\n            let fallbackTriggered = false;\r\n            \r\n            const safeSanitize = (value: string): string => {\r\n                if (fallbackTriggered && this.fallback) {\r\n                    return this.fallback.sanitize(value, options);\r\n                }\r\n                \r\n                try {\r\n                    return this.primary.sanitize(value, options);\r\n                } catch (err: any) {\r\n                    if (!this.fallback) {\r\n                        throw err;\r\n                    }\r\n                    \r\n                    fallbackTriggered = true;\r\n                    logger.warn(\"Switching to fallback sanitizer for this request\");\r\n                    return this.fallback.sanitize(value, options);\r\n                }\r\n            };\r\n\r\n            try {\r\n                \r\n                if (req.body && typeof req.body === \"object\") {\r\n                    const originalBody = req.body;\r\n                    const sanitizedBody: any = Array.isArray(originalBody) ? [] : {};\r\n                    \r\n                    for (const key of Object.keys(originalBody)) {\r\n                        const value = originalBody[key];\r\n                        \r\n                        if (typeof value === \"string\") {\r\n                            sanitizedBody[key] = safeSanitize(value);\r\n                        } else if (Array.isArray(value)) {\r\n                            sanitizedBody[key] = value.map(item => \r\n                                typeof item === \"string\" ? safeSanitize(item) : item\r\n                            );\r\n                        } else if (value && typeof value === \"object\") {\r\n                            sanitizedBody[key] = value; \r\n                        } else {\r\n                            sanitizedBody[key] = value;\r\n                        }\r\n                    }\r\n                    \r\n                    req.sanitizedBody = sanitizedBody;\r\n                    \r\n                    logger.debug(\"Request body sanitized\", {\r\n                        originalKeys: Object.keys(originalBody),\r\n                        sanitizedKeys: Object.keys(sanitizedBody),\r\n                        usedFallback: fallbackTriggered\r\n                    });\r\n                }\r\n\r\n                next();\r\n            } catch (err: any) {\r\n                logger.error(\"Sanitizer middleware failed\", {\r\n                    error: err?.message\r\n                });\r\n                next(new SanitizerError(\"Sanitizer middleware failure\"));\r\n            }\r\n        };\r\n    }\r\n}"]}
+{"version":3,"file":"SanitizerManager.js","sourceRoot":"","sources":["../../src/managers/SanitizerManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { SanitizerError } from \"../core/errors/SanitizerError\";\r\nimport { logger } from \"../logging\";\r\n\r\ninterface SanitizerAdapter {\r\n    sanitize: (value: string, options?: any) => string;\r\n}\r\n\r\nexport class SanitizerManager {\r\n    private primary: SanitizerAdapter;\r\n    private fallback: SanitizerAdapter | null;\r\n\r\n    constructor(primary: SanitizerAdapter, fallback: SanitizerAdapter | null = null) {\r\n        this.primary = primary;\r\n        this.fallback = fallback;\r\n\r\n        logger.info(\"SanitizerManager initialized\", {\r\n            layer: \"sanitizer-manager\",\r\n            fallbackEnabled: !!fallback\r\n        });\r\n    }\r\n\r\n    sanitize(value: string, options?: any): string {\r\n        if (typeof value !== \"string\") {\r\n            return value;\r\n        }\r\n\r\n        try {\r\n            return this.primary.sanitize(value, options);\r\n        } catch (err: any) {\r\n            logger.warn(\"Primary sanitizer failed\", {\r\n                layer: \"sanitizer-manager\",\r\n                operation: \"sanitize\",\r\n                reason: err?.message\r\n            });\r\n\r\n            if (!this.fallback) {\r\n                throw new SanitizerError(\r\n                    \"Primary sanitizer failed and no fallback available.\"\r\n                );\r\n            }\r\n\r\n            logger.warn(\"Sanitizer fallback used\", {\r\n                layer: \"sanitizer-manager\",\r\n                operation: \"sanitize\"\r\n            });\r\n\r\n            return this.fallback.sanitize(value, options);\r\n        }\r\n    }\r\n\r\n    middleware(options?: any) {\r\n        return (req: any, _res: any, next: any) => {\r\n            let fallbackTriggered = false;\r\n\r\n            const safeSanitize = (value: string): string => {\r\n                if (fallbackTriggered && this.fallback) {\r\n                    return this.fallback.sanitize(value, options);\r\n                }\r\n\r\n                try {\r\n                    return this.primary.sanitize(value, options);\r\n                } catch (err: any) {\r\n                    if (!this.fallback) {\r\n                        throw err;\r\n                    }\r\n\r\n                    fallbackTriggered = true;\r\n\r\n                    logger.warn(\"Switching to fallback sanitizer for request\", {\r\n                        layer: \"sanitizer-manager\",\r\n                        operation: \"middleware\"\r\n                    });\r\n\r\n                    return this.fallback.sanitize(value, options);\r\n                }\r\n            };\r\n\r\n            try {\r\n                if (req.body && typeof req.body === \"object\") {\r\n                    const originalBody = req.body;\r\n                    const sanitizedBody: any = Array.isArray(originalBody) ? [] : {};\r\n\r\n                    for (const key of Object.keys(originalBody)) {\r\n                        const value = originalBody[key];\r\n\r\n                        if (typeof value === \"string\") {\r\n                            sanitizedBody[key] = safeSanitize(value);\r\n                        } else if (Array.isArray(value)) {\r\n                            sanitizedBody[key] = value.map(item =>\r\n                                typeof item === \"string\"\r\n                                    ? safeSanitize(item)\r\n                                    : item\r\n                            );\r\n                        } else {\r\n                            sanitizedBody[key] = value;\r\n                        }\r\n                    }\r\n\r\n                    req.sanitizedBody = sanitizedBody;\r\n\r\n                    // ✅ visible + safe info\r\n                    logger.info(\"Request body sanitized\", {\r\n                        layer: \"sanitizer-manager\",\r\n                        operation: \"middleware\",\r\n                        fieldCount: Object.keys(sanitizedBody).length,\r\n                        usedFallback: fallbackTriggered\r\n                    });\r\n                }\r\n\r\n                next();\r\n            } catch (err: any) {\r\n                logger.error(\"Sanitizer middleware failed\", {\r\n                    layer: \"sanitizer-manager\",\r\n                    operation: \"middleware\",\r\n                    reason: err?.message\r\n                });\r\n\r\n                next(new SanitizerError(\"Sanitizer middleware failure\"));\r\n            }\r\n        };\r\n    }\r\n}\r\n"]}

package/dist/managers/ValidatorManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ValidatorManager.d.ts","sourceRoot":"","sources":["../../src/managers/ValidatorManager.ts"],"names":[],"mappings":"AAGA,UAAU,gBAAgB;IACtB,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC;CACnC;AAED,qBAAa,gBAAgB;IACzB,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,cAAc,CAAmB;gBAE7B,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB;IAK1E,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,IAST,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG;CA8C5C"}
+{"version":3,"file":"ValidatorManager.d.ts","sourceRoot":"","sources":["../../src/managers/ValidatorManager.ts"],"names":[],"mappings":"AAGA,UAAU,gBAAgB;IACtB,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC;CACnC;AAED,qBAAa,gBAAgB;IACzB,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,cAAc,CAAmB;gBAE7B,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB;IAU1E,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,IAST,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG;CAmE5C"}

package/dist/managers/ValidatorManager.js

@@ -2,11 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ValidatorManager = void 0;
 const logging_1 = require("../logging");
-const ValidationError_js_1 = require("../core/errors/ValidationError.js");
+const ValidationError_1 = require("../core/errors/ValidationError");
 class ValidatorManager {
     constructor(zodAdapter, expressAdapter) {
         this.zodAdapter = zodAdapter;
         this.expressAdapter = expressAdapter;
+        logging_1.logger.info("ValidatorManager initialized", {
+            layer: "validator-manager",
+            adapters: ["zod", "express-validator"]
+        });
     }
     validate(schema) {
         const isZod = schema &&
@@ -16,17 +20,25 @@ class ValidatorManager {
         const isExpressValidator = Array.isArray(schema);
         return (req, res, next) => {
             let middleware;
+            let adapterUsed = "none";
             if (isZod) {
-                logging_1.logger.debug("Using Zod adapter");
+                adapterUsed = "zod";
                 middleware = this.zodAdapter.validate(schema);
             }
             else if (isExpressValidator) {
-                logging_1.logger.debug(" Using express-validator adapter");
+                adapterUsed = "express-validator";
                 middleware = this.expressAdapter.validate(schema);
             }
             else {
                 return next();
             }
+            logging_1.logger.info("Validation adapter selected", {
+                layer: "validator-manager",
+                operation: "select",
+                adapter: adapterUsed,
+                path: req.path,
+                method: req.method
+            });
             // CASE 1 — express-validator returns ARRAY
             if (Array.isArray(middleware)) {
                 let idx = 0;
@@ -35,17 +47,23 @@ class ValidatorManager {
                         return next(err);
                     const fn = middleware[idx++];
                     if (!fn)
-                        return next(); // done
+                        return next();
                     try {
                         fn(req, res, run);
                     }
                     catch (error) {
-                        next(new ValidationError_js_1.ValidationError(error.message));
+                        logging_1.logger.error("Validation middleware execution failed", {
+                            layer: "validator-manager",
+                            operation: "execute",
+                            adapter: adapterUsed,
+                            reason: error?.message
+                        });
+                        next(new ValidationError_1.ValidationError(error.message));
                     }
                 };
                 return run();
             }
-            // CASE 2 — Zod returns SINGLE MIDDLEWARE
+            // CASE 2 — Zod returns SINGLE middleware
             try {
                 middleware(req, res, (err) => {
                     if (err)
@@ -54,7 +72,13 @@ class ValidatorManager {
                 });
             }
             catch (err) {
-                next(new ValidationError_js_1.ValidationError(err.message));
+                logging_1.logger.error("Validation middleware execution failed", {
+                    layer: "validator-manager",
+                    operation: "execute",
+                    adapter: adapterUsed,
+                    reason: err?.message
+                });
+                next(new ValidationError_1.ValidationError(err.message));
             }
         };
     }

package/dist/managers/ValidatorManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ValidatorManager.js","sourceRoot":"","sources":["../../src/managers/ValidatorManager.ts"],"names":[],"mappings":";;;AAAA,wCAAoC;AACpC,0EAAoE;AAMpE,MAAa,gBAAgB;IAIzB,YAAY,UAA4B,EAAE,cAAgC;QACtE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACzC,CAAC;IAED,QAAQ,CAAC,MAAY;QACjB,MAAM,KAAK,GACf,MAAM;YACN,OAAO,MAAM,KAAK,QAAQ;YAC1B,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAC/B,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU,CAAC;QAEnC,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEjD,OAAO,CAAC,GAAQ,EAAE,GAAQ,EAAE,IAAS,EAAE,EAAE;YACrC,IAAI,UAAU,CAAC;YAEf,IAAI,KAAK,EAAE,CAAC;gBACR,gBAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;gBAClC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAClD,CAAC;iBACI,IAAI,kBAAkB,EAAE,CAAC;gBAC1B,gBAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBACjD,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACtD,CAAC;iBACI,CAAC;gBACF,OAAO,IAAI,EAAE,CAAC;YAClB,CAAC;YAED,2CAA2C;YAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC5B,IAAI,GAAG,GAAG,CAAC,CAAC;gBAEZ,MAAM,GAAG,GAAG,CAAC,GAAS,EAAE,EAAE;oBACtB,IAAI,GAAG;wBAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;oBAE1B,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;oBAC7B,IAAI,CAAC,EAAE;wBAAE,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO;oBAE/B,IAAI,CAAC;wBACD,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;oBACtB,CAAC;oBAAC,OAAO,KAAU,EAAE,CAAC;wBAClB,IAAI,CAAC,IAAI,oCAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;oBAC7C,CAAC;gBACL,CAAC,CAAC;gBAEF,OAAO,GAAG,EAAE,CAAC;YACjB,CAAC;YAED,yCAAyC;YACzC,IAAI,CAAC;gBACD,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAS,EAAE,EAAE;oBAC/B,IAAI,GAAG;wBAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC1B,IAAI,EAAE,CAAC;gBACX,CAAC,CAAC,CAAC;YACP,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAChB,IAAI,CAAC,IAAI,oCAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YAC3C,CAAC;QACL,CAAC,CAAC;IACN,CAAC;CACJ;AAhED,4CAgEC","sourcesContent":["import { logger } from \"../logging\";\r\nimport { ValidationError } from \"../core/errors/ValidationError.js\";\r\n\r\ninterface ValidatorAdapter {\r\n    validate: (schema?: any) => any;\r\n}\r\n\r\nexport class ValidatorManager {\r\n    private zodAdapter: ValidatorAdapter;\r\n    private expressAdapter: ValidatorAdapter;\r\n\r\n    constructor(zodAdapter: ValidatorAdapter, expressAdapter: ValidatorAdapter) {\r\n        this.zodAdapter = zodAdapter;\r\n        this.expressAdapter = expressAdapter;\r\n    }\r\n\r\n    validate(schema?: any) {\r\n        const isZod =\r\n    schema &&\r\n    typeof schema === \"object\" &&\r\n    typeof schema._def === \"object\" && \r\n    typeof schema.safeParse === \"function\";\r\n\r\n        const isExpressValidator = Array.isArray(schema);\r\n\r\n        return (req: any, res: any, next: any) => {\r\n            let middleware;\r\n\r\n            if (isZod) {\r\n                logger.debug(\"Using Zod adapter\");\r\n                middleware = this.zodAdapter.validate(schema);\r\n            } \r\n            else if (isExpressValidator) {\r\n                logger.debug(\" Using express-validator adapter\");\r\n                middleware = this.expressAdapter.validate(schema);\r\n            } \r\n            else {\r\n                return next(); \r\n            }\r\n\r\n            // CASE 1 — express-validator returns ARRAY\r\n            if (Array.isArray(middleware)) {\r\n                let idx = 0;\r\n\r\n                const run = (err?: any) => {\r\n                    if (err) return next(err);\r\n\r\n                    const fn = middleware[idx++];\r\n                    if (!fn) return next(); // done\r\n\r\n                    try {\r\n                        fn(req, res, run);\r\n                    } catch (error: any) {\r\n                        next(new ValidationError(error.message));\r\n                    }\r\n                };\r\n\r\n                return run();\r\n            }\r\n\r\n            // CASE 2 — Zod returns SINGLE MIDDLEWARE\r\n            try {\r\n                middleware(req, res, (err?: any) => {\r\n                    if (err) return next(err);\r\n                    next();\r\n                });\r\n            } catch (err: any) {\r\n                next(new ValidationError(err.message));\r\n            }\r\n        };\r\n    }\r\n}\r\n\r\n"]}
+{"version":3,"file":"ValidatorManager.js","sourceRoot":"","sources":["../../src/managers/ValidatorManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { logger } from \"../logging\";\r\nimport { ValidationError } from \"../core/errors/ValidationError\";\r\n\r\ninterface ValidatorAdapter {\r\n    validate: (schema?: any) => any;\r\n}\r\n\r\nexport class ValidatorManager {\r\n    private zodAdapter: ValidatorAdapter;\r\n    private expressAdapter: ValidatorAdapter;\r\n\r\n    constructor(zodAdapter: ValidatorAdapter, expressAdapter: ValidatorAdapter) {\r\n        this.zodAdapter = zodAdapter;\r\n        this.expressAdapter = expressAdapter;\r\n\r\n        logger.info(\"ValidatorManager initialized\", {\r\n            layer: \"validator-manager\",\r\n            adapters: [\"zod\", \"express-validator\"]\r\n        });\r\n    }\r\n\r\n    validate(schema?: any) {\r\n        const isZod =\r\n            schema &&\r\n            typeof schema === \"object\" &&\r\n            typeof schema._def === \"object\" &&\r\n            typeof schema.safeParse === \"function\";\r\n\r\n        const isExpressValidator = Array.isArray(schema);\r\n\r\n        return (req: any, res: any, next: any) => {\r\n            let middleware;\r\n            let adapterUsed: \"zod\" | \"express-validator\" | \"none\" = \"none\";\r\n\r\n            if (isZod) {\r\n                adapterUsed = \"zod\";\r\n                middleware = this.zodAdapter.validate(schema);\r\n            } else if (isExpressValidator) {\r\n                adapterUsed = \"express-validator\";\r\n                middleware = this.expressAdapter.validate(schema);\r\n            } else {\r\n                return next();\r\n            }\r\n\r\n            logger.info(\"Validation adapter selected\", {\r\n                layer: \"validator-manager\",\r\n                operation: \"select\",\r\n                adapter: adapterUsed,\r\n                path: req.path,\r\n                method: req.method\r\n            });\r\n\r\n            // CASE 1 — express-validator returns ARRAY\r\n            if (Array.isArray(middleware)) {\r\n                let idx = 0;\r\n\r\n                const run = (err?: any) => {\r\n                    if (err) return next(err);\r\n\r\n                    const fn = middleware[idx++];\r\n                    if (!fn) return next();\r\n\r\n                    try {\r\n                        fn(req, res, run);\r\n                    } catch (error: any) {\r\n                        logger.error(\"Validation middleware execution failed\", {\r\n                            layer: \"validator-manager\",\r\n                            operation: \"execute\",\r\n                            adapter: adapterUsed,\r\n                            reason: error?.message\r\n                        });\r\n\r\n                        next(new ValidationError(error.message));\r\n                    }\r\n                };\r\n\r\n                return run();\r\n            }\r\n\r\n            // CASE 2 — Zod returns SINGLE middleware\r\n            try {\r\n                middleware(req, res, (err?: any) => {\r\n                    if (err) return next(err);\r\n                    next();\r\n                });\r\n            } catch (err: any) {\r\n                logger.error(\"Validation middleware execution failed\", {\r\n                    layer: \"validator-manager\",\r\n                    operation: \"execute\",\r\n                    adapter: adapterUsed,\r\n                    reason: err?.message\r\n                });\r\n\r\n                next(new ValidationError(err.message));\r\n            }\r\n        };\r\n    }\r\n}\r\n"]}

package/package.json

@@ -1,14 +1,10 @@
 {
     "name": "hi-secure",
-    "version": "1.0.15",
+    "version": "1.0.17",
     "description": "Unified security layer for Express.js: authentication, validation, sanitization, rate limiting and CORS",
+    "license": "MIT",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/100NikhilBro/hi-secure.git"
-    },
-    "homepage": "https://github.com/100NikhilBro/hi-secure#readme",
     "keywords": [
         "express",
         "security",

package/readme.md

@@ -97,7 +97,7 @@ Managing these separately leads to duplicated logic, configuration drift and sub
 
   <tr>
     <td>Logging</td>
-    <td>Beta</td>
+    <td>Better</td>
     <td>Structured internal logs</td>
   </tr>
 </table>
@@ -324,7 +324,7 @@ Choose the style based on complexity and ownership.
 
 <h4>express-validator (Rule-Based, Inline)</h4>
 
-<pre><code>import { body } from "express-validator";
+<pre><code>import { HiSecure , body } from "hi-secure";
 
 router.post(
   "/register",
@@ -346,7 +346,7 @@ router.post(
 
 <h4>Zod (Schema-Based, Reusable)</h4>
 
-<pre><code>import { z } from "zod";
+<pre><code>import { HiSecure , z } from "hi-secure";
 
 const registerSchema = z.object({
   email: z.string().email(),
@@ -455,9 +455,6 @@ HiSecure.getInstance({
 
 <hr/>
 
-<h2>Final Authentication Setup</h2>
-
-<hr/>
 
 <h2>🔐 Final Authentication Setup</h2>
 

package/src/adapters/ArgonAdapter.ts

@@ -3,12 +3,10 @@ import { AdapterError } from "../core/errors/AdapterError";
 import { logger } from "../logging";
 
 export class ArgonAdapter {
-    private options: argon2.Options | undefined;
+    private options?: argon2.Options;
 
     constructor(options?: argon2.Options) {
-        if (options) {
-            this.options = options;
-        }
+        this.options = options;
     }
 
     async hash(value: string): Promise<string> {
@@ -18,8 +16,11 @@ export class ArgonAdapter {
                 : await argon2.hash(value);
         } catch (err: any) {
             logger.error("Argon2 hashing failed", {
-                error: err?.message || err
+                adapter: "argon2",
+                operation: "hash",
+                reason: err?.message
             });
+
             throw new AdapterError("Argon2 hashing failed.");
         }
     }
@@ -33,8 +34,11 @@ export class ArgonAdapter {
             return await argon2.verify(hashed, value);
         } catch (err: any) {
             logger.error("Argon2 verify failed", {
-                error: err?.message || err
+                adapter: "argon2",
+                operation: "verify",
+                reason: err?.message
             });
+
             throw new AdapterError("Argon2 verify failed.");
         }
     }

package/src/adapters/BcryptAdapter.ts

@@ -14,8 +14,10 @@ export class BcryptAdapter {
             return await bcrypt.hash(value, this.saltRounds);
         } catch (err: any) {
             logger.error("Bcrypt hashing failed", {
-                error: err?.message || err,
-                saltRounds: this.saltRounds
+                adapter: "bcrypt",
+                operation: "hash",
+                saltRounds: this.saltRounds,
+                reason: err?.message
             });
 
             throw new AdapterError("Bcrypt hashing failed.");
@@ -35,15 +37,12 @@ export class BcryptAdapter {
             return await bcrypt.compare(value, hashed);
         } catch (err: any) {
             logger.error("Bcrypt verify failed", {
-                error: err?.message || err
+                adapter: "bcrypt",
+                operation: "verify",
+                reason: err?.message
             });
 
             throw new AdapterError("Bcrypt verify failed.");
         }
     }
 }
-
-
-
-
-

package/src/adapters/ExpressRLAdapter.ts

@@ -1,6 +1,6 @@
 import rateLimit from "express-rate-limit";
-import { logger } from "../logging/index.js";
-import { AdapterError } from "../core/errors/AdapterError.js";
+import { logger } from "../logging";
+import { AdapterError } from "../core/errors/AdapterError";
 
 export interface RateLimitOptions {
     windowMs?: number;
@@ -16,7 +16,7 @@ export class ExpressRLAdapter {
     getMiddleware(options: RateLimitOptions = {}) {
         try {
             const defaultOptions = {
-                windowMs: 15 * 60 * 1000, 
+                windowMs: 15 * 60 * 1000,
                 max: 100,
                 message: { error: "Too many requests" },
                 standardHeaders: true,
@@ -25,21 +25,26 @@ export class ExpressRLAdapter {
             };
 
             const finalOptions = { ...defaultOptions, ...options };
-            
+
             const limiter = rateLimit(finalOptions);
+
             
-            logger.debug("Express rate limiter configured", {
+            logger.info("Express rate limiter configured", {
+                adapter: "express-rate-limit",
+                operation: "configure",
                 windowMs: finalOptions.windowMs,
                 max: finalOptions.max
             });
 
             return limiter;
-
         } catch (err: any) {
-            logger.error("ExpressRLAdapter: failed to create limiter", {
-                error: err?.message || err
+            logger.error("Express rate limiter setup failed", {
+                adapter: "express-rate-limit",
+                operation: "configure",
+                reason: err?.message
             });
+
             throw new AdapterError("Express rate limiter creation failed.");
         }
     }
-}
+}