@ucptools/validator 1.0.0 → 1.0.1

package/dist/validator/structural-validator.js

@@ -0,0 +1,415 @@
+"use strict";
+/**
+ * Structural Validator
+ * Validates UCP Profile JSON structure (no network calls)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateStructure = validateStructure;
+const validation_js_1 = require("../types/validation.js");
+/**
+ * Version format regex (YYYY-MM-DD)
+ */
+const VERSION_REGEX = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * Validate the structural integrity of a UCP profile
+ * Returns an array of validation issues
+ */
+function validateStructure(profile) {
+    const issues = [];
+    // Check if it's an object
+    if (!profile || typeof profile !== 'object') {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.MISSING_UCP_OBJECT,
+            path: '$',
+            message: 'Profile must be a JSON object',
+            hint: 'Ensure your profile is valid JSON and contains a root object',
+        });
+        return issues;
+    }
+    const profileObj = profile;
+    // Check for ucp root object
+    if (!profileObj.ucp || typeof profileObj.ucp !== 'object') {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.MISSING_UCP_OBJECT,
+            path: '$.ucp',
+            message: 'Missing required "ucp" object at root level',
+            hint: 'Add a "ucp" object containing version, services, and capabilities',
+        });
+        return issues;
+    }
+    const ucp = profileObj.ucp;
+    // Validate version
+    issues.push(...validateVersion(ucp));
+    // Validate services
+    issues.push(...validateServices(ucp));
+    // Validate capabilities
+    issues.push(...validateCapabilities(ucp));
+    // Validate signing_keys if present
+    if (profileObj.signing_keys !== undefined) {
+        issues.push(...validateSigningKeys(profileObj.signing_keys));
+    }
+    return issues;
+}
+/**
+ * Validate UCP version field
+ */
+function validateVersion(ucp) {
+    const issues = [];
+    if (!ucp.version) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.MISSING_VERSION,
+            path: '$.ucp.version',
+            message: 'Missing required "version" field in ucp object',
+            hint: 'Add version field with format "YYYY-MM-DD" (e.g., "2026-01-11")',
+        });
+    }
+    else if (typeof ucp.version !== 'string') {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_VERSION_FORMAT,
+            path: '$.ucp.version',
+            message: 'Version must be a string',
+            hint: 'Use format "YYYY-MM-DD" (e.g., "2026-01-11")',
+        });
+    }
+    else if (!VERSION_REGEX.test(ucp.version)) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_VERSION_FORMAT,
+            path: '$.ucp.version',
+            message: `Invalid version format: "${ucp.version}"`,
+            hint: 'Use format "YYYY-MM-DD" (e.g., "2026-01-11")',
+        });
+    }
+    return issues;
+}
+/**
+ * Validate services object
+ */
+function validateServices(ucp) {
+    const issues = [];
+    if (!ucp.services) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.MISSING_SERVICES,
+            path: '$.ucp.services',
+            message: 'Missing required "services" field in ucp object',
+            hint: 'Add a services object with at least one service definition',
+        });
+        return issues;
+    }
+    if (typeof ucp.services !== 'object' || Array.isArray(ucp.services)) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SERVICE_STRUCTURE,
+            path: '$.ucp.services',
+            message: 'Services must be an object (not an array)',
+            hint: 'Use format: { "dev.ucp.shopping": { ... } }',
+        });
+        return issues;
+    }
+    const services = ucp.services;
+    // Check for at least one service
+    if (Object.keys(services).length === 0) {
+        issues.push({
+            severity: 'warn',
+            code: validation_js_1.ValidationErrorCodes.MISSING_SERVICES,
+            path: '$.ucp.services',
+            message: 'Services object is empty',
+            hint: 'Add at least one service (e.g., "dev.ucp.shopping")',
+        });
+    }
+    // Validate each service
+    for (const [serviceName, service] of Object.entries(services)) {
+        issues.push(...validateService(serviceName, service));
+    }
+    return issues;
+}
+/**
+ * Validate individual service definition
+ */
+function validateService(name, service) {
+    const issues = [];
+    const path = `$.ucp.services["${name}"]`;
+    if (!service || typeof service !== 'object') {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SERVICE_STRUCTURE,
+            path,
+            message: `Service "${name}" must be an object`,
+        });
+        return issues;
+    }
+    const svc = service;
+    // Check required version
+    if (!svc.version) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SERVICE_STRUCTURE,
+            path: `${path}.version`,
+            message: `Service "${name}" missing required "version" field`,
+        });
+    }
+    else if (typeof svc.version === 'string' && !VERSION_REGEX.test(svc.version)) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_VERSION_FORMAT,
+            path: `${path}.version`,
+            message: `Invalid version format in service "${name}"`,
+            hint: 'Use format "YYYY-MM-DD"',
+        });
+    }
+    // Check required spec
+    if (!svc.spec) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SERVICE_STRUCTURE,
+            path: `${path}.spec`,
+            message: `Service "${name}" missing required "spec" field`,
+        });
+    }
+    // Check for at least one transport
+    const hasTransport = svc.rest || svc.mcp || svc.a2a || svc.embedded;
+    if (!hasTransport) {
+        issues.push({
+            severity: 'warn',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SERVICE_STRUCTURE,
+            path,
+            message: `Service "${name}" has no transport bindings`,
+            hint: 'Add at least one transport: rest, mcp, a2a, or embedded',
+        });
+    }
+    // Validate REST transport if present
+    if (svc.rest) {
+        issues.push(...validateRestTransport(svc.rest, `${path}.rest`));
+    }
+    // Validate MCP transport if present
+    if (svc.mcp) {
+        issues.push(...validateMcpTransport(svc.mcp, `${path}.mcp`));
+    }
+    return issues;
+}
+/**
+ * Validate REST transport binding
+ */
+function validateRestTransport(transport, path) {
+    const issues = [];
+    if (!transport || typeof transport !== 'object') {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SERVICE_STRUCTURE,
+            path,
+            message: 'REST transport must be an object',
+        });
+        return issues;
+    }
+    const rest = transport;
+    if (!rest.schema) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SERVICE_STRUCTURE,
+            path: `${path}.schema`,
+            message: 'REST transport missing required "schema" field',
+        });
+    }
+    if (!rest.endpoint) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SERVICE_STRUCTURE,
+            path: `${path}.endpoint`,
+            message: 'REST transport missing required "endpoint" field',
+        });
+    }
+    return issues;
+}
+/**
+ * Validate MCP transport binding
+ */
+function validateMcpTransport(transport, path) {
+    const issues = [];
+    if (!transport || typeof transport !== 'object') {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SERVICE_STRUCTURE,
+            path,
+            message: 'MCP transport must be an object',
+        });
+        return issues;
+    }
+    const mcp = transport;
+    if (!mcp.schema) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SERVICE_STRUCTURE,
+            path: `${path}.schema`,
+            message: 'MCP transport missing required "schema" field',
+        });
+    }
+    if (!mcp.endpoint) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SERVICE_STRUCTURE,
+            path: `${path}.endpoint`,
+            message: 'MCP transport missing required "endpoint" field',
+        });
+    }
+    return issues;
+}
+/**
+ * Validate capabilities array
+ */
+function validateCapabilities(ucp) {
+    const issues = [];
+    if (!ucp.capabilities) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.MISSING_CAPABILITIES,
+            path: '$.ucp.capabilities',
+            message: 'Missing required "capabilities" field in ucp object',
+            hint: 'Add a capabilities array with at least one capability',
+        });
+        return issues;
+    }
+    if (!Array.isArray(ucp.capabilities)) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_CAPABILITY_STRUCTURE,
+            path: '$.ucp.capabilities',
+            message: 'Capabilities must be an array',
+        });
+        return issues;
+    }
+    if (ucp.capabilities.length === 0) {
+        issues.push({
+            severity: 'warn',
+            code: validation_js_1.ValidationErrorCodes.MISSING_CAPABILITIES,
+            path: '$.ucp.capabilities',
+            message: 'Capabilities array is empty',
+            hint: 'Add at least one capability (e.g., dev.ucp.shopping.checkout)',
+        });
+    }
+    // Validate each capability
+    for (let i = 0; i < ucp.capabilities.length; i++) {
+        issues.push(...validateCapability(ucp.capabilities[i], i));
+    }
+    return issues;
+}
+/**
+ * Validate individual capability
+ */
+function validateCapability(capability, index) {
+    const issues = [];
+    const path = `$.ucp.capabilities[${index}]`;
+    if (!capability || typeof capability !== 'object') {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_CAPABILITY_STRUCTURE,
+            path,
+            message: `Capability at index ${index} must be an object`,
+        });
+        return issues;
+    }
+    const cap = capability;
+    // Check required fields
+    if (!cap.name) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_CAPABILITY_STRUCTURE,
+            path: `${path}.name`,
+            message: 'Capability missing required "name" field',
+        });
+    }
+    if (!cap.version) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_CAPABILITY_STRUCTURE,
+            path: `${path}.version`,
+            message: 'Capability missing required "version" field',
+        });
+    }
+    else if (typeof cap.version === 'string' && !VERSION_REGEX.test(cap.version)) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_VERSION_FORMAT,
+            path: `${path}.version`,
+            message: `Invalid version format: "${cap.version}"`,
+            hint: 'Use format "YYYY-MM-DD"',
+        });
+    }
+    if (!cap.spec) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_CAPABILITY_STRUCTURE,
+            path: `${path}.spec`,
+            message: 'Capability missing required "spec" field',
+        });
+    }
+    if (!cap.schema) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_CAPABILITY_STRUCTURE,
+            path: `${path}.schema`,
+            message: 'Capability missing required "schema" field',
+        });
+    }
+    return issues;
+}
+/**
+ * Validate signing_keys structure
+ * Accepts signing_keys as a direct array of JWKs (official UCP format)
+ */
+function validateSigningKeys(signingKeys) {
+    const issues = [];
+    const path = '$.signing_keys';
+    // signing_keys should be an array of JWKs
+    if (!Array.isArray(signingKeys)) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SIGNING_KEY,
+            path,
+            message: 'signing_keys must be an array of JWK objects',
+        });
+        return issues;
+    }
+    for (let i = 0; i < signingKeys.length; i++) {
+        issues.push(...validateJwk(signingKeys[i], `${path}[${i}]`));
+    }
+    return issues;
+}
+/**
+ * Validate JWK structure
+ */
+function validateJwk(jwk, path) {
+    const issues = [];
+    if (!jwk || typeof jwk !== 'object') {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SIGNING_KEY,
+            path,
+            message: 'JWK must be an object',
+        });
+        return issues;
+    }
+    const key = jwk;
+    if (!key.kty) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SIGNING_KEY,
+            path: `${path}.kty`,
+            message: 'JWK missing required "kty" field',
+        });
+    }
+    if (!key.kid) {
+        issues.push({
+            severity: 'error',
+            code: validation_js_1.ValidationErrorCodes.INVALID_SIGNING_KEY,
+            path: `${path}.kid`,
+            message: 'JWK missing required "kid" field',
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=structural-validator.js.map

package/dist/validator/structural-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-validator.js","sourceRoot":"","sources":["../../src/validator/structural-validator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ucptools/validator",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Validate and generate UCP (Universal Commerce Protocol) Business Profiles",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/CLAUDE.md

@@ -1,109 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-UCP Profile Manager is a toolkit for validating and generating UCP (Universal Commerce Protocol) Business Profiles - an open standard enabling AI agents to discover, browse, and complete purchases on UCP-enabled merchants. The project includes a core library, REST API, CLI tools, web UI, and Apify actor integration.
-
-**Live deployment:** https://ucptools.dev
-
-## Commands
-
-```bash
-# Development
-npm run dev           # Watch mode Express server (tsx watch src/api/server.ts)
-npm run build         # TypeScript compilation
-npm start             # Production server (node dist/api/server.js)
-
-# Testing
-npm test              # Vitest tests (30s timeout, v8 coverage)
-
-# Linting
-npm run lint          # ESLint on src/**/*.ts
-
-# CLI tools
-npm run validate      # Run validator CLI (tsx src/cli/index.ts)
-npm run generate      # Run generator CLI (tsx src/cli/generate.ts)
-
-# Database (Drizzle + PostgreSQL)
-npm run db:generate   # Generate Drizzle schema
-npm run db:migrate    # Apply migrations
-npm run db:push       # Push schema to DB
-npm run db:studio     # Open Drizzle Studio
-```
-
-## Architecture
-
-### Core Library (`/src/`)
-
-**Validator (`/src/validator/`)** - Four validation levels:
-- `structural-validator.ts` - JSON structure, required fields, version format (YYYY-MM-DD)
-- `rules-validator.ts` - UCP compliance (namespace/origin binding, extension chains, HTTPS endpoints, signing keys)
-- `network-validator.ts` - Remote schema fetching/verification, self-describing schema validation
-- `sdk-validator.ts` - Integration with @ucp-js/sdk for official UCP compliance
-- `index.ts` - Orchestrator exposing `validateProfile()`, `validateRemote()`, `validateQuick()`, `validateJsonString()`
-
-**Generator (`/src/generator/`)** - Profile generation:
-- `profile-builder.ts` - `buildProfile()` for full profiles, `generateMinimalProfile()` for checkout-only
-- `key-generator.ts` - Ed25519/ES256 signing key generation (`generateSigningKeyPair()`)
-
-**Simulator (`/src/simulator/`)** - AI agent interaction simulation:
-- `agent-simulator.ts` - Tests real-world functionality: discovery flow, capability inspection, checkout simulation
-- Not just spec compliance - simulates actual agent workflows
-
-**Hosting (`/src/hosting/`)** - Platform-specific deployment configs:
-- `artifacts-generator.ts` - Generates installation artifacts for Nginx, Apache, Vercel, Netlify, Cloudflare Workers, S3+CloudFront
-
-### API & Deployment
-
-**Express API (`/src/api/server.ts`)** - REST endpoints:
-- `POST /v1/profiles/validate`, `/validate-quick`, `/validate-remote`, `/validate-json`
-- `POST /v1/profiles/generate`, `/generate-minimal`
-- `POST /v1/hosting/artifacts`
-
-**Vercel Serverless (`/api/`)** - Edge functions for ucptools.dev
-
-**Database (`/src/db/`)** - Drizzle ORM with PostgreSQL (Neon):
-- Schema: merchants (directory), benchmarkStats, benchmarkSummary
-- Service: `/src/services/directory.ts` - merchant CRUD, filtering, stats
-
-### Types (`/src/types/`)
-- `ucp-profile.ts` - UCP specification types
-- `validation.ts` - ValidationReport, ValidationIssue interfaces
-- `generator.ts` - Generator input/output types
-
-## Key Patterns
-
-**Validation Issue Structure:**
-```typescript
-{
-  severity: 'error' | 'warn' | 'info',
-  code: string,        // e.g., 'UCP_NS_ORIGIN_MISMATCH'
-  path: string,        // JSON path, e.g., '$.ucp.capabilities[0]'
-  message: string,
-  hint?: string        // Fix suggestion
-}
-```
-
-**Error Codes:** `UCP_MISSING_ROOT`, `UCP_MISSING_VERSION`, `UCP_INVALID_VERSION_FORMAT`, `UCP_NS_ORIGIN_MISMATCH`, `UCP_ORPHANED_EXTENSION`, `UCP_ENDPOINT_NOT_HTTPS`, `UCP_ENDPOINT_TRAILING_SLASH`, `UCP_MISSING_SIGNING_KEYS`, `UCP_SCHEMA_FETCH_FAILED`
-
-## Environment Variables
-
-```
-DATABASE_URL    # PostgreSQL connection string (Neon)
-NODE_ENV        # development | production
-PORT            # API port (default: 3000)
-LOG_LEVEL       # Pino log level (default: info)
-```
-
-## Tech Stack
-
-- **Runtime:** Node.js 20+, TypeScript 5.6, ES2022 target
-- **API:** Express 4.21
-- **Database:** PostgreSQL via @neondatabase/serverless, Drizzle ORM
-- **Validation:** AJV 8.17 (JSON Schema), Zod 3.23, @ucp-js/sdk 0.1
-- **Crypto:** jose (JWT/JWK), Ed25519 signing
-- **CLI:** Commander 12, Chalk 5
-- **Testing:** Vitest
-- **Deployment:** Vercel