@zthun/lumberjacky-log 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Anthony Bonta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/lib/index.esm.js

@@ -0,0 +1,2 @@
+import{noop as t}from"lodash";function n(){return n=Object.assign?Object.assign.bind():function(t){for(var n=1;n<arguments.length;n++){var r=arguments[n];for(var e in r)Object.prototype.hasOwnProperty.call(r,e)&&(t[e]=r[e])}return t},n.apply(this,arguments)}var r;!function(t){t[t.CATASTROPHE=0]="CATASTROPHE",t[t.ERROR=1]="ERROR",t[t.WARNING=2]="WARNING",t[t.INFO=3]="INFO"}(r||(r={}));var e=/*#__PURE__*/function(){function t(){this._entry=void 0,this._entry={context:"",level:r.ERROR,message:"",created:(new Date).toJSON()}}var e=t.prototype;return e.catastrophe=function(){return this._entry.level=r.CATASTROPHE,this},e.error=function(){return this._entry.level=r.ERROR,this},e.warning=function(){return this._entry.level=r.WARNING,this},e.info=function(){return this._entry.level=r.INFO,this},e.context=function(t){return this._entry.context=t,this},e.message=function(t){return this._entry.message=t,this},e.build=function(){return n({},this._entry)},t}(),o=/*#__PURE__*/function(){function t(t){this._children=void 0,this._children=t}return t.prototype.log=function(t){this._children.forEach(function(n){return n.log(t)})},t}(),i=/*#__PURE__*/function(){function t(t){var n;this._console=void 0,this._logFnMap=void 0,this._console=t,this._logFnMap=((n={})[r.CATASTROPHE]=function(n){return t.error(n)},n[r.ERROR]=function(n){return t.error(n)},n[r.WARNING]=function(n){return t.warn(n)},n)}return t.prototype.log=function(n){var e=this;(this._logFnMap[n.level]||function(t){return e._console.log(t)})("["+n.created.toLocaleString()+"]"+(n.level===r.CATASTROPHE?": "+t.FATAL+" - "+n.message:": "+n.message))},t}();i.FATAL="!!FATAL!!";var s=function(){this.log=t};export{e as ZLogEntryBuilder,r as ZLogLevel,o as ZLoggerComposite,i as ZLoggerConsole,s as ZLoggerSilent};
+//# sourceMappingURL=index.esm.js.map

package/dist/lib/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../src/log-entry/log-entry.ts","../../src/logger/logger-composite.ts","../../src/logger/logger-console.ts","../../src/logger/logger-silent.ts"],"sourcesContent":["/**\n * The log level.\n */\nexport enum ZLogLevel {\n  /**\n   * A fatal error.\n   *\n   * Someone's pager is going off at 2:00 in the\n   * morning because the nuclear codes have gone off\n   * and missiles have been launched.\n   */\n  CATASTROPHE = 0,\n\n  /**\n   * A normal error that cause usually be recovered from.\n   *\n   * May require a fire being put out or some immediate\n   * response, but it is not world ending.\n   */\n  ERROR = 1,\n\n  /**\n   * Nothing is really totally wrong.\n   *\n   * Should probably not be ignored and\n   * action should be taken, but it's not\n   * serious enough to call the fire\n   * department.\n   */\n  WARNING = 2,\n\n  /**\n   * Some information that's good to know.\n   *\n   * Analytic logs are in this zone and general\n   * information goes in this zone.  Debug as\n   * well, goes into this zone.\n   *\n   * It is normally best to avoid this log level\n   * unless it's really important to display.\n   */\n  INFO = 3\n}\n\n/**\n * Represents a log entry.\n */\nexport interface IZLogEntry {\n  /**\n   * The log context.\n   *\n   * This will usually be a friendly name of a function\n   * or class where this log took place.\n   */\n  context: string;\n\n  /**\n   * The log level.\n   */\n  level: ZLogLevel;\n\n  /**\n   * The creation of this entry.\n   */\n  created: Date | string;\n\n  /**\n   * The log message.\n   */\n  message: string;\n}\n\n/**\n * Represents a builder for a log entry\n */\nexport class ZLogEntryBuilder {\n  private _entry: IZLogEntry;\n\n  /**\n   * Initializes a new instance of this object.\n   */\n  public constructor() {\n    this._entry = {\n      context: '',\n      level: ZLogLevel.ERROR,\n      message: '',\n      created: new Date().toJSON()\n    };\n  }\n\n  /**\n   * Sets the log level to catastrophe.\n   *\n   * @returns\n   *        This object.\n   */\n  public catastrophe(): this {\n    this._entry.level = ZLogLevel.CATASTROPHE;\n    return this;\n  }\n\n  /**\n   * Sets the log level to error.\n   *\n   * @returns\n   *        This object.\n   */\n  public error(): this {\n    this._entry.level = ZLogLevel.ERROR;\n    return this;\n  }\n\n  /**\n   * Sets the log level to warning.\n   *\n   * @returns\n   *        This object.\n   */\n  public warning(): this {\n    this._entry.level = ZLogLevel.WARNING;\n    return this;\n  }\n\n  /**\n   * Sets the log level to info.\n   *\n   * @returns\n   *        This object.\n   */\n  public info(): this {\n    this._entry.level = ZLogLevel.INFO;\n    return this;\n  }\n\n  /**\n   * Sets the context of the entry.\n   *\n   * @param ctx -\n   *        The entry context.\n   *\n   * @returns\n   *        This object.\n   */\n  public context(ctx: string): this {\n    this._entry.context = ctx;\n    return this;\n  }\n\n  /**\n   * Sets the message.\n   *\n   * @param msg -\n   *        The message to log.\n   *\n   * @returns\n   *        This object.\n   */\n  public message(msg: string): this {\n    this._entry.message = msg;\n    return this;\n  }\n\n  /**\n   * Returns a copy of the built log entry.\n   *\n   * @returns\n   *        The built log entry.\n   */\n  public build(): IZLogEntry {\n    return { ...this._entry };\n  }\n}\n","import { IZLogEntry } from '../log-entry/log-entry';\nimport { IZLogger } from './logger';\n\n/**\n * Represents a logger that logs to multiple sources.\n */\nexport class ZLoggerComposite implements IZLogger {\n  /**\n   * Initializes a new instance of this object.\n   *\n   * @param _children -\n   *        The collection of child loggers to log to.\n   */\n  public constructor(private readonly _children: IZLogger[]) {}\n\n  /**\n   * Logs the entry into every one of the child loggers.\n   *\n   * @param entry -\n   *        The entry to log.\n   */\n  public log(entry: IZLogEntry): void {\n    this._children.forEach((logger) => logger.log(entry));\n  }\n}\n","import { IZLogEntry, ZLogLevel } from '../log-entry/log-entry';\nimport { IZLogger } from './logger';\n\n/**\n * Represents a logger that logs to the console.\n */\nexport class ZLoggerConsole implements IZLogger {\n  public static readonly FATAL = '!!FATAL!!';\n  private _logFnMap: any;\n\n  /**\n   * Initializes a new instance of this object.\n   *\n   * @param _console -\n   *        The console to log to.\n   */\n  public constructor(private _console: Console) {\n    this._logFnMap = {\n      [ZLogLevel.CATASTROPHE]: (msg: string) => _console.error(msg),\n      [ZLogLevel.ERROR]: (msg: string) => _console.error(msg),\n      [ZLogLevel.WARNING]: (msg: string) => _console.warn(msg)\n    };\n  }\n\n  /**\n   * Logs the entry to the console.\n   *\n   * @param entry -\n   *        The entry to log.\n   */\n  public log(entry: IZLogEntry): void {\n    const fn = this._logFnMap[entry.level] || ((msg: string) => this._console.log(msg));\n\n    const timestamp = `[${entry.created.toLocaleString()}]`;\n    const payload =\n      entry.level === ZLogLevel.CATASTROPHE ? `: ${ZLoggerConsole.FATAL} - ${entry.message}` : `: ${entry.message}`;\n    fn(`${timestamp}${payload}`);\n  }\n}\n","import { noop } from 'lodash';\nimport { IZLogEntry } from '../log-entry/log-entry';\nimport { IZLogger } from './logger';\n\n/**\n * A silent logger.  This logger does nothing.\n */\nexport class ZLoggerSilent implements IZLogger {\n  public log: (_: IZLogEntry) => void = noop;\n}\n"],"names":["ZLogLevel","ZLogEntryBuilder","_entry","this","context","level","ERROR","message","created","Date","toJSON","_proto","prototype","catastrophe","CATASTROPHE","error","warning","WARNING","info","INFO","ctx","msg","build","_extends","ZLoggerComposite","_children","log","entry","forEach","logger","ZLoggerConsole","_console","_this$_logFnMap","_logFnMap","warn","_this","toLocaleString","FATAL","ZLoggerSilent","noop"],"mappings":"kQAGY,IAAAA,GAAZ,SAAYA,GAQVA,EAAAA,EAAA,YAAA,GAAA,cAQAA,EAAAA,EAAA,MAAA,GAAA,QAUAA,EAAAA,EAAA,QAAA,GAAA,UAYAA,EAAAA,EAAA,KAAA,GAAA,MACD,CAvCD,CAAYA,IAAAA,EAuCX,CAAA,IAiCY,IAAAC,eAMX,WAAA,SAAAA,IALQC,KAAAA,YAMN,EAAAC,KAAKD,OAAS,CACZE,QAAS,GACTC,MAAOL,EAAUM,MACjBC,QAAS,GACTC,SAAS,IAAIC,MAAOC,SAExB,CAAC,IAAAC,EAAAV,EAAAW,iBAAAD,EAQME,YAAA,WAEL,OADAV,KAAKD,OAAOG,MAAQL,EAAUc,YAEhCX,IAAA,EAACQ,EAQMI,MAAA,WAEL,OADAZ,KAAKD,OAAOG,MAAQL,EAAUM,MAEhCH,IAAA,EAACQ,EAQMK,QAAA,WAEL,OADAb,KAAKD,OAAOG,MAAQL,EAAUiB,QAEhCd,IAAA,EAACQ,EAQMO,KAAA,WAEL,OADAf,KAAKD,OAAOG,MAAQL,EAAUmB,KACvBhB,IACT,EAACQ,EAWMP,QAAA,SAAQgB,GAEb,OADAjB,KAAKD,OAAOE,QAAUgB,EAExBjB,IAAA,EAACQ,EAWMJ,QAAA,SAAQc,GAEb,OADAlB,KAAKD,OAAOK,QAAUc,EAExBlB,IAAA,EAACQ,EAQMW,MAAA,WACL,OAAAC,EAAY,CAAA,EAAApB,KAAKD,OACnB,EAACD,CAAA,CAzFD,GC3EWuB,eAOX,WAAA,SAAAA,EAAoCC,GAAAA,KAAAA,eAAA,EAAAtB,KAASsB,UAATA,CAAwB,CAU3D,OAV4DD,EAAAZ,UAQtDc,IAAA,SAAIC,GACTxB,KAAKsB,UAAUG,QAAQ,SAACC,GAAW,OAAAA,EAAOH,IAAIC,EAAM,EACtD,EAACH,CAAA,CAVD,GCPWM,eAUX,WAAA,SAAAA,EAA2BC,OAAiBC,EAAA7B,KAAjB4B,cARnBE,EAAAA,KAAAA,iBAQmB9B,KAAQ4B,SAARA,EACzB5B,KAAK8B,YAASD,EAAAA,CAAAA,GACXhC,EAAUc,aAAc,SAACO,GAAgB,OAAAU,EAAShB,MAAMM,EAAI,EAAAW,EAC5DhC,EAAUM,OAAQ,SAACe,GAAgB,OAAAU,EAAShB,MAAMM,EAAI,EAAAW,EACtDhC,EAAUiB,SAAU,SAACI,GAAgB,OAAAU,EAASG,KAAKb,EAAI,EAAAW,EAE5D,QAACF,EAAAlB,UAQMc,IAAA,SAAIC,GAAiB,IAAAQ,EAC1BhC,MAAWA,KAAK8B,UAAUN,EAAMtB,QAAW,SAACgB,UAAgBc,EAAKJ,SAASL,IAAIL,EAAI,OAE5DM,EAAMnB,QAAQ4B,sBAElCT,EAAMtB,QAAUL,EAAUc,YAAmBgB,KAAAA,EAAeO,MAAK,MAAMV,EAAMpB,aAAiBoB,EAAMpB,SAExG,EAACuB,CAAA,CArBD,GAVWA,EACYO,MAAQ,YCApB,IAAAC,EAAa,WAAAnC,KACjBuB,IAA+Ba,CAAI"}

package/dist/lib/index.js

@@ -0,0 +1,2 @@
+var e,t=require("lodash");function o(){return o=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var o=arguments[t];for(var r in o)Object.prototype.hasOwnProperty.call(o,r)&&(e[r]=o[r])}return e},o.apply(this,arguments)}exports.ZLogLevel=void 0,(e=exports.ZLogLevel||(exports.ZLogLevel={}))[e.CATASTROPHE=0]="CATASTROPHE",e[e.ERROR=1]="ERROR",e[e.WARNING=2]="WARNING",e[e.INFO=3]="INFO";var r=/*#__PURE__*/function(){function e(){this._entry=void 0,this._entry={context:"",level:exports.ZLogLevel.ERROR,message:"",created:(new Date).toJSON()}}var t=e.prototype;return t.catastrophe=function(){return this._entry.level=exports.ZLogLevel.CATASTROPHE,this},t.error=function(){return this._entry.level=exports.ZLogLevel.ERROR,this},t.warning=function(){return this._entry.level=exports.ZLogLevel.WARNING,this},t.info=function(){return this._entry.level=exports.ZLogLevel.INFO,this},t.context=function(e){return this._entry.context=e,this},t.message=function(e){return this._entry.message=e,this},t.build=function(){return o({},this._entry)},e}(),n=/*#__PURE__*/function(){function e(e){this._children=void 0,this._children=e}return e.prototype.log=function(e){this._children.forEach(function(t){return t.log(e)})},e}(),i=/*#__PURE__*/function(){function e(e){var t;this._console=void 0,this._logFnMap=void 0,this._console=e,this._logFnMap=((t={})[exports.ZLogLevel.CATASTROPHE]=function(t){return e.error(t)},t[exports.ZLogLevel.ERROR]=function(t){return e.error(t)},t[exports.ZLogLevel.WARNING]=function(t){return e.warn(t)},t)}return e.prototype.log=function(t){var o=this;(this._logFnMap[t.level]||function(e){return o._console.log(e)})("["+t.created.toLocaleString()+"]"+(t.level===exports.ZLogLevel.CATASTROPHE?": "+e.FATAL+" - "+t.message:": "+t.message))},e}();i.FATAL="!!FATAL!!",exports.ZLogEntryBuilder=r,exports.ZLoggerComposite=n,exports.ZLoggerConsole=i,exports.ZLoggerSilent=function(){this.log=t.noop};
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/log-entry/log-entry.ts","../../src/logger/logger-composite.ts","../../src/logger/logger-console.ts","../../src/logger/logger-silent.ts"],"sourcesContent":["/**\n * The log level.\n */\nexport enum ZLogLevel {\n  /**\n   * A fatal error.\n   *\n   * Someone's pager is going off at 2:00 in the\n   * morning because the nuclear codes have gone off\n   * and missiles have been launched.\n   */\n  CATASTROPHE = 0,\n\n  /**\n   * A normal error that cause usually be recovered from.\n   *\n   * May require a fire being put out or some immediate\n   * response, but it is not world ending.\n   */\n  ERROR = 1,\n\n  /**\n   * Nothing is really totally wrong.\n   *\n   * Should probably not be ignored and\n   * action should be taken, but it's not\n   * serious enough to call the fire\n   * department.\n   */\n  WARNING = 2,\n\n  /**\n   * Some information that's good to know.\n   *\n   * Analytic logs are in this zone and general\n   * information goes in this zone.  Debug as\n   * well, goes into this zone.\n   *\n   * It is normally best to avoid this log level\n   * unless it's really important to display.\n   */\n  INFO = 3\n}\n\n/**\n * Represents a log entry.\n */\nexport interface IZLogEntry {\n  /**\n   * The log context.\n   *\n   * This will usually be a friendly name of a function\n   * or class where this log took place.\n   */\n  context: string;\n\n  /**\n   * The log level.\n   */\n  level: ZLogLevel;\n\n  /**\n   * The creation of this entry.\n   */\n  created: Date | string;\n\n  /**\n   * The log message.\n   */\n  message: string;\n}\n\n/**\n * Represents a builder for a log entry\n */\nexport class ZLogEntryBuilder {\n  private _entry: IZLogEntry;\n\n  /**\n   * Initializes a new instance of this object.\n   */\n  public constructor() {\n    this._entry = {\n      context: '',\n      level: ZLogLevel.ERROR,\n      message: '',\n      created: new Date().toJSON()\n    };\n  }\n\n  /**\n   * Sets the log level to catastrophe.\n   *\n   * @returns\n   *        This object.\n   */\n  public catastrophe(): this {\n    this._entry.level = ZLogLevel.CATASTROPHE;\n    return this;\n  }\n\n  /**\n   * Sets the log level to error.\n   *\n   * @returns\n   *        This object.\n   */\n  public error(): this {\n    this._entry.level = ZLogLevel.ERROR;\n    return this;\n  }\n\n  /**\n   * Sets the log level to warning.\n   *\n   * @returns\n   *        This object.\n   */\n  public warning(): this {\n    this._entry.level = ZLogLevel.WARNING;\n    return this;\n  }\n\n  /**\n   * Sets the log level to info.\n   *\n   * @returns\n   *        This object.\n   */\n  public info(): this {\n    this._entry.level = ZLogLevel.INFO;\n    return this;\n  }\n\n  /**\n   * Sets the context of the entry.\n   *\n   * @param ctx -\n   *        The entry context.\n   *\n   * @returns\n   *        This object.\n   */\n  public context(ctx: string): this {\n    this._entry.context = ctx;\n    return this;\n  }\n\n  /**\n   * Sets the message.\n   *\n   * @param msg -\n   *        The message to log.\n   *\n   * @returns\n   *        This object.\n   */\n  public message(msg: string): this {\n    this._entry.message = msg;\n    return this;\n  }\n\n  /**\n   * Returns a copy of the built log entry.\n   *\n   * @returns\n   *        The built log entry.\n   */\n  public build(): IZLogEntry {\n    return { ...this._entry };\n  }\n}\n","import { IZLogEntry } from '../log-entry/log-entry';\nimport { IZLogger } from './logger';\n\n/**\n * Represents a logger that logs to multiple sources.\n */\nexport class ZLoggerComposite implements IZLogger {\n  /**\n   * Initializes a new instance of this object.\n   *\n   * @param _children -\n   *        The collection of child loggers to log to.\n   */\n  public constructor(private readonly _children: IZLogger[]) {}\n\n  /**\n   * Logs the entry into every one of the child loggers.\n   *\n   * @param entry -\n   *        The entry to log.\n   */\n  public log(entry: IZLogEntry): void {\n    this._children.forEach((logger) => logger.log(entry));\n  }\n}\n","import { IZLogEntry, ZLogLevel } from '../log-entry/log-entry';\nimport { IZLogger } from './logger';\n\n/**\n * Represents a logger that logs to the console.\n */\nexport class ZLoggerConsole implements IZLogger {\n  public static readonly FATAL = '!!FATAL!!';\n  private _logFnMap: any;\n\n  /**\n   * Initializes a new instance of this object.\n   *\n   * @param _console -\n   *        The console to log to.\n   */\n  public constructor(private _console: Console) {\n    this._logFnMap = {\n      [ZLogLevel.CATASTROPHE]: (msg: string) => _console.error(msg),\n      [ZLogLevel.ERROR]: (msg: string) => _console.error(msg),\n      [ZLogLevel.WARNING]: (msg: string) => _console.warn(msg)\n    };\n  }\n\n  /**\n   * Logs the entry to the console.\n   *\n   * @param entry -\n   *        The entry to log.\n   */\n  public log(entry: IZLogEntry): void {\n    const fn = this._logFnMap[entry.level] || ((msg: string) => this._console.log(msg));\n\n    const timestamp = `[${entry.created.toLocaleString()}]`;\n    const payload =\n      entry.level === ZLogLevel.CATASTROPHE ? `: ${ZLoggerConsole.FATAL} - ${entry.message}` : `: ${entry.message}`;\n    fn(`${timestamp}${payload}`);\n  }\n}\n","import { noop } from 'lodash';\nimport { IZLogEntry } from '../log-entry/log-entry';\nimport { IZLogger } from './logger';\n\n/**\n * A silent logger.  This logger does nothing.\n */\nexport class ZLoggerSilent implements IZLogger {\n  public log: (_: IZLogEntry) => void = noop;\n}\n"],"names":["ZLogLevel","ZLogEntryBuilder","_entry","this","context","level","ERROR","message","created","Date","toJSON","_proto","prototype","catastrophe","CATASTROPHE","error","warning","WARNING","info","INFO","ctx","msg","build","_extends","ZLoggerComposite","_children","log","entry","forEach","logger","ZLoggerConsole","_console","_this$_logFnMap","_logFnMap","warn","_this","toLocaleString","FATAL","noop"],"mappings":"IAGYA,0PAAAA,QAAAA,eAAAA,GAAAA,EAAAA,QAASA,YAATA,QAASA,UAuCpB,CAAA,IA/BCA,EAAA,YAAA,GAAA,cAQAA,EAAAA,EAAA,MAAA,GAAA,QAUAA,EAAAA,EAAA,QAAA,GAAA,UAYAA,EAAAA,EAAA,KAAA,GAAA,OAkCW,IAAAC,eAMX,WAAA,SAAAA,IALQC,KAAAA,YAMN,EAAAC,KAAKD,OAAS,CACZE,QAAS,GACTC,MAAOL,QAAAA,UAAUM,MACjBC,QAAS,GACTC,SAAS,IAAIC,MAAOC,SAExB,CAAC,IAAAC,EAAAV,EAAAW,iBAAAD,EAQME,YAAA,WAEL,OADAV,KAAKD,OAAOG,MAAQL,QAASA,UAACc,YAEhCX,IAAA,EAACQ,EAQMI,MAAA,WAEL,OADAZ,KAAKD,OAAOG,MAAQL,QAASA,UAACM,MAEhCH,IAAA,EAACQ,EAQMK,QAAA,WAEL,OADAb,KAAKD,OAAOG,MAAQL,QAAAA,UAAUiB,QAEhCd,IAAA,EAACQ,EAQMO,KAAA,WAEL,OADAf,KAAKD,OAAOG,MAAQL,QAASA,UAACmB,KACvBhB,IACT,EAACQ,EAWMP,QAAA,SAAQgB,GAEb,OADAjB,KAAKD,OAAOE,QAAUgB,EAExBjB,IAAA,EAACQ,EAWMJ,QAAA,SAAQc,GAEb,OADAlB,KAAKD,OAAOK,QAAUc,EAExBlB,IAAA,EAACQ,EAQMW,MAAA,WACL,OAAAC,EAAY,CAAA,EAAApB,KAAKD,OACnB,EAACD,CAAA,CAzFD,GC3EWuB,eAOX,WAAA,SAAAA,EAAoCC,GAAAA,KAAAA,eAAA,EAAAtB,KAASsB,UAATA,CAAwB,CAU3D,OAV4DD,EAAAZ,UAQtDc,IAAA,SAAIC,GACTxB,KAAKsB,UAAUG,QAAQ,SAACC,GAAW,OAAAA,EAAOH,IAAIC,EAAM,EACtD,EAACH,CAAA,CAVD,GCPWM,eAUX,WAAA,SAAAA,EAA2BC,OAAiBC,EAAA7B,KAAjB4B,cARnBE,EAAAA,KAAAA,iBAQmB9B,KAAQ4B,SAARA,EACzB5B,KAAK8B,YAASD,EAAAA,CAAAA,GACXhC,QAASA,UAACc,aAAc,SAACO,GAAgB,OAAAU,EAAShB,MAAMM,EAAI,EAAAW,EAC5DhC,QAASA,UAACM,OAAQ,SAACe,GAAgB,OAAAU,EAAShB,MAAMM,EAAI,EAAAW,EACtDhC,QAAAA,UAAUiB,SAAU,SAACI,GAAgB,OAAAU,EAASG,KAAKb,EAAI,EAAAW,EAE5D,QAACF,EAAAlB,UAQMc,IAAA,SAAIC,GAAiB,IAAAQ,EAC1BhC,MAAWA,KAAK8B,UAAUN,EAAMtB,QAAW,SAACgB,UAAgBc,EAAKJ,SAASL,IAAIL,EAAI,OAE5DM,EAAMnB,QAAQ4B,sBAElCT,EAAMtB,QAAUL,kBAAUc,YAAmBgB,KAAAA,EAAeO,MAAK,MAAMV,EAAMpB,aAAiBoB,EAAMpB,SAExG,EAACuB,CAAA,CArBD,GAVWA,EACYO,MAAQ,iHCAP,WAAAlC,KACjBuB,IAA+BY,EAAIA,IAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export * from './log-entry/log-entry';
+export * from './logger/logger';
+export * from './logger/logger-composite';
+export * from './logger/logger-console';
+export * from './logger/logger-silent';

package/dist/types/log-entry/log-entry.d.ts

@@ -0,0 +1,129 @@
+/**
+ * The log level.
+ */
+export declare enum ZLogLevel {
+    /**
+     * A fatal error.
+     *
+     * Someone's pager is going off at 2:00 in the
+     * morning because the nuclear codes have gone off
+     * and missiles have been launched.
+     */
+    CATASTROPHE = 0,
+    /**
+     * A normal error that cause usually be recovered from.
+     *
+     * May require a fire being put out or some immediate
+     * response, but it is not world ending.
+     */
+    ERROR = 1,
+    /**
+     * Nothing is really totally wrong.
+     *
+     * Should probably not be ignored and
+     * action should be taken, but it's not
+     * serious enough to call the fire
+     * department.
+     */
+    WARNING = 2,
+    /**
+     * Some information that's good to know.
+     *
+     * Analytic logs are in this zone and general
+     * information goes in this zone.  Debug as
+     * well, goes into this zone.
+     *
+     * It is normally best to avoid this log level
+     * unless it's really important to display.
+     */
+    INFO = 3
+}
+/**
+ * Represents a log entry.
+ */
+export interface IZLogEntry {
+    /**
+     * The log context.
+     *
+     * This will usually be a friendly name of a function
+     * or class where this log took place.
+     */
+    context: string;
+    /**
+     * The log level.
+     */
+    level: ZLogLevel;
+    /**
+     * The creation of this entry.
+     */
+    created: Date | string;
+    /**
+     * The log message.
+     */
+    message: string;
+}
+/**
+ * Represents a builder for a log entry
+ */
+export declare class ZLogEntryBuilder {
+    private _entry;
+    /**
+     * Initializes a new instance of this object.
+     */
+    constructor();
+    /**
+     * Sets the log level to catastrophe.
+     *
+     * @returns
+     *        This object.
+     */
+    catastrophe(): this;
+    /**
+     * Sets the log level to error.
+     *
+     * @returns
+     *        This object.
+     */
+    error(): this;
+    /**
+     * Sets the log level to warning.
+     *
+     * @returns
+     *        This object.
+     */
+    warning(): this;
+    /**
+     * Sets the log level to info.
+     *
+     * @returns
+     *        This object.
+     */
+    info(): this;
+    /**
+     * Sets the context of the entry.
+     *
+     * @param ctx -
+     *        The entry context.
+     *
+     * @returns
+     *        This object.
+     */
+    context(ctx: string): this;
+    /**
+     * Sets the message.
+     *
+     * @param msg -
+     *        The message to log.
+     *
+     * @returns
+     *        This object.
+     */
+    message(msg: string): this;
+    /**
+     * Returns a copy of the built log entry.
+     *
+     * @returns
+     *        The built log entry.
+     */
+    build(): IZLogEntry;
+}

package/dist/types/logger/logger-composite.d.ts

@@ -0,0 +1,22 @@
+import { IZLogEntry } from '../log-entry/log-entry';
+import { IZLogger } from './logger';
+/**
+ * Represents a logger that logs to multiple sources.
+ */
+export declare class ZLoggerComposite implements IZLogger {
+    private readonly _children;
+    /**
+     * Initializes a new instance of this object.
+     *
+     * @param _children -
+     *        The collection of child loggers to log to.
+     */
+    constructor(_children: IZLogger[]);
+    /**
+     * Logs the entry into every one of the child loggers.
+     *
+     * @param entry -
+     *        The entry to log.
+     */
+    log(entry: IZLogEntry): void;
+}

package/dist/types/logger/logger-console.d.ts

@@ -0,0 +1,24 @@
+import { IZLogEntry } from '../log-entry/log-entry';
+import { IZLogger } from './logger';
+/**
+ * Represents a logger that logs to the console.
+ */
+export declare class ZLoggerConsole implements IZLogger {
+    private _console;
+    static readonly FATAL = "!!FATAL!!";
+    private _logFnMap;
+    /**
+     * Initializes a new instance of this object.
+     *
+     * @param _console -
+     *        The console to log to.
+     */
+    constructor(_console: Console);
+    /**
+     * Logs the entry to the console.
+     *
+     * @param entry -
+     *        The entry to log.
+     */
+    log(entry: IZLogEntry): void;
+}

package/dist/types/logger/logger-silent.d.ts

@@ -0,0 +1,8 @@
+import { IZLogEntry } from '../log-entry/log-entry';
+import { IZLogger } from './logger';
+/**
+ * A silent logger.  This logger does nothing.
+ */
+export declare class ZLoggerSilent implements IZLogger {
+    log: (_: IZLogEntry) => void;
+}

package/dist/types/logger/logger.d.ts

@@ -0,0 +1,17 @@
+import { IZLogEntry } from '../log-entry/log-entry';
+/**
+ * Represents a service that manages log entries.
+ *
+ * Logging is a fire and forget operation.  If it fails,
+ * you move on.  Logging should never stop the operation of the
+ * app.
+ */
+export interface IZLogger {
+    /**
+     * Inserts a log entry.
+     *
+     * @param entry -
+     *        The log entry.
+     */
+    log(entry: IZLogEntry): void;
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@zthun/lumberjacky-log",
+  "version": "1.1.0",
+  "description": "A standard log interface between different logging standards.",
+  "author": "Anthony Bonta",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zthun/lumberjacky",
+    "directory": "packages/lumberjacky-log"
+  },
+  "main": "./dist/lib/index.js",
+  "module": "./dist/lib/index.esm.js",
+  "types": "./dist/types/index.d.ts",
+  "scripts": {
+    "build": "microbundle --format esm,cjs --tsconfig tsconfig.prod.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "lodash": "^4.17.21"
+  },
+  "devDependencies": {
+    "microbundle": "^0.15.1",
+    "typescript": "^5.2.2",
+    "vitest": "^0.34.3",
+    "vitest-mock-extended": "^1.2.1"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "gitHead": "7e0c69a4f88247949f75f4d0736e2878a8ce179e"
+}