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

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,17 +11,41 @@ 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 = (
   level: LogLevel,
   data: Record<string, unknown>,
 ) => void;
+
+export interface LoggerSerializerMetadata {
+  target: Constructor;
+}