feat(log): Add MemoryLog class (#11)

Author: ibgreen

docs/modules/log/log.md

@@ -8,6 +8,15 @@ A simple console wrapper with a host of features
 * Image logging - In Chrome console, it is possible log images
 * Improved `assert` messages - Reformats errors from `assert` to show actual error string
 
+## Logger implementations
+
+`@probe.gl/log` exports a few logger classes:
+
+- `ProbeLog` is the full-featured logger with log levels, persistence, and formatting controls. It is exported as `Log` and provided as the default instance export. (It was previously named `ConsoleLog`.)
+- `ConsoleLog` is a minimal wrapper around the runtime `console`, intended for situations where you want the `Logger` interface without configuration or persistence.
+- `MemoryLog` records messages in memory, typically for tests, and accepts an optional `onMessage` callback that fires when a new message is stored.
+- `BaseLog` is a shared base class you can extend to build new `Logger` implementations with consistent log-level handling and `once` de-duplication.
+
 
 ## Installing
 
@@ -129,6 +138,8 @@ Log a normal message, but only once, no console flooding
 
 Returns: a function closure that should be called immediately.
 
+Calling `once` multiple times with the same message will only log the first call for both `ProbeLog`/`Log` and the lightweight `ConsoleLog`. The `MemoryLog` implementation also mirrors this behavior by capturing a single entry.
+
 
 ### probe
 
@@ -250,4 +261,3 @@ Provides an exception safe way to run some code within a group
 ### trace
 
 Prints a stack trace
-

docs/whats-new.md

@@ -1,5 +1,10 @@
 # What's New
 
+## v4.1 (Unreleased)
+
+- **@probe.gl/log** - Renamed the feature-rich `ConsoleLog` class to `ProbeLog` (still exported as `Log` and as the default instance) and added a lightweight `ConsoleLog` wrapper around the runtime console, with shared behavior factored into a new `BaseLog`.
+- **@probe.gl/log** - Added per-logger `once` caching to both the lightweight `ConsoleLog` and `MemoryLog` implementations, and `MemoryLog` now supports an `onMessage` callback that fires when new messages are recorded.
+
 ## v4.0
 
 Release Date: Feb 10, 2023

modules/log/src/index.ts

@@ -1,13 +1,18 @@
-import {Log} from './log';
+import {ProbeLog} from './loggers/probe-log';
 
 // DEFAULT EXPORT IS A LOG INSTANCE
-export default new Log({id: '@probe.gl/log'});
+export default new ProbeLog({id: '@probe.gl/log'});
 
 // LOGGING
-export {Log} from './log';
-export {COLOR} from './utils/color';
+export type {Logger} from './loggers/logger';
+export {ProbeLog, ProbeLog as Log} from './loggers/probe-log';
+export {ConsoleLog} from './loggers/console-log';
+export {BaseLog} from './loggers/base-log';
+export type {MemoryLogMessage} from './loggers/memory-log';
+export {MemoryLog} from './loggers/memory-log';
 
 // UTILITIES
+export {COLOR} from './utils/color';
 export {addColor} from './utils/color';
 export {leftPad, rightPad} from './utils/formatters';
 export {autobind} from './utils/autobind';