semola 0.5.2 → 0.5.3

package/dist/logging/core/index.cjs

@@ -0,0 +1,99 @@
+const require_lib_errors_index = require("../../lib/errors/index.cjs");
+const require_index = require("../formatter/index.cjs");
+let node_path = require("node:path");
+//#region src/lib/logging/core/index.ts
+const PROVIDER_OPTION_DEFAULT = {
+	formatter: new require_index.BaseFormatter(),
+	level: "debug"
+};
+const STACK_FRAME_IDX = 1;
+var StackData = class {
+	stack = [];
+	constructor(fn) {
+		const oldStackTrace = Error.prepareStackTrace;
+		const [stackTraceError] = require_lib_errors_index.mightThrowSync(() => {
+			Error.prepareStackTrace = (_, stack) => {
+				return stack.map((callSite) => {
+					return {
+						fileName: callSite.getFileName(),
+						column: callSite.getColumnNumber(),
+						row: callSite.getLineNumber(),
+						functionCall: callSite.getFunctionName()
+					};
+				});
+			};
+			Error.captureStackTrace(this, fn);
+			this.stack;
+		});
+		Error.prepareStackTrace = oldStackTrace;
+		if (stackTraceError) this.stack = [];
+	}
+	retrieveFrame() {
+		if (this.stack.length === 0) return void 0;
+		return this.stack[STACK_FRAME_IDX];
+	}
+};
+var AbstractLogger = class {
+	providers;
+	prefix;
+	constructor(prefix, providers) {
+		this.prefix = prefix;
+		this.providers = providers;
+	}
+	createLogData(level, msg, prefix) {
+		const logCall = new StackData(this.createLogData).retrieveFrame();
+		let logData = {
+			level,
+			msg,
+			prefix
+		};
+		if (!logCall) return logData;
+		const { column, fileName, functionCall, row } = logCall;
+		if (fileName) logData = {
+			...logData,
+			fileName: (0, node_path.basename)(fileName)
+		};
+		if (column) logData = {
+			...logData,
+			column: String(column)
+		};
+		if (row) logData = {
+			...logData,
+			row: String(row)
+		};
+		if (functionCall) logData = {
+			...logData,
+			method: functionCall
+		};
+		return logData;
+	}
+};
+var Logger = class extends AbstractLogger {
+	debug(msg) {
+		const data = this.createLogData("debug", msg, this.prefix);
+		this.run(data);
+	}
+	info(msg) {
+		const data = this.createLogData("info", msg, this.prefix);
+		this.run(data);
+	}
+	warning(msg) {
+		const data = this.createLogData("warning", msg, this.prefix);
+		this.run(data);
+	}
+	error(msg) {
+		const data = this.createLogData("error", msg, this.prefix);
+		this.run(data);
+	}
+	critical(msg) {
+		const data = this.createLogData("critical", msg, this.prefix);
+		this.run(data);
+	}
+	run(data) {
+		for (let i = 0; i < this.providers.length; i++) this.providers[i]?.execute(data);
+	}
+};
+//#endregion
+exports.AbstractLogger = AbstractLogger;
+exports.Logger = Logger;
+exports.PROVIDER_OPTION_DEFAULT = PROVIDER_OPTION_DEFAULT;

package/dist/logging/core/index.d.cts

@@ -0,0 +1,26 @@
+import { LogDataType, LogLevelType, LogMessageType } from "./types.cjs";
+import { LoggerProvider } from "../provider/index.cjs";
+
+//#region src/lib/logging/core/index.d.ts
+declare abstract class AbstractLogger {
+  protected providers: LoggerProvider[];
+  protected prefix: string;
+  constructor(prefix: string, providers: [LoggerProvider, ...LoggerProvider[]]);
+  abstract debug(msg: LogMessageType): void;
+  abstract info(msg: LogMessageType): void;
+  abstract warning(msg: LogMessageType): void;
+  abstract error(msg: LogMessageType): void;
+  abstract critical(msg: LogMessageType): void;
+  protected createLogData(level: LogLevelType, msg: LogMessageType, prefix: string): LogDataType;
+}
+declare class Logger extends AbstractLogger {
+  debug(msg: LogMessageType): void;
+  info(msg: LogMessageType): void;
+  warning(msg: LogMessageType): void;
+  error(msg: LogMessageType): void;
+  critical(msg: LogMessageType): void;
+  private run;
+}
+//#endregion
+export { AbstractLogger, Logger };
+//# sourceMappingURL=index.d.cts.map

package/dist/logging/core/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/lib/logging/core/index.ts"],"mappings":";;;;uBAuDsB,cAAA;EAAA,UACV,SAAA,EAAW,cAAA;EAAA,UACX,MAAA;cAGR,MAAA,UACA,SAAA,GAAY,cAAA,KAAmB,cAAA;EAAA,SAMjB,KAAA,CAAM,GAAA,EAAK,cAAA;EAAA,SACX,IAAA,CAAK,GAAA,EAAK,cAAA;EAAA,SACV,OAAA,CAAQ,GAAA,EAAK,cAAA;EAAA,SACb,KAAA,CAAM,GAAA,EAAK,cAAA;EAAA,SACX,QAAA,CAAS,GAAA,EAAK,cAAA;EAAA,UAEpB,aAAA,CACR,KAAA,EAAO,YAAA,EACP,GAAA,EAAK,cAAA,EACL,MAAA,WACC,WAAA;AAAA;AAAA,cA+BQ,MAAA,SAAe,cAAA;EACnB,KAAA,CAAM,GAAA,EAAK,cAAA;EAKX,IAAA,CAAK,GAAA,EAAK,cAAA;EAKV,OAAA,CAAQ,GAAA,EAAK,cAAA;EAKb,KAAA,CAAM,GAAA,EAAK,cAAA;EAKX,QAAA,CAAS,GAAA,EAAK,cAAA;EAAA,QAKb,GAAA;AAAA"}

package/dist/logging/core/index.d.mts

@@ -0,0 +1,26 @@
+import { LogDataType, LogLevelType, LogMessageType } from "./types.mjs";
+import { LoggerProvider } from "../provider/index.mjs";
+
+//#region src/lib/logging/core/index.d.ts
+declare abstract class AbstractLogger {
+  protected providers: LoggerProvider[];
+  protected prefix: string;
+  constructor(prefix: string, providers: [LoggerProvider, ...LoggerProvider[]]);
+  abstract debug(msg: LogMessageType): void;
+  abstract info(msg: LogMessageType): void;
+  abstract warning(msg: LogMessageType): void;
+  abstract error(msg: LogMessageType): void;
+  abstract critical(msg: LogMessageType): void;
+  protected createLogData(level: LogLevelType, msg: LogMessageType, prefix: string): LogDataType;
+}
+declare class Logger extends AbstractLogger {
+  debug(msg: LogMessageType): void;
+  info(msg: LogMessageType): void;
+  warning(msg: LogMessageType): void;
+  error(msg: LogMessageType): void;
+  critical(msg: LogMessageType): void;
+  private run;
+}
+//#endregion
+export { AbstractLogger, Logger };
+//# sourceMappingURL=index.d.mts.map

package/dist/logging/core/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/lib/logging/core/index.ts"],"mappings":";;;;uBAuDsB,cAAA;EAAA,UACV,SAAA,EAAW,cAAA;EAAA,UACX,MAAA;cAGR,MAAA,UACA,SAAA,GAAY,cAAA,KAAmB,cAAA;EAAA,SAMjB,KAAA,CAAM,GAAA,EAAK,cAAA;EAAA,SACX,IAAA,CAAK,GAAA,EAAK,cAAA;EAAA,SACV,OAAA,CAAQ,GAAA,EAAK,cAAA;EAAA,SACb,KAAA,CAAM,GAAA,EAAK,cAAA;EAAA,SACX,QAAA,CAAS,GAAA,EAAK,cAAA;EAAA,UAEpB,aAAA,CACR,KAAA,EAAO,YAAA,EACP,GAAA,EAAK,cAAA,EACL,MAAA,WACC,WAAA;AAAA;AAAA,cA+BQ,MAAA,SAAe,cAAA;EACnB,KAAA,CAAM,GAAA,EAAK,cAAA;EAKX,IAAA,CAAK,GAAA,EAAK,cAAA;EAKV,OAAA,CAAQ,GAAA,EAAK,cAAA;EAKb,KAAA,CAAM,GAAA,EAAK,cAAA;EAKX,QAAA,CAAS,GAAA,EAAK,cAAA;EAAA,QAKb,GAAA;AAAA"}

package/dist/logging/core/index.mjs

@@ -0,0 +1,99 @@
+import { mightThrowSync } from "../../lib/errors/index.mjs";
+import { BaseFormatter } from "../formatter/index.mjs";
+import { basename } from "node:path";
+//#region src/lib/logging/core/index.ts
+const PROVIDER_OPTION_DEFAULT = {
+	formatter: new BaseFormatter(),
+	level: "debug"
+};
+const STACK_FRAME_IDX = 1;
+var StackData = class {
+	stack = [];
+	constructor(fn) {
+		const oldStackTrace = Error.prepareStackTrace;
+		const [stackTraceError] = mightThrowSync(() => {
+			Error.prepareStackTrace = (_, stack) => {
+				return stack.map((callSite) => {
+					return {
+						fileName: callSite.getFileName(),
+						column: callSite.getColumnNumber(),
+						row: callSite.getLineNumber(),
+						functionCall: callSite.getFunctionName()
+					};
+				});
+			};
+			Error.captureStackTrace(this, fn);
+			this.stack;
+		});
+		Error.prepareStackTrace = oldStackTrace;
+		if (stackTraceError) this.stack = [];
+	}
+	retrieveFrame() {
+		if (this.stack.length === 0) return void 0;
+		return this.stack[STACK_FRAME_IDX];
+	}
+};
+var AbstractLogger = class {
+	providers;
+	prefix;
+	constructor(prefix, providers) {
+		this.prefix = prefix;
+		this.providers = providers;
+	}
+	createLogData(level, msg, prefix) {
+		const logCall = new StackData(this.createLogData).retrieveFrame();
+		let logData = {
+			level,
+			msg,
+			prefix
+		};
+		if (!logCall) return logData;
+		const { column, fileName, functionCall, row } = logCall;
+		if (fileName) logData = {
+			...logData,
+			fileName: basename(fileName)
+		};
+		if (column) logData = {
+			...logData,
+			column: String(column)
+		};
+		if (row) logData = {
+			...logData,
+			row: String(row)
+		};
+		if (functionCall) logData = {
+			...logData,
+			method: functionCall
+		};
+		return logData;
+	}
+};
+var Logger = class extends AbstractLogger {
+	debug(msg) {
+		const data = this.createLogData("debug", msg, this.prefix);
+		this.run(data);
+	}
+	info(msg) {
+		const data = this.createLogData("info", msg, this.prefix);
+		this.run(data);
+	}
+	warning(msg) {
+		const data = this.createLogData("warning", msg, this.prefix);
+		this.run(data);
+	}
+	error(msg) {
+		const data = this.createLogData("error", msg, this.prefix);
+		this.run(data);
+	}
+	critical(msg) {
+		const data = this.createLogData("critical", msg, this.prefix);
+		this.run(data);
+	}
+	run(data) {
+		for (let i = 0; i < this.providers.length; i++) this.providers[i]?.execute(data);
+	}
+};
+//#endregion
+export { AbstractLogger, Logger, PROVIDER_OPTION_DEFAULT };
+
+//# sourceMappingURL=index.mjs.map

package/dist/logging/core/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/lib/logging/core/index.ts"],"sourcesContent":["import { basename } from \"node:path\";\nimport { mightThrowSync } from \"../../errors/index.js\";\nimport { BaseFormatter } from \"../formatter/index.js\";\nimport type { LoggerProvider } from \"../provider/index.js\";\nimport type { ProviderOptions } from \"../provider/types.js\";\nimport type { LogDataType, LogLevelType, LogMessageType } from \"./types.js\";\n\nexport const PROVIDER_OPTION_DEFAULT: ProviderOptions = {\n  formatter: new BaseFormatter(),\n  level: \"debug\",\n} as const;\n\nconst STACK_FRAME_IDX = 1;\n\nexport type StackTraceData = {\n  fileName: string | null;\n  column: number | null;\n  row: number | null;\n  functionCall: string | null;\n};\n\nexport class StackData {\n  private stack: StackTraceData[] = [];\n\n  public constructor(fn: Function) {\n    const oldStackTrace = Error.prepareStackTrace;\n    const [stackTraceError] = mightThrowSync(() => {\n      Error.prepareStackTrace = (_, stack) => {\n        return stack.map<StackTraceData>((callSite) => {\n          return {\n            fileName: callSite.getFileName(),\n            column: callSite.getColumnNumber(),\n            row: callSite.getLineNumber(),\n            functionCall: callSite.getFunctionName(),\n          };\n        });\n      };\n\n      Error.captureStackTrace(this, fn);\n      this.stack; // Invoke the getter for `stack`.\n    });\n\n    Error.prepareStackTrace = oldStackTrace;\n    if (stackTraceError) this.stack = [];\n  }\n\n  public retrieveFrame() {\n    if (this.stack.length === 0) return undefined;\n\n    // Access the second stack frame because I need to ignore\n    // a logging function's stack frame (e.g \"debug()\" and \"info()\")\n    return this.stack[STACK_FRAME_IDX];\n  }\n}\n\nexport abstract class AbstractLogger {\n  protected providers: LoggerProvider[];\n  protected prefix: string;\n\n  public constructor(\n    prefix: string,\n    providers: [LoggerProvider, ...LoggerProvider[]],\n  ) {\n    this.prefix = prefix;\n    this.providers = providers;\n  }\n\n  public abstract debug(msg: LogMessageType): void;\n  public abstract info(msg: LogMessageType): void;\n  public abstract warning(msg: LogMessageType): void;\n  public abstract error(msg: LogMessageType): void;\n  public abstract critical(msg: LogMessageType): void;\n\n  protected createLogData(\n    level: LogLevelType,\n    msg: LogMessageType,\n    prefix: string,\n  ): LogDataType {\n    const stack = new StackData(this.createLogData);\n    const logCall = stack.retrieveFrame();\n    let logData: LogDataType = { level, msg, prefix };\n\n    if (!logCall) {\n      return logData;\n    }\n\n    const { column, fileName, functionCall, row } = logCall;\n\n    if (fileName) {\n      logData = { ...logData, fileName: basename(fileName) };\n    }\n\n    if (column) {\n      logData = { ...logData, column: String(column) };\n    }\n\n    if (row) {\n      logData = { ...logData, row: String(row) };\n    }\n\n    if (functionCall) {\n      logData = { ...logData, method: functionCall };\n    }\n\n    return logData;\n  }\n}\n\nexport class Logger extends AbstractLogger {\n  public debug(msg: LogMessageType) {\n    const data = this.createLogData(\"debug\", msg, this.prefix);\n    this.run(data);\n  }\n\n  public info(msg: LogMessageType) {\n    const data = this.createLogData(\"info\", msg, this.prefix);\n    this.run(data);\n  }\n\n  public warning(msg: LogMessageType) {\n    const data = this.createLogData(\"warning\", msg, this.prefix);\n    this.run(data);\n  }\n\n  public error(msg: LogMessageType) {\n    const data = this.createLogData(\"error\", msg, this.prefix);\n    this.run(data);\n  }\n\n  public critical(msg: LogMessageType) {\n    const data = this.createLogData(\"critical\", msg, this.prefix);\n    this.run(data);\n  }\n\n  private run(data: LogDataType) {\n    for (let i = 0; i < this.providers.length; i++) {\n      const provider = this.providers[i];\n      provider?.execute(data);\n    }\n  }\n}\n"],"mappings":";;;;AAOA,MAAa,0BAA2C;CACtD,WAAW,IAAI,eAAe;CAC9B,OAAO;CACR;AAED,MAAM,kBAAkB;AASxB,IAAa,YAAb,MAAuB;CACrB,QAAkC,EAAE;CAEpC,YAAmB,IAAc;EAC/B,MAAM,gBAAgB,MAAM;EAC5B,MAAM,CAAC,mBAAmB,qBAAqB;AAC7C,SAAM,qBAAqB,GAAG,UAAU;AACtC,WAAO,MAAM,KAAqB,aAAa;AAC7C,YAAO;MACL,UAAU,SAAS,aAAa;MAChC,QAAQ,SAAS,iBAAiB;MAClC,KAAK,SAAS,eAAe;MAC7B,cAAc,SAAS,iBAAiB;MACzC;MACD;;AAGJ,SAAM,kBAAkB,MAAM,GAAG;AACjC,QAAK;IACL;AAEF,QAAM,oBAAoB;AAC1B,MAAI,gBAAiB,MAAK,QAAQ,EAAE;;CAGtC,gBAAuB;AACrB,MAAI,KAAK,MAAM,WAAW,EAAG,QAAO,KAAA;AAIpC,SAAO,KAAK,MAAM;;;AAItB,IAAsB,iBAAtB,MAAqC;CACnC;CACA;CAEA,YACE,QACA,WACA;AACA,OAAK,SAAS;AACd,OAAK,YAAY;;CASnB,cACE,OACA,KACA,QACa;EAEb,MAAM,UADQ,IAAI,UAAU,KAAK,cAAc,CACzB,eAAe;EACrC,IAAI,UAAuB;GAAE;GAAO;GAAK;GAAQ;AAEjD,MAAI,CAAC,QACH,QAAO;EAGT,MAAM,EAAE,QAAQ,UAAU,cAAc,QAAQ;AAEhD,MAAI,SACF,WAAU;GAAE,GAAG;GAAS,UAAU,SAAS,SAAS;GAAE;AAGxD,MAAI,OACF,WAAU;GAAE,GAAG;GAAS,QAAQ,OAAO,OAAO;GAAE;AAGlD,MAAI,IACF,WAAU;GAAE,GAAG;GAAS,KAAK,OAAO,IAAI;GAAE;AAG5C,MAAI,aACF,WAAU;GAAE,GAAG;GAAS,QAAQ;GAAc;AAGhD,SAAO;;;AAIX,IAAa,SAAb,cAA4B,eAAe;CACzC,MAAa,KAAqB;EAChC,MAAM,OAAO,KAAK,cAAc,SAAS,KAAK,KAAK,OAAO;AAC1D,OAAK,IAAI,KAAK;;CAGhB,KAAY,KAAqB;EAC/B,MAAM,OAAO,KAAK,cAAc,QAAQ,KAAK,KAAK,OAAO;AACzD,OAAK,IAAI,KAAK;;CAGhB,QAAe,KAAqB;EAClC,MAAM,OAAO,KAAK,cAAc,WAAW,KAAK,KAAK,OAAO;AAC5D,OAAK,IAAI,KAAK;;CAGhB,MAAa,KAAqB;EAChC,MAAM,OAAO,KAAK,cAAc,SAAS,KAAK,KAAK,OAAO;AAC1D,OAAK,IAAI,KAAK;;CAGhB,SAAgB,KAAqB;EACnC,MAAM,OAAO,KAAK,cAAc,YAAY,KAAK,KAAK,OAAO;AAC7D,OAAK,IAAI,KAAK;;CAGhB,IAAY,MAAmB;AAC7B,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,UAAU,QAAQ,IACxB,MAAK,UAAU,IACtB,QAAQ,KAAK"}

package/dist/logging/core/types.cjs

@@ -0,0 +1,10 @@
+//#region src/lib/logging/core/types.ts
+const LogLevel = {
+	debug: 10,
+	info: 20,
+	warning: 30,
+	error: 40,
+	critical: 50
+};
+//#endregion
+exports.LogLevel = LogLevel;

package/dist/logging/core/types.d.cts

@@ -0,0 +1,22 @@
+//#region src/lib/logging/core/types.d.ts
+declare const LogLevel: {
+  readonly debug: 10;
+  readonly info: 20;
+  readonly warning: 30;
+  readonly error: 40;
+  readonly critical: 50;
+};
+type LogLevelType = keyof typeof LogLevel;
+type LogMessageType = string | object | number | boolean;
+type LogDataType = {
+  prefix: string;
+  level: LogLevelType;
+  msg: LogMessageType;
+  row?: string;
+  column?: string;
+  fileName?: string;
+  method?: string;
+};
+//#endregion
+export { LogDataType, LogLevel, LogLevelType, LogMessageType };
+//# sourceMappingURL=types.d.cts.map

package/dist/logging/core/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../src/lib/logging/core/types.ts"],"mappings":";cAAa,QAAA;EAAA;;;;;;KAQD,YAAA,gBAA4B,QAAA;AAAA,KAE5B,cAAA;AAAA,KAEA,WAAA;EACV,MAAA;EACA,KAAA,EAAO,YAAA;EACP,GAAA,EAAK,cAAA;EACL,GAAA;EACA,MAAA;EACA,QAAA;EACA,MAAA;AAAA"}

package/dist/logging/core/types.d.mts

@@ -0,0 +1,22 @@
+//#region src/lib/logging/core/types.d.ts
+declare const LogLevel: {
+  readonly debug: 10;
+  readonly info: 20;
+  readonly warning: 30;
+  readonly error: 40;
+  readonly critical: 50;
+};
+type LogLevelType = keyof typeof LogLevel;
+type LogMessageType = string | object | number | boolean;
+type LogDataType = {
+  prefix: string;
+  level: LogLevelType;
+  msg: LogMessageType;
+  row?: string;
+  column?: string;
+  fileName?: string;
+  method?: string;
+};
+//#endregion
+export { LogDataType, LogLevel, LogLevelType, LogMessageType };
+//# sourceMappingURL=types.d.mts.map

package/dist/logging/core/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/lib/logging/core/types.ts"],"mappings":";cAAa,QAAA;EAAA;;;;;;KAQD,YAAA,gBAA4B,QAAA;AAAA,KAE5B,cAAA;AAAA,KAEA,WAAA;EACV,MAAA;EACA,KAAA,EAAO,YAAA;EACP,GAAA,EAAK,cAAA;EACL,GAAA;EACA,MAAA;EACA,QAAA;EACA,MAAA;AAAA"}

package/dist/logging/core/types.mjs

@@ -0,0 +1,12 @@
+//#region src/lib/logging/core/types.ts
+const LogLevel = {
+	debug: 10,
+	info: 20,
+	warning: 30,
+	error: 40,
+	critical: 50
+};
+//#endregion
+export { LogLevel };
+
+//# sourceMappingURL=types.mjs.map

package/dist/logging/core/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../src/lib/logging/core/types.ts"],"sourcesContent":["export const LogLevel = {\n  debug: 10,\n  info: 20,\n  warning: 30,\n  error: 40,\n  critical: 50,\n} as const;\n\nexport type LogLevelType = keyof typeof LogLevel;\n\nexport type LogMessageType = string | object | number | boolean;\n\nexport type LogDataType = {\n  prefix: string;\n  level: LogLevelType;\n  msg: LogMessageType;\n  row?: string;\n  column?: string;\n  fileName?: string;\n  method?: string;\n};\n"],"mappings":";AAAA,MAAa,WAAW;CACtB,OAAO;CACP,MAAM;CACN,SAAS;CACT,OAAO;CACP,UAAU;CACX"}

package/dist/logging/formatter/index.cjs

@@ -0,0 +1,119 @@
+//#region src/lib/logging/formatter/index.ts
+var Formatter = class {
+	dateFmt;
+	constructor(dateFmt) {
+		this.dateFmt = dateFmt;
+	}
+};
+var BaseFormatter = class extends Formatter {
+	constructor(dateFmt = isoDateTimeFormat) {
+		super(dateFmt);
+	}
+	format(logData) {
+		let { prefix, level, msg, fileName, row, column, method } = logData;
+		const timestamp = this.dateFmt();
+		const levelType = level.toUpperCase();
+		if (typeof msg === "object") msg = JSON.stringify(msg);
+		const fileData = `${prefix}/${fileName}:${row}:${column}`;
+		let header = `[${levelType}]`;
+		if (method) header = `${header}\t[${method}]\t[${fileData}]`;
+		else header = `${header}\t[${fileData}]`;
+		return `${timestamp}  ${header} : ${msg}`;
+	}
+	formatError(logData, error) {
+		const { prefix, fileName, row, column, method } = logData;
+		const timestamp = this.dateFmt();
+		const fileData = `${prefix}/${fileName}:${row}:${column}`;
+		let errorMsg = `Error name="${error.name}" Error message="${error.message}"`;
+		let header = "[ERROR]";
+		if (method) header = `${header}\t[${method}]\t[${fileData}]`;
+		else header = `${header}\t[${fileData}]`;
+		if (error.cause) errorMsg = `${errorMsg}\n\tError cause="${error.cause}"`;
+		if (error.stack) errorMsg = `${errorMsg}\n\tStack trace="${error.stack}"`;
+		return `${timestamp}  ${header} : ${errorMsg}`;
+	}
+};
+var JSONFormatter = class extends Formatter {
+	constructor(dateFmt = isoDateTimeFormat) {
+		super(dateFmt);
+	}
+	format(logData) {
+		const { prefix, level, msg, fileName, row, column, method } = logData;
+		const timestamp = this.dateFmt();
+		const levelType = level.toUpperCase();
+		let position = {};
+		if (method) position = { method };
+		position = {
+			...position,
+			fileName,
+			row,
+			column
+		};
+		return JSON.stringify({
+			timestamp,
+			level: levelType,
+			prefix,
+			position,
+			msg
+		});
+	}
+	formatError(logData, error) {
+		const { prefix, fileName, row, column, method } = logData;
+		const timestamp = this.dateFmt();
+		let errorMsg = {
+			errorName: error.name,
+			errorMessage: error.message
+		};
+		let position = {};
+		if (method) position = { method };
+		position = {
+			...position,
+			fileName,
+			row,
+			column
+		};
+		if (error.cause) errorMsg = {
+			...errorMsg,
+			errorCause: error.cause
+		};
+		if (error.stack) errorMsg = {
+			...errorMsg,
+			stackTrace: error.stack
+		};
+		return JSON.stringify({
+			timestamp,
+			level: "ERROR",
+			prefix,
+			position,
+			msg: errorMsg
+		});
+	}
+};
+function isoDateTimeFormat() {
+	return (/* @__PURE__ */ new Date()).toISOString();
+}
+function isoDateFormat() {
+	const date = isoDateTimeFormat().split("T")[0];
+	if (!date) return "";
+	return date;
+}
+function dmyFormat() {
+	const isoDate = isoDateFormat();
+	if (!isoDate) return "";
+	const info = isoDate.split("-");
+	return `${info[2]}-${info[1]}-${info[0]}`;
+}
+function mdyFormat() {
+	const isoDate = isoDateFormat();
+	if (!isoDate) return "";
+	const info = isoDate.split("-");
+	return `${info[1]}-${info[2]}-${info[0]}`;
+}
+//#endregion
+exports.BaseFormatter = BaseFormatter;
+exports.Formatter = Formatter;
+exports.JSONFormatter = JSONFormatter;
+exports.dmyFormat = dmyFormat;
+exports.isoDateFormat = isoDateFormat;
+exports.isoDateTimeFormat = isoDateTimeFormat;
+exports.mdyFormat = mdyFormat;

package/dist/logging/formatter/index.d.cts

@@ -0,0 +1,27 @@
+import { LogDataType } from "../core/types.cjs";
+import { DateFmtFnType } from "./types.cjs";
+
+//#region src/lib/logging/formatter/index.d.ts
+declare abstract class Formatter {
+  protected dateFmt: DateFmtFnType;
+  constructor(dateFmt: DateFmtFnType);
+  abstract format(logData: LogDataType): string;
+  abstract formatError(logData: LogDataType, error: Error): string;
+}
+declare class BaseFormatter extends Formatter {
+  constructor(dateFmt?: DateFmtFnType);
+  format(logData: LogDataType): string;
+  formatError(logData: LogDataType, error: Error): string;
+}
+declare class JSONFormatter extends Formatter {
+  constructor(dateFmt?: DateFmtFnType);
+  format(logData: LogDataType): string;
+  formatError(logData: LogDataType, error: Error): string;
+}
+declare function isoDateTimeFormat(): string;
+declare function isoDateFormat(): string;
+declare function dmyFormat(): string;
+declare function mdyFormat(): string;
+//#endregion
+export { BaseFormatter, Formatter, JSONFormatter, dmyFormat, isoDateFormat, isoDateTimeFormat, mdyFormat };
+//# sourceMappingURL=index.d.cts.map

package/dist/logging/formatter/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/lib/logging/formatter/index.ts"],"mappings":";;;;uBAGsB,SAAA;EAAA,UACV,OAAA,EAAS,aAAA;cAEA,OAAA,EAAS,aAAA;EAAA,SAIZ,MAAA,CAAO,OAAA,EAAS,WAAA;EAAA,SAChB,WAAA,CAAY,OAAA,EAAS,WAAA,EAAa,KAAA,EAAO,KAAA;AAAA;AAAA,cAG9C,aAAA,SAAsB,SAAA;cACd,OAAA,GAAS,aAAA;EAIrB,MAAA,CAAO,OAAA,EAAS,WAAA;EAoBhB,WAAA,CAAY,OAAA,EAAS,WAAA,EAAa,KAAA,EAAO,KAAA;AAAA;AAAA,cA0BrC,aAAA,SAAsB,SAAA;cACd,OAAA,GAAS,aAAA;EAIrB,MAAA,CAAO,OAAA,EAAS,WAAA;EAwBhB,WAAA,CAAY,OAAA,EAAS,WAAA,EAAa,KAAA,EAAO,KAAA;AAAA;AAAA,iBAmClC,iBAAA,CAAA;AAAA,iBAIA,aAAA,CAAA;AAAA,iBAOA,SAAA,CAAA;AAAA,iBASA,SAAA,CAAA"}

package/dist/logging/formatter/index.d.mts

@@ -0,0 +1,27 @@
+import { LogDataType } from "../core/types.mjs";
+import { DateFmtFnType } from "./types.mjs";
+
+//#region src/lib/logging/formatter/index.d.ts
+declare abstract class Formatter {
+  protected dateFmt: DateFmtFnType;
+  constructor(dateFmt: DateFmtFnType);
+  abstract format(logData: LogDataType): string;
+  abstract formatError(logData: LogDataType, error: Error): string;
+}
+declare class BaseFormatter extends Formatter {
+  constructor(dateFmt?: DateFmtFnType);
+  format(logData: LogDataType): string;
+  formatError(logData: LogDataType, error: Error): string;
+}
+declare class JSONFormatter extends Formatter {
+  constructor(dateFmt?: DateFmtFnType);
+  format(logData: LogDataType): string;
+  formatError(logData: LogDataType, error: Error): string;
+}
+declare function isoDateTimeFormat(): string;
+declare function isoDateFormat(): string;
+declare function dmyFormat(): string;
+declare function mdyFormat(): string;
+//#endregion
+export { BaseFormatter, Formatter, JSONFormatter, dmyFormat, isoDateFormat, isoDateTimeFormat, mdyFormat };
+//# sourceMappingURL=index.d.mts.map

package/dist/logging/formatter/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/lib/logging/formatter/index.ts"],"mappings":";;;;uBAGsB,SAAA;EAAA,UACV,OAAA,EAAS,aAAA;cAEA,OAAA,EAAS,aAAA;EAAA,SAIZ,MAAA,CAAO,OAAA,EAAS,WAAA;EAAA,SAChB,WAAA,CAAY,OAAA,EAAS,WAAA,EAAa,KAAA,EAAO,KAAA;AAAA;AAAA,cAG9C,aAAA,SAAsB,SAAA;cACd,OAAA,GAAS,aAAA;EAIrB,MAAA,CAAO,OAAA,EAAS,WAAA;EAoBhB,WAAA,CAAY,OAAA,EAAS,WAAA,EAAa,KAAA,EAAO,KAAA;AAAA;AAAA,cA0BrC,aAAA,SAAsB,SAAA;cACd,OAAA,GAAS,aAAA;EAIrB,MAAA,CAAO,OAAA,EAAS,WAAA;EAwBhB,WAAA,CAAY,OAAA,EAAS,WAAA,EAAa,KAAA,EAAO,KAAA;AAAA;AAAA,iBAmClC,iBAAA,CAAA;AAAA,iBAIA,aAAA,CAAA;AAAA,iBAOA,SAAA,CAAA;AAAA,iBASA,SAAA,CAAA"}

package/dist/logging/formatter/index.mjs

@@ -0,0 +1,115 @@
+//#region src/lib/logging/formatter/index.ts
+var Formatter = class {
+	dateFmt;
+	constructor(dateFmt) {
+		this.dateFmt = dateFmt;
+	}
+};
+var BaseFormatter = class extends Formatter {
+	constructor(dateFmt = isoDateTimeFormat) {
+		super(dateFmt);
+	}
+	format(logData) {
+		let { prefix, level, msg, fileName, row, column, method } = logData;
+		const timestamp = this.dateFmt();
+		const levelType = level.toUpperCase();
+		if (typeof msg === "object") msg = JSON.stringify(msg);
+		const fileData = `${prefix}/${fileName}:${row}:${column}`;
+		let header = `[${levelType}]`;
+		if (method) header = `${header}\t[${method}]\t[${fileData}]`;
+		else header = `${header}\t[${fileData}]`;
+		return `${timestamp}  ${header} : ${msg}`;
+	}
+	formatError(logData, error) {
+		const { prefix, fileName, row, column, method } = logData;
+		const timestamp = this.dateFmt();
+		const fileData = `${prefix}/${fileName}:${row}:${column}`;
+		let errorMsg = `Error name="${error.name}" Error message="${error.message}"`;
+		let header = "[ERROR]";
+		if (method) header = `${header}\t[${method}]\t[${fileData}]`;
+		else header = `${header}\t[${fileData}]`;
+		if (error.cause) errorMsg = `${errorMsg}\n\tError cause="${error.cause}"`;
+		if (error.stack) errorMsg = `${errorMsg}\n\tStack trace="${error.stack}"`;
+		return `${timestamp}  ${header} : ${errorMsg}`;
+	}
+};
+var JSONFormatter = class extends Formatter {
+	constructor(dateFmt = isoDateTimeFormat) {
+		super(dateFmt);
+	}
+	format(logData) {
+		const { prefix, level, msg, fileName, row, column, method } = logData;
+		const timestamp = this.dateFmt();
+		const levelType = level.toUpperCase();
+		let position = {};
+		if (method) position = { method };
+		position = {
+			...position,
+			fileName,
+			row,
+			column
+		};
+		return JSON.stringify({
+			timestamp,
+			level: levelType,
+			prefix,
+			position,
+			msg
+		});
+	}
+	formatError(logData, error) {
+		const { prefix, fileName, row, column, method } = logData;
+		const timestamp = this.dateFmt();
+		let errorMsg = {
+			errorName: error.name,
+			errorMessage: error.message
+		};
+		let position = {};
+		if (method) position = { method };
+		position = {
+			...position,
+			fileName,
+			row,
+			column
+		};
+		if (error.cause) errorMsg = {
+			...errorMsg,
+			errorCause: error.cause
+		};
+		if (error.stack) errorMsg = {
+			...errorMsg,
+			stackTrace: error.stack
+		};
+		return JSON.stringify({
+			timestamp,
+			level: "ERROR",
+			prefix,
+			position,
+			msg: errorMsg
+		});
+	}
+};
+function isoDateTimeFormat() {
+	return (/* @__PURE__ */ new Date()).toISOString();
+}
+function isoDateFormat() {
+	const date = isoDateTimeFormat().split("T")[0];
+	if (!date) return "";
+	return date;
+}
+function dmyFormat() {
+	const isoDate = isoDateFormat();
+	if (!isoDate) return "";
+	const info = isoDate.split("-");
+	return `${info[2]}-${info[1]}-${info[0]}`;
+}
+function mdyFormat() {
+	const isoDate = isoDateFormat();
+	if (!isoDate) return "";
+	const info = isoDate.split("-");
+	return `${info[1]}-${info[2]}-${info[0]}`;
+}
+//#endregion
+export { BaseFormatter, Formatter, JSONFormatter, dmyFormat, isoDateFormat, isoDateTimeFormat, mdyFormat };
+
+//# sourceMappingURL=index.mjs.map

package/dist/logging/formatter/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/lib/logging/formatter/index.ts"],"sourcesContent":["import type { LogDataType } from \"../core/types.js\";\nimport type { DateFmtFnType } from \"./types.js\";\n\nexport abstract class Formatter {\n  protected dateFmt: DateFmtFnType;\n\n  public constructor(dateFmt: DateFmtFnType) {\n    this.dateFmt = dateFmt;\n  }\n\n  public abstract format(logData: LogDataType): string;\n  public abstract formatError(logData: LogDataType, error: Error): string;\n}\n\nexport class BaseFormatter extends Formatter {\n  public constructor(dateFmt: DateFmtFnType = isoDateTimeFormat) {\n    super(dateFmt);\n  }\n\n  public format(logData: LogDataType): string {\n    let { prefix, level, msg, fileName, row, column, method } = logData;\n    const timestamp = this.dateFmt();\n    const levelType = level.toUpperCase();\n    if (typeof msg === \"object\") {\n      msg = JSON.stringify(msg);\n    }\n\n    const fileData = `${prefix}/${fileName}:${row}:${column}`;\n    let header = `[${levelType}]`;\n\n    if (method) {\n      header = `${header}\\t[${method}]\\t[${fileData}]`;\n    } else {\n      header = `${header}\\t[${fileData}]`;\n    }\n\n    return `${timestamp}  ${header} : ${msg}`;\n  }\n\n  public formatError(logData: LogDataType, error: Error): string {\n    const { prefix, fileName, row, column, method } = logData;\n    const timestamp = this.dateFmt();\n\n    const fileData = `${prefix}/${fileName}:${row}:${column}`;\n    let errorMsg = `Error name=\"${error.name}\" Error message=\"${error.message}\"`;\n    let header = \"[ERROR]\";\n\n    if (method) {\n      header = `${header}\\t[${method}]\\t[${fileData}]`;\n    } else {\n      header = `${header}\\t[${fileData}]`;\n    }\n\n    if (error.cause) {\n      errorMsg = `${errorMsg}\\n\\tError cause=\"${error.cause}\"`;\n    }\n\n    if (error.stack) {\n      errorMsg = `${errorMsg}\\n\\tStack trace=\"${error.stack}\"`;\n    }\n\n    return `${timestamp}  ${header} : ${errorMsg}`;\n  }\n}\n\nexport class JSONFormatter extends Formatter {\n  public constructor(dateFmt: DateFmtFnType = isoDateTimeFormat) {\n    super(dateFmt);\n  }\n\n  public format(logData: LogDataType): string {\n    const { prefix, level, msg, fileName, row, column, method } = logData;\n    const timestamp = this.dateFmt();\n    const levelType = level.toUpperCase();\n\n    let position: Record<string, string | undefined> = {};\n\n    if (method) {\n      position = { method };\n    }\n\n    position = { ...position, fileName, row, column };\n\n    const data = {\n      timestamp,\n      level: levelType,\n      prefix,\n      position,\n      msg,\n    };\n\n    return JSON.stringify(data);\n  }\n\n  public formatError(logData: LogDataType, error: Error): string {\n    const { prefix, fileName, row, column, method } = logData;\n    const timestamp = this.dateFmt();\n    let errorMsg: Record<string, unknown> = {\n      errorName: error.name,\n      errorMessage: error.message,\n    };\n    let position: Record<string, string | undefined> = {};\n\n    if (method) {\n      position = { method };\n    }\n\n    position = { ...position, fileName, row, column };\n\n    if (error.cause) {\n      errorMsg = { ...errorMsg, errorCause: error.cause };\n    }\n\n    if (error.stack) {\n      errorMsg = { ...errorMsg, stackTrace: error.stack };\n    }\n\n    const data = {\n      timestamp,\n      level: \"ERROR\",\n      prefix,\n      position,\n      msg: errorMsg,\n    };\n\n    return JSON.stringify(data);\n  }\n}\n\nexport function isoDateTimeFormat() {\n  return new Date().toISOString();\n}\n\nexport function isoDateFormat() {\n  const date = isoDateTimeFormat().split(\"T\")[0];\n  if (!date) return \"\";\n\n  return date;\n}\n\nexport function dmyFormat() {\n  const isoDate = isoDateFormat();\n  if (!isoDate) return \"\";\n\n  const info = isoDate.split(\"-\");\n\n  return `${info[2]}-${info[1]}-${info[0]}`;\n}\n\nexport function mdyFormat() {\n  const isoDate = isoDateFormat();\n  if (!isoDate) return \"\";\n\n  const info = isoDate.split(\"-\");\n\n  return `${info[1]}-${info[2]}-${info[0]}`;\n}\n"],"mappings":"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"}