tauri-plugin-serialplugin-api 2.18.0 → 2.20.0

package/README.md

@@ -1,4 +1,4 @@
-[![npm version](https://img.shields.io/npm/v/tauri-plugin-serialplugin/latest?style=for-the-badge)](https://www.npmjs.com/package/tauri-plugin-serialplugin)
+[![npm version](https://img.shields.io/npm/v/tauri-plugin-serialplugin-api/latest?style=for-the-badge)](https://www.npmjs.com/package/tauri-plugin-serialplugin-api)
 [![Crates.io](https://img.shields.io/crates/v/tauri-plugin-serialplugin?style=for-the-badge)](https://crates.io/crates/tauri-plugin-serialplugin)
 [![Documentation](https://img.shields.io/badge/docs-docs.rs-blue?style=for-the-badge)](https://docs.rs/tauri-plugin-serialplugin/latest/tauri_plugin_serialplugin/all.html)
 [![GitHub issues](https://img.shields.io/github/issues/s00d/tauri-plugin-serialplugin?style=for-the-badge)](https://github.com/s00d/tauri-plugin-serialplugin/issues)
@@ -18,22 +18,24 @@ A comprehensive plugin for Tauri applications to communicate with serial ports.
 1. [Installation](#installation)
 2. [Basic Usage](#basic-usage)
 3. [TypeScript Support](#typescript-support)
-4. [Rust Usage](#rust-usage)
-5. [Permissions](#permissions)
-6. [API Reference](#api-reference)  
-   6.1. [Port Discovery](#port-discovery)  
-   6.2. [Connection Management](#connection-management)  
-   6.3. [Data Transfer](#data-transfer)  
-   6.4. [Port Configuration](#port-configuration)  
-   6.5. [Control Signals](#control-signals)  
-   6.6. [Buffer Management](#buffer-management)
-7. [Common Use Cases](#common-use-cases)
-8. [Android Setup](#android-setup)
-9. [Contributing](#contributing)
-10. [Development Setup](#development-setup)
-11. [Testing](#testing)
-12. [Partners](#partners)
-13. [License](#license)
+4. [Log Level Control](#log-level-control)
+5. [Rust Usage](#rust-usage)
+6. [Permissions](#permissions)
+7. [API Reference](#api-reference)  
+   7.1. [Port Discovery](#port-discovery)  
+   7.2. [Connection Management](#connection-management)  
+   7.3. [Data Transfer](#data-transfer)  
+   7.4. [Port Configuration](#port-configuration)  
+   7.5. [Control Signals](#control-signals)  
+   7.6. [Buffer Management](#buffer-management)  
+   7.7. [Log Control](#log-control)
+8. [Common Use Cases](#common-use-cases)
+9. [Android Setup](#android-setup)
+10. [Contributing](#contributing)
+11. [Development Setup](#development-setup)
+12. [Testing](#testing)
+13. [Partners](#partners)
+14. [License](#license)
 
 ---
 
@@ -143,9 +145,12 @@ pnpm add tauri-plugin-serialplugin-api
    // Write data
    await port.write("Hello, Serial Port!");
 
+   // Start port listening
+   await port.startListening();
+
    // Start port listening
    const unsubscribe = await port.listen((data) => {
-     console.log("Received:", data);
+      console.log("Received:", data);
    });
 
    // Stop listening when done
@@ -336,6 +341,113 @@ await port.clearBreak();
 
 ---
 
+## Log Level Control
+
+The plugin provides comprehensive logging control to help you manage verbosity in production environments. By default, the plugin logs informational messages, but you can adjust this to reduce noise or enable detailed debugging.
+
+### TypeScript/JavaScript Usage
+
+```typescript
+import { SerialPort, LogLevel } from "tauri-plugin-serialplugin-api";
+
+// Disable all logs (recommended for production)
+await SerialPort.setLogLevel(LogLevel.None);
+
+// Show only errors
+await SerialPort.setLogLevel(LogLevel.Error);
+
+// Show errors and warnings
+await SerialPort.setLogLevel(LogLevel.Warn);
+
+// Show errors, warnings, and info (default)
+await SerialPort.setLogLevel(LogLevel.Info);
+
+// Enable all logs including debug information
+await SerialPort.setLogLevel(LogLevel.Debug);
+
+// Get current log level
+const currentLevel = await SerialPort.getLogLevel();
+console.log("Current log level:", currentLevel);
+```
+
+### Rust Usage
+
+```rust
+use tauri_plugin_serialplugin::state::{LogLevel, set_log_level};
+
+// Set log level on plugin initialization
+fn main() {
+    // Disable logs in production
+    set_log_level(LogLevel::None);
+    
+    tauri::Builder::default()
+        .plugin(tauri_plugin_serialplugin::init())
+        .run(tauri::generate_context!())
+        .expect("error while running tauri application");
+}
+```
+
+Or configure via command:
+
+```rust
+use tauri_plugin_serialplugin::commands::set_log_level;
+use tauri_plugin_serialplugin::state::LogLevel;
+use tauri::{AppHandle, State};
+
+#[tauri::command]
+async fn configure_production_logging(
+    app: AppHandle<tauri::Wry>,
+    serial: State<'_, tauri_plugin_serialplugin::desktop_api::SerialPort<tauri::Wry>>
+) -> Result<(), String> {
+    // Only show errors in production
+    set_log_level(app, serial, LogLevel::Error)
+        .map_err(|e| e.to_string())
+}
+```
+
+### Log Levels
+
+- **`None`** - No logging output (recommended for production)
+- **`Error`** - Only critical errors
+- **`Warn`** - Errors and warnings
+- **`Info`** - Errors, warnings, and general information (default)
+- **`Debug`** - All logging including debug information (for development)
+
+### Common Use Cases
+
+#### Production Environment
+
+```typescript
+// Disable noisy logs when polling for available ports
+await SerialPort.setLogLevel(LogLevel.None);
+
+setInterval(async () => {
+  const ports = await SerialPort.available_ports();
+  // No "listen event: plugin-serialplugin-disconnected-COM6" logs
+}, 1000);
+```
+
+#### Development with Debugging
+
+```typescript
+// Enable detailed logging for troubleshooting
+await SerialPort.setLogLevel(LogLevel.Debug);
+
+const port = new SerialPort({ path: "COM1", baudRate: 9600 });
+await port.open();
+// See all internal events and state changes
+```
+
+#### Conditional Logging
+
+```typescript
+// Set log level based on environment
+const isDevelopment = import.meta.env.DEV;
+await SerialPort.setLogLevel(isDevelopment ? LogLevel.Debug : LogLevel.Error);
+```
+
+---
+
 ## Rust Usage
 
 This plugin can also be used directly from Rust code in your Tauri backend. For complete API documentation, see [docs.rs](https://docs.rs/tauri-plugin-serialplugin/).
@@ -899,6 +1011,10 @@ Below is a list of all permissions the plugin supports. Granting or denying them
 | `serialplugin:deny-start-listening`         | Denies starting automatic port monitoring and data listening                  |
 | `serialplugin:allow-stop-listening`         | Allows stopping automatic port monitoring and data listening                  |
 | `serialplugin:deny-stop-listening`          | Denies stopping automatic port monitoring and data listening                  |
+| `serialplugin:allow-set-log-level`          | Allows setting the global log level                                           |
+| `serialplugin:deny-set-log-level`           | Denies setting the global log level                                           |
+| `serialplugin:allow-get-log-level`          | Allows getting the current log level                                          |
+| `serialplugin:deny-get-log-level`           | Denies getting the current log level                                          |
 
 ### Granting All Permissions (Example)
 
@@ -934,7 +1050,9 @@ Below is a list of all permissions the plugin supports. Granting or denying them
   "serialplugin:allow-set-break",
   "serialplugin:allow-clear-break",
   "serialplugin:allow-start-listening",
-  "serialplugin:allow-stop-listening"
+  "serialplugin:allow-stop-listening",
+  "serialplugin:allow-set-log-level",
+  "serialplugin:allow-get-log-level"
 ]
 ```
 
@@ -1281,6 +1399,46 @@ class SerialPort {
 }
 ```
 
+### Log Control
+
+```typescript
+class SerialPort {
+  /**
+   * Sets the global log level for the plugin
+   * @param {LogLevel} level The log level to set (None, Error, Warn, Info, Debug)
+   * @returns {Promise<void>}
+   * @example
+   * // Disable all logs in production
+   * await SerialPort.setLogLevel(LogLevel.None);
+   * 
+   * // Show only errors
+   * await SerialPort.setLogLevel(LogLevel.Error);
+   * 
+   * // Enable debug logs
+   * await SerialPort.setLogLevel(LogLevel.Debug);
+   */
+  static async setLogLevel(level: LogLevel): Promise<void>;
+
+  /**
+   * Gets the current global log level
+   * @returns {Promise<LogLevel>} A promise that resolves to the current log level
+   * @example
+   * const currentLevel = await SerialPort.getLogLevel();
+   * console.log("Current log level:", currentLevel);
+   */
+  static async getLogLevel(): Promise<LogLevel>;
+}
+
+// Available log levels
+enum LogLevel {
+  None = "None",      // No logging output
+  Error = "Error",    // Only critical errors
+  Warn = "Warn",      // Errors and warnings
+  Info = "Info",      // Errors, warnings, and info (default)
+  Debug = "Debug"     // All logging including debug information
+}
+```
+
 ### Auto-Reconnect Management
 
 ```typescript
@@ -1355,6 +1513,7 @@ const port = new SerialPort({
 });
 
 await port.open();
+await port.startListening();
 await port.listen((data) => {
   const sensorValue = parseFloat(data);
   console.log("Sensor reading:", sensorValue);
@@ -1375,6 +1534,9 @@ await port.open();
 const command = new Uint8Array([0x02, 0x01, 0x03]);
 await port.writeBinary(command);
 
+// Start listening for response
+await port.startListening();
+
 // Read response (raw bytes)
 await port.listen((data) => {
   const response = data instanceof Uint8Array ? data : new Uint8Array();
@@ -1433,6 +1595,7 @@ await port.enableAutoReconnect({
 });
 
 // Set up data listener
+await port.startListening();
 const unsubscribe = await port.listen((data) => {
   console.log("Received data:", data);
 });

package/dist-js/index.cjs

@@ -3,6 +3,58 @@
 var core = require('@tauri-apps/api/core');
 var event = require('@tauri-apps/api/event');
 
+// Centralized logger for the serial plugin
+// Avoids circular dependencies and code duplication
+// Global log level state
+let currentLogLevel = "Info";
+/**
+ * Sets the global log level
+ */
+function setLogLevel(level) {
+    currentLogLevel = level;
+}
+/**
+ * Checks if a message should be logged based on current log level
+ */
+function shouldLog(level) {
+    const levels = ["None", "Error", "Warn", "Info", "Debug"];
+    const currentIndex = levels.indexOf(currentLogLevel);
+    const requestedIndex = levels.indexOf(level);
+    return requestedIndex <= currentIndex && currentIndex > 0;
+}
+/**
+ * Logs an error message
+ */
+function logError(...args) {
+    if (shouldLog("Error")) {
+        console.error(...args);
+    }
+}
+/**
+ * Logs a warning message
+ */
+function logWarn(...args) {
+    if (shouldLog("Warn")) {
+        console.warn(...args);
+    }
+}
+/**
+ * Logs an info message
+ */
+function logInfo(...args) {
+    if (shouldLog("Info")) {
+        console.log(...args);
+    }
+}
+/**
+ * Logs a debug message
+ */
+function logDebug(...args) {
+    if (shouldLog("Debug")) {
+        console.log(...args);
+    }
+}
+
 /**
  * Auto-reconnect manager for serial ports
  * Handles automatic reconnection logic with configurable settings
@@ -26,7 +78,7 @@ class AutoReconnectManager {
      */
     async enable(options) {
         if (this.enabled) {
-            console.warn('Auto-reconnect is already enabled');
+            logWarn('Auto-reconnect is already enabled');
             return;
         }
         this.enabled = true;
@@ -35,7 +87,7 @@ class AutoReconnectManager {
         this.currentAttempts = 0;
         this.callback = options.onReconnect;
         this.reconnectFunction = options.reconnectFunction;
-        console.log(`Auto-reconnect enabled: interval=${this.interval}ms, maxAttempts=${this.maxAttempts === null ? 'infinite' : this.maxAttempts}`);
+        logInfo(`Auto-reconnect enabled: interval=${this.interval}ms, maxAttempts=${this.maxAttempts === null ? 'infinite' : this.maxAttempts}`);
     }
     /**
      * @description Disables auto-reconnect functionality
@@ -43,7 +95,7 @@ class AutoReconnectManager {
      */
     async disable() {
         if (!this.enabled) {
-            console.warn('Auto-reconnect is not enabled');
+            logWarn('Auto-reconnect is not enabled');
             return;
         }
         this.enabled = false;
@@ -55,7 +107,7 @@ class AutoReconnectManager {
             clearTimeout(this.timer);
             this.timer = null;
         }
-        console.log('Auto-reconnect disabled');
+        logInfo('Auto-reconnect disabled');
     }
     /**
      * @description Gets auto-reconnect status and configuration
@@ -108,18 +160,18 @@ class AutoReconnectManager {
         }
         // Проверяем лимит ДО увеличения счётчика
         if (this.maxAttempts !== null && this.currentAttempts >= this.maxAttempts) {
-            console.error(`Auto-reconnect failed after ${this.maxAttempts} attempts`);
+            logError(`Auto-reconnect failed after ${this.maxAttempts} attempts`);
             if (this.callback) {
                 this.callback(false, this.currentAttempts);
             }
             return;
         }
         this.currentAttempts++;
-        console.log(`Auto-reconnect attempt ${this.currentAttempts}${this.maxAttempts !== null ? `/${this.maxAttempts}` : ''}`);
+        logInfo(`Auto-reconnect attempt ${this.currentAttempts}${this.maxAttempts !== null ? `/${this.maxAttempts}` : ''}`);
         try {
             const success = await this.reconnectFunction();
             if (success) {
-                console.log('Auto-reconnect successful');
+                logInfo('Auto-reconnect successful');
                 this.currentAttempts = 0; // Reset counter on success
                 if (this.callback) {
                     this.callback(true, this.currentAttempts);
@@ -130,7 +182,7 @@ class AutoReconnectManager {
             }
         }
         catch (error) {
-            console.error(`Auto-reconnect attempt ${this.currentAttempts} failed:`, error);
+            logError(`Auto-reconnect attempt ${this.currentAttempts} failed:`, error);
             if (this.callback) {
                 this.callback(false, this.currentAttempts);
             }
@@ -175,7 +227,7 @@ class ListenerManager {
                 }
             }
             catch (error) {
-                console.warn(`Error in unlisten function for ${id}:`, error);
+                logWarn(`Error in unlisten function for ${id}:`, error);
             }
         };
     }
@@ -189,7 +241,7 @@ class ListenerManager {
                 }
             }
             catch (error) {
-                console.warn(`Error in unlisten function for ${id}:`, error);
+                logWarn(`Error in unlisten function for ${id}:`, error);
             }
         };
     }
@@ -327,19 +379,33 @@ class SerialPort {
         return await core.invoke('plugin:serialplugin|close_all');
     }
     /**
-     * @description Gets the full serial number for a specific port
-     * On Windows, this can fix truncated serial numbers (e.g., "B4" → "B4:3D:4D:B1:5A:C8" for ESP32 devices)
-     * @param {string} path The port path (e.g., "COM3", "/dev/ttyUSB0")
-     * @returns {Promise<string>} A promise that resolves to the full serial number, or "Unknown" if not found
+     * @description Sets the global log level for the plugin
+     * @param {LogLevel} level The log level to set (None, Error, Warn, Info, Debug)
+     * @returns {Promise<void>} A promise that resolves when the log level is set
+     * @example
+     * // Disable all logs in production
+     * await SerialPort.setLogLevel(LogLevel.None);
+     *
+     * // Show only errors
+     * await SerialPort.setLogLevel(LogLevel.Error);
+     *
+     * // Enable all logs for debugging
+     * await SerialPort.setLogLevel(LogLevel.Debug);
      */
-    static async get_full_serial_number(path) {
-        try {
-            const result = await core.invoke('plugin:serialplugin|get_full_serial_number', { path });
-            return Promise.resolve(result);
-        }
-        catch (error) {
-            return Promise.reject(error);
-        }
+    static async setLogLevel(level) {
+        // Sync log level with internal logger
+        setLogLevel(level);
+        return await core.invoke('plugin:serialplugin|set_log_level', { level });
+    }
+    /**
+     * @description Gets the current global log level
+     * @returns {Promise<LogLevel>} A promise that resolves to the current log level
+     * @example
+     * const currentLevel = await SerialPort.getLogLevel();
+     * console.log("Current log level:", currentLevel);
+     */
+    static async getLogLevel() {
+        return await core.invoke('plugin:serialplugin|get_log_level');
     }
     /**
      * @description Cancels listening for serial port data (does not affect disconnect listeners)
@@ -356,7 +422,7 @@ class SerialPort {
                     }
                 }
                 catch (error) {
-                    console.warn(`Error unlistening data listener ${id}:`, error);
+                    logWarn(`Error unlistening data listener ${id}:`, error);
                 }
                 // Remove from map regardless of success/failure
                 this.listeners.delete(id);
@@ -381,7 +447,7 @@ class SerialPort {
                     }
                 }
                 catch (error) {
-                    console.warn(`Error unlistening listener ${id}:`, error);
+                    logWarn(`Error unlistening listener ${id}:`, error);
                 }
                 // Remove from map regardless of success/failure
                 this.listeners.delete(id);
@@ -461,7 +527,7 @@ class SerialPort {
                 await this.cancelRead();
             }
             catch (cancelReadError) {
-                console.warn('Error during cancelRead:', cancelReadError);
+                logWarn('Error during cancelRead:', cancelReadError);
             }
             // Closing the port
             let res = undefined;
@@ -471,20 +537,20 @@ class SerialPort {
                 });
             }
             catch (closeError) {
-                console.warn('Error during port close:', closeError);
+                logWarn('Error during port close:', closeError);
             }
             // Cancel all listeners
             try {
                 await this.cancelAllListeners();
             }
             catch (cancelListenError) {
-                console.warn('Error during cancelAllListeners:', cancelListenError);
+                logWarn('Error during cancelAllListeners:', cancelListenError);
                 // Try to clear listeners manually as fallback
                 try {
                     this.listeners.clear();
                 }
                 catch (clearError) {
-                    console.warn('Error during manual listener clear:', clearError);
+                    logWarn('Error during manual listener clear:', clearError);
                 }
             }
             this.isOpen = false;
@@ -502,20 +568,20 @@ class SerialPort {
     async disconnected(fn) {
         let sub_path = this.options.path?.toString().replaceAll(".", "-").replaceAll("/", "-");
         let checkEvent = `plugin-serialplugin-disconnected-${sub_path}`;
-        console.log('listen event: ' + checkEvent);
+        logDebug('listen event: ' + checkEvent);
         const unListenResult = await event.listen(checkEvent, () => {
             try {
                 fn();
             }
             catch (error) {
-                console.error(error);
+                logError(error);
             }
         });
         if (typeof unListenResult === 'function') {
             this.listeners.add('disconnect', unListenResult);
         }
         else {
-            console.warn('disconnected() did not return a valid unlisten function');
+            logWarn('disconnected() did not return a valid unlisten function');
         }
     }
     /**
@@ -587,16 +653,16 @@ class SerialPort {
     async manualReconnect() {
         try {
             if (this.isOpen) {
-                console.log('Port is already open, no need to reconnect');
+                logInfo('Port is already open, no need to reconnect');
                 return true;
             }
-            console.log('Manual reconnection attempt...');
+            logInfo('Manual reconnection attempt...');
             await this.open();
-            console.log('Manual reconnection successful');
+            logInfo('Manual reconnection successful');
             return true;
         }
         catch (error) {
-            console.error('Manual reconnection failed:', error);
+            logError('Manual reconnection failed:', error);
             return false;
         }
     }
@@ -613,7 +679,7 @@ class SerialPort {
             }
             let sub_path = this.options.path?.toString().replaceAll(".", "-").replaceAll("/", "-");
             let readEvent = `plugin-serialplugin-read-${sub_path}`;
-            console.log('listen event: ' + readEvent);
+            logDebug('listen event: ' + readEvent);
             try {
                 const unListenResult = await event.listen(readEvent, ({ payload }) => {
                     try {
@@ -625,14 +691,14 @@ class SerialPort {
                                 fn(textData);
                             }
                             catch (error) {
-                                console.error('Error converting to text with configured encoding:', error);
+                                logError('Error converting to text with configured encoding:', error);
                                 try {
                                     const fallbackDecoder = new TextDecoder('utf-8');
                                     const textData = fallbackDecoder.decode(uint8Array);
                                     fn(textData);
                                 }
                                 catch (fallbackError) {
-                                    console.error('Fallback decoding also failed:', fallbackError);
+                                    logError('Fallback decoding also failed:', fallbackError);
                                     fn(String.fromCharCode(...uint8Array));
                                 }
                             }
@@ -642,19 +708,19 @@ class SerialPort {
                         }
                     }
                     catch (error) {
-                        console.error(error);
+                        logError(error);
                     }
                 });
                 if (typeof unListenResult === 'function') {
                     return this.listeners.add('data', unListenResult);
                 }
                 else {
-                    console.warn('listen() did not return a valid unlisten function');
+                    logWarn('listen() did not return a valid unlisten function');
                     return Promise.reject('Failed to get unlisten function');
                 }
             }
             catch (listenError) {
-                console.error('Error setting up listener:', listenError);
+                logError('Error setting up listener:', listenError);
                 throw listenError;
             }
         }
@@ -689,7 +755,7 @@ class SerialPort {
             this.isOpen = true;
             this.disconnected(() => {
                 this.isOpen = false;
-            }).catch(err => console.error(err));
+            }).catch(err => logError(err));
             return Promise.resolve(res);
         }
         catch (error) {

package/dist-js/index.d.ts

@@ -1,4 +1,5 @@
 import { UnlistenFn } from '@tauri-apps/api/event';
+import { type LogLevel } from './logger';
 export interface PortInfo {
     path: "Unknown" | string;
     manufacturer: "Unknown" | string;
@@ -115,12 +116,28 @@ declare class SerialPort {
      */
     static closeAll(): Promise<void>;
     /**
-     * @description Gets the full serial number for a specific port
-     * On Windows, this can fix truncated serial numbers (e.g., "B4" → "B4:3D:4D:B1:5A:C8" for ESP32 devices)
-     * @param {string} path The port path (e.g., "COM3", "/dev/ttyUSB0")
-     * @returns {Promise<string>} A promise that resolves to the full serial number, or "Unknown" if not found
+     * @description Sets the global log level for the plugin
+     * @param {LogLevel} level The log level to set (None, Error, Warn, Info, Debug)
+     * @returns {Promise<void>} A promise that resolves when the log level is set
+     * @example
+     * // Disable all logs in production
+     * await SerialPort.setLogLevel(LogLevel.None);
+     *
+     * // Show only errors
+     * await SerialPort.setLogLevel(LogLevel.Error);
+     *
+     * // Enable all logs for debugging
+     * await SerialPort.setLogLevel(LogLevel.Debug);
+     */
+    static setLogLevel(level: LogLevel): Promise<void>;
+    /**
+     * @description Gets the current global log level
+     * @returns {Promise<LogLevel>} A promise that resolves to the current log level
+     * @example
+     * const currentLevel = await SerialPort.getLogLevel();
+     * console.log("Current log level:", currentLevel);
      */
-    static get_full_serial_number(path: string): Promise<string>;
+    static getLogLevel(): Promise<LogLevel>;
     /**
      * @description Cancels listening for serial port data (does not affect disconnect listeners)
      * @returns {Promise<void>} A promise that resolves when listening is cancelled
@@ -370,3 +387,4 @@ declare class SerialPort {
     writeBinary(value: Uint8Array | number[]): Promise<number>;
 }
 export { SerialPort };
+export type { LogLevel };

package/dist-js/index.js

@@ -1,6 +1,58 @@
 import { invoke } from '@tauri-apps/api/core';
 import { listen } from '@tauri-apps/api/event';
 
+// Centralized logger for the serial plugin
+// Avoids circular dependencies and code duplication
+// Global log level state
+let currentLogLevel = "Info";
+/**
+ * Sets the global log level
+ */
+function setLogLevel(level) {
+    currentLogLevel = level;
+}
+/**
+ * Checks if a message should be logged based on current log level
+ */
+function shouldLog(level) {
+    const levels = ["None", "Error", "Warn", "Info", "Debug"];
+    const currentIndex = levels.indexOf(currentLogLevel);
+    const requestedIndex = levels.indexOf(level);
+    return requestedIndex <= currentIndex && currentIndex > 0;
+}
+/**
+ * Logs an error message
+ */
+function logError(...args) {
+    if (shouldLog("Error")) {
+        console.error(...args);
+    }
+}
+/**
+ * Logs a warning message
+ */
+function logWarn(...args) {
+    if (shouldLog("Warn")) {
+        console.warn(...args);
+    }
+}
+/**
+ * Logs an info message
+ */
+function logInfo(...args) {
+    if (shouldLog("Info")) {
+        console.log(...args);
+    }
+}
+/**
+ * Logs a debug message
+ */
+function logDebug(...args) {
+    if (shouldLog("Debug")) {
+        console.log(...args);
+    }
+}
+
 /**
  * Auto-reconnect manager for serial ports
  * Handles automatic reconnection logic with configurable settings
@@ -24,7 +76,7 @@ class AutoReconnectManager {
      */
     async enable(options) {
         if (this.enabled) {
-            console.warn('Auto-reconnect is already enabled');
+            logWarn('Auto-reconnect is already enabled');
             return;
         }
         this.enabled = true;
@@ -33,7 +85,7 @@ class AutoReconnectManager {
         this.currentAttempts = 0;
         this.callback = options.onReconnect;
         this.reconnectFunction = options.reconnectFunction;
-        console.log(`Auto-reconnect enabled: interval=${this.interval}ms, maxAttempts=${this.maxAttempts === null ? 'infinite' : this.maxAttempts}`);
+        logInfo(`Auto-reconnect enabled: interval=${this.interval}ms, maxAttempts=${this.maxAttempts === null ? 'infinite' : this.maxAttempts}`);
     }
     /**
      * @description Disables auto-reconnect functionality
@@ -41,7 +93,7 @@ class AutoReconnectManager {
      */
     async disable() {
         if (!this.enabled) {
-            console.warn('Auto-reconnect is not enabled');
+            logWarn('Auto-reconnect is not enabled');
             return;
         }
         this.enabled = false;
@@ -53,7 +105,7 @@ class AutoReconnectManager {
             clearTimeout(this.timer);
             this.timer = null;
         }
-        console.log('Auto-reconnect disabled');
+        logInfo('Auto-reconnect disabled');
     }
     /**
      * @description Gets auto-reconnect status and configuration
@@ -106,18 +158,18 @@ class AutoReconnectManager {
         }
         // Проверяем лимит ДО увеличения счётчика
         if (this.maxAttempts !== null && this.currentAttempts >= this.maxAttempts) {
-            console.error(`Auto-reconnect failed after ${this.maxAttempts} attempts`);
+            logError(`Auto-reconnect failed after ${this.maxAttempts} attempts`);
             if (this.callback) {
                 this.callback(false, this.currentAttempts);
             }
             return;
         }
         this.currentAttempts++;
-        console.log(`Auto-reconnect attempt ${this.currentAttempts}${this.maxAttempts !== null ? `/${this.maxAttempts}` : ''}`);
+        logInfo(`Auto-reconnect attempt ${this.currentAttempts}${this.maxAttempts !== null ? `/${this.maxAttempts}` : ''}`);
         try {
             const success = await this.reconnectFunction();
             if (success) {
-                console.log('Auto-reconnect successful');
+                logInfo('Auto-reconnect successful');
                 this.currentAttempts = 0; // Reset counter on success
                 if (this.callback) {
                     this.callback(true, this.currentAttempts);
@@ -128,7 +180,7 @@ class AutoReconnectManager {
             }
         }
         catch (error) {
-            console.error(`Auto-reconnect attempt ${this.currentAttempts} failed:`, error);
+            logError(`Auto-reconnect attempt ${this.currentAttempts} failed:`, error);
             if (this.callback) {
                 this.callback(false, this.currentAttempts);
             }
@@ -173,7 +225,7 @@ class ListenerManager {
                 }
             }
             catch (error) {
-                console.warn(`Error in unlisten function for ${id}:`, error);
+                logWarn(`Error in unlisten function for ${id}:`, error);
             }
         };
     }
@@ -187,7 +239,7 @@ class ListenerManager {
                 }
             }
             catch (error) {
-                console.warn(`Error in unlisten function for ${id}:`, error);
+                logWarn(`Error in unlisten function for ${id}:`, error);
             }
         };
     }
@@ -325,19 +377,33 @@ class SerialPort {
         return await invoke('plugin:serialplugin|close_all');
     }
     /**
-     * @description Gets the full serial number for a specific port
-     * On Windows, this can fix truncated serial numbers (e.g., "B4" → "B4:3D:4D:B1:5A:C8" for ESP32 devices)
-     * @param {string} path The port path (e.g., "COM3", "/dev/ttyUSB0")
-     * @returns {Promise<string>} A promise that resolves to the full serial number, or "Unknown" if not found
+     * @description Sets the global log level for the plugin
+     * @param {LogLevel} level The log level to set (None, Error, Warn, Info, Debug)
+     * @returns {Promise<void>} A promise that resolves when the log level is set
+     * @example
+     * // Disable all logs in production
+     * await SerialPort.setLogLevel(LogLevel.None);
+     *
+     * // Show only errors
+     * await SerialPort.setLogLevel(LogLevel.Error);
+     *
+     * // Enable all logs for debugging
+     * await SerialPort.setLogLevel(LogLevel.Debug);
      */
-    static async get_full_serial_number(path) {
-        try {
-            const result = await invoke('plugin:serialplugin|get_full_serial_number', { path });
-            return Promise.resolve(result);
-        }
-        catch (error) {
-            return Promise.reject(error);
-        }
+    static async setLogLevel(level) {
+        // Sync log level with internal logger
+        setLogLevel(level);
+        return await invoke('plugin:serialplugin|set_log_level', { level });
+    }
+    /**
+     * @description Gets the current global log level
+     * @returns {Promise<LogLevel>} A promise that resolves to the current log level
+     * @example
+     * const currentLevel = await SerialPort.getLogLevel();
+     * console.log("Current log level:", currentLevel);
+     */
+    static async getLogLevel() {
+        return await invoke('plugin:serialplugin|get_log_level');
     }
     /**
      * @description Cancels listening for serial port data (does not affect disconnect listeners)
@@ -354,7 +420,7 @@ class SerialPort {
                     }
                 }
                 catch (error) {
-                    console.warn(`Error unlistening data listener ${id}:`, error);
+                    logWarn(`Error unlistening data listener ${id}:`, error);
                 }
                 // Remove from map regardless of success/failure
                 this.listeners.delete(id);
@@ -379,7 +445,7 @@ class SerialPort {
                     }
                 }
                 catch (error) {
-                    console.warn(`Error unlistening listener ${id}:`, error);
+                    logWarn(`Error unlistening listener ${id}:`, error);
                 }
                 // Remove from map regardless of success/failure
                 this.listeners.delete(id);
@@ -459,7 +525,7 @@ class SerialPort {
                 await this.cancelRead();
             }
             catch (cancelReadError) {
-                console.warn('Error during cancelRead:', cancelReadError);
+                logWarn('Error during cancelRead:', cancelReadError);
             }
             // Closing the port
             let res = undefined;
@@ -469,20 +535,20 @@ class SerialPort {
                 });
             }
             catch (closeError) {
-                console.warn('Error during port close:', closeError);
+                logWarn('Error during port close:', closeError);
             }
             // Cancel all listeners
             try {
                 await this.cancelAllListeners();
             }
             catch (cancelListenError) {
-                console.warn('Error during cancelAllListeners:', cancelListenError);
+                logWarn('Error during cancelAllListeners:', cancelListenError);
                 // Try to clear listeners manually as fallback
                 try {
                     this.listeners.clear();
                 }
                 catch (clearError) {
-                    console.warn('Error during manual listener clear:', clearError);
+                    logWarn('Error during manual listener clear:', clearError);
                 }
             }
             this.isOpen = false;
@@ -500,20 +566,20 @@ class SerialPort {
     async disconnected(fn) {
         let sub_path = this.options.path?.toString().replaceAll(".", "-").replaceAll("/", "-");
         let checkEvent = `plugin-serialplugin-disconnected-${sub_path}`;
-        console.log('listen event: ' + checkEvent);
+        logDebug('listen event: ' + checkEvent);
         const unListenResult = await listen(checkEvent, () => {
             try {
                 fn();
             }
             catch (error) {
-                console.error(error);
+                logError(error);
             }
         });
         if (typeof unListenResult === 'function') {
             this.listeners.add('disconnect', unListenResult);
         }
         else {
-            console.warn('disconnected() did not return a valid unlisten function');
+            logWarn('disconnected() did not return a valid unlisten function');
         }
     }
     /**
@@ -585,16 +651,16 @@ class SerialPort {
     async manualReconnect() {
         try {
             if (this.isOpen) {
-                console.log('Port is already open, no need to reconnect');
+                logInfo('Port is already open, no need to reconnect');
                 return true;
             }
-            console.log('Manual reconnection attempt...');
+            logInfo('Manual reconnection attempt...');
             await this.open();
-            console.log('Manual reconnection successful');
+            logInfo('Manual reconnection successful');
             return true;
         }
         catch (error) {
-            console.error('Manual reconnection failed:', error);
+            logError('Manual reconnection failed:', error);
             return false;
         }
     }
@@ -611,7 +677,7 @@ class SerialPort {
             }
             let sub_path = this.options.path?.toString().replaceAll(".", "-").replaceAll("/", "-");
             let readEvent = `plugin-serialplugin-read-${sub_path}`;
-            console.log('listen event: ' + readEvent);
+            logDebug('listen event: ' + readEvent);
             try {
                 const unListenResult = await listen(readEvent, ({ payload }) => {
                     try {
@@ -623,14 +689,14 @@ class SerialPort {
                                 fn(textData);
                             }
                             catch (error) {
-                                console.error('Error converting to text with configured encoding:', error);
+                                logError('Error converting to text with configured encoding:', error);
                                 try {
                                     const fallbackDecoder = new TextDecoder('utf-8');
                                     const textData = fallbackDecoder.decode(uint8Array);
                                     fn(textData);
                                 }
                                 catch (fallbackError) {
-                                    console.error('Fallback decoding also failed:', fallbackError);
+                                    logError('Fallback decoding also failed:', fallbackError);
                                     fn(String.fromCharCode(...uint8Array));
                                 }
                             }
@@ -640,19 +706,19 @@ class SerialPort {
                         }
                     }
                     catch (error) {
-                        console.error(error);
+                        logError(error);
                     }
                 });
                 if (typeof unListenResult === 'function') {
                     return this.listeners.add('data', unListenResult);
                 }
                 else {
-                    console.warn('listen() did not return a valid unlisten function');
+                    logWarn('listen() did not return a valid unlisten function');
                     return Promise.reject('Failed to get unlisten function');
                 }
             }
             catch (listenError) {
-                console.error('Error setting up listener:', listenError);
+                logError('Error setting up listener:', listenError);
                 throw listenError;
             }
         }
@@ -687,7 +753,7 @@ class SerialPort {
             this.isOpen = true;
             this.disconnected(() => {
                 this.isOpen = false;
-            }).catch(err => console.error(err));
+            }).catch(err => logError(err));
             return Promise.resolve(res);
         }
         catch (error) {

package/dist-js/logger.d.ts

@@ -0,0 +1,25 @@
+export type LogLevel = "None" | "Error" | "Warn" | "Info" | "Debug";
+/**
+ * Sets the global log level
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Gets the current log level
+ */
+export declare function getLogLevel(): LogLevel;
+/**
+ * Logs an error message
+ */
+export declare function logError(...args: any[]): void;
+/**
+ * Logs a warning message
+ */
+export declare function logWarn(...args: any[]): void;
+/**
+ * Logs an info message
+ */
+export declare function logInfo(...args: any[]): void;
+/**
+ * Logs a debug message
+ */
+export declare function logDebug(...args: any[]): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tauri-plugin-serialplugin-api",
-  "version": "2.18.0",
+  "version": "2.20.0",
   "license": "MIT or APACHE-2.0",
   "type": "module",
   "types": "./dist-js/index.d.ts",