debug-better 1.0.0

package/dist/node.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Node.js implementation of debug-utility
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+const tty = __importStar(require("tty"));
+const util = __importStar(require("util"));
+const common_1 = require("./common");
+/**
+ * Colors for Node.js (ANSI color codes)
+ */
+const colors = [
+    20, 21, 26, 27, 32, 33, 38, 39, 40, 41, 42, 43, 44, 45, 56, 57, 62, 63, 68, 69, 74, 75, 76, 77,
+    78, 79, 80, 81, 92, 93, 98, 99, 112, 113, 128, 129, 134, 135, 148, 149, 160, 161, 162, 163, 164,
+    165, 166, 167, 168, 169, 170, 171, 172, 173, 178, 179, 184, 185, 196, 197, 198, 199, 200, 201,
+    202, 203, 204, 205, 206, 207, 208, 209, 214, 215, 220, 221,
+];
+/**
+ * Check if supports-color is available (optional dependency)
+ */
+try {
+    const supportsColor = require('supports-color');
+    if (supportsColor && (supportsColor.stderr || supportsColor).level >= 2) {
+        // Use extended color palette if available
+    }
+}
+catch (e) {
+    // supports-color is optional
+}
+/**
+ * Build inspect options from environment variables
+ */
+const inspectOpts = Object.keys(process.env)
+    .filter((key) => /^debug_/i.test(key))
+    .reduce((obj, key) => {
+    // Convert DEBUG_COLORS to colors
+    const prop = key
+        .substring(6)
+        .toLowerCase()
+        .replace(/_([a-z])/g, (_, k) => k.toUpperCase());
+    // Coerce string value
+    let val = process.env[key];
+    if (/^(yes|on|true|enabled)$/i.test(val)) {
+        val = true;
+    }
+    else if (/^(no|off|false|disabled)$/i.test(val)) {
+        val = false;
+    }
+    else if (val === 'null') {
+        val = null;
+    }
+    else {
+        val = Number(val);
+    }
+    obj[prop] = val;
+    return obj;
+}, {});
+/**
+ * Check if colors should be used
+ */
+function useColors() {
+    if ('colors' in inspectOpts) {
+        return Boolean(inspectOpts.colors);
+    }
+    return tty.isatty(process.stderr.fd);
+}
+/**
+ * Format arguments with ANSI colors
+ */
+function formatArgs(args) {
+    const { namespace, useColors: shouldUseColors } = this;
+    if (shouldUseColors) {
+        const c = this.color;
+        const colorCode = '\u001B[3' + (c < 8 ? c : '8;5;' + c);
+        const prefix = `  ${colorCode};1m${namespace} \u001B[0m`;
+        args[0] = prefix + args[0].split('\n').join('\n' + prefix);
+        args.push(colorCode + 'm+' + ms(this.diff) + '\u001B[0m');
+    }
+    else {
+        args[0] = getDate() + namespace + ' ' + args[0];
+    }
+}
+/**
+ * Get formatted date
+ */
+function getDate() {
+    if (inspectOpts.hideDate) {
+        return '';
+    }
+    return new Date().toISOString() + ' ';
+}
+/**
+ * Log to stderr
+ */
+function log(...args) {
+    process.stderr.write(util.formatWithOptions(inspectOpts, ...args) + '\n');
+}
+/**
+ * Save namespaces to environment
+ */
+function save(namespaces) {
+    if (namespaces) {
+        process.env.DEBUG = namespaces;
+    }
+    else {
+        delete process.env.DEBUG;
+    }
+}
+/**
+ * Load namespaces from environment
+ */
+function load() {
+    return process.env.DEBUG || '';
+}
+/**
+ * Destroy function (deprecated)
+ */
+function destroy() {
+    console.warn('Instance method `debug.destroy()` is deprecated and no longer does anything.');
+}
+/**
+ * Initialize a debug instance (optional)
+ */
+function init(debug) {
+    // Initialization logic can be added here if needed
+    debug.inspectOpts = inspectOpts;
+}
+// Import ms for humanizing time
+const ms = require("ms");
+/**
+ * Create environment config for Node.js
+ */
+const nodeEnv = {
+    formatArgs,
+    save,
+    load,
+    useColors,
+    colors,
+    log,
+    inspectOpts,
+    init,
+    destroy,
+};
+module.exports = (0, common_1.setup)(nodeEnv);
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Core type definitions for debug-utility
+ */
+/**
+ * Filter predicate function type
+ */
+export type FilterPredicate = (namespace: string, ...args: any[]) => boolean;
+/**
+ * Formatter function type
+ */
+export type FormatterFunction = (value: any) => string;
+/**
+ * Log function type
+ */
+export type LogFunction = (...args: any[]) => void;
+/**
+ * Filter options for advanced filtering
+ */
+export interface FilterOptions {
+    /** Enable/disable filtering */
+    enabled?: boolean;
+    /** Regular expression patterns to match */
+    patterns?: RegExp[];
+    /** Custom predicate functions */
+    predicates?: FilterPredicate[];
+    /** Minimum log level (if using levels) */
+    minLevel?: number;
+    /** Maximum log level (if using levels) */
+    maxLevel?: number;
+    /** Custom tags to filter by */
+    tags?: string[];
+    /** Include these namespaces */
+    include?: string[];
+    /** Exclude these namespaces */
+    exclude?: string[];
+}
+/**
+ * Debug instance options
+ */
+export interface DebugOptions {
+    /** Custom namespace */
+    namespace?: string;
+    /** Enable/disable colors */
+    useColors?: boolean;
+    /** Custom color */
+    color?: string | number;
+    /** Hide timestamp */
+    hideDate?: boolean;
+    /** Custom log function */
+    log?: LogFunction;
+    /** Filter options */
+    filter?: FilterOptions;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Debug instance interface
+ */
+export interface Debugger {
+    /** The namespace of this debugger instance */
+    namespace: string;
+    /** Whether colors are enabled */
+    useColors: boolean;
+    /** The color assigned to this instance */
+    color: string | number;
+    /** Time difference from previous log */
+    diff: number;
+    /** Previous log timestamp */
+    prev: number;
+    /** Current log timestamp */
+    curr: number;
+    /** Whether this debugger is enabled */
+    enabled: boolean;
+    /** The log function */
+    log: LogFunction;
+    /** Metadata attached to this instance */
+    metadata: Record<string, any>;
+    /** Log a message */
+    (...args: any[]): void;
+    /** Extend this debugger with a sub-namespace */
+    extend(namespace: string, delimiter?: string): Debugger;
+    /** Destroy this debugger instance (deprecated) */
+    destroy(): void;
+    /** Set filter options for this instance */
+    setFilter(filter: FilterOptions): void;
+    /** Add metadata to this instance */
+    setMetadata(key: string, value: any): void;
+    /** Get metadata from this instance */
+    getMetadata(key: string): any;
+}
+/**
+ * Debug factory interface
+ */
+export interface DebugFactory {
+    /** Create a new debugger instance */
+    (namespace: string, options?: DebugOptions): Debugger;
+    /** Available colors */
+    colors: (string | number)[];
+    /** Named namespaces that are enabled */
+    names: string[];
+    /** Named namespaces that are skipped */
+    skips: string[];
+    /** Current namespace configuration */
+    namespaces: string;
+    /** Custom formatters */
+    formatters: Record<string, FormatterFunction>;
+    /** Inspect options (Node.js specific) */
+    inspectOpts?: Record<string, any>;
+    /** Enable debug output */
+    enable(namespaces: string): void;
+    /** Disable debug output */
+    disable(): string;
+    /** Check if a namespace is enabled */
+    enabled(name: string): boolean;
+    /** Humanize time differences */
+    humanize: (ms: number) => string;
+    /** Select a color for a namespace */
+    selectColor(namespace: string): string | number;
+    /** Coerce a value */
+    coerce(val: any): any;
+    /** Format arguments (environment-specific) */
+    formatArgs(args: any[]): void;
+    /** Log function (environment-specific) */
+    log: LogFunction;
+    /** Save namespaces (environment-specific) */
+    save(namespaces: string): void;
+    /** Load namespaces (environment-specific) */
+    load(): string;
+    /** Use colors check (environment-specific) */
+    useColors(): boolean;
+    /** Initialize a debug instance (environment-specific) */
+    init?(debug: Debugger): void;
+    /** Destroy function (deprecated) */
+    destroy(): void;
+    /** Set global filter options */
+    setGlobalFilter(filter: FilterOptions): void;
+    /** Get global filter options */
+    getGlobalFilter(): FilterOptions;
+}
+/**
+ * Environment-specific configuration
+ */
+export interface EnvironmentConfig {
+    /** Format arguments for output */
+    formatArgs: (args: any[]) => void;
+    /** Save namespace configuration */
+    save: (namespaces: string) => void;
+    /** Load namespace configuration */
+    load: () => string;
+    /** Check if colors should be used */
+    useColors: () => boolean;
+    /** Available colors */
+    colors: (string | number)[];
+    /** Log function */
+    log: LogFunction;
+    /** Inspect options */
+    inspectOpts?: Record<string, any>;
+    /** Storage mechanism (browser) */
+    storage?: Storage | null;
+    /** Initialize function */
+    init?: (debug: Debugger) => void;
+    /** Destroy function */
+    destroy: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Core type definitions for debug-utility
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "debug-better",
+  "version": "1.0.0",
+  "description": "Advanced TypeScript debugging utility with filtering capabilities for Node.js and browser",
+  "keywords": [
+    "debug",
+    "log",
+    "debugger",
+    "typescript",
+    "filtering",
+    "logger",
+    "utility"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "browser": "./dist/browser.js",
+  "files": [
+    "dist",
+    "src",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "node dist/examples/test.js",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write \"src/**/*.ts\""
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "ms": "^2.1.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/ms": "^0.7.34",
+    "typescript": "^5.3.3",
+    "eslint": "^8.55.0",
+    "@typescript-eslint/eslint-plugin": "^6.14.0",
+    "@typescript-eslint/parser": "^6.14.0",
+    "prettier": "^3.1.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/yourusername/debug-utility.git"
+  },
+  "author": "Your Name",
+  "license": "MIT"
+}

package/src/browser.ts

@@ -0,0 +1,199 @@
+/**
+ * Browser implementation of debug-utility
+ */
+
+import { setup } from './common';
+import { EnvironmentConfig, Debugger } from './types';
+
+/**
+ * Colors for browser (hex codes)
+ */
+const colors = [
+  '#0000CC', '#0000FF', '#0033CC', '#0033FF', '#0066CC', '#0066FF', '#0099CC', '#0099FF',
+  '#00CC00', '#00CC33', '#00CC66', '#00CC99', '#00CCCC', '#00CCFF', '#3300CC', '#3300FF',
+  '#3333CC', '#3333FF', '#3366CC', '#3366FF', '#3399CC', '#3399FF', '#33CC00', '#33CC33',
+  '#33CC66', '#33CC99', '#33CCCC', '#33CCFF', '#6600CC', '#6600FF', '#6633CC', '#6633FF',
+  '#66CC00', '#66CC33', '#9900CC', '#9900FF', '#9933CC', '#9933FF', '#99CC00', '#99CC33',
+  '#CC0000', '#CC0033', '#CC0066', '#CC0099', '#CC00CC', '#CC00FF', '#CC3300', '#CC3333',
+  '#CC3366', '#CC3399', '#CC33CC', '#CC33FF', '#CC6600', '#CC6633', '#CC9900', '#CC9933',
+  '#CCCC00', '#CCCC33', '#FF0000', '#FF0033', '#FF0066', '#FF0099', '#FF00CC', '#FF00FF',
+  '#FF3300', '#FF3333', '#FF3366', '#FF3399', '#FF33CC', '#FF33FF', '#FF6600', '#FF6633',
+  '#FF9900', '#FF9933', '#FFCC00', '#FFCC33',
+];
+
+/**
+ * Get localStorage safely
+ */
+function localstorage(): Storage | null {
+  try {
+    if (typeof window !== 'undefined' && window.localStorage) {
+      return window.localStorage;
+    }
+    return null;
+  } catch (e) {
+    return null;
+  }
+}
+
+const storage = localstorage();
+
+/**
+ * Check if colors should be used in browser
+ */
+function useColors(): boolean {
+  // Electron renderer
+  if (
+    typeof window !== 'undefined' &&
+    (window as any).process &&
+    ((window as any).process.type === 'renderer' || (window as any).process.__nwjs)
+  ) {
+    return true;
+  }
+
+  // Internet Explorer and Edge do not support colors
+  if (
+    typeof navigator !== 'undefined' &&
+    navigator.userAgent &&
+    navigator.userAgent.toLowerCase().match(/(edge|trident)\/(\d+)/)
+  ) {
+    return false;
+  }
+
+  // Check for various browser capabilities
+  return (
+    (typeof document !== 'undefined' &&
+      document.documentElement &&
+      document.documentElement.style &&
+      (document.documentElement.style as any).WebkitAppearance) ||
+    (typeof window !== 'undefined' &&
+      (window as any).console &&
+      ((window as any).console.firebug ||
+        ((window as any).console.exception && (window as any).console.table))) ||
+    (typeof navigator !== 'undefined' &&
+      navigator.userAgent &&
+      navigator.userAgent.toLowerCase().match(/firefox\/(\d+)/) &&
+      parseInt(RegExp.$1, 10) >= 31) ||
+    (typeof navigator !== 'undefined' &&
+      navigator.userAgent &&
+      navigator.userAgent.toLowerCase().match(/applewebkit\/(\d+)/))
+  );
+}
+
+/**
+ * Format arguments with browser colors
+ */
+function formatArgs(this: Debugger, args: any[]): void {
+  args[0] =
+    (this.useColors ? '%c' : '') +
+    this.namespace +
+    (this.useColors ? ' %c' : ' ') +
+    args[0] +
+    (this.useColors ? '%c ' : ' ') +
+    '+' +
+    ms(this.diff);
+
+  if (!this.useColors) {
+    return;
+  }
+
+  const c = 'color: ' + this.color;
+  args.splice(1, 0, c, 'color: inherit');
+
+  // Handle %c positioning
+  let index = 0;
+  let lastC = 0;
+  args[0].replace(/%[a-zA-Z%]/g, (match: string) => {
+    if (match === '%%') {
+      return match;
+    }
+    index++;
+    if (match === '%c') {
+      lastC = index;
+    }
+    return match;
+  });
+
+  args.splice(lastC, 0, c);
+}
+
+/**
+ * Log function for browser
+ */
+const log =
+  typeof console !== 'undefined' && typeof console.debug === 'function'
+    ? console.debug.bind(console)
+    : typeof console !== 'undefined' && typeof console.log === 'function'
+    ? console.log.bind(console)
+    : (): void => {};
+
+/**
+ * Save namespaces to localStorage
+ */
+function save(namespaces: string): void {
+  try {
+    if (namespaces) {
+      storage?.setItem('debug', namespaces);
+    } else {
+      storage?.removeItem('debug');
+    }
+  } catch (error) {
+    // Ignore errors (e.g., localStorage quota exceeded)
+  }
+}
+
+/**
+ * Load namespaces from localStorage
+ */
+function load(): string {
+  let r: string = '';
+  try {
+    r = storage?.getItem('debug') || '';
+  } catch (error) {
+    // Ignore errors
+  }
+
+  // Also check URL query parameter
+  if (typeof window !== 'undefined' && window.location) {
+    const match = window.location.search.match(/[?&]debug=([^&]*)/);
+    if (match) {
+      r = decodeURIComponent(match[1]);
+    }
+  }
+
+  return r;
+}
+
+/**
+ * Destroy function (deprecated)
+ */
+let warnedDestroy = false;
+function destroy(): void {
+  if (!warnedDestroy) {
+    warnedDestroy = true;
+    console.warn(
+      'Instance method `debug.destroy()` is deprecated and no longer does anything.'
+    );
+  }
+}
+
+// Import ms for humanizing time
+import ms = require('ms');
+
+/**
+ * Create environment config for browser
+ */
+const browserEnv: EnvironmentConfig = {
+  formatArgs,
+  save,
+  load,
+  useColors,
+  colors,
+  log,
+  storage,
+  destroy,
+};
+
+/**
+ * Export the debug factory
+ */
+export = setup(browserEnv);