refactor(lib): consolidate metadata utilities and add data fetchers

Consolidate metadata utilities and add centralized data fetchers for better code organization.

Changes:
- Update metadata generators and helpers with improved type safety
- Remove deprecated seo-helpers.ts
- Add new data fetchers module (src/lib/data/fetchers.ts) for centralized data fetching with React cache()
- Update license component with new i18n structure
- Remove generated backup directories:
  - src/lib/generated.backup/**
  - src/lib/generated.formatted/**

These changes improve maintainability and align with the new i18n architecture.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ericyangpan

src/lib/data/fetchers.ts

@@ -0,0 +1,118 @@
+import { cache } from 'react'
+import type { Locale } from '@/i18n/config'
+import {
+  clisData,
+  extensionsData,
+  idesData,
+  modelsData,
+  providersData,
+  vendorsData,
+} from '@/lib/generated'
+import { getArticleBySlug } from '@/lib/generated/articles'
+import { getDocBySlug } from '@/lib/generated/docs'
+import { localizeManifestItem } from '@/lib/manifest-i18n'
+import type {
+  ManifestCLI,
+  ManifestExtension,
+  ManifestIDE,
+  ManifestModel,
+  ManifestProvider,
+  ManifestVendor,
+} from '@/types/manifests'
+
+/**
+ * Cached fetcher for IDE data
+ * Uses React cache() to prevent duplicate fetching in generateMetadata and page component
+ */
+export const getIDE = cache(async (slug: string, locale: Locale) => {
+  const ideRaw = idesData.find(i => i.id === slug)
+  if (!ideRaw) return null
+
+  return localizeManifestItem(
+    ideRaw as unknown as Record<string, unknown>,
+    locale
+  ) as unknown as ManifestIDE
+})
+
+/**
+ * Cached fetcher for CLI data
+ * Uses React cache() to prevent duplicate fetching in generateMetadata and page component
+ */
+export const getCLI = cache(async (slug: string, locale: Locale) => {
+  const cliRaw = clisData.find(c => c.id === slug)
+  if (!cliRaw) return null
+
+  return localizeManifestItem(
+    cliRaw as unknown as Record<string, unknown>,
+    locale
+  ) as unknown as ManifestCLI
+})
+
+/**
+ * Cached fetcher for Model data
+ * Models don't require localization, so no locale parameter needed
+ * Uses React cache() to prevent duplicate fetching in generateMetadata and page component
+ */
+export const getModel = cache(async (slug: string) => {
+  return (modelsData.find(m => m.id === slug) as unknown as ManifestModel) || null
+})
+
+/**
+ * Cached fetcher for Extension data
+ * Uses React cache() to prevent duplicate fetching in generateMetadata and page component
+ */
+export const getExtension = cache(async (slug: string, locale: Locale) => {
+  const extensionRaw = extensionsData.find(e => e.id === slug)
+  if (!extensionRaw) return null
+
+  return localizeManifestItem(
+    extensionRaw as unknown as Record<string, unknown>,
+    locale
+  ) as unknown as ManifestExtension
+})
+
+/**
+ * Cached fetcher for Vendor data
+ * Uses React cache() to prevent duplicate fetching in generateMetadata and page component
+ */
+export const getVendor = cache(async (slug: string, locale: Locale) => {
+  const vendorRaw = vendorsData.find(v => v.id === slug)
+  if (!vendorRaw) return null
+
+  return localizeManifestItem(
+    vendorRaw as unknown as Record<string, unknown>,
+    locale
+  ) as unknown as ManifestVendor
+})
+
+/**
+ * Cached fetcher for Model Provider data
+ * Uses React cache() to prevent duplicate fetching in generateMetadata and page component
+ */
+export const getModelProvider = cache(async (slug: string, locale: Locale) => {
+  const providerRaw = providersData.find(p => p.id === slug)
+  if (!providerRaw) return null
+
+  return localizeManifestItem(
+    providerRaw as unknown as Record<string, unknown>,
+    locale
+  ) as unknown as ManifestProvider
+})
+
+/**
+ * Cached fetcher for Article data
+ * Articles are already locale-aware through getArticleBySlug
+ * Uses React cache() to prevent duplicate fetching in generateMetadata and page component
+ */
+export const getArticle = cache(async (slug: string, locale: string) => {
+  return getArticleBySlug(slug, locale)
+})
+
+/**
+ * Cached fetcher for Documentation data
+ * Docs are already locale-aware through getDocBySlug
+ * Uses React cache() to prevent duplicate fetching in generateMetadata and page component
+ */
+export const getDoc = cache(async (slug: string, locale: string) => {
+  return getDocBySlug(slug, locale)
+})

src/lib/license.tsx

@@ -9,7 +9,7 @@ import type { ReactElement } from 'react'
  */
 export function translateLicense(license: string, t: (key: string) => string): string {
   if (license.toLowerCase() === 'proprietary') {
-    return t('license.proprietary')
+    return t('shared.common.proprietary')
   }
   return license
 }

src/lib/metadata/generators.ts

@@ -24,7 +24,6 @@ import {
   buildTwitterCard,
   formatPlatforms,
   formatPriceForDescription,
-  getOGImagePath,
 } from './helpers'
 
 /**
@@ -151,24 +150,23 @@ export async function generateSoftwareDetailMetadata(options: {
     languageBasePath: basePath,
   })
 
-  // Build OpenGraph with product image
+  // Build OpenGraph
+  // Note: OG images are automatically detected from opengraph-image.tsx files
   const canonicalPath = locale === defaultLocale ? `/${basePath}` : `/${locale}/${basePath}`
-  const imagePath = getOGImagePath(category, slug)
 
   const openGraph = buildOpenGraph({
     title: `${product.name} - ${typeDescription}`,
     description: product.description,
     url: canonicalPath,
     locale,
     type: 'article',
-    images: [{ url: imagePath, alt: `${product.name} Screenshot` }],
   })
 
-  // Build Twitter Card with product image
+  // Build Twitter Card
+  // Note: Twitter images are automatically detected from opengraph-image.tsx files
   const twitter = buildTwitterCard({
     title: `${product.name} - ${typeDescription}`,
     description: product.description,
-    images: [imagePath],
   })
 
   return {
@@ -242,23 +240,22 @@ export async function generateModelDetailMetadata(options: {
   })
 
   // Build OpenGraph
+  // Note: OG images are automatically detected from opengraph-image.tsx files
   const canonicalPath = locale === defaultLocale ? `/${basePath}` : `/${locale}/${basePath}`
-  const imagePath = getOGImagePath('models', slug)
 
   const openGraph = buildOpenGraph({
     title: `${model.name} - ${t('metaTitle')}`,
     description: model.description,
     url: canonicalPath,
     locale,
     type: 'article',
-    images: [{ url: imagePath, alt: `${model.name} Information` }],
   })
 
   // Build Twitter Card
+  // Note: Twitter images are automatically detected from opengraph-image.tsx files
   const twitter = buildTwitterCard({
     title: `${model.name} - ${t('metaTitle')}`,
     description: model.description,
-    images: [imagePath],
   })
 
   return {
@@ -384,24 +381,23 @@ export async function generateArticleMetadata(options: {
   })
 
   // Build OpenGraph with article metadata
+  // Note: OG images are automatically detected from opengraph-image.tsx files
   const canonicalPath = locale === defaultLocale ? `/${basePath}` : `/${locale}/${basePath}`
-  const imagePath = getOGImagePath('articles', slug)
 
   const openGraph = buildOpenGraph({
     title: article.title,
     description,
     url: canonicalPath,
     locale,
     type: 'article',
-    images: [{ url: imagePath, alt: article.title }],
     publishedTime: article.date,
   })
 
   // Build Twitter Card with creator
+  // Note: Twitter images are automatically detected from opengraph-image.tsx files
   const twitter = buildTwitterCard({
     title: article.title,
     description,
-    images: [imagePath],
     includeCreator: true,
   })
 

src/lib/metadata/index.ts

@@ -11,7 +11,7 @@
  *   return await generateListPageMetadata({
  *     locale: params.locale,
  *     category: 'ides',
- *     translationNamespace: 'stacksPages.ides',
+ *     translationNamespace: 'pages.ides',
  *   });
  * }
  */
@@ -53,6 +53,5 @@ export {
   formatPlatforms,
   formatPriceForDescription,
   getAlternateOGLocale,
-  getOGImagePath,
   mapLocaleToOG,
 } from './helpers'