@ucptools/validator 1.0.0

package/drizzle.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'drizzle-kit';
+
+export default defineConfig({
+  schema: './src/db/schema.ts',
+  out: './drizzle',
+  dialect: 'postgresql',
+  dbCredentials: {
+    url: process.env.DATABASE_URL!,
+  },
+});

package/examples/full-profile.json

@@ -0,0 +1,70 @@
+{
+  "ucp": {
+    "version": "2026-01-11",
+    "services": {
+      "dev.ucp.shopping": {
+        "version": "2026-01-11",
+        "spec": "https://ucp.dev/specification/overview/",
+        "rest": {
+          "schema": "https://ucp.dev/services/shopping/rest.openapi.json",
+          "endpoint": "https://api.merchant.example.com/ucp/v1"
+        },
+        "mcp": {
+          "schema": "https://ucp.dev/services/shopping/mcp.openrpc.json",
+          "endpoint": "https://mcp.merchant.example.com/ucp"
+        }
+      }
+    },
+    "capabilities": [
+      {
+        "name": "dev.ucp.shopping.checkout",
+        "version": "2026-01-11",
+        "spec": "https://ucp.dev/specification/checkout/",
+        "schema": "https://ucp.dev/schemas/shopping/checkout.json"
+      },
+      {
+        "name": "dev.ucp.shopping.order",
+        "version": "2026-01-11",
+        "spec": "https://ucp.dev/specification/order/",
+        "schema": "https://ucp.dev/schemas/shopping/order.json"
+      },
+      {
+        "name": "dev.ucp.shopping.fulfillment",
+        "version": "2026-01-11",
+        "spec": "https://ucp.dev/specification/fulfillment/",
+        "schema": "https://ucp.dev/schemas/shopping/fulfillment.json",
+        "extends": "dev.ucp.shopping.order"
+      },
+      {
+        "name": "dev.ucp.shopping.discount",
+        "version": "2026-01-11",
+        "spec": "https://ucp.dev/specification/discount/",
+        "schema": "https://ucp.dev/schemas/shopping/discount.json"
+      }
+    ]
+  },
+  "payment": {
+    "handlers": [
+      {
+        "id": "stripe",
+        "name": "Stripe",
+        "version": "2026-01-11",
+        "spec": "https://ucp.dev/handlers/tokenization/stripe/",
+        "config": {
+          "publishable_key": "pk_live_..."
+        }
+      }
+    ]
+  },
+  "signing_keys": [
+    {
+      "kty": "EC",
+      "kid": "ucp-webhook-key-1",
+      "use": "sig",
+      "alg": "ES256",
+      "crv": "P-256",
+      "x": "example_x_coordinate_base64url",
+      "y": "example_y_coordinate_base64url"
+    }
+  ]
+}

package/examples/minimal-profile.json

@@ -0,0 +1,23 @@
+{
+  "ucp": {
+    "version": "2026-01-11",
+    "services": {
+      "dev.ucp.shopping": {
+        "version": "2026-01-11",
+        "spec": "https://ucp.dev/specification/overview/",
+        "rest": {
+          "schema": "https://ucp.dev/services/shopping/rest.openapi.json",
+          "endpoint": "https://merchant.example.com/ucp/v1"
+        }
+      }
+    },
+    "capabilities": [
+      {
+        "name": "dev.ucp.shopping.checkout",
+        "version": "2026-01-11",
+        "spec": "https://ucp.dev/specification/checkout/",
+        "schema": "https://ucp.dev/schemas/shopping/checkout.json"
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@ucptools/validator",
+  "version": "1.0.0",
+  "description": "Validate and generate UCP (Universal Commerce Protocol) Business Profiles",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "ucp-validate": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/api/server.ts",
+    "start": "node dist/api/server.js",
+    "test": "vitest",
+    "lint": "eslint src --ext .ts",
+    "validate": "tsx src/cli/index.ts",
+    "generate": "tsx src/cli/generate.ts",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:push": "drizzle-kit push",
+    "db:studio": "drizzle-kit studio"
+  },
+  "keywords": [
+    "ucp",
+    "universal-commerce-protocol",
+    "profile-generator",
+    "validator"
+  ],
+  "author": "UCP.tools",
+  "license": "MIT",
+  "dependencies": {
+    "@neondatabase/serverless": "^1.0.2",
+    "@ucp-js/sdk": "^0.1.0",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "drizzle-orm": "^0.45.1",
+    "express": "^4.21.0",
+    "jose": "^5.9.6",
+    "nanoid": "^5.0.7",
+    "pg": "^8.13.0",
+    "pino": "^9.5.0",
+    "pino-pretty": "^11.3.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.9.0",
+    "@types/pg": "^8.11.10",
+    "@vercel/node": "^5.5.20",
+    "dotenv": "^17.2.3",
+    "drizzle-kit": "^0.31.8",
+    "png-to-ico": "^3.0.1",
+    "sharp": "^0.34.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3",
+    "vitest": "^4.0.17"
+  },
+  "overrides": {
+    "diff": "^8.0.3",
+    "undici": "^7.0.0",
+    "esbuild": "^0.25.0",
+    "path-to-regexp": "^8.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/public/.well-known/ucp

@@ -0,0 +1,25 @@
+{
+  "ucp": {
+    "version": "2026-01-14",
+    "services": {
+      "shopping": {
+        "version": "1.0",
+        "spec": "https://ucp.dev/specs/shopping/1.0",
+        "rest": {
+          "endpoint": "https://ucptools.dev/api",
+          "auth": {
+            "type": "none"
+          }
+        }
+      }
+    },
+    "capabilities": [
+      {
+        "name": "dev.ucp.shopping.checkout",
+        "version": "1.0",
+        "spec": "https://ucp.dev/specs/shopping/checkout/1.0",
+        "schema": "https://ucp.dev/schemas/shopping/checkout/1.0.json"
+      }
+    ]
+  }
+}

package/public/brand.css

@@ -0,0 +1,321 @@
+/**
+ * UCP.tools Brand Design System
+ * CSS Design Tokens extracted from brand logo
+ *
+ * Usage: @import './brand.css' or <link rel="stylesheet" href="/brand.css">
+ */
+
+:root {
+  /* ========================================
+     PRIMARY COLORS (from logo gradient)
+     ======================================== */
+  --brand-blue: #2E86AB;
+  --brand-teal: #36B5A2;
+  --brand-green: #47C97A;
+
+  /* Brand gradient - primary brand expression */
+  --brand-gradient: linear-gradient(135deg, #2E86AB 0%, #36B5A2 50%, #47C97A 100%);
+  --brand-gradient-hover: linear-gradient(135deg, #267593 0%, #2EA18F 50%, #3BB86B 100%);
+
+  /* ========================================
+     SECONDARY COLORS
+     ======================================== */
+  --color-dark: #1A2B3C;
+  --color-medium: #5A6978;
+  --color-light: #94A3B8;
+  --color-border: #E2E8F0;
+  --color-background: #F8FAFC;
+  --color-card: #FFFFFF;
+
+  /* ========================================
+     SEMANTIC COLORS
+     ======================================== */
+  --color-success: #47C97A;
+  --color-warning: #F59E0B;
+  --color-error: #EF4444;
+  --color-info: #2E86AB;
+
+  /* ========================================
+     GRADE COLORS
+     ======================================== */
+  --grade-a-bg: #DCFCE7;
+  --grade-a-text: #16A34A;
+  --grade-b-bg: #DBEAFE;
+  --grade-b-text: #2563EB;
+  --grade-c-bg: #FEF9C3;
+  --grade-c-text: #CA8A04;
+  --grade-d-bg: #FED7AA;
+  --grade-d-text: #EA580C;
+  --grade-f-bg: #FEE2E2;
+  --grade-f-text: #DC2626;
+
+  /* ========================================
+     TYPOGRAPHY
+     ======================================== */
+  --font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+
+  /* Font Sizes */
+  --text-xs: 0.75rem;    /* 12px */
+  --text-sm: 0.875rem;   /* 14px */
+  --text-base: 1rem;     /* 16px */
+  --text-lg: 1.25rem;    /* 20px */
+  --text-xl: 1.5rem;     /* 24px */
+  --text-2xl: 2.25rem;   /* 36px */
+  --text-3xl: 3rem;      /* 48px */
+
+  /* Font Weights */
+  --font-normal: 400;
+  --font-medium: 500;
+  --font-semibold: 600;
+  --font-bold: 700;
+
+  /* Line Heights */
+  --leading-tight: 1.2;
+  --leading-snug: 1.3;
+  --leading-normal: 1.5;
+  --leading-relaxed: 1.6;
+
+  /* ========================================
+     SPACING (8px grid)
+     ======================================== */
+  --space-1: 4px;
+  --space-2: 8px;
+  --space-3: 12px;
+  --space-4: 16px;
+  --space-5: 20px;
+  --space-6: 24px;
+  --space-8: 32px;
+  --space-10: 40px;
+  --space-12: 48px;
+  --space-16: 64px;
+
+  /* ========================================
+     BORDER RADIUS
+     ======================================== */
+  --radius-sm: 4px;
+  --radius-md: 8px;
+  --radius-lg: 12px;
+  --radius-xl: 16px;
+  --radius-full: 9999px;
+
+  /* ========================================
+     SHADOWS
+     ======================================== */
+  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.05);
+  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -2px rgba(0, 0, 0, 0.1);
+  --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1);
+  --shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1);
+  --shadow-brand: 0 4px 12px rgba(46, 134, 171, 0.4);
+
+  /* ========================================
+     TRANSITIONS
+     ======================================== */
+  --transition-fast: 150ms ease;
+  --transition-base: 200ms ease;
+  --transition-slow: 300ms ease;
+}
+
+/* ========================================
+   UTILITY CLASSES
+   ======================================== */
+
+/* Gradient Text */
+.gradient-text {
+  background: var(--brand-gradient);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+
+/* Logo */
+.logo {
+  font-size: var(--text-xl);
+  font-weight: var(--font-bold);
+  background: var(--brand-gradient);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+  text-decoration: none;
+}
+
+.logo .suffix {
+  font-weight: var(--font-normal);
+  -webkit-text-fill-color: var(--color-medium);
+}
+
+/* Primary Button */
+.btn-brand {
+  display: inline-block;
+  background: var(--brand-gradient);
+  color: white;
+  padding: var(--space-3) var(--space-6);
+  border-radius: var(--radius-md);
+  font-weight: var(--font-semibold);
+  font-size: var(--text-base);
+  border: none;
+  cursor: pointer;
+  transition: transform var(--transition-base), box-shadow var(--transition-base);
+  text-decoration: none;
+}
+
+.btn-brand:hover {
+  transform: translateY(-1px);
+  box-shadow: var(--shadow-brand);
+}
+
+.btn-brand:active {
+  transform: translateY(0);
+}
+
+.btn-brand:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+/* Secondary Button */
+.btn-secondary {
+  display: inline-block;
+  background: var(--color-card);
+  color: var(--color-dark);
+  padding: var(--space-3) var(--space-6);
+  border-radius: var(--radius-md);
+  font-weight: var(--font-semibold);
+  font-size: var(--text-base);
+  border: 2px solid var(--color-border);
+  cursor: pointer;
+  transition: border-color var(--transition-base), color var(--transition-base);
+  text-decoration: none;
+}
+
+.btn-secondary:hover {
+  border-color: var(--brand-blue);
+  color: var(--brand-blue);
+}
+
+/* Card */
+.card-brand {
+  background: var(--color-card);
+  border-radius: var(--radius-lg);
+  padding: var(--space-8);
+  box-shadow: var(--shadow-sm);
+  border: 1px solid var(--color-border);
+}
+
+.card-brand:hover {
+  transform: translateY(-2px);
+  box-shadow: var(--shadow-md);
+  transition: transform var(--transition-base), box-shadow var(--transition-base);
+}
+
+/* Input Fields */
+.input-brand {
+  width: 100%;
+  padding: var(--space-3) var(--space-4);
+  border: 2px solid var(--color-border);
+  border-radius: var(--radius-md);
+  font-size: var(--text-base);
+  font-family: var(--font-family);
+  transition: border-color var(--transition-base), box-shadow var(--transition-base);
+}
+
+.input-brand:focus {
+  outline: none;
+  border-color: var(--brand-blue);
+  box-shadow: 0 0 0 3px rgba(46, 134, 171, 0.1);
+}
+
+/* Grade Badges */
+.grade-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--space-2);
+  padding: var(--space-2) var(--space-4);
+  border-radius: var(--radius-full);
+  font-weight: var(--font-bold);
+  font-size: var(--text-lg);
+}
+
+.grade-badge.grade-a {
+  background: var(--grade-a-bg);
+  color: var(--grade-a-text);
+}
+
+.grade-badge.grade-b {
+  background: var(--grade-b-bg);
+  color: var(--grade-b-text);
+}
+
+.grade-badge.grade-c {
+  background: var(--grade-c-bg);
+  color: var(--grade-c-text);
+}
+
+.grade-badge.grade-d {
+  background: var(--grade-d-bg);
+  color: var(--grade-d-text);
+}
+
+.grade-badge.grade-f {
+  background: var(--grade-f-bg);
+  color: var(--grade-f-text);
+}
+
+/* Hero Section Background */
+.hero-gradient {
+  background: linear-gradient(135deg, rgba(46, 134, 171, 0.1) 0%, rgba(54, 181, 162, 0.05) 50%, rgba(71, 201, 122, 0.1) 100%);
+}
+
+/* Focus Ring */
+.focus-ring:focus {
+  outline: none;
+  box-shadow: 0 0 0 3px rgba(46, 134, 171, 0.3);
+}
+
+/* Link Styles */
+.link-brand {
+  color: var(--brand-blue);
+  text-decoration: none;
+  transition: color var(--transition-fast);
+}
+
+.link-brand:hover {
+  color: var(--brand-teal);
+}
+
+/* Issue Styles */
+.issue-error {
+  background: #fef2f2;
+  border-left: 3px solid var(--color-error);
+  padding: var(--space-3);
+  border-radius: var(--radius-sm);
+}
+
+.issue-warning {
+  background: #fefce8;
+  border-left: 3px solid var(--color-warning);
+  padding: var(--space-3);
+  border-radius: var(--radius-sm);
+}
+
+.issue-info {
+  background: rgba(46, 134, 171, 0.1);
+  border-left: 3px solid var(--color-info);
+  padding: var(--space-3);
+  border-radius: var(--radius-sm);
+}
+
+/* Success/Error Result Boxes */
+.result-success {
+  background: #dcfce7;
+  border: 1px solid #86efac;
+  border-radius: var(--radius-md);
+  padding: var(--space-5);
+}
+
+.result-error {
+  background: #fee2e2;
+  border: 1px solid #fca5a5;
+  border-radius: var(--radius-md);
+  padding: var(--space-5);
+}