Add unit test for new utility social share card helper and for refactored meta utilities

Author: webstackdev

.cache/pages.json

@@ -22,10 +22,16 @@
   "contact",
   "offline",
   {
-    "privacy": ["my-data"]
+    "privacy": [
+      "my-data"
+    ]
   },
   {
-    "services": ["consulting", "overview", "web-development"]
+    "services": [
+      "consulting",
+      "overview",
+      "web-development"
+    ]
   },
   {
     "tags": [
@@ -47,4 +53,4 @@
       "typescript"
     ]
   }
-]
+]

src/components/Head/server/__tests__/meta.spec.ts

@@ -0,0 +1,66 @@
+import { afterEach, describe, expect, it, vi } from 'vitest'
+const loadMetaModule = async () => {
+  const module = await import('../meta')
+  return module.getMetaThemeData
+}
+
+const loadBuildError = async () => {
+  const module = await import('@lib/errors/BuildError')
+  return module.BuildError
+}
+
+describe('getMetaThemeData', () => {
+  afterEach(() => {
+    vi.resetModules()
+    vi.doUnmock('@content/themes.json')
+  })
+
+  it('returns the theme that matches the configured default id', async () => {
+    vi.doMock('@content/themes.json', () => ({
+      default: {
+        defaultTheme: { id: 'midnight', prefersDarkScheme: true },
+        themes: [
+          { id: 'sunrise', colors: { backgroundOffset: '#ffeeaa' } },
+          { id: 'midnight', colors: { backgroundOffset: '#001133' } },
+        ],
+      },
+    }))
+
+    const getMetaThemeData = await loadMetaModule()
+    const theme = getMetaThemeData()
+
+    expect(theme.id).toBe('midnight')
+    expect(theme.colors?.backgroundOffset).toBe('#001133')
+  })
+
+  it('falls back to the first configured theme when the default id is missing', async () => {
+    vi.doMock('@content/themes.json', () => ({
+      default: {
+        defaultTheme: { id: 'nonexistent', prefersDarkScheme: false },
+        themes: [
+          { id: 'primary', colors: { backgroundOffset: '#ffffff' } },
+          { id: 'secondary', colors: { backgroundOffset: '#000000' } },
+        ],
+      },
+    }))
+
+    const getMetaThemeData = await loadMetaModule()
+    expect(getMetaThemeData().id).toBe('primary')
+  })
+
+  it('throws a BuildError when no themes are configured', async () => {
+    vi.doMock('@content/themes.json', () => ({
+      default: {
+        defaultTheme: { id: 'anything', prefersDarkScheme: false },
+        themes: [],
+      },
+    }))
+
+    const getMetaThemeData = await loadMetaModule()
+    const BuildError = await loadBuildError()
+    const call = () => getMetaThemeData()
+
+    expect(call).toThrow(BuildError)
+    expect(call).toThrow('No themes configured in themes.json; unable to set meta theme-color.')
+  })
+})

src/components/Head/server/__tests__/utils.spec.ts

@@ -0,0 +1,39 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { getSocialImageLink } from '../utils'
+import { getSiteUrl } from '@lib/config/siteUrlServer'
+
+vi.mock('@lib/config/siteUrlServer', () => ({
+  getSiteUrl: vi.fn(() => 'https://site.test'),
+}))
+
+const mockedGetSiteUrl = vi.mocked(getSiteUrl)
+
+describe('getSocialImageLink', () => {
+  beforeEach(() => {
+    mockedGetSiteUrl.mockClear()
+    mockedGetSiteUrl.mockReturnValue('https://site.test')
+  })
+
+  it('falls back to the home slug when no usable path is provided', () => {
+    expect(getSocialImageLink()).toBe('https://site.test/og/home.png')
+    expect(getSocialImageLink('   ')).toBe('https://site.test/og/home.png')
+    expect(mockedGetSiteUrl).toHaveBeenCalledTimes(2)
+  })
+
+  it('normalizes relative paths with redundant separators and whitespace', () => {
+    const url = getSocialImageLink('  /Articles//My  Feature / ')
+    expect(url).toBe('https://site.test/og/Articles/My-Feature.png')
+  })
+
+  it('parses absolute URLs and decodes their path segments', () => {
+    const url = getSocialImageLink('https://preview.example.com/services/Launch%20Plan///?src=home')
+    expect(url).toBe('https://site.test/og/services/Launch-Plan.png')
+  })
+
+  it('uses the site url value returned at call time', () => {
+    mockedGetSiteUrl.mockReturnValueOnce('https://custom.test')
+    const url = getSocialImageLink('about/company')
+    expect(url).toBe('https://custom.test/og/about/company.png')
+    expect(mockedGetSiteUrl).toHaveBeenCalledTimes(1)
+  })
+})