@warlock.js/logger 4.0.158 → 4.0.162

package/esm/channels/console-log.d.ts

@@ -0,0 +1,17 @@
+import { LogChannel } from "../log-channel";
+import type { BasicLogConfigurations, LoggingData } from "../types";
+export declare class ConsoleLog extends LogChannel<BasicLogConfigurations> {
+    /**
+     * {@inheritdoc}
+     */
+    name: string;
+    /**
+     * Determine if channel is logging in terminal
+     */
+    terminal: boolean;
+    /**
+     * {@inheritdoc}
+     */
+    log(data: LoggingData): void;
+}
+//# sourceMappingURL=console-log.d.ts.map

package/esm/channels/console-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-log.d.ts","sourceRoot":"","sources":["../../src/channels/console-log.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEpE,qBAAa,UAAW,SAAQ,UAAU,CAAC,sBAAsB,CAAC;IAChE;;OAEG;IACI,IAAI,SAAa;IAExB;;OAEG;IACI,QAAQ,UAAQ;IAEvB;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,WAAW;CA0E7B"}

package/esm/channels/console-log.js

@@ -0,0 +1,47 @@
+import {colors}from'@mongez/copper';import {LogChannel}from'../log-channel.js';class ConsoleLog extends LogChannel {
+    /**
+     * {@inheritdoc}
+     */
+    name = "console";
+    /**
+     * Determine if channel is logging in terminal
+     */
+    terminal = true;
+    /**
+     * {@inheritdoc}
+     */
+    log(data) {
+        const { module, action, message, type: level } = data;
+        if (!this.shouldBeLogged(data))
+            return;
+        // display date and time with milliseconds
+        const date = new Date().toISOString(); // i.e 2021-01-01T00:00:00.000Z
+        switch (level) {
+            case "debug":
+                // add a debug icon
+                console.log(colors.magentaBright("⚙"), colors.yellow(`(${date})`), colors.cyan(`[${module}]`), colors.magenta(`[${action}]`), colors.magentaBright(message));
+                break;
+            case "info":
+                // add an info icon
+                console.log(colors.blueBright("ℹ"), colors.yellow(`(${date})`), colors.cyan(`[${module}]`), colors.magenta(`[${action}]`), colors.blueBright(message));
+                break;
+            case "warn":
+                // add a warning icon
+                console.log(colors.yellow("⚠"), colors.yellow(`(${date})`), colors.cyan(`[${module}]`), colors.magenta(`[${action}]`), colors.yellowBright(message));
+                break;
+            case "error":
+                // add an error icon
+                console.log(colors.red("✗"), colors.yellow(`(${date})`), colors.cyan(`[${module}]`), colors.magenta(`[${action}]`), colors.redBright(message));
+                break;
+            case "success":
+                // add a success icon
+                console.log(colors.green("✓"), colors.yellow(`(${date})`), colors.cyan(`[${module}]`), colors.magenta(`[${action}]`), colors.greenBright(message));
+                break;
+            default:
+                console.log("[log]", colors.yellow(`(${date})`), colors.cyan(`[${module}]`), colors.magenta(`[${action}]`), message);
+        }
+        if (typeof message === "object") {
+            console.log(message);
+        }
+    }
+}export{ConsoleLog};//# sourceMappingURL=console-log.js.map

package/esm/channels/console-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-log.js","sources":["../../src/channels/console-log.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/esm/channels/file-log.d.ts

@@ -0,0 +1,171 @@
+import { LogChannel } from "../log-channel";
+import type { BasicLogConfigurations, LogContract, LoggingData, LogLevel, LogMessage } from "../types";
+export type FileLogConfig = BasicLogConfigurations & {
+    storagePath?: string;
+    /**
+     * File name, without extension
+     */
+    name?: string;
+    /**
+     * chunk mode
+     * If set to `single`, the logs will be created in a single file, unless the rotate is set to true
+     * If set to `daily`, the logs will be created in a daily file, unless the rotate is set to true
+     * If set to `hourly`, the logs will be created in an hourly file, unless the rotate is set to true
+     * @default single
+     */
+    chunk?: "single" | "daily" | "hourly";
+    /**
+     * Whether to rotate the file
+     *
+     * @default true
+     */
+    rotate?: boolean;
+    /**
+     * File Extension
+     *
+     * @default log
+     */
+    extension?: string;
+    /**
+     * If rotate is set, the rotate name will be added to the file name suffixed with `-`
+     *
+     * @default DD-MM-YYYY
+     */
+    rotateFileName?: string;
+    /**
+     * Max file size before rotating the file
+     *
+     * @default 10MB
+     */
+    maxFileSize?: number;
+    /**
+     * Set the max messages that needs to be added before writing to the file
+     *
+     * @default 100
+     */
+    maxMessagesToWrite?: number;
+    /**
+     * Group logs by
+     * Please note that the order matters here
+     * For example, if you set `groupBy: ['level', 'module']`, the logs will be added in level name first, then by module
+     *
+     * @default none
+     */
+    groupBy?: ("level" | "module" | "action")[];
+    /**
+     * Define what levels should be logged
+     *
+     * @default all
+     */
+    levels?: LogLevel[];
+    /**
+     * Date and time format
+     */
+    dateFormat?: {
+        date?: string;
+        time?: string;
+    };
+};
+export declare class FileLog extends LogChannel<FileLogConfig> implements LogContract {
+    /**
+     * {@inheritdoc}
+     */
+    name: string;
+    /**
+     * Messages buffer
+     */
+    protected messages: LogMessage[];
+    /**
+     * Grouped messages
+     */
+    protected groupedMessages: Record<string, LogMessage[]>;
+    /**
+     * Default channel configurations
+     */
+    protected defaultConfigurations: FileLogConfig;
+    /**
+     * Last write time
+     */
+    protected lastWriteTime: number;
+    /**
+     * A flag to determine if the file is being written
+     */
+    protected isWriting: boolean;
+    /**
+     * Check file size for file rotation
+     */
+    protected checkAndRotateFile(filePath?: string): Promise<void>;
+    /**
+     * Rotate log file
+     */
+    protected rotateLogFile(): Promise<void>;
+    /**
+     * Flush messages
+     */
+    protected initMessageFlush(): void;
+    /**
+     * Get file path
+     */
+    get filePath(): string;
+    /**
+     * Get max messages
+     */
+    protected get maxMessagesToWrite(): number;
+    /**
+     * Get file name
+     */
+    get fileName(): string;
+    /**
+     * Get file extension
+     */
+    get extension(): string;
+    /**
+     * Get content
+     */
+    protected get content(): string;
+    /**
+     * Get storage path
+     */
+    get storagePath(): string;
+    /**
+     * {@inheritdoc}
+     */
+    protected init(): Promise<void>;
+    /**
+     * Synchronously flush messages
+     */
+    flushSync(): void;
+    /**
+     * {@inheritdoc}
+     */
+    log(data: LoggingData): Promise<void>;
+    /**
+     * Check if messages should be written
+     */
+    protected checkIfMessagesShouldBeWritten(): Promise<void>;
+    /**
+     * Should be called after messages are saved
+     */
+    protected onSave(): void;
+    /**
+     * Check if messages should be grouped
+     */
+    protected get messagedShouldBeGrouped(): boolean;
+    /**
+     * Write messages to the file
+     */
+    protected writeMessagesToFile(): Promise<void>;
+    /**
+     * Write grouped messages to the file
+     */
+    protected writeGroupedMessagesToFile(): Promise<void>;
+    /**
+     * Prepare grouped messages
+     */
+    protected prepareGroupedMessages(): void;
+    /**
+     * Start writing to the file
+     */
+    protected write(filePath: string, content: string): Promise<unknown>;
+}
+//# sourceMappingURL=file-log.d.ts.map

package/esm/channels/file-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-log.d.ts","sourceRoot":"","sources":["../../src/channels/file-log.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EACV,sBAAsB,EACtB,WAAW,EACX,WAAW,EACX,QAAQ,EACR,UAAU,EACX,MAAM,UAAU,CAAC;AAIlB,MAAM,MAAM,aAAa,GAAG,sBAAsB,GAAG;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtC;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC5C;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB;;OAEG;IACH,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAEF,qBAAa,OAAQ,SAAQ,UAAU,CAAC,aAAa,CAAE,YAAW,WAAW;IAC3E;;OAEG;IACI,IAAI,SAAU;IAErB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAM;IAEtC;;OAEG;IACH,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAM;IAE7D;;OAEG;IACH,SAAS,CAAC,qBAAqB,EAAE,aAAa,CAgB5C;IAEF;;OAEG;IACH,SAAS,CAAC,aAAa,SAAc;IAErC;;OAEG;IACH,SAAS,CAAC,SAAS,UAAS;IAE5B;;OAEG;cACa,kBAAkB,CAAC,QAAQ,SAAgB;IAkB3D;;OAEG;cACa,aAAa;IAY7B;;OAEG;IACH,SAAS,CAAC,gBAAgB;IAW1B;;OAEG;IACH,IAAW,QAAQ,WAMlB;IAED;;OAEG;IACH,SAAS,KAAK,kBAAkB,IAAI,MAAM,CAEzC;IAED;;OAEG;IACH,IAAW,QAAQ,IAAI,MAAM,CAY5B;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,SAAS,KAAK,OAAO,WAEpB;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED;;OAEG;cACa,IAAI;IAQpB;;OAEG;IACI,SAAS,IAAI,IAAI;IAoBxB;;OAEG;IACU,GAAG,CAAC,IAAI,EAAE,WAAW;IAsClC;;OAEG;cACa,8BAA8B;IAM9C;;OAEG;IACH,SAAS,CAAC,MAAM;IAOhB;;OAEG;IACH,SAAS,KAAK,uBAAuB,IAAI,OAAO,CAE/C;IAED;;OAEG;cACa,mBAAmB;IAqBnC;;OAEG;cACa,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B3D;;OAEG;IACH,SAAS,CAAC,sBAAsB,IAAI,IAAI;IAWxC;;OAEG;cACa,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAcxD"}

package/esm/channels/file-log.js

@@ -0,0 +1,293 @@
+import {ensureDirectoryAsync}from'@mongez/fs';import dayjs from'dayjs';import fs from'fs';import {EOL}from'os';import path from'path';import {LogChannel}from'../log-channel.js';class FileLog extends LogChannel {
+    /**
+     * {@inheritdoc}
+     */
+    name = "file";
+    /**
+     * Messages buffer
+     */
+    messages = [];
+    /**
+     * Grouped messages
+     */
+    groupedMessages = {};
+    /**
+     * Default channel configurations
+     */
+    defaultConfigurations = {
+        storagePath: process.cwd() + "/storage/logs",
+        rotate: true,
+        name: "app",
+        extension: "log",
+        chunk: "single",
+        maxMessagesToWrite: 100,
+        filter: () => true,
+        maxFileSize: 10 * 1024 * 1024,
+        get rotateFileName() {
+            return dayjs().format("DD-MM-YYYY");
+        },
+        dateFormat: {
+            date: "DD-MM-YYYY",
+            time: "HH:mm:ss",
+        },
+    };
+    /**
+     * Last write time
+     */
+    lastWriteTime = Date.now();
+    /**
+     * A flag to determine if the file is being written
+     */
+    isWriting = false;
+    /**
+     * Check file size for file rotation
+     */
+    async checkAndRotateFile(filePath = this.filePath) {
+        if (!this.config("rotate"))
+            return;
+        try {
+            const stats = await fs.promises.stat(filePath);
+            if (stats.size >= this.config("maxFileSize")) {
+                await this.rotateLogFile();
+            }
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                // File doesn't exist, this can be normal if it's a new file
+                console.log("Log file does not exist, will be created on first write.");
+            }
+            else {
+                console.error("Error checking log file:", error);
+            }
+        }
+    }
+    /**
+     * Rotate log file
+     */
+    async rotateLogFile() {
+        const fileName = `${this.fileName}-${this.config("rotateFileName")}-${Date.now()}`;
+        const extension = this.extension;
+        const rotatedFilePath = path.join(this.storagePath, `${fileName}.${extension}`);
+        await fs.promises.rename(this.filePath, rotatedFilePath).catch((error) => {
+            console.error("Error rotating file:", error);
+        });
+    }
+    /**
+     * Flush messages
+     */
+    initMessageFlush() {
+        setInterval(() => {
+            if (this.messages.length > 0 &&
+                (this.messages.length >= this.maxMessagesToWrite || Date.now() - this.lastWriteTime > 5000)) {
+                this.writeMessagesToFile();
+            }
+        }, 5000); // Periodic check
+    }
+    /**
+     * Get file path
+     */
+    get filePath() {
+        const fileName = this.fileName;
+        const extension = this.extension;
+        return path.join(this.storagePath, `${fileName}.${extension}`);
+    }
+    /**
+     * Get max messages
+     */
+    get maxMessagesToWrite() {
+        return this.config("maxMessagesToWrite");
+    }
+    /**
+     * Get file name
+     */
+    get fileName() {
+        const debugLevel = this.config("chunk");
+        switch (debugLevel) {
+            case "single":
+            default:
+                return this.config("name");
+            case "daily":
+                return dayjs().format("DD-MM-YYYY");
+            case "hourly":
+                return dayjs().format("DD-MM-YYYY-HH-00-00-a");
+        }
+    }
+    /**
+     * Get file extension
+     */
+    get extension() {
+        return this.config("extension");
+    }
+    /**
+     * Get content
+     */
+    get content() {
+        return this.messages.map((message) => message.content).join(EOL) + EOL;
+    }
+    /**
+     * Get storage path
+     */
+    get storagePath() {
+        return this.config("storagePath");
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async init() {
+        const logsDirectory = this.storagePath;
+        await ensureDirectoryAsync(logsDirectory);
+        this.initMessageFlush();
+    }
+    /**
+     * Synchronously flush messages
+     */
+    flushSync() {
+        if (this.messages.length === 0 && Object.keys(this.groupedMessages).length === 0)
+            return;
+        if (this.messagedShouldBeGrouped) {
+            this.prepareGroupedMessages();
+            for (const key in this.groupedMessages) {
+                const directoryPath = path.join(this.storagePath, key);
+                fs.mkdirSync(directoryPath, { recursive: true });
+                const filePath = path.join(directoryPath, `${this.fileName}.${this.extension}`);
+                const content = this.groupedMessages[key].map((message) => message.content).join(EOL) + EOL;
+                fs.appendFileSync(filePath, content);
+            }
+        }
+        else {
+            fs.mkdirSync(this.storagePath, { recursive: true });
+            fs.appendFileSync(this.filePath, this.content);
+        }
+        this.onSave();
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async log(data) {
+        const { module, action, message, type: level, context } = data;
+        if (!this.shouldBeLogged(data))
+            return;
+        const { date: dateFormat, time } = this.getDateAndTimeFormat();
+        const date = dayjs().format(dateFormat + " " + time);
+        let content = `[${date}] [${level}] [${module}][${action}]: `;
+        let stack;
+        // check if message is an instance of Error
+        if (message instanceof Error) {
+            // in that case we need to store the error message and stack trace
+            content += message.message + EOL;
+            content += `[trace]` + EOL;
+            content += message.stack;
+            stack = message.stack;
+        }
+        else {
+            content += message;
+        }
+        this.messages.push({
+            content,
+            level,
+            date,
+            module,
+            action,
+            stack,
+            context,
+            timestamp: new Date().toISOString(),
+        });
+        await this.checkIfMessagesShouldBeWritten(); // Immediate check on buffer size
+    }
+    /**
+     * Check if messages should be written
+     */
+    async checkIfMessagesShouldBeWritten() {
+        if (this.messages.length >= this.maxMessagesToWrite || Date.now() - this.lastWriteTime > 5000) {
+            await this.writeMessagesToFile();
+        }
+    }
+    /**
+     * Should be called after messages are saved
+     */
+    onSave() {
+        this.messages = [];
+        this.groupedMessages = {};
+        this.isWriting = false;
+        this.lastWriteTime = Date.now();
+    }
+    /**
+     * Check if messages should be grouped
+     */
+    get messagedShouldBeGrouped() {
+        return Number(this.config("groupBy")?.length) > 0;
+    }
+    /**
+     * Write messages to the file
+     */
+    async writeMessagesToFile() {
+        if (this.messages.length === 0 || this.isWriting || !this.isInitialized)
+            return;
+        this.isWriting = true;
+        if (this.messagedShouldBeGrouped) {
+            return await this.writeGroupedMessagesToFile();
+        }
+        await this.checkAndRotateFile(); // Ensure we check file size before writing
+        try {
+            await this.write(this.filePath, this.content);
+            this.onSave();
+        }
+        catch (error) {
+            console.error("Failed to write log:", error);
+            // Implement fallback logic here
+            this.isWriting = false;
+        }
+    }
+    /**
+     * Write grouped messages to the file
+     */
+    async writeGroupedMessagesToFile() {
+        // first step, is to group the messages
+        this.prepareGroupedMessages();
+        // now each key in the grouped messages, represents the directory path that should extend the storage path
+        for (const key in this.groupedMessages) {
+            const directoryPath = path.join(this.storagePath, key);
+            await ensureDirectoryAsync(directoryPath);
+            const filePath = path.join(directoryPath, `${this.fileName}.${this.extension}`);
+            await this.checkAndRotateFile(filePath); // Ensure we check file size before writing
+            const content = this.groupedMessages[key].map((message) => message.content).join(EOL) + EOL;
+            try {
+                await this.write(filePath, content);
+            }
+            catch (error) {
+                console.error("Failed to write log:", error);
+            }
+        }
+        this.onSave();
+        this.isWriting = false;
+    }
+    /**
+     * Prepare grouped messages
+     */
+    prepareGroupedMessages() {
+        this.messages.forEach((message) => {
+            const key = this.config("groupBy")
+                .map((groupKey) => encodeURIComponent(message[groupKey]))
+                .join("/");
+            this.groupedMessages[key] = this.groupedMessages[key] || [];
+            this.groupedMessages[key].push(message);
+        });
+    }
+    /**
+     * Start writing to the file
+     */
+    async write(filePath, content) {
+        return new Promise((resolve, reject) => {
+            const writer = fs.createWriteStream(filePath, { flags: "a" });
+            writer.write(content, (error) => {
+                writer.end();
+                if (error) {
+                    reject(error);
+                }
+                else {
+                    resolve(true);
+                }
+            });
+        });
+    }
+}export{FileLog};//# sourceMappingURL=file-log.js.map

package/esm/channels/file-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-log.js","sources":["../../src/channels/file-log.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/esm/channels/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./console-log";
+export * from "./file-log";
+export * from "./json-file-log";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/esm/channels/json-file-log.d.ts

@@ -0,0 +1,33 @@
+import type { LogContract, LoggingData } from "../types";
+import { FileLog } from "./file-log";
+export declare class JSONFileLog extends FileLog implements LogContract {
+    /**
+     * {@inheritdoc}
+     */
+    name: string;
+    /**
+     * Get file extension
+     */
+    get extension(): string;
+    /**
+     * Get initial file contents
+     */
+    protected get initialFileContents(): Record<string, any>;
+    /**
+     * Synchronously flush messages
+     */
+    flushSync(): void;
+    /**
+     * {@inheritdoc}
+     */
+    log(data: LoggingData): Promise<void>;
+    /**
+     * Write messages to the file
+     */
+    protected writeMessagesToFile(): Promise<void>;
+    /**
+     * Write grouped messages to the file
+     */
+    protected writeGroupedMessagesToFile(): Promise<void>;
+}
+//# sourceMappingURL=json-file-log.d.ts.map

package/esm/channels/json-file-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file-log.d.ts","sourceRoot":"","sources":["../../src/channels/json-file-log.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAc,WAAW,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,qBAAa,WAAY,SAAQ,OAAQ,YAAW,WAAW;IAC7D;;OAEG;IACI,IAAI,SAAc;IAEzB;;OAEG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,SAAS,KAAK,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAIvD;IAED;;OAEG;IACI,SAAS,IAAI,IAAI;IAwCxB;;OAEG;IACU,GAAG,CAAC,IAAI,EAAE,WAAW;IA8BlC;;OAEG;cACa,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCpD;;OAEG;cACa,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;CAuC5D"}