@boozilla/homebridge-shome 1.1.2 → 1.2.0

package/src/platform.ts

@@ -1,16 +1,19 @@
 import { API, Characteristic, DynamicPlatformPlugin, Logger, PlatformAccessory, PlatformConfig, Service } from 'homebridge';
 import { PLATFORM_NAME, PLUGIN_NAME } from './settings.js';
-import { ShomeClient, MainDevice, SubDevice, Visitor } from './shomeClient.js';
+import { ShomeClient, MainDevice, SubDevice, Visitor, ParkingEvent, MaintenanceFeeData } from './shomeClient.js';
 import { LightAccessory } from './accessories/lightAccessory.js';
 import { VentilatorAccessory } from './accessories/ventilatorAccessory.js';
 import { HeaterAccessory } from './accessories/heaterAccessory.js';
 import { DoorlockAccessory } from './accessories/doorlockAccessory.js';
 import { DoorbellAccessory } from './accessories/doorbellAccessory.js';
+import { ParkingAccessory } from './accessories/parkingAccessory.js';
+import { MaintenanceFeeAccessory } from './accessories/maintenanceFeeAccessory.js';
 
 const CONTROLLABLE_MULTI_DEVICE_TYPES = ['LIGHT', 'HEATER', 'VENTILATOR'];
 const SPECIAL_CONTROLLABLE_TYPES = ['DOORLOCK'];
 
-type AccessoryHandler = LightAccessory | VentilatorAccessory | HeaterAccessory | DoorlockAccessory | DoorbellAccessory;
+type AccessoryHandler = LightAccessory | VentilatorAccessory | HeaterAccessory |
+    DoorlockAccessory | DoorbellAccessory | ParkingAccessory | MaintenanceFeeAccessory;
 
 export class ShomePlatform implements DynamicPlatformPlugin {
   public readonly Service: typeof Service;
@@ -22,6 +25,8 @@ export class ShomePlatform implements DynamicPlatformPlugin {
   private pollingTimer?: NodeJS.Timeout;
 
   private lastCheckedTimestamp: Date = new Date();
+  private lastCheckedParkingTimestamp: Date = new Date();
+  private lastCheckedMaintenanceFeeMonth: string | null = null;
 
   constructor(
         public readonly log: Logger,
@@ -59,6 +64,12 @@ export class ShomePlatform implements DynamicPlatformPlugin {
       if (this.pollingTimer) {
         clearInterval(this.pollingTimer);
       }
+      // Add this loop to properly shut down handlers
+      for (const handler of this.accessoryHandlers.values()) {
+        if (handler instanceof DoorbellAccessory) {
+          handler.shutdown();
+        }
+      }
     });
   }
 
@@ -98,6 +109,16 @@ export class ShomePlatform implements DynamicPlatformPlugin {
       const doorbellAccessory = this.setupAccessory(doorbellDevice, null, doorbellUUID);
       foundAccessories.push(doorbellAccessory);
 
+      const parkingUUID = this.api.hap.uuid.generate('shome-parking');
+      const parkingDevice = { thngModelTypeName: 'PARKING', nickname: 'Parking Sensor', thngId: 'shome-parking' } as MainDevice;
+      const parkingAccessory = this.setupAccessory(parkingDevice, null, parkingUUID);
+      foundAccessories.push(parkingAccessory);
+
+      const feeUUID = this.api.hap.uuid.generate('shome-maintenance-fee');
+      const feeDevice = { thngModelTypeName: 'MAINTENANCE_FEE', nickname: 'Maintenance Fee', thngId: 'shome-maintenance-fee' } as MainDevice;
+      const feeAccessory = this.setupAccessory(feeDevice, null, feeUUID);
+      foundAccessories.push(feeAccessory);
+
       const accessoriesToRemove = this.accessories.filter(cachedAccessory =>
         !foundAccessories.some(foundAccessory => foundAccessory.UUID === cachedAccessory.UUID),
       );
@@ -162,6 +183,12 @@ export class ShomePlatform implements DynamicPlatformPlugin {
     case 'DOORBELL':
       this.accessoryHandlers.set(accessory.UUID, new DoorbellAccessory(this, accessory));
       break;
+    case 'PARKING':
+      this.accessoryHandlers.set(accessory.UUID, new ParkingAccessory(this, accessory));
+      break;
+    case 'MAINTENANCE_FEE':
+      this.accessoryHandlers.set(accessory.UUID, new MaintenanceFeeAccessory(this, accessory));
+      break;
     }
   }
 
@@ -172,6 +199,8 @@ export class ShomePlatform implements DynamicPlatformPlugin {
       try {
         await this.pollDeviceUpdates();
         await this.checkForNewVisitors();
+        await this.checkForNewParkingEvents();
+        await this.checkForNewMaintenanceFee();
       } catch (error) {
         this.log.error('An error occurred during polling:', error);
       }
@@ -246,6 +275,122 @@ export class ShomePlatform implements DynamicPlatformPlugin {
     }
   }
 
+  async checkForNewParkingEvents() {
+    this.log.debug('Checking for new parking events...');
+    const parkingEventList = await this.shomeClient.getParkingHistory();
+    const newParkingEvents: ParkingEvent[] = [];
+
+    for (const event of parkingEventList) {
+      const eventTime = new Date(event.park_date);
+
+      if (eventTime > this.lastCheckedParkingTimestamp) {
+        newParkingEvents.push(event);
+      }
+    }
+
+    if (newParkingEvents.length > 0) {
+      this.log.info(`Found ${newParkingEvents.length} new parking event(s).`);
+      newParkingEvents.sort((a, b) => a.park_date.localeCompare(b.park_date));
+
+      const parkingUUID = this.api.hap.uuid.generate('shome-parking');
+      const parkingHandler = this.accessoryHandlers.get(parkingUUID) as ParkingAccessory | undefined;
+
+      if (parkingHandler) {
+        for (const event of newParkingEvents) {
+          parkingHandler.newParkingEvent(event);
+        }
+      } else {
+        this.log.warn('Parking accessory handler not found.');
+      }
+
+      const latestEvent = newParkingEvents[newParkingEvents.length - 1];
+      this.lastCheckedParkingTimestamp = new Date(latestEvent.park_date);
+      this.log.debug(`Updated last checked parking timestamp to: ${this.lastCheckedParkingTimestamp.toISOString()}`);
+    }
+  }
+
+  async checkForNewMaintenanceFee() {
+    this.log.debug('Checking for new maintenance fee...');
+
+    if (!this.lastCheckedMaintenanceFeeMonth) {
+      this.log.debug('First run for maintenance fee check. Finding the latest available data...');
+      const now = new Date();
+      let initialFeeData: MaintenanceFeeData | null = null;
+      let initialYear = now.getFullYear();
+      let initialMonth = now.getMonth() + 1;
+
+      for (let i = 0; i < 3; i++) {
+        const feeData = await this.shomeClient.getMaintenanceFee(initialYear, initialMonth);
+        if (feeData && feeData.expense_total && feeData.expense_total.length > 0 && feeData.expense_total[0].money > 0) {
+          initialFeeData = feeData;
+          break;
+        }
+
+        initialMonth--;
+        if (initialMonth === 0) {
+          initialMonth = 12;
+          initialYear--;
+        }
+      }
+
+      if (initialFeeData) {
+        const monthStr = `${initialFeeData.search_year}-${initialFeeData.search_month}`;
+        this.log.info(`Found initial latest maintenance fee data for ${monthStr}.`);
+        this.lastCheckedMaintenanceFeeMonth = monthStr;
+      } else {
+        this.log.debug('Could not find any maintenance fee data for the last 3 months on first run.');
+
+        const twoMonthsAgo = new Date();
+        twoMonthsAgo.setMonth(twoMonthsAgo.getMonth() - 2);
+        this.lastCheckedMaintenanceFeeMonth = `${twoMonthsAgo.getFullYear()}-${String(twoMonthsAgo.getMonth() + 1).padStart(2, '0')}`;
+        this.log.debug(`Setting baseline check month to ${this.lastCheckedMaintenanceFeeMonth}.`);
+      }
+      return;
+    }
+
+    let [lastYear, lastMonth] = this.lastCheckedMaintenanceFeeMonth.split('-').map(Number);
+
+    for (let i = 0; i < 3; i++) {
+      let nextMonth = lastMonth + 1;
+      let nextYear = lastYear;
+      if (nextMonth > 12) {
+        nextMonth = 1;
+        nextYear++;
+      }
+
+      const now = new Date();
+
+      if (nextYear > now.getFullYear() || (nextYear === now.getFullYear() && nextMonth > now.getMonth() + 1)) {
+        break;
+      }
+
+      const nextMonthStr = `${nextYear}-${String(nextMonth).padStart(2, '0')}`;
+      this.log.debug(`Proactively checking for maintenance fee for ${nextMonthStr}...`);
+      const feeData = await this.shomeClient.getMaintenanceFee(nextYear, nextMonth);
+
+      if (feeData && feeData.expense_total && feeData.expense_total.length > 0 && feeData.expense_total[0].money > 0) {
+        this.log.info(`Found new maintenance fee data for ${nextMonthStr}.`);
+
+        const feeUUID = this.api.hap.uuid.generate('shome-maintenance-fee');
+        const feeHandler = this.accessoryHandlers.get(feeUUID) as MaintenanceFeeAccessory | undefined;
+        if (feeHandler) {
+          feeHandler.triggerNotification(feeData);
+          this.lastCheckedMaintenanceFeeMonth = nextMonthStr;
+          this.log.debug(`Last checked maintenance fee month updated to: ${nextMonthStr}`);
+
+          lastYear = nextYear;
+          lastMonth = nextMonth;
+        } else {
+          this.log.warn('Maintenance fee accessory handler not found.');
+          break;
+        }
+      } else {
+        this.log.debug(`No maintenance fee data found for ${nextMonthStr}. Stopping check for this cycle.`);
+        break;
+      }
+    }
+  }
+
   private parseRecordDt(recordDt: string): Date {
     const year = parseInt(recordDt.substring(0, 4), 10);
     const month = parseInt(recordDt.substring(4, 6), 10) - 1;

package/src/shomeClient.ts

@@ -31,6 +31,35 @@ export interface Visitor {
     deviceLabel: string;
 }
 
+export interface ParkingEvent {
+    car_no: string;
+    park_date: string;
+    unit: 'in' | 'out';
+}
+
+export interface ExpenseItem {
+    money: number;
+    name: string;
+}
+
+export interface ExpenseBundle {
+    money: number;
+    name: string;
+}
+
+export interface ExpenseTotal {
+    money: number;
+    name: string;
+}
+
+export interface MaintenanceFeeData {
+    search_year: string;
+    search_month: string;
+    expense_item: ExpenseItem[];
+    expense_bundle: ExpenseBundle[];
+    expense_total: ExpenseTotal[];
+}
+
 type QueueTask<T = unknown> = {
     request: () => Promise<T>;
     resolve: (value: T | PromiseLike<T>) => void;
@@ -315,6 +344,47 @@ export class ShomeClient {
     });
   }
 
+  async getParkingHistory(): Promise<ParkingEvent[]> {
+    return this.executeWithRetries(async () => {
+      const token = this.cachedAccessToken;
+      if (!token || !this.homeId) {
+        this.log.error('Cannot fetch parking history: Not logged in or homeId is missing.');
+        return [];
+      }
+
+      const createDate = this.getDateTime();
+      const hashData = this.sha512(`IHRESTAPI${this.homeId}${createDate}`);
+      const response = await axios.get(`${BASE_URL}/v18/complex/${this.homeId}/parking/inout-histories`, {
+        params: { createDate, hashData },
+        headers: { 'Authorization': `Bearer ${token}` },
+      });
+
+      return response.data.data || [];
+    });
+  }
+
+  async getMaintenanceFee(year: number, month: number): Promise<MaintenanceFeeData | null> {
+    return this.executeWithRetries(async () => {
+      const token = this.cachedAccessToken;
+      if (!token || !this.homeId) {
+        this.log.error('Cannot fetch maintenance fee: Not logged in or homeId is missing.');
+        return null;
+      }
+
+      const createDate = this.getDateTime();
+      const hashData = this.sha512(`IHRESTAPI${this.homeId}${year}${month}${createDate}`);
+      const response = await axios.get(`${BASE_URL}/v18/complex/${this.homeId}/maintenance-fee/${year}/${month}`, {
+        params: { createDate, hashData },
+        headers: { 'Authorization': `Bearer ${token}` },
+      });
+
+      if (response.data && response.data.data && response.data.data.length > 0) {
+        return response.data.data[0];
+      }
+      return null;
+    });
+  }
+
   async getThumbnailImage(visitor: Visitor): Promise<Buffer | null> {
     const request = async () => {
       const token = this.cachedAccessToken;
@@ -346,7 +416,6 @@ export class ShomeClient {
     return this.executeWithRetries(request);
   }
 
-
   private sha512(input: string): string {
     return CryptoJS.SHA512(input).toString();
   }