standard-log 9.1.6 → 10.0.0

package/cjs/types.d.ts

@@ -8,7 +8,7 @@ export interface LoggerOptions extends StackTraceMeta {
     level?: number;
     writeTo?: LogReporter | ReporterFilter;
 }
-export declare type Logger<T extends string = LogMethodNames> = {
+export declare type Logger<N extends string = LogMethodNames> = {
     readonly id: string;
     /**
      * Logger local log level.
@@ -19,13 +19,13 @@ export declare type Logger<T extends string = LogMethodNames> = {
      * This is useful during debugging to check for steps executed.
      */
     count(...args: any[]): void;
-    on(level: number | T, logFunction: LogFunction): void;
+    on(level: number | N, logFunction: LogFunction): void;
     /**
      * Write custom log entries.
      */
     write(entry: LogEntry): void;
 } & {
-    [k in T]: LogMethod;
+    [k in N]: LogMethod;
 };
 /**
  * Names of the standard log methods.

package/cjs/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../ts/types.ts"],"names":[],"mappings":"","sourcesContent":["import { StackTraceMeta } from '@just-func/types'\n\nexport type StandardLogOptions<CustomLevelNames extends string = LogMethodNames> = {\n  customLevels?: Record<CustomLevelNames, number>,\n  logLevel?: number,\n  reporters?: LogReporter[]\n}\n\nexport interface LoggerOptions extends StackTraceMeta {\n  level?: number,\n  writeTo?: LogReporter | ReporterFilter\n}\n\nexport type Logger<T extends string = LogMethodNames> = {\n  readonly id: string,\n  /**\n   * Logger local log level.\n   */\n  level?: number,\n  /**\n   * Logs with an increment counter.\n   * This is useful during debugging to check for steps executed.\n   */\n  count(...args: any[]): void,\n  on(level: number | T, logFunction: LogFunction): void,\n  /**\n   * Write custom log entries.\n   */\n  write(entry: LogEntry): void\n} & { [k in T]: LogMethod }\n\n/**\n * Names of the standard log methods.\n */\nexport type LogMethodNames = 'emergency' | 'alert' | 'critical' | 'error' | 'warn' | 'notice' | 'info' | 'debug' | 'trace' | 'planck'\n\nexport type LogEntry = {\n  id: string,\n  level: number,\n  // args instead of messages because it is `any[]` instead of `string[]`\n  args: any[],\n  timestamp: Date\n}\n\nexport type LogMethod = (...args: any[]) => void\n\nexport type LogFunction = ((log: LogMethod) => void) | (() => string)\n\nexport type ReporterFilter = string | RegExp | ((reporterId: string) => boolean)\n\n/**\n * Formats a log entry.\n * Depends on the reporter, it can expect a different return type.\n * By default the return type is `any[]` which the `console` accepts.\n */\nexport type LogFormatter<T = any[]> = (entry: LogEntry) => T\n\n/**\n * Determines whether the entry should be written.\n */\nexport type LogFilter = (entry: LogEntry) => boolean\n\nexport type LogLevelEntry = { name: string, level: number }\n\nexport interface LogReporter<T = any> {\n  readonly id: string,\n  /**\n   * Specifies the formatter to be used by the reporter.\n   * Using this you can customize how the reporter writes the log entry.\n   */\n  readonly formatter: LogFormatter<T>,\n  /**\n   * Specifies a filter to determine should the log be written.\n   */\n  readonly filter?: LogFilter,\n  /**\n   * Indicate if this is a console reporter.\n   * There is only one console reporter can be present in the system.\n   */\n  readonly isConsoleReporter?: boolean,\n  write(entry: LogEntry): void\n}\n\nexport type LogReporterOptions<T = any> = {\n  id?: string,\n  /**\n   * Specifies the formatter to be used by the reporter.\n   * Using this you can customize how the reporter writes the log entry.\n   */\n  formatter?: LogFormatter<T>,\n  /**\n   * Specifies a filter to determine should the log be written.\n   */\n  filter?: LogFilter\n}\n\nexport type LogLevel = number\n\nexport interface ConsoleLike {\n  debug(...args: any[]): void,\n  info(...args: any[]): void,\n  warn(...args: any[]): void,\n  error(...args: any[]): void,\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../ts/types.ts"],"names":[],"mappings":"","sourcesContent":["import { StackTraceMeta } from '@just-func/types'\n\nexport type StandardLogOptions<CustomLevelNames extends string = LogMethodNames> = {\n  customLevels?: Record<CustomLevelNames, number>,\n  logLevel?: number,\n  reporters?: LogReporter[]\n}\n\nexport interface LoggerOptions extends StackTraceMeta {\n  level?: number,\n  writeTo?: LogReporter | ReporterFilter\n}\n\nexport type Logger<N extends string = LogMethodNames> = {\n  readonly id: string,\n  /**\n   * Logger local log level.\n   */\n  level?: number,\n  /**\n   * Logs with an increment counter.\n   * This is useful during debugging to check for steps executed.\n   */\n  count(...args: any[]): void,\n  on(level: number | N, logFunction: LogFunction): void,\n  /**\n   * Write custom log entries.\n   */\n  write(entry: LogEntry): void\n} & { [k in N]: LogMethod }\n\n/**\n * Names of the standard log methods.\n */\nexport type LogMethodNames = 'emergency' | 'alert' | 'critical' | 'error' | 'warn' | 'notice' | 'info' | 'debug' | 'trace' | 'planck'\n\nexport type LogEntry = {\n  id: string,\n  level: number,\n  // args instead of messages because it is `any[]` instead of `string[]`\n  args: any[],\n  timestamp: Date\n}\n\nexport type LogMethod = (...args: any[]) => void\n\nexport type LogFunction = ((log: LogMethod) => void) | (() => string)\n\nexport type ReporterFilter = string | RegExp | ((reporterId: string) => boolean)\n\n/**\n * Formats a log entry.\n * Depends on the reporter, it can expect a different return type.\n * By default the return type is `any[]` which the `console` accepts.\n */\nexport type LogFormatter<T = any[]> = (entry: LogEntry) => T\n\n/**\n * Determines whether the entry should be written.\n */\nexport type LogFilter = (entry: LogEntry) => boolean\n\nexport type LogLevelEntry = { name: string, level: number }\n\nexport interface LogReporter<T = any> {\n  readonly id: string,\n  /**\n   * Specifies the formatter to be used by the reporter.\n   * Using this you can customize how the reporter writes the log entry.\n   */\n  readonly formatter: LogFormatter<T>,\n  /**\n   * Specifies a filter to determine should the log be written.\n   */\n  readonly filter?: LogFilter,\n  /**\n   * Indicate if this is a console reporter.\n   * There is only one console reporter can be present in the system.\n   */\n  readonly isConsoleReporter?: boolean,\n  write(entry: LogEntry): void\n}\n\nexport type LogReporterOptions<T = any> = {\n  id?: string,\n  /**\n   * Specifies the formatter to be used by the reporter.\n   * Using this you can customize how the reporter writes the log entry.\n   */\n  formatter?: LogFormatter<T>,\n  /**\n   * Specifies a filter to determine should the log be written.\n   */\n  filter?: LogFilter\n}\n\nexport type LogLevel = number\n\nexport interface ConsoleLike {\n  debug(...args: any[]): void,\n  info(...args: any[]): void,\n  warn(...args: any[]): void,\n  error(...args: any[]): void,\n}\n"]}

package/dist/standard-log.es5.js

@@ -5872,7 +5872,7 @@ function buildFn(name) {
     };
 }
 function createConsoleLogReporter(options) {
-    var _a = (0, type_plus_1.required)({ id: 'console', formatter: formatter_js_1.plainLogFormatter }, options), id = _a.id, formatter = _a.formatter, filter = _a.filter;
+    var _a = (0, type_plus_1.unpartial)({ id: 'console', formatter: formatter_js_1.consoleFormatter }, options), id = _a.id, formatter = _a.formatter, filter = _a.filter;
     if (!platform_js_1.polyfill.console)
         platform_js_1.polyfill.console = buildPolyfillConsole();
     return Object.freeze({
@@ -5970,7 +5970,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.plainLogFormatter = exports.formatLogLevel = exports.createTimestampFormatter = void 0;
+exports.consoleFormatter = exports.plainLogFormatter = exports.formatLogLevel = exports.createTimestampFormatter = void 0;
 var ms_1 = __importDefault(__webpack_require__(/*! ms */ "../../node_modules/ms/index.js"));
 var upper_case_1 = __webpack_require__(/*! upper-case */ "../../node_modules/upper-case/dist/index.js");
 var logLevels_js_1 = __webpack_require__(/*! ./logLevels.js */ "./ts/logLevels.ts");
@@ -5996,11 +5996,25 @@ function formatLogLevel(level) {
     return "(".concat((0, upper_case_1.upperCase)((0, logLevels_js_1.toLogLevelName)(level)), ")");
 }
 exports.formatLogLevel = formatLogLevel;
+/**
+ * Formats log entry as plain text with the following format:
+ * `timestamp id level ...args`
+ *
+ * This is typically useful for writing logs to file
+ */
 function plainLogFormatter(_a) {
     var id = _a.id, level = _a.level, args = _a.args, timestamp = _a.timestamp;
     return __spreadArray([timestamp.toISOString(), id, formatLogLevel(level)], args, true);
 }
 exports.plainLogFormatter = plainLogFormatter;
+/**
+ * Formats log entry like default console log.
+ */
+function consoleFormatter(_a) {
+    var args = _a.args;
+    return args;
+}
+exports.consoleFormatter = consoleFormatter;
 
 
 /***/ }),
@@ -8873,6 +8887,134 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 
 /***/ }),
 
+/***/ "../../node_modules/tersify/node_modules/unpartial/cjs/index.js":
+/*!**********************************************************************!*\
+  !*** ../../node_modules/tersify/node_modules/unpartial/cjs/index.js ***!
+  \**********************************************************************/
+/***/ (function(__unused_webpack_module, exports, __webpack_require__) {
+
+"use strict";
+
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+__exportStar(__webpack_require__(/*! ./required.js */ "../../node_modules/tersify/node_modules/unpartial/cjs/required.js"), exports);
+__exportStar(__webpack_require__(/*! ./unpartial.js */ "../../node_modules/tersify/node_modules/unpartial/cjs/unpartial.js"), exports);
+//# sourceMappingURL=index.js.map
+
+/***/ }),
+
+/***/ "../../node_modules/tersify/node_modules/unpartial/cjs/required.js":
+/*!*************************************************************************!*\
+  !*** ../../node_modules/tersify/node_modules/unpartial/cjs/required.js ***!
+  \*************************************************************************/
+/***/ (function(__unused_webpack_module, exports) {
+
+"use strict";
+
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.requiredDeep = exports.required = void 0;
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+/* eslint-disable @typescript-eslint/no-unsafe-return */
+function required(source1, source2, source3) {
+    return merge([source1, source2, source3], function (p, e) { return (__assign(__assign({}, p), e)); });
+}
+exports.required = required;
+function requiredDeep(source1, source2, source3) {
+    return merge([source1, source2, source3], function (p, e) { return deepmerge(p, e); });
+}
+exports.requiredDeep = requiredDeep;
+function merge(entries, reducer) {
+    if (entries[0] === undefined || entries[0] === null)
+        return entries[0];
+    return entries.filter(function (x) { return !!x; }).reduce(reducer, {});
+}
+function deepmerge(source1, source2) {
+    if (typeof source1 !== 'object' || source1 === null)
+        return source2 !== undefined ? source2 : source1;
+    if (Array.isArray(source1)) {
+        if (Array.isArray(source2))
+            return source2;
+        if (source2 === undefined)
+            return __spreadArray([], source1, true);
+        return __spreadArray(__spreadArray([], source1, true), [source2], false);
+    }
+    return getAllKeys(source1).concat(getAllKeys(source2)).reduce(function (p, k) {
+        // @ts-ignore
+        p[k] = deepmerge(source1[k], source2 && source2[k]);
+        return p;
+    }, {});
+}
+function getAllKeys(subject, internal) {
+    if (internal === void 0) { internal = false; }
+    if (typeof subject !== 'object')
+        return [];
+    var propertyNames = Object.getOwnPropertyNames(subject);
+    var keys = internal ? propertyNames.filter(function (n) { return n !== 'constructor'; }) : propertyNames;
+    var proto = Object.getPrototypeOf(subject);
+    return proto !== Object.prototype ? keys.concat(getAllKeys(proto, true)) : keys;
+}
+//# sourceMappingURL=required.js.map
+
+/***/ }),
+
+/***/ "../../node_modules/tersify/node_modules/unpartial/cjs/unpartial.js":
+/*!**************************************************************************!*\
+  !*** ../../node_modules/tersify/node_modules/unpartial/cjs/unpartial.js ***!
+  \**************************************************************************/
+/***/ (function(__unused_webpack_module, exports, __webpack_require__) {
+
+"use strict";
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.unpartialRecursively = exports.unpartial = void 0;
+var required_js_1 = __webpack_require__(/*! ./required.js */ "../../node_modules/tersify/node_modules/unpartial/cjs/required.js");
+function unpartial(arg1, arg2, arg3) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+    return (0, required_js_1.required)(arg1, arg2, arg3);
+}
+exports.unpartial = unpartial;
+function unpartialRecursively(arg1, arg2, arg3) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+    return (0, required_js_1.requiredDeep)(arg1, arg2, arg3);
+}
+exports.unpartialRecursively = unpartialRecursively;
+//# sourceMappingURL=unpartial.js.map
+
+/***/ }),
+
 /***/ "../../node_modules/type-plus/cjs/JSONTypes.js":
 /*!*****************************************************!*\
   !*** ../../node_modules/type-plus/cjs/JSONTypes.js ***!
@@ -9121,6 +9263,7 @@ assertType.custom = function (validator) {
         return;
     };
 };
+assertType.as = function (subject) { };
 //# sourceMappingURL=assertType.js.map
 
 /***/ }),
@@ -9304,11 +9447,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.requiredDeep = exports.required = void 0;
+exports.unpartial = exports.requiredDeep = exports.required = void 0;
 // import * as types from './types/index.js'
 var unpartial_1 = __webpack_require__(/*! unpartial */ "../../node_modules/unpartial/cjs/index.js");
 Object.defineProperty(exports, "required", ({ enumerable: true, get: function () { return unpartial_1.required; } }));
 Object.defineProperty(exports, "requiredDeep", ({ enumerable: true, get: function () { return unpartial_1.requiredDeep; } }));
+Object.defineProperty(exports, "unpartial", ({ enumerable: true, get: function () { return unpartial_1.unpartial; } }));
 __exportStar(__webpack_require__(/*! ./array/index.js */ "../../node_modules/type-plus/cjs/array/index.js"), exports);
 __exportStar(__webpack_require__(/*! ./assertion/index.js */ "../../node_modules/type-plus/cjs/assertion/index.js"), exports);
 __exportStar(__webpack_require__(/*! ./class/index.js */ "../../node_modules/type-plus/cjs/class/index.js"), exports);
@@ -10319,7 +10463,9 @@ exports.requiredDeep = exports.required = void 0;
 /* eslint-disable @typescript-eslint/no-unsafe-assignment */
 /* eslint-disable @typescript-eslint/no-unsafe-return */
 function required(source1, source2, source3) {
-    return merge([source1, source2, source3], function (p, e) { return (__assign(__assign({}, p), e)); });
+    return merge([source1, source2, source3], function (p, e) {
+        return __assign(__assign({}, p), e);
+    });
 }
 exports.required = required;
 function requiredDeep(source1, source2, source3) {
@@ -10368,51 +10514,46 @@ function getAllKeys(subject, internal) {
 
 "use strict";
 
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.unpartialRecursively = exports.unpartial = void 0;
+exports.unpartial = exports.unpartialRecursively = void 0;
 var required_js_1 = __webpack_require__(/*! ./required.js */ "../../node_modules/unpartial/cjs/required.js");
-function unpartial(arg1, arg2, arg3) {
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-    return (0, required_js_1.required)(arg1, arg2, arg3);
-}
-exports.unpartial = unpartial;
 function unpartialRecursively(arg1, arg2, arg3) {
     // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
     return (0, required_js_1.requiredDeep)(arg1, arg2, arg3);
 }
 exports.unpartialRecursively = unpartialRecursively;
+function unpartial(s1, s2, s3) {
+    // defensive check for JS
+    if (s1 === undefined || s1 === null)
+        return s1;
+    return [s1, s2, s3]
+        .filter(notNil)
+        .reduce(function (p, s) { return (__assign(__assign({}, p), trimNilProps(s))); }, {});
+}
+exports.unpartial = unpartial;
+function trimNilProps(value) {
+    return Object.keys(value).reduce(function (p, k) {
+        if (notNil(value[k]))
+            p[k] = value[k];
+        return p;
+    }, {});
+}
+function notNil(value) {
+    return value !== null && value !== undefined;
+}
 //# sourceMappingURL=unpartial.js.map
 
-/***/ }),
-
-/***/ "../../node_modules/tersify/node_modules/unpartial/cjs/index.js":
-/*!**********************************************************************!*\
-  !*** ../../node_modules/tersify/node_modules/unpartial/cjs/index.js ***!
-  \**********************************************************************/
-/***/ (function(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
-
-"use strict";
-__webpack_require__.r(__webpack_exports__);
-
-var __createBinding = (undefined && undefined.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (undefined && undefined.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./required.js"), exports);
-__exportStar(require("./unpartial.js"), exports);
-//# sourceMappingURL=index.js.map
-
 /***/ })
 
 /******/ 	});
@@ -10454,17 +10595,6 @@ __exportStar(require("./unpartial.js"), exports);
 /******/ 		})();
 /******/ 	}();
 /******/ 	
-/******/ 	/* webpack/runtime/make namespace object */
-/******/ 	!function() {
-/******/ 		// define __esModule on exports
-/******/ 		__webpack_require__.r = function(exports) {
-/******/ 			if(typeof Symbol !== 'undefined' && Symbol.toStringTag) {
-/******/ 				Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-/******/ 			}
-/******/ 			Object.defineProperty(exports, '__esModule', { value: true });
-/******/ 		};
-/******/ 	}();
-/******/ 	
 /************************************************************************/
 /******/ 	
 /******/ 	// startup