@djangocfg/layouts 2.0.6 → 2.0.8

package/src/utils/og-image.ts

@@ -1,169 +0,0 @@
-/**
- * OG Image URL Generation Utilities
- * 
- * Client-side utilities for generating OG image URLs.
- * Moved from @djangocfg/nextjs to keep nextjs package server-only.
- */
-
-/**
- * Encode string to base64 with Unicode support
- * Works in both browser and Node.js environments
- */
-function encodeBase64(str: string): string {
-  // Node.js environment
-  if (typeof Buffer !== 'undefined') {
-    return Buffer.from(str, 'utf-8').toString('base64');
-  }
-  // Browser environment - handle Unicode via UTF-8 encoding
-  return btoa(unescape(encodeURIComponent(str)));
-}
-
-/**
- * OG Image URL parameters
- * All parameters can be encoded in URL via base64
- */
-export interface OgImageUrlParams {
-  /** Page title */
-  title: string;
-  /** Page description (optional) */
-  description?: string;
-  /** Site name (optional) */
-  siteName?: string;
-  /** Logo URL (optional) */
-  logo?: string;
-  /** Background type: 'gradient' or 'solid' */
-  backgroundType?: 'gradient' | 'solid';
-  /** Gradient start color (hex) */
-  gradientStart?: string;
-  /** Gradient end color (hex) */
-  gradientEnd?: string;
-  /** Background color (for solid type) */
-  backgroundColor?: string;
-  /** Title font size (px) */
-  titleSize?: number;
-  /** Title font weight */
-  titleWeight?: number;
-  /** Title text color */
-  titleColor?: string;
-  /** Description font size (px) */
-  descriptionSize?: number;
-  /** Description text color */
-  descriptionColor?: string;
-  /** Site name font size (px) */
-  siteNameSize?: number;
-  /** Site name text color */
-  siteNameColor?: string;
-  /** Padding (px) */
-  padding?: number;
-  /** Logo size (px) */
-  logoSize?: number;
-  /** Show logo flag */
-  showLogo?: boolean;
-  /** Show site name flag */
-  showSiteName?: boolean;
-  /** Additional custom parameters */
-  [key: string]: string | number | boolean | undefined;
-}
-
-/**
- * Generate OG image URL with query parameters or base64 encoding
- *
- * @param baseUrl - Base URL of the OG image API route (e.g., '/api/og' or 'https://example.com/api/og')
- * @param params - URL parameters for the OG image
- * @param useBase64 - If true, encode params as base64 for safer URLs (default: true)
- * @returns Complete OG image URL with encoded parameters
- *
- * @example
- * ```typescript
- * // Base64 encoding (safe, default) - all parameters can be encoded
- * const url = generateOgImageUrl('/api/og', {
- *   title: 'My Page Title',
- *   description: 'Page description here',
- *   siteName: 'My Site',
- * });
- * // Result: /api/og/[base64-encoded-json]
- * ```
- */
-export function generateOgImageUrl(
-  baseUrl: string,
-  params: OgImageUrlParams,
-  useBase64: boolean = true
-): string {
-  if (useBase64) {
-    // Clean params - remove undefined/null/empty values
-    const cleanParams: Record<string, string | number | boolean> = {};
-    Object.entries(params).forEach(([key, value]) => {
-      if (value !== undefined && value !== null && value !== '') {
-        cleanParams[key] = value;
-      }
-    });
-
-    // Encode as base64 (Unicode-safe)
-    const jsonString = JSON.stringify(cleanParams);
-    const base64Data = encodeBase64(jsonString);
-
-    // CRITICAL: Use path parameter instead of query parameter
-    // Next.js strips query params in internal requests for metadata generation
-    // Using /api/og/[data] instead of /api/og?data=... preserves the data
-    return `${baseUrl}/${base64Data}`;
-  } else {
-    // Legacy query params mode
-    const searchParams = new URLSearchParams();
-
-    // Add all defined parameters
-    Object.entries(params).forEach(([key, value]) => {
-      if (value !== undefined && value !== null && value !== '') {
-        searchParams.append(key, String(value));
-      }
-    });
-
-    const query = searchParams.toString();
-    return query ? `${baseUrl}?${query}` : baseUrl;
-  }
-}
-
-/**
- * Get absolute OG image URL from relative path
- *
- * Useful for generating absolute URLs required by Open Graph meta tags
- *
- * @param relativePath - Relative OG image path (e.g., '/api/og?title=Hello')
- * @param siteUrl - Base site URL (e.g., 'https://example.com')
- * @returns Absolute URL
- */
-export function getAbsoluteOgImageUrl(
-  relativePath: string,
-  siteUrl: string
-): string {
-  // Remove trailing slash from site URL
-  const cleanSiteUrl = siteUrl.replace(/\/$/, '');
-
-  // Ensure relative path starts with /
-  const cleanPath = relativePath.startsWith('/')
-    ? relativePath
-    : `/${relativePath}`;
-
-  return `${cleanSiteUrl}${cleanPath}`;
-}
-
-/**
- * Create OG image URL builder with preset configuration
- *
- * Useful when you want to reuse the same base URL and default parameters
- *
- * @param baseUrl - Base URL of the OG image API route
- * @param defaults - Default parameters to merge with each URL generation
- * @returns URL builder function
- */
-export function createOgImageUrlBuilder(
-  baseUrl: string,
-  defaults: Partial<OgImageUrlParams> = {}
-) {
-  return (params: OgImageUrlParams): string => {
-    return generateOgImageUrl(baseUrl, {
-      ...defaults,
-      ...params,
-    });
-  };
-}
-