@unchainedshop/logger 4.0.0-rc.2 → 4.0.0-rc.21
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +94 -2
- package/benchmarks/README.md +32 -0
- package/benchmarks/benchmark.ts +273 -0
- package/lib/createLogger.d.ts +23 -2
- package/lib/createLogger.d.ts.map +1 -1
- package/lib/createLogger.js +175 -50
- package/lib/createLogger.js.map +1 -1
- package/lib/log.d.ts +2 -2
- package/lib/log.d.ts.map +1 -1
- package/package.json +5 -7
- package/src/createLogger.ts +199 -56
- package/tests/createLogger.test.ts +725 -0
- package/tsconfig.json +3 -2
package/lib/createLogger.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"createLogger.js","sourceRoot":"","sources":["../src/createLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"createLogger.js","sourceRoot":"","sources":["../src/createLogger.ts"],"names":[],"mappings":"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"}
|
package/lib/log.d.ts
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
export declare const defaultLogger: import("
|
|
2
|
-
export declare const log: (...
|
|
1
|
+
export declare const defaultLogger: import("./createLogger.js").Logger;
|
|
2
|
+
export declare const log: (message: any, ...args: any[]) => void;
|
|
3
3
|
//# sourceMappingURL=log.d.ts.map
|
package/lib/log.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa,
|
|
1
|
+
{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa,oCAAS,CAAC;AAEpC,eAAO,MAAM,GAAG,wCAAc,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@unchainedshop/logger",
|
|
3
|
-
"version": "4.0.0-rc.
|
|
3
|
+
"version": "4.0.0-rc.21",
|
|
4
4
|
"main": "lib/logger-index.js",
|
|
5
5
|
"types": "lib/logger-index.d.ts",
|
|
6
6
|
"type": "module",
|
|
@@ -10,7 +10,8 @@
|
|
|
10
10
|
"prepublishOnly": "npm run clean && npm run build",
|
|
11
11
|
"watch": "tsc -w",
|
|
12
12
|
"test": "tsx --test",
|
|
13
|
-
"test:watch": "tsx --test --watch"
|
|
13
|
+
"test:watch": "tsx --test --watch",
|
|
14
|
+
"benchmark": "tsx benchmarks/benchmark.ts"
|
|
14
15
|
},
|
|
15
16
|
"repository": {
|
|
16
17
|
"type": "git",
|
|
@@ -31,14 +32,11 @@
|
|
|
31
32
|
},
|
|
32
33
|
"homepage": "https://github.com/unchainedshop/unchained#readme",
|
|
33
34
|
"dependencies": {
|
|
34
|
-
"chalk": "^5.4.1",
|
|
35
|
-
"loglevel": "^1.9.2",
|
|
36
|
-
"loglevel-plugin-prefix": "^0.8.4",
|
|
37
35
|
"safe-stable-stringify": "^2.5.0"
|
|
38
36
|
},
|
|
39
37
|
"devDependencies": {
|
|
40
|
-
"@types/node": "^
|
|
41
|
-
"tsx": "^4.
|
|
38
|
+
"@types/node": "^24.0.13",
|
|
39
|
+
"tsx": "^4.20.3",
|
|
42
40
|
"typescript": "^5.8.3"
|
|
43
41
|
}
|
|
44
42
|
}
|
package/src/createLogger.ts
CHANGED
|
@@ -1,85 +1,228 @@
|
|
|
1
|
+
import { inspect } from 'node:util';
|
|
1
2
|
import { stringify } from 'safe-stable-stringify';
|
|
2
|
-
import { default as log } from 'loglevel';
|
|
3
3
|
import { LogLevel } from './logger.types.js';
|
|
4
|
-
import { default as prefix } from 'loglevel-plugin-prefix';
|
|
5
|
-
import chalk from 'chalk';
|
|
6
4
|
|
|
7
|
-
|
|
5
|
+
/**
|
|
6
|
+
* Performance optimization: Cache compiled regex patterns to avoid recreating them
|
|
7
|
+
* on every DEBUG pattern match. This provides ~190% improvement in pattern matching.
|
|
8
|
+
*/
|
|
9
|
+
const regexCache = new Map<string, RegExp>();
|
|
8
10
|
|
|
9
|
-
|
|
11
|
+
/**
|
|
12
|
+
* Performance optimization: Cache DEBUG pattern matching results per module
|
|
13
|
+
* to avoid recomputation for the same module names.
|
|
14
|
+
*/
|
|
15
|
+
const debugPatternCache = new Map<string, boolean>();
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* Checks if a module name matches the DEBUG environment variable pattern.
|
|
19
|
+
* Supports wildcards (*), exclusions (-pattern), and comma-separated lists.
|
|
20
|
+
* Results are cached for performance.
|
|
21
|
+
*/
|
|
22
|
+
const debugStringContainsModule = (debugString: string, moduleName: string): boolean => {
|
|
10
23
|
if (!debugString) return false;
|
|
24
|
+
|
|
25
|
+
// Check cache first for performance
|
|
26
|
+
const cacheKey = `${debugString}::${moduleName}`;
|
|
27
|
+
const cached = debugPatternCache.get(cacheKey);
|
|
28
|
+
if (cached !== undefined) return cached;
|
|
29
|
+
|
|
11
30
|
const loggingMatched = debugString.split(',').reduce((accumulator: any, name: string) => {
|
|
12
31
|
if (accumulator === false) return accumulator;
|
|
13
|
-
|
|
14
|
-
|
|
32
|
+
|
|
33
|
+
// Get or create cached regex pattern
|
|
34
|
+
let regExp = regexCache.get(name);
|
|
35
|
+
if (!regExp) {
|
|
36
|
+
const nameRegex = name.replace(/-/i, '\\-?').replace(/:\*/i, '\\:?*').replace(/\*/i, '.*');
|
|
37
|
+
regExp = new RegExp(`^${nameRegex}$`, 'm');
|
|
38
|
+
regexCache.set(name, regExp);
|
|
39
|
+
}
|
|
40
|
+
|
|
15
41
|
if (regExp.test(moduleName)) {
|
|
42
|
+
// Exclusion pattern (starts with -)
|
|
16
43
|
if (name.slice(0, 1) === '-') {
|
|
17
|
-
// explicitly disable
|
|
18
44
|
return false;
|
|
19
45
|
}
|
|
20
46
|
return true;
|
|
21
47
|
}
|
|
22
48
|
return accumulator;
|
|
23
49
|
}, undefined);
|
|
24
|
-
|
|
50
|
+
|
|
51
|
+
const result = loggingMatched || false;
|
|
52
|
+
debugPatternCache.set(cacheKey, result);
|
|
53
|
+
return result;
|
|
25
54
|
};
|
|
26
55
|
|
|
56
|
+
// ANSI color codes
|
|
27
57
|
const colors = {
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
58
|
+
gray: '\x1b[90m',
|
|
59
|
+
green: '\x1b[32m',
|
|
60
|
+
cyan: '\x1b[36m',
|
|
61
|
+
blue: '\x1b[34m',
|
|
62
|
+
yellow: '\x1b[33m',
|
|
63
|
+
red: '\x1b[31m',
|
|
64
|
+
magenta: '\x1b[35m',
|
|
65
|
+
reset: '\x1b[0m',
|
|
33
66
|
};
|
|
34
67
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
68
|
+
// Log level configuration
|
|
69
|
+
enum LogLevelValue {
|
|
70
|
+
TRACE = 0,
|
|
71
|
+
DEBUG = 1,
|
|
72
|
+
INFO = 2,
|
|
73
|
+
WARN = 3,
|
|
74
|
+
ERROR = 4,
|
|
42
75
|
}
|
|
43
76
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
};
|
|
69
|
-
log.rebuild();
|
|
77
|
+
const logLevelMap: Record<string, LogLevelValue> = {
|
|
78
|
+
[LogLevel.Verbose]: LogLevelValue.TRACE,
|
|
79
|
+
[LogLevel.Debug]: LogLevelValue.DEBUG,
|
|
80
|
+
[LogLevel.Info]: LogLevelValue.INFO,
|
|
81
|
+
[LogLevel.Warning]: LogLevelValue.WARN,
|
|
82
|
+
[LogLevel.Error]: LogLevelValue.ERROR,
|
|
83
|
+
// Add trace as an alias for verbose
|
|
84
|
+
trace: LogLevelValue.TRACE,
|
|
85
|
+
};
|
|
86
|
+
|
|
87
|
+
const levelColors: Record<string, string> = {
|
|
88
|
+
trace: colors.magenta,
|
|
89
|
+
debug: colors.cyan,
|
|
90
|
+
info: colors.blue,
|
|
91
|
+
warn: colors.yellow,
|
|
92
|
+
error: colors.red,
|
|
93
|
+
};
|
|
94
|
+
|
|
95
|
+
export interface Logger {
|
|
96
|
+
trace: (message: any, ...args: any[]) => void;
|
|
97
|
+
debug: (message: any, ...args: any[]) => void;
|
|
98
|
+
info: (message: any, ...args: any[]) => void;
|
|
99
|
+
warn: (message: any, ...args: any[]) => void;
|
|
100
|
+
error: (message: any, ...args: any[]) => void;
|
|
70
101
|
}
|
|
71
102
|
|
|
72
|
-
|
|
103
|
+
/**
|
|
104
|
+
* Formats the current time as HH:MM:SS for log output.
|
|
105
|
+
* Optimized to avoid unnecessary string conversions.
|
|
106
|
+
*/
|
|
107
|
+
const formatTimestamp = (): string => {
|
|
108
|
+
const now = new Date();
|
|
109
|
+
const hours = now.getHours().toString().padStart(2, '0');
|
|
110
|
+
const minutes = now.getMinutes().toString().padStart(2, '0');
|
|
111
|
+
const seconds = now.getSeconds().toString().padStart(2, '0');
|
|
112
|
+
return `${hours}:${minutes}:${seconds}`;
|
|
113
|
+
};
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* Custom JSON replacer function that handles BigInt values by converting them to strings.
|
|
117
|
+
* This ensures BigInt values can be serialized in JSON logs.
|
|
118
|
+
*/
|
|
119
|
+
const bigintReplacer = (_key: string, value: any): any => {
|
|
120
|
+
if (typeof value === 'bigint') {
|
|
121
|
+
return value.toString();
|
|
122
|
+
}
|
|
123
|
+
return value;
|
|
124
|
+
};
|
|
125
|
+
|
|
126
|
+
/**
|
|
127
|
+
* Resets all internal caches. Used for testing to ensure a clean state.
|
|
128
|
+
*/
|
|
129
|
+
export const resetLoggerInitialization = (): void => {
|
|
130
|
+
regexCache.clear();
|
|
131
|
+
debugPatternCache.clear();
|
|
132
|
+
};
|
|
133
|
+
|
|
134
|
+
/**
|
|
135
|
+
* Creates a logger instance for the specified module name.
|
|
136
|
+
* The logger respects DEBUG, LOG_LEVEL, and UNCHAINED_LOG_FORMAT environment variables.
|
|
137
|
+
*
|
|
138
|
+
* Performance optimizations:
|
|
139
|
+
* - Returns no-op functions for disabled log levels (zero-cost logging)
|
|
140
|
+
* - Caches regex patterns and debug results for fast pattern matching
|
|
141
|
+
*
|
|
142
|
+
* @param moduleName - The name of the module (used for filtering and display)
|
|
143
|
+
* @returns A logger instance with trace, debug, info, warn, and error methods
|
|
144
|
+
*/
|
|
145
|
+
export const createLogger = (moduleName: string): Logger => {
|
|
146
|
+
const { DEBUG = '', LOG_LEVEL = LogLevel.Info, UNCHAINED_LOG_FORMAT = 'unchained' } = process.env;
|
|
147
|
+
|
|
148
|
+
// Validate format at logger creation time
|
|
149
|
+
const format = UNCHAINED_LOG_FORMAT.toLowerCase();
|
|
150
|
+
if (format !== 'json' && format !== 'unchained') {
|
|
151
|
+
throw new Error(`UNCHAINED_LOG_FORMAT is invalid, use one of json,unchained`);
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
// Determine minimum log level
|
|
73
155
|
const loggingMatched = debugStringContainsModule(DEBUG, moduleName);
|
|
74
|
-
const
|
|
156
|
+
const logLevelLower = LOG_LEVEL.toLowerCase();
|
|
157
|
+
const mappedLevel = logLevelMap[logLevelLower];
|
|
158
|
+
const minLevel = loggingMatched
|
|
159
|
+
? LogLevelValue.DEBUG
|
|
160
|
+
: mappedLevel !== undefined
|
|
161
|
+
? mappedLevel
|
|
162
|
+
: LogLevelValue.INFO;
|
|
75
163
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
[LogLevel.Warning]: log.levels.WARN,
|
|
80
|
-
[LogLevel.Error]: log.levels.ERROR,
|
|
164
|
+
// Performance optimization: No-op function for disabled log levels
|
|
165
|
+
const noop = () => {
|
|
166
|
+
// Intentionally empty for performance
|
|
81
167
|
};
|
|
82
168
|
|
|
83
|
-
|
|
84
|
-
|
|
169
|
+
const log = (level: string, levelValue: LogLevelValue, message: any, ...args: any[]) => {
|
|
170
|
+
if (levelValue < minLevel) return;
|
|
171
|
+
|
|
172
|
+
if (format === 'json') {
|
|
173
|
+
// JSON format
|
|
174
|
+
const logObject: any = {
|
|
175
|
+
timestamp: new Date().toISOString(),
|
|
176
|
+
level: level.toUpperCase(),
|
|
177
|
+
name: moduleName,
|
|
178
|
+
message: typeof message === 'string' ? message : message,
|
|
179
|
+
};
|
|
180
|
+
|
|
181
|
+
// Merge additional args if they're objects, guarding against prototype pollution
|
|
182
|
+
if (args.length > 0 && typeof args[0] === 'object' && args[0] !== null) {
|
|
183
|
+
for (const key in args[0]) {
|
|
184
|
+
// Skip prototype pollution vectors
|
|
185
|
+
if (key === '__proto__' || key === 'constructor' || key === 'prototype') continue;
|
|
186
|
+
logObject[key] = args[0][key];
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
// Use safe-stable-stringify for proper JSON output with BigInt support
|
|
191
|
+
console.log(stringify(logObject, bigintReplacer));
|
|
192
|
+
} else {
|
|
193
|
+
// Unchained format (pretty)
|
|
194
|
+
const timestamp = formatTimestamp();
|
|
195
|
+
const levelColor = levelColors[level] || colors.reset;
|
|
196
|
+
const prefix = `${colors.gray}${timestamp}${colors.reset} [${colors.green}${moduleName}${colors.reset}] ${levelColor}${level}:${colors.reset}`;
|
|
197
|
+
|
|
198
|
+
if (typeof message === 'string') {
|
|
199
|
+
console.log(prefix, message, ...args);
|
|
200
|
+
} else {
|
|
201
|
+
console.log(prefix, inspect(message, { colors: true, depth: 3 }), ...args);
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
};
|
|
205
|
+
|
|
206
|
+
return {
|
|
207
|
+
trace:
|
|
208
|
+
LogLevelValue.TRACE < minLevel
|
|
209
|
+
? noop
|
|
210
|
+
: (message: any, ...args: any[]) => log('trace', LogLevelValue.TRACE, message, ...args),
|
|
211
|
+
debug:
|
|
212
|
+
LogLevelValue.DEBUG < minLevel
|
|
213
|
+
? noop
|
|
214
|
+
: (message: any, ...args: any[]) => log('debug', LogLevelValue.DEBUG, message, ...args),
|
|
215
|
+
info:
|
|
216
|
+
LogLevelValue.INFO < minLevel
|
|
217
|
+
? noop
|
|
218
|
+
: (message: any, ...args: any[]) => log('info', LogLevelValue.INFO, message, ...args),
|
|
219
|
+
warn:
|
|
220
|
+
LogLevelValue.WARN < minLevel
|
|
221
|
+
? noop
|
|
222
|
+
: (message: any, ...args: any[]) => log('warn', LogLevelValue.WARN, message, ...args),
|
|
223
|
+
error:
|
|
224
|
+
LogLevelValue.ERROR < minLevel
|
|
225
|
+
? noop
|
|
226
|
+
: (message: any, ...args: any[]) => log('error', LogLevelValue.ERROR, message, ...args),
|
|
227
|
+
};
|
|
85
228
|
};
|