@rsdk/logging 5.11.1-next.0 → 5.11.1-next.1

package/dist/decorators/log-serializer.decorator.js

@@ -4,7 +4,9 @@ exports.LogSerializer = void 0;
 require("reflect-metadata");
 const constants_1 = require("../metadata/constants");
 const logger_metadata_registry_1 = require("../metadata/logger-metadata.registry");
-const logSerializerDecorator = function (target) {
+const logSerializerDecorator = function (
+// eslint-disable-next-line @typescript-eslint/ban-types
+target) {
     const metadata = {
         target: target,
     };

package/dist/decorators/log-serializer.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"log-serializer.decorator.js","sourceRoot":"","sources":["../../src/decorators/log-serializer.decorator.ts"],"names":[],"mappings":";;;AAGA,4BAA0B;AAE1B,qDAA4D;AAC5D,mFAA8E;AAG9E,MAAM,sBAAsB,GAAmB,UAC7C,MAAgB;IAEhB,MAAM,QAAQ,GAA6B;QACzC,MAAM,EAAE,MAAqB;KAC9B,CAAC;IAEF,OAAO,CAAC,cAAc,CAAC,+BAAmB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9D,iDAAsB,CAAC,kBAAkB,CAAC,MAAqB,EAAE,QAAQ,CAAC,CAAC;AAC7E,CAAC,CAAC;AAEK,MAAM,aAAa,GAAG,GAAmB,EAAE,CAAC,sBAAsB,CAAC;AAA7D,QAAA,aAAa,iBAAgD"}
+{"version":3,"file":"log-serializer.decorator.js","sourceRoot":"","sources":["../../src/decorators/log-serializer.decorator.ts"],"names":[],"mappings":";;;AAEA,4BAA0B;AAE1B,qDAA4D;AAC5D,mFAA8E;AAG9E,MAAM,sBAAsB,GAAmB;AAC7C,wDAAwD;AACxD,MAAgB;IAEhB,MAAM,QAAQ,GAA6B;QACzC,MAAM,EAAE,MAAqB;KAC9B,CAAC;IAEF,OAAO,CAAC,cAAc,CAAC,+BAAmB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9D,iDAAsB,CAAC,kBAAkB,CAAC,MAAqB,EAAE,QAAQ,CAAC,CAAC;AAC7E,CAAC,CAAC;AAEK,MAAM,aAAa,GAAG,GAAmB,EAAE,CAAC,sBAAsB,CAAC;AAA7D,QAAA,aAAa,iBAAgD"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { DEFAULT_LEVEL } from './defaults';
 export { PinoLogger } from './implementations/pino-logger.class';
-export { LogLevel, Params, LoggerOptions, LoggingContext, OnMessage, LoggerSerealizerMetadata, } from './types';
+export { LogLevel, Params, LoggerOptions, LoggingContext, OnMessage, LoggerSerializerMetadata, LogTimestampFormat, } from './types';
 export { ILogger, ILogSerializer, LogSerializerBase } from './logger.interface';
 export { stringifyContext } from './helpers';
 export { LoggerFactory } from './logger.factory';

package/dist/index.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogSerializer = exports.LoggerFactory = exports.stringifyContext = exports.LogLevel = exports.PinoLogger = exports.DEFAULT_LEVEL = void 0;
+exports.LogSerializer = exports.LoggerFactory = exports.stringifyContext = exports.LogTimestampFormat = exports.LogLevel = exports.PinoLogger = exports.DEFAULT_LEVEL = void 0;
 var defaults_1 = require("./defaults");
 Object.defineProperty(exports, "DEFAULT_LEVEL", { enumerable: true, get: function () { return defaults_1.DEFAULT_LEVEL; } });
 var pino_logger_class_1 = require("./implementations/pino-logger.class");
 Object.defineProperty(exports, "PinoLogger", { enumerable: true, get: function () { return pino_logger_class_1.PinoLogger; } });
 var types_1 = require("./types");
 Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return types_1.LogLevel; } });
+Object.defineProperty(exports, "LogTimestampFormat", { enumerable: true, get: function () { return types_1.LogTimestampFormat; } });
 var helpers_1 = require("./helpers");
 Object.defineProperty(exports, "stringifyContext", { enumerable: true, get: function () { return helpers_1.stringifyContext; } });
 var logger_factory_1 = require("./logger.factory");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAA2C;AAAlC,yGAAA,aAAa,OAAA;AAEtB,yEAAiE;AAAxD,+GAAA,UAAU,OAAA;AACnB,iCAOiB;AANf,iGAAA,QAAQ,OAAA;AAQV,qCAA6C;AAApC,2GAAA,gBAAgB,OAAA;AACzB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,kFAAsE;AAA7D,yHAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAA2C;AAAlC,yGAAA,aAAa,OAAA;AAEtB,yEAAiE;AAAxD,+GAAA,UAAU,OAAA;AACnB,iCAQiB;AAPf,iGAAA,QAAQ,OAAA;AAMR,2GAAA,kBAAkB,OAAA;AAGpB,qCAA6C;AAApC,2GAAA,gBAAgB,OAAA;AACzB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,kFAAsE;AAA7D,yHAAA,aAAa,OAAA"}

package/dist/logger.factory.d.ts

@@ -6,6 +6,8 @@ import type { LoggerOptions, LoggingContext, OnMessage } from './types';
  */
 export declare class LoggerFactory {
     private static readonly events;
+    private static opts;
+    private static pinoTimestampFormatMap;
     /**
      * Under the hood every logger instance will use this
      * static instance. Motivation for this is that it's much
@@ -17,7 +19,10 @@ export declare class LoggerFactory {
      */
     private static _globalPino;
     private static _serializers;
-    private static readonly opts;
+    /** Ссылка на активный worker-транспорт для закрытия его воркеров. */
+    private static _activeTransport;
+    /** Конфиг, по которому собран _activeTransport (для переиспользования воркера). */
+    private static _activeTransportConfig;
     /**
      * Переконфигурация pino нужна потому, что изначально логгер инициализируется
      * с дефолтными настройками, т. к. конфигурация ещё не прочитана.
@@ -42,6 +47,11 @@ export declare class LoggerFactory {
      * при помощи cli - можно немного упростить архитектуру
      */
     static applyInstrumentations<T extends Record<string, any>>(logHookFunction?: (record: T) => void): void;
+    /**
+     * Сливает буфер worker-транспорта и завершает его воркеры. Без вызова на
+     * остановке приложения забуференные логи теряются, а воркеры висят.
+     */
+    static shutdown(timeoutMs?: number): Promise<void>;
     static onMessage(handler: OnMessage): void;
     static create(context: LoggingContext): ILogger;
     static getSerializers(): LogSerializerBase[];
@@ -64,4 +74,31 @@ export declare class LoggerFactory {
      */
     static hasSerializer(name: string): boolean;
     private static applyOptions;
+    /**
+     * `stream`/`transport` исключаем из опций: способ доставки задаётся вторым
+     * аргументом `pino()`, а pino запрещает одновременно `transport` в опциях и
+     * stream-аргумент.
+     */
+    private static buildPinoOptions;
+    /**
+     * Создаёт инстанс pino. Воркер транспорта переиспользуется, если объект
+     * конфига транспорта тот же по ссылке (сравнение identity, не по значению).
+     * Это покрывает связку reconfigure→applyInstrumentations (между ними
+     * this.opts.transport не пересобирается) и не даёт пересоздавать и тут же
+     * закрывать только что поднятый, возможно медленный, OTEL-воркер. Новый
+     * объект конфига (например, при config.onUpdate) ожидаемо пересоздаёт воркер.
+     */
+    private static instantiatePino;
+    /**
+     * Поднимает worker-транспорт, закрыв предыдущий. Обработчик 'error' не даёт
+     * асинхронной ошибке воркера уронить процесс, но делает её видимой в stderr
+     * (сам логгер использовать нельзя — упал его транспорт). Ошибку резолва
+     * таргета pino.transport(...) бросает синхронно — она долетает до старта.
+     */
+    private static createTransport;
+    /**
+     * Завершает воркеры предыдущего транспорта (best-effort, не блокируя). stdout
+     * не затрагивается: для него хэндл не сохраняется.
+     */
+    private static disposeActiveTransport;
 }

package/dist/logger.factory.js

@@ -5,10 +5,13 @@ const node_events_1 = require("node:events");
 const logger_metadata_registry_1 = require("./metadata/logger-metadata.registry");
 const defaults_1 = require("./defaults");
 const implementations_1 = require("./implementations");
+const types_1 = require("./types");
+const DEFAULT_SHUTDOWN_TIMEOUT_MS = 1000;
 /**
  * ATTENTION: require('pino') тут не просто так, в общем они нужны для корректной работы хуков из `@opentelemetry/instrumentation-pino`
  */
 const requirePino = () => {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
     return require('pino');
 };
 /**
@@ -18,6 +21,18 @@ const requirePino = () => {
 class LoggerFactory {
     // eslint-disable-next-line unicorn/prefer-event-target
     static events = new node_events_1.EventEmitter();
+    static opts = {
+        level: defaults_1.DEFAULT_LEVEL,
+        redact: [],
+        stream: requirePino().destination(),
+        timestampFormat: types_1.LogTimestampFormat.isoTime,
+    };
+    static pinoTimestampFormatMap = {
+        [types_1.LogTimestampFormat.epochTime]: requirePino().stdTimeFunctions.epochTime,
+        [types_1.LogTimestampFormat.unixTime]: requirePino().stdTimeFunctions.unixTime,
+        [types_1.LogTimestampFormat.nullTime]: requirePino().stdTimeFunctions.nullTime,
+        [types_1.LogTimestampFormat.isoTime]: requirePino().stdTimeFunctions.isoTime,
+    };
     /**
      * Under the hood every logger instance will use this
      * static instance. Motivation for this is that it's much
@@ -27,16 +42,16 @@ class LoggerFactory {
      * Downside is that the idea is not composable with child
      * loggers (which are no used anywhere yet)
      */
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
     static _globalPino = requirePino()({
         level: defaults_1.DEFAULT_LEVEL,
+        timestamp: this.pinoTimestampFormatMap[this.opts.timestampFormat],
     });
     static _serializers = null;
-    static opts = {
-        level: defaults_1.DEFAULT_LEVEL,
-        redact: [],
-        stream: requirePino().destination(),
-    };
+    /** Ссылка на активный worker-транспорт для закрытия его воркеров. */
+    static _activeTransport = null;
+    /** Конфиг, по которому собран _activeTransport (для переиспользования воркера). */
+    static _activeTransportConfig = null;
     /**
      * Переконфигурация pino нужна потому, что изначально логгер инициализируется
      * с дефолтными настройками, т. к. конфигурация ещё не прочитана.
@@ -46,8 +61,7 @@ class LoggerFactory {
      */
     static reconfigure(opts) {
         this.applyOptions(opts);
-        const { stream, ...other } = this.opts;
-        this._globalPino = requirePino()(other, stream);
+        this._globalPino = this.instantiatePino();
     }
     /**
      * Этот метод должен быть вызван после того, как подключен instrumentation-pino.
@@ -65,10 +79,7 @@ class LoggerFactory {
      * при помощи cli - можно немного упростить архитектуру
      */
     static applyInstrumentations(logHookFunction) {
-        const { stream, ...other } = this.opts;
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        this._globalPino = requirePino()({
-            ...other,
+        this._globalPino = this.instantiatePino({
             /**
              * Функция которая позволяет добавить дополнительные данные в логи Pino
              */
@@ -78,21 +89,47 @@ class LoggerFactory {
                      * Реализация взята с официальной документации
                      * https://getpino.io/#/docs/api?id=logmethod
                      */
-                    logMethod: function (inputArgs, 
                     // eslint-disable-next-line @typescript-eslint/ban-types
-                    method) {
-                        if (inputArgs.length >= 2) {
-                            const arg1 = inputArgs.shift() || {};
-                            const arg2 = inputArgs.shift();
+                    logMethod: function (inputArgs, method) {
+                        const arg1 = inputArgs[0];
+                        if (arg1 && typeof arg1 === 'object') {
                             logHookFunction(arg1);
-                            // eslint-disable-next-line unicorn/prefer-reflect-apply
-                            return method.apply(this, [arg1, arg2, ...inputArgs]);
                         }
+                        // eslint-disable-next-line unicorn/prefer-reflect-apply
                         return method.apply(this, inputArgs);
                     },
                 }
                 : {},
-        }, stream);
+        });
+    }
+    /**
+     * Сливает буфер worker-транспорта и завершает его воркеры. Без вызова на
+     * остановке приложения забуференные логи теряются, а воркеры висят.
+     */
+    static async shutdown(timeoutMs = DEFAULT_SHUTDOWN_TIMEOUT_MS) {
+        const stream = this._activeTransport;
+        if (!stream)
+            return;
+        this._activeTransport = null;
+        this._activeTransportConfig = null;
+        await new Promise((resolve) => {
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                resolve();
+            };
+            try {
+                stream.on('close', finish);
+                stream.flush(() => stream.end());
+            }
+            catch {
+                finish();
+            }
+            const timer = setTimeout(finish, timeoutMs);
+            timer.unref?.();
+        });
     }
     static onMessage(handler) {
         this.events.on('msg', handler);
@@ -145,8 +182,105 @@ class LoggerFactory {
         return this._serializers.has(name);
     }
     static applyOptions(opts) {
-        const { redact, level, stream = requirePino().destination() } = opts || {};
-        Object.assign(this.opts, { redact, level: level ?? defaults_1.DEFAULT_LEVEL, stream });
+        const { redact, level, stream, transport, timestampFormat } = opts || {};
+        const base = {
+            redact: redact ?? this.opts.redact ?? [],
+            level: level ?? defaults_1.DEFAULT_LEVEL,
+            timestampFormat: timestampFormat ?? types_1.LogTimestampFormat.isoTime,
+        };
+        /**
+         * Выбираем ровно один способ доставки. Если ни stream, ни transport не
+         * переданы — сохраняем текущий, чтобы частичный reconfigure({ level }) не
+         * сбрасывал ранее заданный transport.
+         */
+        if (transport) {
+            this.opts = { ...base, transport };
+        }
+        else if (stream) {
+            this.opts = { ...base, stream };
+        }
+        else if (this.opts.transport) {
+            this.opts = { ...base, transport: this.opts.transport };
+        }
+        else {
+            this.opts = {
+                ...base,
+                stream: this.opts.stream ?? requirePino().destination(),
+            };
+        }
+    }
+    /**
+     * `stream`/`transport` исключаем из опций: способ доставки задаётся вторым
+     * аргументом `pino()`, а pino запрещает одновременно `transport` в опциях и
+     * stream-аргумент.
+     */
+    static buildPinoOptions(extra = {}) {
+        const { timestampFormat, stream: _stream, transport: _transport, ...other } = this.opts;
+        return {
+            ...other,
+            timestamp: this.pinoTimestampFormatMap[timestampFormat],
+            ...extra,
+        };
+    }
+    /**
+     * Создаёт инстанс pino. Воркер транспорта переиспользуется, если объект
+     * конфига транспорта тот же по ссылке (сравнение identity, не по значению).
+     * Это покрывает связку reconfigure→applyInstrumentations (между ними
+     * this.opts.transport не пересобирается) и не даёт пересоздавать и тут же
+     * закрывать только что поднятый, возможно медленный, OTEL-воркер. Новый
+     * объект конфига (например, при config.onUpdate) ожидаемо пересоздаёт воркер.
+     */
+    static instantiatePino(extra = {}) {
+        const pino = requirePino();
+        const options = this.buildPinoOptions(extra);
+        if (!this.opts.transport) {
+            this.disposeActiveTransport();
+            return pino(options, this.opts.stream);
+        }
+        const reuse = this._activeTransport &&
+            this.opts.transport === this._activeTransportConfig;
+        const stream = reuse
+            ? this._activeTransport
+            : this.createTransport(this.opts.transport);
+        return pino(options, stream);
+    }
+    /**
+     * Поднимает worker-транспорт, закрыв предыдущий. Обработчик 'error' не даёт
+     * асинхронной ошибке воркера уронить процесс, но делает её видимой в stderr
+     * (сам логгер использовать нельзя — упал его транспорт). Ошибку резолва
+     * таргета pino.transport(...) бросает синхронно — она долетает до старта.
+     */
+    static createTransport(transport) {
+        this.disposeActiveTransport();
+        const stream = requirePino().transport(transport);
+        stream.on('error', (...args) => {
+            const error = args[0];
+            const message = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`[@rsdk/logging] transport error: ${message}\n`);
+        });
+        this._activeTransport = stream;
+        this._activeTransportConfig = transport;
+        return stream;
+    }
+    /**
+     * Завершает воркеры предыдущего транспорта (best-effort, не блокируя). stdout
+     * не затрагивается: для него хэндл не сохраняется.
+     */
+    static disposeActiveTransport() {
+        const previous = this._activeTransport;
+        if (!previous)
+            return;
+        this._activeTransport = null;
+        this._activeTransportConfig = null;
+        // на teardown ошибки ожидаемы (например, "end() took too long" у медленных
+        // транспортов) — глушим их молча и не держим event loop
+        previous.unref?.();
+        previous.removeAllListeners?.('error');
+        previous.on('error', () => { });
+        try {
+            previous.end();
+        }
+        catch { }
     }
 }
 exports.LoggerFactory = LoggerFactory;

package/dist/logger.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.factory.js","sourceRoot":"","sources":["../src/logger.factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logger.factory.js","sourceRoot":"","sources":["../src/logger.factory.ts"],"names":[],"mappings":"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"}

package/dist/metadata/logger-metadata.registry.d.ts

@@ -1,7 +1,7 @@
 import type { Constructor } from '@rsdk/common';
-import type { LoggerSerealizerMetadata } from '../types';
+import type { LoggerSerializerMetadata } from '../types';
 export declare class LoggerMetadataRegistry {
     private static readonly serializers;
-    static registerSerializer(target: Constructor, metadata: LoggerSerealizerMetadata): void;
-    static getSerializers(): LoggerSerealizerMetadata[];
+    static registerSerializer(target: Constructor, metadata: LoggerSerializerMetadata): void;
+    static getSerializers(): LoggerSerializerMetadata[];
 }

package/dist/types.d.ts

@@ -1,5 +1,6 @@
 import type { Constructor } from '@rsdk/common';
 import type pino from 'pino';
+import type { TransportMultiOptions } from 'pino';
 export declare enum LogLevel {
     fatal = "fatal",
     error = "error",
@@ -8,14 +9,33 @@ export declare enum LogLevel {
     debug = "debug",
     trace = "trace"
 }
+export declare enum LogTimestampFormat {
+    epochTime = "epochTime",
+    unixTime = "unixTime",
+    nullTime = "nullTime",
+    isoTime = "isoTime"
+}
+export type TimeFn = () => string;
 export type Params = Record<string, unknown>;
-export interface LoggerOptions {
+export interface LoggerOptionsBase {
     level: LogLevel;
     redact: string[];
-    stream: pino.DestinationStream;
+    timestampFormat: LogTimestampFormat;
 }
+/**
+ * `stream` и `transport` — взаимоисключающие способы доставки (pino не
+ * принимает оба сразу). Это закодировано в типе: задание одного запрещает
+ * другой.
+ */
+export type LoggerOptions = LoggerOptionsBase & ({
+    stream?: pino.DestinationStream;
+    transport?: never;
+} | {
+    stream?: never;
+    transport?: TransportMultiOptions;
+});
 export type LoggingContext = string | Constructor;
 export type OnMessage = (level: LogLevel, data: Record<string, unknown>) => void;
-export interface LoggerSerealizerMetadata {
+export interface LoggerSerializerMetadata {
     target: Constructor;
 }

package/dist/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogLevel = void 0;
+exports.LogTimestampFormat = exports.LogLevel = void 0;
 var LogLevel;
 (function (LogLevel) {
     LogLevel["fatal"] = "fatal";
@@ -10,4 +10,11 @@ var LogLevel;
     LogLevel["debug"] = "debug";
     LogLevel["trace"] = "trace";
 })(LogLevel || (exports.LogLevel = LogLevel = {}));
+var LogTimestampFormat;
+(function (LogTimestampFormat) {
+    LogTimestampFormat["epochTime"] = "epochTime";
+    LogTimestampFormat["unixTime"] = "unixTime";
+    LogTimestampFormat["nullTime"] = "nullTime";
+    LogTimestampFormat["isoTime"] = "isoTime";
+})(LogTimestampFormat || (exports.LogTimestampFormat = LogTimestampFormat = {}));
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAGA,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;IACf,2BAAe,CAAA;AACjB,CAAC,EAPW,QAAQ,wBAAR,QAAQ,QAOnB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAIA,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;IACf,2BAAe,CAAA;AACjB,CAAC,EAPW,QAAQ,wBAAR,QAAQ,QAOnB;AAED,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,6CAAuB,CAAA;IACvB,2CAAqB,CAAA;IACrB,2CAAqB,CAAA;IACrB,yCAAmB,CAAA;AACrB,CAAC,EALW,kBAAkB,kCAAlB,kBAAkB,QAK7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsdk/logging",
-  "version": "5.11.1-next.0",
+  "version": "5.11.1-next.1",
   "description": "Base framework independent logging functionality",
   "license": "Apache License 2.0",
   "publishConfig": {
@@ -18,5 +18,5 @@
     "reflect-metadata": "^0.1.12 || ^0.2.0",
     "rxjs": "^7.1.0"
   },
-  "gitHead": "04f2adf58ff5c2ff362192903235bb0112f7331f"
+  "gitHead": "b562f667d53198750aab0a70649b9ab17c0419c1"
 }

package/src/decorators/log-serializer.decorator.ts

@@ -1,16 +1,16 @@
-/* eslint-disable @typescript-eslint/ban-types */
 import type { Constructor } from '@rsdk/common';
 
 import 'reflect-metadata';
 
 import { LOGGER_METADATA_KEY } from '../metadata/constants';
 import { LoggerMetadataRegistry } from '../metadata/logger-metadata.registry';
-import type { LoggerSerealizerMetadata } from '../types';
+import type { LoggerSerializerMetadata } from '../types';
 
 const logSerializerDecorator: ClassDecorator = function (
+  // eslint-disable-next-line @typescript-eslint/ban-types
   target: Function,
 ): void {
-  const metadata: LoggerSerealizerMetadata = {
+  const metadata: LoggerSerializerMetadata = {
     target: target as Constructor,
   };
 

package/src/index.ts

@@ -7,7 +7,8 @@ export {
   LoggerOptions,
   LoggingContext,
   OnMessage,
-  LoggerSerealizerMetadata,
+  LoggerSerializerMetadata,
+  LogTimestampFormat,
 } from './types';
 export { ILogger, ILogSerializer, LogSerializerBase } from './logger.interface';
 export { stringifyContext } from './helpers';

package/src/logger.factory.ts

@@ -1,6 +1,11 @@
 import { EventEmitter } from 'node:events';
 import type _pino from 'pino';
-import type { Logger as Pino } from 'pino';
+import type {
+  DestinationStream,
+  Logger as Pino,
+  LoggerOptions as LoggerOptsPino,
+  TransportMultiOptions,
+} from 'pino';
 
 import { LoggerMetadataRegistry } from './metadata/logger-metadata.registry';
 import { DEFAULT_LEVEL } from './defaults';
@@ -8,16 +13,32 @@ import { PinoLogger } from './implementations';
 import type { ILogger, LogSerializerBase } from './logger.interface';
 import type {
   LoggerOptions,
-  LoggerSerealizerMetadata,
+  LoggerOptionsBase,
+  LoggerSerializerMetadata,
   LoggingContext,
   LogLevel,
   OnMessage,
+  TimeFn,
 } from './types';
+import { LogTimestampFormat } from './types';
+
+/** Хэндл worker-транспорта pino (thread-stream) для teardown воркеров. */
+interface TransportStream extends DestinationStream {
+  end(): void;
+  flush(cb?: (err?: Error) => void): void;
+  flushSync(): void;
+  unref(): void;
+  on(event: string, listener: (...args: unknown[]) => void): void;
+  removeAllListeners(event?: string): void;
+}
+
+const DEFAULT_SHUTDOWN_TIMEOUT_MS = 1000;
 
 /**
  * ATTENTION: require('pino') тут не просто так, в общем они нужны для корректной работы хуков из `@opentelemetry/instrumentation-pino`
  */
 const requirePino = (): typeof _pino => {
+  // eslint-disable-next-line @typescript-eslint/no-require-imports
   return require('pino');
 };
 
@@ -29,6 +50,20 @@ export class LoggerFactory {
   // eslint-disable-next-line unicorn/prefer-event-target
   private static readonly events = new EventEmitter();
 
+  private static opts: LoggerOptions = {
+    level: DEFAULT_LEVEL,
+    redact: [],
+    stream: requirePino().destination(),
+    timestampFormat: LogTimestampFormat.isoTime,
+  };
+
+  private static pinoTimestampFormatMap: Record<LogTimestampFormat, TimeFn> = {
+    [LogTimestampFormat.epochTime]: requirePino().stdTimeFunctions.epochTime,
+    [LogTimestampFormat.unixTime]: requirePino().stdTimeFunctions.unixTime,
+    [LogTimestampFormat.nullTime]: requirePino().stdTimeFunctions.nullTime,
+    [LogTimestampFormat.isoTime]: requirePino().stdTimeFunctions.isoTime,
+  };
+
   /**
    * Under the hood every logger instance will use this
    * static instance. Motivation for this is that it's much
@@ -38,18 +73,19 @@ export class LoggerFactory {
    * Downside is that the idea is not composable with child
    * loggers (which are no used anywhere yet)
    */
-  // eslint-disable-next-line @typescript-eslint/no-var-requires
+  // eslint-disable-next-line @typescript-eslint/no-require-imports
   private static _globalPino: Pino = requirePino()({
     level: DEFAULT_LEVEL,
+    timestamp: this.pinoTimestampFormatMap[this.opts.timestampFormat],
   });
 
   private static _serializers: Map<string, LogSerializerBase> | null = null;
 
-  private static readonly opts: LoggerOptions = {
-    level: DEFAULT_LEVEL,
-    redact: [],
-    stream: requirePino().destination(),
-  };
+  /** Ссылка на активный worker-транспорт для закрытия его воркеров. */
+  private static _activeTransport: TransportStream | null = null;
+
+  /** Конфиг, по которому собран _activeTransport (для переиспользования воркера). */
+  private static _activeTransportConfig: TransportMultiOptions | null = null;
 
   /**
    * Переконфигурация pino нужна потому, что изначально логгер инициализируется
@@ -61,9 +97,7 @@ export class LoggerFactory {
   static reconfigure(opts: Partial<LoggerOptions>): void {
     this.applyOptions(opts);
 
-    const { stream, ...other } = this.opts;
-
-    this._globalPino = requirePino()(other, stream);
+    this._globalPino = this.instantiatePino();
   }
 
   /**
@@ -84,43 +118,64 @@ export class LoggerFactory {
   static applyInstrumentations<T extends Record<string, any>>(
     logHookFunction?: (record: T) => void,
   ): void {
-    const { stream, ...other } = this.opts;
-
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
-    this._globalPino = requirePino()(
-      {
-        ...other,
-
-        /**
-         * Функция которая позволяет добавить дополнительные данные в логи Pino
-         */
-        hooks: logHookFunction
-          ? {
-              /**
-               * Реализация взята с официальной документации
-               * https://getpino.io/#/docs/api?id=logmethod
-               */
-              logMethod: function (
-                inputArgs: any[],
-                // eslint-disable-next-line @typescript-eslint/ban-types
-                method: Function,
-              ): unknown {
-                if (inputArgs.length >= 2) {
-                  const arg1: T = inputArgs.shift() || {};
-                  const arg2 = inputArgs.shift();
-
-                  logHookFunction(arg1);
-
-                  // eslint-disable-next-line unicorn/prefer-reflect-apply
-                  return method.apply(this, [arg1, arg2, ...inputArgs]);
-                }
-                return method.apply(this, inputArgs);
-              },
-            }
-          : {},
-      },
-      stream,
-    );
+    this._globalPino = this.instantiatePino({
+      /**
+       * Функция которая позволяет добавить дополнительные данные в логи Pino
+       */
+      hooks: logHookFunction
+        ? {
+            /**
+             * Реализация взята с официальной документации
+             * https://getpino.io/#/docs/api?id=logmethod
+             */
+            // eslint-disable-next-line @typescript-eslint/ban-types
+            logMethod: function (inputArgs: any[], method: Function): unknown {
+              const arg1 = inputArgs[0];
+              if (arg1 && typeof arg1 === 'object') {
+                logHookFunction(arg1 as T);
+              }
+              // eslint-disable-next-line unicorn/prefer-reflect-apply
+              return method.apply(this, inputArgs);
+            },
+          }
+        : {},
+    });
+  }
+
+  /**
+   * Сливает буфер worker-транспорта и завершает его воркеры. Без вызова на
+   * остановке приложения забуференные логи теряются, а воркеры висят.
+   */
+  static async shutdown(
+    timeoutMs: number = DEFAULT_SHUTDOWN_TIMEOUT_MS,
+  ): Promise<void> {
+    const stream = this._activeTransport;
+
+    if (!stream) return;
+
+    this._activeTransport = null;
+    this._activeTransportConfig = null;
+
+    await new Promise<void>((resolve) => {
+      let settled = false;
+
+      const finish = (): void => {
+        if (settled) return;
+        settled = true;
+        resolve();
+      };
+
+      try {
+        stream.on('close', finish);
+        stream.flush(() => stream.end());
+      } catch {
+        finish();
+      }
+
+      const timer = setTimeout(finish, timeoutMs);
+
+      timer.unref?.();
+    });
   }
 
   static onMessage(handler: OnMessage): void {
@@ -139,7 +194,7 @@ export class LoggerFactory {
   static getSerializers(): LogSerializerBase[] {
     if (this._serializers) return Array.from(this._serializers.values());
 
-    const metas: LoggerSerealizerMetadata[] =
+    const metas: LoggerSerializerMetadata[] =
       LoggerMetadataRegistry.getSerializers();
 
     this._serializers = new Map<string, LogSerializerBase>();
@@ -189,8 +244,130 @@ export class LoggerFactory {
   }
 
   private static applyOptions(opts: Partial<LoggerOptions>): void {
-    const { redact, level, stream = requirePino().destination() } = opts || {};
+    const { redact, level, stream, transport, timestampFormat } = opts || {};
+
+    const base: LoggerOptionsBase = {
+      redact: redact ?? this.opts.redact ?? [],
+      level: level ?? DEFAULT_LEVEL,
+      timestampFormat: timestampFormat ?? LogTimestampFormat.isoTime,
+    };
+
+    /**
+     * Выбираем ровно один способ доставки. Если ни stream, ни transport не
+     * переданы — сохраняем текущий, чтобы частичный reconfigure({ level }) не
+     * сбрасывал ранее заданный transport.
+     */
+    if (transport) {
+      this.opts = { ...base, transport };
+    } else if (stream) {
+      this.opts = { ...base, stream };
+    } else if (this.opts.transport) {
+      this.opts = { ...base, transport: this.opts.transport };
+    } else {
+      this.opts = {
+        ...base,
+        stream: this.opts.stream ?? requirePino().destination(),
+      };
+    }
+  }
+
+  /**
+   * `stream`/`transport` исключаем из опций: способ доставки задаётся вторым
+   * аргументом `pino()`, а pino запрещает одновременно `transport` в опциях и
+   * stream-аргумент.
+   */
+  private static buildPinoOptions(
+    extra: Partial<LoggerOptsPino> = {},
+  ): LoggerOptsPino {
+    const {
+      timestampFormat,
+      stream: _stream,
+      transport: _transport,
+      ...other
+    } = this.opts;
+
+    return {
+      ...other,
+      timestamp: this.pinoTimestampFormatMap[timestampFormat],
+      ...extra,
+    };
+  }
+
+  /**
+   * Создаёт инстанс pino. Воркер транспорта переиспользуется, если объект
+   * конфига транспорта тот же по ссылке (сравнение identity, не по значению).
+   * Это покрывает связку reconfigure→applyInstrumentations (между ними
+   * this.opts.transport не пересобирается) и не даёт пересоздавать и тут же
+   * закрывать только что поднятый, возможно медленный, OTEL-воркер. Новый
+   * объект конфига (например, при config.onUpdate) ожидаемо пересоздаёт воркер.
+   */
+  private static instantiatePino(extra: Partial<LoggerOptsPino> = {}): Pino {
+    const pino = requirePino();
+    const options = this.buildPinoOptions(extra);
+
+    if (!this.opts.transport) {
+      this.disposeActiveTransport();
+
+      return pino(options, this.opts.stream);
+    }
+
+    const reuse =
+      this._activeTransport &&
+      this.opts.transport === this._activeTransportConfig;
+
+    const stream = reuse
+      ? this._activeTransport!
+      : this.createTransport(this.opts.transport);
+
+    return pino(options, stream);
+  }
+
+  /**
+   * Поднимает worker-транспорт, закрыв предыдущий. Обработчик 'error' не даёт
+   * асинхронной ошибке воркера уронить процесс, но делает её видимой в stderr
+   * (сам логгер использовать нельзя — упал его транспорт). Ошибку резолва
+   * таргета pino.transport(...) бросает синхронно — она долетает до старта.
+   */
+  private static createTransport(
+    transport: TransportMultiOptions,
+  ): TransportStream {
+    this.disposeActiveTransport();
+
+    const stream = requirePino().transport(transport) as TransportStream;
+
+    stream.on('error', (...args: unknown[]) => {
+      const error = args[0];
+      const message = error instanceof Error ? error.message : String(error);
+
+      process.stderr.write(`[@rsdk/logging] transport error: ${message}\n`);
+    });
+
+    this._activeTransport = stream;
+    this._activeTransportConfig = transport;
+
+    return stream;
+  }
+
+  /**
+   * Завершает воркеры предыдущего транспорта (best-effort, не блокируя). stdout
+   * не затрагивается: для него хэндл не сохраняется.
+   */
+  private static disposeActiveTransport(): void {
+    const previous = this._activeTransport;
+
+    if (!previous) return;
+
+    this._activeTransport = null;
+    this._activeTransportConfig = null;
+
+    // на teardown ошибки ожидаемы (например, "end() took too long" у медленных
+    // транспортов) — глушим их молча и не держим event loop
+    previous.unref?.();
+    previous.removeAllListeners?.('error');
+    previous.on('error', () => {});
 
-    Object.assign(this.opts, { redact, level: level ?? DEFAULT_LEVEL, stream });
+    try {
+      previous.end();
+    } catch {}
   }
 }

package/src/metadata/logger-metadata.registry.ts

@@ -1,21 +1,21 @@
 import type { Constructor } from '@rsdk/common';
 
-import type { LoggerSerealizerMetadata } from '../types';
+import type { LoggerSerializerMetadata } from '../types';
 
 export class LoggerMetadataRegistry {
   private static readonly serializers = new Map<
     Constructor,
-    LoggerSerealizerMetadata
+    LoggerSerializerMetadata
   >();
 
   static registerSerializer(
     target: Constructor,
-    metadata: LoggerSerealizerMetadata,
+    metadata: LoggerSerializerMetadata,
   ): void {
     this.serializers.set(target, metadata);
   }
 
-  static getSerializers(): LoggerSerealizerMetadata[] {
+  static getSerializers(): LoggerSerializerMetadata[] {
     return Array.from(this.serializers.values());
   }
 }

package/src/types.ts

@@ -1,5 +1,6 @@
 import type { Constructor } from '@rsdk/common';
 import type pino from 'pino';
+import type { TransportMultiOptions } from 'pino';
 
 export enum LogLevel {
   fatal = 'fatal',
@@ -10,14 +11,34 @@ export enum LogLevel {
   trace = 'trace',
 }
 
+export enum LogTimestampFormat {
+  epochTime = 'epochTime',
+  unixTime = 'unixTime',
+  nullTime = 'nullTime',
+  isoTime = 'isoTime',
+}
+
+export type TimeFn = () => string;
+
 export type Params = Record<string, unknown>;
 
-export interface LoggerOptions {
+export interface LoggerOptionsBase {
   level: LogLevel;
   redact: string[];
-  stream: pino.DestinationStream;
+  timestampFormat: LogTimestampFormat;
 }
 
+/**
+ * `stream` и `transport` — взаимоисключающие способы доставки (pino не
+ * принимает оба сразу). Это закодировано в типе: задание одного запрещает
+ * другой.
+ */
+export type LoggerOptions = LoggerOptionsBase &
+  (
+    | { stream?: pino.DestinationStream; transport?: never }
+    | { stream?: never; transport?: TransportMultiOptions }
+  );
+
 export type LoggingContext = string | Constructor;
 
 export type OnMessage = (
@@ -25,6 +46,6 @@ export type OnMessage = (
   data: Record<string, unknown>,
 ) => void;
 
-export interface LoggerSerealizerMetadata {
+export interface LoggerSerializerMetadata {
   target: Constructor;
 }