@ucptools/validator 1.0.0 → 1.1.0

package/scripts/setup-benchmark-db.js

@@ -1,70 +0,0 @@
-/**
- * Setup script for benchmark database tables
- * Run with: node scripts/setup-benchmark-db.js
- */
-
-import pg from 'pg';
-
-const { Pool } = pg;
-
-async function setup() {
-  const pool = new Pool({
-    connectionString: process.env.DATABASE_URL,
-    ssl: { rejectUnauthorized: false }
-  });
-
-  try {
-    console.log('Creating benchmark tables...');
-
-    // Create benchmark_stats table for aggregate statistics
-    await pool.query(`
-      CREATE TABLE IF NOT EXISTS benchmark_stats (
-        id SERIAL PRIMARY KEY,
-        score_bucket INT NOT NULL CHECK (score_bucket >= 0 AND score_bucket <= 100),
-        count INT DEFAULT 0,
-        UNIQUE(score_bucket)
-      );
-    `);
-
-    // Initialize score buckets (0-10, 10-20, ..., 90-100)
-    for (let bucket = 0; bucket <= 100; bucket += 10) {
-      await pool.query(`
-        INSERT INTO benchmark_stats (score_bucket, count)
-        VALUES ($1, 0)
-        ON CONFLICT (score_bucket) DO NOTHING;
-      `, [bucket]);
-    }
-
-    // Create summary table for quick stats
-    await pool.query(`
-      CREATE TABLE IF NOT EXISTS benchmark_summary (
-        id INT PRIMARY KEY DEFAULT 1,
-        total_validations INT DEFAULT 0,
-        avg_score DECIMAL(5,2) DEFAULT 0,
-        updated_at TIMESTAMP DEFAULT NOW(),
-        CHECK (id = 1)
-      );
-    `);
-
-    // Initialize summary row
-    await pool.query(`
-      INSERT INTO benchmark_summary (id, total_validations, avg_score)
-      VALUES (1, 0, 0)
-      ON CONFLICT (id) DO NOTHING;
-    `);
-
-    console.log('✓ Benchmark tables created successfully');
-
-    // Verify setup
-    const result = await pool.query('SELECT * FROM benchmark_stats ORDER BY score_bucket');
-    console.log('Score buckets:', result.rows.length);
-
-  } catch (error) {
-    console.error('Error setting up database:', error);
-    process.exit(1);
-  } finally {
-    await pool.end();
-  }
-}
-
-setup();

package/src/api/server.ts

@@ -1,266 +0,0 @@
-/**
- * UCP Profile Manager API Server
- */
-
-import express from 'express';
-import type { Request, Response, NextFunction } from 'express';
-import { nanoid } from 'nanoid';
-import pino from 'pino';
-import { buildProfile, generateMinimalProfile } from '../generator/index.js';
-import { validateProfile, validateRemote, validateQuick, validateJsonString } from '../validator/index.js';
-import { generateHostingArtifacts } from '../hosting/index.js';
-import type { GeneratorInput, HostingConfig } from '../types/generator.js';
-import type { ValidationOptions } from '../types/validation.js';
-
-// Logger
-const logger = pino({
-  level: process.env.LOG_LEVEL || 'info',
-  transport: process.env.NODE_ENV !== 'production' ? { target: 'pino-pretty' } : undefined,
-});
-
-const app = express();
-app.use(express.json({ limit: '1mb' }));
-
-// Request logging middleware
-app.use((req: Request, res: Response, next: NextFunction) => {
-  const requestId = nanoid(8);
-  (req as any).requestId = requestId;
-  logger.info({ requestId, method: req.method, path: req.path }, 'Request received');
-  next();
-});
-
-// CORS middleware
-app.use((req: Request, res: Response, next: NextFunction) => {
-  res.header('Access-Control-Allow-Origin', '*');
-  res.header('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
-  res.header('Access-Control-Allow-Headers', 'Content-Type, Authorization');
-  if (req.method === 'OPTIONS') {
-    return res.sendStatus(204);
-  }
-  next();
-});
-
-// Health check
-app.get('/health', (req: Request, res: Response) => {
-  res.json({ status: 'ok', version: '1.0.0' });
-});
-
-// API version prefix
-const api = express.Router();
-
-/**
- * Generate a UCP profile
- * POST /v1/profiles/generate
- */
-api.post('/profiles/generate', async (req: Request, res: Response) => {
-  try {
-    const input: GeneratorInput = req.body;
-
-    // Validate required fields
-    if (!input.merchant?.merchantId || !input.merchant?.primaryDomain) {
-      return res.status(400).json({
-        error: 'Missing required fields: merchant.merchantId and merchant.primaryDomain',
-      });
-    }
-
-    if (!input.transport?.rest?.endpoint) {
-      return res.status(400).json({
-        error: 'Missing required field: transport.rest.endpoint',
-      });
-    }
-
-    // Set defaults
-    input.capabilities = input.capabilities || { checkout: true, order: false, fulfillment: false, discount: false };
-
-    const result = await buildProfile(input);
-
-    res.json({
-      profile: result.profile,
-      signing_key_pair: result.signingKeyPair ? {
-        public_key: result.signingKeyPair.publicKey,
-        private_key_pem: result.signingKeyPair.privateKey,
-      } : undefined,
-    });
-  } catch (error) {
-    logger.error({ error }, 'Profile generation failed');
-    res.status(500).json({ error: 'Failed to generate profile' });
-  }
-});
-
-/**
- * Generate minimal profile
- * POST /v1/profiles/generate-minimal
- */
-api.post('/profiles/generate-minimal', (req: Request, res: Response) => {
-  try {
-    const { endpoint, version } = req.body;
-
-    if (!endpoint) {
-      return res.status(400).json({ error: 'Missing required field: endpoint' });
-    }
-
-    const profile = generateMinimalProfile(endpoint, version);
-    res.json({ profile });
-  } catch (error) {
-    logger.error({ error }, 'Minimal profile generation failed');
-    res.status(500).json({ error: 'Failed to generate minimal profile' });
-  }
-});
-
-/**
- * Validate a profile (from request body)
- * POST /v1/profiles/validate
- */
-api.post('/profiles/validate', async (req: Request, res: Response) => {
-  try {
-    const { profile, options } = req.body as {
-      profile: unknown;
-      options?: ValidationOptions;
-    };
-
-    if (!profile) {
-      return res.status(400).json({ error: 'Missing required field: profile' });
-    }
-
-    const report = await validateProfile(profile, options || {});
-    res.json(report);
-  } catch (error) {
-    logger.error({ error }, 'Profile validation failed');
-    res.status(500).json({ error: 'Validation failed' });
-  }
-});
-
-/**
- * Quick validate (structural + rules only)
- * POST /v1/profiles/validate-quick
- */
-api.post('/profiles/validate-quick', (req: Request, res: Response) => {
-  try {
-    const { profile } = req.body;
-
-    if (!profile) {
-      return res.status(400).json({ error: 'Missing required field: profile' });
-    }
-
-    const report = validateQuick(profile);
-    res.json(report);
-  } catch (error) {
-    logger.error({ error }, 'Quick validation failed');
-    res.status(500).json({ error: 'Validation failed' });
-  }
-});
-
-/**
- * Validate remote profile
- * POST /v1/profiles/validate-remote
- */
-api.post('/profiles/validate-remote', async (req: Request, res: Response) => {
-  try {
-    const { domain, options } = req.body as {
-      domain: string;
-      options?: ValidationOptions;
-    };
-
-    if (!domain) {
-      return res.status(400).json({ error: 'Missing required field: domain' });
-    }
-
-    const report = await validateRemote(domain, options || {});
-    res.json(report);
-  } catch (error) {
-    logger.error({ error }, 'Remote validation failed');
-    res.status(500).json({ error: 'Remote validation failed' });
-  }
-});
-
-/**
- * Validate JSON string
- * POST /v1/profiles/validate-json
- */
-api.post('/profiles/validate-json', async (req: Request, res: Response) => {
-  try {
-    const { json, options } = req.body as {
-      json: string;
-      options?: ValidationOptions;
-    };
-
-    if (!json) {
-      return res.status(400).json({ error: 'Missing required field: json' });
-    }
-
-    const report = await validateJsonString(json, options || {});
-    res.json(report);
-  } catch (error) {
-    logger.error({ error }, 'JSON validation failed');
-    res.status(500).json({ error: 'Validation failed' });
-  }
-});
-
-/**
- * Generate hosting artifacts
- * POST /v1/hosting/artifacts
- */
-api.post('/hosting/artifacts', (req: Request, res: Response) => {
-  try {
-    const { config, profile_json } = req.body as {
-      config: HostingConfig;
-      profile_json: string;
-    };
-
-    if (!config?.merchantId || !config?.merchantDomain || !config?.mode) {
-      return res.status(400).json({
-        error: 'Missing required config fields: merchantId, merchantDomain, mode',
-      });
-    }
-
-    if (!profile_json) {
-      return res.status(400).json({ error: 'Missing required field: profile_json' });
-    }
-
-    const artifacts = generateHostingArtifacts(config, profile_json);
-    res.json({ artifacts });
-  } catch (error) {
-    logger.error({ error }, 'Artifact generation failed');
-    res.status(500).json({ error: 'Failed to generate artifacts' });
-  }
-});
-
-/**
- * Hosted profile endpoint (for edge worker proxying)
- * GET /hosted/:merchantId/ucp.json
- */
-api.get('/hosted/:merchantId/ucp.json', async (req: Request, res: Response) => {
-  const { merchantId } = req.params;
-
-  // TODO: Implement database lookup for stored profiles
-  // For now, return 404 as this requires database integration
-  res.status(404).json({
-    error: 'Profile not found',
-    hint: 'This endpoint requires database integration. Use /v1/profiles/generate to create profiles.',
-  });
-});
-
-// Mount API routes
-app.use('/v1', api);
-
-// Error handler
-app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
-  logger.error({ error: err }, 'Unhandled error');
-  res.status(500).json({ error: 'Internal server error' });
-});
-
-// 404 handler
-app.use((req: Request, res: Response) => {
-  res.status(404).json({ error: 'Not found' });
-});
-
-// Start server
-const PORT = process.env.PORT || 3000;
-
-if (process.env.NODE_ENV !== 'test') {
-  app.listen(PORT, () => {
-    logger.info({ port: PORT }, 'UCP Profile Manager API started');
-  });
-}
-
-export { app };

package/src/cli/index.ts

@@ -1,302 +0,0 @@
-#!/usr/bin/env node
-/**
- * UCP Profile Validator CLI
- */
-
-import { program } from 'commander';
-import { readFileSync, writeFileSync, existsSync } from 'fs';
-import { resolve } from 'path';
-import { validateProfile, validateRemote, validateQuick } from '../validator/index.js';
-import { buildProfile, generateMinimalProfile } from '../generator/index.js';
-import { generateHostingArtifacts } from '../hosting/index.js';
-import type { ValidationReport } from '../types/validation.js';
-import type { GeneratorInput, HostingConfig, HostingMode, HostingPlatform } from '../types/generator.js';
-
-// Colors for terminal output (simple implementation without chalk for ESM)
-const colors = {
-  red: (s: string) => `\x1b[31m${s}\x1b[0m`,
-  green: (s: string) => `\x1b[32m${s}\x1b[0m`,
-  yellow: (s: string) => `\x1b[33m${s}\x1b[0m`,
-  blue: (s: string) => `\x1b[34m${s}\x1b[0m`,
-  gray: (s: string) => `\x1b[90m${s}\x1b[0m`,
-  bold: (s: string) => `\x1b[1m${s}\x1b[0m`,
-};
-
-program
-  .name('ucp-validate')
-  .description('UCP Profile Validator and Generator CLI')
-  .version('1.0.0');
-
-/**
- * Validate command
- */
-program
-  .command('validate')
-  .description('Validate a UCP profile')
-  .option('-f, --file <path>', 'Path to local JSON file')
-  .option('-r, --remote <domain>', 'Remote domain to fetch profile from')
-  .option('-q, --quick', 'Quick validation (no network checks)')
-  .option('-o, --output <path>', 'Output report to file')
-  .option('--json', 'Output as JSON')
-  .action(async (options) => {
-    try {
-      let report: ValidationReport;
-
-      if (options.remote) {
-        console.log(colors.blue(`Fetching profile from https://${options.remote}/.well-known/ucp...`));
-        report = await validateRemote(options.remote, {
-          skipNetworkChecks: options.quick,
-        });
-      } else if (options.file) {
-        const filePath = resolve(options.file);
-        if (!existsSync(filePath)) {
-          console.error(colors.red(`File not found: ${filePath}`));
-          process.exit(1);
-        }
-        const content = readFileSync(filePath, 'utf-8');
-        const profile = JSON.parse(content);
-
-        if (options.quick) {
-          report = validateQuick(profile);
-        } else {
-          report = await validateProfile(profile);
-        }
-      } else {
-        console.error(colors.red('Please specify --file or --remote'));
-        process.exit(1);
-      }
-
-      // Output
-      if (options.json) {
-        console.log(JSON.stringify(report, null, 2));
-      } else {
-        printValidationReport(report);
-      }
-
-      if (options.output) {
-        writeFileSync(options.output, JSON.stringify(report, null, 2));
-        console.log(colors.gray(`\nReport saved to: ${options.output}`));
-      }
-
-      process.exit(report.ok ? 0 : 1);
-    } catch (error) {
-      console.error(colors.red(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
-      process.exit(1);
-    }
-  });
-
-/**
- * Generate command
- */
-program
-  .command('generate')
-  .description('Generate a new UCP profile')
-  .requiredOption('-d, --domain <domain>', 'Primary domain (e.g., merchant.com)')
-  .requiredOption('-e, --endpoint <url>', 'REST API endpoint URL')
-  .option('-i, --id <id>', 'Merchant ID (auto-generated if not provided)')
-  .option('--order', 'Enable Order capability')
-  .option('--fulfillment', 'Enable Fulfillment capability')
-  .option('--discount', 'Enable Discount capability')
-  .option('-o, --output <path>', 'Output file path', 'ucp.json')
-  .option('--json', 'Output to stdout as JSON')
-  .action(async (options) => {
-    try {
-      const input: GeneratorInput = {
-        merchant: {
-          merchantId: options.id || `merchant-${Date.now()}`,
-          primaryDomain: options.domain,
-        },
-        transport: {
-          rest: {
-            endpoint: options.endpoint,
-          },
-        },
-        capabilities: {
-          checkout: true,
-          order: options.order || false,
-          fulfillment: options.fulfillment || false,
-          discount: options.discount || false,
-        },
-        security: {
-          generateSigningKeys: options.order || false,
-        },
-      };
-
-      const result = await buildProfile(input);
-
-      if (options.json) {
-        console.log(result.profileJson);
-      } else {
-        writeFileSync(options.output, result.profileJson);
-        console.log(colors.green(`✓ Profile generated: ${options.output}`));
-
-        if (result.signingKeyPair) {
-          const keyFile = options.output.replace('.json', '-private-key.pem');
-          writeFileSync(keyFile, result.signingKeyPair.privateKey);
-          console.log(colors.yellow(`⚠ Private key saved: ${keyFile}`));
-          console.log(colors.gray('  Keep this file secure! Do not commit to version control.'));
-        }
-
-        console.log(colors.blue('\nNext steps:'));
-        console.log('  1. Review the generated profile');
-        console.log('  2. Run: ucp-validate validate -f ' + options.output);
-        console.log('  3. Deploy to https://' + options.domain + '/.well-known/ucp');
-      }
-    } catch (error) {
-      console.error(colors.red(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
-      process.exit(1);
-    }
-  });
-
-/**
- * Generate minimal profile
- */
-program
-  .command('generate-minimal')
-  .description('Generate a minimal starter profile')
-  .requiredOption('-e, --endpoint <url>', 'REST API endpoint URL')
-  .option('-o, --output <path>', 'Output file path', 'ucp.json')
-  .action((options) => {
-    try {
-      const profile = generateMinimalProfile(options.endpoint);
-      const json = JSON.stringify(profile, null, 2);
-
-      writeFileSync(options.output, json);
-      console.log(colors.green(`✓ Minimal profile generated: ${options.output}`));
-    } catch (error) {
-      console.error(colors.red(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
-      process.exit(1);
-    }
-  });
-
-/**
- * Generate hosting artifacts
- */
-program
-  .command('hosting')
-  .description('Generate hosting configuration files')
-  .requiredOption('-f, --file <path>', 'Path to profile JSON file')
-  .requiredOption('-d, --domain <domain>', 'Merchant domain')
-  .requiredOption('-m, --mode <mode>', 'Hosting mode: static, edge-worker, reverse-proxy')
-  .option('-p, --platform <platform>', 'Platform: nginx, apache, vercel, netlify, cloudflare-worker, s3-cloudfront')
-  .option('-i, --id <id>', 'Merchant ID')
-  .option('-o, --output <dir>', 'Output directory', './ucp-hosting')
-  .action((options) => {
-    try {
-      const filePath = resolve(options.file);
-      if (!existsSync(filePath)) {
-        console.error(colors.red(`File not found: ${filePath}`));
-        process.exit(1);
-      }
-
-      const profileJson = readFileSync(filePath, 'utf-8');
-
-      const config: HostingConfig = {
-        mode: options.mode as HostingMode,
-        platform: options.platform as HostingPlatform,
-        merchantId: options.id || `merchant-${Date.now()}`,
-        merchantDomain: options.domain,
-      };
-
-      const artifacts = generateHostingArtifacts(config, profileJson);
-
-      // Create output directory
-      const outputDir = resolve(options.output);
-      if (!existsSync(outputDir)) {
-        const { mkdirSync } = require('fs');
-        mkdirSync(outputDir, { recursive: true });
-      }
-
-      // Write artifacts
-      for (const artifact of artifacts) {
-        const artifactPath = resolve(outputDir, artifact.filename);
-        // Create subdirectories if needed
-        const dir = artifactPath.substring(0, artifactPath.lastIndexOf('/'));
-        if (dir && !existsSync(dir)) {
-          const { mkdirSync } = require('fs');
-          mkdirSync(dir, { recursive: true });
-        }
-        writeFileSync(artifactPath, artifact.content);
-        console.log(colors.green(`✓ ${artifact.filename}`));
-      }
-
-      console.log(colors.blue(`\nArtifacts generated in: ${outputDir}`));
-      console.log(colors.gray('See README.md for installation instructions.'));
-    } catch (error) {
-      console.error(colors.red(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
-      process.exit(1);
-    }
-  });
-
-/**
- * Print validation report to console
- */
-function printValidationReport(report: ValidationReport): void {
-  console.log('\n' + colors.bold('UCP Profile Validation Report'));
-  console.log('═'.repeat(50));
-
-  if (report.profile_url) {
-    console.log(colors.gray(`Profile: ${report.profile_url}`));
-  }
-  if (report.ucp_version) {
-    console.log(colors.gray(`UCP Version: ${report.ucp_version}`));
-  }
-  console.log(colors.gray(`Validated: ${report.validated_at}`));
-  console.log(colors.gray(`Mode: ${report.validation_mode}`));
-  console.log('');
-
-  // Summary
-  if (report.ok) {
-    console.log(colors.green('✓ Validation PASSED'));
-  } else {
-    console.log(colors.red('✗ Validation FAILED'));
-  }
-
-  // Issue counts
-  const errors = report.issues.filter(i => i.severity === 'error');
-  const warnings = report.issues.filter(i => i.severity === 'warn');
-  const info = report.issues.filter(i => i.severity === 'info');
-
-  if (report.issues.length === 0) {
-    console.log(colors.green('\nNo issues found!'));
-  } else {
-    console.log(`\n${errors.length} error(s), ${warnings.length} warning(s), ${info.length} info`);
-  }
-
-  // Print issues
-  if (errors.length > 0) {
-    console.log('\n' + colors.red('Errors:'));
-    for (const issue of errors) {
-      printIssue(issue);
-    }
-  }
-
-  if (warnings.length > 0) {
-    console.log('\n' + colors.yellow('Warnings:'));
-    for (const issue of warnings) {
-      printIssue(issue);
-    }
-  }
-
-  if (info.length > 0) {
-    console.log('\n' + colors.blue('Info:'));
-    for (const issue of info) {
-      printIssue(issue);
-    }
-  }
-
-  console.log('');
-}
-
-function printIssue(issue: { severity: string; code: string; path: string; message: string; hint?: string }): void {
-  const icon = issue.severity === 'error' ? '✗' : issue.severity === 'warn' ? '⚠' : 'ℹ';
-  const color = issue.severity === 'error' ? colors.red : issue.severity === 'warn' ? colors.yellow : colors.blue;
-
-  console.log(`  ${color(icon)} [${issue.code}] ${issue.message}`);
-  console.log(colors.gray(`    Path: ${issue.path}`));
-  if (issue.hint) {
-    console.log(colors.gray(`    Hint: ${issue.hint}`));
-  }
-}
-
-program.parse();