tsvesync 1.0.17 → 1.0.18

package/dist/lib/logger.d.ts

@@ -1,5 +1,5 @@
 /**
- * Logger utility for TSVeSync
+ * Logger module for VeSync library
  */
 export declare enum LogLevel {
     DEBUG = 0,
@@ -8,16 +8,35 @@ export declare enum LogLevel {
     ERROR = 3,
     NONE = 4
 }
-export declare class Logger {
-    private static instance;
-    private currentLevel;
-    private constructor();
-    static getInstance(): Logger;
-    setLevel(level: LogLevel): void;
-    getLevel(): LogLevel;
-    debug(message: string, ...args: any[]): void;
-    info(message: string, ...args: any[]): void;
-    warn(message: string, ...args: any[]): void;
-    error(message: string, ...args: any[]): void;
+export interface Logger {
+    debug: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+    setLevel?: (level: LogLevel) => void;
+    getLevel?: () => LogLevel | undefined;
 }
+/**
+ * Set a custom logger implementation
+ * @param customLogger - Custom logger implementation
+ */
+export declare function setLogger(customLogger: Logger): void;
+/**
+ * Reset to default logger
+ */
+export declare function resetLogger(): void;
+/**
+ * Get the current logger instance
+ */
+export declare function getLogger(): Logger;
+/**
+ * Set the log level (only works with default logger)
+ * @param level - The log level to set
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Get the current log level (only works with default logger)
+ * @returns The current log level or undefined if using custom logger
+ */
+export declare function getLogLevel(): LogLevel | undefined;
 export declare const logger: Logger;

package/dist/lib/logger.js

@@ -1,9 +1,14 @@
 "use strict";
 /**
- * Logger utility for TSVeSync
+ * Logger module for VeSync library
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.logger = exports.Logger = exports.LogLevel = void 0;
+exports.logger = exports.LogLevel = void 0;
+exports.setLogger = setLogger;
+exports.resetLogger = resetLogger;
+exports.getLogger = getLogger;
+exports.setLogLevel = setLogLevel;
+exports.getLogLevel = getLogLevel;
 var LogLevel;
 (function (LogLevel) {
     LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
@@ -12,16 +17,10 @@ var LogLevel;
     LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
     LogLevel[LogLevel["NONE"] = 4] = "NONE";
 })(LogLevel || (exports.LogLevel = LogLevel = {}));
-class Logger {
+class DefaultLogger {
     constructor() {
         this.currentLevel = LogLevel.INFO;
     }
-    static getInstance() {
-        if (!Logger.instance) {
-            Logger.instance = new Logger();
-        }
-        return Logger.instance;
-    }
     setLevel(level) {
         this.currentLevel = level;
     }
@@ -30,12 +29,12 @@ class Logger {
     }
     debug(message, ...args) {
         if (this.currentLevel <= LogLevel.DEBUG) {
-            console.log(`[DEBUG] ${message}`, ...args);
+            console.debug(`[DEBUG] ${message}`, ...args);
         }
     }
     info(message, ...args) {
         if (this.currentLevel <= LogLevel.INFO) {
-            console.log(`[INFO] ${message}`, ...args);
+            console.info(`[INFO] ${message}`, ...args);
         }
     }
     warn(message, ...args) {
@@ -49,6 +48,54 @@ class Logger {
         }
     }
 }
-exports.Logger = Logger;
-// Export singleton instance
-exports.logger = Logger.getInstance();
+// Default logger implementation
+const defaultLogger = new DefaultLogger();
+// Current logger instance
+let currentLogger = defaultLogger;
+/**
+ * Set a custom logger implementation
+ * @param customLogger - Custom logger implementation
+ */
+function setLogger(customLogger) {
+    currentLogger = customLogger;
+}
+/**
+ * Reset to default logger
+ */
+function resetLogger() {
+    currentLogger = defaultLogger;
+}
+/**
+ * Get the current logger instance
+ */
+function getLogger() {
+    return currentLogger;
+}
+/**
+ * Set the log level (only works with default logger)
+ * @param level - The log level to set
+ */
+function setLogLevel(level) {
+    if (currentLogger === defaultLogger) {
+        currentLogger.setLevel(level);
+    }
+}
+/**
+ * Get the current log level (only works with default logger)
+ * @returns The current log level or undefined if using custom logger
+ */
+function getLogLevel() {
+    if (currentLogger === defaultLogger) {
+        return currentLogger.getLevel();
+    }
+    return undefined;
+}
+// Export the logger interface for use throughout the application
+exports.logger = {
+    debug: (message, ...args) => currentLogger.debug(message, ...args),
+    info: (message, ...args) => currentLogger.info(message, ...args),
+    warn: (message, ...args) => currentLogger.warn(message, ...args),
+    error: (message, ...args) => currentLogger.error(message, ...args),
+    setLevel: (level) => setLogLevel(level),
+    getLevel: () => getLogLevel()
+};

package/dist/lib/vesync.d.ts

@@ -2,6 +2,7 @@
  * VeSync API Device Library
  */
 import { VeSyncBaseDevice } from './vesyncBaseDevice';
+import { Logger } from './logger';
 /**
  * VeSync Manager Class
  */
@@ -29,8 +30,15 @@ export declare class VeSync {
     scales: VeSyncBaseDevice[];
     /**
      * Initialize VeSync Manager
+     * @param username - VeSync account username
+     * @param password - VeSync account password
+     * @param timeZone - Optional timezone (defaults to America/New_York)
+     * @param debug - Optional debug mode flag
+     * @param redact - Optional redact mode flag
+     * @param apiUrl - Optional API base URL override
+     * @param customLogger - Optional custom logger implementation
      */
-    constructor(username: string, password: string, timeZone?: string, debug?: boolean, redact?: boolean);
+    constructor(username: string, password: string, timeZone?: string, debug?: boolean, redact?: boolean, apiUrl?: string, customLogger?: Logger);
     /**
      * Get/Set debug mode
      */

package/dist/lib/vesync.js

@@ -103,8 +103,15 @@ function objectFactory(details, manager) {
 class VeSync {
     /**
      * Initialize VeSync Manager
+     * @param username - VeSync account username
+     * @param password - VeSync account password
+     * @param timeZone - Optional timezone (defaults to America/New_York)
+     * @param debug - Optional debug mode flag
+     * @param redact - Optional redact mode flag
+     * @param apiUrl - Optional API base URL override
+     * @param customLogger - Optional custom logger implementation
      */
-    constructor(username, password, timeZone = helpers_1.DEFAULT_TZ, debug = false, redact = true) {
+    constructor(username, password, timeZone = helpers_1.DEFAULT_TZ, debug = false, redact = true, apiUrl, customLogger) {
         this._debug = debug;
         this._redact = redact;
         this._energyUpdateInterval = DEFAULT_ENERGY_UPDATE_INTERVAL;
@@ -130,6 +137,14 @@ class VeSync {
             switches: this.switches,
             bulbs: this.bulbs
         };
+        // Set custom API URL if provided
+        if (apiUrl) {
+            (0, helpers_1.setApiBaseUrl)(apiUrl);
+        }
+        // Set custom logger if provided
+        if (customLogger) {
+            (0, logger_1.setLogger)(customLogger);
+        }
         if (typeof timeZone === 'string' && timeZone) {
             const regTest = /[^a-zA-Z/_]/;
             if (regTest.test(timeZone)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsvesync",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "A TypeScript library for interacting with VeSync smart home devices",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/lib/logger.ts

@@ -1,5 +1,5 @@
 /**
- * Logger utility for TSVeSync
+ * Logger module for VeSync library
  */
 
 export enum LogLevel {
@@ -10,36 +10,35 @@ export enum LogLevel {
     NONE = 4
 }
 
-export class Logger {
-    private static instance: Logger;
-    private currentLevel: LogLevel = LogLevel.INFO;
-
-    private constructor() {}
+export interface Logger {
+    debug: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+    setLevel?: (level: LogLevel) => void;
+    getLevel?: () => LogLevel | undefined;
+}
 
-    static getInstance(): Logger {
-        if (!Logger.instance) {
-            Logger.instance = new Logger();
-        }
-        return Logger.instance;
-    }
+class DefaultLogger implements Logger {
+    private currentLevel: LogLevel = LogLevel.INFO;
 
     setLevel(level: LogLevel): void {
         this.currentLevel = level;
     }
 
-    getLevel(): LogLevel {
+    getLevel(): LogLevel | undefined {
         return this.currentLevel;
     }
 
     debug(message: string, ...args: any[]): void {
         if (this.currentLevel <= LogLevel.DEBUG) {
-            console.log(`[DEBUG] ${message}`, ...args);
+            console.debug(`[DEBUG] ${message}`, ...args);
         }
     }
 
     info(message: string, ...args: any[]): void {
         if (this.currentLevel <= LogLevel.INFO) {
-            console.log(`[INFO] ${message}`, ...args);
+            console.info(`[INFO] ${message}`, ...args);
         }
     }
 
@@ -56,5 +55,61 @@ export class Logger {
     }
 }
 
-// Export singleton instance
-export const logger = Logger.getInstance(); 
+// Default logger implementation
+const defaultLogger: Logger = new DefaultLogger();
+
+// Current logger instance
+let currentLogger: Logger = defaultLogger;
+
+/**
+ * Set a custom logger implementation
+ * @param customLogger - Custom logger implementation
+ */
+export function setLogger(customLogger: Logger): void {
+    currentLogger = customLogger;
+}
+
+/**
+ * Reset to default logger
+ */
+export function resetLogger(): void {
+    currentLogger = defaultLogger;
+}
+
+/**
+ * Get the current logger instance
+ */
+export function getLogger(): Logger {
+    return currentLogger;
+}
+
+/**
+ * Set the log level (only works with default logger)
+ * @param level - The log level to set
+ */
+export function setLogLevel(level: LogLevel): void {
+    if (currentLogger === defaultLogger) {
+        (currentLogger as DefaultLogger).setLevel(level);
+    }
+}
+
+/**
+ * Get the current log level (only works with default logger)
+ * @returns The current log level or undefined if using custom logger
+ */
+export function getLogLevel(): LogLevel | undefined {
+    if (currentLogger === defaultLogger) {
+        return (currentLogger as DefaultLogger).getLevel();
+    }
+    return undefined;
+}
+
+// Export the logger interface for use throughout the application
+export const logger: Logger = {
+    debug: (message: string, ...args: any[]) => currentLogger.debug(message, ...args),
+    info: (message: string, ...args: any[]) => currentLogger.info(message, ...args),
+    warn: (message: string, ...args: any[]) => currentLogger.warn(message, ...args),
+    error: (message: string, ...args: any[]) => currentLogger.error(message, ...args),
+    setLevel: (level: LogLevel) => setLogLevel(level),
+    getLevel: () => getLogLevel()
+}; 

package/src/lib/vesync.ts

@@ -2,14 +2,14 @@
  * VeSync API Device Library
  */
 
-import { Helpers, API_RATE_LIMIT, DEFAULT_TZ } from './helpers';
+import { Helpers, API_RATE_LIMIT, DEFAULT_TZ, setApiBaseUrl } from './helpers';
 import { VeSyncBaseDevice } from './vesyncBaseDevice';
 import { fanModules } from './vesyncFanImpl';
 import { outletModules } from './vesyncOutletImpl';
 import { switchModules } from './vesyncSwitchImpl';
 import { bulbModules } from './vesyncBulbImpl';
 import { VeSyncBulb } from './vesyncBulb';
-import { logger } from './logger';
+import { logger, setLogger, Logger } from './logger';
 
 const DEFAULT_ENERGY_UPDATE_INTERVAL = 21600;
 
@@ -145,13 +145,22 @@ export class VeSync {
 
     /**
      * Initialize VeSync Manager
+     * @param username - VeSync account username
+     * @param password - VeSync account password
+     * @param timeZone - Optional timezone (defaults to America/New_York)
+     * @param debug - Optional debug mode flag
+     * @param redact - Optional redact mode flag
+     * @param apiUrl - Optional API base URL override
+     * @param customLogger - Optional custom logger implementation
      */
     constructor(
         username: string,
         password: string,
         timeZone: string = DEFAULT_TZ,
         debug = false,
-        redact = true
+        redact = true,
+        apiUrl?: string,
+        customLogger?: Logger
     ) {
         this._debug = debug;
         this._redact = redact;
@@ -182,6 +191,16 @@ export class VeSync {
             bulbs: this.bulbs
         };
 
+        // Set custom API URL if provided
+        if (apiUrl) {
+            setApiBaseUrl(apiUrl);
+        }
+
+        // Set custom logger if provided
+        if (customLogger) {
+            setLogger(customLogger);
+        }
+
         if (typeof timeZone === 'string' && timeZone) {
             const regTest = /[^a-zA-Z/_]/;
             if (regTest.test(timeZone)) {