@quatrain/log 1.1.11 → 1.2.2

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.
@@ -19,15 +19,15 @@ export declare abstract class AbstractLoggerAdapter implements LoggerType {
19
19
  protected _me: string;
20
20
  protected _logLevel: LogLevel;
21
21
  protected _logger: any;
22
- constructor(prefix?: string, level?: LogLevel);
22
+ constructor(prefix?: string, _level?: LogLevel);
23
23
  logLevel(level: LogLevel): void;
24
24
  clone(suffix: string): this;
25
- formatLogMessage: (messages: any[], loglevel?: LogLevel, tag?: string) => string;
26
- log(...messages: any[]): void;
27
- debug(...messages: any[]): void;
28
- warn(...messages: any[]): void;
29
- info(...messages: any[]): void;
30
- error(...messages: any[]): void;
31
- trace(...messages: any[]): void;
25
+ formatLogMessage: (messages: any[], _loglevel?: LogLevel, tag?: string) => string;
26
+ log(..._messages: any[]): void;
27
+ debug(..._messages: any[]): void;
28
+ warn(..._messages: any[]): void;
29
+ info(..._messages: any[]): void;
30
+ error(..._messages: any[]): void;
31
+ trace(..._messages: any[]): void;
32
32
  }
33
33
  //# sourceMappingURL=AbstractLoggerAdapter.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"AbstractLoggerAdapter.d.ts","sourceRoot":"","sources":["../src/AbstractLoggerAdapter.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IACjB,KAAK,IAAI;IACT,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,MAAM,IAAI;CACZ;AAED,MAAM,WAAW,UAAU;IACxB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,eAAO,MAAM,aAAa,UAOzB,CAAA;AAED,8BAAsB,qBAAsB,YAAW,UAAU;IAC9D,SAAS,CAAC,GAAG,EAAE,MAAM,CAAK;IAC1B,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAgB;IAC7C,SAAS,CAAC,OAAO,EAAE,GAAG,CAAY;gBAEtB,MAAM,SAAK,EAAE,KAAK,GAAE,QAAwB;IAIxD,QAAQ,CAAC,KAAK,EAAE,QAAQ;IAQxB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK3B,gBAAgB,GACb,UAAU,GAAG,EAAE,EACf,WAAU,QAAwB,EAClC,MAAK,MAAW,KAChB,MAAM,CAgBR;IAOD,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAI7B,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAI/B,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAI9B,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAI9B,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAI/B,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;CAGjC"}
1
+ {"version":3,"file":"AbstractLoggerAdapter.d.ts","sourceRoot":"","sources":["../src/AbstractLoggerAdapter.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IACjB,KAAK,IAAI;IACT,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,MAAM,IAAI;CACZ;AAED,MAAM,WAAW,UAAU;IACxB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,eAAO,MAAM,aAAa,UAOzB,CAAA;AAMD,8BAAsB,qBAAsB,YAAW,UAAU;IAC9D,SAAS,CAAC,GAAG,EAAE,MAAM,CAAK;IAC1B,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAgB;IAC7C,SAAS,CAAC,OAAO,EAAE,GAAG,CAAY;gBAEtB,MAAM,SAAK,EAAE,MAAM,GAAE,QAAwB;IASzD,QAAQ,CAAC,KAAK,EAAE,QAAQ;IAQxB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAa3B,gBAAgB,GACb,UAAU,GAAG,EAAE,EACf,YAAW,QAAwB,EACnC,MAAK,MAAW,KAChB,MAAM,CAgBR;IAOD,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI;IAS9B,KAAK,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI;IAShC,IAAI,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI;IAS/B,IAAI,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI;IAS/B,KAAK,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI;IAShC,KAAK,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI;CAGlC"}
@@ -22,7 +22,7 @@ class AbstractLoggerAdapter {
22
22
  _me = '';
23
23
  _logLevel = LogLevel.WARN;
24
24
  _logger = undefined;
25
- constructor(prefix = '', level = LogLevel.WARN) {
25
+ constructor(prefix = '', _level = LogLevel.WARN) {
26
26
  this._me = prefix;
27
27
  }
28
28
  logLevel(level) {
@@ -32,7 +32,7 @@ class AbstractLoggerAdapter {
32
32
  const newPrefix = this._me ? `${this._me}][${suffix}` : suffix;
33
33
  return new this.constructor(newPrefix, this._logLevel);
34
34
  }
35
- formatLogMessage = (messages, loglevel = LogLevel.INFO, tag = '') => {
35
+ formatLogMessage = (messages, _loglevel = LogLevel.INFO, tag = '') => {
36
36
  const flatMessages = messages.flat();
37
37
  const prefix = `${new Date().toISOString()}${tag} - [${this._me}]`;
38
38
  const strs = flatMessages.map((message) => {
@@ -46,22 +46,22 @@ class AbstractLoggerAdapter {
46
46
  });
47
47
  return `${prefix} ${strs.join(' ')}`;
48
48
  };
49
- log(...messages) {
49
+ log(..._messages) {
50
50
  throw new Error(`This method needs to be implemtend in child class`);
51
51
  }
52
- debug(...messages) {
52
+ debug(..._messages) {
53
53
  throw new Error(`This method needs to be implemtend in child class`);
54
54
  }
55
- warn(...messages) {
55
+ warn(..._messages) {
56
56
  throw new Error(`This method needs to be implemtend in child class`);
57
57
  }
58
- info(...messages) {
58
+ info(..._messages) {
59
59
  throw new Error(`This method needs to be implemtend in child class`);
60
60
  }
61
- error(...messages) {
61
+ error(..._messages) {
62
62
  throw new Error(`This method needs to be implemtend in child class`);
63
63
  }
64
- trace(...messages) {
64
+ trace(..._messages) {
65
65
  throw new Error(`This method needs to be implemtend in child class`);
66
66
  }
67
67
  }
@@ -1 +1 @@
1
- {"version":3,"file":"AbstractLoggerAdapter.js","sourceRoot":"","sources":["../src/AbstractLoggerAdapter.ts"],"names":[],"mappings":";;;AAAA,IAAY,QAOX;AAPD,WAAY,QAAQ;IACjB,yCAAS,CAAA;IACT,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,2CAAU,CAAA;AACb,CAAC,EAPW,QAAQ,wBAAR,QAAQ,QAOnB;AAWY,QAAA,aAAa,GAAG;IAC1B,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;CACV,CAAA;AAED,MAAsB,qBAAqB;IAC9B,GAAG,GAAW,EAAE,CAAA;IAChB,SAAS,GAAa,QAAQ,CAAC,IAAI,CAAA;IACnC,OAAO,GAAQ,SAAS,CAAA;IAElC,YAAY,MAAM,GAAG,EAAE,EAAE,QAAkB,QAAQ,CAAC,IAAI;QACrD,IAAI,CAAC,GAAG,GAAG,MAAM,CAAA;IACpB,CAAC;IAED,QAAQ,CAAC,KAAe;QACrB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;IACzB,CAAC;IAMD,KAAK,CAAC,MAAc;QACjB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;QAC9D,OAAO,IAAK,IAAI,CAAC,WAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IAClE,CAAC;IAED,gBAAgB,GAAG,CAChB,QAAe,EACf,WAAqB,QAAQ,CAAC,IAAI,EAClC,MAAc,EAAE,EACT,EAAE;QAET,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;QAEpC,MAAM,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,GAAG,CAAA;QAClE,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,OAAY,EAAE,EAAE;YAC5C,IAAI,OAAO,YAAY,KAAK,EAAE,CAAC;gBAC5B,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAA;YAC1C,CAAC;YACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACnD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;YACjC,CAAC;YACD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAA;QACzB,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;IACvC,CAAC,CAAA;IAOD,GAAG,CAAC,GAAG,QAAe;QACnB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACvE,CAAC;IAED,KAAK,CAAC,GAAG,QAAe;QACrB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACvE,CAAC;IAED,IAAI,CAAC,GAAG,QAAe;QACpB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACvE,CAAC;IAED,IAAI,CAAC,GAAG,QAAe;QACpB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACvE,CAAC;IAED,KAAK,CAAC,GAAG,QAAe;QACrB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACvE,CAAC;IAED,KAAK,CAAC,GAAG,QAAe;QACrB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACvE,CAAC;CACH;AAxED,sDAwEC"}
1
+ {"version":3,"file":"AbstractLoggerAdapter.js","sourceRoot":"","sources":["../src/AbstractLoggerAdapter.ts"],"names":[],"mappings":";;;AAAA,IAAY,QAOX;AAPD,WAAY,QAAQ;IACjB,yCAAS,CAAA;IACT,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,2CAAU,CAAA;AACb,CAAC,EAPW,QAAQ,wBAAR,QAAQ,QAOnB;AAWY,QAAA,aAAa,GAAG;IAC1B,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;CACV,CAAA;AAMD,MAAsB,qBAAqB;IAC9B,GAAG,GAAW,EAAE,CAAA;IAChB,SAAS,GAAa,QAAQ,CAAC,IAAI,CAAA;IACnC,OAAO,GAAQ,SAAS,CAAA;IAElC,YAAY,MAAM,GAAG,EAAE,EAAE,SAAmB,QAAQ,CAAC,IAAI;QACtD,IAAI,CAAC,GAAG,GAAG,MAAM,CAAA;IACpB,CAAC;IAOD,QAAQ,CAAC,KAAe;QACrB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;IACzB,CAAC;IAMD,KAAK,CAAC,MAAc;QACjB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;QAC9D,OAAO,IAAK,IAAI,CAAC,WAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IAClE,CAAC;IAUD,gBAAgB,GAAG,CAChB,QAAe,EACf,YAAsB,QAAQ,CAAC,IAAI,EACnC,MAAc,EAAE,EACT,EAAE;QAET,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;QAEpC,MAAM,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,GAAG,CAAA;QAClE,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,OAAY,EAAE,EAAE;YAC5C,IAAI,OAAO,YAAY,KAAK,EAAE,CAAC;gBAC5B,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAA;YAC1C,CAAC;YACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACnD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;YACjC,CAAC;YACD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAA;QACzB,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;IACvC,CAAC,CAAA;IAOD,GAAG,CAAC,GAAG,SAAgB;QACpB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACvE,CAAC;IAOD,KAAK,CAAC,GAAG,SAAgB;QACtB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACvE,CAAC;IAOD,IAAI,CAAC,GAAG,SAAgB;QACrB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACvE,CAAC;IAOD,IAAI,CAAC,GAAG,SAAgB;QACrB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACvE,CAAC;IAOD,KAAK,CAAC,GAAG,SAAgB;QACtB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACvE,CAAC;IAOD,KAAK,CAAC,GAAG,SAAgB;QACtB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACvE,CAAC;CACH;AA9GD,sDA8GC"}
@@ -1 +1 @@
1
- {"version":3,"file":"DefaultLoggerAdapter.d.ts","sourceRoot":"","sources":["../src/DefaultLoggerAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAIzE,qBAAa,oBAAqB,SAAQ,qBAAqB;gBAChD,MAAM,SAAK,EAAE,KAAK,GAAE,QAAyB;IAWzD,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,GAAE,QAAyB,GAAG,IAAI;IAuC5D,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAK/B,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,GAAG,IAAI;IAI7B,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,GAAG,IAAI;IAI5B,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,GAAG,IAAI;IAI5B,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,GAAG,IAAI;IAI7B,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,GAAG,IAAI;CAG/B"}
1
+ {"version":3,"file":"DefaultLoggerAdapter.d.ts","sourceRoot":"","sources":["../src/DefaultLoggerAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAOzE,qBAAa,oBAAqB,SAAQ,qBAAqB;gBAChD,MAAM,SAAK,EAAE,KAAK,GAAE,QAAyB;IAWzD,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,GAAE,QAAyB,GAAG,IAAI;IA4C5D,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAU/B,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,GAAG,IAAI;IAS7B,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,GAAG,IAAI;IAS5B,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,GAAG,IAAI;IAS5B,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,GAAG,IAAI;IAS7B,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,GAAG,IAAI;CAG/B"}
@@ -1 +1 @@
1
- {"version":3,"file":"DefaultLoggerAdapter.js","sourceRoot":"","sources":["../src/DefaultLoggerAdapter.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"DefaultLoggerAdapter.js","sourceRoot":"","sources":["../src/DefaultLoggerAdapter.ts"],"names":[],"mappings":";;;;;;AAAA,mEAAyE;AACzE,wDAA6B;AAC7B,kDAAyB;AAKzB,MAAa,oBAAqB,SAAQ,6CAAqB;IAC5D,YAAY,MAAM,GAAG,EAAE,EAAE,QAAkB,gCAAQ,CAAC,KAAK;QACtD,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,kBAAM,CAAA;QACrB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;IAOD,GAAG,CAAC,QAAe,EAAE,QAAkB,IAAI,CAAC,SAAS;QAClD,IAAI,GAAG,GAAG,EAAE,CAAA;QACZ,IAAI,eAAK,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YAErB,MAAM,UAAU,GAA2B;gBACxC,CAAC,gCAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;gBACzB,CAAC,gCAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;gBACzB,CAAC,gCAAQ,CAAC,IAAI,CAAC,EAAE,OAAO;gBACxB,CAAC,gCAAQ,CAAC,IAAI,CAAC,EAAE,OAAO;gBACxB,CAAC,gCAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;gBACzB,CAAC,gCAAQ,CAAC,MAAM,CAAC,EAAE,EAAE;aACvB,CAAA;YACD,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,GAAG,CAAA;QAC5C,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;QAE3D,QAAQ,KAAK,EAAE,CAAC;YACb,KAAK,gCAAQ,CAAC,KAAK;gBAChB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;gBACvC,MAAK;YACR,KAAK,gCAAQ,CAAC,KAAK;gBAChB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;gBACzC,MAAK;YACR,KAAK,gCAAQ,CAAC,IAAI;gBACf,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;gBACvC,MAAK;YACR,KAAK,gCAAQ,CAAC,IAAI;gBACf,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;gBACrC,MAAK;YACR,KAAK,gCAAQ,CAAC,KAAK;gBAChB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;gBACnD,MAAK;YACR;gBACG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;gBACzB,MAAK;QACX,CAAC;IACJ,CAAC;IAOD,QAAQ,CAAC,KAAe;QACrB,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACrB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;IAOD,KAAK,CAAC,GAAG,QAAa;QACnB,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,gCAAQ,CAAC,KAAK,CAAC,CAAA;IACrC,CAAC;IAOD,IAAI,CAAC,GAAG,QAAa;QAClB,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,gCAAQ,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IAOD,IAAI,CAAC,GAAG,QAAa;QAClB,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,gCAAQ,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IAOD,KAAK,CAAC,GAAG,QAAa;QACnB,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,gCAAQ,CAAC,KAAK,CAAC,CAAA;IACrC,CAAC;IAOD,KAAK,CAAC,GAAG,QAAa;QACnB,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,gCAAQ,CAAC,KAAK,CAAC,CAAA;IACrC,CAAC;CACH;AAzGD,oDAyGC"}
package/dist/Log.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"Log.d.ts","sourceRoot":"","sources":["../src/Log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAGzE,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,qBAAqB,IAAI;IAC3D,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAA;CAChB,CAAA;AACD,qBAAa,GAAG;IACb,MAAM,CAAC,aAAa,SAAa;IAEjC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,GAAG,CAAC,CAAK;IAGnD,MAAM,CAAC,SAAS;IAIhB,MAAM,CAAC,SAAS,CACb,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,qBAAkD,EAC1D,UAAU,GAAE,OAAe;IAU9B,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,qBAAqB,EAC7C,KAAK,GAAE,MAA2B,GAClC,CAAC;IAgBJ,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAIpC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAItC,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAIrC,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAIrC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAItC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;CAGxC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}
1
+ {"version":3,"file":"Log.d.ts","sourceRoot":"","sources":["../src/Log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAGzE,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,qBAAqB,IAAI;IAC3D,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAA;CAChB,CAAA;AAKD,qBAAa,GAAG;IAEb,MAAM,CAAC,aAAa,SAAa;IAEjC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,GAAG,CAAC,CAAK;IAQnD,MAAM,CAAC,SAAS;IAYhB,MAAM,CAAC,SAAS,CACb,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,qBAAkD,EAC1D,UAAU,GAAE,OAAe;IAgB9B,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,qBAAqB,EAC7C,KAAK,GAAE,MAA2B,GAClC,CAAC;IAgBJ,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IASpC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAStC,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IASrC,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IASrC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;IAStC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI;CAGxC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}
package/dist/Log.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"Log.js","sourceRoot":"","sources":["../src/Log.ts"],"names":[],"mappings":";;;AAAA,mEAAyE;AAwEhE,yFAxEuB,gCAAQ,OAwEvB;AAvEjB,iEAA6D;AAK7D,MAAa,GAAG;IACb,MAAM,CAAC,aAAa,GAAG,UAAU,CAAA;IAEvB,MAAM,CAAC,QAAQ,GAAwB,EAAE,CAAA;IAGnD,MAAM,CAAC,SAAS;QACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAClC,CAAC;IAED,MAAM,CAAC,SAAS,CACb,KAAa,EACb,SAAgC,IAAI,2CAAoB,EAAE,EAC1D,aAAsB,KAAK;QAE3B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,MAAM,CAAA;QAC7B,IAAI,UAAU,EAAE,CAAC;YACd,IAAI,CAAC,aAAa,GAAG,KAAK,CAAA;QAC7B,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC;IAED,MAAM,CAAC,SAAS,CACb,QAAgB,IAAI,CAAC,aAAa;QAElC,IAAI,KAAK,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,2CAAoB,EAAE,CAAA;QACzD,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC9B,CAAC;aAAM,CAAC;YACL,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,GAAG,CAAC,CAAA;QACtD,CAAC;IACJ,CAAC;IAMD,MAAM,CAAC,GAAG,CAAC,GAAG,QAAe;QAC1B,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,QAAe;QAC5B,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC5C,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,QAAe;QAC3B,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,QAAe;QAC3B,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,QAAe;QAC5B,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC5C,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,QAAe;QAC5B,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC5C,CAAC;;AA/DJ,kBAgEC"}
1
+ {"version":3,"file":"Log.js","sourceRoot":"","sources":["../src/Log.ts"],"names":[],"mappings":";;;AAAA,mEAAyE;AAyHhE,yFAzHuB,gCAAQ,OAyHvB;AAxHjB,iEAA6D;AAS7D,MAAa,GAAG;IAEb,MAAM,CAAC,aAAa,GAAG,UAAU,CAAA;IAEvB,MAAM,CAAC,QAAQ,GAAwB,EAAE,CAAA;IAQnD,MAAM,CAAC,SAAS;QACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAClC,CAAC;IAUD,MAAM,CAAC,SAAS,CACb,KAAa,EACb,SAAgC,IAAI,2CAAoB,EAAE,EAC1D,aAAsB,KAAK;QAE3B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,MAAM,CAAA;QAC7B,IAAI,UAAU,EAAE,CAAC;YACd,IAAI,CAAC,aAAa,GAAG,KAAK,CAAA;QAC7B,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC;IAQD,MAAM,CAAC,SAAS,CACb,QAAgB,IAAI,CAAC,aAAa;QAElC,IAAI,KAAK,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,2CAAoB,EAAE,CAAA;QACzD,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC9B,CAAC;aAAM,CAAC;YACL,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,GAAG,CAAC,CAAA;QACtD,CAAC;IACJ,CAAC;IAMD,MAAM,CAAC,GAAG,CAAC,GAAG,QAAe;QAC1B,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC1C,CAAC;IAOD,MAAM,CAAC,KAAK,CAAC,GAAG,QAAe;QAC5B,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC5C,CAAC;IAOD,MAAM,CAAC,IAAI,CAAC,GAAG,QAAe;QAC3B,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC3C,CAAC;IAOD,MAAM,CAAC,IAAI,CAAC,GAAG,QAAe;QAC3B,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC3C,CAAC;IAOD,MAAM,CAAC,KAAK,CAAC,GAAG,QAAe;QAC5B,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC5C,CAAC;IAOD,MAAM,CAAC,KAAK,CAAC,GAAG,QAAe;QAC5B,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAA;IAC5C,CAAC;;AA5GJ,kBA6GC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@quatrain/log",
3
- "version": "1.1.11",
3
+ "version": "1.2.2",
4
4
  "description": "Logger for business apps",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -38,5 +38,8 @@
38
38
  "build": "tsc",
39
39
  "wbuild": "tsc --watch",
40
40
  "bump-to": "yarn version"
41
+ },
42
+ "typedoc": {
43
+ "entryPoint": "src/index.ts"
41
44
  }
42
45
  }
@@ -25,15 +25,24 @@ export const loglevelNames = [
25
25
  'SILENT',
26
26
  ]
27
27
 
28
+ /**
29
+ * Base abstraction for creating custom logging adapters.
30
+ * Ensures consistent log levels and signature formats across implementations.
31
+ */
28
32
  export abstract class AbstractLoggerAdapter implements LoggerType {
29
33
  protected _me: string = ''
30
34
  protected _logLevel: LogLevel = LogLevel.WARN
31
35
  protected _logger: any = undefined
32
36
 
33
- constructor(prefix = '', level: LogLevel = LogLevel.WARN) {
37
+ constructor(prefix = '', _level: LogLevel = LogLevel.WARN) {
34
38
  this._me = prefix
35
39
  }
36
40
 
41
+ /**
42
+ * Overrides the current log verbosity level.
43
+ *
44
+ * @param level - The target LogLevel enum.
45
+ */
37
46
  logLevel(level: LogLevel) {
38
47
  this._logLevel = level
39
48
  }
@@ -47,9 +56,17 @@ export abstract class AbstractLoggerAdapter implements LoggerType {
47
56
  return new (this.constructor as any)(newPrefix, this._logLevel)
48
57
  }
49
58
 
59
+ /**
60
+ * Safely stringifies and combines all parts of a log payload into a single string.
61
+ *
62
+ * @param messages - Array of items to log.
63
+ * @param _loglevel - Severity of the log.
64
+ * @param tag - A specific label for the line.
65
+ * @returns Formatted output string.
66
+ */
50
67
  formatLogMessage = (
51
68
  messages: any[],
52
- loglevel: LogLevel = LogLevel.INFO,
69
+ _loglevel: LogLevel = LogLevel.INFO,
53
70
  tag: string = ''
54
71
  ): string => {
55
72
  // Flatten nested arrays (from rest parameter spreading)
@@ -74,27 +91,52 @@ export abstract class AbstractLoggerAdapter implements LoggerType {
74
91
  * @param message string | object
75
92
  * @param level string
76
93
  */
77
- log(...messages: any[]): void {
94
+ log(..._messages: any[]): void {
78
95
  throw new Error(`This method needs to be implemtend in child class`)
79
96
  }
80
97
 
81
- debug(...messages: any[]): void {
98
+ /**
99
+ * Trigger a debug-level log.
100
+ *
101
+ * @param _messages - Items to log.
102
+ */
103
+ debug(..._messages: any[]): void {
82
104
  throw new Error(`This method needs to be implemtend in child class`)
83
105
  }
84
106
 
85
- warn(...messages: any[]): void {
107
+ /**
108
+ * Trigger a warn-level log.
109
+ *
110
+ * @param _messages - Items to log.
111
+ */
112
+ warn(..._messages: any[]): void {
86
113
  throw new Error(`This method needs to be implemtend in child class`)
87
114
  }
88
115
 
89
- info(...messages: any[]): void {
116
+ /**
117
+ * Trigger an info-level log.
118
+ *
119
+ * @param _messages - Items to log.
120
+ */
121
+ info(..._messages: any[]): void {
90
122
  throw new Error(`This method needs to be implemtend in child class`)
91
123
  }
92
124
 
93
- error(...messages: any[]): void {
125
+ /**
126
+ * Trigger an error-level log.
127
+ *
128
+ * @param _messages - Items to log.
129
+ */
130
+ error(..._messages: any[]): void {
94
131
  throw new Error(`This method needs to be implemtend in child class`)
95
132
  }
96
133
 
97
- trace(...messages: any[]): void {
134
+ /**
135
+ * Trigger a trace-level log.
136
+ *
137
+ * @param _messages - Items to log.
138
+ */
139
+ trace(..._messages: any[]): void {
98
140
  throw new Error(`This method needs to be implemtend in child class`)
99
141
  }
100
142
  }
@@ -2,6 +2,9 @@ import { AbstractLoggerAdapter, LogLevel } from './AbstractLoggerAdapter'
2
2
  import logger from 'loglevel'
3
3
  import chalk from 'chalk'
4
4
 
5
+ /**
6
+ * Default internal implementation relying on `loglevel` and `chalk` for colored console outputs.
7
+ */
5
8
  export class DefaultLoggerAdapter extends AbstractLoggerAdapter {
6
9
  constructor(prefix = '', level: LogLevel = LogLevel.DEBUG) {
7
10
  super(prefix, level)
@@ -53,27 +56,57 @@ export class DefaultLoggerAdapter extends AbstractLoggerAdapter {
53
56
  }
54
57
  }
55
58
 
59
+ /**
60
+ * Updates the logger to a new verbosity log level.
61
+ *
62
+ * @param level - The target LogLevel enum.
63
+ */
56
64
  logLevel(level: LogLevel): void {
57
65
  super.logLevel(level)
58
66
  this._logger.setLevel(level)
59
67
  }
60
68
 
69
+ /**
70
+ * Debug level shortcut.
71
+ *
72
+ * @param messages - Variadic payload.
73
+ */
61
74
  debug(...messages: any): void {
62
75
  this.log(messages, LogLevel.DEBUG)
63
76
  }
64
77
 
78
+ /**
79
+ * Warning level shortcut.
80
+ *
81
+ * @param messages - Variadic payload.
82
+ */
65
83
  warn(...messages: any): void {
66
84
  this.log(messages, LogLevel.WARN)
67
85
  }
68
86
 
87
+ /**
88
+ * Info level shortcut.
89
+ *
90
+ * @param messages - Variadic payload.
91
+ */
69
92
  info(...messages: any): void {
70
93
  this.log(messages, LogLevel.INFO)
71
94
  }
72
95
 
96
+ /**
97
+ * Error level shortcut.
98
+ *
99
+ * @param messages - Variadic payload.
100
+ */
73
101
  error(...messages: any): void {
74
102
  this.log(messages, LogLevel.ERROR)
75
103
  }
76
104
 
105
+ /**
106
+ * Trace level shortcut.
107
+ *
108
+ * @param messages - Variadic payload.
109
+ */
77
110
  trace(...messages: any): void {
78
111
  this.log(messages, LogLevel.TRACE)
79
112
  }
package/src/Log.ts CHANGED
@@ -4,16 +4,34 @@ import { DefaultLoggerAdapter } from './DefaultLoggerAdapter'
4
4
  export type LoggerRegistry<T extends AbstractLoggerAdapter> = {
5
5
  [x: string]: T
6
6
  }
7
+ /**
8
+ * Global static registry and entrypoint for logging in Quatrain.
9
+ * Manages instantiated logger adapters.
10
+ */
7
11
  export class Log {
12
+ /** Alias for the active default logger. */
8
13
  static defaultLogger = '@default'
9
14
 
10
15
  protected static _loggers: LoggerRegistry<any> = {}
11
16
 
12
17
  // How timestamp are formatted
18
+ /**
19
+ * Centralized formatting for log timestamps.
20
+ *
21
+ * @returns The ISO date string.
22
+ */
13
23
  static timestamp() {
14
24
  return new Date().toISOString()
15
25
  }
16
26
 
27
+ /**
28
+ * Registers a new initialized logger context within the singleton context.
29
+ *
30
+ * @param alias - Short identifier name.
31
+ * @param logger - The concrete logger instance.
32
+ * @param setDefault - Makes this instance the new default target.
33
+ * @returns The newly added logger.
34
+ */
17
35
  static addLogger(
18
36
  alias: string,
19
37
  logger: AbstractLoggerAdapter = new DefaultLoggerAdapter(),
@@ -27,6 +45,12 @@ export class Log {
27
45
  return this._loggers[alias]
28
46
  }
29
47
 
48
+ /**
49
+ * Looks up an existing logger by alias.
50
+ *
51
+ * @param alias - Required name.
52
+ * @returns The located Logger adapter.
53
+ */
30
54
  static getLogger<T extends AbstractLoggerAdapter>(
31
55
  alias: string = this.defaultLogger
32
56
  ): T {
@@ -49,22 +73,47 @@ export class Log {
49
73
  return Log.getLogger().log(...messages)
50
74
  }
51
75
 
76
+ /**
77
+ * Delegate debug call to the default logger.
78
+ *
79
+ * @param messages - Variadic arguments to log.
80
+ */
52
81
  static debug(...messages: any[]): void {
53
82
  return Log.getLogger().debug(...messages)
54
83
  }
55
84
 
85
+ /**
86
+ * Delegate warning call to the default logger.
87
+ *
88
+ * @param messages - Variadic arguments to log.
89
+ */
56
90
  static warn(...messages: any[]): void {
57
91
  return Log.getLogger().warn(...messages)
58
92
  }
59
93
 
94
+ /**
95
+ * Delegate info call to the default logger.
96
+ *
97
+ * @param messages - Variadic arguments to log.
98
+ */
60
99
  static info(...messages: any[]): void {
61
100
  return Log.getLogger().info(...messages)
62
101
  }
63
102
 
103
+ /**
104
+ * Delegate error call to the default logger.
105
+ *
106
+ * @param messages - Variadic arguments to log.
107
+ */
64
108
  static error(...messages: any[]): void {
65
109
  return Log.getLogger().error(...messages)
66
110
  }
67
111
 
112
+ /**
113
+ * Delegate trace call to the default logger.
114
+ *
115
+ * @param messages - Variadic arguments to log.
116
+ */
68
117
  static trace(...messages: any[]): void {
69
118
  return Log.getLogger().trace(...messages)
70
119
  }