analogger 1.19.0 → 1.20.0

package/CHANGELOG.md

@@ -1,5 +1,7 @@
-# [1.19.0](https://github.com/thimpat/analogger/compare/v1.18.3...v1.19.0) (2022-09-03)
+# [1.20.0](https://github.com/thimpat/analogger/compare/v1.19.0...v1.20.0) (2022-09-05)
 
+# [1.19.0](https://github.com/thimpat/analogger/compare/v1.18.3...v1.19.0) (2022-09-03)
+
 ## [1.18.3](https://github.com/thimpat/analogger/compare/v1.18.2...v1.18.3) (2022-08-31)
 
 ## [1.18.2](https://github.com/thimpat/analogger/compare/v1.18.1...v1.18.2) (2022-08-13)

package/README.md

@@ -97,6 +97,9 @@ import {anaLogger} from "./node_modules/analogger/dist/analogger-browser.min.mjs
 #### FileSystem
 ![img.png](https://github.com/thimpat/analogger/blob/main/docs/images/img_5.png)
 
+#### Remote logging
+![img.png](https://github.com/thimpat/analogger/blob/main/docs/images/img_6.png)
+
 <br/>
 
 ---
@@ -327,12 +330,13 @@ Display the browser native message box if run from it; otherwise, it displays th
 | logToRemote      | undefined   | string (url)                      | _Send log to a remote (more info in the next version)_                             |
 | requiredLogLevel | "LOG"       | "LOG" / "INFO" / "WARN" / "ERROR" | _Define the log level from which the system can show a log entry_                  |
 
+<br/>
 
 ```javascript
 // No hook alert message + Log messages in the div #analogger
 anaLogger.setOptions({hideHookMessage: true, logToDom: "#analogger"})
 ```
-<br/>
+
 <br/>
 
 #### Examples
@@ -353,6 +357,18 @@ anaLogger.setOptions({silent: false, logToFile: logFilePath});
 
 <br/>
 
+##### Write logs to a remote server
+
+```javascript
+// Use a predefined remote server
+anaLogger.setOptions({logToRemote: true});                                           
+
+// Use your remote server (You are resposible for the back-end implementation)
+anaLogger.setOptions({logToRemote: "http://your.server.com/data"});                  
+```
+
+<br/>
+
 ---
 
 ### overrideConsole()
@@ -641,5 +657,63 @@ anaLoggerInstance2.setOptions({logToFile: "./logme.log"});
 ```
 
 <br/>
+
+
+## Take a screenshot
+
+### takeScreenshot()
+
+You can take screenshot via the "html-to-image" plugin (integrated in the module).
+html-to-image is an external module that this module uses to take screenshots.
+
+
+```javascript
+// Load an AnaLogger instance
+import {anaLogger} from "./node_modules/analogger/browser/src/ana-logger.mjs";
+
+// Register the plugin
+import "./node_modules/analogger/browser/src/html-to-image-plugin.mjs";
+
+// Ask AnaLogger to upload the image to the predefined server (not available yet - should be ready by 08/08/2022)
+anaLogger.setOptions({logToRemote: true});
+
+// Take a screenshot then upload to the server
+anaLogger.takeScreenshot({callback: (data) =>
+ {
+    // Add the image to the DOM 
+    const img = new Image();
+    img.src = data;
+    document.body.appendChild(img);
+ }});
+
+
+```
+
 <br/>
 
+---
+
+## Plugins
+
+### Implement a plugin
+
+```javascript
+// Load anaLogger
+import {anaLogger}  from "./ana-logger.mjs";
+
+// Implement
+const doSomething = ({node = document.body, container = document.body} = {}) =>
+{
+    console.log(`Hello plugin`)
+};
+
+// Register the plugin
+anaLogger.addPlugin("doSomething", doSomething);
+
+
+
+```
+
+---
+
+

package/browser/node_modules/flatted/esm/index.mjs

@@ -0,0 +1,94 @@
+/*! (c) 2020 Andrea Giammarchi */
+
+const {parse: $parse, stringify: $stringify} = JSON;
+const {keys} = Object;
+
+const Primitive = String;   // it could be Number
+const primitive = 'string'; // it could be 'number'
+
+const ignore = {};
+const object = 'object';
+
+const noop = (_, value) => value;
+
+const primitives = value => (
+  value instanceof Primitive ? Primitive(value) : value
+);
+
+const Primitives = (_, value) => (
+  typeof value === primitive ? new Primitive(value) : value
+);
+
+const revive = (input, parsed, output, $) => {
+  const lazy = [];
+  for (let ke = keys(output), {length} = ke, y = 0; y < length; y++) {
+    const k = ke[y];
+    const value = output[k];
+    if (value instanceof Primitive) {
+      const tmp = input[value];
+      if (typeof tmp === object && !parsed.has(tmp)) {
+        parsed.add(tmp);
+        output[k] = ignore;
+        lazy.push({k, a: [input, parsed, tmp, $]});
+      }
+      else
+        output[k] = $.call(output, k, tmp);
+    }
+    else if (output[k] !== ignore)
+      output[k] = $.call(output, k, value);
+  }
+  for (let {length} = lazy, i = 0; i < length; i++) {
+    const {k, a} = lazy[i];
+    output[k] = $.call(output, k, revive.apply(null, a));
+  }
+  return output;
+};
+
+const set = (known, input, value) => {
+  const index = Primitive(input.push(value) - 1);
+  known.set(value, index);
+  return index;
+};
+
+export const parse = (text, reviver) => {
+  const input = $parse(text, Primitives).map(primitives);
+  const value = input[0];
+  const $ = reviver || noop;
+  const tmp = typeof value === object && value ?
+              revive(input, new Set, value, $) :
+              value;
+  return $.call({'': tmp}, '', tmp);
+};
+
+export const stringify = (value, replacer, space) => {
+  const $ = replacer && typeof replacer === object ?
+            (k, v) => (k === '' || -1 < replacer.indexOf(k) ? v : void 0) :
+            (replacer || noop);
+  const known = new Map;
+  const input = [];
+  const output = [];
+  let i = +set(known, input, $.call({'': value}, '', value));
+  let firstRun = !i;
+  while (i < input.length) {
+    firstRun = true;
+    output[i] = $stringify(input[i++], replace, space);
+  }
+  return '[' + output.join(',') + ']';
+  function replace(key, value) {
+    if (firstRun) {
+      firstRun = !firstRun;
+      return value;
+    }
+    const after = $.call(this, key, value);
+    switch (typeof after) {
+      case object:
+        if (after === null) return after;
+      case primitive:
+        return known.get(after) || set(known, input, after);
+    }
+    return after;
+  }
+};
+
+export const toJSON = any => $parse(stringify(any));
+export const fromJSON = any => parse($stringify(any));