lognerd 0.1.0 → 1.0.1

package/README.md

@@ -16,15 +16,44 @@ npm install lognerd
 
 ## 📖 Uso Básico
 
+### Uso Directo (Recomendado - Patrón Singleton)
+
+Puedes usar el logger directamente sin necesidad de crear una instancia:
+
 ```typescript
-import { createLogger } from 'lognerd';
+import { info, warn, error, debug } from 'lognerd';
+
+// Uso directo - el logger se configura automáticamente desde variables de entorno
+info('Aplicación iniciada');
+error('Error crítico', { code: 500, message: 'Error de servidor' });
+warn('Advertencia: conexión lenta');
+debug('Información de debug', { userId: 123 });
+```
+
+O usando el objeto logger:
 
-const logger = createLogger();
+```typescript
+import { logger } from 'lognerd';
 
 logger.info('Aplicación iniciada');
-logger.error('Error crítico', { code: 500, message: 'Error de servidor' });
-logger.warn('Advertencia: conexión lenta');
-logger.debug('Información de debug', { userId: 123 });
+logger.error('Error crítico', { code: 500 });
+logger.warn('Advertencia');
+logger.debug('Debug info');
+```
+
+### Uso con Instancia Personalizada
+
+Si necesitas múltiples instancias con configuraciones diferentes:
+
+```typescript
+import { createLogger } from 'lognerd';
+
+const customLogger = createLogger({
+  level: 'DEBUG',
+  filePath: './logs/custom.log',
+});
+
+customLogger.info('Mensaje con logger personalizado');
 ```
 
 ## ⚙️ Configuración
@@ -135,9 +164,10 @@ NODE_ENV=production LOGNERD_LEVEL=WARN
 ### Ejemplo Completo
 
 ```typescript
-import { createLogger } from 'lognerd';
+import { info, warn, error, debug, configureLogger } from 'lognerd';
 
-const logger = createLogger({
+// Configurar el logger (opcional, se configura automáticamente desde variables de entorno)
+configureLogger({
   level: process.env.NODE_ENV === 'production' ? 'WARN' : 'DEBUG',
   environment: process.env.NODE_ENV || 'development',
   filePath: './logs/app.log',
@@ -146,39 +176,71 @@ const logger = createLogger({
 // En desarrollo: se muestra en consola con colores y se guarda en archivo
 // En producción: solo se guarda en archivo
 
-logger.info('Servidor iniciado en puerto 3000');
-logger.debug('Variables de entorno cargadas', { env: process.env.NODE_ENV });
+info('Servidor iniciado en puerto 3000');
+debug('Variables de entorno cargadas', { env: process.env.NODE_ENV });
 
 try {
   // Tu código aquí
-  logger.info('Operación exitosa');
-} catch (error) {
-  logger.error('Error en operación', { error: error.message, stack: error.stack });
+  info('Operación exitosa');
+} catch (err) {
+  error('Error en operación', { error: err.message, stack: err.stack });
 }
 ```
 
 ### Actualizar Configuración en Tiempo de Ejecución
 
 ```typescript
-const logger = createLogger();
+import { configureLogger } from 'lognerd';
 
-// Cambiar el nivel de log dinámicamente
-logger.updateConfig({ level: 'ERROR' });
+// Cambiar el nivel de log dinámicamente del singleton
+configureLogger({ level: 'ERROR' });
 ```
 
 ## 🔧 API
 
+### Funciones Directas (Singleton)
+
+El paquete exporta funciones directas que usan una instancia singleton del logger:
+
+```typescript
+import { info, warn, error, debug, logger, configureLogger } from 'lognerd';
+
+// Funciones directas
+info('Mensaje informativo');
+warn('Advertencia');
+error('Error', { code: 500 });
+debug('Debug', { data: 'test' });
+
+// Objeto logger (mismo singleton)
+logger.info('Mensaje');
+logger.warn('Advertencia');
+
+// Configurar el singleton
+configureLogger({ level: 'WARN', filePath: './logs/custom.log' });
+```
+
 ### `createLogger(config?: Partial<LoggerConfig>): LoggerService`
 
-Crea una instancia del logger con la configuración proporcionada.
+Crea una nueva instancia del logger con configuración personalizada (útil para múltiples loggers).
 
-### Métodos del Logger
+### Métodos Disponibles
 
-- `logger.error(message: string, data?: unknown): void` - Log de error
-- `logger.warn(message: string, data?: unknown): void` - Log de advertencia
+**Funciones directas (singleton):**
+- `info(message: string, data?: unknown): void` - Log informativo
+- `warn(message: string, data?: unknown): void` - Log de advertencia
+- `error(message: string, data?: unknown): void` - Log de error
+- `debug(message: string, data?: unknown): void` - Log de debug
+- `configureLogger(config: Partial<LoggerConfig>): void` - Actualizar configuración del singleton
+
+**Objeto logger (singleton):**
 - `logger.info(message: string, data?: unknown): void` - Log informativo
+- `logger.warn(message: string, data?: unknown): void` - Log de advertencia
+- `logger.error(message: string, data?: unknown): void` - Log de error
 - `logger.debug(message: string, data?: unknown): void` - Log de debug
-- `logger.updateConfig(newConfig: Partial<LoggerConfig>): void` - Actualizar configuración
+- `logger.updateConfig(config: Partial<LoggerConfig>): void` - Actualizar configuración
+
+**Instancias personalizadas:**
+- `logger.updateConfig(newConfig: Partial<LoggerConfig>): void` - Actualizar configuración (en instancias creadas con `createLogger`)
 
 ## 📦 Estructura de Archivos de Log
 

package/dist/index.d.ts

@@ -1,7 +1,25 @@
 import { LoggerService } from './logger/logger.service';
 import { createLoggerConfig } from './logger/logger.config';
 import { LoggerConfig, LogLevel } from './logger/logger.types';
+/**
+ * Crea una nueva instancia del logger con configuración personalizada
+ */
 export declare const createLogger: (config?: Partial<LoggerConfig>) => LoggerService;
+/**
+ * Actualiza la configuración del logger singleton
+ */
+export declare const configureLogger: (config: Partial<LoggerConfig>) => void;
+export declare const info: (message: string, data?: unknown) => void;
+export declare const warn: (message: string, data?: unknown) => void;
+export declare const error: (message: string, data?: unknown) => void;
+export declare const debug: (message: string, data?: unknown) => void;
+export declare const logger: {
+    info: (message: string, data?: unknown) => void;
+    warn: (message: string, data?: unknown) => void;
+    error: (message: string, data?: unknown) => void;
+    debug: (message: string, data?: unknown) => void;
+    updateConfig: (config: Partial<LoggerConfig>) => void;
+};
 export { LoggerService };
 export type { LoggerConfig, LogLevel };
 export { createLoggerConfig };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE/D,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,CAAC,YAAY,CAAC,kBAG1D,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAgB/D;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,CAAC,YAAY,CAAC,kBAG1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,OAAO,CAAC,YAAY,CAAC,KAAG,IAK/D,CAAC;AAGF,eAAO,MAAM,IAAI,GAAI,SAAS,MAAM,EAAE,OAAO,OAAO,KAAG,IAEtD,CAAC;AAEF,eAAO,MAAM,IAAI,GAAI,SAAS,MAAM,EAAE,OAAO,OAAO,KAAG,IAEtD,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,SAAS,MAAM,EAAE,OAAO,OAAO,KAAG,IAEvD,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,SAAS,MAAM,EAAE,OAAO,OAAO,KAAG,IAEvD,CAAC;AAGF,eAAO,MAAM,MAAM;oBAjBW,MAAM,SAAS,OAAO,KAAG,IAAI;oBAI7B,MAAM,SAAS,OAAO,KAAG,IAAI;qBAI5B,MAAM,SAAS,OAAO,KAAG,IAAI;qBAI7B,MAAM,SAAS,OAAO,KAAG,IAAI;2BAUnC,OAAO,CAAC,YAAY,CAAC;CAC7C,CAAC;AAGF,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/index.js

@@ -1,13 +1,63 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createLoggerConfig = exports.LoggerService = exports.createLogger = void 0;
+exports.createLoggerConfig = exports.LoggerService = exports.logger = exports.debug = exports.error = exports.warn = exports.info = exports.configureLogger = exports.createLogger = void 0;
 const logger_service_1 = require("./logger/logger.service");
 Object.defineProperty(exports, "LoggerService", { enumerable: true, get: function () { return logger_service_1.LoggerService; } });
 const logger_config_1 = require("./logger/logger.config");
 Object.defineProperty(exports, "createLoggerConfig", { enumerable: true, get: function () { return logger_config_1.createLoggerConfig; } });
+// Instancia singleton del logger
+let loggerInstance = null;
+/**
+ * Crea o retorna la instancia singleton del logger
+ */
+const getLogger = () => {
+    if (!loggerInstance) {
+        const config = (0, logger_config_1.createLoggerConfig)();
+        loggerInstance = new logger_service_1.LoggerService(config);
+    }
+    return loggerInstance;
+};
+/**
+ * Crea una nueva instancia del logger con configuración personalizada
+ */
 const createLogger = (config) => {
     const loggerConfig = (0, logger_config_1.createLoggerConfig)(config);
     return new logger_service_1.LoggerService(loggerConfig);
 };
 exports.createLogger = createLogger;
+/**
+ * Actualiza la configuración del logger singleton
+ */
+const configureLogger = (config) => {
+    if (!loggerInstance) {
+        getLogger();
+    }
+    loggerInstance.updateConfig(config);
+};
+exports.configureLogger = configureLogger;
+// Exportar métodos directos del logger singleton
+const info = (message, data) => {
+    getLogger().info(message, data);
+};
+exports.info = info;
+const warn = (message, data) => {
+    getLogger().warn(message, data);
+};
+exports.warn = warn;
+const error = (message, data) => {
+    getLogger().error(message, data);
+};
+exports.error = error;
+const debug = (message, data) => {
+    getLogger().debug(message, data);
+};
+exports.debug = debug;
+// Exportar también el logger singleton completo
+exports.logger = {
+    info: exports.info,
+    warn: exports.warn,
+    error: exports.error,
+    debug: exports.debug,
+    updateConfig: (config) => (0, exports.configureLogger)(config),
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,4DAAwD;AAS/C,8FATA,8BAAa,OASA;AARtB,0DAA4D;AAUnD,mGAVA,kCAAkB,OAUA;AAPpB,MAAM,YAAY,GAAG,CAAC,MAA8B,EAAE,EAAE;IAC7D,MAAM,YAAY,GAAG,IAAA,kCAAkB,EAAC,MAAM,CAAC,CAAC;IAChD,OAAO,IAAI,8BAAa,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC,CAAC;AAHW,QAAA,YAAY,gBAGvB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,4DAAwD;AA+D/C,8FA/DA,8BAAa,OA+DA;AA9DtB,0DAA4D;AAgEnD,mGAhEA,kCAAkB,OAgEA;AA7D3B,iCAAiC;AACjC,IAAI,cAAc,GAAyB,IAAI,CAAC;AAEhD;;GAEG;AACH,MAAM,SAAS,GAAG,GAAkB,EAAE;IACpC,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAA,kCAAkB,GAAE,CAAC;QACpC,cAAc,GAAG,IAAI,8BAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC,CAAC;AAEF;;GAEG;AACI,MAAM,YAAY,GAAG,CAAC,MAA8B,EAAE,EAAE;IAC7D,MAAM,YAAY,GAAG,IAAA,kCAAkB,EAAC,MAAM,CAAC,CAAC;IAChD,OAAO,IAAI,8BAAa,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC,CAAC;AAHW,QAAA,YAAY,gBAGvB;AAEF;;GAEG;AACI,MAAM,eAAe,GAAG,CAAC,MAA6B,EAAQ,EAAE;IACrE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,SAAS,EAAE,CAAC;IACd,CAAC;IACD,cAAe,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC,CAAC;AALW,QAAA,eAAe,mBAK1B;AAEF,iDAAiD;AAC1C,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE;IAC5D,SAAS,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC,CAAC;AAFW,QAAA,IAAI,QAEf;AAEK,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE;IAC5D,SAAS,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC,CAAC;AAFW,QAAA,IAAI,QAEf;AAEK,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE;IAC7D,SAAS,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC,CAAC;AAFW,QAAA,KAAK,SAEhB;AAEK,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE;IAC7D,SAAS,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC,CAAC;AAFW,QAAA,KAAK,SAEhB;AAEF,gDAAgD;AACnC,QAAA,MAAM,GAAG;IACpB,IAAI,EAAJ,YAAI;IACJ,IAAI,EAAJ,YAAI;IACJ,KAAK,EAAL,aAAK;IACL,KAAK,EAAL,aAAK;IACL,YAAY,EAAE,CAAC,MAA6B,EAAE,EAAE,CAAC,IAAA,uBAAe,EAAC,MAAM,CAAC;CACzE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lognerd",
-  "version": "0.1.0",
+  "version": "1.0.1",
   "description": "Sistema de logging con colores y escritura a archivo",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,6 +29,9 @@
   "peerDependencies": {
     "typescript": "^5.0.0"
   },
+  "engines": {
+    "node": ">=16.0.0"
+  },
   "files": [
     "dist",
     "README.md"
@@ -37,6 +40,7 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "test": "ts-node test-logger.ts",
-    "test:env": "ts-node test-env.ts"
+    "test:env": "ts-node test-env.ts",
+    "test:singleton": "ts-node test-singleton.ts"
   }
 }