zario 0.3.5 → 0.3.6

package/dist/esm/filters/Filter.d.ts

@@ -1,47 +1,49 @@
 import { LogData } from '../types/index.js';
+import { LogLevel } from '../core/LogLevel.js';
 export interface Filter {
-    /**
-     * Determines if a log record should be emitted
-     * @param logData The structured log record
-     * @returns true if the log should be emitted, false if it should be filtered out
-     */
     shouldEmit(logData: LogData): boolean;
 }
 export type FilterPredicate = (logData: LogData) => boolean;
-/**
- * A filter that combines multiple filters with AND logic
- * Note: With an empty array of filters, this returns true (allows all logs).
- * This follows the mathematical concept of vacuous truth - "all" conditions
- * are satisfied when there are no conditions to check.
- */
 export declare class CompositeFilter implements Filter {
     private filters;
     constructor(filters: Filter[]);
     shouldEmit(logData: LogData): boolean;
 }
-/**
- * A filter that combines multiple filters with OR logic
- * Note: With an empty array of filters, this returns false (blocks all logs).
- * This is because there are no matching conditions when the filter array is empty.
- */
 export declare class OrFilter implements Filter {
     private filters;
     constructor(filters: Filter[]);
     shouldEmit(logData: LogData): boolean;
 }
-/**
- * A filter that negates another filter
- */
 export declare class NotFilter implements Filter {
     private filter;
     constructor(filter: Filter);
     shouldEmit(logData: LogData): boolean;
 }
-/**
- * A filter based on a predicate function
- */
 export declare class PredicateFilter implements Filter {
     private predicate;
     constructor(predicate: FilterPredicate);
     shouldEmit(logData: LogData): boolean;
 }
+export declare class LevelFilter implements Filter {
+    private allowedLevels;
+    constructor(allowedLevels: LogLevel[]);
+    shouldEmit(logData: LogData): boolean;
+}
+export declare class PrefixFilter implements Filter {
+    private allowedPrefixes;
+    constructor(allowedPrefixes: string[]);
+    shouldEmit(logData: LogData): boolean;
+}
+export declare class MetadataFilter implements Filter {
+    private requiredMetadata;
+    constructor(requiredMetadata: {
+        [key: string]: any;
+    });
+    shouldEmit(logData: LogData): boolean;
+}
+export declare class FieldFilter implements Filter {
+    private fieldName;
+    private expectedValue;
+    constructor(fieldName: string, expectedValue: any);
+    shouldEmit(logData: LogData): boolean;
+}

package/dist/esm/filters/Filter.js

@@ -1,9 +1,3 @@
-/**
- * A filter that combines multiple filters with AND logic
- * Note: With an empty array of filters, this returns true (allows all logs).
- * This follows the mathematical concept of vacuous truth - "all" conditions
- * are satisfied when there are no conditions to check.
- */
 export class CompositeFilter {
     constructor(filters) {
         this.filters = filters;
@@ -12,11 +6,6 @@ export class CompositeFilter {
         return this.filters.every(filter => filter.shouldEmit(logData));
     }
 }
-/**
- * A filter that combines multiple filters with OR logic
- * Note: With an empty array of filters, this returns false (blocks all logs).
- * This is because there are no matching conditions when the filter array is empty.
- */
 export class OrFilter {
     constructor(filters) {
         this.filters = filters;
@@ -25,9 +14,6 @@ export class OrFilter {
         return this.filters.some(filter => filter.shouldEmit(logData));
     }
 }
-/**
- * A filter that negates another filter
- */
 export class NotFilter {
     constructor(filter) {
         this.filter = filter;
@@ -36,9 +22,6 @@ export class NotFilter {
         return !this.filter.shouldEmit(logData);
     }
 }
-/**
- * A filter based on a predicate function
- */
 export class PredicateFilter {
     constructor(predicate) {
         this.predicate = predicate;
@@ -47,3 +30,50 @@ export class PredicateFilter {
         return this.predicate(logData);
     }
 }
+export class LevelFilter {
+    constructor(allowedLevels) {
+        this.allowedLevels = new Set(allowedLevels);
+    }
+    shouldEmit(logData) {
+        return this.allowedLevels.has(logData.level);
+    }
+}
+export class PrefixFilter {
+    constructor(allowedPrefixes) {
+        this.allowedPrefixes = new Set(allowedPrefixes);
+    }
+    shouldEmit(logData) {
+        if (!logData.prefix) {
+            return this.allowedPrefixes.has('');
+        }
+        return this.allowedPrefixes.has(logData.prefix);
+    }
+}
+export class MetadataFilter {
+    constructor(requiredMetadata) {
+        this.requiredMetadata = requiredMetadata;
+    }
+    shouldEmit(logData) {
+        if (!logData.metadata) {
+            return Object.keys(this.requiredMetadata).length === 0;
+        }
+        for (const [key, value] of Object.entries(this.requiredMetadata)) {
+            if (logData.metadata[key] !== value) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+export class FieldFilter {
+    constructor(fieldName, expectedValue) {
+        this.fieldName = fieldName;
+        this.expectedValue = expectedValue;
+    }
+    shouldEmit(logData) {
+        if (!logData.metadata) {
+            return false;
+        }
+        return logData.metadata[this.fieldName] === this.expectedValue;
+    }
+}

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

@@ -1,2 +1 @@
 export * from './Filter.js';
-export * from './SpecificFilters.js';

package/dist/esm/filters/index.js

@@ -1,2 +1 @@
 export * from './Filter.js';
-export * from './SpecificFilters.js';

package/dist/esm/index.d.ts

@@ -6,6 +6,7 @@ import { CustomLogLevelConfig } from './core/CustomLogLevel.js';
 import { Filter, CompositeFilter, OrFilter, NotFilter, PredicateFilter, LevelFilter, PrefixFilter, MetadataFilter, FieldFilter } from './filters/index.js';
 import { LogAggregator, BatchAggregator, TimeBasedAggregator, CompositeAggregator } from './aggregation/index.js';
 import { LogEnricher, MetadataEnricher, LogEnrichmentPipeline } from './structured/index.js';
-export { Logger, ConsoleTransport, FileTransport, HttpTransport, FilterableTransport, CompositeFilter, OrFilter, NotFilter, PredicateFilter, LevelFilter, PrefixFilter, MetadataFilter, FieldFilter, BatchAggregator, TimeBasedAggregator, CompositeAggregator, MetadataEnricher, LogEnrichmentPipeline };
+import { Timer } from './utils/index.js';
+export { Logger, ConsoleTransport, FileTransport, HttpTransport, FilterableTransport, CompositeFilter, OrFilter, NotFilter, PredicateFilter, LevelFilter, PrefixFilter, MetadataFilter, FieldFilter, BatchAggregator, TimeBasedAggregator, CompositeAggregator, MetadataEnricher, LogEnrichmentPipeline, Timer };
 export type { LogLevel, Transport, TransportConfig, LoggerConfig, CustomLogLevelConfig, Filter, LogAggregator, LogEnricher };
 export default Logger;

package/dist/esm/index.js

@@ -3,6 +3,7 @@ import { ConsoleTransport, FileTransport, HttpTransport, FilterableTransport } f
 import { CompositeFilter, OrFilter, NotFilter, PredicateFilter, LevelFilter, PrefixFilter, MetadataFilter, FieldFilter } from './filters/index.js';
 import { BatchAggregator, TimeBasedAggregator, CompositeAggregator } from './aggregation/index.js';
 import { MetadataEnricher, LogEnrichmentPipeline } from './structured/index.js';
+import { Timer } from './utils/index.js';
 // Configure default transports to maintain backward compatibility
 Logger.defaultTransportsFactory = (isProd) => {
     if (isProd) {
@@ -18,5 +19,7 @@ CompositeFilter, OrFilter, NotFilter, PredicateFilter, LevelFilter, PrefixFilter
 // Aggregators
 BatchAggregator, TimeBasedAggregator, CompositeAggregator, 
 // Structured logging extensions
-MetadataEnricher, LogEnrichmentPipeline };
+MetadataEnricher, LogEnrichmentPipeline, 
+// Utils
+Timer };
 export default Logger;

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

@@ -0,0 +1,15 @@
+export declare class ColorUtil {
+    private static readonly ANSI_COLORS;
+    static colorize(text: string, color: string): string;
+}
+export declare class TimeUtil {
+    static format(date: Date, format: string): string;
+}
+export declare class Timer {
+    private startTime;
+    private name;
+    private logFn;
+    private hasEnded;
+    constructor(name: string, logFn: (message: string) => void);
+    end(): void;
+}

package/dist/esm/utils/index.js

@@ -0,0 +1,72 @@
+export class ColorUtil {
+    static colorize(text, color) {
+        const supportsColor = process.env.FORCE_COLOR !== "0" &&
+            (process.stdout.isTTY || process.env.FORCE_COLOR === "1");
+        if (!supportsColor) {
+            return text;
+        }
+        const colorCode = ColorUtil.ANSI_COLORS[color] || ColorUtil.ANSI_COLORS.reset;
+        return `${colorCode}${text}${ColorUtil.ANSI_COLORS.reset}`;
+    }
+}
+ColorUtil.ANSI_COLORS = {
+    black: "\x1b[30m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    magenta: "\x1b[35m",
+    cyan: "\x1b[36m",
+    white: "\x1b[37m",
+    brightRed: "\x1b[91m",
+    brightGreen: "\x1b[92m",
+    brightYellow: "\x1b[93m",
+    brightBlue: "\x1b[94m",
+    brightMagenta: "\x1b[95m",
+    brightCyan: "\x1b[96m",
+    brightWhite: "\x1b[97m",
+    info: "\x1b[32m",
+    warn: "\x1b[33m",
+    error: "\x1b[31m",
+    debug: "\x1b[36m",
+    boring: "\x1b[37m",
+    reset: "\x1b[0m",
+};
+export class TimeUtil {
+    static format(date, format) {
+        if (format === "ISO")
+            return date.toISOString();
+        if (format === "UTC")
+            return date.toUTCString();
+        if (format === "LOCAL")
+            return date.toLocaleString();
+        const pad = (n, width = 2) => n.toString().padStart(width, "0");
+        const tokens = {
+            YYYY: pad(date.getFullYear(), 4),
+            MM: pad(date.getMonth() + 1),
+            DD: pad(date.getDate()),
+            HH: pad(date.getHours()),
+            mm: pad(date.getMinutes()),
+            ss: pad(date.getSeconds()),
+            SSS: pad(date.getMilliseconds(), 3),
+        };
+        return format.replace(/YYYY|MM|DD|HH|mm|ss|SSS/g, (match) => tokens[match] || match);
+    }
+}
+export class Timer {
+    constructor(name, logFn) {
+        this.hasEnded = false;
+        this.name = name;
+        this.logFn = logFn;
+        this.startTime = Date.now();
+    }
+    end() {
+        if (this.hasEnded) {
+            return;
+        }
+        const endTime = Date.now();
+        const duration = endTime - this.startTime;
+        this.logFn(`${this.name} took ${duration}ms`);
+        this.hasEnded = true;
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zario",
-  "version": "0.3.5",
-  "description": "A minimal, fast logging library for Node.js.",
+  "version": "0.3.6",
+  "description": "just a minimal, fast, and feature-rich logging library for Node.js.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/esm/index.d.ts",
@@ -39,7 +39,8 @@
     "logger",
     "console",
     "terminal",
-    "typescript"
+    "typescript",
+    "nodejs"
   ],
   "author": "Dev-dami",
   "license": "MIT",

package/dist/cjs/filters/SpecificFilters.js

@@ -1,71 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FieldFilter = exports.MetadataFilter = exports.PrefixFilter = exports.LevelFilter = void 0;
-/**
- * A filter that allows logs based on their log level
- */
-class LevelFilter {
-    constructor(allowedLevels) {
-        this.allowedLevels = new Set(allowedLevels);
-    }
-    shouldEmit(logData) {
-        return this.allowedLevels.has(logData.level);
-    }
-}
-exports.LevelFilter = LevelFilter;
-/**
- * A filter that allows logs based on their prefix/namespace
- */
-class PrefixFilter {
-    constructor(allowedPrefixes) {
-        this.allowedPrefixes = new Set(allowedPrefixes);
-    }
-    shouldEmit(logData) {
-        if (!logData.prefix) {
-            // If no prefix exists, only allow if empty string is in allowed prefixes
-            return this.allowedPrefixes.has('');
-        }
-        return this.allowedPrefixes.has(logData.prefix);
-    }
-}
-exports.PrefixFilter = PrefixFilter;
-/**
- * A filter that allows logs based on specific metadata fields
- * Note: Uses strict equality (===) for comparison, which means objects and arrays
- * will only match if they are the same reference. For deep comparison of complex
- * values, consider implementing a custom filter.
- */
-class MetadataFilter {
-    constructor(requiredMetadata) {
-        this.requiredMetadata = requiredMetadata;
-    }
-    shouldEmit(logData) {
-        if (!logData.metadata) {
-            // If no metadata exists but we require some, return false
-            return Object.keys(this.requiredMetadata).length === 0;
-        }
-        for (const [key, value] of Object.entries(this.requiredMetadata)) {
-            if (logData.metadata[key] !== value) {
-                return false;
-            }
-        }
-        return true;
-    }
-}
-exports.MetadataFilter = MetadataFilter;
-/**
- * A filter that allows logs based on a custom field in metadata
- */
-class FieldFilter {
-    constructor(fieldName, expectedValue) {
-        this.fieldName = fieldName;
-        this.expectedValue = expectedValue;
-    }
-    shouldEmit(logData) {
-        if (!logData.metadata) {
-            return false;
-        }
-        return logData.metadata[this.fieldName] === this.expectedValue;
-    }
-}
-exports.FieldFilter = FieldFilter;

package/dist/cjs/utils/ColorUtil.js

@@ -1,42 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ColorUtil = void 0;
-class ColorUtil {
-    static colorize(text, color) {
-        const supportsColor = process.env.FORCE_COLOR !== "0" &&
-            (process.stdout.isTTY || process.env.FORCE_COLOR === "1");
-        if (!supportsColor) {
-            return text;
-        }
-        const colorCode = ColorUtil.ANSI_COLORS[color] || ColorUtil.ANSI_COLORS.reset;
-        return `${colorCode}${text}${ColorUtil.ANSI_COLORS.reset}`;
-    }
-}
-exports.ColorUtil = ColorUtil;
-// ANSI color codes
-ColorUtil.ANSI_COLORS = {
-    // Standard colors
-    black: "\x1b[30m",
-    red: "\x1b[31m",
-    green: "\x1b[32m",
-    yellow: "\x1b[33m",
-    blue: "\x1b[34m",
-    magenta: "\x1b[35m",
-    cyan: "\x1b[36m",
-    white: "\x1b[37m",
-    // Bright colors
-    brightRed: "\x1b[91m",
-    brightGreen: "\x1b[92m",
-    brightYellow: "\x1b[93m",
-    brightBlue: "\x1b[94m",
-    brightMagenta: "\x1b[95m",
-    brightCyan: "\x1b[96m",
-    brightWhite: "\x1b[97m",
-    // Default log level colors
-    info: "\x1b[32m",
-    warn: "\x1b[33m",
-    error: "\x1b[31m",
-    debug: "\x1b[36m",
-    boring: "\x1b[37m",
-    reset: "\x1b[0m",
-};

package/dist/cjs/utils/TimeUtil.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimeUtil = void 0;
-class TimeUtil {
-    // util class for date formating
-    static format(date, format) {
-        if (format === "ISO")
-            return date.toISOString();
-        if (format === "UTC")
-            return date.toUTCString();
-        if (format === "LOCAL")
-            return date.toLocaleString();
-        const pad = (n, width = 2) => n.toString().padStart(width, "0");
-        const tokens = {
-            YYYY: pad(date.getFullYear(), 4),
-            MM: pad(date.getMonth() + 1),
-            DD: pad(date.getDate()),
-            HH: pad(date.getHours()),
-            mm: pad(date.getMinutes()),
-            ss: pad(date.getSeconds()),
-            SSS: pad(date.getMilliseconds(), 3),
-        };
-        return format.replace(/YYYY|MM|DD|HH|mm|ss|SSS/g, (match) => tokens[match] || match);
-    }
-}
-exports.TimeUtil = TimeUtil;

package/dist/cjs/utils/Timerutil.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Timer = void 0;
-class Timer {
-    constructor(name, logFn) {
-        this.hasEnded = false;
-        this.name = name;
-        this.logFn = logFn;
-        this.startTime = Date.now();
-    }
-    end() {
-        // If already ended, do nothing (idempotent)
-        if (this.hasEnded) {
-            return;
-        }
-        const endTime = Date.now();
-        const duration = endTime - this.startTime;
-        this.logFn(`${this.name} took ${duration}ms`);
-        this.hasEnded = true;
-    }
-}
-exports.Timer = Timer;

package/dist/esm/filters/SpecificFilters.d.ts

@@ -1,41 +0,0 @@
-import { LogData } from '../types/index.js';
-import { LogLevel } from '../core/LogLevel.js';
-import { Filter } from './Filter.js';
-/**
- * A filter that allows logs based on their log level
- */
-export declare class LevelFilter implements Filter {
-    private allowedLevels;
-    constructor(allowedLevels: LogLevel[]);
-    shouldEmit(logData: LogData): boolean;
-}
-/**
- * A filter that allows logs based on their prefix/namespace
- */
-export declare class PrefixFilter implements Filter {
-    private allowedPrefixes;
-    constructor(allowedPrefixes: string[]);
-    shouldEmit(logData: LogData): boolean;
-}
-/**
- * A filter that allows logs based on specific metadata fields
- * Note: Uses strict equality (===) for comparison, which means objects and arrays
- * will only match if they are the same reference. For deep comparison of complex
- * values, consider implementing a custom filter.
- */
-export declare class MetadataFilter implements Filter {
-    private requiredMetadata;
-    constructor(requiredMetadata: {
-        [key: string]: any;
-    });
-    shouldEmit(logData: LogData): boolean;
-}
-/**
- * A filter that allows logs based on a custom field in metadata
- */
-export declare class FieldFilter implements Filter {
-    private fieldName;
-    private expectedValue;
-    constructor(fieldName: string, expectedValue: any);
-    shouldEmit(logData: LogData): boolean;
-}

package/dist/esm/filters/SpecificFilters.js

@@ -1,64 +0,0 @@
-/**
- * A filter that allows logs based on their log level
- */
-export class LevelFilter {
-    constructor(allowedLevels) {
-        this.allowedLevels = new Set(allowedLevels);
-    }
-    shouldEmit(logData) {
-        return this.allowedLevels.has(logData.level);
-    }
-}
-/**
- * A filter that allows logs based on their prefix/namespace
- */
-export class PrefixFilter {
-    constructor(allowedPrefixes) {
-        this.allowedPrefixes = new Set(allowedPrefixes);
-    }
-    shouldEmit(logData) {
-        if (!logData.prefix) {
-            // If no prefix exists, only allow if empty string is in allowed prefixes
-            return this.allowedPrefixes.has('');
-        }
-        return this.allowedPrefixes.has(logData.prefix);
-    }
-}
-/**
- * A filter that allows logs based on specific metadata fields
- * Note: Uses strict equality (===) for comparison, which means objects and arrays
- * will only match if they are the same reference. For deep comparison of complex
- * values, consider implementing a custom filter.
- */
-export class MetadataFilter {
-    constructor(requiredMetadata) {
-        this.requiredMetadata = requiredMetadata;
-    }
-    shouldEmit(logData) {
-        if (!logData.metadata) {
-            // If no metadata exists but we require some, return false
-            return Object.keys(this.requiredMetadata).length === 0;
-        }
-        for (const [key, value] of Object.entries(this.requiredMetadata)) {
-            if (logData.metadata[key] !== value) {
-                return false;
-            }
-        }
-        return true;
-    }
-}
-/**
- * A filter that allows logs based on a custom field in metadata
- */
-export class FieldFilter {
-    constructor(fieldName, expectedValue) {
-        this.fieldName = fieldName;
-        this.expectedValue = expectedValue;
-    }
-    shouldEmit(logData) {
-        if (!logData.metadata) {
-            return false;
-        }
-        return logData.metadata[this.fieldName] === this.expectedValue;
-    }
-}

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

@@ -1,4 +0,0 @@
-export declare class ColorUtil {
-    private static readonly ANSI_COLORS;
-    static colorize(text: string, color: string): string;
-}

package/dist/esm/utils/ColorUtil.js

@@ -1,38 +0,0 @@
-export class ColorUtil {
-    static colorize(text, color) {
-        const supportsColor = process.env.FORCE_COLOR !== "0" &&
-            (process.stdout.isTTY || process.env.FORCE_COLOR === "1");
-        if (!supportsColor) {
-            return text;
-        }
-        const colorCode = ColorUtil.ANSI_COLORS[color] || ColorUtil.ANSI_COLORS.reset;
-        return `${colorCode}${text}${ColorUtil.ANSI_COLORS.reset}`;
-    }
-}
-// ANSI color codes
-ColorUtil.ANSI_COLORS = {
-    // Standard colors
-    black: "\x1b[30m",
-    red: "\x1b[31m",
-    green: "\x1b[32m",
-    yellow: "\x1b[33m",
-    blue: "\x1b[34m",
-    magenta: "\x1b[35m",
-    cyan: "\x1b[36m",
-    white: "\x1b[37m",
-    // Bright colors
-    brightRed: "\x1b[91m",
-    brightGreen: "\x1b[92m",
-    brightYellow: "\x1b[93m",
-    brightBlue: "\x1b[94m",
-    brightMagenta: "\x1b[95m",
-    brightCyan: "\x1b[96m",
-    brightWhite: "\x1b[97m",
-    // Default log level colors
-    info: "\x1b[32m",
-    warn: "\x1b[33m",
-    error: "\x1b[31m",
-    debug: "\x1b[36m",
-    boring: "\x1b[37m",
-    reset: "\x1b[0m",
-};

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

@@ -1,3 +0,0 @@
-export declare class TimeUtil {
-    static format(date: Date, format: string): string;
-}

package/dist/esm/utils/TimeUtil.js

@@ -1,22 +0,0 @@
-export class TimeUtil {
-    // util class for date formating
-    static format(date, format) {
-        if (format === "ISO")
-            return date.toISOString();
-        if (format === "UTC")
-            return date.toUTCString();
-        if (format === "LOCAL")
-            return date.toLocaleString();
-        const pad = (n, width = 2) => n.toString().padStart(width, "0");
-        const tokens = {
-            YYYY: pad(date.getFullYear(), 4),
-            MM: pad(date.getMonth() + 1),
-            DD: pad(date.getDate()),
-            HH: pad(date.getHours()),
-            mm: pad(date.getMinutes()),
-            ss: pad(date.getSeconds()),
-            SSS: pad(date.getMilliseconds(), 3),
-        };
-        return format.replace(/YYYY|MM|DD|HH|mm|ss|SSS/g, (match) => tokens[match] || match);
-    }
-}

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

@@ -1,8 +0,0 @@
-export declare class Timer {
-    private startTime;
-    private name;
-    private logFn;
-    private hasEnded;
-    constructor(name: string, logFn: (message: string) => void);
-    end(): void;
-}

package/dist/esm/utils/Timerutil.js

@@ -1,18 +0,0 @@
-export class Timer {
-    constructor(name, logFn) {
-        this.hasEnded = false;
-        this.name = name;
-        this.logFn = logFn;
-        this.startTime = Date.now();
-    }
-    end() {
-        // If already ended, do nothing (idempotent)
-        if (this.hasEnded) {
-            return;
-        }
-        const endTime = Date.now();
-        const duration = endTime - this.startTime;
-        this.logFn(`${this.name} took ${duration}ms`);
-        this.hasEnded = true;
-    }
-}