@mks2508/better-logger 0.0.2-alpha.2 → 0.3.0

package/dist/types/handlers/ExportLogHandler.d.ts

@@ -0,0 +1,100 @@
+import { ILogHandler, LogLevel, LogMetadata, LogEntry, ExportFilters, ExportOptions, ExportResult, BufferStats, ExportFormat } from '../types/index.js';
+/**
+ * Export log handler with circular buffer and multiple export formats
+ */
+export declare class ExportLogHandler implements ILogHandler {
+    private buffer;
+    private maxSize;
+    private groupDepth;
+    private currentGroup?;
+    constructor(maxSize?: number);
+    /**
+     * Handle incoming log and store in buffer
+     */
+    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): void;
+    /**
+     * Set group tracking for nested logs
+     */
+    setGroupInfo(depth: number, groupName?: string): void;
+    /**
+     * Get buffer statistics
+     */
+    getBufferStats(): BufferStats;
+    /**
+     * Clear the buffer
+     */
+    clearBuffer(): void;
+    /**
+     * Set buffer size (with limits)
+     */
+    setBufferSize(size: number): void;
+    /**
+     * Filter logs based on criteria
+     */
+    private filterLogs;
+    /**
+     * Export logs in JSON format
+     */
+    private exportJSON;
+    /**
+     * Export logs in CSV format
+     */
+    private exportCSV;
+    /**
+     * Export logs in Markdown format
+     */
+    private exportMarkdown;
+    /**
+     * Export logs in plain text format
+     */
+    private exportPlain;
+    /**
+     * Export logs in HTML format
+     */
+    private exportHTML;
+    /**
+     * Get emoji for log level
+     */
+    private getLevelEmoji;
+    /**
+     * Main export function
+     */
+    export(format: ExportFormat, filters?: ExportFilters, options?: ExportOptions): ExportResult;
+    /**
+     * Copy to clipboard with fallback
+     */
+    copyToClipboard(format: ExportFormat, filters?: ExportFilters, options?: ExportOptions): Promise<boolean>;
+    /**
+     * Get all logs (for debugging)
+     */
+    getAllLogs(): LogEntry[];
+    /**
+     * Save export to file with download prompt
+     */
+    saveToFile(format: ExportFormat, filters?: ExportFilters, options?: ExportOptions): Promise<boolean>;
+    /**
+     * Get MIME type for format
+     */
+    private getMimeType;
+    /**
+     * Generate filename with timestamp
+     */
+    private generateFilename;
+    /**
+     * Stream logs to external endpoint
+     */
+    streamToEndpoint(endpoint: string, filters?: ExportFilters, options?: {
+        apiKey?: string;
+        batchSize?: number;
+        format?: ExportFormat;
+    }): Promise<boolean>;
+    /**
+     * Create export with metadata enrichment
+     */
+    exportWithMetadata(format: ExportFormat, filters?: ExportFilters, options?: ExportOptions): ExportResult;
+    /**
+     * Estimate memory usage of buffer
+     */
+    private estimateMemoryUsage;
+}
+//# sourceMappingURL=ExportLogHandler.d.ts.map

package/dist/types/handlers/ExportLogHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportLogHandler.d.ts","sourceRoot":"","sources":["../../../src/handlers/ExportLogHandler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACf,MAAM,mBAAmB,CAAC;AAI3B;;GAEG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAChD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,YAAY,CAAC,CAAS;gBAElB,OAAO,GAAE,MAAmC;IAIxD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAsBlF;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAKrD;;OAEG;IACH,cAAc,IAAI,WAAW;IAuC7B;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASjC;;OAEG;IACH,OAAO,CAAC,UAAU;IAkElB;;OAEG;IACH,OAAO,CAAC,UAAU;IAkBlB;;OAEG;IACH,OAAO,CAAC,SAAS;IA2BjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAsDtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,OAAO,CAAC,UAAU;IA2DlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,aAAkB,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY;IAqCpG;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,aAAkB,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IA0BvH;;OAEG;IACH,UAAU,IAAI,QAAQ,EAAE;IAIxB;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,aAAkB,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IA0BlH;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,EAAE,OAAO,GAAE;QAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,YAAY,CAAA;KACnB,GAAG,OAAO,CAAC,OAAO,CAAC;IA4CzB;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,aAAkB,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY;IAsBhH;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAQ9B"}

package/dist/types/handlers/FileLogHandler.d.ts

@@ -0,0 +1,33 @@
+import { ILogHandler, LogLevel, LogMetadata } from '../types/index.js';
+/**
+ * Universal file-based log handler for persistent logging
+ * Works in both Node.js (real files) and browser (localStorage)
+ */
+export declare class FileLogHandler implements ILogHandler {
+    private filename;
+    private maxSize?;
+    private fs?;
+    constructor(filename?: string, maxSize?: number);
+    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): void;
+    /**
+     * Format log entry as a single line for file storage
+     */
+    private formatLogLine;
+    /**
+     * Write to actual file in Node.js environment
+     */
+    private writeToFileNode;
+    /**
+     * Write to localStorage in browser environment
+     */
+    private writeToFileLocal;
+    /**
+     * Get stored logs (useful for debugging)
+     */
+    getLogs(): string | null;
+    /**
+     * Clear stored logs
+     */
+    clearLogs(): void;
+}
+//# sourceMappingURL=FileLogHandler.d.ts.map

package/dist/types/handlers/FileLogHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileLogHandler.d.ts","sourceRoot":"","sources":["../../../src/handlers/FileLogHandler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAI5E;;;GAGG;AACH,qBAAa,cAAe,YAAW,WAAW;IAC9C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,EAAE,CAAC,CAAM;gBAEL,QAAQ,GAAE,MAAkB,EAAE,OAAO,CAAC,EAAE,MAAM;IAc1D,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAsBlF;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyBvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,IAAI;IAcxB;;OAEG;IACH,SAAS,IAAI,IAAI;CAYpB"}

package/dist/types/handlers/RemoteLogHandler.d.ts

@@ -0,0 +1,11 @@
+import { ILogHandler, LogLevel, LogMetadata } from '../types/index.js';
+/**
+ * Remote log handler for sending logs to external services
+ */
+export declare class RemoteLogHandler implements ILogHandler {
+    private endpoint;
+    private apiKey?;
+    constructor(endpoint: string, apiKey?: string);
+    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): Promise<void>;
+}
+//# sourceMappingURL=RemoteLogHandler.d.ts.map

package/dist/types/handlers/RemoteLogHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteLogHandler.d.ts","sourceRoot":"","sources":["../../../src/handlers/RemoteLogHandler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5E;;GAEG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAKvC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAuBpG"}

package/dist/types/handlers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Log handlers exports for Advanced Logger
+ */
+export { FileLogHandler } from './FileLogHandler.js';
+export { RemoteLogHandler } from './RemoteLogHandler.js';
+export { AnalyticsLogHandler } from './AnalyticsLogHandler.js';
+export { ExportLogHandler } from './ExportLogHandler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/types/handlers.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Handler and metadata type definitions for Advanced Logger
+ */
+import type { LogLevel, StackInfo } from './core.js';
+/**
+ * Metadata associated with each log entry
+ */
+export interface LogMetadata {
+    timestamp: string;
+    level: LogLevel;
+    prefix?: string;
+    stackInfo?: StackInfo;
+    group?: string;
+}
+/**
+ * Interface for custom log handlers (extensibility)
+ */
+export interface ILogHandler {
+    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): void;
+}
+/**
+ * Stored log entry for export functionality
+ */
+export interface LogEntry {
+    id: string;
+    timestamp: string;
+    level: LogLevel;
+    prefix?: string;
+    message: string;
+    args: any[];
+    location?: StackInfo;
+    groupInfo?: {
+        depth: number;
+        groupName?: string;
+    };
+}
+/**
+ * Export filter options
+ */
+export interface ExportFilters {
+    levels?: LogLevel[];
+    since?: Date | string | number;
+    until?: Date | string | number;
+    prefixes?: string[];
+    excludePrefixes?: string[];
+    withStackTrace?: boolean;
+    errorsOnly?: boolean;
+    last?: number;
+    first?: number;
+    search?: string;
+    groupBy?: 'level' | 'prefix' | 'hour' | 'date';
+}
+/**
+ * Export options for different formats
+ */
+export interface ExportOptions {
+    minimal?: boolean;
+    compact?: boolean;
+    styled?: boolean;
+    includeMetadata?: boolean;
+    groupBy?: ExportFilters['groupBy'];
+}
+/**
+ * Export result with metadata
+ */
+export interface ExportResult {
+    format: string;
+    data: string;
+    metadata: {
+        totalLogs: number;
+        filteredLogs: number;
+        exportedAt: string;
+        filters?: ExportFilters;
+        options?: ExportOptions;
+    };
+}
+/**
+ * Buffer statistics for log management
+ */
+export interface BufferStats {
+    size: number;
+    maxSize: number;
+    usage: number;
+    oldestLog?: Date;
+    newestLog?: Date;
+    levelCounts: Record<LogLevel, number>;
+}
+//# sourceMappingURL=handlers.d.ts.map

package/dist/types/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/types/handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CACtF;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,OAAO,CAAC,EAAE,aAAa,CAAC;KAC3B,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;CACzC"}

package/dist/types/handlers.js

@@ -0,0 +1,4 @@
+/**
+ * @fileoverview Handler and metadata type definitions for Advanced Logger
+ */
+export {};