@ucptools/validator 1.0.0 → 1.0.1

package/api/analyze-feed.js

@@ -1,140 +0,0 @@
-/**
- * Vercel Serverless Function: Product Feed Quality Analyzer
- * POST /api/analyze-feed
- *
- * Analyzes product feed quality for AI agent visibility.
- *
- * Request body:
- *   {
- *     "url": "https://example.com/products",
- *     "maxProducts": 50,
- *     "includeProductDetails": true
- *   }
- *
- * GET /api/analyze-feed?url=https://example.com/products
- *   Quick analysis with default options.
- */
-
-export default async function handler(req, res) {
-    // Handle CORS
-    res.setHeader('Access-Control-Allow-Origin', '*');
-    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
-    res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
-
-    if (req.method === 'OPTIONS') {
-        return res.status(200).end();
-    }
-
-    // Extract URL from query (GET) or body (POST)
-    let url;
-    let maxProducts = 50;
-    let includeProductDetails = true;
-
-    if (req.method === 'GET') {
-        url = req.query.url;
-        if (req.query.maxProducts) {
-            maxProducts = parseInt(req.query.maxProducts, 10);
-        }
-        if (req.query.includeProductDetails === 'false') {
-            includeProductDetails = false;
-        }
-    } else if (req.method === 'POST') {
-        const body = req.body || {};
-        url = body.url;
-        maxProducts = body.maxProducts || 50;
-        includeProductDetails = body.includeProductDetails !== false;
-    } else {
-        return res.status(405).json({
-            error: 'Method not allowed',
-            message: 'Use GET or POST to analyze a product feed',
-        });
-    }
-
-    // Validate URL
-    if (!url) {
-        return res.status(400).json({
-            error: 'Missing URL',
-            message: 'Please provide a URL to analyze',
-        });
-    }
-
-    try {
-        new URL(url);
-    } catch {
-        return res.status(400).json({
-            error: 'Invalid URL',
-            message: 'Please provide a valid URL',
-        });
-    }
-
-    // Validate maxProducts
-    if (maxProducts < 1 || maxProducts > 100) {
-        return res.status(400).json({
-            error: 'Invalid maxProducts',
-            message: 'maxProducts must be between 1 and 100',
-        });
-    }
-
-    try {
-        // Fetch the page content
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), 30000);
-
-        const response = await fetch(url, {
-            headers: {
-                'User-Agent': 'UCP-Tools Feed Analyzer/1.0 (https://ucp.day)',
-                'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
-            },
-            signal: controller.signal,
-        });
-
-        clearTimeout(timeoutId);
-
-        if (!response.ok) {
-            return res.status(400).json({
-                error: 'Failed to fetch URL',
-                message: `Server returned ${response.status}: ${response.statusText}`,
-            });
-        }
-
-        const html = await response.text();
-
-        // Import and run the analyzer
-        const { analyzeProductFeedFromHtml } = await import('../src/feed-analyzer/index.js');
-
-        const result = analyzeProductFeedFromHtml(html, url, {
-            maxProducts,
-            includeProductDetails,
-        });
-
-        // Check if any products were found
-        if (result.productsFound === 0) {
-            return res.status(200).json({
-                success: true,
-                warning: 'No products found',
-                message: 'No Schema.org Product markup was found on this page. Make sure your page includes JSON-LD structured data with @type: "Product".',
-                ...result,
-            });
-        }
-
-        return res.status(200).json({
-            success: true,
-            ...result,
-        });
-
-    } catch (error) {
-        console.error('Feed analysis error:', error);
-
-        if (error.name === 'AbortError') {
-            return res.status(408).json({
-                error: 'Request timeout',
-                message: 'The request took too long. The target server may be slow or unresponsive.',
-            });
-        }
-
-        return res.status(500).json({
-            error: 'Analysis failed',
-            message: error.message || 'An unexpected error occurred',
-        });
-    }
-}

package/api/badge.js

@@ -1,185 +0,0 @@
-/**
- * Vercel Serverless Function: Generate AI Commerce Ready Badge
- * GET /api/badge?domain=example.com&style=flat
- *
- * Returns an SVG badge showing the AI readiness grade
- */
-
-const GRADE_COLORS = {
-  A: { bg: '#16A34A', text: '#DCFCE7' },
-  B: { bg: '#2563EB', text: '#DBEAFE' },
-  C: { bg: '#CA8A04', text: '#FEF9C3' },
-  D: { bg: '#EA580C', text: '#FED7AA' },
-  F: { bg: '#DC2626', text: '#FEE2E2' },
-};
-
-const READINESS_LABELS = {
-  A: 'AI Commerce Ready',
-  B: 'Mostly Ready',
-  C: 'Partially Ready',
-  D: 'Limited Readiness',
-  F: 'Not Ready',
-};
-
-function generateFlatBadge(grade, domain, score) {
-  const colors = GRADE_COLORS[grade] || GRADE_COLORS.F;
-  const label = READINESS_LABELS[grade] || 'Not Ready';
-
-  return `<svg xmlns="http://www.w3.org/2000/svg" width="180" height="20" role="img" aria-label="AI Commerce: ${grade}">
-  <title>AI Commerce: Grade ${grade} - ${label}</title>
-  <linearGradient id="s" x2="0" y2="100%">
-    <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
-    <stop offset="1" stop-opacity=".1"/>
-  </linearGradient>
-  <clipPath id="r">
-    <rect width="180" height="20" rx="3" fill="#fff"/>
-  </clipPath>
-  <g clip-path="url(#r)">
-    <rect width="95" height="20" fill="#555"/>
-    <rect x="95" width="85" height="20" fill="${colors.bg}"/>
-    <rect width="180" height="20" fill="url(#s)"/>
-  </g>
-  <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="11">
-    <text x="48.5" y="14">AI Commerce</text>
-    <text x="137.5" y="14" font-weight="bold">${grade} ${score}/100</text>
-  </g>
-</svg>`;
-}
-
-function generateFlatSquareBadge(grade, domain, score) {
-  const colors = GRADE_COLORS[grade] || GRADE_COLORS.F;
-  const label = READINESS_LABELS[grade] || 'Not Ready';
-
-  return `<svg xmlns="http://www.w3.org/2000/svg" width="180" height="20" role="img" aria-label="AI Commerce: ${grade}">
-  <title>AI Commerce: Grade ${grade} - ${label}</title>
-  <g shape-rendering="crispEdges">
-    <rect width="95" height="20" fill="#555"/>
-    <rect x="95" width="85" height="20" fill="${colors.bg}"/>
-  </g>
-  <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="11">
-    <text x="48.5" y="14">AI Commerce</text>
-    <text x="137.5" y="14" font-weight="bold">${grade} ${score}/100</text>
-  </g>
-</svg>`;
-}
-
-function generateLargeBadge(grade, domain, score) {
-  const colors = GRADE_COLORS[grade] || GRADE_COLORS.F;
-  const label = READINESS_LABELS[grade] || 'Not Ready';
-
-  return `<svg xmlns="http://www.w3.org/2000/svg" width="200" height="80" role="img" aria-label="AI Commerce Ready: ${grade}">
-  <title>AI Commerce: Grade ${grade} - ${label}</title>
-  <defs>
-    <linearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#2E86AB;stop-opacity:1" />
-      <stop offset="50%" style="stop-color:#36B5A2;stop-opacity:1" />
-      <stop offset="100%" style="stop-color:#47C97A;stop-opacity:1" />
-    </linearGradient>
-  </defs>
-  <rect width="200" height="80" rx="8" fill="#1A2B3C"/>
-  <rect x="2" y="2" width="196" height="76" rx="6" fill="none" stroke="url(#grad)" stroke-width="2"/>
-
-  <!-- Grade circle -->
-  <circle cx="40" cy="40" r="25" fill="${colors.bg}"/>
-  <text x="40" y="47" text-anchor="middle" font-family="Verdana,Geneva,sans-serif" font-size="24" font-weight="bold" fill="#fff">${grade}</text>
-
-  <!-- Text -->
-  <text x="75" y="30" font-family="Verdana,Geneva,sans-serif" font-size="11" fill="#94A3B8">AI Commerce</text>
-  <text x="75" y="48" font-family="Verdana,Geneva,sans-serif" font-size="14" font-weight="bold" fill="#fff">${label}</text>
-  <text x="75" y="65" font-family="Verdana,Geneva,sans-serif" font-size="10" fill="#94A3B8">Score: ${score}/100 • ucptools.dev</text>
-</svg>`;
-}
-
-function generateMiniBadge(grade) {
-  const colors = GRADE_COLORS[grade] || GRADE_COLORS.F;
-
-  return `<svg xmlns="http://www.w3.org/2000/svg" width="40" height="20" role="img" aria-label="Grade ${grade}">
-  <title>AI Commerce Grade ${grade}</title>
-  <rect width="40" height="20" rx="3" fill="${colors.bg}"/>
-  <text x="20" y="14" text-anchor="middle" font-family="Verdana,Geneva,sans-serif" font-size="11" font-weight="bold" fill="#fff">${grade}</text>
-</svg>`;
-}
-
-export default async function handler(req, res) {
-  // CORS headers
-  res.setHeader('Access-Control-Allow-Origin', '*');
-  res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
-  res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
-  res.setHeader('Cache-Control', 'public, max-age=3600'); // Cache for 1 hour
-
-  if (req.method === 'OPTIONS') {
-    return res.status(200).end();
-  }
-
-  if (req.method !== 'GET') {
-    return res.status(405).json({ error: 'Method not allowed' });
-  }
-
-  const { domain, style = 'flat', grade: staticGrade, score: staticScore } = req.query;
-
-  // If static grade provided (for previews), use that
-  if (staticGrade) {
-    const grade = staticGrade.toUpperCase();
-    const score = parseInt(staticScore) || (grade === 'A' ? 95 : grade === 'B' ? 82 : grade === 'C' ? 71 : grade === 'D' ? 55 : 30);
-
-    res.setHeader('Content-Type', 'image/svg+xml');
-
-    switch (style) {
-      case 'flat-square':
-        return res.send(generateFlatSquareBadge(grade, '', score));
-      case 'large':
-        return res.send(generateLargeBadge(grade, '', score));
-      case 'mini':
-        return res.send(generateMiniBadge(grade));
-      default:
-        return res.send(generateFlatBadge(grade, '', score));
-    }
-  }
-
-  if (!domain) {
-    return res.status(400).json({ error: 'Missing required parameter: domain' });
-  }
-
-  const cleanDomain = domain.replace(/^https?:\/\//, '').replace(/\/$/, '').split('/')[0];
-
-  try {
-    // Fetch validation data from our own API
-    const baseUrl = process.env.VERCEL_URL
-      ? `https://${process.env.VERCEL_URL}`
-      : 'https://ucptools.dev';
-
-    const validateRes = await fetch(`${baseUrl}/api/validate`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ domain: cleanDomain }),
-    });
-
-    if (!validateRes.ok) {
-      throw new Error('Validation failed');
-    }
-
-    const data = await validateRes.json();
-    const grade = data.ai_readiness?.grade || 'F';
-    const score = data.ai_readiness?.score || 0;
-
-    res.setHeader('Content-Type', 'image/svg+xml');
-
-    switch (style) {
-      case 'flat-square':
-        return res.send(generateFlatSquareBadge(grade, cleanDomain, score));
-      case 'large':
-        return res.send(generateLargeBadge(grade, cleanDomain, score));
-      case 'mini':
-        return res.send(generateMiniBadge(grade));
-      default:
-        return res.send(generateFlatBadge(grade, cleanDomain, score));
-    }
-  } catch (error) {
-    // Return a gray "unknown" badge on error
-    res.setHeader('Content-Type', 'image/svg+xml');
-    return res.send(`<svg xmlns="http://www.w3.org/2000/svg" width="180" height="20" role="img">
-  <rect width="180" height="20" rx="3" fill="#9CA3AF"/>
-  <text x="90" y="14" text-anchor="middle" font-family="Verdana,Geneva,sans-serif" font-size="11" fill="#fff">AI Commerce • Unknown</text>
-</svg>`);
-  }
-}

package/api/benchmark.js

@@ -1,177 +0,0 @@
-/**
- * Vercel Serverless Function: Benchmark Statistics
- *
- * POST /api/benchmark - Record a new validation score
- * GET /api/benchmark - Get benchmark statistics and percentile
- *
- * Privacy: Only stores aggregate statistics, not individual domains
- */
-
-import pg from 'pg';
-
-const { Pool } = pg;
-
-let pool = null;
-
-function getPool() {
-  if (!pool) {
-    pool = new Pool({
-      connectionString: process.env.DATABASE_URL,
-      ssl: { rejectUnauthorized: false },
-      max: 5,
-      idleTimeoutMillis: 30000,
-    });
-  }
-  return pool;
-}
-
-/**
- * Get the score bucket for a given score (0, 10, 20, ..., 100)
- */
-function getScoreBucket(score) {
-  return Math.floor(score / 10) * 10;
-}
-
-/**
- * Calculate percentile for a given score based on distribution
- */
-async function calculatePercentile(pool, score) {
-  const result = await pool.query(`
-    SELECT
-      score_bucket,
-      count,
-      SUM(count) OVER (ORDER BY score_bucket) as cumulative
-    FROM benchmark_stats
-    ORDER BY score_bucket
-  `);
-
-  const summary = await pool.query('SELECT total_validations FROM benchmark_summary WHERE id = 1');
-  const total = summary.rows[0]?.total_validations || 0;
-
-  if (total === 0) {
-    return 50; // Default to 50th percentile if no data
-  }
-
-  const scoreBucket = getScoreBucket(score);
-  let belowCount = 0;
-
-  for (const row of result.rows) {
-    if (row.score_bucket < scoreBucket) {
-      belowCount = row.cumulative;
-    } else if (row.score_bucket === scoreBucket) {
-      // For the current bucket, count half of it (assume uniform distribution within bucket)
-      belowCount = (row.cumulative - row.count) + Math.floor(row.count / 2);
-      break;
-    }
-  }
-
-  return Math.round((belowCount / total) * 100);
-}
-
-/**
- * Record a new validation score
- */
-async function recordScore(pool, score) {
-  const bucket = getScoreBucket(score);
-
-  // Increment the bucket count
-  await pool.query(`
-    UPDATE benchmark_stats
-    SET count = count + 1
-    WHERE score_bucket = $1
-  `, [bucket]);
-
-  // Update summary statistics
-  await pool.query(`
-    UPDATE benchmark_summary
-    SET
-      total_validations = total_validations + 1,
-      avg_score = (avg_score * total_validations + $1) / (total_validations + 1),
-      updated_at = NOW()
-    WHERE id = 1
-  `, [score]);
-}
-
-/**
- * Get benchmark statistics
- */
-async function getStats(pool) {
-  const summary = await pool.query('SELECT * FROM benchmark_summary WHERE id = 1');
-  const distribution = await pool.query('SELECT score_bucket, count FROM benchmark_stats ORDER BY score_bucket');
-
-  const stats = summary.rows[0] || { total_validations: 0, avg_score: 0 };
-
-  return {
-    total_validations: stats.total_validations,
-    avg_score: Math.round(stats.avg_score * 10) / 10,
-    distribution: distribution.rows.reduce((acc, row) => {
-      acc[row.score_bucket] = row.count;
-      return acc;
-    }, {}),
-    updated_at: stats.updated_at,
-  };
-}
-
-export default async function handler(req, res) {
-  // CORS headers
-  res.setHeader('Access-Control-Allow-Origin', '*');
-  res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
-  res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
-
-  if (req.method === 'OPTIONS') {
-    return res.status(200).end();
-  }
-
-  if (!process.env.DATABASE_URL) {
-    return res.status(500).json({ error: 'Database not configured' });
-  }
-
-  const pool = getPool();
-
-  try {
-    if (req.method === 'POST') {
-      // Record a new score
-      const { score } = req.body;
-
-      if (typeof score !== 'number' || score < 0 || score > 100) {
-        return res.status(400).json({ error: 'Invalid score. Must be a number between 0 and 100.' });
-      }
-
-      await recordScore(pool, score);
-      const percentile = await calculatePercentile(pool, score);
-      const stats = await getStats(pool);
-
-      return res.status(200).json({
-        recorded: true,
-        percentile,
-        stats: {
-          total_validations: stats.total_validations,
-          avg_score: stats.avg_score,
-        }
-      });
-
-    } else if (req.method === 'GET') {
-      // Get benchmark statistics
-      const score = req.query.score ? parseInt(req.query.score, 10) : null;
-      const stats = await getStats(pool);
-
-      const response = {
-        stats,
-      };
-
-      // If score provided, calculate percentile
-      if (score !== null && !isNaN(score) && score >= 0 && score <= 100) {
-        response.percentile = await calculatePercentile(pool, score);
-      }
-
-      return res.status(200).json(response);
-
-    } else {
-      return res.status(405).json({ error: 'Method not allowed' });
-    }
-
-  } catch (error) {
-    console.error('Benchmark API error:', error);
-    return res.status(500).json({ error: 'Internal server error' });
-  }
-}

package/api/directory-stats.ts

@@ -1,29 +0,0 @@
-/**
- * Vercel Serverless Function: Directory Statistics
- * GET /api/directory-stats
- */
-
-import type { VercelRequest, VercelResponse } from '@vercel/node';
-import { getDirectoryStats } from '../src/services/directory.js';
-
-export default async function handler(req: VercelRequest, res: VercelResponse) {
-  res.setHeader('Access-Control-Allow-Origin', '*');
-  res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
-  res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
-
-  if (req.method === 'OPTIONS') {
-    return res.status(200).end();
-  }
-
-  if (req.method !== 'GET') {
-    return res.status(405).json({ error: 'Method not allowed' });
-  }
-
-  try {
-    const stats = await getDirectoryStats();
-    return res.status(200).json(stats);
-  } catch (error: any) {
-    console.error('Directory stats error:', error);
-    return res.status(500).json({ error: 'Internal server error' });
-  }
-}

package/api/directory.ts

@@ -1,73 +0,0 @@
-/**
- * Vercel Serverless Function: UCP Merchant Directory
- *
- * GET /api/directory - List merchants with pagination and filters
- * POST /api/directory - Submit a new merchant to the directory
- */
-
-import type { VercelRequest, VercelResponse } from '@vercel/node';
-import { listMerchants, submitMerchant } from '../src/services/directory.js';
-
-export default async function handler(req: VercelRequest, res: VercelResponse) {
-  // CORS handled by vercel.json, but keep for local dev
-  res.setHeader('Access-Control-Allow-Origin', '*');
-  res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
-  res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
-
-  if (req.method === 'OPTIONS') {
-    return res.status(200).end();
-  }
-
-  try {
-    if (req.method === 'GET') {
-      const result = await listMerchants({
-        page: parseInt(req.query.page as string) || 1,
-        limit: parseInt(req.query.limit as string) || 20,
-        category: req.query.category as string,
-        country: req.query.country as string,
-        search: req.query.search as string,
-        sort: req.query.sort as 'score' | 'domain' | 'displayName' | 'createdAt',
-        order: req.query.order as 'asc' | 'desc',
-      });
-
-      return res.status(200).json(result);
-    }
-
-    if (req.method === 'POST') {
-      const { domain, displayName, description, logoUrl, websiteUrl, category, countryCode } = req.body;
-
-      if (!domain) {
-        return res.status(400).json({ error: 'Missing required field: domain' });
-      }
-
-      const result = await submitMerchant({
-        domain,
-        displayName,
-        description,
-        logoUrl,
-        websiteUrl,
-        category,
-        countryCode,
-      });
-
-      if (!result.success) {
-        return res.status(400).json({
-          error: result.error,
-          details: result.details,
-        });
-      }
-
-      return res.status(201).json({
-        success: true,
-        message: 'Merchant added to directory',
-        merchant: result.merchant,
-        directoryUrl: `https://ucptools.dev/directory#${result.merchant?.domain}`,
-      });
-    }
-
-    return res.status(405).json({ error: 'Method not allowed' });
-  } catch (error: any) {
-    console.error('Directory API error:', error);
-    return res.status(500).json({ error: 'Internal server error' });
-  }
-}