Release 5.8.2 beta 8 service fallback

Author: r11a

CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 5.8.2-beta.8 - 2026-06-03
+
+Focused beta follow-up for issue #28 after beta 7 exposed the next Home Assistant service-call layer.
+
+Release focus:
+
+- Keeps exposed `music_assistant` services as a valid integration signal even when the config entry reports `not_loaded`.
+- Still passes the discovered `config_entry_id` to Home Assistant `music_assistant` service calls when the services require it, fixing `required key not provided @ data['config_entry_id']` library failures.
+- Removes `queue_id` from the Home Assistant `music_assistant.get_queue` diagnostic path so HA receives only the selected `entity_id`.
+- Improves Diagnostic v3 wording for generic HA fallback players, so Alexa/other fallback entities are no longer described as strict Music Assistant-marked players.
+- Softens queue diagnostics when a fallback selected player has no Music Assistant queue identity.
+
+Validation:
+
+- Targeted lint and runtime/settings regression tests passed before the release version bump.
+- Full lint, full Vitest, production build, and release artifact sync were run for the final beta package.
+
 ## 5.8.2-beta.7 - 2026-06-02
 
 Targeted beta follow-up for issue #28, Diagnostic v3, and the phone Queue Flow entry point.

README.md

@@ -47,7 +47,7 @@ https://github.com/user-attachments/assets/a0076e6e-0352-40f8-ac37-35737e717a80
 
 <p align="center">
   <a href="https://github.com/r11a/homeii-music-flow"><img alt="stable version" src="https://img.shields.io/badge/stable-5.8.1-gold"></a>
-  <a href="https://github.com/r11a/homeii-music-flow/releases/tag/v5.8.2-beta.7"><img alt="beta version" src="https://img.shields.io/badge/beta-5.8.2--beta.7-8A63D2"></a>
+  <a href="https://github.com/r11a/homeii-music-flow/releases/tag/v5.8.2-beta.8"><img alt="beta version" src="https://img.shields.io/badge/beta-5.8.2--beta.8-8A63D2"></a>
   <img alt="Home Assistant" src="https://img.shields.io/badge/Home%20Assistant-Dashboard-41BDF5">
   <img alt="Music Assistant" src="https://img.shields.io/badge/Music%20Assistant-required-7C5CFF">
   <img alt="Sendspin" src="https://img.shields.io/badge/Sendspin-browser%20player-18B6FF">
@@ -63,24 +63,23 @@ HOMEii Flow is a custom Home Assistant Dashboard card for Music Assistant. It tu
 
 HOMEii Flow started from my own daily use of Home Assistant and Music Assistant. I wanted it to feel less like a technical dashboard widget and more like a real music app inside Home Assistant, so a lot of thought went into the flow, touch interactions, Hebrew/RTL comfort, wall-tablet behavior, mobile details, and the small moments that make choosing music feel natural at home.
 
-## 5.8.2 Beta 7
+## 5.8.2 Beta 8
 
-HOMEii Flow 5.8.2 Beta 7 focuses on issue #28, Diagnostic v3, and a cleaner phone Queue Flow entry point.
+HOMEii Flow 5.8.2 Beta 8 is a focused follow-up for issue #28 after the beta 7 diagnostics exposed the next service-call layer.
 
-- Lets the card keep working through the Home Assistant Music Assistant integration even when the MA config entry lookup reports `not_loaded` but HA still exposes `music_assistant` services.
-- Uses generic HA `media_player` entities as compatibility fallback targets only when Music Assistant services exist.
-- Improves diagnostics to Diagnostic v3 with integration signals, strict/fallback player markers, queue providers, library providers, browser-blocked Direct API classification, and the existing privacy redaction.
-- Treats browser-blocked Direct API/CORS failures as optional when the HA integration path is available, instead of making the whole card look broken.
-- Removes the phone Queue Flow button above the artwork and keeps Queue Flow available only as a Quick Action option.
-- Removes the invalid `limit` parameter from the HA `music_assistant.get_queue` diagnostic path.
-- Keeps the Beta 1 through Beta 6 artwork, Music Assistant compatibility, Danish localization, diagnostics, and performance fixes.
+- Keeps the beta 7 integration signal fallback, but now still passes the discovered `config_entry_id` to Home Assistant `music_assistant` service calls when those services require it.
+- Fixes library/service calls that failed with `required key not provided @ data['config_entry_id']` in some Home Assistant / Music Assistant setups.
+- Removes `queue_id` from the Home Assistant `music_assistant.get_queue` diagnostic path so HA only receives the selected `entity_id`.
+- Improves Diagnostic v3 wording for generic HA fallback players so Alexa/other `media_player` entities are not described as strict Music Assistant-marked players.
+- Makes queue diagnostics less fatal when the selected fallback player has no `active_queue` / `queue_id` identity.
+- Keeps the Beta 1 through Beta 7 artwork, Music Assistant compatibility, Danish localization, diagnostics, and performance fixes.
 
-Beta download: [v5.8.2-beta.7](https://github.com/r11a/homeii-music-flow/releases/tag/v5.8.2-beta.7)
+Beta download: [v5.8.2-beta.8](https://github.com/r11a/homeii-music-flow/releases/tag/v5.8.2-beta.8)
 
 Stable users can remain on 5.8.1. Beta users should hard refresh Home Assistant or use:
 
 ```text
-/local/community/homeii-music-flow/homeii-music-flow.js?v=5.8.2-beta.7
+/local/community/homeii-music-flow/homeii-music-flow.js?v=5.8.2-beta.8
 ```
 
 ## 5.8.1 Hotfix Release
@@ -1024,7 +1023,8 @@ src/core/                             extracted foundation helpers
 src/config/                           config validators
 tests/                                regression coverage
 scripts/release.mjs                   release sync tooling
-RELEASE_NOTES_5.8.2-beta.7.md         detailed GitHub release notes for the current beta
+RELEASE_NOTES_5.8.2-beta.8.md         detailed GitHub release notes for the current beta
+RELEASE_NOTES_5.8.2-beta.7.md         previous beta release notes
 RELEASE_NOTES_5.8.2-beta.6.md         previous beta release notes
 RELEASE_NOTES_5.8.2-beta.5.md         previous beta release notes
 RELEASE_NOTES_5.8.2-beta.4.md         previous beta release notes
@@ -1050,7 +1050,7 @@ npm run lint
 npm test
 ```
 
-Current packaged version: `5.8.2-beta.7`
+Current packaged version: `5.8.2-beta.8`
 
 ## Release Readiness
 
@@ -1104,6 +1104,7 @@ Credit and thanks:
 
 - [Local deployment guide](./LOCAL_DEPLOYMENT.md)
 - [Publishing checklist](./PUBLISHING.md)
+- [5.8.2 Beta 8 release notes](./RELEASE_NOTES_5.8.2-beta.8.md)
 - [5.8.2 Beta 7 release notes](./RELEASE_NOTES_5.8.2-beta.7.md)
 - [5.8.2 Beta 6 release notes](./RELEASE_NOTES_5.8.2-beta.6.md)
 - [5.8.2 Beta 5 release notes](./RELEASE_NOTES_5.8.2-beta.5.md)

RELEASE_NOTES_5.8.2-beta.8.md

@@ -0,0 +1,35 @@
+# HOMEii Music Flow 5.8.2-beta.8
+
+This beta is a focused follow-up for issue #28 after beta 7 exposed the next Home Assistant service-call layer.
+
+## Fixed
+
+- Keeps the beta 7 Music Assistant integration fallback, but still passes the discovered `config_entry_id` to Home Assistant `music_assistant` service calls when those services require it.
+- Fixes library/service calls that failed with `required key not provided @ data['config_entry_id']` in some Home Assistant / Music Assistant setups.
+- Removes `queue_id` from the Home Assistant `music_assistant.get_queue` diagnostic path so HA receives only the selected `entity_id`.
+- Improves Diagnostic v3 wording for generic HA fallback players, so Alexa/other `media_player` entities are not described as strict Music Assistant-marked players.
+- Makes queue diagnostics less fatal when the selected fallback player has no `active_queue` / `queue_id`.
+
+## Testing Notes
+
+After installing, hard refresh the Home Assistant dashboard and make sure the Lovelace resource URL/cache key is updated to:
+
+```text
+/local/community/homeii-music-flow/homeii-music-flow.js?v=5.8.2-beta.8
+```
+
+For issue #28, please test with `ma_url` empty first, then run the in-card diagnostics:
+
+```text
+Settings > General > Settings Source: In-card Settings
+Settings > Music Assistant > Diagnostics > Run diagnostics > Copy report
+```
+
+The copied report should show:
+
+```text
+Diagnostics: v3
+Version: 5.8.2-beta.8
+```
+
+Please check whether Library pages now return items instead of `required key not provided @ data['config_entry_id']`.

dist/core/base-music-card.js

@@ -1095,7 +1095,7 @@ export function createHomeiiBaseMusicCard({
     _versionedAssetUrl(url) {
       const value = String(url || "").trim();
       if (!value || /^data:/i.test(value) || /[?&]v=/.test(value)) return value;
-      const version = typeof HOMEII_CARD_VERSION === "string" ? HOMEII_CARD_VERSION : "5.8.2-beta.7";
+      const version = typeof HOMEII_CARD_VERSION === "string" ? HOMEII_CARD_VERSION : "5.8.2-beta.8";
       return `${value}${value.includes("?") ? "&" : "?"}v=${encodeURIComponent(version)}`;
     }
 
@@ -10071,7 +10071,9 @@ export function createHomeiiBaseMusicCard({
         return explicit;
       }
       if (this._resolvedConfigEntryId && !force) {
-        return this._hasUsableMusicAssistantConfigEntry() ? this._resolvedConfigEntryId : "";
+        return (this._hasUsableMusicAssistantConfigEntry() || this._hasMusicAssistantServiceSignal())
+          ? this._resolvedConfigEntryId
+          : "";
       }
       try {
         const entries = await this._withTimeout(this._hass.connection.sendMessagePromise({
@@ -10086,9 +10088,9 @@ export function createHomeiiBaseMusicCard({
         this._resolvedConfigEntryId = preferred?.entry_id || "";
         this._resolvedConfigEntryState = String(preferred?.state || "").trim();
         if (!this._resolvedConfigEntryId || preferred?.state && preferred.state !== "loaded") {
-          if (this._hasMusicAssistantServiceSignal()) {
+          if (this._resolvedConfigEntryId && this._hasMusicAssistantServiceSignal()) {
             this._state.musicAssistantIssueMessage = "";
-            return "";
+            return this._resolvedConfigEntryId;
           }
           this._handleMusicAssistantIssue(preferred?.state ? `Music Assistant entry ${preferred.state}` : this._musicAssistantSetupMessage());
           return "";
@@ -10220,9 +10222,7 @@ export function createHomeiiBaseMusicCard({
 
     async _fetchMusicAssistantQueueSnapshot(player) {
       if (!player?.entity_id) return null;
-      const queueId = this._queueIdForPlayer(player);
       const payload = { entity_id: player.entity_id };
-      if (queueId) payload.queue_id = queueId;
       const snapshot = await this._callService("get_queue", payload, { includeConfigEntryId: false });
       return this._normalizeQueueSnapshot(snapshot, player.entity_id);
     }

dist/homeii-music-flow.js

@@ -19341,7 +19341,7 @@ function createHomeiiBaseMusicCard({
         return explicit;
       }
       if (this._resolvedConfigEntryId && !force) {
-        return this._hasUsableMusicAssistantConfigEntry() ? this._resolvedConfigEntryId : "";
+        return this._hasUsableMusicAssistantConfigEntry() || this._hasMusicAssistantServiceSignal() ? this._resolvedConfigEntryId : "";
       }
       try {
         const entries = await this._withTimeout(this._hass.connection.sendMessagePromise({
@@ -19353,9 +19353,9 @@ function createHomeiiBaseMusicCard({
         this._resolvedConfigEntryId = preferred?.entry_id || "";
         this._resolvedConfigEntryState = String(preferred?.state || "").trim();
         if (!this._resolvedConfigEntryId || preferred?.state && preferred.state !== "loaded") {
-          if (this._hasMusicAssistantServiceSignal()) {
+          if (this._resolvedConfigEntryId && this._hasMusicAssistantServiceSignal()) {
             this._state.musicAssistantIssueMessage = "";
-            return "";
+            return this._resolvedConfigEntryId;
           }
           this._handleMusicAssistantIssue(preferred?.state ? `Music Assistant entry ${preferred.state}` : this._musicAssistantSetupMessage());
           return "";
@@ -19442,9 +19442,7 @@ function createHomeiiBaseMusicCard({
     }
     async _fetchMusicAssistantQueueSnapshot(player) {
       if (!player?.entity_id) return null;
-      const queueId = this._queueIdForPlayer(player);
       const payload = { entity_id: player.entity_id };
-      if (queueId) payload.queue_id = queueId;
       const snapshot = await this._callService("get_queue", payload, { includeConfigEntryId: false });
       return this._normalizeQueueSnapshot(snapshot, player.entity_id);
     }
@@ -25998,9 +25996,9 @@ function ensureHaEditorComponents() {
   } catch (_) {
   }
 }
-const HOMEII_CARD_VERSION = "5.8.2-beta.7";
-const HOMEII_BROWSER_EDITOR_TAG = "homeii-music-flow-browser-editor-v5827";
-const HOMEII_MOBILE_EDITOR_TAG = "homeii-music-flow-editor-v5827";
+const HOMEII_CARD_VERSION = "5.8.2-beta.8";
+const HOMEII_BROWSER_EDITOR_TAG = "homeii-music-flow-browser-editor-v5828";
+const HOMEII_MOBILE_EDITOR_TAG = "homeii-music-flow-editor-v5828";
 const AMBIENT_LIGHT_PAIR_PLAYER_PREFIX = "__homeii_ambient_light_pair_player_";
 const AMBIENT_LIGHT_PAIR_LIGHTS_PREFIX = "__homeii_ambient_light_pair_lights_";
 const HomeiiEditorLocale = Object.freeze({
@@ -55007,6 +55005,9 @@ class HomeiiMusicFlowBaseCard extends HomeiiBaseMusicCard {
     if (!markers.length) markers.push("no strict MA markers");
     return markers.join(", ");
   }
+  _diagnosticIsStrictMusicAssistantPlayer(player = null, hassEntities = this._hass?.entities || {}) {
+    return !!(this._isDirectMaPlayer?.(player) || HomeiiPlayersFoundation.isMusicAssistantPlayer(player, hassEntities?.[player?.entity_id]));
+  }
   async _diagnosticQueueRows(add, selectedPlayer = null) {
     if (!selectedPlayer) {
       add("fail", "Queue snapshot", "No selected player is available, so queue checks cannot run.");
@@ -55041,7 +55042,9 @@ class HomeiiMusicFlowBaseCard extends HomeiiBaseMusicCard {
     } else if (best) {
       add("warn", "Queue snapshot", `${detail}. Queue API is reachable but returned no items; this can be normal for an idle/empty queue.`);
     } else {
-      add("fail", "Queue snapshot", detail);
+      const strictPlayer = this._diagnosticIsStrictMusicAssistantPlayer(selectedPlayer);
+      const fallbackPlayer = !strictPlayer && this._isGenericMusicAssistantFallbackPlayer?.(selectedPlayer);
+      add(fallbackPlayer && !queueId ? "warn" : "fail", "Queue snapshot", fallbackPlayer && !queueId ? `${detail}. The selected player is using the generic HA fallback and has no active_queue/queue_id, so Home Assistant may not be able to resolve a Music Assistant queue for it.` : detail);
     }
     const queueItems = Array.isArray(best?.snapshot?.items) ? best.snapshot.items : [];
     if (!queueItems.length) {
@@ -55236,10 +55239,10 @@ class HomeiiMusicFlowBaseCard extends HomeiiBaseMusicCard {
       add("fail", "Selected player", "No selected player is available.");
     } else {
       const selectedName = selectedPlayer.attributes?.friendly_name || selectedPlayer.entity_id || "";
-      const selectedIsMa = this._isMusicAssistantPlayer(selectedPlayer);
-      const selectedFallback = !selectedIsMa && this._isGenericMusicAssistantFallbackPlayer?.(selectedPlayer);
+      const selectedStrictMa = this._diagnosticIsStrictMusicAssistantPlayer(selectedPlayer, hassEntities);
+      const selectedFallback = !selectedStrictMa && this._isGenericMusicAssistantFallbackPlayer?.(selectedPlayer);
       const excluded = this._isPlayerExcluded?.(selectedPlayer);
-      add((selectedIsMa || selectedFallback) && !excluded ? "ok" : "warn", "Selected player", excluded ? "The selected player is currently excluded in HOMEii settings." : selectedIsMa ? "Selected player has Music Assistant markers." : selectedFallback ? "Selected player has no strict MA markers, but integration fallback can use it." : "Selected player does not look usable for Music Assistant.", `${selectedName} | ${this._diagnosticPlayerMarkerSummary(selectedPlayer, hassEntities)}`);
+      add((selectedStrictMa || selectedFallback) && !excluded ? "ok" : "warn", "Selected player", excluded ? "The selected player is currently excluded in HOMEii settings." : selectedStrictMa ? "Selected player has strict Music Assistant markers." : selectedFallback ? "Selected player has no strict MA markers; HOMEii is using the generic Home Assistant fallback." : "Selected player does not look usable for Music Assistant.", `${selectedName} | ${this._diagnosticPlayerMarkerSummary(selectedPlayer, hassEntities)}`);
     }
     if (!maUrl) {
       add(hasIntegrationServices ? "ok" : "info", "ma_url", "Empty is OK for the normal Home Assistant integration path. Direct API and Sendspin need a separate direct Music Assistant URL.", "(empty)");

dist/localization/index.js

@@ -1,11 +1,11 @@
-import en from "./en.js?v=5.8.2-beta.7-8468eb524b";
-import da from "./da.js?v=5.8.2-beta.7-7f86f3e425";
-import es from "./es.js?v=5.8.2-beta.7-16e5cabf8e";
-import fr from "./fr.js?v=5.8.2-beta.7-53901fc467";
-import he from "./he.js?v=5.8.2-beta.7-10e3feafaa";
-import it from "./it.js?v=5.8.2-beta.7-f7b021fce1";
-import lt from "./lt.js?v=5.8.2-beta.7-f34c389d46";
-import zh from "./zh.js?v=5.8.2-beta.7-a33bc98f49";
+import en from "./en.js?v=5.8.2-beta.8-8468eb524b";
+import da from "./da.js?v=5.8.2-beta.8-7f86f3e425";
+import es from "./es.js?v=5.8.2-beta.8-16e5cabf8e";
+import fr from "./fr.js?v=5.8.2-beta.8-53901fc467";
+import he from "./he.js?v=5.8.2-beta.8-10e3feafaa";
+import it from "./it.js?v=5.8.2-beta.8-f7b021fce1";
+import lt from "./lt.js?v=5.8.2-beta.8-f34c389d46";
+import zh from "./zh.js?v=5.8.2-beta.8-a33bc98f49";
 
 export const DEFAULT_LANGUAGE = "en";
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "homeii-music-flow",
-  "version": "5.8.2-beta.7",
+  "version": "5.8.2-beta.8",
   "description": "Premium Home Assistant Music Assistant dashboard card with a mobile-first visual player and built-in editor.",
   "private": true,
   "license": "MIT",

src/core/base-music-card.js

@@ -1095,7 +1095,7 @@ export function createHomeiiBaseMusicCard({
     _versionedAssetUrl(url) {
       const value = String(url || "").trim();
       if (!value || /^data:/i.test(value) || /[?&]v=/.test(value)) return value;
-      const version = typeof HOMEII_CARD_VERSION === "string" ? HOMEII_CARD_VERSION : "5.8.2-beta.7";
+      const version = typeof HOMEII_CARD_VERSION === "string" ? HOMEII_CARD_VERSION : "5.8.2-beta.8";
       return `${value}${value.includes("?") ? "&" : "?"}v=${encodeURIComponent(version)}`;
     }
 
@@ -10071,7 +10071,9 @@ export function createHomeiiBaseMusicCard({
         return explicit;
       }
       if (this._resolvedConfigEntryId && !force) {
-        return this._hasUsableMusicAssistantConfigEntry() ? this._resolvedConfigEntryId : "";
+        return (this._hasUsableMusicAssistantConfigEntry() || this._hasMusicAssistantServiceSignal())
+          ? this._resolvedConfigEntryId
+          : "";
       }
       try {
         const entries = await this._withTimeout(this._hass.connection.sendMessagePromise({
@@ -10086,9 +10088,9 @@ export function createHomeiiBaseMusicCard({
         this._resolvedConfigEntryId = preferred?.entry_id || "";
         this._resolvedConfigEntryState = String(preferred?.state || "").trim();
         if (!this._resolvedConfigEntryId || preferred?.state && preferred.state !== "loaded") {
-          if (this._hasMusicAssistantServiceSignal()) {
+          if (this._resolvedConfigEntryId && this._hasMusicAssistantServiceSignal()) {
             this._state.musicAssistantIssueMessage = "";
-            return "";
+            return this._resolvedConfigEntryId;
           }
           this._handleMusicAssistantIssue(preferred?.state ? `Music Assistant entry ${preferred.state}` : this._musicAssistantSetupMessage());
           return "";
@@ -10220,9 +10222,7 @@ export function createHomeiiBaseMusicCard({
 
     async _fetchMusicAssistantQueueSnapshot(player) {
       if (!player?.entity_id) return null;
-      const queueId = this._queueIdForPlayer(player);
       const payload = { entity_id: player.entity_id };
-      if (queueId) payload.queue_id = queueId;
       const snapshot = await this._callService("get_queue", payload, { includeConfigEntryId: false });
       return this._normalizeQueueSnapshot(snapshot, player.entity_id);
     }