Skip to content

v1.0.104 - International Account Support

Choose a tag to compare

@mickgiles mickgiles released this 26 Aug 01:40
· 71 commits to main since this release

πŸš€ What's New

This release introduces comprehensive international account support, enabling VeSync users worldwide to authenticate and control their devices regardless of their account region.

πŸ”§ Changes

Added

  • International Account Support: Full support for accounts worldwide with country code configuration
    • New countryCode parameter in VeSync constructor for specifying account country
    • Smart endpoint selection based on country codes (EU countries β†’ EU endpoint, others β†’ US endpoint)
    • Support for 40+ European country codes automatically routed to EU endpoint
    • Comprehensive error messages when country code configuration is needed
    • Country code detection helpers for better user guidance

Changed

  • Enhanced Error Messages: Clear, actionable error messages for authentication failures
    • When both regions fail, displays helpful country code configuration instructions
    • Shows common country codes (AU, NZ, JP, etc.) in error messages for quick reference
    • Warning messages when country code mismatch is detected with fix instructions
    • Improved cross-region error detection and user guidance

Fixed

  • Australian/New Zealand Authentication: AU and NZ accounts now work with US endpoint + country codes
    • Discovered that AU/NZ accounts use US endpoint but require their specific country codes
    • Fixed authentication for all Asia-Pacific region accounts
    • Removed invalid .cn endpoint attempts

πŸ“¦ Installation

npm install tsvesync@1.0.104

πŸ”— Related Releases

  • homebridge-tsvesync v1.0.104: Enhanced UI with country code configuration dropdown

🌍 Usage Examples

// For US accounts (default - no change needed)
const vesync = new VeSync('user@example.com', 'password');

// For Australian accounts
const vesync = new VeSync('user@example.com', 'password', 'AU');

// For New Zealand accounts
const vesync = new VeSync('user@example.com', 'password', 'NZ');

// For German accounts
const vesync = new VeSync('user@example.com', 'password', 'DE');

πŸ“‹ Migration Notes

  • US Users: No action required - default behavior unchanged
  • International Users: Add your country code as the third parameter
  • EU Users: Continue to work automatically with proper country codes
  • AU/NZ Users: Must specify 'AU' or 'NZ' country codes respectively

πŸ€– Generated with Claude Code