@e22m4u/ts-rest-router 0.0.6 → 0.1.0

package/dist/esm/utils/create-debugger.js

@@ -1,15 +1,81 @@
-import DebugFactory from 'debug';
+import { inspect } from 'util';
+import DebugModule from 'debug';
 import { format } from '@e22m4u/js-format';
+/**
+ * Colorize string.
+ *
+ * @param input
+ */
+function colorizeString(input) {
+    const c = Number(DebugModule['selectColor'](input));
+    const colorCode = '\u001B[3' + (c < 8 ? c : '8;5;' + c);
+    return `${colorCode};1m${input}\u001B[0m`;
+}
 /**
  * Create debugger.
  *
+ * Base usage:
+ * ```ts
+ * const debug = createDebugger('myService');
+ * debug('Service created.');
+ * // ujut:myService Service created.
+ * ```
+ *
+ * Nested namespaces:
+ * ```ts
+ * const debug1 = debug.bind('namespace1');
+ * const debug2 = debug.bind('namespace2');
+ * debug1('Application started');    // ujut:myService [namespace1] Application started
+ * debug2('Connection established'); // ujut:myService [namespace2] Connection established
+ * ```
+ *
+ * Value inspection:
+ * ```ts
+ * debug({foo: 'lorem', bar: 'ipsum'})
+ * // ujut:myService {
+ * // ujut:myService   "foo": "lorem",
+ * // ujut:myService   "bar": "ipsum"
+ * // ujut:myService }
+ * ```
+ *
+ * Titled inspection output:
+ * ```ts
+ * debug({foo: 'lorem', bar: 'ipsum'}, 'My awesome output:')
+ * // ujut:myService My awesome output:
+ * // ujut:myService {
+ * // ujut:myService   "foo": "lorem",
+ * // ujut:myService   "bar": "ipsum"
+ * // ujut:myService }
+ * ```
+ *
  * @param name
  */
 export function createDebugger(name) {
-    const debug = DebugFactory(`tsRestRouter:${name}`);
+    const debuggerName = `tsRestRouter:${name}`;
+    // включить вывод логов можно принудительно
+    // if (!process.env.DEBUG) DebugModule.enable('ujut*');
+    const debug = DebugModule(debuggerName);
+    return function (messageOrData, 
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    return function (message, ...args) {
-        const interpolatedMessage = format(message, ...args);
-        return debug(interpolatedMessage);
+    ...args) {
+        let prefix = '';
+        if (typeof this === 'string') {
+            const isDebugUsesColors = debug.useColors;
+            prefix = isDebugUsesColors ? colorizeString(`[${this}] `) : `[${this}] `;
+        }
+        if (typeof messageOrData === 'string') {
+            const interpolatedMessage = format(messageOrData, ...args);
+            return debug(prefix + interpolatedMessage);
+        }
+        const inspectOptions = {
+            showHidden: false,
+            depth: null,
+            colors: true,
+            compact: false,
+        };
+        const multiString = inspect(messageOrData, inspectOptions);
+        const rows = multiString.split('\n');
+        const colorizedDebuggerName = colorizeString(debuggerName);
+        [...args, ...rows].forEach(v => console.log(`  ${colorizedDebuggerName} ${prefix}${v}`));
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@e22m4u/ts-rest-router",
-  "version": "0.0.6",
+  "version": "0.1.0",
   "description": "Controllers-based REST router implementation for TypeScript",
   "author": "e22m4u <e22m4u@yandex.ru>",
   "keywords": [
@@ -40,37 +40,37 @@
     "prepare": "husky"
   },
   "dependencies": {
-    "@e22m4u/js-format": "0.1.x",
-    "@e22m4u/js-service": "0.2.x",
-    "@e22m4u/js-trie-router": "0.0.x",
-    "@e22m4u/ts-data-schema": "0.0.x",
-    "@e22m4u/ts-reflector": "0.1.x",
-    "debug": "~4.3.7",
+    "@e22m4u/js-format": "~0.1.0",
+    "@e22m4u/js-service": "~0.2.0",
+    "@e22m4u/js-trie-router": "~0.0.1",
+    "@e22m4u/ts-data-schema": "~0.0.1",
+    "@e22m4u/ts-reflector": "~0.1.0",
+    "debug": "~4.4.0",
     "http-errors": "~2.0.0"
   },
   "devDependencies": {
-    "@commitlint/cli": "~19.6.0",
+    "@commitlint/cli": "~19.6.1",
     "@commitlint/config-conventional": "~19.6.0",
-    "@eslint/js": "~9.15.0",
+    "@eslint/js": "~9.17.0",
     "@types/chai": "~5.0.1",
     "@types/debug": "~4.1.12",
     "@types/http-errors": "~2.0.4",
     "@types/mocha": "~10.0.10",
-    "@types/node": "~22.9.3",
-    "c8": "~10.1.2",
+    "@types/node": "~22.10.2",
+    "c8": "~10.1.3",
     "chai": "~5.1.2",
-    "esbuild": "~0.24.0",
-    "eslint": "~9.15.0",
+    "esbuild": "~0.24.2",
+    "eslint": "~9.17.0",
     "eslint-config-prettier": "~9.1.0",
     "eslint-plugin-chai-expect": "~3.1.0",
     "eslint-plugin-mocha": "~10.5.0",
     "husky": "~9.1.7",
-    "mocha": "~10.8.2",
-    "prettier": "~3.3.3",
+    "mocha": "~11.0.1",
+    "prettier": "~3.4.2",
     "rimraf": "~6.0.1",
     "tsx": "~4.19.2",
-    "typescript": "~5.6.3",
-    "typescript-eslint": "~8.15.0"
+    "typescript": "~5.7.2",
+    "typescript-eslint": "~8.18.2"
   },
   "license": "MIT"
 }