@rawnodes/logger 1.8.0 → 1.9.1

package/README.md

@@ -297,6 +297,39 @@ All external transports support:
 | `maxRetries` | 3 | Retry count on failure |
 | `retryDelay` | 1000 | Base retry delay in ms |
 
+### Multiple Transports
+
+You can configure multiple instances of the same transport type using arrays:
+
+```typescript
+const logger = Logger.create({
+  level: 'info',
+  console: { format: 'plain' },
+  discord: [
+    {
+      webhookUrl: 'https://discord.com/api/webhooks/payments/xxx',
+      level: 'off',
+      rules: [{ match: { context: 'payments' }, level: 'error' }],
+    },
+    {
+      webhookUrl: 'https://discord.com/api/webhooks/auth/yyy',
+      level: 'off',
+      rules: [{ match: { context: 'auth' }, level: 'error' }],
+    },
+  ],
+  telegram: [
+    { botToken: 'token1', chatId: 'errors-chat', level: 'error' },
+    { botToken: 'token2', chatId: 'alerts-chat', level: 'warn' },
+  ],
+});
+
+// Payment errors go to payments Discord channel
+logger.for('payments').error('Payment failed');
+
+// Auth errors go to auth Discord channel
+logger.for('auth').error('Login failed');
+```
+
 ## Singleton Pattern
 
 For app-wide logging:

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import TransportStream from 'winston-transport';
+import { z } from 'zod';
 
 declare const LOG_LEVELS: {
     readonly off: -1;
@@ -79,9 +80,9 @@ interface LoggerConfig {
     level: LevelConfig;
     console: ConsoleConfig;
     file?: FileConfig;
-    discord?: DiscordConfig;
-    telegram?: TelegramConfig;
-    cloudwatch?: CloudWatchConfig;
+    discord?: DiscordConfig | DiscordConfig[];
+    telegram?: TelegramConfig | TelegramConfig[];
+    cloudwatch?: CloudWatchConfig | CloudWatchConfig[];
 }
 type LoggerContext = Record<string, unknown>;
 type LevelOverrideMatch<TContext extends LoggerContext> = Partial<TContext> & {
@@ -260,4 +261,19 @@ declare function flattenObject(obj: Record<string, unknown>, prefix?: string): R
 declare function formatLogfmtValue(value: unknown): string;
 declare function formatLogfmt(data: Record<string, unknown>): string;
 
-export { BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CloudWatchConfig, CloudWatchTransport, type ConsoleConfig, type DiscordConfig, DiscordTransport, type FileConfig, type HttpTransportBaseConfig, LOG_LEVELS, type LevelConfig, type LevelConfigObject, type LevelOverride, type LevelOverrideMatch, type LevelRule, type LogFormat, type LogLevel, Logger, type LoggerConfig, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SingletonLogger, type TelegramConfig, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatLogfmt, formatLogfmtValue, generateRequestId, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync };
+declare const LogLevelSchema: z.ZodType<LogLevel>;
+declare const LogFormatSchema: z.ZodType<LogFormat>;
+declare const LevelRuleSchema: z.ZodType<LevelRule>;
+declare const ConsoleConfigSchema: z.ZodType<ConsoleConfig>;
+declare const FileConfigSchema: z.ZodType<FileConfig>;
+declare const HttpTransportBaseConfigSchema: z.ZodType<HttpTransportBaseConfig>;
+declare const DiscordConfigSchema: z.ZodType<DiscordConfig>;
+declare const TelegramConfigSchema: z.ZodType<TelegramConfig>;
+declare const CloudWatchConfigSchema: z.ZodType<CloudWatchConfig>;
+declare const LevelConfigObjectSchema: z.ZodType<LevelConfigObject>;
+declare const LevelConfigSchema: z.ZodType<LevelConfig>;
+declare const LoggerConfigSchema: z.ZodType<LoggerConfig>;
+declare function validateConfig(config: unknown): z.infer<typeof LoggerConfigSchema>;
+declare function safeValidateConfig(config: unknown): z.ZodSafeParseResult<LoggerConfig>;
+
+export { BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CloudWatchConfig, CloudWatchConfigSchema, CloudWatchTransport, type ConsoleConfig, ConsoleConfigSchema, type DiscordConfig, DiscordConfigSchema, DiscordTransport, type FileConfig, FileConfigSchema, type HttpTransportBaseConfig, HttpTransportBaseConfigSchema, LOG_LEVELS, type LevelConfig, type LevelConfigObject, LevelConfigObjectSchema, LevelConfigSchema, type LevelOverride, type LevelOverrideMatch, type LevelRule, LevelRuleSchema, type LogFormat, LogFormatSchema, type LogLevel, LogLevelSchema, Logger, type LoggerConfig, LoggerConfigSchema, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SingletonLogger, type TelegramConfig, TelegramConfigSchema, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatLogfmt, formatLogfmtValue, generateRequestId, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync, safeValidateConfig, validateConfig };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import TransportStream from 'winston-transport';
+import { z } from 'zod';
 
 declare const LOG_LEVELS: {
     readonly off: -1;
@@ -79,9 +80,9 @@ interface LoggerConfig {
     level: LevelConfig;
     console: ConsoleConfig;
     file?: FileConfig;
-    discord?: DiscordConfig;
-    telegram?: TelegramConfig;
-    cloudwatch?: CloudWatchConfig;
+    discord?: DiscordConfig | DiscordConfig[];
+    telegram?: TelegramConfig | TelegramConfig[];
+    cloudwatch?: CloudWatchConfig | CloudWatchConfig[];
 }
 type LoggerContext = Record<string, unknown>;
 type LevelOverrideMatch<TContext extends LoggerContext> = Partial<TContext> & {
@@ -260,4 +261,19 @@ declare function flattenObject(obj: Record<string, unknown>, prefix?: string): R
 declare function formatLogfmtValue(value: unknown): string;
 declare function formatLogfmt(data: Record<string, unknown>): string;
 
-export { BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CloudWatchConfig, CloudWatchTransport, type ConsoleConfig, type DiscordConfig, DiscordTransport, type FileConfig, type HttpTransportBaseConfig, LOG_LEVELS, type LevelConfig, type LevelConfigObject, type LevelOverride, type LevelOverrideMatch, type LevelRule, type LogFormat, type LogLevel, Logger, type LoggerConfig, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SingletonLogger, type TelegramConfig, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatLogfmt, formatLogfmtValue, generateRequestId, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync };
+declare const LogLevelSchema: z.ZodType<LogLevel>;
+declare const LogFormatSchema: z.ZodType<LogFormat>;
+declare const LevelRuleSchema: z.ZodType<LevelRule>;
+declare const ConsoleConfigSchema: z.ZodType<ConsoleConfig>;
+declare const FileConfigSchema: z.ZodType<FileConfig>;
+declare const HttpTransportBaseConfigSchema: z.ZodType<HttpTransportBaseConfig>;
+declare const DiscordConfigSchema: z.ZodType<DiscordConfig>;
+declare const TelegramConfigSchema: z.ZodType<TelegramConfig>;
+declare const CloudWatchConfigSchema: z.ZodType<CloudWatchConfig>;
+declare const LevelConfigObjectSchema: z.ZodType<LevelConfigObject>;
+declare const LevelConfigSchema: z.ZodType<LevelConfig>;
+declare const LoggerConfigSchema: z.ZodType<LoggerConfig>;
+declare function validateConfig(config: unknown): z.infer<typeof LoggerConfigSchema>;
+declare function safeValidateConfig(config: unknown): z.ZodSafeParseResult<LoggerConfig>;
+
+export { BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CloudWatchConfig, CloudWatchConfigSchema, CloudWatchTransport, type ConsoleConfig, ConsoleConfigSchema, type DiscordConfig, DiscordConfigSchema, DiscordTransport, type FileConfig, FileConfigSchema, type HttpTransportBaseConfig, HttpTransportBaseConfigSchema, LOG_LEVELS, type LevelConfig, type LevelConfigObject, LevelConfigObjectSchema, LevelConfigSchema, type LevelOverride, type LevelOverrideMatch, type LevelRule, LevelRuleSchema, type LogFormat, LogFormatSchema, type LogLevel, LogLevelSchema, Logger, type LoggerConfig, LoggerConfigSchema, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SingletonLogger, type TelegramConfig, TelegramConfigSchema, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatLogfmt, formatLogfmtValue, generateRequestId, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync, safeValidateConfig, validateConfig };

package/dist/index.js

@@ -6,6 +6,7 @@ var DailyRotateFile = require('winston-daily-rotate-file');
 var util = require('util');
 var TransportStream = require('winston-transport');
 var clientCloudwatchLogs = require('@aws-sdk/client-cloudwatch-logs');
+var zod = require('zod');
 var crypto = require('crypto');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -711,6 +712,10 @@ var CloudWatchTransport = class extends BaseHttpTransport {
 };
 
 // src/transports.ts
+function toArray(value) {
+  if (!value) return [];
+  return Array.isArray(value) ? value : [value];
+}
 function createTransports(config, store) {
   const result = [
     new winston.transports.Console({
@@ -736,26 +741,26 @@ function createTransports(config, store) {
       })
     );
   }
-  if (config.discord) {
-    const discord = new DiscordTransport(config.discord);
+  for (const discordConfig of toArray(config.discord)) {
+    const discord = new DiscordTransport(discordConfig);
     discord.format = winston.format.combine(
-      createFilterFormat(config.discord.level, config.discord.rules, store),
+      createFilterFormat(discordConfig.level, discordConfig.rules, store),
       winston.format.timestamp()
     );
     result.push(discord);
   }
-  if (config.telegram) {
-    const telegram = new TelegramTransport(config.telegram);
+  for (const telegramConfig of toArray(config.telegram)) {
+    const telegram = new TelegramTransport(telegramConfig);
     telegram.format = winston.format.combine(
-      createFilterFormat(config.telegram.level, config.telegram.rules, store),
+      createFilterFormat(telegramConfig.level, telegramConfig.rules, store),
       winston.format.timestamp()
     );
     result.push(telegram);
   }
-  if (config.cloudwatch) {
-    const cloudwatch = new CloudWatchTransport(config.cloudwatch);
+  for (const cloudwatchConfig of toArray(config.cloudwatch)) {
+    const cloudwatch = new CloudWatchTransport(cloudwatchConfig);
     cloudwatch.format = winston.format.combine(
-      createFilterFormat(config.cloudwatch.level, config.cloudwatch.rules, store),
+      createFilterFormat(cloudwatchConfig.level, cloudwatchConfig.rules, store),
       winston.format.timestamp()
     );
     result.push(cloudwatch);
@@ -838,6 +843,111 @@ function matchesContext(storeContext, loggerContext, match) {
   const combined = { ...storeContext, context: loggerContext };
   return Object.entries(match).every(([key, value]) => combined[key] === value);
 }
+var LogLevelSchema = zod.z.enum([
+  "off",
+  "error",
+  "warn",
+  "info",
+  "http",
+  "verbose",
+  "debug",
+  "silly"
+]);
+var LogFormatSchema = zod.z.enum(["json", "plain", "logfmt", "simple"]);
+var LevelRuleSchema = zod.z.object({
+  match: zod.z.record(zod.z.string(), zod.z.unknown()),
+  level: LogLevelSchema
+});
+var ConsoleConfigSchema = zod.z.object({
+  format: LogFormatSchema,
+  level: LogLevelSchema.optional(),
+  rules: zod.z.array(LevelRuleSchema).optional()
+});
+var FileConfigSchema = zod.z.object({
+  format: LogFormatSchema,
+  level: LogLevelSchema.optional(),
+  rules: zod.z.array(LevelRuleSchema).optional(),
+  dirname: zod.z.string().min(1, "dirname is required"),
+  filename: zod.z.string().min(1, "filename is required"),
+  datePattern: zod.z.string().optional(),
+  zippedArchive: zod.z.boolean().optional(),
+  maxSize: zod.z.string().optional(),
+  maxFiles: zod.z.string().optional()
+});
+var HttpTransportBaseConfigSchema = zod.z.object({
+  level: LogLevelSchema.optional(),
+  rules: zod.z.array(LevelRuleSchema).optional(),
+  batchSize: zod.z.number().int().positive().optional(),
+  flushInterval: zod.z.number().int().positive().optional(),
+  maxRetries: zod.z.number().int().nonnegative().optional(),
+  retryDelay: zod.z.number().int().positive().optional()
+});
+var DiscordConfigSchema = zod.z.object({
+  level: LogLevelSchema.optional(),
+  rules: zod.z.array(LevelRuleSchema).optional(),
+  batchSize: zod.z.number().int().positive().optional(),
+  flushInterval: zod.z.number().int().positive().optional(),
+  maxRetries: zod.z.number().int().nonnegative().optional(),
+  retryDelay: zod.z.number().int().positive().optional(),
+  webhookUrl: zod.z.string().url("webhookUrl must be a valid URL"),
+  username: zod.z.string().optional(),
+  avatarUrl: zod.z.string().url().optional(),
+  embedColors: zod.z.record(zod.z.string(), zod.z.number().int()).optional(),
+  includeTimestamp: zod.z.boolean().optional(),
+  includeMeta: zod.z.boolean().optional(),
+  maxEmbedFields: zod.z.number().int().min(1).max(25).optional()
+});
+var TelegramConfigSchema = zod.z.object({
+  level: LogLevelSchema.optional(),
+  rules: zod.z.array(LevelRuleSchema).optional(),
+  batchSize: zod.z.number().int().positive().optional(),
+  flushInterval: zod.z.number().int().positive().optional(),
+  maxRetries: zod.z.number().int().nonnegative().optional(),
+  retryDelay: zod.z.number().int().positive().optional(),
+  botToken: zod.z.string().min(1, "botToken is required"),
+  chatId: zod.z.union([zod.z.string(), zod.z.number()]),
+  parseMode: zod.z.enum(["Markdown", "MarkdownV2", "HTML"]).optional(),
+  disableNotification: zod.z.boolean().optional(),
+  threadId: zod.z.number().int().optional(),
+  replyToMessageId: zod.z.number().int().optional()
+});
+var CloudWatchConfigSchema = zod.z.object({
+  level: LogLevelSchema.optional(),
+  rules: zod.z.array(LevelRuleSchema).optional(),
+  batchSize: zod.z.number().int().positive().optional(),
+  flushInterval: zod.z.number().int().positive().optional(),
+  maxRetries: zod.z.number().int().nonnegative().optional(),
+  retryDelay: zod.z.number().int().positive().optional(),
+  logGroupName: zod.z.string().min(1, "logGroupName is required"),
+  logStreamName: zod.z.string().min(1, "logStreamName is required"),
+  region: zod.z.string().min(1, "region is required"),
+  accessKeyId: zod.z.string().min(1, "accessKeyId is required"),
+  secretAccessKey: zod.z.string().min(1, "secretAccessKey is required"),
+  createLogGroup: zod.z.boolean().optional(),
+  createLogStream: zod.z.boolean().optional()
+});
+var LevelConfigObjectSchema = zod.z.object({
+  default: LogLevelSchema,
+  rules: zod.z.array(LevelRuleSchema).optional()
+});
+var LevelConfigSchema = zod.z.union([
+  LogLevelSchema,
+  LevelConfigObjectSchema
+]);
+var LoggerConfigSchema = zod.z.object({
+  level: LevelConfigSchema,
+  console: ConsoleConfigSchema,
+  file: FileConfigSchema.optional(),
+  discord: zod.z.union([DiscordConfigSchema, zod.z.array(DiscordConfigSchema)]).optional(),
+  telegram: zod.z.union([TelegramConfigSchema, zod.z.array(TelegramConfigSchema)]).optional(),
+  cloudwatch: zod.z.union([CloudWatchConfigSchema, zod.z.array(CloudWatchConfigSchema)]).optional()
+});
+function validateConfig(config) {
+  return LoggerConfigSchema.parse(config);
+}
+function safeValidateConfig(config) {
+  return LoggerConfigSchema.safeParse(config);
+}
 
 // src/logger.ts
 var Logger = class _Logger {
@@ -846,7 +956,8 @@ var Logger = class _Logger {
     this.context = context;
   }
   static create(config, store) {
-    const state = createState(config, store);
+    const validatedConfig = validateConfig(config);
+    const state = createState(validatedConfig, store);
     return new _Logger(state, "APP");
   }
   for(context) {
@@ -1027,12 +1138,24 @@ function getOrGenerateRequestId(headers, options = {}) {
 }
 
 exports.BaseHttpTransport = BaseHttpTransport;
+exports.CloudWatchConfigSchema = CloudWatchConfigSchema;
 exports.CloudWatchTransport = CloudWatchTransport;
+exports.ConsoleConfigSchema = ConsoleConfigSchema;
+exports.DiscordConfigSchema = DiscordConfigSchema;
 exports.DiscordTransport = DiscordTransport;
+exports.FileConfigSchema = FileConfigSchema;
+exports.HttpTransportBaseConfigSchema = HttpTransportBaseConfigSchema;
 exports.LOG_LEVELS = LOG_LEVELS;
+exports.LevelConfigObjectSchema = LevelConfigObjectSchema;
+exports.LevelConfigSchema = LevelConfigSchema;
+exports.LevelRuleSchema = LevelRuleSchema;
+exports.LogFormatSchema = LogFormatSchema;
+exports.LogLevelSchema = LogLevelSchema;
 exports.Logger = Logger;
+exports.LoggerConfigSchema = LoggerConfigSchema;
 exports.LoggerStore = LoggerStore;
 exports.MessageBuffer = MessageBuffer;
+exports.TelegramConfigSchema = TelegramConfigSchema;
 exports.TelegramTransport = TelegramTransport;
 exports.assertLogLevel = assertLogLevel;
 exports.createMasker = createMasker;
@@ -1048,5 +1171,7 @@ exports.maskSecrets = maskSecrets;
 exports.matchesContext = matchesContext;
 exports.measureAsync = measureAsync;
 exports.measureSync = measureSync;
+exports.safeValidateConfig = safeValidateConfig;
+exports.validateConfig = validateConfig;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map