feat(catalog): add support for displaying public labels

cypress/e2e/specs/catalog.spec.ts

@@ -1,5 +1,6 @@
 import { ProductCatalogIndexSourceLatestVersion, SearchResults, SearchResultsDataInner } from '@kong/sdk-portal-js'
 import { generateProducts } from '../support/utils/generateProducts'
+import { FeatureFlags } from '@/constants/feature-flags'
 
 const mockProductSearchQuery = (searchQuery: string) => {
   const searchResults: SearchResultsDataInner[] = ([
@@ -25,7 +26,8 @@ const mockProductSearchQuery = (searchQuery: string) => {
         latest_version: {
           name: versions[0],
           id: crypto.randomUUID()
-        }
+        },
+        public_labels: {}
       }
     }))
 
@@ -197,6 +199,105 @@ describe('Catalog', () => {
         cy.get('.k-table tbody td:nth-of-type(4) a').should('exist').should('contain', 'Documentation')
       })
     })
+
+    describe('Catalog Item Public Labels (feature flag enabled)', () => {
+      beforeEach(() => {
+        cy.mockPublicPortal()
+        cy.mockLaunchDarklyFlags([
+          { name: FeatureFlags.publicLabelsUI, value: true }
+        ])
+        cy.visit('/')
+        // click view toggle to table mode
+        cy.get('[data-testid="view-switcher"]:not(:disabled)').click()
+      })
+
+      it('renders public labels correctly', () => {
+        const productWithLabels = {
+          id: 'test-product',
+          title: 'Test Product',
+          description: 'A test product with public labels',
+          public_labels: {
+            category: 'test',
+            version: '1.0'
+          },
+          showSpecLink: true,
+          documentCount: 1,
+          latestVersion: { name: 'v1' }
+        }
+
+        cy.mockProductsCatalog(1, [productWithLabels])
+
+        cy.visit('/')
+
+        cy.get('.catalog-item').eq(0).within(() => {
+          // Check if the public labels section exists
+          cy.contains('Labels:').should('exist')
+
+          // Check if all public labels are rendered
+          cy.get('.product-public-label').should('have.length', 2)
+
+          // Check the content of each label
+          cy.get('.product-public-label').eq(0).should('contain', 'category: test')
+          cy.get('.product-public-label').eq(1).should('contain', 'version: 1.0')
+        })
+      })
+
+      it('does not render public labels section when product has no labels', () => {
+        const productWithoutLabels = {
+          id: 'test-product-no-labels',
+          title: 'Test Product Without Labels',
+          description: 'A test product without public labels',
+          public_labels: {},
+          showSpecLink: true,
+          documentCount: 1,
+          latestVersion: { name: 'v1' }
+        }
+
+        cy.mockProductsCatalog(1, [productWithoutLabels])
+
+        cy.visit('/')
+
+        cy.get('.catalog-item').eq(0).within(() => {
+          // Check that the public labels section does not exist
+          cy.contains('Labels:').should('not.exist')
+          cy.get('.product-public-label').should('not.exist')
+        })
+      })
+    })
+    describe('Catalog Item Public Labels (feature flag disabled)', () => {
+      beforeEach(() => {
+        cy.mockPublicPortal()
+        cy.mockLaunchDarklyFlags([
+          { name: FeatureFlags.publicLabelsUI, value: false }
+        ])
+        cy.visit('/')
+      })
+
+      it('renders no labels ', () => {
+        const productWithLabels = {
+          id: 'test-product',
+          title: 'Test Product',
+          description: 'A test product with public labels',
+          public_labels: {
+            category: 'test',
+            version: '1.0'
+          },
+          showSpecLink: true,
+          documentCount: 1,
+          latestVersion: { name: 'v1' }
+        }
+
+        cy.mockProductsCatalog(1, [productWithLabels])
+
+        cy.visit('/')
+
+        cy.get('.catalog-item').within(() => {
+          // Check if the public labels section exists
+          cy.contains('Labels:').should('not.exist')
+          cy.get('.product-public-label').should('not.exist')
+        })
+      })
+    })
   })
 
   describe('Catalog versions', () => {

package.json

@@ -36,7 +36,7 @@
     "@kong/kong-auth-elements": "2.12.6",
     "@kong/kongponents": "8.127.0",
     "@kong/markdown": "1.7.8",
-    "@kong/sdk-portal-js": "2.15.4",
+    "@kong/sdk-portal-js": "2.16.0",
     "@unhead/vue": "1.11.6",
     "@xstate/vue": "2.0.0",
     "axios": "1.6.7",

src/components/CatalogItem.vue

@@ -18,9 +18,7 @@
     </template>
     <template #body>
       <p class="description color-text_colors-secondary">
-        <template
-          v-if="loading"
-        >
+        <template v-if="loading">
           <KSkeletonBox width="100" />
           <KSkeletonBox width="50" />
           <KSkeletonBox width="75" />
@@ -35,9 +33,7 @@
             v-if="version"
             class="my-2 color-text_colors-secondary"
           >
-            <template
-              v-if="loading"
-            >
+            <template v-if="loading">
               <KSkeletonBox width="2" />
             </template>
             <template v-else>
@@ -52,6 +48,33 @@
             </template>
           </span>
         </li>
+        <li
+          v-if="publicLabelsUIEnabled"
+          class="details-item"
+        >
+          <span
+            v-if="product.publicLabels.length"
+            class="my-2 color-text_colors-secondary"
+          >
+            <template v-if="loading">
+              <KSkeletonBox width="2" />
+            </template>
+            <template v-else>
+              <span class="mr-2">{{ helpText.publicLabels }}</span>
+              <div>
+                <KBadge
+                  v-for="label in product.publicLabels"
+                  :key="label.key"
+                  color="var(--text_colors-secondary)"
+                  background-color="var(--section_colors-accent)"
+                  class="product-public-label"
+                >
+                  {{ label.key }}: {{ label.value }}
+                </KBadge>
+              </div>
+            </template>
+          </span>
+        </li>
         <li class="docs-links">
           <div
             v-if="product.showSpecLink"
@@ -104,6 +127,8 @@
 </template>
 
 <script lang="ts">
+import { FeatureFlags } from '@/constants/feature-flags'
+import useLDFeatureFlag from '@/hooks/useLDFeatureFlag'
 import { CatalogItemModel, useI18nStore } from '@/stores'
 import { PropType } from 'vue'
 
@@ -122,8 +147,12 @@ export default {
   data () {
     const helpText = useI18nStore().state.helpText.catalogItem
 
+    // check for feature flag
+    const publicLabelsUIEnabled = useLDFeatureFlag(FeatureFlags.publicLabelsUI, false)
+
     return {
-      helpText
+      helpText,
+      publicLabelsUIEnabled
     }
   },
   computed: {

src/components/CatalogTableList.vue

@@ -14,6 +14,22 @@
       <template #title="{ rowValue }">
         {{ rowValue }}
       </template>
+      <template #publicLabels="{ row }">
+        <div v-if="publicLabelsUIEnabled">
+          <div
+            v-for="label in row.publicLabels"
+            :key="label.key"
+          >
+            <KBadge
+              color="var(--text_colors-secondary)"
+              background-color="var(--section_colors-accent)"
+              class="product-version"
+            >
+              {{ label.key }}: {{ label.value }}
+            </KBadge>
+          </div>
+        </div>
+      </template>
       <template #latestVersion="{ row }">
         <div>
           <KBadge
@@ -47,6 +63,8 @@
 </template>
 
 <script lang="ts">
+import { FeatureFlags } from '@/constants/feature-flags'
+import useLDFeatureFlag from '@/hooks/useLDFeatureFlag'
 import { useI18nStore, CatalogItemModel } from '@/stores'
 import { defineComponent, ref, computed, watch, PropType } from 'vue'
 import { useRouter } from 'vue-router'
@@ -95,11 +113,15 @@ export default defineComponent({
     }
   },
   data () {
+    const publicLabelsUIEnabled = useLDFeatureFlag(FeatureFlags.publicLabelsUI, false)
+
     return {
+      publicLabelsUIEnabled,
       tableHeaders: [
         { label: 'Title', key: 'title' },
         { label: 'Description', key: 'description' },
         { label: 'Latest Version', key: 'latestVersion' },
+        { label: 'Labels', key: 'publicLabels' },
         { label: 'Details', key: 'links' }
       ]
     }

src/constants/feature-flags.ts

@@ -1,3 +1,4 @@
 export enum FeatureFlags {
   newMarkdownRender = 'tdx-4186-new-markdown',
+  publicLabelsUI = 'tdx-4824-public-labels-ui'
 }

src/locales/ca_ES.ts

@@ -256,7 +256,8 @@ export const ca_ES: I18nType = {
   catalogItem: {
     latestVersion: 'Última versió:',
     specificationLink: 'Especificació',
-    documentationLink: 'Documentació'
+    documentationLink: 'Documentació',
+    publicLabels: translationNeeded(en.catalogItem.publicLabels)
   },
   catalogTable: {
     specificationLink: 'Especificació',

src/locales/de.ts

@@ -256,7 +256,8 @@ export const de: I18nType = {
   catalogItem: {
     latestVersion: 'Aktuelle Version:',
     specificationLink: 'Spezifikation',
-    documentationLink: 'Dokumentation'
+    documentationLink: 'Dokumentation',
+    publicLabels: translationNeeded(en.catalogItem.publicLabels)
   },
   catalogTable: {
     specificationLink: 'Spezifikation',

src/locales/en.ts

@@ -251,6 +251,7 @@ export const en = {
   },
   catalogItem: {
     latestVersion: 'Latest Version:',
+    publicLabels: 'Labels:',
     specificationLink: 'Specification',
     documentationLink: 'Documentation'
   },

src/locales/es_ES.ts

@@ -256,7 +256,8 @@ export const es_ES: I18nType = {
   catalogItem: {
     latestVersion: 'Última versión: ',
     specificationLink: 'Especificación',
-    documentationLink: 'Documentación'
+    documentationLink: 'Documentación',
+    publicLabels: translationNeeded(en.catalogItem.publicLabels)
   },
   catalogTable: {
     specificationLink: 'Especificación',

src/locales/fr.ts

@@ -256,7 +256,8 @@ export const fr: I18nType = {
   catalogItem: {
     latestVersion: 'Dernière version :',
     specificationLink: 'Spécification',
-    documentationLink: 'Documentation'
+    documentationLink: 'Documentation',
+    publicLabels: translationNeeded(en.catalogItem.publicLabels)
   },
   catalogTable: {
     specificationLink: 'Spécification',

src/locales/i18n-type.d.ts

@@ -251,6 +251,7 @@ export interface I18nType {
   };
   catalogItem: {
     latestVersion: string;
+    publicLabels: string;
     specificationLink: string;
     documentationLink: string;
   };

src/stores/product.ts

@@ -14,6 +14,7 @@ export interface CatalogItemModel {
   description: string;
   documentCount: number;
   versionCount: number;
+  publicLabels: Array<{key: string; value: string}>;
 }
 
 export type CustomOperation = Operation & {tag?: string}

src/views/ProductCatalogWrapper.vue

@@ -152,14 +152,25 @@ export default defineComponent({
               })
             }
 
+            // convert source public_labels from key/value to array
+            const publicLabels = source.public_labels
+              ? Object.entries(source.public_labels).map(([key, value]) => {
+                return {
+                  key,
+                  value
+                }
+              })
+              : []
+
             return {
               id: source.id,
               title: source.name,
               latestVersion: source.latest_version,
               showSpecLink,
               description: source.description,
               documentCount: source.document_count,
-              versionCount: source.version_count
+              versionCount: source.version_count,
+              publicLabels
             }
           }))
           totalCount.value = meta.page.total