@infosel-sdk/logger 0.1.0

package/src/data/repositories/logger_repository_impl.d.ts

@@ -0,0 +1,34 @@
+import { LoggerDataSource } from '../../domain/datasources/logger_datasource';
+import { LoggerRepository, LogOptions } from '../../domain/repositories/logger_repository';
+import { LogLevel } from '../../domain/entities/log_level';
+/**
+ * Implementation of logger repository
+ */
+export declare class LoggerRepositoryImpl implements LoggerRepository {
+    private dataSource;
+    constructor(dataSource: LoggerDataSource);
+    /**
+     * Log a debug message
+     */
+    debug(message: string, options?: LogOptions): void;
+    /**
+     * Log an info message
+     */
+    info(message: string, options?: LogOptions): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, options?: LogOptions): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, options?: LogOptions): void;
+    /**
+     * Log a message with a specific level, service, and context
+     */
+    log(level: LogLevel, message: string, options?: LogOptions): void;
+    /**
+     * Check if a log level is enabled
+     */
+    isLevelEnabled(level: LogLevel): boolean;
+}

package/src/data/repositories/logger_repository_impl.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerRepositoryImpl = void 0;
+const log_level_1 = require("../../domain/entities/log_level");
+/**
+ * Implementation of logger repository
+ */
+class LoggerRepositoryImpl {
+    constructor(dataSource) {
+        this.dataSource = dataSource;
+    }
+    /**
+     * Log a debug message
+     */
+    debug(message, options) {
+        this.log(log_level_1.LogLevel.DEBUG, message, options);
+    }
+    /**
+     * Log an info message
+     */
+    info(message, options) {
+        this.log(log_level_1.LogLevel.INFO, message, options);
+    }
+    /**
+     * Log a warning message
+     */
+    warn(message, options) {
+        this.log(log_level_1.LogLevel.WARN, message, options);
+    }
+    /**
+     * Log an error message
+     */
+    error(message, options) {
+        this.log(log_level_1.LogLevel.ERROR, message, options);
+    }
+    /**
+     * Log a message with a specific level, service, and context
+     */
+    log(level, message, options) {
+        const entry = {
+            level,
+            message,
+            timestamp: new Date(),
+            metadata: options === null || options === void 0 ? void 0 : options.metadata,
+            service: options === null || options === void 0 ? void 0 : options.service,
+            context: options === null || options === void 0 ? void 0 : options.context,
+        };
+        this.dataSource.log(entry);
+    }
+    /**
+     * Check if a log level is enabled
+     */
+    isLevelEnabled(level) {
+        return this.dataSource.isLevelEnabled(level);
+    }
+}
+exports.LoggerRepositoryImpl = LoggerRepositoryImpl;
+//# sourceMappingURL=logger_repository_impl.js.map

package/src/data/repositories/logger_repository_impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger_repository_impl.js","sourceRoot":"","sources":["../../../../../../packages/logger/src/data/repositories/logger_repository_impl.ts"],"names":[],"mappings":";;;AAKA,+DAA2D;AAG3D;;GAEG;AACH,MAAa,oBAAoB;IAC/B,YAAoB,UAA4B;QAA5B,eAAU,GAAV,UAAU,CAAkB;IAAG,CAAC;IAEpD;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,OAAoB;QACzC,IAAI,CAAC,GAAG,CAAC,oBAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,OAAoB;QACxC,IAAI,CAAC,GAAG,CAAC,oBAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,OAAoB;QACxC,IAAI,CAAC,GAAG,CAAC,oBAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,OAAoB;QACzC,IAAI,CAAC,GAAG,CAAC,oBAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,OAAoB;QACxD,MAAM,KAAK,GAAa;YACtB,KAAK;YACL,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;YAC3B,OAAO,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO;YACzB,OAAO,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO;SAC1B,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,KAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;CACF;AArDD,oDAqDC"}

package/src/domain/datasources/logger_datasource.d.ts

@@ -0,0 +1,16 @@
+import { LogEntry } from '../entities/log_entry';
+/**
+ * Interface for logger data source operations
+ */
+export interface LoggerDataSource {
+    /**
+     * Log a message
+     * @param entry Log entry to write
+     */
+    log(entry: LogEntry): void;
+    /**
+     * Check if a log level is enabled
+     * @param level Log level to check
+     */
+    isLevelEnabled(level: string): boolean;
+}

package/src/domain/datasources/logger_datasource.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=logger_datasource.js.map

package/src/domain/datasources/logger_datasource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger_datasource.js","sourceRoot":"","sources":["../../../../../../packages/logger/src/domain/datasources/logger_datasource.ts"],"names":[],"mappings":""}

package/src/domain/di/logger_component.d.ts

@@ -0,0 +1,127 @@
+import { LoggerRepository, LogOptions } from '../repositories/logger_repository';
+import { LogMessage } from '../use_cases/log_message';
+import { LogError } from '../use_cases/log_error';
+import { LogLevel } from '../entities/log_level';
+import { DetectableError } from '../entities/error_types';
+/**
+ * Logger component interface for dependency injection
+ */
+export interface LoggerComponent {
+    /**
+     * Log a debug message
+     * @param message Message to log
+     * @param options Optional log options (metadata, service, context)
+     */
+    debug(message: string, options?: LogOptions): void;
+    /**
+     * Log an info message
+     * @param message Message to log
+     * @param options Optional log options (metadata, service, context)
+     */
+    info(message: string, options?: LogOptions): void;
+    /**
+     * Log a warning message
+     * @param message Message to log
+     * @param options Optional log options (metadata, service, context)
+     */
+    warn(message: string, options?: LogOptions): void;
+    /**
+     * Log an error message
+     * @param message Message to log
+     * @param options Optional log options (metadata, service, context)
+     */
+    error(message: string, options?: LogOptions): void;
+    /**
+     * Log a message with a specific level, service, and context
+     * This method uses Pino internally to generate structured logs with:
+     * - Timestamp (ISO 8601)
+     * - Log level (INFO, WARN, ERROR, DEBUG)
+     * - Service / Module name
+     * - Context of the event (e.g., login, reconnection, retransmission)
+     * - Clear message
+     *
+     * @param level Log level
+     * @param message Clear message describing the event
+     * @param options Log options including:
+     *   - service: Service or module name
+     *   - context: Event context (login, reconnection, etc.)
+     *   - metadata: Additional structured data
+     *
+     * @example
+     * logger.log(LogLevel.INFO, 'User successfully logged in', {
+     *   service: 'AuthService',
+     *   context: 'login',
+     *   metadata: { userId: '123', method: 'oauth' }
+     * });
+     */
+    log(level: LogLevel, message: string, options?: LogOptions): void;
+    /**
+     * Check if a log level is enabled
+     */
+    isLevelEnabled(level: LogLevel): boolean;
+    /**
+     * Get the logger repository
+     */
+    getRepository(): LoggerRepository;
+    /**
+     * Get the log message use case
+     */
+    getLogMessageUseCase(): LogMessage;
+    /**
+     * Log an error with automatic type detection and level determination
+     *
+     * Automatically detects if the error is from:
+     * - Axios: Extracts status, URL, method, response data
+     * - Fetch: Extracts status, URL, response
+     * - Standard Error: Extracts message and stack
+     *
+     * Determines log level based on HTTP status:
+     * - Status 400-499: WARN (client errors)
+     * - Status 500+: ERROR (server errors)
+     * - Other errors: ERROR
+     *
+     * @param message Clear message describing what failed
+     * @param error The error object (Axios, Fetch, Error, or any)
+     * @param options Optional service, context, and additional metadata
+     *
+     * @example
+     * // Axios error (status 404 → WARN)
+     * try {
+     *   await axios.get('/api/user/123');
+     * } catch (error) {
+     *   logger.logError('Failed to fetch user', error, {
+     *     service: 'user-service',
+     *     context: 'user-fetch'
+     *   });
+     * }
+     *
+     * @example
+     * // Fetch error (status 500 → ERROR)
+     * try {
+     *   const res = await fetch('/api/data');
+     * } catch (error) {
+     *   logger.logError('Failed to fetch data', error, {
+     *     service: 'api-service',
+     *     context: 'data-fetch'
+     *   });
+     * }
+     *
+     * @example
+     * // Standard error (→ ERROR)
+     * try {
+     *   throw new Error('Database connection failed');
+     * } catch (error) {
+     *   logger.logError('Database error', error, {
+     *     service: 'database-service',
+     *     context: 'connection'
+     *   });
+     * }
+     */
+    logError(message: string, error: DetectableError, options?: Omit<LogOptions, 'metadata'> & {
+        metadata?: Record<string, unknown>;
+    }): void;
+    /**
+     * Get the log error use case
+     */
+    getLogErrorUseCase(): LogError;
+}

package/src/domain/di/logger_component.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=logger_component.js.map

package/src/domain/di/logger_component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger_component.js","sourceRoot":"","sources":["../../../../../../packages/logger/src/domain/di/logger_component.ts"],"names":[],"mappings":""}

package/src/domain/entities/error_types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Types for error detection and handling
+ */
+export interface AxiosError extends Error {
+    isAxiosError: true;
+    response?: {
+        status: number;
+        statusText: string;
+        data?: any;
+        headers?: any;
+    };
+    request?: any;
+    config?: {
+        url?: string;
+        method?: string;
+        headers?: any;
+        data?: any;
+    };
+    code?: string;
+}
+export interface FetchError extends Error {
+    response?: Response;
+    status?: number;
+    statusText?: string;
+}
+export type DetectableError = Error | AxiosError | FetchError | unknown;
+export interface ErrorInfo {
+    errorMessage: string;
+    errorStack?: string;
+    errorName?: string;
+    errorType: 'axios' | 'fetch' | 'standard' | 'unknown';
+    statusCode?: number;
+    statusText?: string;
+    url?: string;
+    method?: string;
+    responseData?: any;
+    requestData?: any;
+    errorCode?: string;
+}

package/src/domain/entities/error_types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Types for error detection and handling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=error_types.js.map

package/src/domain/entities/error_types.js.map

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

package/src/domain/entities/index.d.ts

@@ -0,0 +1,3 @@
+export * from './log_level';
+export * from './log_entry';
+export * from './logger_config';

package/src/domain/entities/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./log_level"), exports);
+tslib_1.__exportStar(require("./log_entry"), exports);
+tslib_1.__exportStar(require("./logger_config"), exports);
+//# sourceMappingURL=index.js.map

package/src/domain/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/logger/src/domain/entities/index.ts"],"names":[],"mappings":";;;AAAA,sDAA4B;AAC5B,sDAA4B;AAC5B,0DAAgC"}

package/src/domain/entities/log_entry.d.ts

@@ -0,0 +1,13 @@
+import { LogLevel } from './log_level';
+/**
+ * Represents a log entry
+ */
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: Date;
+    metadata?: Record<string, unknown>;
+    prefix?: string;
+    service?: string;
+    context?: string;
+}

package/src/domain/entities/log_entry.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=log_entry.js.map

package/src/domain/entities/log_entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log_entry.js","sourceRoot":"","sources":["../../../../../../packages/logger/src/domain/entities/log_entry.ts"],"names":[],"mappings":""}

package/src/domain/entities/log_level.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Log levels in order of severity
+ */
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+/**
+ * Numeric values for log level comparison
+ */
+export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;

package/src/domain/entities/log_level.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOG_LEVEL_PRIORITY = exports.LogLevel = void 0;
+/**
+ * Log levels in order of severity
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["INFO"] = "info";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+/**
+ * Numeric values for log level comparison
+ */
+exports.LOG_LEVEL_PRIORITY = {
+    [LogLevel.DEBUG]: 0,
+    [LogLevel.INFO]: 1,
+    [LogLevel.WARN]: 2,
+    [LogLevel.ERROR]: 3,
+};
+//# sourceMappingURL=log_level.js.map

package/src/domain/entities/log_level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log_level.js","sourceRoot":"","sources":["../../../../../../packages/logger/src/domain/entities/log_level.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;AACjB,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB;AAED;;GAEG;AACU,QAAA,kBAAkB,GAA6B;IAC1D,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACnB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IAClB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IAClB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;CACpB,CAAC"}

package/src/domain/entities/logger_config.d.ts

@@ -0,0 +1,52 @@
+import { LogLevel } from './log_level';
+/**
+ * Configuration options for the logger
+ */
+export interface LoggerConfig {
+    /**
+     * Minimum log level to display
+     * @default LogLevel.INFO
+     */
+    minLevel?: LogLevel;
+    /**
+     * Enable timestamp in logs
+     * @default true
+     */
+    enableTimestamps?: boolean;
+    /**
+     * Enable colored console output
+     * @default true
+     */
+    enableColors?: boolean;
+    /**
+     * Custom prefix for all log messages
+     * @default undefined
+     */
+    prefix?: string;
+    /**
+     * Service or module name
+     * @default undefined
+     */
+    service?: string;
+    /**
+     * Use Pino for logging instead of console
+     * @default false
+     */
+    usePino?: boolean;
+    /**
+     * Pino pretty print options
+     * @default undefined
+     */
+    prettyPrint?: boolean;
+    /**
+     * Custom output function (useful for testing or custom transports)
+     * @default console.log
+     */
+    outputFn?: (message: string) => void;
+}
+/**
+ * Default logger configuration
+ */
+export declare const DEFAULT_LOGGER_CONFIG: Required<Omit<LoggerConfig, 'outputFn'>> & {
+    outputFn?: (message: string) => void;
+};

package/src/domain/entities/logger_config.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LOGGER_CONFIG = void 0;
+const log_level_1 = require("./log_level");
+/**
+ * Default logger configuration
+ */
+exports.DEFAULT_LOGGER_CONFIG = {
+    minLevel: log_level_1.LogLevel.INFO,
+    enableTimestamps: true,
+    enableColors: true,
+    prefix: '',
+    service: '',
+    usePino: false,
+    prettyPrint: false,
+    outputFn: console.log,
+};
+//# sourceMappingURL=logger_config.js.map

package/src/domain/entities/logger_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger_config.js","sourceRoot":"","sources":["../../../../../../packages/logger/src/domain/entities/logger_config.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AAuDvC;;GAEG;AACU,QAAA,qBAAqB,GAAwF;IACxH,QAAQ,EAAE,oBAAQ,CAAC,IAAI;IACvB,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,IAAI;IAClB,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,KAAK;IAClB,QAAQ,EAAE,OAAO,CAAC,GAAG;CACtB,CAAC"}

package/src/domain/repositories/logger_repository.d.ts

@@ -0,0 +1,47 @@
+import { LogLevel } from '../entities/log_level';
+export interface LogOptions {
+    metadata?: Record<string, unknown>;
+    service?: string;
+    context?: string;
+}
+/**
+ * Interface for logger repository operations
+ */
+export interface LoggerRepository {
+    /**
+     * Log a debug message
+     * @param message Message to log
+     * @param options Optional log options (metadata, service, context)
+     */
+    debug(message: string, options?: LogOptions): void;
+    /**
+     * Log an info message
+     * @param message Message to log
+     * @param options Optional log options (metadata, service, context)
+     */
+    info(message: string, options?: LogOptions): void;
+    /**
+     * Log a warning message
+     * @param message Message to log
+     * @param options Optional log options (metadata, service, context)
+     */
+    warn(message: string, options?: LogOptions): void;
+    /**
+     * Log an error message
+     * @param message Message to log
+     * @param options Optional log options (metadata, service, context)
+     */
+    error(message: string, options?: LogOptions): void;
+    /**
+     * Log a message with a specific level, service, and context
+     * @param level Log level
+     * @param message Message to log
+     * @param options Log options (metadata, service, context)
+     */
+    log(level: LogLevel, message: string, options?: LogOptions): void;
+    /**
+     * Check if a log level is enabled
+     * @param level Log level to check
+     */
+    isLevelEnabled(level: LogLevel): boolean;
+}

package/src/domain/repositories/logger_repository.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=logger_repository.js.map

package/src/domain/repositories/logger_repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger_repository.js","sourceRoot":"","sources":["../../../../../../packages/logger/src/domain/repositories/logger_repository.ts"],"names":[],"mappings":""}

package/src/domain/use_cases/log_error.d.ts

@@ -0,0 +1,57 @@
+import { LoggerRepository, LogOptions } from '../repositories/logger_repository';
+import { DetectableError } from '../entities/error_types';
+/**
+ * Use case for intelligent error logging
+ * Automatically detects error type and determines appropriate log level
+ */
+export declare class LogError {
+    private repository;
+    constructor(repository: LoggerRepository);
+    /**
+     * Log an error with automatic type detection and level determination
+     *
+     * Rules:
+     * - Axios/Fetch errors with status 400-499: WARN
+     * - Axios/Fetch errors with status 500+: ERROR
+     * - All other errors: ERROR
+     *
+     * @param message Clear message describing what failed
+     * @param error The error object to analyze
+     * @param options Additional log options (service, context, metadata)
+     */
+    execute(message: string, error: DetectableError, options?: Omit<LogOptions, 'metadata'> & {
+        metadata?: Record<string, unknown>;
+    }): void;
+    /**
+     * Analyze error and extract relevant information
+     */
+    private analyzeError;
+    /**
+     * Determine log level based on error info
+     */
+    private determineLogLevel;
+    /**
+     * Check if error is an Axios error
+     */
+    private isAxiosError;
+    /**
+     * Check if error is a Fetch error
+     */
+    private isFetchError;
+    /**
+     * Extract information from Axios error
+     */
+    private extractAxiosErrorInfo;
+    /**
+     * Extract information from Fetch error
+     */
+    private extractFetchErrorInfo;
+    /**
+     * Extract information from standard Error
+     */
+    private extractStandardErrorInfo;
+    /**
+     * Extract information from unknown error
+     */
+    private extractUnknownErrorInfo;
+}