standard-log 7.1.0 → 9.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2017 unional, Homa Wong (homawong@gmail.com)
+Copyright © 2017 unional, Homa Wong (homawong@gmail.com)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -3,50 +3,61 @@
 [![NPM version][npm-image]][npm-url]
 [![NPM downloads][downloads-image]][downloads-url]
 
-[![Github NodeJS][github-nodejs]][github-action-url]
+[![GitHub NodeJS][github-nodejs]][github-action-url]
 [![Codecov][codecov-image]][codecov-url]
-[![Codacy Grade Badge][codacy-grade]][codacy-grade-url]
-[![Codacy Coverage Badge][codacy-coverage]][codacy-coverage-url]
-
-[![Greenkeeper][greenkeeper-image]][greenkeeper-url]
 
 [![Visual Studio Code][vscode-image]][vscode-url]
-[![Wallaby.js][wallaby-image]][wallaby-url]
 
-`standard-log` is a powerful and extensible logging library.
+[`standard-log`] is a powerful and extensible logging library.
+
+## New in 9.0
+
+[`standard-log`] 9.0 is a trimmed down version that focus more on security and support the micro-app paradigm.
+
+The key changes are:
+
+- No side effects: application calling `createStandardLog()` gets a completely enclosed log system.
+- Immutable: after the log system can be configured when calling `createStandardLog()`.\
+  But after that, the system is immutable and cannot be changed.\
+
+For the full list of changes, please check the [change log](./CHANGELOG.md).
 
 ## Key features
 
-- create multiple loggers for different part of your application.
-- provide multiple log levels out of the box.
-- add custom log levels.
-- global and local log level control.
-- send logs to multiple reporters, e.g. console, file, memory, or remote service.
-- custom formatting and filtering for each reporter.
-- config tempering protection during production
+- Support micro-app with isolated log system.
+- Create multiple loggers for different part of your application.
+- Provide multiple log levels out of the box.
+- Support custom log levels.
+- Three levels of log level controls: log system, logger, and log method.
+- Send logs to multiple reporters, e.g. console, file, memory, or remote service.
+- Custom formatting and filtering for each reporter.
+- Security focus. After the system is created, it cannot be changed.
+- Compliant with the [`just-func`] paradigm.
 
 ## Usage
 
-To use `standard-log`, simply create your logger and log away:
+To use [`standard-log`], you first create a new log system.
 
 ```ts
-import { getLogger } from 'standard-log'
+import { createStandardLog } from 'standard-log'
+
+const standardLog = createStandarLog(/* options */)
 
-const log = getLogger('my-app')
+const log = standardLog.getLogger(['my-app'])
 
-log.error('error')
-log.warn('warn')
-log.info('info')
+log.error('error message')
+log.warn('warn message')
+log.info('info message')
 // by default debug() will not be printed
 // because production mode defaults log level to `info`
-log.debug('debug')
+log.debug('debug message')
 ```
 
-![rendering-example](images/2019-08-08-23-40-05.png)
+![Rendering example](images/2022-06-10-19-21-48.png)
 
-(above is logged with `standard-log-color` installed)
+(above is logged with `standard-log-color`)
 
-You can configure a logger by doing `getLogger(id, options)`:
+You can configure a logger by doing `getLogger([id, options])`:
 
 `options.level: number`:
 
@@ -56,41 +67,12 @@ Log level of this logger.
 
 Only log to specific reporter(s).
 
-### Mode
-
-By default, `standard-log` runs in production mode.
-You can change it programmatically:
-
-```ts
-import { config } from 'standard-log'
-
-config({ mode: 'production' }) // or 'development', 'test'
-```
-
-or by setting the environment variable `STANDARD_LOG`.
-
-`production` mode:
-
-- `config()` can only be called once.
-- configuration is protected from tempering.
-
-`development` mode:
-
-- a warning is emitted when calling `config()` or log for the first time.
-
-`test` mode:
-
-- no warning is emitted
-
 ### Log Level
 
 `standard-log` log level defaults to `logLevels.info`.
 It comes with many log levels out of the box:
 
 ```ts
-import { getLogger } from 'standard-log'
-
-const log = getLogger('x')
 log.emergency('msg')
 log.alert('msg')
 log.critical('msg')
@@ -108,16 +90,16 @@ When sending logs to console, they are mapped to `info`, `warn`, `error`, and `d
 You can also add your own custom levels:
 
 ```ts
-import { config, getLogger, logLevel } from 'standard-log'
+import { createStandardLog } from 'standard-log'
 
-config({
+const standardLog = createStandardLog({
   customLevels: {
     'important': logLevel.warn + 1,
     'silly': logLevel.debug + 1
   }
 })
 
-const log = getLogger<'silly' | 'important'>('custom')
+const log = standardLog.getLogger('custom')
 log.important('this is an important message')
 log.silly('oh silly')
 ```
@@ -128,14 +110,14 @@ Besides printing the logs to console,
 you can use different reporters to save the logs in memory, file, service, or others.
 
 ```ts
-import { config, createConsoleLogReporter, createMemoryLogReporter } from 'standard-log'
+import { createStandardLog, createConsoleLogReporter, createMemoryLogReporter } from 'standard-log'
 
-config({
+createStandardLog({
   reporters: [createConsoleLogReporter(), createMemoryLogReporter()]
 })
 ```
 
-Some reporters allows you to format the logs and/or filter them.
+Some reporters allow you to format the logs and/or filter them.
 Using the console log reporter as an example:
 
 ```ts
@@ -149,37 +131,10 @@ createConsoleLogReporter({
 
 Here are some additional reporters:
 
-- [`standard-log-color`](https://github.com/unional/standard-log/tree/master/packages/color)
+- [`standard-log-color`]
 - `standard-log-file` (TODO)
 - `standard-log-syslog` (TODO)
 
-### Capture Logs
-
-You can temporarily capture logs by `captureLogs()`.
-This is useful when you are writing tests.
-
-```ts
-import { getLogger, captureLogs } from 'standard-log'
-import a from 'assertron'
-
-test('your test', () => {
-  function foo() {
-    const log = getLogger('foo logger')
-    // this log will not be sent to normal reporters
-    log.info('some messages')
-    return 'miku'
-  }
-  const log = getLogger('foo logger')
-  const [result, logs] = captureLogs(log, foo)
-
-  a.satisfies(logs, [{ args: ['some messages']}])
-  a.equals('miku', result)
-
-  // rewriting the logs
-  logs.forEach(entry => log.write(entry))
-})
-```
-
 ### Suppress log
 
 You can temporarily suppress logs by `suppressLogs()`.
@@ -193,66 +148,35 @@ const log = getLogger('some logger')
 suppressLogs(() => log.info('not logged'), log)
 ```
 
-## Browser usage
-
-The package comes with a pre-bundled file under `dist`.
-To use it, you also need to load [`global-store`](https://github.com/unional/global-store)
-
-If you are building a library and bundle it, make sure you mark `global-store` as externals.
-You can check out [`global-store`](https://github.com/unional/global-store) for more information.
-
-## testing
+## Testing
 
 During test,
-you should configure `standard-log` to `test` mode and use `MemoryReporter` to capture the logs.
+you should use `createStandardLogForTest` which includes a `MemoryReporter` to capture the logs.
 
 ```ts
-import { config, createMemoryReporter } from 'standard-log'
+import { createStandardLogForTest, createMemoryReporter } from 'standard-log'
 
 test('your test', () => {
-  const reporter = createMemoryLogReporter()
-  config({
-    reporters: [reporter],
-    mode: 'test'
-  })
+  const standardLog = createStandardLogForTest()
+  yourApp.standardLog = standardLog
 
-  // do your thing...
+// do your thing...
 
-  const messages = reporter.getLogMessage() // or getLogMessageWithLevel()
+  const messages = standardLog.reporter.getLogMessage() // or getLogMessageWithLevel()
   // validate the message if you want to
 })
 ```
 
-And to simplify things, you can use the `configForTest()` function:
-
-```ts
-import { configForTest } from 'standard-log'
-
-test('your test', () => {
-  const { reporter } = configForTest()
-
-  // do your thing...
-})
-```
-
-[npm-image]: https://img.shields.io/npm/v/standard-log.svg?style=flat
-[npm-url]: https://www.npmjs.com/package/standard-log
+[`just-func`]: https://github.com/justland/just-func-typescript
+[`standard-log`]: https://github.com/unional/standard-log
+[`standard-log-color`]: https://github.com/unional/standard-log/tree/master/packages/color
+[codecov-image]: https://codecov.io/gh/unional/standard-log/branch/master/graph/badge.svg
+[codecov-url]: https://codecov.io/gh/unional/standard-log
 [downloads-image]: https://img.shields.io/npm/dm/standard-log.svg?style=flat
 [downloads-url]: https://npmjs.org/package/standard-log
-
-[github-nodejs]: https://github.com/unional/standard-log/workflows/Node%20CI/badge.svg
 [github-action-url]: https://github.com/unional/standard-log/actions
-[codecov-image]: https://codecov.io/gh/unional/standard-log/branch/master/graph/badge.svg
-[codecov-url]: https://codecov.io/gh/unional/standard-log
-[codacy-grade]: https://api.codacy.com/project/badge/Grade/707f89609508442486050d207ec5bd78
-[codacy-grade-url]: https://www.codacy.com/app/homawong/standard-log?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=unional/standard-log&amp;utm_campaign=Badge_Grade
-[codacy-coverage]: https://api.codacy.com/project/badge/Coverage/707f89609508442486050d207ec5bd78
-[codacy-coverage-url]: https://www.codacy.com/manual/homawong/standard-log?utm_source=github.com&utm_medium=referral&utm_content=unional/standard-log&utm_campaign=Badge_Coverage
-
-[greenkeeper-image]: https://badges.greenkeeper.io/unional/standard-log.svg
-[greenkeeper-url]: https://greenkeeper.io/
-
+[github-nodejs]: https://github.com/unional/standard-log/workflows/Node%20CI/badge.svg
+[npm-image]: https://img.shields.io/npm/v/standard-log.svg?style=flat
+[npm-url]: https://www.npmjs.com/package/standard-log
 [vscode-image]: https://img.shields.io/badge/vscode-ready-green.svg
 [vscode-url]: https://code.visualstudio.com/
-[wallaby-image]: https://img.shields.io/badge/wallaby.js-configured-green.svg
-[wallaby-url]: https://wallabyjs.com

package/{libm/console/createConsoleLogReporter.d.ts → cjs/console.d.ts}

@@ -1,9 +1,9 @@
-import { LogFormatter, LogReporter, LogReporterOptions } from '../types';
-import { Console } from './types';
+import type { ConsoleLike, LogFormatter, LogReporter, LogReporterOptions } from './types.js';
+export declare function toConsoleMethod(level: number): "error" | "warn" | "info" | "debug";
+export declare type ConsoleLogFormatter = LogFormatter<any[]>;
 export declare type ConsoleLogReporter = LogReporter<any[]> & {
-    console: Console;
+    console: ConsoleLike;
 };
-export declare type ConsoleLogFormatter = LogFormatter<any[]>;
 export declare type ConsoleLogReporterOptions = LogReporterOptions<any[]>;
 export declare function createConsoleLogReporter(options?: ConsoleLogReporterOptions): ConsoleLogReporter;
-//# sourceMappingURL=createConsoleLogReporter.d.ts.map
+//# sourceMappingURL=console.d.ts.map

package/cjs/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../ts/console.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAY,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEtG,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,uCAS5C;AAmCD,oBAAY,mBAAmB,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC,CAAA;AACrD,oBAAY,kBAAkB,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,GAAG;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,CAAA;AAC9E,oBAAY,yBAAyB,GAAG,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAA;AAEjE,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,kBAAkB,CAiBhG"}

package/cjs/console.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConsoleLogReporter = exports.toConsoleMethod = void 0;
+var type_plus_1 = require("type-plus");
+var logLevels_js_1 = require("./logLevels.js");
+var platform_js_1 = require("./platform.js");
+var formatter_js_1 = require("./formatter.js");
+function toConsoleMethod(level) {
+    switch (true) {
+        // edge case in case none is somehow written
+        case (level <= 0): return 'debug';
+        case (level <= logLevels_js_1.logLevels.error): return 'error';
+        case (level <= logLevels_js_1.logLevels.warn): return 'warn';
+        case (level <= logLevels_js_1.logLevels.info): return 'info';
+        default: return 'debug';
+    }
+}
+exports.toConsoleMethod = toConsoleMethod;
+// istanbul ignore next
+/* eslint-disable no-console */
+function buildPolyfillConsole() {
+    // old phantomjs does not have bind function
+    var hasBind = !!console.log.bind;
+    if (hasBind) {
+        return {
+            // Node@9.3 or below has `console.debug = undefined` or it doesn't log
+            // Should use `console.log()` in those case.
+            debug: ((0, platform_js_1.isConsoleDebugAvailable)() ? console.debug : console.log).bind(console),
+            // the `typeof` guards against IE where `console.log.apply()`
+            // results in error `Object doesn't support property or method 'apply'`
+            info: (typeof console.info === 'function' ? console.info : console.log).bind(console),
+            warn: (typeof console.warn === 'function' ? console.warn : console.log).bind(console),
+            error: (typeof console.error === 'function' ? console.error : console.log).bind(console)
+        };
+    }
+    else {
+        return {
+            debug: buildFn((0, platform_js_1.isConsoleDebugAvailable)() ? 'debug' : 'log'),
+            info: buildFn(typeof console.info === 'function' ? 'info' : 'log'),
+            warn: buildFn(typeof console.warn === 'function' ? 'warn' : 'log'),
+            error: buildFn(typeof console.error === 'function' ? 'error' : 'log'),
+        };
+    }
+}
+// istanbul ignore next
+function buildFn(name) {
+    return function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        console[name].apply(console, args);
+    };
+}
+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;
+    if (!platform_js_1.polyfill.console)
+        platform_js_1.polyfill.console = buildPolyfillConsole();
+    return Object.freeze({
+        id: id,
+        isConsoleReporter: true,
+        get formatter() { return formatter; },
+        get filter() { return filter; },
+        console: platform_js_1.polyfill.console,
+        write: function (entry) {
+            var _a;
+            if (filter && !filter(entry))
+                return;
+            var values = formatter(entry);
+            var method = toConsoleMethod(entry.level);
+            (_a = this.console)[method].apply(_a, values);
+        }
+    });
+}
+exports.createConsoleLogReporter = createConsoleLogReporter;
+//# sourceMappingURL=console.js.map

package/cjs/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../ts/console.ts"],"names":[],"mappings":"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","sourcesContent":["import { required } from 'type-plus'\nimport { logLevels } from './logLevels.js'\nimport { isConsoleDebugAvailable, polyfill } from './platform.js'\nimport { plainLogFormatter } from './formatter.js'\nimport type { ConsoleLike, LogEntry, LogFormatter, LogReporter, LogReporterOptions } from './types.js'\n\nexport function toConsoleMethod(level: number) {\n  switch (true) {\n    // edge case in case none is somehow written\n    case (level <= 0): return 'debug'\n    case (level <= logLevels.error): return 'error'\n    case (level <= logLevels.warn): return 'warn'\n    case (level <= logLevels.info): return 'info'\n    default: return 'debug'\n  }\n}\n\n// istanbul ignore next\n/* eslint-disable no-console */\nfunction buildPolyfillConsole() {\n  // old phantomjs does not have bind function\n  const hasBind = !!console.log.bind as boolean\n  if (hasBind) {\n    return {\n      // Node@9.3 or below has `console.debug = undefined` or it doesn't log\n      // Should use `console.log()` in those case.\n      debug: (isConsoleDebugAvailable() ? console.debug : console.log).bind(console),\n      // the `typeof` guards against IE where `console.log.apply()`\n      // results in error `Object doesn't support property or method 'apply'`\n      info: (typeof console.info === 'function' ? console.info : console.log).bind(console),\n      warn: (typeof console.warn === 'function' ? console.warn : console.log).bind(console),\n      error: (typeof console.error === 'function' ? console.error : console.log).bind(console)\n    }\n  }\n  else {\n    return {\n      debug: buildFn(isConsoleDebugAvailable() ? 'debug' : 'log'),\n      info: buildFn(typeof console.info === 'function' ? 'info' : 'log'),\n      warn: buildFn(typeof console.warn === 'function' ? 'warn' : 'log'),\n      error: buildFn(typeof console.error === 'function' ? 'error' : 'log'),\n    }\n  }\n}\n\n// istanbul ignore next\nfunction buildFn(name: 'debug' | 'info' | 'warn' | 'error' | 'log') {\n  return function (...args: any[]) { console[name](...args) }\n}\n\n\nexport type ConsoleLogFormatter = LogFormatter<any[]>\nexport type ConsoleLogReporter = LogReporter<any[]> & { console: ConsoleLike }\nexport type ConsoleLogReporterOptions = LogReporterOptions<any[]>\n\nexport function createConsoleLogReporter(options?: ConsoleLogReporterOptions): ConsoleLogReporter {\n  const { id, formatter, filter } = required({ id: 'console', formatter: plainLogFormatter }, options)\n  if (!polyfill.console) polyfill.console = buildPolyfillConsole()\n\n  return Object.freeze({\n    id,\n    isConsoleReporter: true,\n    get formatter() { return formatter },\n    get filter() { return filter },\n    console: polyfill.console,\n    write(entry: LogEntry) {\n      if (filter && !filter(entry)) return\n      const values = formatter(entry)\n      const method = toConsoleMethod(entry.level)\n      this.console[method](...values)\n    }\n  })\n}\n"]}

package/cjs/console.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=console.spec.d.ts.map

package/cjs/console.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.spec.d.ts","sourceRoot":"","sources":["../ts/console.spec.ts"],"names":[],"mappings":""}

package/cjs/console.spec.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var standardLog_js_1 = require("./standardLog.js");
+var index_js_1 = require("./index.js");
+var platform_js_1 = require("./platform.js");
+describe('toConsoleMethod()', function () {
+    it('converts any level to standard console method names: debug, info, warn, error', function () {
+        expect((0, index_js_1.toConsoleMethod)(1)).toEqual('error');
+        expect((0, index_js_1.toConsoleMethod)(399)).toEqual('error');
+        expect((0, index_js_1.toConsoleMethod)(400)).toEqual('error');
+        expect((0, index_js_1.toConsoleMethod)(401)).toEqual('warn');
+        expect((0, index_js_1.toConsoleMethod)(499)).toEqual('warn');
+        expect((0, index_js_1.toConsoleMethod)(500)).toEqual('warn');
+        expect((0, index_js_1.toConsoleMethod)(501)).toEqual('info');
+        expect((0, index_js_1.toConsoleMethod)(700)).toEqual('info');
+        expect((0, index_js_1.toConsoleMethod)(701)).toEqual('debug');
+        expect((0, index_js_1.toConsoleMethod)(800)).toEqual('debug');
+        expect((0, index_js_1.toConsoleMethod)(801)).toEqual('debug');
+        expect((0, index_js_1.toConsoleMethod)(Infinity)).toEqual('debug');
+    });
+    it('converts to debug for 0 (none) or negative (not valid) level', function () {
+        // these are invalid input.
+        // so instead of hiding them and not logged,
+        // log them so that it is easier to discover.
+        expect((0, index_js_1.toConsoleMethod)(-1)).toEqual('debug');
+        expect((0, index_js_1.toConsoleMethod)(0)).toEqual('debug');
+    });
+});
+describe('rendering tests', function () {
+    test('plain rendering', function () {
+        var reporter = (0, index_js_1.createConsoleLogReporter)({ formatter: index_js_1.plainLogFormatter });
+        ['emergency', 'info', 'warn', 'debug'].forEach(function (level) {
+            reporter.write({ id: 'plain', level: index_js_1.logLevels[level], args: ['hello', 'world'], timestamp: new Date() });
+        });
+    });
+});
+describe('createConsoleLogReporter', function () {
+    var fakeConsole = createFakeConsole();
+    beforeEach(function () { return platform_js_1.polyfill.console = fakeConsole = createFakeConsole(); });
+    describe('id', function () {
+        test('default is "console"', function () {
+            var reporter = (0, index_js_1.createConsoleLogReporter)();
+            expect(reporter.id).toBe('console');
+        });
+        test('can be overridden', function () {
+            var reporter = (0, index_js_1.createConsoleLogReporter)({ id: 'neo-console' });
+            expect(reporter.id).toBe('neo-console');
+        });
+    });
+    describe('log level', function () {
+        test('error, alert, critical and emergency logs are written to console.error', function () {
+            var id = 'log';
+            var reporter = (0, index_js_1.createConsoleLogReporter)();
+            reporter.write({ id: id, level: index_js_1.logLevels.emergency, args: ['emergency'], timestamp: new Date() });
+            reporter.write({ id: id, level: index_js_1.logLevels.critical, args: ['critical'], timestamp: new Date() });
+            reporter.write({ id: id, level: index_js_1.logLevels.alert, args: ['alert'], timestamp: new Date() });
+            reporter.write({ id: id, level: index_js_1.logLevels.error, args: ['error'], timestamp: new Date() });
+            expect(fakeConsole.errors.length).toBe(4);
+        });
+        test('warn logs are written to console.warn', function () {
+            var id = 'log';
+            var reporter = (0, index_js_1.createConsoleLogReporter)();
+            reporter.write({ id: id, level: index_js_1.logLevels.warn, args: ['warn'], timestamp: new Date() });
+            expect(fakeConsole.warns.length).toBe(1);
+        });
+        test('notice and info logs are written to console.info', function () {
+            var id = 'log';
+            var reporter = (0, index_js_1.createConsoleLogReporter)();
+            reporter.write({ id: id, level: index_js_1.logLevels.notice, args: ['notice'], timestamp: new Date() });
+            reporter.write({ id: id, level: index_js_1.logLevels.info, args: ['info'], timestamp: new Date() });
+            expect(fakeConsole.infos.length).toBe(2);
+        });
+        test('debug, trace, and planck logs are written to console.debug', function () {
+            var id = 'log';
+            var reporter = (0, index_js_1.createConsoleLogReporter)();
+            reporter.write({ id: id, level: index_js_1.logLevels.debug, args: ['debug'], timestamp: new Date() });
+            reporter.write({ id: id, level: index_js_1.logLevels.trace, args: ['trace'], timestamp: new Date() });
+            reporter.write({ id: id, level: index_js_1.logLevels.planck, args: ['planck'], timestamp: new Date() });
+            expect(fakeConsole.debugs.length).toBe(3);
+        });
+    });
+    describe('custom logs', function () {
+        test('are written according to their log level value', function () {
+            var id = 'log';
+            var reporter = (0, index_js_1.createConsoleLogReporter)();
+            var sl = (0, standardLog_js_1.createStandardLog)({
+                logLevel: index_js_1.logLevels.all,
+                customLevels: {
+                    'high': 50,
+                    'important': 450,
+                    'interest': 650,
+                    'silly': 1000
+                },
+                reporters: [reporter]
+            });
+            var log = sl.getLogger([id]);
+            log.high('a');
+            log.important('b');
+            log.interest('c');
+            log.silly('d');
+            expect(fakeConsole.errors.length).toBe(1);
+            expect(fakeConsole.warns.length).toBe(1);
+            expect(fakeConsole.infos.length).toBe(1);
+            expect(fakeConsole.debugs.length).toBe(1);
+        });
+    });
+    var idFormatter = function (entry) { return [entry.id]; };
+    describe('formatter', function () {
+        test('use specific formatter', function () {
+            var id = 'id-only';
+            var reporter = (0, index_js_1.createConsoleLogReporter)({ formatter: idFormatter });
+            expect(reporter.formatter).toBe(idFormatter);
+            reporter.write({ id: id, level: index_js_1.logLevels.emergency, args: ['emergency'], timestamp: new Date() });
+            expect(fakeConsole.errors).toEqual([['id-only']]);
+        });
+    });
+    describe('filter', function () {
+        var filter = function (entry) { return entry.id !== 'secret'; };
+        test('use specific filter', function () {
+            var reporter = (0, index_js_1.createConsoleLogReporter)({ formatter: idFormatter, filter: filter });
+            expect(reporter.filter).toBe(filter);
+            reporter.write({ id: 'normal', level: index_js_1.logLevels.emergency, args: ['emergency'], timestamp: new Date() });
+            reporter.write({ id: 'secret', level: index_js_1.logLevels.emergency, args: ['emergency'], timestamp: new Date() });
+            expect(fakeConsole.errors).toEqual([['normal']]);
+        });
+    });
+    test('write log entry with multiple arguments', function () {
+        var id = 'log';
+        var reporter = (0, index_js_1.createConsoleLogReporter)({ formatter: index_js_1.plainLogFormatter });
+        var entry = { id: id, level: index_js_1.logLevels.info, args: ['a', 'b', 'c'], timestamp: new Date() };
+        reporter.write(entry);
+        expect(fakeConsole.infos).toEqual([
+            [entry.timestamp.toISOString(), 'log', '(INFO)', 'a', 'b', 'c']
+        ]);
+    });
+});
+function createFakeConsole() {
+    var errors = [];
+    var infos = [];
+    var warns = [];
+    var debugs = [];
+    return {
+        errors: errors,
+        infos: infos,
+        warns: warns,
+        debugs: debugs,
+        error: function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            errors.push(args);
+        },
+        info: function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            infos.push(args);
+        },
+        warn: function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            warns.push(args);
+        },
+        debug: function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            debugs.push(args);
+        }
+    };
+}
+//# sourceMappingURL=console.spec.js.map

package/cjs/console.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.spec.js","sourceRoot":"","sources":["../ts/console.spec.ts"],"names":[],"mappings":"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","sourcesContent":["import { createStandardLog } from './standardLog.js'\nimport {\n  ConsoleLogFormatter, createConsoleLogReporter,\n  LogFilter, logLevels, plainLogFormatter, toConsoleMethod\n} from './index.js'\nimport { polyfill } from './platform.js'\n\ndescribe('toConsoleMethod()', () => {\n  it('converts any level to standard console method names: debug, info, warn, error', () => {\n    expect(toConsoleMethod(1)).toEqual('error')\n    expect(toConsoleMethod(399)).toEqual('error')\n    expect(toConsoleMethod(400)).toEqual('error')\n\n    expect(toConsoleMethod(401)).toEqual('warn')\n    expect(toConsoleMethod(499)).toEqual('warn')\n    expect(toConsoleMethod(500)).toEqual('warn')\n\n    expect(toConsoleMethod(501)).toEqual('info')\n    expect(toConsoleMethod(700)).toEqual('info')\n\n    expect(toConsoleMethod(701)).toEqual('debug')\n    expect(toConsoleMethod(800)).toEqual('debug')\n    expect(toConsoleMethod(801)).toEqual('debug')\n    expect(toConsoleMethod(Infinity)).toEqual('debug')\n  })\n  it('converts to debug for 0 (none) or negative (not valid) level', () => {\n    // these are invalid input.\n    // so instead of hiding them and not logged,\n    // log them so that it is easier to discover.\n    expect(toConsoleMethod(-1)).toEqual('debug')\n    expect(toConsoleMethod(0)).toEqual('debug')\n  })\n})\ndescribe('rendering tests', () => {\n  test('plain rendering', () => {\n    const reporter = createConsoleLogReporter({ formatter: plainLogFormatter });\n    ['emergency', 'info', 'warn', 'debug'].forEach(level => {\n      reporter.write({ id: 'plain', level: (logLevels as any)[level], args: ['hello', 'world'], timestamp: new Date() })\n    })\n  })\n})\n\n\ndescribe('createConsoleLogReporter', () => {\n  let fakeConsole = createFakeConsole()\n  beforeEach(() => polyfill.console = fakeConsole = createFakeConsole())\n\n  describe('id', () => {\n    test('default is \"console\"', () => {\n      const reporter = createConsoleLogReporter()\n      expect(reporter.id).toBe('console')\n    })\n    test('can be overridden', () => {\n      const reporter = createConsoleLogReporter({ id: 'neo-console' })\n      expect(reporter.id).toBe('neo-console')\n    })\n  })\n\n  describe('log level', () => {\n    test('error, alert, critical and emergency logs are written to console.error', () => {\n      const id = 'log'\n      const reporter = createConsoleLogReporter()\n\n      reporter.write({ id, level: logLevels.emergency, args: ['emergency'], timestamp: new Date() })\n      reporter.write({ id, level: logLevels.critical, args: ['critical'], timestamp: new Date() })\n      reporter.write({ id, level: logLevels.alert, args: ['alert'], timestamp: new Date() })\n      reporter.write({ id, level: logLevels.error, args: ['error'], timestamp: new Date() })\n\n      expect(fakeConsole.errors.length).toBe(4)\n    })\n\n    test('warn logs are written to console.warn', () => {\n      const id = 'log'\n      const reporter = createConsoleLogReporter()\n\n      reporter.write({ id, level: logLevels.warn, args: ['warn'], timestamp: new Date() })\n\n      expect(fakeConsole.warns.length).toBe(1)\n    })\n\n    test('notice and info logs are written to console.info', () => {\n      const id = 'log'\n      const reporter = createConsoleLogReporter()\n\n      reporter.write({ id, level: logLevels.notice, args: ['notice'], timestamp: new Date() })\n      reporter.write({ id, level: logLevels.info, args: ['info'], timestamp: new Date() })\n\n      expect(fakeConsole.infos.length).toBe(2)\n    })\n\n\n    test('debug, trace, and planck logs are written to console.debug', () => {\n      const id = 'log'\n      const reporter = createConsoleLogReporter()\n\n      reporter.write({ id, level: logLevels.debug, args: ['debug'], timestamp: new Date() })\n      reporter.write({ id, level: logLevels.trace, args: ['trace'], timestamp: new Date() })\n      reporter.write({ id, level: logLevels.planck, args: ['planck'], timestamp: new Date() })\n\n      expect(fakeConsole.debugs.length).toBe(3)\n    })\n  })\n\n  describe('custom logs', () => {\n    test('are written according to their log level value', () => {\n      const id = 'log'\n      const reporter = createConsoleLogReporter()\n\n      const sl = createStandardLog({\n        logLevel: logLevels.all,\n        customLevels: {\n          'high': 50,\n          'important': 450,\n          'interest': 650,\n          'silly': 1000\n        },\n        reporters: [reporter]\n      })\n      const log = sl.getLogger([id])\n      log.high('a')\n      log.important('b')\n      log.interest('c')\n      log.silly('d')\n\n      expect(fakeConsole.errors.length).toBe(1)\n      expect(fakeConsole.warns.length).toBe(1)\n      expect(fakeConsole.infos.length).toBe(1)\n      expect(fakeConsole.debugs.length).toBe(1)\n    })\n  })\n\n  const idFormatter: ConsoleLogFormatter = (entry) => [entry.id]\n\n  describe('formatter', () => {\n    test('use specific formatter', () => {\n      const id = 'id-only'\n      const reporter = createConsoleLogReporter({ formatter: idFormatter })\n      expect(reporter.formatter).toBe(idFormatter)\n\n      reporter.write({ id, level: logLevels.emergency, args: ['emergency'], timestamp: new Date() })\n\n      expect(fakeConsole.errors).toEqual([['id-only']])\n    })\n  })\n\n  describe('filter', () => {\n    const filter: LogFilter = (entry) => entry.id !== 'secret'\n    test('use specific filter', () => {\n      const reporter = createConsoleLogReporter({ formatter: idFormatter, filter })\n      expect(reporter.filter).toBe(filter)\n\n      reporter.write({ id: 'normal', level: logLevels.emergency, args: ['emergency'], timestamp: new Date() })\n      reporter.write({ id: 'secret', level: logLevels.emergency, args: ['emergency'], timestamp: new Date() })\n\n      expect(fakeConsole.errors).toEqual([['normal']])\n    })\n  })\n\n  test('write log entry with multiple arguments', () => {\n    const id = 'log'\n    const reporter = createConsoleLogReporter({ formatter: plainLogFormatter })\n\n    const entry = { id, level: logLevels.info, args: ['a', 'b', 'c'], timestamp: new Date() }\n\n    reporter.write(entry)\n\n    expect(fakeConsole.infos).toEqual([\n      [entry.timestamp.toISOString(), 'log', '(INFO)', 'a', 'b', 'c']\n    ])\n  })\n})\n\nfunction createFakeConsole() {\n  const errors: any[] = []\n  const infos: any[] = []\n  const warns: any[] = []\n  const debugs: any[] = []\n  return {\n    errors,\n    infos,\n    warns,\n    debugs,\n    error(...args: any[]) { errors.push(args) },\n    info(...args: any[]) { infos.push(args) },\n    warn(...args: any[]) { warns.push(args) },\n    debug(...args: any[]) { debugs.push(args) }\n  }\n}\n"]}

package/cjs/errors.d.ts

@@ -0,0 +1,9 @@
+import { IsoError, ModuleError } from 'iso-error';
+export declare class StandardLogError extends ModuleError {
+    constructor(description: string, options?: IsoError.Options);
+}
+export declare class InvalidId extends StandardLogError {
+    id: string;
+    constructor(id: string, options?: IsoError.Options);
+}
+//# sourceMappingURL=errors.d.ts.map

package/cjs/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../ts/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEjD,qBAAa,gBAAiB,SAAQ,WAAW;gBACnC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO;CAG5D;AACD,qBAAa,SAAU,SAAQ,gBAAgB;IAC1B,EAAE,EAAE,MAAM;gBAAV,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO;CAG1D"}