@homebridge-plugins/homebridge-tuya 3.0.0-beta.2 → 3.0.0-beta.21

package/test/zigbee/CloudLocalReconciliation.test.ts

@@ -1,284 +0,0 @@
-import { describe, expect, it, beforeEach, jest } from '@jest/globals';
-import {
-  reconcileDeviceSources,
-  getPreferredSource,
-  filterDevicesBySource,
-  markDeviceConnected,
-  shouldHideFromSource,
-  logReconciliationSummary,
-  DeviceSourceInfo,
-} from '../../src/local/CloudLocalReconciliation';
-import TuyaDevice from '../../src/cloud/device/TuyaDevice';
-import Logger from '../../src/shared/util/Logger';
-
-function makeMockLog(): Logger {
-  return {
-    debug: jest.fn(),
-    info: jest.fn(),
-    warn: jest.fn(),
-    error: jest.fn(),
-    log: jest.fn(),
-  } as unknown as Logger;
-}
-
-function createMockDevice(id: string, uuid: string): TuyaDevice {
-  return {
-    id,
-    uuid,
-    name: `Device ${id}`,
-  } as TuyaDevice;
-}
-
-describe('CloudLocalReconciliation - Phase 4', () => {
-  let log: Logger;
-
-  beforeEach(() => {
-    log = makeMockLog();
-  });
-
-  describe('reconcileDeviceSources', () => {
-    it('reconciles cloud-only devices', () => {
-      const cloudDevices = [
-        createMockDevice('cloud_001', 'uuid_001'),
-        createMockDevice('cloud_002', 'uuid_002'),
-      ];
-
-      const result = reconcileDeviceSources(cloudDevices, [], log);
-
-      expect(result.size).toBe(2);
-      expect(result.get('uuid_001')).toEqual({
-        cloud: true,
-        local: false,
-        connectedTo: 'cloud',
-      });
-    });
-
-    it('reconciles local-only devices', () => {
-      const localDevices = [
-        createMockDevice('local_001', 'uuid_101'),
-      ];
-
-      const result = reconcileDeviceSources([], localDevices, log);
-
-      expect(result.size).toBe(1);
-      expect(result.get('uuid_101')).toEqual({
-        cloud: false,
-        local: true,
-        localIP: undefined,
-        localVersion: undefined,
-        connectedTo: 'local',
-      });
-    });
-
-    it('reconciles hybrid devices (same UUID, both sources)', () => {
-      const cloudDevices = [createMockDevice('device_a', 'uuid_hybrid')];
-      const localDevices = [createMockDevice('device_a', 'uuid_hybrid')];
-
-      const result = reconcileDeviceSources(cloudDevices, localDevices, log);
-
-      expect(result.size).toBe(1);
-      const info = result.get('uuid_hybrid');
-      expect(info?.cloud).toBe(true);
-      expect(info?.local).toBe(true);
-      expect(info?.connectedTo).toBe('both');
-
-      const infoSpy = log.info as jest.MockedFunction<typeof log.info>;
-      expect(infoSpy).toHaveBeenCalledWith(expect.stringContaining('available via cloud AND local'));
-    });
-
-    it('handles mixed cloud-only, local-only, and hybrid devices', () => {
-      const cloudDevices = [
-        createMockDevice('cloud_only', 'uuid_cloud'),
-        createMockDevice('hybrid', 'uuid_hybrid'),
-      ];
-      const localDevices = [
-        createMockDevice('local_only', 'uuid_local'),
-        createMockDevice('hybrid', 'uuid_hybrid'),
-      ];
-
-      const result = reconcileDeviceSources(cloudDevices, localDevices, log);
-
-      expect(result.size).toBe(3);
-      expect(result.get('uuid_cloud')?.cloud).toBe(true);
-      expect(result.get('uuid_cloud')?.local).toBe(false);
-      expect(result.get('uuid_local')?.cloud).toBe(false);
-      expect(result.get('uuid_local')?.local).toBe(true);
-      expect(result.get('uuid_hybrid')?.cloud).toBe(true);
-      expect(result.get('uuid_hybrid')?.local).toBe(true);
-    });
-
-    it('logs hybrid device detection', () => {
-      const cloudDevices = [createMockDevice('device', 'uuid_123')];
-      const localDevices = [createMockDevice('device', 'uuid_123')];
-
-      reconcileDeviceSources(cloudDevices, localDevices, log);
-
-      const infoSpy = log.info as jest.MockedFunction<typeof log.info>;
-      expect(infoSpy).toHaveBeenCalledWith(expect.stringContaining('available via cloud AND local'));
-    });
-  });
-
-  describe('getPreferredSource', () => {
-    it('prefers local when available', () => {
-      const sourceInfo: DeviceSourceInfo = { cloud: true, local: true };
-      expect(getPreferredSource(sourceInfo)).toBe('local');
-    });
-
-    it('uses cloud when local unavailable', () => {
-      const sourceInfo: DeviceSourceInfo = { cloud: true, local: false };
-      expect(getPreferredSource(sourceInfo)).toBe('cloud');
-    });
-
-    it('always prefers local when both available (ignores default param)', () => {
-      const sourceInfo: DeviceSourceInfo = { cloud: true, local: true };
-      // The defaultSource param is only used when local is unavailable
-      // When both are available, local is always preferred
-      expect(getPreferredSource(sourceInfo, 'local')).toBe('local');
-      expect(getPreferredSource(sourceInfo, 'cloud')).toBe('local');
-    });
-  });
-
-  describe('filterDevicesBySource', () => {
-    let sourceMap: Map<string, DeviceSourceInfo>;
-
-    beforeEach(() => {
-      sourceMap = new Map([
-        ['uuid_cloud', { cloud: true, local: false }],
-        ['uuid_local', { cloud: false, local: true }],
-        ['uuid_hybrid', { cloud: true, local: true }],
-      ]);
-    });
-
-    it('filters to local-only devices', () => {
-      const devices = [
-        createMockDevice('cloud', 'uuid_cloud'),
-        createMockDevice('local', 'uuid_local'),
-        createMockDevice('hybrid', 'uuid_hybrid'),
-      ];
-
-      const result = filterDevicesBySource(devices, 'local', sourceMap);
-
-      expect(result.length).toBe(2);
-      expect(result.map(d => d.uuid)).toContain('uuid_local');
-      expect(result.map(d => d.uuid)).toContain('uuid_hybrid');
-      expect(result.map(d => d.uuid)).not.toContain('uuid_cloud');
-    });
-
-    it('filters to cloud-only devices', () => {
-      const devices = [
-        createMockDevice('cloud', 'uuid_cloud'),
-        createMockDevice('local', 'uuid_local'),
-        createMockDevice('hybrid', 'uuid_hybrid'),
-      ];
-
-      const result = filterDevicesBySource(devices, 'cloud', sourceMap);
-
-      expect(result.length).toBe(2);
-      expect(result.map(d => d.uuid)).toContain('uuid_cloud');
-      expect(result.map(d => d.uuid)).toContain('uuid_hybrid');
-      expect(result.map(d => d.uuid)).not.toContain('uuid_local');
-    });
-
-    it('returns all devices for both source filter', () => {
-      const devices = [
-        createMockDevice('cloud', 'uuid_cloud'),
-        createMockDevice('local', 'uuid_local'),
-        createMockDevice('hybrid', 'uuid_hybrid'),
-      ];
-
-      const result = filterDevicesBySource(devices, 'both', sourceMap);
-
-      expect(result.length).toBe(3);
-    });
-
-    it('excludes unknown devices from filter', () => {
-      const devices = [
-        createMockDevice('cloud', 'uuid_cloud'),
-        createMockDevice('unknown', 'uuid_unknown'),
-      ];
-
-      const result = filterDevicesBySource(devices, 'cloud', sourceMap);
-
-      expect(result.length).toBe(1);
-      expect(result[0].uuid).toBe('uuid_cloud');
-    });
-  });
-
-  describe('markDeviceConnected', () => {
-    let sourceMap: Map<string, DeviceSourceInfo>;
-
-    beforeEach(() => {
-      sourceMap = new Map([
-        ['uuid_001', { cloud: true, local: true, connectedTo: 'cloud' }],
-      ]);
-    });
-
-    it('updates device connection state to local', () => {
-      markDeviceConnected('uuid_001', 'local', sourceMap, log);
-
-      expect(sourceMap.get('uuid_001')?.connectedTo).toBe('both');
-    });
-
-    it('warns if marking unknown device as connected', () => {
-      markDeviceConnected('uuid_unknown', 'local', sourceMap, log);
-
-      const warnSpy = log.warn as jest.MockedFunction<typeof log.warn>;
-      expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('unknown device'));
-    });
-
-    it('warns if marking device connected to unavailable source', () => {
-      const sourceInfo: DeviceSourceInfo = {
-        cloud: true,
-        local: false,
-      };
-      sourceMap.set('uuid_002', sourceInfo);
-
-      markDeviceConnected('uuid_002', 'local', sourceMap, log);
-
-      const warnSpy = log.warn as jest.MockedFunction<typeof log.warn>;
-      expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('not available locally'));
-    });
-  });
-
-  describe('shouldHideFromSource', () => {
-    it('does not hide when source is both', () => {
-      const device = createMockDevice('test', 'uuid_test');
-      expect(shouldHideFromSource(device, 'cloud', 'both')).toBe(false);
-      expect(shouldHideFromSource(device, 'local', 'both')).toBe(false);
-    });
-
-    it('hides cloud devices when source is local-only', () => {
-      const device = createMockDevice('test', 'uuid_test');
-      expect(shouldHideFromSource(device, 'cloud', 'local')).toBe(true);
-    });
-
-    it('hides local devices when source is cloud-only', () => {
-      const device = createMockDevice('test', 'uuid_test');
-      expect(shouldHideFromSource(device, 'local', 'cloud')).toBe(true);
-    });
-
-    it('defaults to cloud-only when source undefined', () => {
-      const device = createMockDevice('test', 'uuid_test');
-      expect(shouldHideFromSource(device, 'local', undefined)).toBe(true);
-      expect(shouldHideFromSource(device, 'cloud', undefined)).toBe(false);
-    });
-  });
-
-  describe('logReconciliationSummary', () => {
-    it('logs reconciliation counts', () => {
-      const sourceMap = new Map<string, DeviceSourceInfo>([
-        ['uuid_1', { cloud: true, local: true }],
-        ['uuid_2', { cloud: true, local: false }],
-        ['uuid_3', { cloud: false, local: true }],
-      ]);
-
-      logReconciliationSummary(sourceMap, log);
-
-      const infoSpy = log.info as jest.MockedFunction<typeof log.info>;
-      const call = String(infoSpy.mock.calls[0][0]);
-      expect(call).toContain('1 hybrid');
-      expect(call).toContain('1 cloud-only');
-      expect(call).toContain('1 local-only');
-    });
-  });
-});

package/tuya-local-configs/dev-1.hash

@@ -1 +0,0 @@
-85778e1add80c517

package/tuya-local-configs/device1.hash

@@ -1 +0,0 @@
-35d2f400f4ef8c0f

package/wiki/Get-Local-Keys-for-Your-Devices.md

@@ -1,85 +0,0 @@
-# Get Local Keys for Your Devices
-
-To get the local keys for your devices, you'll need an account on Tuya's IoT site. Don't be overwhelmed, there's a lot on that site but it's pretty easy to get what you need out of it. The free trial will give you enough access to the Tuya API to get the information you need, on up to 50 devices.
-
-## 1 - Tuya Smart App
-
-As a prerequisite, add all of your devices to the Tuya Smart app ([iOS](https://apps.apple.com/au/app/tuya-smart/id1034649547) / [Android](https://play.google.com/store/apps/details?id=com.tuya.smart&hl=en_AU&gl=US&pli=1))
-
-## 2 - Sign up for an IoT account
-
-Go to https://iot.tuya.com and click Sign Up
-
-![signup](https://user-images.githubusercontent.com/82495132/120384295-d2c95100-c2da-11eb-930d-75eaad628f4f.png)
-
-* Fill in your information
-* Make up a company name if you need to
-
-![signup-info](https://user-images.githubusercontent.com/82495132/120384453-099f6700-c2db-11eb-8cbc-20f3bc5bb17f.png)
-
-* Check Agree to Terms
-* Click Agree
-* You'll be emailed a code, enter it
-
-## 3 - Sign in at iot.tuya.com
-
-## 4 - Create a cloud project
-
-* Click through the intro
-* On the sidebar click cloud, then projects
-* Click Free Trial under TRIAL EDITION
-
-![freetrial](https://user-images.githubusercontent.com/82495132/120384723-60a53c00-c2db-11eb-8f79-f2a2f38dbc8a.png)
-
-* Click Buy now in the new tab
-
-![buynow](https://user-images.githubusercontent.com/82495132/120384754-69960d80-c2db-11eb-802c-7067dff3274a.png)
-
-* Close the Tuya Value Added Service tab/popup
-* In the Tuya IoT Platform tab, click Subscribed to be taken back to Cloud -> Projects
-* Click create
-
-![create](https://user-images.githubusercontent.com/82495132/120384789-7a468380-c2db-11eb-9770-8bdd41d65a3a.png)
-
-* Make sure you pick smart home PAAS and the correct region, this affects whether you will be able to access your devices in the following steps. Click create
-
-![createproject](https://user-images.githubusercontent.com/82495132/120386067-04431c00-c2dd-11eb-93ff-27371397e1e2.png)
-
-* Click Authorize for the recommended APIs
-
-![authorize](https://user-images.githubusercontent.com/82495132/120384846-87637280-c2db-11eb-8a3c-b2fd256f68d5.png)
-
-## 5 - Link devices registered in Tuya app to the IoT site
-
-* From your project, click the link devices tab, then Link devices by App Account, then Add App Account
-
-![addappaccount](https://user-images.githubusercontent.com/82495132/120385095-d7dad000-c2db-11eb-9e4c-595af4502154.png)
-
-* In the Tuya Smart app, click me at the bottom, then the scan button, then scan your QR code
-
-![scan2](https://user-images.githubusercontent.com/82495132/120385375-2f793b80-c2dc-11eb-9343-c579fc288962.png)
-
-* Confirm the sign in
-
-## 6 - Get the keys for your devices
-
-* Go to the device list tab
-* Copy the device ID for your device
-
-![devices](https://user-images.githubusercontent.com/484912/204113199-a7ffd1c6-7f22-4295-a3a1-948ba15643b2.png)
-
-* In the sidebar, hover over "Cloud" and click on "API Explorer"
-
-![apiexplorer](https://user-images.githubusercontent.com/484912/204113419-3d106164-eff8-4ff3-a4f5-c7f2a025de96.png)
-
-* In the sidebar, search for "get device information" endpoint and click on the highlighted option. (It should be under "General Devices management" section. Note: there is also another endpoint called "Get _the_ device information" which will not work.)
-
-* In the "device_id" text field, paste in the device ID you copied and click "Submit Request"
-
-* In the "Response" section, there should be a property called `local_key` which is your local key.
-
-![localkey](https://user-images.githubusercontent.com/484912/204113337-81ebe3c3-5f3a-4854-a069-aa929bfb145d.png)
-
-## 7 - Video Tutorial
-
-* [YouTube](https://youtu.be/FpY-xsY-pZ8)