@alwatr/logger 0.6.0

package/CHANGELOG.md

@@ -0,0 +1,72 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# [0.6.0](https://github.com/AliMD/alwatr/compare/v0.5.0...v0.6.0) (2022-03-11)
+
+
+### Bug Fixes
+
+* alalwatr ([898aa6e](https://github.com/AliMD/alwatr/commit/898aa6ed0888eab9265c83b96a50f1b8c216d143))
+* **packages:** duplicate alwatr keyword ([77d4aa2](https://github.com/AliMD/alwatr/commit/77d4aa2105ad47515c3eee251fd6b8c281d0d1fc))
+
+
+
+
+
+# [0.5.0](https://github.com/AliMD/alwatr/compare/v0.4.0...v0.5.0) (2022-03-11)
+
+### Performance Improvements
+
+* **logger:** refactor making logger object ([bc38018](https://github.com/AliMD/alwatr/commit/bc38018758540130df2f46c44521aea0a867bbe8))
+
+# [0.4.0](https://github.com/AliMD/alwatr/compare/v0.3.0...v0.4.0) (2022-03-11)
+
+### Bug Fixes
+
+* **logger:** types missing ([712363d](https://github.com/AliMD/alwatr/commit/712363d3cf77a712f8c801c4dc9d06d256dfc0e6))
+
+### Features
+
+* **logger:** add logProperty, logMethodFull ([8b0317d](https://github.com/AliMD/alwatr/commit/8b0317db88ed73604a27935a3a30cd5c31cb0804))
+* **logger:** complete refactor the logger with new API and fix show correct line number ([7efe8cf](https://github.com/AliMD/alwatr/commit/7efe8cf0f566e148406f38fdd60fa3d747c9bc51))
+
+# [0.3.0](https://github.com/AliMD/alwatr/compare/v0.2.1...v0.3.0) (2022-03-06)
+
+**Note:** Version bump only for package @alwatr/logger
+
+## [0.2.1](https://github.com/AliMD/alwatr/compare/v0.2.0...v0.2.1) (2022-03-05)
+
+### Bug Fixes
+
+* **logger:** alwatrRegisteredList name ([ff59133](https://github.com/AliMD/alwatr/commit/ff5913321c4eafa1ce53fdacebf8fb4f23bfe430))
+
+# [0.2.0](https://github.com/AliMD/alwatr/compare/v0.1.2...v0.2.0) (2022-03-05)
+
+**Note:** Version bump only for package @alwatr/logger
+
+## [0.1.2](https://github.com/AliMD/alwatr/compare/v0.1.1...v0.1.2) (2022-03-03)
+
+**Note:** Version bump only for package @alwatr/logger
+
+## [0.1.1](https://github.com/AliMD/alwatr/compare/v0.1.0...v0.1.1) (2022-03-03)
+
+### Bug Fixes
+
+* **packages:** add publish config to public ([9cb3710](https://github.com/AliMD/alwatr/commit/9cb37106b5a35d24d5195ff54232e5769ccc034e))
+
+# 0.1.0 (2022-03-02)
+
+### Bug Fixes
+
+* **logger:** fix debug scope ([be62f14](https://github.com/AliMD/alwatr/commit/be62f142cbe3fe4d328e3fd9941ea7c2d640a23f))
+* **logger:** fix logger debug scope ([e734d21](https://github.com/AliMD/alwatr/commit/e734d218db888ecec33a03dc805b98dd75543efd))
+* tsconfig issues ([159adeb](https://github.com/AliMD/alwatr/commit/159adeb72de4626dc16f6657765605b0a2ddccb1))
+
+### Features
+
+* **logger:** debug scope ([6e4190d](https://github.com/AliMD/alwatr/commit/6e4190dc9dafc28e3a7a481aa43622a23527993c))
+* **logger:** debug scope logger package ([1a4baeb](https://github.com/AliMD/alwatr/commit/1a4baeb7a253ba66563dbcf06079242dabb9f246))
+* **logger:** alwatr logger package ([711268e](https://github.com/AliMD/alwatr/commit/711268e17dea8ada9c901ef1e9d605b3212abd97))
+* **logger:** alwatr meta structure ([feade73](https://github.com/AliMD/alwatr/commit/feade735a6f141db77b81d7791d8872d45c8bf7e))

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 S. Ali Mihandoost
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,140 @@
+# @alwatr/logger
+
+Fancy colorful console debugger with custom scope written in tiny TypeScript, ES module.
+
+## Example usage
+
+```ts
+import { createLogger } from 'https://esm.run/@alwatr/logger';
+
+const logger = createLogger('demo');
+
+function sayHello (name: string) {
+  logger.logMethodArgs('sayHello', {name});
+}
+```
+
+### Debug Mode
+
+Many of the methods in the logger are no-ops when the debug mode is off.  
+Please remember to **reload** the window after changing the debug mode.
+
+- Debugging all scopes
+
+  ```ts
+  window.localStorage?.setItem('ALWATR_LOG', '*');
+  ```
+
+- Debugging specific scope
+
+  ```ts
+  window.localStorage?.setItem('ALWATR_LOG', 'scope_name');
+  ```
+
+- Debugging some scopes with pattern
+
+  ```ts
+  window.localStorage?.setItem('ALWATR_LOG', '*alwatr*');
+  ```
+
+### API
+
+### Prepare the logger
+
+```ts
+import {createLogger} from 'https://esm.run/@alwatr/logger';
+const logger = createLogger('logger/demo', 'green');
+```
+
+### `logProperty(property, value)`
+
+`console.debug` property change.
+
+Example:
+
+```ts
+logger.logProperty('name', 'ali');
+```
+
+### `logMethod(method)`
+
+`console.debug` function or method calls.
+
+Example:
+
+```ts
+function myMethod () {
+  logger.logMethod('myMethod');
+}
+```
+
+### `logMethodArgs(method, args)`
+
+`console.debug` function or method calls with arguments.
+
+Example:
+
+```ts
+function myMethod (a: number, b: number) {
+  logger.logMethodArgs('myMethod', {a, b});
+}
+```
+
+### `logMethodFull(method, args, result)`
+
+`console.debug` function or method calls with arguments.
+
+Example:
+
+```ts
+function add (a: number, b: number): number {
+  const result = a + b;
+  logger.logMethodFull('add', {a, b}, result);
+  return result;
+}
+```
+
+### `incident(method, code, description, ...args)`
+
+`console.trace` an event or expected accident. (not warn or error)
+
+Example:
+
+```ts
+logger.incident('fetch', 'abort_signal', 'aborted signal received', {url: '/test.json'});
+```
+
+### `accident(method, code, description, ...args)`
+
+`console.warn` an unexpected accident or error that you handled.
+
+Example:
+
+```ts
+logger.accident('fetch', 'file_not_found', 'url requested return 404 not found', {url: '/test.json'});
+```
+
+### `error(method, code, errorStack, ...args)`
+
+`console.error` an unexpected error.
+
+Example:
+
+```ts
+try {
+  ...
+}
+catch (err) {
+  logger.error('myMethod', 'error_code', (err as Error).stack || err, {a: 1, b: 2});
+}
+```
+
+### `logOther(...args)`
+
+Simple `console.debug` with styled scope.
+
+Example:
+
+```ts
+logger.logOther('foo:', 'bar', {a: 1});
+```

package/logger.d.ts

@@ -0,0 +1,23 @@
+import type { Logger } from './type';
+/**
+ * Define `window.Alwatr.registeredList`
+ */
+export declare const alwatrRegisteredList: {
+    name: string;
+    version: string;
+}[];
+export declare const style: {
+    scope: string;
+    reset: string;
+};
+/**
+ * Create a logger function for fancy console debug with custom scope.
+ *
+ * @example
+ *  const logger = createLogger('demo');
+ *  function sayHello (name: string) {
+ *    logger.logMethodArgs('sayHello', {name});
+ *  }
+ */
+export declare const createLogger: (scope: string, color?: string, force?: boolean) => Logger;
+//# sourceMappingURL=logger.d.ts.map

package/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;GAAsC,CAAC;AAoExE,eAAO,MAAM,KAAK;;;CAGjB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,UACd,MAAM,UACN,MAAM,sBAEd,MAsGF,CAAC"}

package/logger.js

@@ -0,0 +1,112 @@
+var _a, _b, _c, _d;
+/**
+ * Define `window.Alwatr.registeredList`
+ */
+export const alwatrRegisteredList = ((_a = window.Alwatr) === null || _a === void 0 ? void 0 : _a.registeredList) || [];
+(_b = window.Alwatr) !== null && _b !== void 0 ? _b : (window.Alwatr = {});
+window.Alwatr.registeredList = alwatrRegisteredList;
+alwatrRegisteredList.push({
+    name: '@alwatr/logger',
+    version: '{{ALWATR_VERSION}}', // TODO: replace with real version at release time.
+});
+/**
+ * Color list storage for logger.
+ */
+let colorIndex = 0;
+const colorList = [
+    '#f05561',
+    '#35b997',
+    '#ee224a',
+    '#91c13e',
+    '#22af4b',
+    '#f0e995',
+    '#0fe995',
+    '#0f89ca',
+    '#08b9a5',
+    '#fee851',
+    '#ee573d',
+    '#f9df30',
+    '#1da2dc',
+    '#f05123',
+    '#ee2524',
+];
+const getNextColor = () => {
+    const color = colorList[colorIndex];
+    colorIndex++;
+    if (colorIndex >= colorList.length) {
+        colorIndex = 0;
+    }
+    return color;
+};
+const debugString = (_d = (_c = window.localStorage) === null || _c === void 0 ? void 0 : _c.getItem('ALWATR_LOG')) === null || _d === void 0 ? void 0 : _d.trim();
+const getDebugState = (scope, force) => {
+    if (debugString == null ||
+        debugString == '') {
+        return false;
+    }
+    if (force ||
+        debugString === scope ||
+        (debugString.indexOf('*') === 0 && // starts with `*` for example: `*alwatr*`
+            scope.indexOf(debugString.replaceAll('*', '')) !== -1) ||
+        (debugString.indexOf('*') === debugString.length - 1 && // ends with `*` for example: `alwatr/*`
+            scope.indexOf(debugString.replaceAll('*', '')) === 0)) {
+        return true;
+    }
+    // else
+    return false;
+};
+export const style = {
+    scope: 'color: {{color}};',
+    reset: 'color: inherit;',
+};
+/**
+ * Create a logger function for fancy console debug with custom scope.
+ *
+ * @example
+ *  const logger = createLogger('demo');
+ *  function sayHello (name: string) {
+ *    logger.logMethodArgs('sayHello', {name});
+ *  }
+ */
+export const createLogger = (scope, color = getNextColor(), force = false) => {
+    scope = scope.trim();
+    const debug = getDebugState(scope, force);
+    const first = scope.charAt(0);
+    if (first !== '[' && first !== '{' && first !== '(' && first !== '<') {
+        scope = '[' + scope + ']';
+    }
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    const empty = () => { };
+    const styleScope = style.scope.replaceAll('{{color}}', color);
+    /**
+     * Required logger object, accident, error always reported even when the debug is false.
+     */
+    const requiredItems = {
+        color,
+        scope,
+        accident: console.warn.bind(console, '%c%s%c.%s => Accident: "%s" (%s)!', styleScope, scope, style.reset),
+        error: console.error.bind(console, '%c%s%c.%s "%s" =>', styleScope, scope, style.reset),
+    };
+    if (!debug) {
+        return {
+            ...requiredItems,
+            logProperty: empty,
+            logMethod: empty,
+            logMethodArgs: empty,
+            logMethodFull: empty,
+            incident: empty,
+            logOther: empty,
+        };
+    }
+    // else if debug is true for this scope
+    return {
+        ...requiredItems,
+        logProperty: console.debug.bind(console, '%c%s%c.%s = %o;', styleScope, scope, style.reset),
+        logMethod: console.debug.bind(console, '%c%s%c.%s();', styleScope, scope, style.reset),
+        logMethodArgs: console.debug.bind(console, '%c%s%c.%s(%o);', styleScope, scope, style.reset),
+        logMethodFull: console.debug.bind(console, '%c%s%c.%s(%o); // %o', styleScope, scope, style.reset),
+        incident: console.trace.bind(console, '%c%s%c.%s() => Incident: "%s" (%s)!', styleScope, scope, style.reset),
+        logOther: console.debug.bind(console, '%c%s', styleScope, scope),
+    };
+};
+//# sourceMappingURL=logger.js.map

package/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["src/logger.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@alwatr/logger",
+  "version": "0.6.0",
+  "description": "Fancy colorful console debugger with custom scope written in tiny TypeScript, ES module.",
+  "keywords": [
+    "log",
+    "logger",
+    "console",
+    "debug",
+    "typescript",
+    "esm",
+    "alwatr"
+  ],
+  "main": "logger.js",
+  "type": "module",
+  "types": "logger.d.ts",
+  "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com> (https://ali.mihandoost.com)",
+  "license": "MIT",
+  "files": [
+    "**/*.js",
+    "**/*.d.ts",
+    "**/*.map",
+    "**/*.html",
+    "**/*.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AliMD/alwatr",
+    "directory": "package/logger"
+  },
+  "homepage": "https://github.com/AliMD/alwatr/tree/main/package/logger#readme",
+  "bugs": {
+    "url": "https://github.com/AliMD/alwatr/issues"
+  },
+  "dependencies": {
+    "tslib": "^2.3.1"
+  },
+  "gitHead": "8ed13adce22d7bb0cc24eb17c9f8ecfb6bbe8553"
+}

package/type.d.ts

@@ -0,0 +1,114 @@
+declare global {
+    interface Window {
+        Alwatr?: {
+            registeredList?: Array<{
+                name: string;
+                version: string;
+            }>;
+        };
+    }
+    /**
+     * @TODO: Make an issue to TS, WTF is this way! any better solution for more args in bind?!
+     */
+    interface CallableFunction {
+        bind<T, A0, A1, A2, A3, A4, A extends unknown[], R>(this: (this: T, arg0: A0, arg1: A1, arg2: A2, arg3: A3, arg4: A4, ...args: A) => R, thisArg: T, arg0: A0, arg1: A1, arg2: A2, arg3: A3, arg4: A4): (...args: A) => R;
+    }
+}
+export interface Logger {
+    readonly color: string;
+    readonly scope: string;
+    /**
+     * `console.debug` property change.
+     *
+     * Example:
+     *
+     * ```ts
+     * logger.logProperty('name', 'ali');
+     * ```
+     */
+    logProperty(property: string, value: unknown): void;
+    /**
+     * `console.debug` function or method calls.
+     *
+     * Example:
+     *
+     * ```ts
+     * function myMethod () {
+     *   logger.logMethod('myMethod');
+     * }
+     * ```
+     */
+    logMethod(method: string): void;
+    /**
+     * `console.debug` function or method calls with arguments.
+     *
+     * Example:
+     *
+     * ```ts
+     * function myMethod (a: number, b: number) {
+     *   logger.logMethodArgs('myMethod', {a, b});
+     * }
+     * ```
+     */
+    logMethodArgs(method: string, args: Record<string, unknown> | string | number | boolean): void;
+    /**
+     * `console.debug` function or method calls with arguments.
+     *
+     * Example:
+     *
+     * ```ts
+     * function add (a: number, b: number): number {
+     *   const result = a + b;
+     *   logger.logMethodFull('add', {a, b}, result);
+     *   return result;
+     * }
+     * ```
+     */
+    logMethodFull(method: string, args: Record<string, unknown> | string | number | boolean, result: unknown): void;
+    /**
+     * `console.trace` an event or expected accident. (not warn or error)
+     *
+     * Example:
+     *
+     * ```ts
+     * logger.incident('fetch', 'abort_signal', 'aborted signal received', {url: '/test.json'});
+     * ```
+     */
+    incident(method: string, code: string, desc: string, ...args: unknown[]): void;
+    /**
+     * `console.warn` an unexpected accident or error that you handled.
+     *
+     * Example:
+     *
+     * ```ts
+     * logger.accident('fetch', 'file_not_found', 'url requested return 404 not found', {url: '/test.json'});
+     * ```
+     */
+    accident(method: string, code: string, desc: string, ...args: unknown[]): void;
+    /**
+     * `console.error` an unexpected error.
+     *
+     * Example:
+     *
+     * ```ts
+     * try {
+     *   ...
+     * }
+     * catch (err) {
+     *   logger.error('myMethod', 'error_code', (err as Error).stack || err, {a: 1, b: 2});
+     * }
+     * ```
+     */
+    error(method: string, code: string, errorStack: string | unknown, ...args: unknown[]): void;
+    /**
+     * Simple `console.debug` with styled scope.
+     *
+     * Example:
+     *
+     * ```ts
+     * logger.logOther('foo:', 'bar', {a: 1});
+     * ```
+     */
+    logOther(...args: unknown[]): void;
+}
+//# sourceMappingURL=type.d.ts.map

package/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["src/type.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,MAAM,CAAC,EAAE;YACP,cAAc,CAAC,EAAE,KAAK,CAAC;gBACrB,IAAI,EAAE,MAAM,CAAC;gBACb,OAAO,EAAE,MAAM,CAAC;aACjB,CAAC,CAAC;SACJ,CAAA;KACF;IAED;;OAEG;IACH,UAAU,gBAAgB;QACxB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC/C,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,KACxE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;KAC5F;CACF;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;;;;;;OAQG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAEpD;;;;;;;;;;OAUG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAE/F;;;;;;;;;;;;OAYG;IACF,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAEjH;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE/E;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE/E;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE5F;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACpC"}

package/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["src/type.ts"],"names":[],"mappings":""}