hazo_logs 1.0.0

package/dist/lib/log-reader.js

@@ -0,0 +1,248 @@
+/**
+ * Log Reader Service
+ * Reads and parses log files with filtering, sorting, and pagination
+ */
+import fs from 'fs';
+import path from 'path';
+import readline from 'readline';
+import { loadConfig } from './config_loader.js';
+const LEVEL_ORDER = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    debug: 3,
+};
+/**
+ * Read logs from file with filtering, sorting, and pagination
+ */
+export async function readLogs(options = {}) {
+    const config = loadConfig();
+    const logDir = options.logDirectory || config.log_directory;
+    const date = options.date || getTodayDate();
+    const pageSize = options.pageSize || config.log_viewer_page_size || 50;
+    const page = options.page || 1;
+    const maxResults = config.log_viewer_max_results || 1000;
+    const logFilePath = path.resolve(logDir, `hazo-${date}.log`);
+    if (!fs.existsSync(logFilePath)) {
+        return {
+            logs: [],
+            total: 0,
+            page,
+            pageSize,
+            totalPages: 0,
+        };
+    }
+    // Read and parse all logs from file
+    let logs = await parseLogFile(logFilePath);
+    // Apply filters
+    logs = applyFilters(logs, options);
+    // Limit to max results
+    if (logs.length > maxResults) {
+        logs = logs.slice(0, maxResults);
+    }
+    const total = logs.length;
+    // Apply sorting
+    logs = applySorting(logs, options.sortBy, options.sortOrder);
+    // Apply pagination
+    const totalPages = Math.ceil(total / pageSize);
+    const startIndex = (page - 1) * pageSize;
+    const paginatedLogs = logs.slice(startIndex, startIndex + pageSize);
+    return {
+        logs: paginatedLogs,
+        total,
+        page,
+        pageSize,
+        totalPages,
+    };
+}
+/**
+ * Get list of available log dates
+ */
+export async function getAvailableLogDates(logDirectory) {
+    const config = loadConfig();
+    const logDir = logDirectory || config.log_directory;
+    const resolvedDir = path.resolve(logDir);
+    if (!fs.existsSync(resolvedDir)) {
+        return [];
+    }
+    const files = fs.readdirSync(resolvedDir);
+    const dates = [];
+    for (const file of files) {
+        const match = file.match(/^hazo-(\d{4}-\d{2}-\d{2})\.log$/);
+        if (match) {
+            dates.push(match[1]);
+        }
+    }
+    // Sort dates descending (newest first)
+    return dates.sort((a, b) => b.localeCompare(a));
+}
+/**
+ * Get unique package names from logs
+ */
+export async function getUniquePackages(logDirectory, date) {
+    const config = loadConfig();
+    const logDir = logDirectory || config.log_directory;
+    const targetDate = date || getTodayDate();
+    const logFilePath = path.resolve(logDir, `hazo-${targetDate}.log`);
+    if (!fs.existsSync(logFilePath)) {
+        return [];
+    }
+    const logs = await parseLogFile(logFilePath);
+    const packages = new Set();
+    for (const log of logs) {
+        if (log.package) {
+            packages.add(log.package);
+        }
+    }
+    return Array.from(packages).sort();
+}
+/**
+ * Get unique execution IDs from logs
+ */
+export async function getUniqueExecutionIds(logDirectory, date) {
+    const config = loadConfig();
+    const logDir = logDirectory || config.log_directory;
+    const targetDate = date || getTodayDate();
+    const logFilePath = path.resolve(logDir, `hazo-${targetDate}.log`);
+    if (!fs.existsSync(logFilePath)) {
+        return [];
+    }
+    const logs = await parseLogFile(logFilePath);
+    const executionIds = new Set();
+    for (const log of logs) {
+        if (log.executionId) {
+            executionIds.add(log.executionId);
+        }
+    }
+    return Array.from(executionIds).sort();
+}
+/**
+ * Get unique session IDs from logs
+ */
+export async function getUniqueSessionIds(logDirectory, date) {
+    const config = loadConfig();
+    const logDir = logDirectory || config.log_directory;
+    const targetDate = date || getTodayDate();
+    const logFilePath = path.resolve(logDir, `hazo-${targetDate}.log`);
+    if (!fs.existsSync(logFilePath)) {
+        return [];
+    }
+    const logs = await parseLogFile(logFilePath);
+    const sessionIds = new Set();
+    for (const log of logs) {
+        if (log.sessionId) {
+            sessionIds.add(log.sessionId);
+        }
+    }
+    return Array.from(sessionIds).sort();
+}
+/**
+ * Get unique references from logs
+ */
+export async function getUniqueReferences(logDirectory, date) {
+    const config = loadConfig();
+    const logDir = logDirectory || config.log_directory;
+    const targetDate = date || getTodayDate();
+    const logFilePath = path.resolve(logDir, `hazo-${targetDate}.log`);
+    if (!fs.existsSync(logFilePath)) {
+        return [];
+    }
+    const logs = await parseLogFile(logFilePath);
+    const references = new Set();
+    for (const log of logs) {
+        if (log.reference) {
+            references.add(log.reference);
+        }
+    }
+    return Array.from(references).sort();
+}
+/**
+ * Parse a log file line by line
+ */
+async function parseLogFile(filePath) {
+    const logs = [];
+    const fileStream = fs.createReadStream(filePath);
+    const rl = readline.createInterface({
+        input: fileStream,
+        crlfDelay: Infinity,
+    });
+    for await (const line of rl) {
+        if (!line.trim())
+            continue;
+        try {
+            const entry = JSON.parse(line);
+            logs.push(entry);
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    return logs;
+}
+/**
+ * Apply filters to logs
+ */
+function applyFilters(logs, options) {
+    let filtered = logs;
+    // Filter by level
+    if (options.level && options.level.length > 0) {
+        filtered = filtered.filter((log) => options.level.includes(log.level));
+    }
+    // Filter by package
+    if (options.package && options.package.length > 0) {
+        filtered = filtered.filter((log) => options.package.includes(log.package));
+    }
+    // Filter by execution ID
+    if (options.executionId && options.executionId.length > 0) {
+        filtered = filtered.filter((log) => options.executionId.includes(log.executionId));
+    }
+    // Filter by session ID
+    if (options.sessionId && options.sessionId.length > 0) {
+        filtered = filtered.filter((log) => log.sessionId && options.sessionId.includes(log.sessionId));
+    }
+    // Filter by reference
+    if (options.reference && options.reference.length > 0) {
+        filtered = filtered.filter((log) => log.reference && options.reference.includes(log.reference));
+    }
+    // Filter by search text
+    if (options.search) {
+        const searchLower = options.search.toLowerCase();
+        filtered = filtered.filter((log) => log.message.toLowerCase().includes(searchLower) ||
+            log.package.toLowerCase().includes(searchLower) ||
+            log.filename.toLowerCase().includes(searchLower) ||
+            (log.sessionId && log.sessionId.toLowerCase().includes(searchLower)) ||
+            (log.reference && log.reference.toLowerCase().includes(searchLower)));
+    }
+    return filtered;
+}
+/**
+ * Apply sorting to logs
+ */
+function applySorting(logs, sortBy, sortOrder) {
+    const order = sortOrder === 'asc' ? 1 : -1;
+    return [...logs].sort((a, b) => {
+        switch (sortBy) {
+            case 'level':
+                return (LEVEL_ORDER[a.level] - LEVEL_ORDER[b.level]) * order;
+            case 'package':
+                return a.package.localeCompare(b.package) * order;
+            case 'executionId':
+                return a.executionId.localeCompare(b.executionId) * order;
+            case 'sessionId':
+                return (a.sessionId || '').localeCompare(b.sessionId || '') * order;
+            case 'reference':
+                return (a.reference || '').localeCompare(b.reference || '') * order;
+            case 'timestamp':
+            default:
+                return a.timestamp.localeCompare(b.timestamp) * order;
+        }
+    });
+}
+/**
+ * Get today's date in YYYY-MM-DD format
+ */
+function getTodayDate() {
+    const now = new Date();
+    return now.toISOString().split('T')[0];
+}
+//# sourceMappingURL=log-reader.js.map

package/dist/lib/log-reader.js.map

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

package/dist/lib/package_logger.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Package-specific logger implementation
+ * Creates loggers that tag all entries with a package name
+ */
+import { HazoLogger } from './hazo_logger.js';
+import type { Logger, LogData, PackageLoggerOptions } from './types.js';
+/**
+ * Logger implementation for a specific package
+ * Tags all log entries with the package name and captures caller info
+ */
+export declare class PackageLogger implements Logger {
+    private coreLogger;
+    private packageName;
+    constructor(options: PackageLoggerOptions, coreLogger?: HazoLogger);
+    private log;
+    error(message: string, data?: LogData): void;
+    warn(message: string, data?: LogData): void;
+    info(message: string, data?: LogData): void;
+    debug(message: string, data?: LogData): void;
+}
+/**
+ * Factory function to create a package-specific logger
+ * @param packageName - Name of the package (e.g., "hazo_auth", "hazo_notify")
+ * @returns Logger instance for the specified package
+ */
+export declare function createLogger(packageName: string): Logger;
+//# sourceMappingURL=package_logger.d.ts.map

package/dist/lib/package_logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package_logger.d.ts","sourceRoot":"","sources":["../../src/lib/package_logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAY,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIlF;;;GAGG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,oBAAoB,EAAE,UAAU,CAAC,EAAE,UAAU;IAKlE,OAAO,CAAC,GAAG;IAmBX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;CAG7C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/lib/package_logger.js

@@ -0,0 +1,57 @@
+/**
+ * Package-specific logger implementation
+ * Creates loggers that tag all entries with a package name
+ */
+import { HazoLogger } from './hazo_logger.js';
+import { getCallerInfo } from './utils/caller_info.js';
+import { getLogContext } from './context/log-context.js';
+/**
+ * Logger implementation for a specific package
+ * Tags all log entries with the package name and captures caller info
+ */
+export class PackageLogger {
+    coreLogger;
+    packageName;
+    constructor(options, coreLogger) {
+        this.packageName = options.packageName;
+        this.coreLogger = coreLogger || HazoLogger.getInstance();
+    }
+    log(level, message, data) {
+        const { filename, line } = getCallerInfo();
+        const context = getLogContext();
+        this.coreLogger.log({
+            timestamp: new Date().toISOString(),
+            level,
+            package: this.packageName,
+            message,
+            filename,
+            line,
+            executionId: this.coreLogger.getExecutionId(),
+            ...(context?.sessionId ? { sessionId: context.sessionId } : {}),
+            ...(context?.reference ? { reference: context.reference } : {}),
+            ...(context?.depth ? { depth: context.depth } : {}),
+            ...(data ? { data } : {}),
+        });
+    }
+    error(message, data) {
+        this.log('error', message, data);
+    }
+    warn(message, data) {
+        this.log('warn', message, data);
+    }
+    info(message, data) {
+        this.log('info', message, data);
+    }
+    debug(message, data) {
+        this.log('debug', message, data);
+    }
+}
+/**
+ * Factory function to create a package-specific logger
+ * @param packageName - Name of the package (e.g., "hazo_auth", "hazo_notify")
+ * @returns Logger instance for the specified package
+ */
+export function createLogger(packageName) {
+    return new PackageLogger({ packageName });
+}
+//# sourceMappingURL=package_logger.js.map

package/dist/lib/package_logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package_logger.js","sourceRoot":"","sources":["../../src/lib/package_logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;GAGG;AACH,MAAM,OAAO,aAAa;IAChB,UAAU,CAAa;IACvB,WAAW,CAAS;IAE5B,YAAY,OAA6B,EAAE,UAAuB;QAChE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;IAC3D,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAAc;QAC1D,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,aAAa,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;QAEhC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK;YACL,OAAO,EAAE,IAAI,CAAC,WAAW;YACzB,OAAO;YACP,QAAQ;YACR,IAAI;YACJ,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE;YAC7C,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,IAAI,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/lib/transports/console_transport.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Colored console transport for hazo_logs
+ */
+import winston from 'winston';
+import type { LogLevel } from '../types.js';
+/**
+ * Create a Winston console transport with colored output
+ */
+export declare function createConsoleTransport(level: LogLevel): winston.transport;
+//# sourceMappingURL=console_transport.d.ts.map

package/dist/lib/transports/console_transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console_transport.d.ts","sourceRoot":"","sources":["../../../src/lib/transports/console_transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAezE"}

package/dist/lib/transports/console_transport.js

@@ -0,0 +1,21 @@
+/**
+ * Colored console transport for hazo_logs
+ */
+import winston from 'winston';
+import { COLORS } from '../utils/constants.js';
+/**
+ * Create a Winston console transport with colored output
+ */
+export function createConsoleTransport(level) {
+    return new winston.transports.Console({
+        level,
+        format: winston.format.combine(winston.format.timestamp({ format: 'HH:mm:ss' }), winston.format.printf((info) => {
+            const { timestamp, level: logLevel, message, package: pkg, filename, line } = info;
+            const color = COLORS[logLevel] || COLORS.reset;
+            const levelUpper = logLevel.toUpperCase().padEnd(5);
+            const location = `${filename}:${line}`;
+            return `${color}[${timestamp}] [${levelUpper}] [${pkg}] ${message} (${location})${COLORS.reset}`;
+        })),
+    });
+}
+//# sourceMappingURL=console_transport.js.map

package/dist/lib/transports/console_transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console_transport.js","sourceRoot":"","sources":["../../../src/lib/transports/console_transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAe;IACpD,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QACpC,KAAK;QACL,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAChD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YAC7B,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;YACnF,MAAM,KAAK,GAAG,MAAM,CAAC,QAA+B,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC;YACtE,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACpD,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;YAEvC,OAAO,GAAG,KAAK,IAAI,SAAS,MAAM,UAAU,MAAM,GAAG,KAAK,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACnG,CAAC,CAAC,CACH;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/transports/file_transport.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Daily rotating JSON file transport for hazo_logs
+ */
+import DailyRotateFile from 'winston-daily-rotate-file';
+import type { HazoLogConfig } from '../types.js';
+/**
+ * Create a Winston daily rotating file transport with JSON format
+ */
+export declare function createFileTransport(config: HazoLogConfig): DailyRotateFile;
+//# sourceMappingURL=file_transport.d.ts.map

package/dist/lib/transports/file_transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_transport.d.ts","sourceRoot":"","sources":["../../../src/lib/transports/file_transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,eAAe,MAAM,2BAA2B,CAAC;AAIxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAmCjD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAmB1E"}

package/dist/lib/transports/file_transport.js

@@ -0,0 +1,56 @@
+/**
+ * Daily rotating JSON file transport for hazo_logs
+ */
+import DailyRotateFile from 'winston-daily-rotate-file';
+import winston from 'winston';
+import path from 'path';
+import fs from 'fs';
+/**
+ * Custom format that outputs fields in a logical, readable order
+ */
+const orderedJsonFormat = winston.format.printf((info) => {
+    const ordered = {
+        timestamp: info.timestamp,
+        level: info.level,
+        package: info.package,
+        message: info.message,
+        filename: info.filename,
+        line: info.line,
+        executionId: info.executionId,
+    };
+    // Add optional context fields if present
+    if (info.sessionId) {
+        ordered.sessionId = info.sessionId;
+    }
+    if (info.reference) {
+        ordered.reference = info.reference;
+    }
+    if (info.depth !== undefined) {
+        ordered.depth = info.depth;
+    }
+    // Add data field if present
+    if (info.data) {
+        ordered.data = info.data;
+    }
+    return JSON.stringify(ordered);
+});
+/**
+ * Create a Winston daily rotating file transport with JSON format
+ */
+export function createFileTransport(config) {
+    // Ensure log directory exists
+    const logDir = path.resolve(config.log_directory);
+    if (!fs.existsSync(logDir)) {
+        fs.mkdirSync(logDir, { recursive: true });
+    }
+    return new DailyRotateFile({
+        level: config.log_level,
+        dirname: logDir,
+        filename: 'hazo-%DATE%.log',
+        datePattern: config.date_pattern,
+        maxSize: config.max_file_size,
+        maxFiles: config.max_files,
+        format: winston.format.combine(winston.format.timestamp(), orderedJsonFormat),
+    });
+}
+//# sourceMappingURL=file_transport.js.map

package/dist/lib/transports/file_transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_transport.js","sourceRoot":"","sources":["../../../src/lib/transports/file_transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,eAAe,MAAM,2BAA2B,CAAC;AACxD,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB;;GAEG;AACH,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;IACvD,MAAM,OAAO,GAA4B;QACvC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC;IAEF,yCAAyC;IACzC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACrC,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACrC,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,4BAA4B;IAC5B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,8BAA8B;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,IAAI,eAAe,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC,SAAS;QACvB,OAAO,EAAE,MAAM;QACf,QAAQ,EAAE,iBAAiB;QAC3B,WAAW,EAAE,MAAM,CAAC,YAAY;QAChC,OAAO,EAAE,MAAM,CAAC,aAAa;QAC7B,QAAQ,EAAE,MAAM,CAAC,SAAS;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,iBAAiB,CAClB;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/transports/index.d.ts

@@ -0,0 +1,3 @@
+export { createConsoleTransport } from './console_transport.js';
+export { createFileTransport } from './file_transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/transports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/transports/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/transports/index.js

@@ -0,0 +1,3 @@
+export { createConsoleTransport } from './console_transport.js';
+export { createFileTransport } from './file_transport.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/transports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/transports/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Type definitions for hazo_logs
+ */
+/**
+ * Log levels supported by hazo_logs
+ */
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+/**
+ * Additional data that can be attached to log entries
+ */
+export type LogData = Record<string, unknown>;
+/**
+ * Log entry structure written to JSON files
+ */
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    package: string;
+    message: string;
+    filename: string;
+    line: number;
+    executionId: string;
+    sessionId?: string;
+    reference?: string;
+    depth?: number;
+    data?: LogData;
+}
+/**
+ * Logger interface - the public API for logging
+ */
+export interface Logger {
+    error(message: string, data?: LogData): void;
+    warn(message: string, data?: LogData): void;
+    info(message: string, data?: LogData): void;
+    debug(message: string, data?: LogData): void;
+}
+/**
+ * Configuration options loaded from hazo_logs_config.ini
+ */
+export interface HazoLogConfig {
+    log_directory: string;
+    log_level: LogLevel;
+    enable_console: boolean;
+    enable_file: boolean;
+    max_file_size: string;
+    max_files: string;
+    date_pattern: string;
+    enable_log_viewer: boolean;
+    log_viewer_page_size: number;
+    log_viewer_max_results: number;
+}
+/**
+ * Options for creating a package logger
+ */
+export interface PackageLoggerOptions {
+    packageName: string;
+}
+/**
+ * Log context for session and reference tracking
+ */
+export interface LogContext {
+    sessionId?: string;
+    reference?: string;
+    depth?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,QAAQ,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IAErB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/lib/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for hazo_logs
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

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

package/dist/lib/utils/caller_info.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Utility to extract filename and line number from call stack
+ */
+export interface CallerInfo {
+    filename: string;
+    line: number;
+}
+/**
+ * Get the filename and line number of the caller
+ * Walks up the stack to find the actual calling code (not the logger internals)
+ */
+export declare function getCallerInfo(): CallerInfo;
+//# sourceMappingURL=caller_info.d.ts.map

package/dist/lib/utils/caller_info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller_info.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/caller_info.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,CA+B1C"}

package/dist/lib/utils/caller_info.js

@@ -0,0 +1,65 @@
+/**
+ * Utility to extract filename and line number from call stack
+ */
+/**
+ * Get the filename and line number of the caller
+ * Walks up the stack to find the actual calling code (not the logger internals)
+ */
+export function getCallerInfo() {
+    const originalPrepareStackTrace = Error.prepareStackTrace;
+    try {
+        const err = new Error();
+        Error.prepareStackTrace = (_, stack) => stack;
+        const stack = err.stack;
+        Error.prepareStackTrace = originalPrepareStackTrace;
+        // Walk up the stack to find user code
+        for (let i = 0; i < stack.length; i++) {
+            const frame = stack[i];
+            const filename = frame.getFileName() || '';
+            // Skip if no filename
+            if (!filename)
+                continue;
+            // Skip frames that are part of the logger internals
+            if (isInternalFrame(filename))
+                continue;
+            // Found user code
+            return {
+                filename: extractFilename(filename),
+                line: frame.getLineNumber() || 0,
+            };
+        }
+        return { filename: 'unknown', line: 0 };
+    }
+    catch {
+        return { filename: 'unknown', line: 0 };
+    }
+}
+/**
+ * Check if a filename is an internal frame that should be skipped
+ */
+function isInternalFrame(filename) {
+    const lowered = filename.toLowerCase();
+    // Skip node internals
+    if (lowered.startsWith('node:'))
+        return true;
+    // Skip node_modules (including hazo_logs when used as a package)
+    if (lowered.includes('node_modules'))
+        return true;
+    // Skip hazo_logs package source files (src/lib or dist/lib)
+    // Be specific to avoid skipping user files in directories that happen to contain "hazo_log"
+    if (lowered.includes('hazo_logs/src/lib') ||
+        lowered.includes('hazo_logs/dist/lib') ||
+        lowered.includes('hazo_logs\\src\\lib') ||
+        lowered.includes('hazo_logs\\dist\\lib')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Extract just the filename from a full path
+ */
+function extractFilename(fullPath) {
+    const parts = fullPath.split(/[/\\]/);
+    return parts[parts.length - 1] || fullPath;
+}
+//# sourceMappingURL=caller_info.js.map