@adapt-arch/utiliti-es 0.1.0

package/dist/bundle/utiliti-es.js

@@ -0,0 +1,475 @@
+var u = Object.defineProperty;
+var h = (t, e, s) => e in t ? u(t, e, { enumerable: !0, configurable: !0, writable: !0, value: s }) : t[e] = s;
+var r = (t, e, s) => (h(t, typeof e != "symbol" ? e + "" : e, s), s);
+class g {
+  constructor() {
+    r(this, "_subscriptions", /* @__PURE__ */ new Map());
+  }
+  /** @inheritdoc */
+  publish(e, s) {
+    if (!e)
+      throw new Error("Invalid topic.");
+    if (!s)
+      throw new Error("Invalid message.");
+    const i = this._subscriptions.get(e);
+    if (i)
+      for (const n of i.values()) {
+        const a = structuredClone(e), l = structuredClone(s);
+        setTimeout(() => n(a, l), 0);
+      }
+  }
+  /** @inheritdoc */
+  subscribe(e, s) {
+    if (!e)
+      throw new Error("Invalid topic.");
+    if (!s)
+      throw new Error("Invalid handler.");
+    let i = this._subscriptions.get(e);
+    i || (i = /* @__PURE__ */ new Map(), this._subscriptions.set(structuredClone(e), i));
+    const n = `sub-${Date.now()}`;
+    return i.set(n, s), n;
+  }
+  /** @inheritdoc */
+  unsubscribe(e) {
+    if (e) {
+      for (const s of this._subscriptions.values())
+        if (s.delete(e))
+          return;
+    }
+  }
+}
+function m(t = 1, e) {
+  return new Promise((s, i) => {
+    setTimeout(() => {
+      e ? i(e) : s();
+    }, t);
+  });
+}
+class p {
+  /**
+   * Constructor.
+   *
+   * @param {ExtraParams} values The values to add to the log.
+   * @param {boolean} overrideExisting Override a value if it already exists.
+   */
+  constructor(e, s) {
+    r(this, "_values");
+    r(this, "_overrideExisting");
+    this._values = e, this._overrideExisting = s;
+  }
+  /**
+   * @inheritdoc
+   */
+  enrich(e) {
+    if (!this._values)
+      return;
+    e.extraParams = e.extraParams || {};
+    const s = Object.keys(e.extraParams);
+    for (const i in this._values)
+      s.indexOf(i) !== -1 && !this._overrideExisting || (e.extraParams[i] = this._values[i]);
+  }
+}
+class f {
+  /**
+   * Constructor.
+   *
+   * @param {DynamicValuesFunction} valuesFunction The values to add to the log.
+   * @param {boolean} overrideExisting Override a value if it already exists.
+   */
+  constructor(e, s) {
+    r(this, "_valuesFn");
+    r(this, "_overrideExisting");
+    this._valuesFn = e, this._overrideExisting = s;
+  }
+  /**
+   * @inheritdoc
+   */
+  enrich(e) {
+    const s = typeof this._valuesFn == "function" ? this._valuesFn() : void 0;
+    if (!s)
+      return;
+    e.extraParams = e.extraParams || {};
+    const i = Object.keys(e.extraParams);
+    for (const n in s)
+      i.indexOf(n) !== -1 && !this._overrideExisting || (e.extraParams[n] = s[n]);
+  }
+}
+var o;
+(function(t) {
+  t[t.Trace = 0] = "Trace", t[t.Debug = 1] = "Debug", t[t.Information = 2] = "Information", t[t.Warning = 3] = "Warning", t[t.Error = 4] = "Error", t[t.Critical = 5] = "Critical", t[t.None = 6] = "None";
+})(o || (o = {}));
+class c {
+  constructor() {
+    /**
+     * The timestamp of the log message.
+     */
+    r(this, "timestamp", (/* @__PURE__ */ new Date()).getTime());
+    /**
+     * The level of the log message.
+     */
+    r(this, "level", o.None);
+    /**
+     * The name of the logger.
+     */
+    r(this, "name", "");
+    /**
+     * The message to log.
+     */
+    r(this, "message", "");
+    /**
+     * The error message.
+     */
+    r(this, "errorMessage");
+    /**
+     * The stack trace of the error.
+     */
+    r(this, "stackTrace");
+    /**
+     * Any extra parameters to log.
+     */
+    r(this, "extraParams");
+  }
+}
+class d {
+  /**
+   * Constructor.
+   *
+   * @param {Console} console The current console reference.
+   */
+  constructor(e) {
+    r(this, "_console");
+    this._console = e;
+  }
+  /**
+   * @inheritdoc
+   */
+  register(e) {
+    let s;
+    if (this._console)
+      switch (e.level) {
+        case o.Trace:
+          s = this._console.trace || this._console.log;
+          break;
+        case o.Debug:
+          s = this._console.debug || this._console.log;
+          break;
+        case o.Information:
+          s = this._console.info || this._console.log;
+          break;
+        case o.Warning:
+          s = this._console.warn || this._console.log;
+          break;
+        case o.Error:
+          s = this._console.error || this._console.log;
+          break;
+        case o.Critical:
+          s = this._console.error || this._console.log;
+          break;
+        default:
+          s = null;
+          break;
+      }
+    typeof s == "function" && s.call(this._console, e.message, e);
+  }
+  /**
+   * @inheritdoc
+   */
+  [Symbol.asyncDispose]() {
+    return Promise.resolve();
+  }
+}
+class b {
+  constructor() {
+    /**
+     * Endpoint that receives the logs.
+     */
+    r(this, "endpoint", "");
+    /**
+     * HTTP verb used when calling the endpoint.
+     */
+    r(this, "verb", "POST");
+    /**
+     * The number of items to send in a batch.
+     */
+    r(this, "batchSize", 20);
+    /**
+     * The maximum interval, in milliseconds, to wait for the batch size to be achieved before reporting.
+     */
+    r(this, "interval", 2e3);
+    /**
+     * A function that can be used to transform the request before sending it.
+     */
+    r(this, "requestTransform");
+  }
+}
+class w {
+  constructor(e) {
+    r(this, "_messageQueue");
+    r(this, "_options");
+    r(this, "_reportActionTimeoutRef");
+    r(this, "_reportActionPromise");
+    r(this, "_disposed");
+    if (!e)
+      throw new Error('Argument "options" is required');
+    this._messageQueue = [], this._options = e, this._reportActionTimeoutRef = void 0, this._reportActionPromise = null, this._disposed = !1;
+  }
+  /**
+   * @inheritdoc
+   */
+  register(e) {
+    this._disposed || (this._messageQueue.push(e), this._scheduleNextProcessAction());
+  }
+  /**
+   * @inheritdoc
+   */
+  async [Symbol.asyncDispose]() {
+    if (this._disposed)
+      return Promise.resolve();
+    await (this._reportActionPromise ?? this._processMessages()), this._disposed = !0;
+  }
+  _scheduleNextProcessAction() {
+    if (this._reportActionTimeoutRef)
+      return;
+    const e = this._messageQueue.length >= this._options.batchSize ? 0 : this._options.interval;
+    this._reportActionTimeoutRef = setTimeout(() => {
+      this._reportActionPromise = this._processMessages().then(() => {
+        const s = this._reportActionTimeoutRef;
+        this._reportActionTimeoutRef = void 0, clearTimeout(s), this._reportActionPromise = null, this._scheduleNextProcessAction();
+      });
+    }, e);
+  }
+  async _processMessages() {
+    let e, s;
+    for (; this._messageQueue.length > 0; )
+      if (e = this._messageQueue.splice(0, Math.min(this._messageQueue.length, this._options.batchSize)), s = await this._sendMessagesBatch(e), !s) {
+        this._messageQueue.unshift(...e);
+        return;
+      }
+  }
+  _sendMessagesBatch(e) {
+    return new Promise((s) => {
+      const i = () => {
+        s(!1);
+      }, n = new XMLHttpRequest();
+      n.open(this._options.verb, this._options.endpoint), n.setRequestHeader("Content-Type", "application/json;charset=UTF-8"), this._options.requestTransform && this._options.requestTransform(n), n.onload = function() {
+        s(this.status >= 200 && this.status < 300);
+      }, n.onerror = i, n.onabort = i, n.send(JSON.stringify(e));
+    });
+  }
+}
+class v {
+  constructor() {
+    r(this, "_messages", []);
+  }
+  get messages() {
+    return this._messages.slice();
+  }
+  /**
+   * @inheritdoc
+   */
+  register(e) {
+    this._messages.push(e);
+  }
+  /**
+   * @inheritdoc
+   */
+  [Symbol.asyncDispose]() {
+    return Promise.resolve();
+  }
+}
+class y {
+  constructor(e) {
+    r(this, "_reporters");
+    this._reporters = e || [];
+  }
+  /**
+   * @inheritdoc
+   */
+  register(e) {
+    for (const s of this._reporters)
+      s.register(e);
+  }
+  /**
+   * @inheritdoc
+   */
+  async [Symbol.asyncDispose]() {
+    const e = new Array();
+    for (const s of this._reporters)
+      e.push(s[Symbol.asyncDispose]());
+    e.length && await Promise.all(e);
+  }
+}
+class T {
+  /**
+   * Constructor.
+   *
+   * @param {LoggerOptions} options The logger options.
+   */
+  constructor(e) {
+    r(this, "_options");
+    this._options = e;
+  }
+  /**
+   * The core logging method.
+   *
+   * @param {LogMessage} message The message to log.
+   */
+  logMessageCore(e) {
+    var s;
+    e.name = this._options.name;
+    for (const i of this._options.enrichers)
+      i.enrich(e);
+    (s = this._options.reporter) == null || s.register(e);
+  }
+  /**
+   * @inheritdoc
+   */
+  async [Symbol.asyncDispose]() {
+    var e;
+    await ((e = this._options.reporter) == null ? void 0 : e[Symbol.asyncDispose]());
+  }
+  /**
+   * Indicates if the specified level will be logged.
+   *
+   * @param {LogLevel} level The log level.
+   */
+  isEnabled(e) {
+    return e !== o.None && e >= this._options.minimumLevel;
+  }
+  /**
+   * Log trace.
+   *
+   * @param msg The message to log.
+   */
+  trace(e) {
+    const s = new c();
+    s.level = o.Trace, s.message = e, this.logMessage(s);
+  }
+  /**
+   * Log debug.
+   *
+   * @param msg The message to log.
+   */
+  debug(e) {
+    const s = new c();
+    s.level = o.Debug, s.message = e, this.logMessage(s);
+  }
+  /**
+   * Log information.
+   *
+   * @param msg The message to log.
+   */
+  info(e) {
+    const s = new c();
+    s.level = o.Information, s.message = e, this.logMessage(s);
+  }
+  /**
+   * Log warning.
+   *
+   * @param msg The message to log.
+   */
+  warn(e) {
+    const s = new c();
+    s.level = o.Warning, s.message = e, this.logMessage(s);
+  }
+  /**
+   * Log error.
+   *
+   * @param msg The message to log.
+   */
+  error(e) {
+    const s = new c();
+    s.level = o.Error, s.message = e, this.logMessage(s);
+  }
+  /**
+   * Log error.
+   *
+   * @param msg The message to log.
+   */
+  crit(e) {
+    const s = new c();
+    s.level = o.Critical, s.message = e, this.logMessage(s);
+  }
+  /**
+   * Log an event.
+   *
+   * @param {LogLevel} level The level to log the event.
+   * @param {String} message Custom message.
+   * @param {Error} e The error associated with the event.
+   * @param {ExtraParams} params Extra parameters.
+   */
+  log(e, s, i, n) {
+    const a = new c();
+    a.level = e, a.message = s, a.errorMessage = i == null ? void 0 : i.message, a.stackTrace = i == null ? void 0 : i.stack, a.extraParams = n, this.logMessage(a);
+  }
+  /**
+   * Log a message.
+   *
+   * @param {LogMessage} message The message to log.
+   */
+  logMessage(e) {
+    this.isEnabled(e.level) && setTimeout(() => {
+      this.logMessageCore(e);
+    }, 1);
+  }
+}
+class M {
+  constructor() {
+    /**
+     * The name of the logger.
+     */
+    r(this, "name", "");
+    /**
+     * The reporter for the messages.
+     */
+    r(this, "reporter", null);
+    /**
+     * The minimum log level.
+     */
+    r(this, "minimumLevel", o.Warning);
+    /**
+     * Log enrichers.
+     */
+    r(this, "enrichers", []);
+  }
+  /**
+   * Get the LogLevel from a string value.
+   *
+   * @param {String} level The log level as string.
+   */
+  static getLevel(e) {
+    switch ((e || "").toUpperCase()) {
+      case "TRACE":
+        return o.Trace;
+      case "DEBUG":
+        return o.Debug;
+      case "INFORMATION":
+        return o.Information;
+      case "WARNING":
+        return o.Warning;
+      case "ERROR":
+        return o.Error;
+      case "CRITICAL":
+        return o.Critical;
+      case "NONE":
+        return o.None;
+      default:
+        return o.None;
+    }
+  }
+}
+export {
+  d as ConsoleReporter,
+  f as DynamicValuesEnricher,
+  v as InMemoryReporter,
+  o as LogLevel,
+  c as LogMessage,
+  T as Logger,
+  M as LoggerOptions,
+  y as MultipleReporter,
+  g as PubSubHub,
+  p as ValuesEnricher,
+  w as XhrReporter,
+  b as XhrReporterOptions,
+  m as delay
+};

package/dist/bundle/utiliti-es.umd.cjs

@@ -0,0 +1 @@
+(function(t,a){typeof exports=="object"&&typeof module<"u"?a(exports):typeof define=="function"&&define.amd?define(["exports"],a):(t=typeof globalThis<"u"?globalThis:t||self,a(t.adaptArch_utilitiEs={}))})(this,function(t){"use strict";var L=Object.defineProperty;var w=(t,a,u)=>a in t?L(t,a,{enumerable:!0,configurable:!0,writable:!0,value:u}):t[a]=u;var r=(t,a,u)=>(w(t,typeof a!="symbol"?a+"":a,u),u);class a{constructor(){r(this,"_subscriptions",new Map)}publish(e,s){if(!e)throw new Error("Invalid topic.");if(!s)throw new Error("Invalid message.");const o=this._subscriptions.get(e);if(o)for(const n of o.values()){const l=structuredClone(e),y=structuredClone(s);setTimeout(()=>n(l,y),0)}}subscribe(e,s){if(!e)throw new Error("Invalid topic.");if(!s)throw new Error("Invalid handler.");let o=this._subscriptions.get(e);o||(o=new Map,this._subscriptions.set(structuredClone(e),o));const n=`sub-${Date.now()}`;return o.set(n,s),n}unsubscribe(e){if(e){for(const s of this._subscriptions.values())if(s.delete(e))return}}}function u(i=1,e){return new Promise((s,o)=>{setTimeout(()=>{e?o(e):s()},i)})}class h{constructor(e,s){r(this,"_values");r(this,"_overrideExisting");this._values=e,this._overrideExisting=s}enrich(e){if(!this._values)return;e.extraParams=e.extraParams||{};const s=Object.keys(e.extraParams);for(const o in this._values)s.indexOf(o)!==-1&&!this._overrideExisting||(e.extraParams[o]=this._values[o])}}class g{constructor(e,s){r(this,"_valuesFn");r(this,"_overrideExisting");this._valuesFn=e,this._overrideExisting=s}enrich(e){const s=typeof this._valuesFn=="function"?this._valuesFn():void 0;if(!s)return;e.extraParams=e.extraParams||{};const o=Object.keys(e.extraParams);for(const n in s)o.indexOf(n)!==-1&&!this._overrideExisting||(e.extraParams[n]=s[n])}}t.LogLevel=void 0,function(i){i[i.Trace=0]="Trace",i[i.Debug=1]="Debug",i[i.Information=2]="Information",i[i.Warning=3]="Warning",i[i.Error=4]="Error",i[i.Critical=5]="Critical",i[i.None=6]="None"}(t.LogLevel||(t.LogLevel={}));class c{constructor(){r(this,"timestamp",new Date().getTime());r(this,"level",t.LogLevel.None);r(this,"name","");r(this,"message","");r(this,"errorMessage");r(this,"stackTrace");r(this,"extraParams")}}class _{constructor(e){r(this,"_console");this._console=e}register(e){let s;if(this._console)switch(e.level){case t.LogLevel.Trace:s=this._console.trace||this._console.log;break;case t.LogLevel.Debug:s=this._console.debug||this._console.log;break;case t.LogLevel.Information:s=this._console.info||this._console.log;break;case t.LogLevel.Warning:s=this._console.warn||this._console.log;break;case t.LogLevel.Error:s=this._console.error||this._console.log;break;case t.LogLevel.Critical:s=this._console.error||this._console.log;break;default:s=null;break}typeof s=="function"&&s.call(this._console,e.message,e)}[Symbol.asyncDispose](){return Promise.resolve()}}class m{constructor(){r(this,"endpoint","");r(this,"verb","POST");r(this,"batchSize",20);r(this,"interval",2e3);r(this,"requestTransform")}}class f{constructor(e){r(this,"_messageQueue");r(this,"_options");r(this,"_reportActionTimeoutRef");r(this,"_reportActionPromise");r(this,"_disposed");if(!e)throw new Error('Argument "options" is required');this._messageQueue=[],this._options=e,this._reportActionTimeoutRef=void 0,this._reportActionPromise=null,this._disposed=!1}register(e){this._disposed||(this._messageQueue.push(e),this._scheduleNextProcessAction())}async[Symbol.asyncDispose](){if(this._disposed)return Promise.resolve();await(this._reportActionPromise??this._processMessages()),this._disposed=!0}_scheduleNextProcessAction(){if(this._reportActionTimeoutRef)return;const e=this._messageQueue.length>=this._options.batchSize?0:this._options.interval;this._reportActionTimeoutRef=setTimeout(()=>{this._reportActionPromise=this._processMessages().then(()=>{const s=this._reportActionTimeoutRef;this._reportActionTimeoutRef=void 0,clearTimeout(s),this._reportActionPromise=null,this._scheduleNextProcessAction()})},e)}async _processMessages(){let e,s;for(;this._messageQueue.length>0;)if(e=this._messageQueue.splice(0,Math.min(this._messageQueue.length,this._options.batchSize)),s=await this._sendMessagesBatch(e),!s){this._messageQueue.unshift(...e);return}}_sendMessagesBatch(e){return new Promise(s=>{const o=()=>{s(!1)},n=new XMLHttpRequest;n.open(this._options.verb,this._options.endpoint),n.setRequestHeader("Content-Type","application/json;charset=UTF-8"),this._options.requestTransform&&this._options.requestTransform(n),n.onload=function(){s(this.status>=200&&this.status<300)},n.onerror=o,n.onabort=o,n.send(JSON.stringify(e))})}}class d{constructor(){r(this,"_messages",[])}get messages(){return this._messages.slice()}register(e){this._messages.push(e)}[Symbol.asyncDispose](){return Promise.resolve()}}class p{constructor(e){r(this,"_reporters");this._reporters=e||[]}register(e){for(const s of this._reporters)s.register(e)}async[Symbol.asyncDispose](){const e=new Array;for(const s of this._reporters)e.push(s[Symbol.asyncDispose]());e.length&&await Promise.all(e)}}class v{constructor(e){r(this,"_options");this._options=e}logMessageCore(e){var s;e.name=this._options.name;for(const o of this._options.enrichers)o.enrich(e);(s=this._options.reporter)==null||s.register(e)}async[Symbol.asyncDispose](){var e;await((e=this._options.reporter)==null?void 0:e[Symbol.asyncDispose]())}isEnabled(e){return e!==t.LogLevel.None&&e>=this._options.minimumLevel}trace(e){const s=new c;s.level=t.LogLevel.Trace,s.message=e,this.logMessage(s)}debug(e){const s=new c;s.level=t.LogLevel.Debug,s.message=e,this.logMessage(s)}info(e){const s=new c;s.level=t.LogLevel.Information,s.message=e,this.logMessage(s)}warn(e){const s=new c;s.level=t.LogLevel.Warning,s.message=e,this.logMessage(s)}error(e){const s=new c;s.level=t.LogLevel.Error,s.message=e,this.logMessage(s)}crit(e){const s=new c;s.level=t.LogLevel.Critical,s.message=e,this.logMessage(s)}log(e,s,o,n){const l=new c;l.level=e,l.message=s,l.errorMessage=o==null?void 0:o.message,l.stackTrace=o==null?void 0:o.stack,l.extraParams=n,this.logMessage(l)}logMessage(e){this.isEnabled(e.level)&&setTimeout(()=>{this.logMessageCore(e)},1)}}class b{constructor(){r(this,"name","");r(this,"reporter",null);r(this,"minimumLevel",t.LogLevel.Warning);r(this,"enrichers",[])}static getLevel(e){switch((e||"").toUpperCase()){case"TRACE":return t.LogLevel.Trace;case"DEBUG":return t.LogLevel.Debug;case"INFORMATION":return t.LogLevel.Information;case"WARNING":return t.LogLevel.Warning;case"ERROR":return t.LogLevel.Error;case"CRITICAL":return t.LogLevel.Critical;case"NONE":return t.LogLevel.None;default:return t.LogLevel.None}}}t.ConsoleReporter=_,t.DynamicValuesEnricher=g,t.InMemoryReporter=d,t.LogMessage=c,t.Logger=v,t.LoggerOptions=b,t.MultipleReporter=p,t.PubSubHub=a,t.ValuesEnricher=h,t.XhrReporter=f,t.XhrReporterOptions=m,t.delay=u,Object.defineProperty(t,Symbol.toStringTag,{value:"Module"})});

package/dist/common/contracts.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SerializableValues is a type that represents common values that can be serialized as JSON in most languages.
+ */
+export type SerializableValues = string | number | boolean | null | Date | Array<SerializableValues> | {
+    [key: string]: SerializableValues;
+};

package/dist/common/contracts.js

@@ -0,0 +1 @@
+export {};

package/dist/common/index.d.ts

@@ -0,0 +1 @@
+export { type SerializableValues } from "./contracts";

package/dist/common/index.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./pubsub/index";
+export * from "./utils/index";
+export * from "./common";
+export * from "./logger";

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./pubsub/index";
+export * from "./utils/index";
+export * from "./common";
+export * from "./logger";

package/dist/logger/contracts.d.ts

@@ -0,0 +1,95 @@
+import type { SerializableValues } from "../common";
+/**
+ * Log level
+ */
+export declare enum LogLevel {
+    /**
+     * Logs that contain the most detailed messages. These messages may contain sensitive application data. These messages are disabled by default and should never be enabled in a production environment.
+     */
+    Trace = 0,
+    /**
+     * Logs that are used for interactive investigation during development. These logs should primarily contain information useful for debugging and have no long-term value.
+     */
+    Debug = 1,
+    /**
+     * Logs that track the general flow of the application. These logs should have long-term value.
+     */
+    Information = 2,
+    /**
+     * Logs that highlight an abnormal or unexpected event in the application flow, but do not otherwise cause the application execution to stop.
+     */
+    Warning = 3,
+    /**
+     * Logs that highlight when the current flow of execution is stopped due to a failure. These should indicate a failure in the current activity, not an application-wide failure.
+     */
+    Error = 4,
+    /**
+     * Logs that describe an unrecoverable application or system crash, or a catastrophic failure that requires immediate attention.
+     */
+    Critical = 5,
+    /**
+     * Not used for writing log messages. Specifies that a logging category should not write any messages.
+     */
+    None = 6
+}
+/**
+ * Extra parameters to log.
+ */
+export type ExtraParams = {
+    [id: string]: SerializableValues;
+};
+/**
+ * Base logging message
+ */
+export declare class LogMessage {
+    /**
+     * The timestamp of the log message.
+     */
+    timestamp: number;
+    /**
+     * The level of the log message.
+     */
+    level: LogLevel;
+    /**
+     * The name of the logger.
+     */
+    name: string;
+    /**
+     * The message to log.
+     */
+    message: string;
+    /**
+     * The error message.
+     */
+    errorMessage?: string;
+    /**
+     * The stack trace of the error.
+     */
+    stackTrace?: string;
+    /**
+     * Any extra parameters to log.
+     */
+    extraParams?: ExtraParams;
+}
+/**
+ * Contract for the component responsible for reporting the logs.
+ */
+export interface ILogsReporter extends AsyncDisposable {
+    /**
+     * Register a message to be reported immediately or queue for reporting at a latter point.
+     *
+     * @param {LogMessage} message The message to register.
+     */
+    register(message: LogMessage): void;
+}
+/**
+ * Enrich the log message with extra information.
+ */
+export interface ILogMessageEnricher {
+    /**
+     * Enrich the log message with extra information.
+     *
+     * @param message The log message.
+     */
+    enrich(message: LogMessage): void;
+}

package/dist/logger/contracts.js

@@ -0,0 +1,67 @@
+/**
+ * Log level
+ */
+export var LogLevel;
+(function (LogLevel) {
+    /**
+     * Logs that contain the most detailed messages. These messages may contain sensitive application data. These messages are disabled by default and should never be enabled in a production environment.
+     */
+    LogLevel[LogLevel["Trace"] = 0] = "Trace";
+    /**
+     * Logs that are used for interactive investigation during development. These logs should primarily contain information useful for debugging and have no long-term value.
+     */
+    LogLevel[LogLevel["Debug"] = 1] = "Debug";
+    /**
+     * Logs that track the general flow of the application. These logs should have long-term value.
+     */
+    LogLevel[LogLevel["Information"] = 2] = "Information";
+    /**
+     * Logs that highlight an abnormal or unexpected event in the application flow, but do not otherwise cause the application execution to stop.
+     */
+    LogLevel[LogLevel["Warning"] = 3] = "Warning";
+    /**
+     * Logs that highlight when the current flow of execution is stopped due to a failure. These should indicate a failure in the current activity, not an application-wide failure.
+     */
+    LogLevel[LogLevel["Error"] = 4] = "Error";
+    /**
+     * Logs that describe an unrecoverable application or system crash, or a catastrophic failure that requires immediate attention.
+     */
+    LogLevel[LogLevel["Critical"] = 5] = "Critical";
+    /**
+     * Not used for writing log messages. Specifies that a logging category should not write any messages.
+     */
+    LogLevel[LogLevel["None"] = 6] = "None";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Base logging message
+ */
+export class LogMessage {
+    /**
+     * The timestamp of the log message.
+     */
+    timestamp = new Date().getTime();
+    /**
+     * The level of the log message.
+     */
+    level = LogLevel.None;
+    /**
+     * The name of the logger.
+     */
+    name = "";
+    /**
+     * The message to log.
+     */
+    message = "";
+    /**
+     * The error message.
+     */
+    errorMessage;
+    /**
+     * The stack trace of the error.
+     */
+    stackTrace;
+    /**
+     * Any extra parameters to log.
+     */
+    extraParams;
+}

package/dist/logger/enrichers/dynamicValuesEnricher.d.ts

@@ -0,0 +1,20 @@
+import type { ExtraParams, ILogMessageEnricher, LogMessage } from "../contracts";
+/**
+ * A function that returns the values to add to the log.
+ */
+export type DynamicValuesFunction = () => ExtraParams;
+export declare class DynamicValuesEnricher implements ILogMessageEnricher {
+    private _valuesFn;
+    private _overrideExisting;
+    /**
+     * Constructor.
+     *
+     * @param {DynamicValuesFunction} valuesFunction The values to add to the log.
+     * @param {boolean} overrideExisting Override a value if it already exists.
+     */
+    constructor(valuesFunction: DynamicValuesFunction, overrideExisting: boolean);
+    /**
+     * @inheritdoc
+     */
+    enrich(message: LogMessage): void;
+}