@reldens/utils 0.51.0 → 0.52.0

package/README.md

@@ -2,7 +2,7 @@
 
 # Reldens - Utils
 
-### Features
+## Features
 
 - Interaction area calculation helper.
 - Page range provider helper.
@@ -13,6 +13,106 @@
 - Error Manager.
 - Events Manager and Events Manager Singleton.
 
+---
+
+## Usage examples
+
+### EventsManager
+Advanced event emitter with features like event sanitization, memory leak detection, key-based event management, and support for async/sync execution.
+
+```javascript
+const { EventsManager } = require('@reldens/utils');
+let eventsManager = new EventsManager();
+
+// Listen to events
+eventsManager.on('userLogin', (userData) => {
+    console.log('User logged in:', userData.username);
+});
+
+// Emit events
+eventsManager.emit('userLogin', { username: 'player1', id: 123 });
+
+// Listen with unique keys
+eventsManager.onWithKey('gameStart', callback, 'uniqueKey');
+eventsManager.offWithKey('uniqueKey'); // Remove by key
+```
+
+### InteractionArea
+Spatial interaction validation helper that determines if objects are within interaction range based on coordinates and area margins.
+
+```javascript
+const { InteractionArea } = require('@reldens/utils');
+let interactionArea = new InteractionArea();
+
+// Setup interaction area
+interactionArea.setupInteractionArea(50, 100, 200); // margin=50, x=100, y=200
+
+// Validate interaction
+let isValid = interactionArea.isValidInteraction(120, 210); // true
+let isInvalid = interactionArea.isValidInteraction(200, 300); // false
+```
+
+### Logger
+Advanced logging utility with multiple log levels, custom levels support, active level filtering, and environment-based configuration.
+
+```javascript
+const { Logger } = require('@reldens/utils');
+
+// Standard logging
+Logger.info('Application started');
+Logger.error('Database connection failed', errorDetails);
+Logger.debug('Processing user request', requestData);
+
+// Custom levels
+Logger.activeLogLevels = [3, 4, 10]; // Only critical, error, and custom level 10
+Logger.customLevels = [10, 11, 12];
+Logger.log(10, 'custom', 'Custom log message');
+
+// Configuration
+Logger.setForcedDisabled(false);
+Logger.setAddTimeStamp(true);
+```
+
+### PageRangeProvider
+Pagination helper that calculates page ranges for UI components, handling first/last page navigation and customizable display options.
+
+```javascript
+const { PageRangeProvider } = require('@reldens/utils');
+let pageProvider = new PageRangeProvider();
+
+// Generate page range
+let range = pageProvider.fetch(5, 20, 7, 'First', 'Last');
+// Returns: [{label: 'First', value: 1}, {label: 2, value: 2}, ...]
+
+// Simple range
+let simpleRange = pageProvider.fetch(3, 10, 5);
+// Returns pages around current page 3
+```
+
+### SchemaValidator
+Object validation utility that validates object properties against defined schemas with support for nested objects and custom validation rules.
+
+```javascript
+const { SchemaValidator } = require('@reldens/utils');
+
+let schema = {
+    username: { type: 'string', min: 3, max: 20 },
+    age: { type: 'int', min: 18 },
+    profile: { 
+        type: 'object', 
+        nested: {
+            email: { type: 'string', required: true }
+        }
+    }
+};
+
+let validator = new SchemaValidator(schema);
+let userData = { username: 'player1', age: 25, profile: { email: 'test@example.com' } };
+let isValid = validator.validate(userData);
+```
+
+---
+
 Need something specific?
 
 [Request a feature here: https://www.reldens.com/features-request](https://www.reldens.com/features-request)

package/lib/logger.js

@@ -32,6 +32,8 @@ class Logger
         this.maxLogArgLength = sc.get(context, 'RELDENS_LOGS_MAX_ARGUMENT_LENGTH', 0);
         this.maxStackTraceLength = sc.get(context, 'RELDENS_LOGS_MAX_STACK_TRACE_LENGTH', 0);
         this.applySanitizer = Boolean(sc.get(context, 'RELDENS_LOGS_APPLY_SANITIZER', false));
+        this.activeLogLevels = [];
+        this.customLevels = [];
     }
 
     context()
@@ -91,8 +93,21 @@ class Logger
         return (this.context().RELDENS_ENABLE_TRACE_FOR || '').split(',');
     }
 
-    log(levelLabel, ...args)
+    log(levelNumber, levelLabel, ...args)
     {
+        if(this.forcedDisabled){
+            return this;
+        }
+        if(0 < this.activeLogLevels.length){
+            if(-1 === this.activeLogLevels.indexOf(levelNumber)){
+                return this;
+            }
+        }
+        if(0 === this.activeLogLevels.length){
+            if(levelNumber > this.logLevel()){
+                return this;
+            }
+        }
         let date = !this.addTimeStamp ? '' : (new Date()).toISOString().slice(0, 19).replace('T', ' ')+' - ';
         let processedArgs = args;
         if(this.applySanitizer){
@@ -125,90 +140,42 @@ class Logger
 
     debug(...args)
     {
-        if(this.forcedDisabled){
-            return this;
-        }
-        if(8 > this.logLevel()){
-            return this;
-        }
-        return this.log('debug', ...args);
+        return this.log(8, 'debug', ...args);
     }
 
     info(...args)
     {
-        if(this.forcedDisabled){
-            return this;
-        }
-        if(7 > this.logLevel()){
-            return this;
-        }
-        return this.log('info', ...args);
+        return this.log(7, 'info', ...args);
     }
 
     notice(...args)
     {
-        if(this.forcedDisabled){
-            return this;
-        }
-        if(6 > this.logLevel()){
-            return this;
-        }
-        return this.log('notice', ...args);
+        return this.log(6, 'notice', ...args);
     }
 
     warning(...args)
     {
-        if(this.forcedDisabled){
-            return this;
-        }
-        if(5 > this.logLevel()){
-            return this;
-        }
-        return this.log('warning', ...args);
+        return this.log(5, 'warning', ...args);
     }
 
     error(...args)
     {
-        if(this.forcedDisabled){
-            return this;
-        }
-        if(4 > this.logLevel()){
-            return this;
-        }
-        return this.log('error', ...args);
+        return this.log(4, 'error', ...args);
     }
 
     critical(...args)
     {
-        if(this.forcedDisabled){
-            return this;
-        }
-        if(3 > this.logLevel()){
-            return this;
-        }
-        return this.log('critical', ...args);
+        return this.log(3, 'critical', ...args);
     }
 
     alert(...args)
     {
-        if(this.forcedDisabled){
-            return this;
-        }
-        if(2 > this.logLevel()){
-            return this;
-        }
-        return this.log('alert', ...args);
+        return this.log(2, 'alert', ...args);
     }
 
     emergency(...args)
     {
-        if(this.forcedDisabled){
-            return this;
-        }
-        if(1 > this.logLevel()){
-            return this;
-        }
-        return this.log('emergency', ...args);
+        return this.log(1, 'emergency', ...args);
     }
 
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@reldens/utils",
     "scope": "@reldens",
-    "version": "0.51.0",
+    "version": "0.52.0",
     "description": "Reldens - Utils",
     "author": "Damian A. Pastorini",
     "license": "MIT",