@ucptools/validator 1.0.1 → 1.2.0

package/dist/validator/utils.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Validator Utilities
+ * Helper functions for normalizing UCP profile data
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDraftCapability = isDraftCapability;
+exports.resolveSeverity = resolveSeverity;
+exports.normalizeCapabilities = normalizeCapabilities;
+exports.normalizeServices = normalizeServices;
+const ucp_profile_js_1 = require("../types/ucp-profile.js");
+/**
+ * Check if a capability is a draft specification
+ */
+function isDraftCapability(capabilityName) {
+    return ucp_profile_js_1.CAPABILITY_STABILITY[capabilityName] === 'draft';
+}
+/**
+ * Resolve validation severity based on capability stability.
+ * Discovery blockers are always errors regardless of draft/stable status.
+ * Draft capabilities get warnings; stable capabilities get errors.
+ */
+function resolveSeverity(capabilityName, isDiscoveryBlocker = false) {
+    if (isDiscoveryBlocker)
+        return 'error';
+    return isDraftCapability(capabilityName) ? 'warn' : 'error';
+}
+/**
+ * Capabilities can be in two formats:
+ * 1. Array format: [{ name, version, spec, schema, ... }, ...]
+ * 2. Object format (Shopify): { [name]: [{ version, spec, schema, ... }, ...] }
+ *
+ * This function normalizes both to our standard array format.
+ */
+function normalizeCapabilities(capabilities) {
+    if (!capabilities) {
+        return [];
+    }
+    // Already an array - validate it looks like capabilities and return
+    if (Array.isArray(capabilities)) {
+        // Check if array items look like UcpCapability (have name property)
+        if (capabilities.length === 0 || (capabilities[0] && typeof capabilities[0] === 'object' && 'name' in capabilities[0])) {
+            return capabilities;
+        }
+        // Array of strings or other non-object format - return empty
+        return [];
+    }
+    // Object format - convert to array
+    if (typeof capabilities === 'object') {
+        const normalized = [];
+        for (const [name, entries] of Object.entries(capabilities)) {
+            // Each capability name can have multiple version entries
+            if (Array.isArray(entries)) {
+                for (const entry of entries) {
+                    if (entry && typeof entry === 'object') {
+                        normalized.push({
+                            name,
+                            version: entry.version || '',
+                            spec: entry.spec || '',
+                            schema: entry.schema || '',
+                            extends: entry.extends,
+                            config: entry.config,
+                        });
+                    }
+                }
+            }
+        }
+        return normalized;
+    }
+    // Unknown format - return empty array
+    return [];
+}
+/**
+ * Services can be in two formats:
+ * 1. Object format (our format): { [name]: { version, rest?, mcp?, ... } }
+ * 2. Array format (Shopify): { [name]: [{ version, transport, endpoint, ... }, ...] }
+ *
+ * This function normalizes services and returns individual service objects.
+ */
+function normalizeServices(services) {
+    if (!services) {
+        return [];
+    }
+    const normalized = [];
+    for (const [serviceName, serviceData] of Object.entries(services)) {
+        if (Array.isArray(serviceData)) {
+            // Array format - convert each entry to UcpService
+            for (const entry of serviceData) {
+                const service = convertServiceEntry(entry);
+                if (service) {
+                    normalized.push({ name: serviceName, service });
+                }
+            }
+        }
+        else if (serviceData && typeof serviceData === 'object') {
+            // Already UcpService format
+            normalized.push({ name: serviceName, service: serviceData });
+        }
+    }
+    return normalized;
+}
+/**
+ * Convert a Shopify-style service entry to our UcpService format
+ */
+function convertServiceEntry(entry) {
+    if (!entry || typeof entry !== 'object') {
+        return null;
+    }
+    const service = {
+        version: entry.version || '',
+        spec: entry.spec || '',
+    };
+    // Handle transport-based entries (Shopify format)
+    if (entry.transport) {
+        switch (entry.transport) {
+            case 'rest':
+                service.rest = {
+                    schema: entry.schema || '',
+                    endpoint: entry.endpoint || '',
+                };
+                break;
+            case 'mcp':
+                service.mcp = {
+                    schema: entry.schema || '',
+                    endpoint: entry.endpoint || '',
+                };
+                break;
+            case 'a2a':
+                service.a2a = {
+                    agentCard: entry.endpoint || '',
+                };
+                break;
+            case 'embedded':
+                service.embedded = {
+                    schema: entry.schema || '',
+                };
+                break;
+        }
+    }
+    // Handle direct transport properties (our format)
+    if (entry.rest)
+        service.rest = entry.rest;
+    if (entry.mcp)
+        service.mcp = entry.mcp;
+    if (entry.a2a)
+        service.a2a = entry.a2a;
+    if (entry.embedded)
+        service.embedded = entry.embedded;
+    return service;
+}
+//# sourceMappingURL=utils.js.map

package/dist/validator/utils.js.map

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

package/package.json

@@ -1,58 +1,92 @@
 {
   "name": "@ucptools/validator",
-  "version": "1.0.1",
+  "version": "1.2.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"
+    "ucp-validate": "./dist/cli/index.js",
+    "ucptools": "./dist/cli/index.js"
   },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsx watch src/api/server.ts",
-    "start": "node dist/api/server.js",
+    "dev": "next dev -p 3001",
+    "dev:api": "tsx watch --env-file=.env.local src/api/server.ts",
+    "build": "next build && tsc -p tsconfig.api.json",
+    "build:api": "tsc -p tsconfig.api.json",
+    "start": "next start",
+    "start:api": "node dist/api/server.js",
     "test": "vitest",
-    "lint": "eslint src --ext .ts",
+    "lint": "next lint && eslint src --ext .ts",
+    "typecheck": "tsc --noEmit --pretty && node -e \"console.log('\\n✓ TypeScript check completed successfully')\"",
     "validate": "tsx src/cli/index.ts",
     "generate": "tsx src/cli/generate.ts",
     "db:generate": "drizzle-kit generate",
-    "db:migrate": "drizzle-kit migrate",
+    "db:migrate": "node scripts/migrate.js",
     "db:push": "drizzle-kit push",
-    "db:studio": "drizzle-kit studio"
+    "db:studio": "drizzle-kit studio",
+    "analyze:competition": "tsx scripts/competition-analysis.ts"
   },
   "keywords": [
     "ucp",
     "universal-commerce-protocol",
     "profile-generator",
-    "validator"
+    "validator",
+    "ucp-mock-server",
+    "ucp-simulator",
+    "ucp-cli",
+    "ucp-testing",
+    "ai-commerce",
+    "agentic-commerce",
+    "google-shopping",
+    "shopify-ucp"
   ],
   "author": "UCP.tools",
   "license": "MIT",
   "dependencies": {
-    "@neondatabase/serverless": "^1.0.2",
+    "@auth/core": "^0.41.1",
+    "@auth/drizzle-adapter": "^1.11.1",
+    "@heroicons/react": "^2.2.0",
     "@ucp-js/sdk": "^0.1.0",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
+    "bcryptjs": "^3.0.3",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
+    "cookie-parser": "^1.4.7",
     "drizzle-orm": "^0.45.1",
     "express": "^4.21.0",
+    "google-auth-library": "^10.5.0",
     "jose": "^5.9.6",
+    "jspdf": "^4.0.0",
+    "jspdf-autotable": "^5.0.7",
     "nanoid": "^5.0.7",
+    "next": "^16.1.4",
     "pg": "^8.13.0",
     "pino": "^9.5.0",
     "pino-pretty": "^11.3.0",
+    "playwright": "^1.58.0",
+    "posthog-js": "^1.205.0",
+    "posthog-node": "^5.24.17",
+    "puppeteer": "^24.36.1",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "stripe": "^20.2.0",
     "zod": "^3.23.8"
   },
   "devDependencies": {
+    "@types/bcryptjs": "^2.4.6",
+    "@types/cookie-parser": "^1.4.10",
     "@types/express": "^5.0.0",
     "@types/node": "^22.9.0",
     "@types/pg": "^8.11.10",
+    "@types/react": "19.2.9",
+    "@types/supertest": "^6.0.3",
     "@vercel/node": "^5.5.20",
     "dotenv": "^17.2.3",
     "drizzle-kit": "^0.31.8",
     "png-to-ico": "^3.0.1",
     "sharp": "^0.34.5",
+    "supertest": "^7.2.2",
     "tsx": "^4.19.2",
     "typescript": "^5.6.3",
     "vitest": "^4.0.17"
@@ -60,8 +94,7 @@
   "overrides": {
     "diff": "^8.0.3",
     "undici": "^7.0.0",
-    "esbuild": "^0.25.0",
-    "path-to-regexp": "^8.0.0"
+    "esbuild": "^0.25.0"
   },
   "engines": {
     "node": ">=20.0.0"

package/.claude/settings.local.json

@@ -1,60 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(git add:*)",
-      "Bash(git commit:*)",
-      "Bash(gh repo view:*)",
-      "WebFetch(domain:github.com)",
-      "Bash(gh issue create --title \"UCP Merchant Directory - Public registry of UCP-enabled sites\" --body \"$\\(cat <<''EOF''\n## Description\nCreate a public directory/registry of UCP-enabled merchant sites. **No one else has this** - first-mover opportunity.\n\n## Value\n- Unique resource in the UCP ecosystem\n- Drives traffic as the go-to place to discover UCP merchants\n- Builds community and network effects\n- SEO for \"UCP merchants\", \"UCP enabled stores\"\n\n## Features\n- [ ] Database to store validated UCP merchants\n- [ ] Public directory page with search/filter\n- [ ] Auto-add sites that pass validation \\(opt-in\\)\n- [ ] Categories \\(e-commerce platform, industry, region\\)\n- [ ] Badge for listed merchants \\(\"Listed on UCPtools Directory\"\\)\n- [ ] API endpoint to query directory\n\n## Technical Considerations\n- Storage: Vercel KV, Supabase, or similar\n- Moderation: prevent spam/fake entries\n- Privacy: only list with merchant consent\n\n## Effort\nMedium\n\n## Priority\nHigh - First-mover advantage\nEOF\n\\)\" --label \"enhancement,first-mover,priority:high\")",
-      "Bash(gh issue create:*)",
-      "Bash(gh release:*)",
-      "Bash(git checkout:*)",
-      "Bash(npx -y @neondatabase/mcp-server-neon --help)",
-      "WebFetch(domain:neon.tech)",
-      "WebFetch(domain:neon.com)",
-      "Bash(npx neonctl@latest init)",
-      "Bash(test:*)",
-      "Bash(claude mcp add:*)",
-      "Bash(node scripts/setup-benchmark-db.js:*)",
-      "Bash(node --check:*)",
-      "Bash(git push:*)",
-      "Bash(gh pr create:*)",
-      "Bash(vercel env add:*)",
-      "Bash(gh pr merge:*)",
-      "Bash(git pull:*)",
-      "Bash(gh issue list:*)",
-      "Bash(gh issue view:*)",
-      "Bash(npm install:*)",
-      "Bash(npm uninstall:*)",
-      "Bash(npm run db:generate:*)",
-      "Bash(npm run db:push:*)",
-      "Bash(source:*)",
-      "Bash(npx tsc:*)",
-      "Bash(npm test:*)",
-      "WebSearch",
-      "WebFetch(domain:ucp.dev)",
-      "WebFetch(domain:puddingheroes.com)",
-      "Bash(curl:*)",
-      "Bash(npx tsx:*)",
-      "Bash(node:*)",
-      "WebFetch(domain:raw.githubusercontent.com)",
-      "WebFetch(domain:api.github.com)",
-      "Bash(git rm:*)",
-      "WebFetch(domain:community.shopify.com)",
-      "WebFetch(domain:www.consentmo.com)",
-      "WebFetch(domain:www.searchenginejournal.com)",
-      "WebFetch(domain:www.cio.com)",
-      "Bash(gh issue edit:*)",
-      "Bash(git restore:*)",
-      "WebFetch(domain:blog.fka.dev)",
-      "Bash(npm run build:*)",
-      "Bash(ls:*)",
-      "Bash(npm pack:*)",
-      "Bash(npm --version)",
-      "Bash(dir:*)",
-      "Bash(echo:*)",
-      "Bash(npm publish:*)",
-      "Bash(tee:*)"
-    ]
-  }
-}

package/.vercel/README.txt

@@ -1,11 +0,0 @@
-> Why do I have a folder named ".vercel" in my project?
-The ".vercel" folder is created when you link a directory to a Vercel project.
-
-> What does the "project.json" file contain?
-The "project.json" file contains:
-- The ID of the Vercel project that you linked ("projectId")
-- The ID of the user or team your Vercel project is owned by ("orgId")
-
-> Should I commit the ".vercel" folder?
-No, you should not share the ".vercel" folder with anyone.
-Upon creation, it will be automatically added to your ".gitignore" file.

package/.vercel/project.json

@@ -1 +0,0 @@
-{"projectId":"prj_eTjAnoZgKgFqS9xhKX7Xbzhz6aHZ","orgId":"team_2huQYroxI3sER9pnJgLgEOWr","projectName":"ucp-tools"}

package/tsconfig.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "lib": ["ES2022"],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "resolveJsonModule": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "tests"]
-}