[matt-thepie]

Problem

home-assistant/core#185593: Hive login fails if the email is typed with any capital letter, for example when the iOS app autocapitalises the first letter. Hive's Cognito pool treats the username as case-sensitive and answers with NotAuthorizedException, which surfaces as HiveInvalidPassword.

Home Assistant only partly works around this. config_flow.py lower-cases the username for the flow's own Auth(...):

username = self.data[CONF_USERNAME].lower()
self.hive_auth = Auth(
    username=username,

but self.data.update(user_input) keeps the typed value, and that is what is saved in the config entry. On every start, __init__.py passes the entry to the library:

hive_config = dict(entry.data)
...
devices = await hive.session.startSession(hive_config)

and start_session copies it straight onto the auth object (self.auth.username = config["username"]), so any later password or device login uses the capitalised address and fails.

Fix

HiveAuthAsync and HiveAuth now expose username as a property whose setter stores the value trimmed and lower-cased. This covers both the constructor and the reassignment in start_session, with no Home Assistant change needed. File mode (use@file.com) is detected regardless of case as a side effect.

Verification

Live, against a real Hive account with saved device credentials:

Username typed	Before	After
lowercase (as registered)	OK	OK
First letter capitalised	HiveInvalidPassword	OK
All upper case	HiveInvalidPassword	OK

• New tests in tests/unit/test_hive_auth_async.py and tests/unit/test_hive_auth.py cover the constructor, reassignment, the USERNAME sent to InitiateAuth, and file-mode detection.
• Full suite: 1071 passed, 100% coverage. mypy, pylint 10/10, bandit clean. Ruff's three PLR0917 hits are pre-existing on untouched lines and also appear on dev.
• .secrets.baseline updated because the new property shifts an allowlisted line in hive_auth_async.py.

Home Assistant impact

No public API change. Auth, startSession and the exceptions raised are unchanged, and nothing in the integration reads auth.username back. Checked homeassistant/components/hive/config_flow.py and __init__.py on dev.

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
⚠️ Please upload report for BASE (dev@0294877). Learn more about missing BASE report.

Additional details and impacted files

@@          Coverage Diff           @@
##             dev     #179   +/-   ##
======================================
  Coverage       ?   99.96%           
======================================
  Files          ?       30           
  Lines          ?     2655           
  Branches       ?      310           
======================================
  Hits           ?     2654           
  Misses         ?        0           
  Partials       ?        1           

Flag	Coverage Δ
unittests	99.96% <100.00%> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
src/api/hive_auth.py	100.00% <100.00%> (ø)
src/api/hive_auth_async.py	100.00% <100.00%> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.