jsgar 1.2.2 → 1.2.4

package/dist/gar.umd.js

@@ -38,8 +38,10 @@
          * @param {string} wsEndpoint - WebSocket endpoint (e.g., "ws://localhost:8765")
          * @param {string} user - Client username for identification
          * @param {number} [heartbeatInterval=4000] - Heartbeat interval in milliseconds
+         * @param {boolean} [allowSelfSignedCertificate=false] - Allow self-signed certificates
+         * @param {string} [logLevel='INFO'] - Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
          */
-        constructor(wsEndpoint, user, heartbeatInterval = 4000, allowSelfSignedCertificate = false) {
+        constructor(wsEndpoint, user, heartbeatInterval = 4000, allowSelfSignedCertificate = false, logLevel = 'INFO') {
             this.wsEndpoint = wsEndpoint;
             this.websocket = null;
             this.messageQueue = [];
@@ -70,18 +72,33 @@
             this.allowSelfSignedCertificate = allowSelfSignedCertificate;
             this.exitCode = 0;
 
+            // Initialize log levels and set logLevel
+            this.logLevels = ['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL'];
+            this.logLevel = logLevel.toUpperCase();
+            if (!this.logLevels.includes(this.logLevel)) {
+                console.warn(`Invalid logLevel "${logLevel}" provided; defaulting to INFO`);
+                this.logLevel = 'INFO';
+            }
+
             this.registerDefaultHandlers();
         }
 
         /**
-         * Log messages with a specific level.
-         * @param {string} level - Log level (DEBUG, INFO, WARNING, ERROR)
+         * Log messages with a specific level, only if the level is at or above the configured logLevel.
+         * @param {string} level - Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
          * @param {string} message - Message to log
-         * @param  {...any} args - Additional arguments
+         * @param {...any} args - Additional arguments
          */
         log(level, message, ...args) {
-            const timestamp = new Date().toISOString();
-            console.log(`${timestamp} ${level} gar.js - ${message}`, ...args);
+            const levelUpper = level.toUpperCase();
+            if (!this.logLevels.includes(levelUpper)) {
+                console.warn(`Invalid log level "${level}" in log call`);
+                return;
+            }
+            if (this.logLevels.indexOf(levelUpper) >= this.logLevels.indexOf(this.logLevel)) {
+                const timestamp = new Date().toISOString();
+                console.log(`${timestamp} ${levelUpper} gar.js - ${message}`, ...args);
+            }
         }
 
         /**
@@ -373,17 +390,17 @@
             this.registerHeartbeatHandler((u_milliseconds) => this.log('DEBUG', `Heartbeat received ${u_milliseconds}}`));
             this.registerLogoffHandler(() => this.log('INFO', 'Logoff received'));
             this.registerTopicIntroductionHandler((topicId, name) =>
-                this.log('INFO', `New server topic: ${name} (Server ID: ${topicId})`));
+                this.log('DEBUG', `New server topic: ${name} (Server ID: ${topicId})`));
             this.registerKeyIntroductionHandler((keyId, name, _class) =>
-                this.log('INFO', `New server key: ${name} (Server ID: ${keyId})`));
+                this.log('DEBUG', `New server key: ${name} (Server ID: ${keyId})`));
             this.registerDeleteKeyHandler((keyId) =>
-                this.log('INFO', `Delete key: ${this.serverKeyMap.get(keyId) || 'unknown'} (Server ID: ${keyId})`));
+                this.log('DEBUG', `Delete key: ${this.serverKeyMap.get(keyId) || 'unknown'} (Server ID: ${keyId})`));
             this.registerSubscriptionStatusHandler((name, status) =>
                 this.log('INFO', `Subscription ${name} status: ${status}`));
             this.registerDeleteRecordHandler((keyId, topicId) =>
-                this.log('INFO', `Delete record: ${this.serverKeyMap.get(keyId) || 'unknown'} - ${this.serverTopicMap.get(topicId) || 'unknown'}`));
+                this.log('DEBUG', `Delete record: ${this.serverKeyMap.get(keyId) || 'unknown'} - ${this.serverTopicMap.get(topicId) || 'unknown'}`));
             this.registerRecordUpdateHandler((keyId, topicId, value) =>
-                this.log('INFO', `Record update: ${this.serverKeyMap.get(keyId) || 'unknown'} - ${this.serverTopicMap.get(topicId) || 'unknown'} = ${JSON.stringify(value)}`));
+                this.log('DEBUG', `Record update: ${this.serverKeyMap.get(keyId) || 'unknown'} - ${this.serverTopicMap.get(topicId) || 'unknown'} = ${JSON.stringify(value)}`));
             this.registerShutdownHandler(() => this.log('INFO', 'Shutdown received'));
         }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsgar",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "A Javascript client for the GAR protocol",
   "type": "module",
   "main": "dist/gar.umd.js",