@nemigo/logger 1.5.0

package/dist/atoms.d.ts

@@ -0,0 +1,6 @@
+import type { Caller, Mode, PrintParams } from "./types.js";
+import type { Timestamp } from "@nemigo/helpers/types";
+export declare const formatTimestamp: (timestamp?: Timestamp) => string;
+export declare const flatCaller: (caller: Caller) => string;
+export declare const formatHeader: <M extends string = Mode>(caller: Caller, options: PrintParams<M>) => string;
+export declare const print: <M extends string = Mode>(caller: Caller, message: unknown, options?: PrintParams<M>) => void;

package/dist/atoms.js

@@ -0,0 +1,14 @@
+import { emojis } from "./emojis.js";
+import { formatDateTime } from "@nemigo/helpers/datetime/format";
+export const formatTimestamp = (timestamp = Date.now()) => formatDateTime(timestamp, "DD-DM-DY (TH:TM:TS)");
+export const flatCaller = (caller) => (typeof caller === "string" ? `[${caller}]` : `[${caller.module} (${caller.method})]`);
+export const formatHeader = (caller, options) => {
+    const { dated = formatTimestamp(), styler, emoji } = options;
+    const process = flatCaller(caller);
+    const colored = styler ? styler(process) : process;
+    return emoji ? `${dated} ${colored}: ${emojis[emoji]}` : `${dated} ${colored}:`;
+};
+export const print = (caller, message, options = {}) => {
+    const header = formatHeader(caller, options);
+    console.log(header, JSON.stringify(message === undefined ? "undefined" : message, null, 2));
+};

package/dist/chalk.d.ts

@@ -0,0 +1,15 @@
+import type { Caller, ILogger, ILoggerBalancePayload, ILoggerLoadPayload, ILoggerRedirectPayload, ILoggerThrowPayload, Mode, PrintParams } from "./types.js";
+export declare class ChalkLogger<M extends string = Mode> implements ILogger<M> {
+    print(caller: Caller, payload: unknown, options?: PrintParams<M>): void;
+    debug(caller: Caller, payload: unknown, mode?: PrintParams<M>["mode"]): void;
+    log(caller: Caller, payload: unknown, mode?: PrintParams<M>["mode"]): void;
+    info(caller: Caller, payload: unknown, mode?: PrintParams<M>["mode"]): void;
+    good(caller: Caller, payload: unknown, mode?: M | undefined): void;
+    warn(caller: Caller, payload: unknown, mode?: PrintParams<M>["mode"]): void;
+    error(caller: Caller, payload: unknown, mode?: PrintParams<M>["mode"]): void;
+    __throw(caller: Caller, payload: ILoggerThrowPayload): never;
+    throw(caller: Caller, payload: ILoggerThrowPayload, mode?: PrintParams<M>["mode"]): never;
+    balance(caller: Caller, { amount }: ILoggerBalancePayload, mode?: PrintParams<M>["mode"]): void;
+    load(caller: Caller, { pathname }: ILoggerLoadPayload, mode?: PrintParams<M>["mode"]): void;
+    redirect(caller: Caller, payload: ILoggerRedirectPayload, mode?: PrintParams<M>["mode"]): void;
+}

package/dist/chalk.js

@@ -0,0 +1,45 @@
+import { flatCaller, print } from "./atoms.js";
+import { formatRUB } from "@nemigo/helpers/rubles";
+import chalk from "chalk";
+export class ChalkLogger {
+    print(caller, payload, options) {
+        print(caller, payload, options);
+    }
+    debug(caller, payload, mode) {
+        this.print(caller, payload, { styler: chalk.gray, mode, emoji: "details" });
+    }
+    log(caller, payload, mode) {
+        this.print(caller, payload, { styler: chalk.blue, mode, emoji: "gear" });
+    }
+    info(caller, payload, mode) {
+        this.print(caller, payload, { styler: chalk.magenta, mode, emoji: "info" });
+    }
+    good(caller, payload, mode) {
+        this.print(caller, payload, { styler: chalk.green, mode, emoji: "good" });
+    }
+    warn(caller, payload, mode) {
+        this.print(caller, payload, { styler: chalk.yellow, mode, emoji: "warn" });
+    }
+    error(caller, payload, mode) {
+        this.print(caller, payload, { styler: chalk.red, mode, emoji: "error" });
+    }
+    __throw(caller, payload) {
+        throw new Error(`${flatCaller(caller)} - ${payload.cause ?? "ERROR"}`);
+    }
+    throw(caller, payload, mode) {
+        this.print(caller, payload, { styler: chalk.red, mode, emoji: "error" });
+        return this.__throw(caller, payload);
+    }
+    //...
+    balance(caller, { amount }, mode) {
+        const payload = formatRUB(amount);
+        this.print(caller, payload, { styler: chalk.yellow, emoji: "money", mode });
+    }
+    load(caller, { pathname }, mode) {
+        this.print(caller, pathname, { styler: chalk.blue, mode, emoji: "gear" });
+    }
+    redirect(caller, payload, mode) {
+        const __payload = `from "${payload.from}" to "${payload.to}" (${payload.code} - ${payload.reason})`;
+        this.print(caller, __payload, { styler: chalk.yellow, mode, emoji: "warn" });
+    }
+}

package/dist/emojis.d.ts

@@ -0,0 +1,13 @@
+import type { KEYS } from "@nemigo/helpers/types";
+export declare const emojis: {
+    readonly stats: "📊";
+    readonly money: "💰";
+    readonly details: "🔍";
+    readonly gear: "⚙️ ";
+    readonly bot: "🤖";
+    readonly info: "👀";
+    readonly warn: "⚠️ ";
+    readonly error: "🆘";
+    readonly good: "✅";
+};
+export type Emojis = KEYS<typeof emojis>;

package/dist/emojis.js

@@ -0,0 +1,11 @@
+export const emojis = {
+    stats: "📊",
+    money: "💰",
+    details: "🔍",
+    gear: "⚙️ ",
+    bot: "🤖",
+    info: "👀",
+    warn: "⚠️ ",
+    error: "🆘",
+    good: "✅",
+};

package/dist/types.d.ts

@@ -0,0 +1,105 @@
+import type { Emojis } from "./emojis.js";
+export type Mode = "console";
+/**
+ * Имя процесса (с возможным указанием отдельного метода), вызвавшего логирование
+ */
+export type Caller = string | {
+    module: string;
+    method: string;
+};
+/**
+ * Конфигурация вывода для {@link ILogger}
+ */
+export interface PrintParams<M extends string = Mode> {
+    /**
+     * Режим вывода (по умолчанию консольный, может быть расширен при наследовании)
+     */
+    mode?: M;
+    /**
+     * Форматирование заголовка процесса
+     */
+    styler?: (process: string) => string;
+    /**
+     * Для избежания повтора операции при изменении формата
+     */
+    dated?: string;
+    /**
+     * Акцентные эмодзи
+     */
+    emoji?: Emojis;
+}
+/**
+ * Сообщение для {@link ILogger.throw}
+ */
+export interface ILoggerThrowPayload {
+    cause?: string;
+    error?: unknown;
+    data?: unknown;
+}
+/**
+ * Сообщение для {@link ILogger.balance}
+ */
+export interface ILoggerBalancePayload {
+    amount: number;
+}
+/**
+ * Сообщение для {@link ILogger.load}
+ */
+export interface ILoggerLoadPayload {
+    pathname: string;
+}
+/**
+ * Сообщение для {@link ILogger.redirect}
+ */
+export interface ILoggerRedirectPayload {
+    from: string;
+    to: string;
+    reason: string;
+    code: number | string;
+}
+export interface ILogger<M extends string = Mode> {
+    /**
+     * Непосредственно функция вывода сообщений
+     */
+    print(caller: Caller, payload: unknown, options?: PrintParams<M>): void;
+    /**
+     * Лог глубокой отладки
+     */
+    debug(caller: Caller, payload: unknown, mode?: PrintParams<M>["mode"]): void;
+    /**
+     * Логи работы
+     */
+    log(caller: Caller, payload: unknown, mode?: PrintParams<M>["mode"]): void;
+    /**
+     * Информационное сообщение
+     */
+    info(caller: Caller, payload: unknown, mode?: PrintParams<M>["mode"]): void;
+    /**
+     * Лог об успешной операции
+     */
+    good(caller: Caller, payload: unknown, mode?: PrintParams<M>["mode"]): void;
+    /**
+     * Лог о предупреждении (что-то пошло не так)
+     */
+    warn(caller: Caller, payload: unknown, mode?: PrintParams<M>["mode"]): void;
+    /**
+     * Лог о фатальной ошибке
+     */
+    error(caller: Caller, payload: unknown, mode?: PrintParams<M>["mode"]): void;
+    /**
+     * Лог о фатальной ошибке с её выбросом
+     */
+    throw(caller: Caller, payload: ILoggerThrowPayload, mode?: PrintParams<M>["mode"]): never;
+    /**
+     * Лог о балансе аккаунтов сторонних интеграций
+     */
+    balance(caller: Caller, payload: ILoggerBalancePayload, mode?: PrintParams<M>["mode"]): void;
+    /**
+     * Лог об успешной отдачи страницы сервером клиенту
+     */
+    load(caller: Caller, payload: ILoggerLoadPayload, mode?: PrintParams<M>["mode"]): void;
+    /**
+     * Лог о перенаправлении с одного маршрута на другой
+     */
+    redirect(caller: Caller, payload: ILoggerRedirectPayload, mode?: PrintParams<M>["mode"]): void;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,51 @@
+{
+	"name": "@nemigo/logger",
+	"version": "1.5.0",
+	"private": false,
+	"author": {
+		"name": "Vlad Logvin",
+		"email": "vlad.logvin84@gmail.com"
+	},
+	"type": "module",
+	"engines": {
+		"node": ">=22",
+		"pnpm": ">=10.9.0"
+	},
+	"scripts": {
+		"build": "svelte-package && rimraf .svelte-kit",
+		"check": "tsc --noemit",
+		"lint": "eslint ./",
+		"format": "prettier --write ./"
+	},
+	"exports": {
+		"./atoms": {
+			"types": "./dist/atoms.d.ts",
+			"default": "./dist/atoms.js"
+		},
+		"./chalk": {
+			"types": "./dist/chalk.d.ts",
+			"default": "./dist/chalk.js"
+		},
+		"./emojis": {
+			"types": "./dist/emojis.d.ts",
+			"default": "./dist/emojis.js"
+		},
+		"./types": {
+			"types": "./dist/types.d.ts",
+			"default": "./dist/types.js"
+		}
+	},
+	"peerDependencies": {
+		"@nemigo/helpers": ">=1.5.3",
+		"chalk": "^5.6.0"
+	},
+	"peerDependenciesMeta": {
+		"chalk": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@nemigo/configs": "workspace:*",
+		"@nemigo/helpers": "workspace:*"
+	}
+}