From 61740bf08dea76b20bece8471fe140f5c059ce3f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dav=C3=AD=C3=B0=20Steinar?= <davidsteinar@gmail.com>
Date: Thu, 14 May 2026 17:10:18 +0200
Subject: [PATCH] Enable episode deep linking via episodeId

Wire episodeId query parameter through item links and search results,
and preselect/show the corresponding episode on item page load.
---
 client/components/cards/LazyBookCard.vue    |  1 +
 client/components/controls/GlobalSearch.vue |  2 +-
 client/pages/item/_id/index.vue             | 10 ++++++++++
 3 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/client/components/cards/LazyBookCard.vue b/client/components/cards/LazyBookCard.vue
index 51f657dbc..2258c306c 100644
--- a/client/components/cards/LazyBookCard.vue
+++ b/client/components/cards/LazyBookCard.vue
@@ -711,6 +711,7 @@ export default {
         var router = this.$router || this.$nuxt.$router
         if (router) {
           if (this.collapsedSeries) router.push(`/library/${this.libraryId}/series/${this.collapsedSeries.id}`)
+          else if (this.recentEpisode) router.push(`/item/${this.libraryItemId}?episodeId=${this.recentEpisode.id}`)
           else router.push(`/item/${this.libraryItemId}`)
         }
       }
diff --git a/client/components/controls/GlobalSearch.vue b/client/components/controls/GlobalSearch.vue
index 6f3a819bf..c70c8ce8c 100644
--- a/client/components/controls/GlobalSearch.vue
+++ b/client/components/controls/GlobalSearch.vue
@@ -42,7 +42,7 @@
           <p v-if="episodeResults.length" class="uppercase text-xs text-gray-400 my-1 px-1 font-semibold">{{ $strings.LabelEpisodes }}</p>
           <template v-for="item in episodeResults">
             <li :key="item.libraryItem.recentEpisode.id" class="text-gray-50 select-none relative cursor-pointer hover:bg-black-400 py-1" role="option" @click="clickOption">
-              <nuxt-link :to="`/item/${item.libraryItem.id}`">
+              <nuxt-link :to="`/item/${item.libraryItem.id}?episodeId=${item.libraryItem.recentEpisode.id}`">
                 <cards-episode-search-card :episode="item.libraryItem.recentEpisode" :library-item="item.libraryItem" />
               </nuxt-link>
             </li>
diff --git a/client/pages/item/_id/index.vue b/client/pages/item/_id/index.vue
index 1d8f0f20b..205140554 100644
--- a/client/pages/item/_id/index.vue
+++ b/client/pages/item/_id/index.vue
@@ -785,6 +785,16 @@ export default {
     this.episodeDownloadsQueued = this.libraryItem.episodeDownloadsQueued || []
     this.episodesDownloading = this.libraryItem.episodesDownloading || []
 
+    const episodeId = this.$route.query.episodeId
+    if (episodeId) {
+      const episode = this.podcastEpisodes.find((ep) => ep.id === episodeId)
+      if (episode) {
+        this.$store.commit('setSelectedLibraryItem', this.libraryItem)
+        this.$store.commit('globals/setSelectedEpisode', episode)
+        this.$store.commit('globals/setShowViewPodcastEpisodeModal', true)
+      }
+    }
+
     this.$eventBus.$on(`${this.libraryItem.id}_updated`, this.libraryItemUpdated)
     this.$root.socket.on('item_updated', this.libraryItemUpdated)
     this.$root.socket.on('rss_feed_open', this.rssFeedOpen)