Skip to content

v1.1.0 — HTTP API Auth, Setup Without Account & Credentials Flow

Choose a tag to compare

View all tags
@github-actions github-actions released this 01 Mar 02:33
v1.1.0
0d2227d

Ultra Card Connect v1.1.0

Stable Release — recommended for all users.

✨ What's New

HTTP API Auth Views

Three new HA HTTP API endpoints are now registered on integration setup, allowing the Ultra Card frontend to authenticate users directly through Home Assistant's secure session layer — credentials are never stored in browser localStorage.

  • POST /api/ultra_card_pro_cloud/login — Accepts username + password, updates the config entry credentials, forces the coordinator to re-authenticate, and returns the current sensor state immediately so the frontend reflects auth status without a page reload. If no config entry exists yet, one is created automatically via the config flow.
  • POST /api/ultra_card_pro_cloud/logout — Removes stored credentials from the config entry and resets JWT/refresh tokens, logging the user out cleanly.
  • POST /api/ultra_card_pro_cloud/register — Creates a new ultracard.io account via the WordPress API, then auto-logs in using the login flow above. Returns the sensor state on success.

All views require a valid Home Assistant session (requires_auth = True).

Setup Without Account

The config flow now opens with a menu step letting users choose:

  • Sign in with ultracard.io account — proceeds to the new credentials step (username/password).
  • Set up without an account — creates a config entry immediately with no credentials, so the sidebar appears right away. Users can sign in later via the Account tab in the Hub sidebar.

Coordinator — Graceful No-Credentials Handling

When the config entry has no credentials (set up without account), the coordinator now returns {"authenticated": False} immediately instead of attempting network requests, eliminating unnecessary errors in the logs.

Config Flow Cleanup

  • Split async_step_user into a menu step (user) and a dedicated async_step_credentials step for the sign-in form.
  • Added async_step_user_api — a programmatic flow step called by the new login HTTP view to create entries without user interaction.
  • Config entry title changed from "Ultra Card Pro (...)" to "Ultra Card (...)".
  • Removed emoji prefixes from log statements for cleaner HA logs.

Strings & Translations

  • New user step description explains the menu choice.
  • New credentials step with sign-in instructions and a link to the registration page.
  • Updated strings.json and translations/en.json in sync.

🐛 Bug Fixes

  • Fixed whitespace/formatting inconsistencies in coordinator.py.
  • ultra-card-panel.js minor update (line 307 patch).

🔧 Installation / Upgrade

  1. In HACS, find Ultra Card Connect and update to v1.1.0.
  2. Restart Home Assistant when prompted.
  3. If upgrading, your existing config entry is preserved — no reconfiguration needed.
  4. New installs will see the "Set up without account" option during initial config flow.

Pairs with Ultra Card v3.1.0-beta1 or later.

Assets 2
Loading