@matter/general 0.13.0-alpha.0-20250322-f085fa576 → 0.13.0-alpha.0-20250324-d7b7d9731
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/dist/cjs/log/Console.d.ts +21 -0
- package/dist/cjs/log/Console.d.ts.map +1 -0
- package/dist/cjs/log/Console.js +58 -0
- package/dist/cjs/log/Console.js.map +6 -0
- package/dist/cjs/log/Diagnostic.d.ts +6 -0
- package/dist/cjs/log/Diagnostic.d.ts.map +1 -1
- package/dist/cjs/log/Diagnostic.js +16 -0
- package/dist/cjs/log/Diagnostic.js.map +1 -1
- package/dist/cjs/log/LogDestination.d.ts +67 -0
- package/dist/cjs/log/LogDestination.d.ts.map +1 -0
- package/dist/cjs/log/LogDestination.js +65 -0
- package/dist/cjs/log/LogDestination.js.map +6 -0
- package/dist/cjs/log/LogFormat.d.ts +18 -12
- package/dist/cjs/log/LogFormat.d.ts.map +1 -1
- package/dist/cjs/log/LogFormat.js +17 -24
- package/dist/cjs/log/LogFormat.js.map +1 -1
- package/dist/cjs/log/LogLevel.d.ts +19 -9
- package/dist/cjs/log/LogLevel.d.ts.map +1 -1
- package/dist/cjs/log/LogLevel.js +40 -25
- package/dist/cjs/log/LogLevel.js.map +1 -1
- package/dist/cjs/log/Logger.d.ts +157 -106
- package/dist/cjs/log/Logger.d.ts.map +1 -1
- package/dist/cjs/log/Logger.js +298 -256
- package/dist/cjs/log/Logger.js.map +2 -2
- package/dist/cjs/log/index.d.ts +1 -0
- package/dist/cjs/log/index.d.ts.map +1 -1
- package/dist/cjs/log/index.js +1 -0
- package/dist/cjs/log/index.js.map +1 -1
- package/dist/cjs/transaction/Transaction.d.ts +19 -19
- package/dist/esm/log/Console.d.ts +21 -0
- package/dist/esm/log/Console.d.ts.map +1 -0
- package/dist/esm/log/Console.js +38 -0
- package/dist/esm/log/Console.js.map +6 -0
- package/dist/esm/log/Diagnostic.d.ts +6 -0
- package/dist/esm/log/Diagnostic.d.ts.map +1 -1
- package/dist/esm/log/Diagnostic.js +16 -0
- package/dist/esm/log/Diagnostic.js.map +1 -1
- package/dist/esm/log/LogDestination.d.ts +67 -0
- package/dist/esm/log/LogDestination.d.ts.map +1 -0
- package/dist/esm/log/LogDestination.js +45 -0
- package/dist/esm/log/LogDestination.js.map +6 -0
- package/dist/esm/log/LogFormat.d.ts +18 -12
- package/dist/esm/log/LogFormat.d.ts.map +1 -1
- package/dist/esm/log/LogFormat.js +17 -24
- package/dist/esm/log/LogFormat.js.map +1 -1
- package/dist/esm/log/LogLevel.d.ts +19 -9
- package/dist/esm/log/LogLevel.d.ts.map +1 -1
- package/dist/esm/log/LogLevel.js +40 -25
- package/dist/esm/log/LogLevel.js.map +1 -1
- package/dist/esm/log/Logger.d.ts +157 -106
- package/dist/esm/log/Logger.d.ts.map +1 -1
- package/dist/esm/log/Logger.js +298 -256
- package/dist/esm/log/Logger.js.map +2 -2
- package/dist/esm/log/index.d.ts +1 -0
- package/dist/esm/log/index.d.ts.map +1 -1
- package/dist/esm/log/index.js +1 -0
- package/dist/esm/log/index.js.map +1 -1
- package/dist/esm/transaction/Transaction.d.ts +19 -19
- package/package.json +2 -2
- package/src/log/Console.ts +52 -0
- package/src/log/Diagnostic.ts +21 -0
- package/src/log/LogDestination.ts +113 -0
- package/src/log/LogFormat.ts +39 -36
- package/src/log/LogLevel.ts +55 -25
- package/src/log/Logger.ts +379 -314
- package/src/log/index.ts +1 -0
package/dist/cjs/log/LogLevel.js
CHANGED
|
@@ -22,36 +22,51 @@ __export(LogLevel_exports, {
|
|
|
22
22
|
logLevelFromString: () => logLevelFromString
|
|
23
23
|
});
|
|
24
24
|
module.exports = __toCommonJS(LogLevel_exports);
|
|
25
|
+
var import_MatterError = require("#MatterError.js");
|
|
25
26
|
/**
|
|
26
27
|
* @license
|
|
27
28
|
* Copyright 2022-2025 Matter.js Authors
|
|
28
29
|
* SPDX-License-Identifier: Apache-2.0
|
|
29
30
|
*/
|
|
30
|
-
function
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
return 0 /* DEBUG */;
|
|
34
|
-
case "info":
|
|
35
|
-
return 1 /* INFO */;
|
|
36
|
-
case "notice":
|
|
37
|
-
return 2 /* NOTICE */;
|
|
38
|
-
case "warn":
|
|
39
|
-
return 3 /* WARN */;
|
|
40
|
-
case "error":
|
|
41
|
-
return 4 /* ERROR */;
|
|
42
|
-
case "fatal":
|
|
43
|
-
return 5 /* FATAL */;
|
|
44
|
-
default:
|
|
45
|
-
return 1 /* INFO */;
|
|
31
|
+
function LogLevel(level) {
|
|
32
|
+
if (typeof level === "string" && level.match(/^\d+$/)) {
|
|
33
|
+
level = Number.parseInt(level);
|
|
46
34
|
}
|
|
35
|
+
if (typeof level === "string") {
|
|
36
|
+
switch (level.toLowerCase()) {
|
|
37
|
+
case "debug":
|
|
38
|
+
return LogLevel.DEBUG;
|
|
39
|
+
case "info":
|
|
40
|
+
return LogLevel.INFO;
|
|
41
|
+
case "notice":
|
|
42
|
+
return LogLevel.NOTICE;
|
|
43
|
+
case "warn":
|
|
44
|
+
return LogLevel.WARN;
|
|
45
|
+
case "error":
|
|
46
|
+
return LogLevel.ERROR;
|
|
47
|
+
case "fatal":
|
|
48
|
+
return LogLevel.FATAL;
|
|
49
|
+
default:
|
|
50
|
+
}
|
|
51
|
+
} else if (level >= 0 && level <= 5) {
|
|
52
|
+
return level;
|
|
53
|
+
}
|
|
54
|
+
throw new import_MatterError.ImplementationError(`Unsupported log level "${level}"`);
|
|
47
55
|
}
|
|
48
|
-
|
|
49
|
-
LogLevel2
|
|
50
|
-
LogLevel2
|
|
51
|
-
LogLevel2
|
|
52
|
-
LogLevel2
|
|
53
|
-
LogLevel2
|
|
54
|
-
LogLevel2
|
|
55
|
-
|
|
56
|
-
})(LogLevel || {});
|
|
56
|
+
((LogLevel2) => {
|
|
57
|
+
LogLevel2.DEBUG = 0;
|
|
58
|
+
LogLevel2.INFO = 1;
|
|
59
|
+
LogLevel2.NOTICE = 2;
|
|
60
|
+
LogLevel2.WARN = 3;
|
|
61
|
+
LogLevel2.ERROR = 4;
|
|
62
|
+
LogLevel2.FATAL = 5;
|
|
63
|
+
LogLevel2.names = ["debug", "info", "notice", "warn", "error", "fatal"];
|
|
64
|
+
})(LogLevel || (LogLevel = {}));
|
|
65
|
+
LogLevel[0] = "debug";
|
|
66
|
+
LogLevel[1] = "info";
|
|
67
|
+
LogLevel[2] = "notice";
|
|
68
|
+
LogLevel[3] = "warn";
|
|
69
|
+
LogLevel[4] = "error";
|
|
70
|
+
LogLevel[5] = "fatal";
|
|
71
|
+
const logLevelFromString = LogLevel;
|
|
57
72
|
//# sourceMappingURL=LogLevel.js.map
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../src/log/LogLevel.ts"],
|
|
4
|
-
"mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;
|
|
4
|
+
"mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,yBAAoC;AANpC;AAAA;AAAA;AAAA;AAAA;AAgBO,SAAS,SAAS,OAAoC;AACzD,MAAI,OAAO,UAAU,YAAY,MAAM,MAAM,OAAO,GAAG;AACnD,YAAQ,OAAO,SAAS,KAAK;AAAA,EACjC;AAEA,MAAI,OAAO,UAAU,UAAU;AAC3B,YAAQ,MAAM,YAAY,GAAG;AAAA,MACzB,KAAK;AACD,eAAO,SAAS;AAAA,MACpB,KAAK;AACD,eAAO,SAAS;AAAA,MACpB,KAAK;AACD,eAAO,SAAS;AAAA,MACpB,KAAK;AACD,eAAO,SAAS;AAAA,MACpB,KAAK;AACD,eAAO,SAAS;AAAA,MACpB,KAAK;AACD,eAAO,SAAS;AAAA,MACpB;AAAA,IACJ;AAAA,EACJ,WAAW,SAAS,KAAK,SAAS,GAAG;AACjC,WAAO;AAAA,EACX;AAEA,QAAM,IAAI,uCAAoB,0BAA0B,KAAK,GAAG;AACpE;AAAA,CAEO,CAAUA,cAAV;AACI,EAAMA,UAAA,QAAkB;AACxB,EAAMA,UAAA,OAAiB;AACvB,EAAMA,UAAA,SAAmB;AACzB,EAAMA,UAAA,OAAiB;AACvB,EAAMA,UAAA,QAAkB;AACxB,EAAMA,UAAA,QAAkB;AAExB,EAAMA,UAAA,QAAQ,CAAC,SAAS,QAAQ,UAAU,QAAQ,SAAS,OAAO;AAAA,GAR5D;AAWjB,SAAS,CAAC,IAAI;AACd,SAAS,CAAC,IAAI;AACd,SAAS,CAAC,IAAI;AACd,SAAS,CAAC,IAAI;AACd,SAAS,CAAC,IAAI;AACd,SAAS,CAAC,IAAI;AAKP,MAAM,qBAAqB;",
|
|
5
5
|
"names": ["LogLevel"]
|
|
6
6
|
}
|
package/dist/cjs/log/Logger.d.ts
CHANGED
|
@@ -4,59 +4,125 @@
|
|
|
4
4
|
* SPDX-License-Identifier: Apache-2.0
|
|
5
5
|
*/
|
|
6
6
|
import { Diagnostic } from "./Diagnostic.js";
|
|
7
|
+
import { LogDestination } from "./LogDestination.js";
|
|
8
|
+
import { LogFormat } from "./LogFormat.js";
|
|
7
9
|
import { LogLevel } from "./LogLevel.js";
|
|
8
10
|
/**
|
|
9
|
-
*
|
|
10
|
-
*/
|
|
11
|
-
export declare function consoleLogger(level: LogLevel, formattedLog: string, _facility?: string): void;
|
|
12
|
-
export declare namespace consoleLogger {
|
|
13
|
-
/**
|
|
14
|
-
* The target for consoleLogger.
|
|
15
|
-
*/
|
|
16
|
-
let console: Console;
|
|
17
|
-
}
|
|
18
|
-
/**
|
|
19
|
-
* Definition of one registered Logger.
|
|
20
|
-
*/
|
|
21
|
-
type LoggerDefinition = {
|
|
22
|
-
logIdentifier: string;
|
|
23
|
-
logFormatter: (now: Date, level: LogLevel, facility: string, prefix: string, ...values: any[]) => string;
|
|
24
|
-
log: (level: LogLevel, formattedLog: string, facility?: string) => void;
|
|
25
|
-
defaultLogLevel: LogLevel;
|
|
26
|
-
logLevels: {
|
|
27
|
-
[facility: string]: LogLevel;
|
|
28
|
-
};
|
|
29
|
-
context?: Diagnostic.Context;
|
|
30
|
-
};
|
|
31
|
-
/**
|
|
32
|
-
* Logger that can be used to emit traces.
|
|
33
|
-
*
|
|
34
|
-
* The class supports adding multiple loggers for different targets. A default logger (identifier "default") is added on
|
|
35
|
-
* startup which logs to "console".
|
|
11
|
+
* matter.js logging API
|
|
36
12
|
*
|
|
37
13
|
* Usage:
|
|
38
14
|
*
|
|
39
|
-
* const
|
|
40
|
-
*
|
|
41
|
-
*
|
|
42
|
-
* The configuration of the default logger can be adjusted by using the static properties of the Logger class:
|
|
15
|
+
* const logger = Logger.get("loggerName");
|
|
16
|
+
* logger.debug("My debug message", "my extra value to log");
|
|
43
17
|
*
|
|
44
|
-
*
|
|
45
|
-
*
|
|
46
|
-
* - Logger.format = Format.ANSI enables colorization via ANSI escape sequences in default formatter
|
|
18
|
+
* matter.js writes logs to each {@link LogDestination} in {@link Logger.destinations}. By default a single destination
|
|
19
|
+
* named "default" writes to the JS console.
|
|
47
20
|
*
|
|
48
|
-
*
|
|
49
|
-
* configuration of these can be adjusted using static methods with the identifier as first parameter:
|
|
21
|
+
* You may adjust log verbosity and format by modifying the properties on destinations. For example:
|
|
50
22
|
*
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
*
|
|
23
|
+
* `Logger.format = LogFormat.PLAIN` sets all destinations to write plaintext
|
|
24
|
+
* `Logger.destinations.default.format = LogFormat.format.ansi` sets one destination to write ANSI
|
|
25
|
+
* `Logger.level = LogLevel.NOTICE` sets "notice" as the minimum level for all destinations
|
|
26
|
+
* `Logger.destinations.default.level = LogLevel.NOTICE` sets "notice" as level for one destination
|
|
54
27
|
*/
|
|
55
28
|
export declare class Logger {
|
|
56
29
|
#private;
|
|
57
|
-
|
|
30
|
+
/**
|
|
31
|
+
* Log destinations.
|
|
32
|
+
*
|
|
33
|
+
* By default there is a single destination named "default". You can create new destinations using
|
|
34
|
+
* {@link LogDestination}. Add or remove destinations by modifying this object.
|
|
35
|
+
*
|
|
36
|
+
* Throws an error if you access a destination that doesn't exist.
|
|
37
|
+
*/
|
|
38
|
+
static destinations: Record<string, LogDestination>;
|
|
39
|
+
/**
|
|
40
|
+
* The number of indents to print with messages.
|
|
41
|
+
*/
|
|
58
42
|
static nestingLevel: number;
|
|
59
|
-
/**
|
|
43
|
+
/**
|
|
44
|
+
* Create a new logger for a facility.
|
|
45
|
+
*
|
|
46
|
+
* @param name the name of the facility
|
|
47
|
+
* @returns a new facility
|
|
48
|
+
*/
|
|
49
|
+
static get(name: string): Logger;
|
|
50
|
+
/**
|
|
51
|
+
* Get the default log level.
|
|
52
|
+
*/
|
|
53
|
+
static get level(): LogLevel | string;
|
|
54
|
+
/**
|
|
55
|
+
* Set log level as name or number for all destinations.
|
|
56
|
+
*/
|
|
57
|
+
static set level(level: LogLevel | string);
|
|
58
|
+
/**
|
|
59
|
+
* Get the default facility levels.
|
|
60
|
+
*/
|
|
61
|
+
static get facilityLevels(): Record<string, LogLevel | string>;
|
|
62
|
+
/**
|
|
63
|
+
* Set log level as name or number for facilities in all destinations.
|
|
64
|
+
*
|
|
65
|
+
* Existing levels that are not named in {@link levels} will remain unchanged.
|
|
66
|
+
*/
|
|
67
|
+
static set facilityLevels(levels: Record<string, LogLevel | string>);
|
|
68
|
+
/**
|
|
69
|
+
* Get the default format name.
|
|
70
|
+
*/
|
|
71
|
+
static get format(): string;
|
|
72
|
+
/**
|
|
73
|
+
* Set the format for all destinations.
|
|
74
|
+
*/
|
|
75
|
+
static set format(format: string | LogFormat.Formatter);
|
|
76
|
+
/**
|
|
77
|
+
* Mask a string with a given character. If unmaskedLength is provided then these number of characters will be
|
|
78
|
+
* shown unmasked.
|
|
79
|
+
*
|
|
80
|
+
* @param str String to mask
|
|
81
|
+
* @param maskChar character to mask with
|
|
82
|
+
* @param unmaskedLength number of characters to show unmasked in the beginning
|
|
83
|
+
*/
|
|
84
|
+
static maskString(str: string, maskChar?: string, unmaskedLength?: number): string;
|
|
85
|
+
/**
|
|
86
|
+
* Perform operations in a nested logging context. Messages will be
|
|
87
|
+
* indented while the context executes.
|
|
88
|
+
*/
|
|
89
|
+
static nest<T>(context: () => T): T;
|
|
90
|
+
/**
|
|
91
|
+
* Async version of nest().
|
|
92
|
+
*/
|
|
93
|
+
static nestAsync(context: () => Promise<any>): Promise<any>;
|
|
94
|
+
/**
|
|
95
|
+
* Unhandled error reporter.
|
|
96
|
+
*
|
|
97
|
+
* Some environments do not report full error details such as {@link Error#cause} and {@link AggregateError#errors}.
|
|
98
|
+
*
|
|
99
|
+
* To ensure these details are always recorded somewhere, unhandled errors may be reported here.
|
|
100
|
+
*
|
|
101
|
+
* To disable this behavior replace this function.
|
|
102
|
+
*/
|
|
103
|
+
static reportUnhandledError(error: Error): void;
|
|
104
|
+
constructor(name: string);
|
|
105
|
+
debug(...values: unknown[]): void;
|
|
106
|
+
info(...values: unknown[]): void;
|
|
107
|
+
notice(...values: unknown[]): void;
|
|
108
|
+
warn(...values: unknown[]): void;
|
|
109
|
+
error(...values: unknown[]): void;
|
|
110
|
+
fatal(...values: unknown[]): void;
|
|
111
|
+
log(level: LogLevel, ...values: unknown[]): void;
|
|
112
|
+
/**
|
|
113
|
+
* Stringify a value (BigInt aware) as JSON.
|
|
114
|
+
*
|
|
115
|
+
* @param data the value to stringify
|
|
116
|
+
* @returns the stringified value
|
|
117
|
+
*
|
|
118
|
+
* @deprecated use {@link Diagnostic.json}
|
|
119
|
+
*/
|
|
120
|
+
static toJSON(data: any): string;
|
|
121
|
+
/**
|
|
122
|
+
* Add additional logger to the list of loggers including the default configuration.
|
|
123
|
+
*
|
|
124
|
+
* @deprecated use {@link destinations}
|
|
125
|
+
*/
|
|
60
126
|
static addLogger(identifier: string, logger: (level: LogLevel, formattedLog: string) => void, options?: {
|
|
61
127
|
defaultLogLevel?: LogLevel;
|
|
62
128
|
logLevels?: {
|
|
@@ -64,36 +130,41 @@ export declare class Logger {
|
|
|
64
130
|
};
|
|
65
131
|
logFormat?: string;
|
|
66
132
|
}): void;
|
|
133
|
+
/**
|
|
134
|
+
* @deprecated use {@link destinations}
|
|
135
|
+
*/
|
|
67
136
|
static removeLogger(identifier: string): void;
|
|
68
137
|
/**
|
|
69
138
|
* Check if a logger with the matching identifier exists.
|
|
70
139
|
* @param identifier The identifier of the logger
|
|
140
|
+
*
|
|
141
|
+
* @deprecated use {@link destinations}
|
|
71
142
|
*/
|
|
72
143
|
static hasLoggerForIdentifier(identifier: string): boolean;
|
|
73
144
|
/**
|
|
74
145
|
* Get the logger with the matching identifier.
|
|
75
146
|
* @param identifier The identifier of the logger
|
|
147
|
+
*
|
|
148
|
+
* @deprecated use {@link destinations}
|
|
76
149
|
*/
|
|
77
150
|
static getLoggerForIdentifier(identifier: string): LoggerDefinition;
|
|
78
151
|
/**
|
|
79
|
-
*
|
|
80
|
-
*/
|
|
81
|
-
static set level(level: number | string);
|
|
82
|
-
/**
|
|
83
|
-
* Set logFormatter using configuration-style format name.
|
|
84
|
-
*
|
|
85
|
-
* @param format the name of the formatter (see Format enum)
|
|
152
|
+
* @deprecated use {@link destinations}
|
|
86
153
|
*/
|
|
87
|
-
static
|
|
154
|
+
static getLoggerforIdentifier(identifier: string): LoggerDefinition;
|
|
88
155
|
/**
|
|
89
156
|
* Set facility loglevels for the default logger.
|
|
90
157
|
* @param levels The levels to set
|
|
158
|
+
*
|
|
159
|
+
* @deprecated use {@link destinations}
|
|
91
160
|
*/
|
|
92
161
|
static set logLevels(levels: {
|
|
93
162
|
[facility: string]: LogLevel;
|
|
94
163
|
});
|
|
95
164
|
/**
|
|
96
165
|
* Get facility loglevels for the default logger.
|
|
166
|
+
*
|
|
167
|
+
* @deprecated use {@link Logger.facilityLevels}
|
|
97
168
|
*/
|
|
98
169
|
static get logLevels(): {
|
|
99
170
|
[facility: string]: LogLevel;
|
|
@@ -102,30 +173,42 @@ export declare class Logger {
|
|
|
102
173
|
* Set default loglevel for the default logger.
|
|
103
174
|
*
|
|
104
175
|
* @param level The level to set
|
|
176
|
+
*
|
|
177
|
+
* @deprecated use {@link Logger.level}
|
|
105
178
|
*/
|
|
106
179
|
static set defaultLogLevel(level: LogLevel);
|
|
107
180
|
/**
|
|
108
181
|
* Get default loglevel for the default logger.
|
|
182
|
+
*
|
|
183
|
+
* @deprecated use {@link destinations}
|
|
109
184
|
*/
|
|
110
185
|
static get defaultLogLevel(): LogLevel;
|
|
111
186
|
/**
|
|
112
187
|
* Set the log function for the default logger.
|
|
113
188
|
*
|
|
114
189
|
* @param log The log function to set
|
|
190
|
+
*
|
|
191
|
+
* @deprecated use {@link destinations}
|
|
115
192
|
*/
|
|
116
193
|
static set log(log: (level: LogLevel, formattedLog: string, facility?: string) => void);
|
|
117
194
|
/**
|
|
118
195
|
* Get the log function for the default logger.
|
|
196
|
+
*
|
|
197
|
+
* @deprecated use {@link destinations}
|
|
119
198
|
*/
|
|
120
199
|
static get log(): (level: LogLevel, formattedLog: string, facility?: string) => void;
|
|
121
200
|
/**
|
|
122
201
|
* Set the log formatter for the default logger.
|
|
123
202
|
*
|
|
124
203
|
* @param logFormatter
|
|
204
|
+
*
|
|
205
|
+
* @deprecated use {@link destinations}
|
|
125
206
|
*/
|
|
126
207
|
static set logFormatter(logFormatter: (now: Date, level: LogLevel, facility: string, nestingPrefix: string, values: any[]) => string);
|
|
127
208
|
/**
|
|
128
209
|
* Get the log formatter for the default logger.
|
|
210
|
+
*
|
|
211
|
+
* @deprecated use {@link destinations}
|
|
129
212
|
*/
|
|
130
213
|
static get logFormatter(): (now: Date, level: LogLevel, facility: string, nestingPrefix: string, values: any[]) => string;
|
|
131
214
|
/**
|
|
@@ -133,6 +216,8 @@ export declare class Logger {
|
|
|
133
216
|
*
|
|
134
217
|
* @param identifier The identifier of the logger
|
|
135
218
|
* @param format the name of the formatter (see Format enum)
|
|
219
|
+
*
|
|
220
|
+
* @deprecated use {@link destinations}
|
|
136
221
|
*/
|
|
137
222
|
static setFormatForLogger(identifier: string, format: string): void;
|
|
138
223
|
/**
|
|
@@ -140,6 +225,8 @@ export declare class Logger {
|
|
|
140
225
|
*
|
|
141
226
|
* @param identifier The identifier of the logger
|
|
142
227
|
* @param level The level to set
|
|
228
|
+
*
|
|
229
|
+
* @deprecated use {@link destinations}
|
|
143
230
|
*/
|
|
144
231
|
static setDefaultLoglevelForLogger(identifier: string, level: LogLevel): void;
|
|
145
232
|
/**
|
|
@@ -147,6 +234,8 @@ export declare class Logger {
|
|
|
147
234
|
*
|
|
148
235
|
* @param identifier The identifier of the logger
|
|
149
236
|
* @param levels The levels to set
|
|
237
|
+
*
|
|
238
|
+
* @deprecated use {@link destinations}
|
|
150
239
|
*/
|
|
151
240
|
static setLogLevelsForLogger(identifier: string, levels: {
|
|
152
241
|
[facility: string]: LogLevel;
|
|
@@ -156,6 +245,8 @@ export declare class Logger {
|
|
|
156
245
|
*
|
|
157
246
|
* @param identifier The identifier of the logger
|
|
158
247
|
* @param log The log function to set
|
|
248
|
+
*
|
|
249
|
+
* @deprecated use {@link destinations}
|
|
159
250
|
*/
|
|
160
251
|
static setLogger(identifier: string, log: (level: LogLevel, formattedLog: string, facility?: string) => void): void;
|
|
161
252
|
/**
|
|
@@ -163,65 +254,25 @@ export declare class Logger {
|
|
|
163
254
|
*
|
|
164
255
|
* @param identifier The identifier of the logger
|
|
165
256
|
* @param logFormatter The log formatter to set
|
|
166
|
-
*/
|
|
167
|
-
static setLogFormatterForLogger(identifier: string, logFormatter: (now: Date, level: LogLevel, facility: string, nestingPrefix: string, values: any[]) => string): void;
|
|
168
|
-
/**
|
|
169
|
-
* Create a new facility.
|
|
170
|
-
*
|
|
171
|
-
* @param name the name of the facility
|
|
172
|
-
* @returns a new facility
|
|
173
|
-
*/
|
|
174
|
-
static get(name: string): Logger;
|
|
175
|
-
/**
|
|
176
|
-
* Stringify a value (BigInt aware) as JSON.
|
|
177
257
|
*
|
|
178
|
-
* @
|
|
179
|
-
* @returns the stringified value
|
|
258
|
+
* @deprecated use {@link destinations}
|
|
180
259
|
*/
|
|
181
|
-
static
|
|
182
|
-
/**
|
|
183
|
-
* Mask a string with a given character. If unmaskedLength is provided then these number of characters will be
|
|
184
|
-
* shown unmasked.
|
|
185
|
-
*
|
|
186
|
-
* @param str String to mask
|
|
187
|
-
* @param maskChar character to mask with
|
|
188
|
-
* @param unmaskedLength number of characters to show unmasked in the beginning
|
|
189
|
-
*/
|
|
190
|
-
static maskString(str: string, maskChar?: string, unmaskedLength?: number): string;
|
|
191
|
-
/**
|
|
192
|
-
* Perform operations in a nested logging context. Messages will be
|
|
193
|
-
* indented while the context executes.
|
|
194
|
-
*/
|
|
195
|
-
static nest<T>(context: () => T): T;
|
|
196
|
-
/**
|
|
197
|
-
* Async version of nest().
|
|
198
|
-
*/
|
|
199
|
-
static nestAsync(context: () => Promise<any>): Promise<any>;
|
|
200
|
-
/**
|
|
201
|
-
* Unhandled error reporter.
|
|
202
|
-
*
|
|
203
|
-
* Some environments do not report full error details such as {@link Error#cause} and {@link AggregateError#errors}.
|
|
204
|
-
*
|
|
205
|
-
* To ensure these details are always recorded somewhere, unhandled errors may be reported here.
|
|
206
|
-
*
|
|
207
|
-
* To disable this behavior replace this function.
|
|
208
|
-
*/
|
|
209
|
-
static reportUnhandledError(error: Error): void;
|
|
210
|
-
/**
|
|
211
|
-
* Invoke logic and return any log messages produced.
|
|
212
|
-
*/
|
|
213
|
-
static capture(fn: () => void, fromLogger?: string): {
|
|
214
|
-
level: LogLevel;
|
|
215
|
-
message: string;
|
|
216
|
-
}[];
|
|
217
|
-
constructor(name: string);
|
|
218
|
-
debug: (...values: any[]) => void;
|
|
219
|
-
info: (...values: any[]) => void;
|
|
220
|
-
notice: (...values: any[]) => void;
|
|
221
|
-
warn: (...values: any[]) => void;
|
|
222
|
-
error: (...values: any[]) => void;
|
|
223
|
-
fatal: (...values: any[]) => void;
|
|
224
|
-
log: (level: LogLevel, ...values: any[]) => void;
|
|
260
|
+
static setLogFormatterForLogger(identifier: string, logFormatter: (now: Date, level: LogLevel, facility: string, nestingPrefix: string, values: any[]) => string): void;
|
|
225
261
|
}
|
|
262
|
+
/**
|
|
263
|
+
* Definition of one registered Logger.
|
|
264
|
+
*
|
|
265
|
+
* @deprecated
|
|
266
|
+
*/
|
|
267
|
+
type LoggerDefinition = {
|
|
268
|
+
logIdentifier: string;
|
|
269
|
+
logFormatter: (now: Date, level: LogLevel, facility: string, prefix: string, values: any[]) => string;
|
|
270
|
+
log: (level: LogLevel, formattedLog: string, facility?: string) => void;
|
|
271
|
+
defaultLogLevel: LogLevel;
|
|
272
|
+
logLevels: {
|
|
273
|
+
[facility: string]: LogLevel;
|
|
274
|
+
};
|
|
275
|
+
context?: Diagnostic.Context;
|
|
276
|
+
};
|
|
226
277
|
export {};
|
|
227
278
|
//# sourceMappingURL=Logger.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../src/log/Logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../src/log/Logger.ts"],"names":[],"mappings":"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"}
|