cannaiq/backend/src/_deprecated/utils/HomepageValidator.ts

/**
 * HomepageValidator - Content validation for homepage and marketing pages
 *
 * Validates that homepage content adheres to enterprise-safe phrasing
 * and contains no forbidden terminology.
 */

import { ContentValidator } from './ContentValidator';

export interface HomepageContent {
  hero?: {
    headline?: string;
    subheadline?: string;
    ctaPrimary?: string;
    ctaSecondary?: string;
  };
  features?: Array<{
    title: string;
    description: string;
  }>;
  stats?: Array<{
    label: string;
    value: string;
  }>;
  testimonials?: Array<{
    quote: string;
    author: string;
  }>;
  faq?: Array<{
    question: string;
    answer: string;
  }>;
  [key: string]: unknown;
}

export interface ValidationResult {
  valid: boolean;
  forbiddenTerms: string[];
  warnings: string[];
}

/**
 * Validate homepage content for forbidden terms
 * Throws an error if forbidden terms are found (for build/deploy)
 */
export function validateHomepageContent(content: HomepageContent): void {
  ContentValidator.validateOrThrow(content, 'homepage content');
}

/**
 * Validate homepage content (non-throwing)
 * Returns validation result with details
 */
export function checkHomepageContent(content: HomepageContent): ValidationResult {
  const result = ContentValidator.validate(content);

  const warnings: string[] = [];

  // Check for potential issues even if technically valid
  const jsonContent = JSON.stringify(content).toLowerCase();

  // Warn about terms that might be close to forbidden
  if (jsonContent.includes('data') && jsonContent.includes('collect')) {
    warnings.push('Content mentions "data" and "collect" - ensure context is appropriate');
  }

  if (jsonContent.includes('automat')) {
    warnings.push('Content mentions automation - verify phrasing is enterprise-appropriate');
  }

  return {
    valid: result.valid,
    forbiddenTerms: result.forbiddenTerms,
    warnings,
  };
}

/**
 * Sanitize homepage content
 * Returns cleaned content with forbidden terms replaced
 */
export function sanitizeHomepageContent<T extends HomepageContent>(content: T): T {
  return ContentValidator.sanitizeContent(content);
}

/**
 * Validate and sanitize in one call
 * Logs warnings but returns sanitized content
 */
export function processHomepageContent<T extends HomepageContent>(
  content: T,
  options?: { logWarnings?: boolean }
): T {
  const check = checkHomepageContent(content);

  if (options?.logWarnings && check.warnings.length > 0) {
    console.warn('[HomepageValidator] Warnings:', check.warnings);
  }

  if (!check.valid) {
    console.warn(
      '[HomepageValidator] Forbidden terms found and sanitized:',
      check.forbiddenTerms
    );
  }

  return sanitizeHomepageContent(content);
}

export default {
  validateHomepageContent,
  checkHomepageContent,
  sanitizeHomepageContent,
  processHomepageContent,
};