dash16/homebridge-cync-app v0.0.2

v0.0.2 – Cloud 2FA login + device discovery

on GitHub

This release brings the first end-to-end Cync cloud integration: 2FA login, token persistence, and device discovery.

Highlights

• Added email + password + 2FA login against the Cync cloud API.
• Implemented persistent token storage in the Homebridge storage path.
• Restores sessions automatically on Homebridge restart using the stored token.
• Fetches Cync meshes via /user/{userId}/subscribe/devices.
• For each mesh, probes /product/{productId}/device/{meshId}/property to locate bulbsArray.
• Maps bulbsArray entries into Homebridge accessories:
  • Uses Cync displayName as the HomeKit accessory name.
  • Uses deviceID / wifiMac to seed stable UUIDs (e.g. cync-<meshId>-<deviceId>).

Installation / Upgrade

1. Install the plugin:

   npm install -g homebridge-cync-app

1. Add a platform entry to your config.json:

   {
     "platform": "CyncAppPlatform",
     "name": "Cync App (Dev)",
     "username": "you@example.com",
     "password": "your-cync-password"
   }

1. Start Homebridge once without twoFactor set to trigger a 2FA email.

2. Add the 2FA code as "twoFactor": "123456" in the platform config and restart Homebridge.

3. You should see your Cync outlets appear as HomeKit switches using their Cync names.

Known limitations

• TCP / LAN control is not wired yet:

  • The switch On characteristic logs state changes but does not send real commands to devices.

• Only simple on/off outlets have been validated.

• Token refresh / expiry handling is not implemented; if the token expires, you may need to repeat the 2FA flow.

Breaking changes

• None. This is still a 0.0.x exploratory build, but code paths for login and discovery have changed significantly from v0.0.1.