@switchbot/homebridge-switchbot 5.0.0-beta.3 → 5.0.0-beta.31

package/dist/test/matter/platform-matter.unregister.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-matter.unregister.test.js","sourceRoot":"","sources":["../../../src/test/matter/platform-matter.unregister.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAE1E,QAAQ,CAAC,qDAAqD,EAAE,GAAG,EAAE;IACnE,EAAE,CAAC,yFAAyF,EAAE,KAAK,IAAI,EAAE;QACvG,mBAAmB;QACnB,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QAC1B,MAAM,GAAG,GAAQ,WAAW,CAAC,EAAE,6BAA6B,EAAE,UAAU,EAAE,CAAC,CAAA;QAC3E,MAAM,GAAG,GAAQ,WAAW,EAAE,CAAA;QAC9B,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAAC,GAAU,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAS,EAAE,GAAG,CAAC,CAAA;QAEjG,gFAAgF;QAChF,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAA;QAC3D,MAAM,SAAS,GAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAA;QAE/F,wEAAwE;QACxE,MAAM,GAAG,GAAI,QAAgB,CAAC,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAC1E;QAAC,QAAgB,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,IAAW,CAAC,CACrD;QAAC,QAAgB,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAG9D;QAAC,QAAgB,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QAEzD,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,QAAe,EAAE,sBAAsB,CAAC,CAAA;QAElE,0CAA0C;QAC1C,MAAO,QAAgB,CAAC,yBAAyB,EAAE,CAAA;QAEnD,6DAA6D;QAC7D,MAAM,CAAC,UAAU,CAAC,CAAC,gBAAgB,EAAE,CAAA;QACrC,MAAM,CAAE,QAAgB,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;QAErE,2EAA2E;QAC3E,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACnE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/utils.d.ts

@@ -1,3 +1,4 @@
+import type { API, Logging } from 'homebridge';
 import type { blindTilt, curtain, curtain3, device } from 'node-switchbot';
 import type { devicesConfig } from './settings.js';
 export declare enum BlindTiltMappingMode {
@@ -48,4 +49,130 @@ export declare function m2hs(m: any): number[];
  * Returns undefined if nothing meaningful remains.
  */
 export declare function cleanDeviceConfig(deviceConfig?: Record<string, Record<string, any>>): Record<string, Record<string, any>> | undefined;
+/**
+ * Factory that returns a function to send OpenAPI commands using a retry wrapper.
+ *
+ * @param retryCommandFunc - bound function that calls platform.retryCommand(device, bodyChange, maxRetries, delay)
+ * @param deviceObj - the device object to operate on
+ * @param opts - optional overrides for maxRetries and delayBetweenRetries
+ * @param opts.maxRetries - override for maxRetries
+ * @param opts.delayBetweenRetries - override for delayBetweenRetries
+ */
+export declare function makeOpenAPISender(retryCommandFunc: any, deviceObj: any, opts?: {
+    maxRetries?: number;
+    delayBetweenRetries?: number;
+}): (command: string, parameter?: string) => Promise<any>;
+/**
+ * Factory that returns a function to perform BLE actions using a SwitchBotBLE client.
+ * Handles discovery retries and method invocation on the discovered device instance.
+ *
+ * @param switchBotBLE - instance of SwitchBotBLE (may be undefined)
+ * @param deviceObj - the device object (used to obtain bleModel/deviceId)
+ * @param opts - optional retry settings
+ * @param opts.bleRetries - number of BLE discovery retries
+ * @param opts.bleRetryDelay - delay between BLE retries in ms
+ */
+export declare function makeBLESender(switchBotBLE: any, deviceObj: any, opts?: {
+    bleRetries?: number;
+    bleRetryDelay?: number;
+}): (methodName: string, ...args: any[]) => Promise<any>;
+/**
+ * Decide effective connection type for a device given platform options.
+ * Mirrors the logic previously in platform-matter.
+ */
+export declare function chooseConnectionType(platformOptions: any, deviceObj: any): 'BLE' | 'OpenAPI';
+/**
+ * Detect whether Matter is enabled/available on the provided Homebridge API object.
+ * This encapsulates the multi-fallback detection used across the project.
+ */
+/**
+ * Detect whether Matter is enabled on the provided Homebridge API object.
+ * Returns an object with an `enabled` boolean and an optional `reason` string
+ * describing which check matched (useful for diagnostics).
+ */
+export declare function detectMatter(apiObj: API): {
+    enabled: boolean;
+    reason?: string;
+};
+/**
+ * Backwards-compatible boolean wrapper for detectMatter.
+ */
+export declare function detectMatterEnabled(apiObj: API): boolean;
+/**
+ * Create platform logging helpers used by both HAP and Matter platforms.
+ *
+ * getPlatformLogging may be either a synchronous string-returning function or an
+ * async function that resolves to the current platform logging setting. The
+ * returned helpers mirror the instance methods previously implemented on the
+ * HAP platform (infoLog, warnLog, errorLog, debugLog, etc.).
+ */
+export declare function createPlatformLogger(getPlatformLogging: () => string | Promise<string | undefined>, log: Logging): {
+    infoLog: (...args: any[]) => Promise<void>;
+    successLog: (...args: any[]) => Promise<void>;
+    debugSuccessLog: (...args: any[]) => Promise<void>;
+    warnLog: (...args: any[]) => Promise<void>;
+    debugWarnLog: (...args: any[]) => Promise<void>;
+    errorLog: (...args: any[]) => Promise<void>;
+    debugErrorLog: (...args: any[]) => Promise<void>;
+    debugLog: (...args: any[]) => Promise<void>;
+    loggingIsDebug: () => Promise<boolean>;
+    enablingPlatformLogging: () => Promise<boolean>;
+};
+/**
+ * Create a Platform proxy class that selects between two platform constructors
+ * (HAP vs Matter) at runtime using `detectMatter`. Returns a class suitable
+ * for passing to `api.registerPlatform`.
+ */
+export declare function createPlatformProxy(HAPCtor: any, MatterCtor: any): {
+    new (log: any, config: any, api: API): {
+        delegate: any;
+        readonly log: any;
+        readonly config: any;
+        readonly api: API;
+        configureAccessory(accessory: any): void;
+        configureMatterAccessory?(accessory: any): void;
+        get accessories(): any;
+        get matterAccessories(): any;
+    };
+};
+/**
+ * API Request Tracker - Persistent tracking of SwitchBot API calls
+ * Tracks requests per day with automatic midnight rollover
+ */
+export declare class ApiRequestTracker {
+    private count;
+    private date;
+    private statsFile;
+    private hourlyTimer?;
+    private log;
+    constructor(api: API, log: Logging, pluginName?: string);
+    /**
+     * Load API request statistics from persistent storage
+     */
+    private load;
+    /**
+     * Save API request statistics to persistent storage
+     */
+    private save;
+    /**
+     * Increment API request counter and save
+     */
+    track(): void;
+    /**
+     * Start hourly logging of API request count
+     */
+    startHourlyLogging(): void;
+    /**
+     * Stop hourly logging
+     */
+    stopHourlyLogging(): void;
+    /**
+     * Get current count
+     */
+    getCount(): number;
+    /**
+     * Get current date
+     */
+    getDate(): string;
+}
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,oBAAY,oBAAoB;IAC9B,MAAM,YAAY;IAClB,QAAQ,cAAc;IACtB,SAAS,gBAAgB;IACzB,SAAS,gBAAgB;IACzB,mBAAmB,2BAA2B;CAC/C;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,aAAa,CAE9G;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,IAAI,SAAS,GAAG,aAAa,CAErG;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AACD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAOlF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAQlF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,UAWrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CA6BrF;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,YAiC5C;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,YAyCpC;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,OA8D9B;AAED,wBAAgB,IAAI,CAAC,CAAC,KAAA,YA2ZrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,SAAS,CA2CrI"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/dist/utils.js

@@ -1,3 +1,9 @@
+/* Copyright(C) 2017-2024, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+ *
+ * util.ts: @switchbot/homebridge-switchbot platform class.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
 export var BlindTiltMappingMode;
 (function (BlindTiltMappingMode) {
     BlindTiltMappingMode["OnlyUp"] = "only_up";
@@ -690,4 +696,403 @@ export function cleanDeviceConfig(deviceConfig) {
     }
     return undefined;
 }
+/**
+ * Factory that returns a function to send OpenAPI commands using a retry wrapper.
+ *
+ * @param retryCommandFunc - bound function that calls platform.retryCommand(device, bodyChange, maxRetries, delay)
+ * @param deviceObj - the device object to operate on
+ * @param opts - optional overrides for maxRetries and delayBetweenRetries
+ * @param opts.maxRetries - override for maxRetries
+ * @param opts.delayBetweenRetries - override for delayBetweenRetries
+ */
+export function makeOpenAPISender(retryCommandFunc, deviceObj, opts) {
+    return async (command, parameter = 'default') => {
+        const bodyChange = { command, parameter, commandType: 'command' };
+        return retryCommandFunc(deviceObj, bodyChange, opts?.maxRetries, opts?.delayBetweenRetries);
+    };
+}
+/**
+ * Factory that returns a function to perform BLE actions using a SwitchBotBLE client.
+ * Handles discovery retries and method invocation on the discovered device instance.
+ *
+ * @param switchBotBLE - instance of SwitchBotBLE (may be undefined)
+ * @param deviceObj - the device object (used to obtain bleModel/deviceId)
+ * @param opts - optional retry settings
+ * @param opts.bleRetries - number of BLE discovery retries
+ * @param opts.bleRetryDelay - delay between BLE retries in ms
+ */
+export function makeBLESender(switchBotBLE, deviceObj, opts) {
+    return async (methodName, ...args) => {
+        if (!switchBotBLE) {
+            throw new Error('Platform BLE not available');
+        }
+        const id = formatDeviceIdAsMac(deviceObj.deviceId);
+        const maxRetries = opts?.bleRetries ?? 2;
+        const retryDelay = opts?.bleRetryDelay ?? 500;
+        let attempt = 0;
+        while (attempt < maxRetries) {
+            try {
+                const list = await switchBotBLE.discover({ model: deviceObj.bleModel, id });
+                if (!Array.isArray(list) || list.length === 0) {
+                    throw new Error('BLE device not found');
+                }
+                const deviceInst = list[0];
+                if (typeof deviceInst[methodName] !== 'function') {
+                    throw new TypeError(`BLE method ${methodName} not available on device`);
+                }
+                return await deviceInst[methodName](...args);
+            }
+            catch (e) {
+                attempt++;
+                if (attempt >= maxRetries) {
+                    throw e;
+                }
+                await sleep(retryDelay);
+            }
+        }
+        throw new Error('BLE operation failed');
+    };
+}
+/**
+ * Decide effective connection type for a device given platform options.
+ * Mirrors the logic previously in platform-matter.
+ */
+export function chooseConnectionType(platformOptions, deviceObj) {
+    if (deviceObj?.connectionType) {
+        return deviceObj.connectionType === 'BLE' ? 'BLE' : 'OpenAPI';
+    }
+    if (platformOptions?.BLE && (deviceObj?.bleModel || (typeof deviceObj?.deviceId === 'string' && deviceObj.deviceId.length > 0))) {
+        return 'BLE';
+    }
+    return 'OpenAPI';
+}
+/**
+ * Detect whether Matter is enabled/available on the provided Homebridge API object.
+ * This encapsulates the multi-fallback detection used across the project.
+ */
+/**
+ * Detect whether Matter is enabled on the provided Homebridge API object.
+ * Returns an object with an `enabled` boolean and an optional `reason` string
+ * describing which check matched (useful for diagnostics).
+ */
+export function detectMatter(apiObj) {
+    try {
+        const maybe = apiObj.isMatterEnabled;
+        if (typeof maybe === 'function') {
+            return { enabled: Boolean(maybe.call(apiObj)), reason: 'api.isMatterEnabled() returned truthy' };
+        }
+        if (typeof maybe !== 'undefined') {
+            return { enabled: Boolean(maybe), reason: 'api.isMatterEnabled property present' };
+        }
+        const server = apiObj.server ?? apiObj.homebridgeServer ?? apiObj.homebridge_server;
+        const serverMaybe = server?.isMatterEnabled;
+        if (typeof serverMaybe === 'function') {
+            return { enabled: Boolean(serverMaybe.call(server)), reason: 'server.isMatterEnabled() returned truthy' };
+        }
+        if (typeof server?.isMatterEnabled !== 'undefined') {
+            return { enabled: Boolean(server.isMatterEnabled), reason: 'server.isMatterEnabled property present' };
+        }
+    }
+    catch (e) {
+        return { enabled: false, reason: `error during detection: ${String(e?.message ?? e)}` };
+    }
+    return { enabled: false, reason: 'no isMatterEnabled API or server fallback detected' };
+}
+/**
+ * Backwards-compatible boolean wrapper for detectMatter.
+ */
+export function detectMatterEnabled(apiObj) {
+    return detectMatter(apiObj).enabled;
+}
+/**
+ * Create platform logging helpers used by both HAP and Matter platforms.
+ *
+ * getPlatformLogging may be either a synchronous string-returning function or an
+ * async function that resolves to the current platform logging setting. The
+ * returned helpers mirror the instance methods previously implemented on the
+ * HAP platform (infoLog, warnLog, errorLog, debugLog, etc.).
+ */
+export function createPlatformLogger(getPlatformLogging, log) {
+    const getPL = async () => {
+        try {
+            return await getPlatformLogging();
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const loggingIsDebug = async () => {
+        const pl = await getPL();
+        return pl === 'debugMode' || pl === 'debug';
+    };
+    const enablingPlatformLogging = async () => {
+        const pl = await getPL();
+        return pl === 'debugMode' || pl === 'debug' || pl === 'standard';
+    };
+    const formatArgs = (args) => {
+        return args
+            .map((a) => {
+            if (typeof a === 'string') {
+                return a;
+            }
+            try {
+                return JSON.stringify(a);
+            }
+            catch {
+                return String(a);
+            }
+        })
+            .join(' ');
+    };
+    return {
+        // Format arbitrary arguments into a single string to ensure values are not dropped
+        // when loggers only accept a single message parameter.
+        // Prefer readable JSON for objects, fall back to String() on errors.
+        // Example: infoLog('Loaded', accessory.displayName) => "Loaded My Light"
+        infoLog: async (...args) => {
+            if (await enablingPlatformLogging()) {
+                const msg = formatArgs(args);
+                log.info(msg);
+            }
+        },
+        successLog: async (...args) => {
+            if (await enablingPlatformLogging()) {
+                const msg = formatArgs(args);
+                log.success?.(msg) ?? log.info(msg);
+            }
+        },
+        debugSuccessLog: async (...args) => {
+            if (await enablingPlatformLogging()) {
+                if (await loggingIsDebug()) {
+                    const msg = formatArgs(args);
+                    log.success?.(`[DEBUG] ${msg}`) ?? log.info(`[DEBUG] ${msg}`);
+                }
+            }
+        },
+        warnLog: async (...args) => {
+            if (await enablingPlatformLogging()) {
+                const msg = formatArgs(args);
+                log.warn(msg);
+            }
+        },
+        debugWarnLog: async (...args) => {
+            if (await enablingPlatformLogging()) {
+                if (await loggingIsDebug()) {
+                    const msg = formatArgs(args);
+                    log.warn(`[DEBUG] ${msg}`);
+                }
+            }
+        },
+        errorLog: async (...args) => {
+            if (await enablingPlatformLogging()) {
+                const msg = formatArgs(args);
+                log.error(msg);
+            }
+        },
+        debugErrorLog: async (...args) => {
+            if (await enablingPlatformLogging()) {
+                if (await loggingIsDebug()) {
+                    const msg = formatArgs(args);
+                    log.error(`[DEBUG] ${msg}`);
+                }
+            }
+        },
+        debugLog: async (...args) => {
+            if (await enablingPlatformLogging()) {
+                const pl = await getPL();
+                if (pl === 'debug') {
+                    const msg = formatArgs(args);
+                    log.info(`[DEBUG] ${msg}`);
+                }
+                else if (pl === 'debugMode') {
+                    const msg = formatArgs(args);
+                    log.debug(msg);
+                }
+            }
+        },
+        loggingIsDebug,
+        enablingPlatformLogging,
+    };
+}
+/**
+ * Create a Platform proxy class that selects between two platform constructors
+ * (HAP vs Matter) at runtime using `detectMatter`. Returns a class suitable
+ * for passing to `api.registerPlatform`.
+ */
+export function createPlatformProxy(HAPCtor, MatterCtor) {
+    return class PlatformProxy {
+        log;
+        config;
+        api;
+        delegate;
+        constructor(log, config, api) {
+            this.log = log;
+            this.config = config;
+            this.api = api;
+            const matterInfo = detectMatter(this.api);
+            const isMatter = matterInfo.enabled;
+            const reason = matterInfo.reason ? ` Reason: ${matterInfo.reason}` : '';
+            this.log.info?.(`Homebridge SwitchBot Plugin initializing in ${isMatter ? 'Matter' : 'HAP'} mode.`);
+            this.log.debug?.(`Homebridge SwitchBot Plugin initializing in ${isMatter ? 'Matter' : 'HAP'} mode.${reason}`);
+            const PlatformCtor = isMatter ? MatterCtor : HAPCtor;
+            this.delegate = new PlatformCtor(this.log, this.config, this.api);
+        }
+        configureAccessory(accessory) {
+            try {
+                if (this.delegate && typeof this.delegate.configureAccessory === 'function') {
+                    return this.delegate.configureAccessory(accessory);
+                }
+            }
+            catch (e) {
+                // swallow — preserve previous behaviour where delegate errors don't bubble here
+            }
+        }
+        configureMatterAccessory(accessory) {
+            try {
+                if (this.delegate && typeof this.delegate.configureMatterAccessory === 'function') {
+                    return this.delegate.configureMatterAccessory(accessory);
+                }
+            }
+            catch (e) {
+                // swallow — delegate may not implement this or may throw
+            }
+        }
+        get accessories() {
+            try {
+                return this.delegate?.accessories;
+            }
+            catch (e) {
+                return undefined;
+            }
+        }
+        get matterAccessories() {
+            try {
+                return this.delegate?.matterAccessories;
+            }
+            catch (e) {
+                return undefined;
+            }
+        }
+    };
+}
+/**
+ * API Request Tracker - Persistent tracking of SwitchBot API calls
+ * Tracks requests per day with automatic midnight rollover
+ */
+export class ApiRequestTracker {
+    count = 0;
+    date = '';
+    statsFile = '';
+    hourlyTimer;
+    log;
+    constructor(api, log, pluginName = 'SwitchBot') {
+        this.log = log;
+        this.statsFile = join(api.user.storagePath(), `${pluginName.toLowerCase()}-api-stats.json`);
+        this.load();
+    }
+    /**
+     * Load API request statistics from persistent storage
+     */
+    load() {
+        try {
+            const today = new Date().toISOString().split('T')[0];
+            if (existsSync(this.statsFile)) {
+                const data = JSON.parse(readFileSync(this.statsFile, 'utf8'));
+                // If it's a new day, reset the counter
+                if (data.date === today) {
+                    this.count = data.count || 0;
+                    this.date = data.date;
+                    this.log.warn?.(`[API Stats] Loaded: ${this.count} requests today (${today})`);
+                }
+                else {
+                    this.log.error?.(`[API Stats] New day detected. Previous: ${data.count || 0} requests on ${data.date}`);
+                    this.count = 0;
+                    this.date = today;
+                    this.save();
+                }
+            }
+            else {
+                this.log.debug?.('[API Stats] No existing stats file, starting fresh');
+                this.count = 0;
+                this.date = today;
+                this.save();
+            }
+        }
+        catch (e) {
+            this.log.error?.(`[API Stats] Failed to load stats: ${e?.message ?? e}`);
+            this.count = 0;
+            this.date = new Date().toISOString().split('T')[0];
+        }
+    }
+    /**
+     * Save API request statistics to persistent storage
+     */
+    save() {
+        try {
+            const data = {
+                date: this.date,
+                count: this.count,
+                lastUpdated: new Date().toISOString(),
+            };
+            writeFileSync(this.statsFile, JSON.stringify(data, null, 2), 'utf8');
+        }
+        catch (e) {
+            this.log.debug?.(`[API Stats] Failed to save stats: ${e?.message ?? e}`);
+        }
+    }
+    /**
+     * Increment API request counter and save
+     */
+    track() {
+        const today = new Date().toISOString().split('T')[0];
+        // Reset counter if it's a new day
+        if (this.date !== today) {
+            this.log.debug?.(`[API Stats] Day rollover: ${this.count} requests on ${this.date}`);
+            this.count = 0;
+            this.date = today;
+        }
+        this.count++;
+        this.save();
+    }
+    /**
+     * Start hourly logging of API request count
+     */
+    startHourlyLogging() {
+        // Log immediately on startup
+        this.log.info?.(`[API Stats] Today (${this.date}): ${this.count} API requests`);
+        // Then log every hour
+        this.hourlyTimer = setInterval(() => {
+            const today = new Date().toISOString().split('T')[0];
+            if (this.date !== today) {
+                // Day rollover
+                this.log.info?.(`[API Stats] Day rollover - Previous day (${this.date}): ${this.count} API requests`);
+                this.count = 0;
+                this.date = today;
+                this.save();
+            }
+            this.log.info?.(`[API Stats] Today (${this.date}): ${this.count} API requests`);
+        }, 60 * 60 * 1000); // Every hour
+    }
+    /**
+     * Stop hourly logging
+     */
+    stopHourlyLogging() {
+        if (this.hourlyTimer) {
+            clearInterval(this.hourlyTimer);
+            this.hourlyTimer = undefined;
+        }
+    }
+    /**
+     * Get current count
+     */
+    getCount() {
+        return this.count;
+    }
+    /**
+     * Get current date
+     */
+    getDate() {
+        return this.date;
+    }
+}
 //# sourceMappingURL=utils.js.map