From e033d2f8080b5e12300f36aacaaa92829a0cbd51 Mon Sep 17 00:00:00 2001
From: Allan Otodi Opeto <103313919+AllanOXDi@users.noreply.github.com>
Date: Fri, 27 Feb 2026 20:43:16 +0300
Subject: [PATCH] add channel version history to publish side panel

---
 .../sidePanels/ChannelVersionHistory.vue      | 244 ++++++++++++++++++
 .../sidePanels/PublishSidePanel.vue           |   7 +
 .../__tests__/PublishSidePanel.spec.js        |   5 +
 .../composables/useChannelVersionHistory.js   | 109 ++++++++
 .../strings/communityChannelsStrings.js       |  21 ++
 5 files changed, 386 insertions(+)
 create mode 100644 contentcuration/contentcuration/frontend/channelEdit/components/sidePanels/ChannelVersionHistory.vue
 create mode 100644 contentcuration/contentcuration/frontend/shared/composables/useChannelVersionHistory.js

diff --git a/contentcuration/contentcuration/frontend/channelEdit/components/sidePanels/ChannelVersionHistory.vue b/contentcuration/contentcuration/frontend/channelEdit/components/sidePanels/ChannelVersionHistory.vue
new file mode 100644
index 0000000000..924e15655c
--- /dev/null
+++ b/contentcuration/contentcuration/frontend/channelEdit/components/sidePanels/ChannelVersionHistory.vue
@@ -0,0 +1,244 @@
+<template>
+
+  <div class="channel-version-history">
+    <div
+      v-if="!isExpanded"
+      class="toggle-section"
+    >
+      <KButton
+        appearance="basic-link"
+        :text="seeAllVersions$()"
+        @click="handleExpand"
+      />
+    </div>
+    <div
+      v-if="isExpanded"
+      class="versions-container"
+    >
+      <div
+        v-if="isLoading && versions.length === 0"
+        class="loading"
+      >
+        <KCircularLoader />
+      </div>
+
+      <div
+        v-else-if="error && versions.length === 0"
+        class="error"
+      >
+        {{ errorLoadingVersions$() }}
+      </div>
+
+      <div
+        v-else
+        class="versions-list"
+      >
+        <!-- Display each version -->
+        <div
+          v-for="version in versions"
+          :key="version.id"
+          class="version-item"
+        >
+          <span class="version-number">
+            {{ versionLabel$({ version: version.version }) }}
+          </span>
+          <div
+            v-if="version.version_notes"
+            class="version-description"
+          >
+            <div class="description-label">
+              {{ versionDescriptionLabel$() }}
+            </div>
+            <div class="description-body">
+              {{ version.version_notes }}
+            </div>
+          </div>
+        </div>
+
+        <!-- "Show more" button - shown when more versions available -->
+        <div
+          v-if="hasMore"
+          class="show-more-section"
+        >
+          <KButton
+            appearance="basic-link"
+            :text="showMore$()"
+            :disabled="isLoadingMore"
+            @click="handleShowMore"
+          />
+          <KCircularLoader
+            v-if="isLoadingMore"
+            class="inline-loader"
+          />
+          <div
+            v-if="error && versions.length > 0"
+            class="fetch-more-error"
+          >
+            {{ errorLoadingVersions$() }}
+          </div>
+        </div>
+
+        <div class="collapse-section">
+          <KButton
+            appearance="basic-link"
+            :text="seeLess$()"
+            @click="handleCollapse"
+          />
+        </div>
+      </div>
+    </div>
+  </div>
+
+</template>
+
+
+<script>
+
+  import { ref, watch } from 'vue';
+  import { useChannelVersionHistory } from 'shared/composables/useChannelVersionHistory';
+  import { communityChannelsStrings } from 'shared/strings/communityChannelsStrings';
+
+  export default {
+    name: 'ChannelVersionHistory',
+    setup(props) {
+      const isExpanded = ref(false);
+      const {
+        seeAllVersions$,
+        seeLess$,
+        showMore$,
+        versionLabel$,
+        errorLoadingVersions$,
+        versionDescriptionLabel$,
+      } = communityChannelsStrings;
+
+      const {
+        versions,
+        isLoading,
+        isLoadingMore,
+        error,
+        hasMore,
+        fetchVersions,
+        fetchMore,
+        reset,
+      } = useChannelVersionHistory();
+
+      watch(
+        () => props.channelId,
+        (newChannelId, oldChannelId) => {
+          if (newChannelId !== oldChannelId) {
+            reset();
+            isExpanded.value = false;
+          }
+        },
+      );
+
+      const handleExpand = async () => {
+        isExpanded.value = true;
+        if (versions.value.length === 0) {
+          await fetchVersions(props.channelId);
+        }
+      };
+      const handleCollapse = () => {
+        isExpanded.value = false;
+      };
+      const handleShowMore = async () => {
+        await fetchMore();
+      };
+
+      return {
+        isExpanded,
+        versions,
+        isLoading,
+        isLoadingMore,
+        error,
+        hasMore,
+        handleExpand,
+        handleCollapse,
+        handleShowMore,
+        seeAllVersions$,
+        seeLess$,
+        showMore$,
+        versionLabel$,
+        errorLoadingVersions$,
+        versionDescriptionLabel$,
+      };
+    },
+    props: {
+      channelId: {
+        type: String,
+        required: true,
+      },
+    },
+  };
+
+</script>
+
+
+<style scoped lang="scss">
+
+  .channel-version-history {
+    margin-top: 16px;
+
+    .toggle-section {
+      margin: 8px 0;
+    }
+
+    .versions-container {
+      .loading,
+      .error {
+        padding: 8px 0;
+        text-align: center;
+      }
+
+      .versions-list {
+        .version-item {
+          padding: 12px 0;
+          border-bottom: 1px solid #e0e0e0;
+
+          .version-number {
+            font-weight: 500;
+          }
+
+          .version-description {
+            padding: 12px;
+            margin-top: 8px;
+            background-color: #f5f5f5;
+            border-radius: 6px;
+
+            .description-label {
+              margin-bottom: 6px;
+              font-weight: 600;
+            }
+
+            .description-body {
+              line-height: 1.4;
+              color: #4a4a4a;
+            }
+          }
+        }
+
+        .show-more-section {
+          display: flex;
+          gap: 8px;
+          align-items: center;
+          margin: 8px 0;
+
+          .inline-loader {
+            width: 20px;
+            height: 20px;
+          }
+
+          .fetch-more-error {
+            font-size: 14px;
+            color: #d32f2f;
+          }
+        }
+
+        .collapse-section {
+          margin: 8px 0;
+        }
+      }
+    }
+  }
+
+</style>
diff --git a/contentcuration/contentcuration/frontend/channelEdit/components/sidePanels/PublishSidePanel.vue b/contentcuration/contentcuration/frontend/channelEdit/components/sidePanels/PublishSidePanel.vue
index f16745cd5e..85081ffec8 100644
--- a/contentcuration/contentcuration/frontend/channelEdit/components/sidePanels/PublishSidePanel.vue
+++ b/contentcuration/contentcuration/frontend/channelEdit/components/sidePanels/PublishSidePanel.vue
@@ -74,6 +74,11 @@
                       @blur="isLanguageSelectBlurred = true"
                     />
                   </div>
+
+                  <ChannelVersionHistory
+                    v-if="currentChannel"
+                    :channelId="currentChannel.id"
+                  />
                 </div>
               </div>
 
@@ -154,6 +159,7 @@
 <script>
 
   import { ref, computed, getCurrentInstance } from 'vue';
+  import ChannelVersionHistory from './ChannelVersionHistory.vue';
   import SidePanelModal from 'shared/views/SidePanelModal';
   import { Channel, CommunityLibrarySubmission } from 'shared/data/resources';
   import { forceServerSync } from 'shared/data/serverSync';
@@ -165,6 +171,7 @@
     name: 'PublishSidePanel',
     components: {
       SidePanelModal,
+      ChannelVersionHistory,
     },
     setup(props, { emit }) {
       const PublishModes = {
diff --git a/contentcuration/contentcuration/frontend/channelEdit/components/sidePanels/__tests__/PublishSidePanel.spec.js b/contentcuration/contentcuration/frontend/channelEdit/components/sidePanels/__tests__/PublishSidePanel.spec.js
index 0d95fff1ea..cece3ca086 100644
--- a/contentcuration/contentcuration/frontend/channelEdit/components/sidePanels/__tests__/PublishSidePanel.spec.js
+++ b/contentcuration/contentcuration/frontend/channelEdit/components/sidePanels/__tests__/PublishSidePanel.spec.js
@@ -391,4 +391,9 @@ describe('PublishSidePanel', () => {
     await fireEvent.click(cancelBtn);
     expect(emitted().close).toBeTruthy();
   });
+
+  it('renders ChannelVersionHistory component', () => {
+    renderComponent();
+    expect(screen.getByText(communityChannelsStrings.seeAllVersions$())).toBeInTheDocument();
+  });
 });
diff --git a/contentcuration/contentcuration/frontend/shared/composables/useChannelVersionHistory.js b/contentcuration/contentcuration/frontend/shared/composables/useChannelVersionHistory.js
new file mode 100644
index 0000000000..e6646fb130
--- /dev/null
+++ b/contentcuration/contentcuration/frontend/shared/composables/useChannelVersionHistory.js
@@ -0,0 +1,109 @@
+import { ref } from 'vue';
+import { ChannelVersion } from 'shared/data/resources';
+
+export const VERSIONS_PER_PAGE = 10;
+
+/**
+ * Composable that fetches and manages paginated channel versions
+ *
+ * @returns {{
+ *   versions: import('vue').Ref<Array<Object>>,
+ *   isLoading: import('vue').Ref<boolean>,
+ *   isLoadingMore: import('vue').Ref<boolean>,
+ *   error: import('vue').Ref<Error|null>,
+ *   hasMore: import('vue').Ref<boolean>,
+ *   currentPage: import('vue').Ref<number>,
+ *   fetchVersions: (channelId: string) => Promise<void>,
+ *   fetchMore: () => Promise<void>,
+ * }}
+ */
+export function useChannelVersionHistory() {
+  const versions = ref([]);
+  const isLoading = ref(false);
+  const isLoadingMore = ref(false);
+  const error = ref(null);
+  const hasMore = ref(false);
+  const currentPage = ref(0);
+  const currentChannelId = ref(null);
+
+  /**
+   * Fetch first page of versions for a channel
+   * @param {string} channelId - The channel ID to fetch versions for
+   */
+  async function fetchVersions(channelId) {
+    isLoading.value = true;
+    error.value = null;
+    versions.value = [];
+    currentPage.value = 0;
+    currentChannelId.value = channelId;
+
+    try {
+      const response = await ChannelVersion.fetchCollection({
+        channel: channelId,
+        page_size: VERSIONS_PER_PAGE,
+        page: 1,
+      });
+
+      versions.value = response.results || [];
+      currentPage.value = 1;
+
+      // Check if there are more pages
+      // response.next will be null if no more pages
+      hasMore.value = response.next !== null;
+    } catch (err) {
+      error.value = err;
+      versions.value = [];
+    } finally {
+      isLoading.value = false;
+    }
+  }
+
+  async function fetchMore() {
+    if (!hasMore.value || isLoadingMore.value || !currentChannelId.value) {
+      return;
+    }
+
+    isLoadingMore.value = true;
+    error.value = null;
+
+    try {
+      const nextPage = currentPage.value + 1;
+      const response = await ChannelVersion.fetchCollection({
+        channel: currentChannelId.value,
+        page_size: VERSIONS_PER_PAGE,
+        page: nextPage,
+      });
+
+      versions.value = [...versions.value, ...(response.results || [])];
+      currentPage.value = nextPage;
+
+      hasMore.value = response.next !== null;
+    } catch (err) {
+      error.value = err;
+    } finally {
+      isLoadingMore.value = false;
+    }
+  }
+
+  function reset() {
+    versions.value = [];
+    isLoading.value = false;
+    isLoadingMore.value = false;
+    error.value = null;
+    hasMore.value = false;
+    currentPage.value = 0;
+    currentChannelId.value = null;
+  }
+
+  return {
+    versions,
+    isLoading,
+    isLoadingMore,
+    error,
+    hasMore,
+    currentPage,
+    fetchVersions,
+    fetchMore,
+    reset,
+  };
+}
diff --git a/contentcuration/contentcuration/frontend/shared/strings/communityChannelsStrings.js b/contentcuration/contentcuration/frontend/shared/strings/communityChannelsStrings.js
index 53ee27edfa..d76d48a06f 100644
--- a/contentcuration/contentcuration/frontend/shared/strings/communityChannelsStrings.js
+++ b/contentcuration/contentcuration/frontend/shared/strings/communityChannelsStrings.js
@@ -77,6 +77,27 @@ export const communityChannelsStrings = createTranslator('CommunityChannelsStrin
     message: 'Language is required',
     context: 'Error message when language selection is required but not provided',
   },
+  // Channel version history strings
+  seeAllVersions: {
+    message: 'See all versions',
+    context: 'Button text to expand and show channel version history',
+  },
+  seeLess: {
+    message: 'See less',
+    context: 'Button text to collapse channel version history',
+  },
+  showMore: {
+    message: 'Show more',
+    context: 'Button text to load more channel versions',
+  },
+  versionLabel: {
+    message: 'Version {version}',
+    context: 'Label displaying a channel version number',
+  },
+  errorLoadingVersions: {
+    message: 'Unable to load version history',
+    context: 'Error message when channel versions fail to load',
+  },
   pendingStatus: {
     message: 'Submitted',
     context: 'Status indicating that an Community Library submission is pending',