@mks2508/better-logger 2.0.0 → 2.1.0

package/dist/utils/formatting.d.ts

@@ -0,0 +1,58 @@
+import { LogLevel, StackInfo, OutputFormat } from '../types/index.js';
+export type { OutputFormat } from '../types/index.js';
+/**
+ * Creates output based on environment and format preference
+ */
+export declare function createOutput(level: LogLevel, message: string, prefix?: string, stackInfo?: StackInfo | null, format?: OutputFormat): string;
+/**
+ * Creates plain text output for any environment
+ * No colors, no styling - maximum compatibility
+ */
+export declare function createPlainOutput(level: LogLevel, message: string, prefix?: string, stackInfo?: StackInfo | null): string;
+/**
+ * Creates ANSI-colored output for terminals
+ */
+export declare function createANSIOutput(level: LogLevel, message: string, prefix?: string, stackInfo?: StackInfo | null): string;
+/**
+ * Creates build-friendly output (optimized for Next.js builds, webpack, etc.)
+ */
+export declare function createBuildOutput(level: LogLevel, message: string, prefix?: string, stackInfo?: StackInfo | null): string;
+/**
+ * Creates CI-friendly output (no emojis, simple formatting)
+ */
+export declare function createCIOutput(level: LogLevel, message: string, prefix?: string, stackInfo?: StackInfo | null): string;
+/**
+ * Detects the optimal output format based on environment
+ */
+export declare function detectOptimalFormat(): OutputFormat;
+/**
+ * Gets the appropriate log method for the level
+ * Uses different console methods for better semantics
+ */
+export declare function getConsoleMethod(level: LogLevel): 'log' | 'info' | 'warn' | 'error';
+/**
+ * Create a simple log entry object for handlers
+ */
+export declare function createLogEntry(level: LogLevel, message: string, args: any[], prefix?: string, stackInfo?: StackInfo | null): {
+    timestamp: string;
+    level: string;
+    prefix: string | undefined;
+    message: string;
+    args: any[];
+    location: {
+        file: string;
+        line: number;
+        column: number;
+        function: string | undefined;
+    } | undefined;
+    raw: any[];
+};
+/**
+ * Format data for table display in plain text
+ */
+export declare function formatTablePlain(data: any, columns?: string[]): string;
+/**
+ * Safe object serialization for logging
+ */
+export declare function safeSerialize(obj: any, maxDepth?: number, currentDepth?: number): any;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/utils/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAa3E,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,YAAY,CACxB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,EAC5B,MAAM,GAAE,YAAqB,GAC9B,MAAM,CAcR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC7B,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC7B,MAAM,CA0BR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC7B,MAAM,CAyCR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC7B,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAiClD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAcnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;;;;;;;;;;;;;EAgB/B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CA+BtE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,GAAE,MAAU,EAAE,YAAY,GAAE,MAAU,GAAG,GAAG,CAqB3F"}

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Utility functions exports for Advanced Logger
+ */
+export { parseStackTrace } from './stackTrace.js';
+export { formatTimestamp, parseRelativeTime, parseTimeInput, formatDisplayTime } from './timestamps.js';
+export { createStyledOutput, generateLogId, escapeHtml, safeStringify, detectDevToolsTheme, getAdaptiveColor, setupThemeChangeListener, type LevelStyleConfig } from './output.js';
+export { createPlainOutput, createOutput, createANSIOutput, createBuildOutput, createCIOutput, detectOptimalFormat, getConsoleMethod, createLogEntry, formatTablePlain, safeSerialize } from './formatting.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACH,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,gBAAgB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACH,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,aAAa,EAChB,MAAM,iBAAiB,CAAC"}

package/dist/utils/opentui-detection.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview OpenTUI detection and enhancement utilities for core logger
+ */
+/**
+ * Check if OpenTUI packages are available
+ */
+export declare function hasOpenTUI(): Promise<boolean>;
+/**
+ * Check if OpenTUI enhancement package is available
+ */
+export declare function hasOpenTUILogHandler(): Promise<boolean>;
+/**
+ * Dynamically enhance logger with OpenTUI if available
+ */
+export declare function tryEnhanceWithOpenTUI(logger: any): Promise<boolean>;
+/**
+ * Get OpenTUI environment information
+ */
+export declare function getOpenTUIInfo(): Promise<{
+    available: boolean;
+    coreAvailable: boolean;
+    handlerAvailable: boolean;
+    nodeVersion: string | null;
+    terminalSupport: boolean;
+}>;
+/**
+ * Auto-enhance logger with best available rendering
+ */
+export declare function autoEnhanceLogger(logger: any): Promise<{
+    enhanced: boolean;
+    method: 'opentui' | 'ansi' | 'plain';
+    info?: any;
+}>;
+//# sourceMappingURL=opentui-detection.d.ts.map

package/dist/utils/opentui-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentui-detection.d.ts","sourceRoot":"","sources":["../../src/utils/opentui-detection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAanD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAY7D;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAkCzE;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;CAC5B,CAAC,CAaD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC;IAC1D,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,IAAI,CAAC,EAAE,GAAG,CAAC;CACd,CAAC,CA0BD"}

package/dist/utils/output.d.ts

@@ -0,0 +1,46 @@
+import { LogLevel, StackInfo, DevToolsTheme, AdaptiveColors, LogStyles } from '../types/index.js';
+/**
+ * Style configuration for each log level
+ */
+export interface LevelStyleConfig {
+    emoji: string;
+    label: string;
+    background: string;
+    color: string;
+    border: string;
+    shadow: string;
+}
+/**
+ * Detects the current DevTools theme preference
+ */
+export declare function detectDevToolsTheme(): DevToolsTheme;
+/**
+ * Gets adaptive color based on current DevTools theme
+ */
+export declare function getAdaptiveColor(colors: AdaptiveColors, theme?: DevToolsTheme): string;
+/**
+ * Sets up theme change listener for dynamic updates
+ */
+export declare function setupThemeChangeListener(callback: (theme: DevToolsTheme) => void): (() => void) | null;
+/**
+ * Creates styled console output with multiple %c formatters
+ * Automatically adapts to browser or terminal environment
+ */
+export declare function createStyledOutput(level: LogLevel, levelStyles: Record<LogLevel | 'success', LevelStyleConfig>, prefix: string | undefined, message: string, stackInfo: StackInfo | null, autoDetectTheme?: boolean, presetStyles?: LogStyles, presetName?: string): [string, ...string[]];
+/**
+ * Create a unique ID for log entries
+ */
+export declare function generateLogId(): string;
+/**
+ * Escape HTML entities for safe HTML output
+ */
+export declare function escapeHtml(text: string): string;
+/**
+ * Convert objects to safe string representation for logging
+ */
+export declare function safeStringify(obj: any, _maxDepth?: number): string;
+/**
+ * Create terminal output with ANSI colors and formatting
+ */
+export declare function createTerminalOutput(level: LogLevel, message: string, timestamp?: string, prefix?: string, stackInfo?: StackInfo | null, presetStyles?: LogStyles, presetName?: string): [string, ...string[]];
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAM5F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAYnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,CAGtF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAyBtG;AAGD;;;GAGG;AACH,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,EAAE,gBAAgB,CAAC,EAC3D,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,eAAe,GAAE,OAAc,EAC/B,YAAY,CAAC,EAAE,SAAS,EACxB,UAAU,CAAC,EAAE,MAAM,GACpB,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAwEvB;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,SAAI,GAAG,MAAM,CAY7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,EAC5B,YAAY,CAAC,EAAE,SAAS,EACxB,UAAU,CAAC,EAAE,MAAM,GACpB,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAevB"}

package/dist/utils/stackTrace.d.ts

@@ -0,0 +1,6 @@
+import { StackInfo } from '../types/index.js';
+/**
+ * Parses the current stack trace to extract caller information
+ */
+export declare function parseStackTrace(): StackInfo | null;
+//# sourceMappingURL=stackTrace.d.ts.map

package/dist/utils/stackTrace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stackTrace.d.ts","sourceRoot":"","sources":["../../src/utils/stackTrace.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAsCnD;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,GAAG,IAAI,CAkGlD"}

package/dist/utils/timestamps.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Timestamp utilities for Advanced Logger
+ */
+/**
+ * Formats the timestamp using modern Date API
+ */
+export declare function formatTimestamp(): string;
+/**
+ * Parse relative time strings like "2h", "30m", "1d" into milliseconds
+ */
+export declare function parseRelativeTime(timeStr: string): number;
+/**
+ * Parse time input which can be Date, ISO string, or relative time
+ */
+export declare function parseTimeInput(input: Date | string | number): Date;
+/**
+ * Format timestamp for display in different contexts
+ */
+export declare function formatDisplayTime(date: Date, format?: 'short' | 'full' | 'time-only'): string;
+//# sourceMappingURL=timestamps.d.ts.map

package/dist/utils/timestamps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamps.d.ts","sourceRoot":"","sources":["../../src/utils/timestamps.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAQxC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CA2BlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,OAAO,GAAG,MAAM,GAAG,WAAqB,GAAG,MAAM,CAUtG"}

package/dist/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mks2508/better-logger",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "type": "module",
   "description": "Logger avanzado para consola con estilos CSS, temas adaptativos, badges automáticos, SVG, animaciones, CLI integrado y soporte dual browser/terminal con colores ANSI",
   "main": "dist/index.js",