@ucptools/validator 1.0.0 → 1.0.1

package/dist/types/ucp-profile.d.ts

@@ -0,0 +1,103 @@
+/**
+ * UCP (Universal Commerce Protocol) Profile Types
+ * Based on https://ucp.dev/specification/overview/
+ */
+export declare const CURRENT_UCP_VERSION = "2026-01-11";
+export interface RestTransport {
+    schema: string;
+    endpoint: string;
+}
+export interface McpTransport {
+    schema: string;
+    endpoint: string;
+}
+export interface A2aTransport {
+    agentCard: string;
+}
+export interface EmbeddedTransport {
+    schema: string;
+}
+export interface UcpService {
+    version: string;
+    spec: string;
+    rest?: RestTransport;
+    mcp?: McpTransport;
+    a2a?: A2aTransport;
+    embedded?: EmbeddedTransport;
+}
+export interface UcpCapability {
+    name: string;
+    version: string;
+    spec: string;
+    schema: string;
+    extends?: string;
+    config?: Record<string, unknown>;
+}
+export interface JwkKey {
+    kty: string;
+    kid: string;
+    use?: string;
+    alg?: string;
+    crv?: string;
+    x?: string;
+    y?: string;
+    n?: string;
+    e?: string;
+}
+export type SigningKeys = JwkKey[];
+export interface PaymentHandler {
+    id: string;
+    name: string;
+    version: string;
+    spec: string;
+    config_schema?: string;
+    instrument_schemas?: string[];
+    config?: Record<string, unknown>;
+}
+export interface PaymentConfig {
+    handlers: PaymentHandler[];
+}
+export interface UcpObject {
+    version: string;
+    services: Record<string, UcpService>;
+    capabilities: UcpCapability[];
+}
+export interface UcpProfile {
+    ucp: UcpObject;
+    payment?: PaymentConfig;
+    signing_keys?: SigningKeys;
+    [key: string]: unknown;
+}
+export declare const CAPABILITY_NAMESPACES: {
+    readonly UCP_OFFICIAL: "dev.ucp.";
+    readonly VENDOR_PREFIX: "com.";
+};
+export declare const KNOWN_CAPABILITIES: {
+    readonly CHECKOUT: "dev.ucp.shopping.checkout";
+    readonly ORDER: "dev.ucp.shopping.order";
+    readonly PAYMENT: "dev.ucp.shopping.payment";
+    readonly PAYMENT_DATA: "dev.ucp.shopping.payment_data";
+    readonly FULFILLMENT: "dev.ucp.shopping.fulfillment";
+    readonly DISCOUNT: "dev.ucp.shopping.discount";
+    readonly BUYER_CONSENT: "dev.ucp.shopping.buyer_consent";
+};
+export declare const KNOWN_SERVICES: {
+    readonly SHOPPING: "dev.ucp.shopping";
+};
+export declare const UCP_DEFAULTS: {
+    readonly SPEC_BASE: "https://ucp.dev/specification/";
+    readonly SCHEMA_BASE: "https://ucp.dev/schemas/";
+    readonly SERVICE_SCHEMA_BASE: "https://ucp.dev/services/";
+    readonly SHOPPING_REST_SCHEMA: "https://ucp.dev/services/shopping/rest.openapi.json";
+    readonly CHECKOUT_SPEC: "https://ucp.dev/specification/checkout/";
+    readonly CHECKOUT_SCHEMA: "https://ucp.dev/schemas/shopping/checkout.json";
+    readonly ORDER_SPEC: "https://ucp.dev/specification/order/";
+    readonly ORDER_SCHEMA: "https://ucp.dev/schemas/shopping/order.json";
+    readonly FULFILLMENT_SPEC: "https://ucp.dev/specification/fulfillment/";
+    readonly FULFILLMENT_SCHEMA: "https://ucp.dev/schemas/shopping/fulfillment.json";
+    readonly DISCOUNT_SPEC: "https://ucp.dev/specification/discount/";
+    readonly DISCOUNT_SCHEMA: "https://ucp.dev/schemas/shopping/discount.json";
+};
+export type Environment = 'production' | 'staging' | 'development';
+export type ProfileStatus = 'draft' | 'published';
+//# sourceMappingURL=ucp-profile.d.ts.map

package/dist/types/ucp-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ucp-profile.d.ts","sourceRoot":"","sources":["../../src/types/ucp-profile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAGhD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAGD,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAGD,MAAM,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC;AAGnC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAGD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAGD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,YAAY,EAAE,aAAa,EAAE,CAAC;CAC/B;AAGD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,SAAS,CAAC;IACf,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,YAAY,CAAC,EAAE,WAAW,CAAC;IAE3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAGD,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAGX,eAAO,MAAM,kBAAkB;;;;;;;;CAQrB,CAAC;AAGX,eAAO,MAAM,cAAc;;CAEjB,CAAC;AAGX,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAef,CAAC;AAGX,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,CAAC;AAGnE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,WAAW,CAAC"}

package/dist/types/ucp-profile.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * UCP (Universal Commerce Protocol) Profile Types
+ * Based on https://ucp.dev/specification/overview/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UCP_DEFAULTS = exports.KNOWN_SERVICES = exports.KNOWN_CAPABILITIES = exports.CAPABILITY_NAMESPACES = exports.CURRENT_UCP_VERSION = void 0;
+// Current UCP version
+exports.CURRENT_UCP_VERSION = '2026-01-11';
+// Known capability namespaces
+exports.CAPABILITY_NAMESPACES = {
+    UCP_OFFICIAL: 'dev.ucp.',
+    VENDOR_PREFIX: 'com.',
+};
+// Known UCP capabilities (from official spec)
+exports.KNOWN_CAPABILITIES = {
+    CHECKOUT: 'dev.ucp.shopping.checkout',
+    ORDER: 'dev.ucp.shopping.order',
+    PAYMENT: 'dev.ucp.shopping.payment',
+    PAYMENT_DATA: 'dev.ucp.shopping.payment_data',
+    FULFILLMENT: 'dev.ucp.shopping.fulfillment',
+    DISCOUNT: 'dev.ucp.shopping.discount',
+    BUYER_CONSENT: 'dev.ucp.shopping.buyer_consent',
+};
+// Known UCP services
+exports.KNOWN_SERVICES = {
+    SHOPPING: 'dev.ucp.shopping',
+};
+// Default URLs for UCP official resources
+exports.UCP_DEFAULTS = {
+    SPEC_BASE: 'https://ucp.dev/specification/',
+    SCHEMA_BASE: 'https://ucp.dev/schemas/',
+    SERVICE_SCHEMA_BASE: 'https://ucp.dev/services/',
+    // Default schema URLs
+    SHOPPING_REST_SCHEMA: 'https://ucp.dev/services/shopping/rest.openapi.json',
+    CHECKOUT_SPEC: 'https://ucp.dev/specification/checkout/',
+    CHECKOUT_SCHEMA: 'https://ucp.dev/schemas/shopping/checkout.json',
+    ORDER_SPEC: 'https://ucp.dev/specification/order/',
+    ORDER_SCHEMA: 'https://ucp.dev/schemas/shopping/order.json',
+    FULFILLMENT_SPEC: 'https://ucp.dev/specification/fulfillment/',
+    FULFILLMENT_SCHEMA: 'https://ucp.dev/schemas/shopping/fulfillment.json',
+    DISCOUNT_SPEC: 'https://ucp.dev/specification/discount/',
+    DISCOUNT_SCHEMA: 'https://ucp.dev/schemas/shopping/discount.json',
+};
+//# sourceMappingURL=ucp-profile.js.map

package/dist/types/ucp-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ucp-profile.js","sourceRoot":"","sources":["../../src/types/ucp-profile.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,sBAAsB;AACT,QAAA,mBAAmB,GAAG,YAAY,CAAC;AAyFhD,8BAA8B;AACjB,QAAA,qBAAqB,GAAG;IACnC,YAAY,EAAE,UAAU;IACxB,aAAa,EAAE,MAAM;CACb,CAAC;AAEX,8CAA8C;AACjC,QAAA,kBAAkB,GAAG;IAChC,QAAQ,EAAE,2BAA2B;IACrC,KAAK,EAAE,wBAAwB;IAC/B,OAAO,EAAE,0BAA0B;IACnC,YAAY,EAAE,+BAA+B;IAC7C,WAAW,EAAE,8BAA8B;IAC3C,QAAQ,EAAE,2BAA2B;IACrC,aAAa,EAAE,gCAAgC;CACvC,CAAC;AAEX,qBAAqB;AACR,QAAA,cAAc,GAAG;IAC5B,QAAQ,EAAE,kBAAkB;CACpB,CAAC;AAEX,0CAA0C;AAC7B,QAAA,YAAY,GAAG;IAC1B,SAAS,EAAE,gCAAgC;IAC3C,WAAW,EAAE,0BAA0B;IACvC,mBAAmB,EAAE,2BAA2B;IAEhD,sBAAsB;IACtB,oBAAoB,EAAE,qDAAqD;IAC3E,aAAa,EAAE,yCAAyC;IACxD,eAAe,EAAE,gDAAgD;IACjE,UAAU,EAAE,sCAAsC;IAClD,YAAY,EAAE,6CAA6C;IAC3D,gBAAgB,EAAE,4CAA4C;IAC9D,kBAAkB,EAAE,mDAAmD;IACvE,aAAa,EAAE,yCAAyC;IACxD,eAAe,EAAE,gDAAgD;CACzD,CAAC"}

package/dist/types/validation.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Validation Types for UCP Profile Validator
+ */
+export type ValidationSeverity = 'error' | 'warn' | 'info';
+export declare const ValidationErrorCodes: {
+    readonly MISSING_UCP_OBJECT: "UCP_MISSING_ROOT";
+    readonly MISSING_VERSION: "UCP_MISSING_VERSION";
+    readonly INVALID_VERSION_FORMAT: "UCP_INVALID_VERSION_FORMAT";
+    readonly MISSING_SERVICES: "UCP_MISSING_SERVICES";
+    readonly MISSING_CAPABILITIES: "UCP_MISSING_CAPABILITIES";
+    readonly INVALID_SERVICE_STRUCTURE: "UCP_INVALID_SERVICE";
+    readonly INVALID_CAPABILITY_STRUCTURE: "UCP_INVALID_CAPABILITY";
+    readonly NS_ORIGIN_MISMATCH: "UCP_NS_ORIGIN_MISMATCH";
+    readonly ORPHANED_EXTENSION: "UCP_ORPHANED_EXTENSION";
+    readonly ENDPOINT_NOT_HTTPS: "UCP_ENDPOINT_NOT_HTTPS";
+    readonly ENDPOINT_TRAILING_SLASH: "UCP_ENDPOINT_TRAILING_SLASH";
+    readonly MISSING_SIGNING_KEYS: "UCP_MISSING_SIGNING_KEYS";
+    readonly INVALID_SIGNING_KEY: "UCP_INVALID_SIGNING_KEY";
+    readonly PROFILE_FETCH_FAILED: "UCP_PROFILE_FETCH_FAILED";
+    readonly SCHEMA_FETCH_FAILED: "UCP_SCHEMA_FETCH_FAILED";
+    readonly SCHEMA_NOT_SELF_DESCRIBING: "UCP_SCHEMA_NOT_SELF_DESCRIBING";
+    readonly SCHEMA_NAME_MISMATCH: "UCP_SCHEMA_NAME_MISMATCH";
+    readonly SCHEMA_VERSION_MISMATCH: "UCP_SCHEMA_VERSION_MISMATCH";
+    readonly PRIVATE_IP_ENDPOINT: "UCP_PRIVATE_IP_ENDPOINT";
+};
+export type ValidationErrorCode = typeof ValidationErrorCodes[keyof typeof ValidationErrorCodes];
+export interface ValidationIssue {
+    severity: ValidationSeverity;
+    code: ValidationErrorCode;
+    path: string;
+    message: string;
+    hint?: string;
+}
+export interface ValidationReport {
+    ok: boolean;
+    profile_url?: string;
+    ucp_version?: string;
+    issues: ValidationIssue[];
+    validated_at: string;
+    validation_mode: ValidationMode;
+    sdk_validation?: {
+        validated: boolean;
+        sdk_version: string;
+        compliant: boolean;
+    };
+}
+export type ValidationMode = 'structural' | 'rules' | 'network' | 'full';
+export interface ValidationOptions {
+    mode?: ValidationMode;
+    skipNetworkChecks?: boolean;
+    timeoutMs?: number;
+    cacheTtlMs?: number;
+}
+export interface SchemaCacheEntry {
+    url: string;
+    etag?: string;
+    fetchedAt: string;
+    body: Record<string, unknown>;
+    expiresAt: string;
+}
+export interface FetchResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    statusCode?: number;
+    etag?: string;
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/types/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAG3D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;CAyBvB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,OAAO,oBAAoB,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAGjG,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,cAAc,CAAC;IAChC,cAAc,CAAC,EAAE;QACf,SAAS,EAAE,OAAO,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AAGD,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAGzE,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types/validation.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Validation Types for UCP Profile Validator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationErrorCodes = void 0;
+// Validation error codes
+exports.ValidationErrorCodes = {
+    // Structural errors
+    MISSING_UCP_OBJECT: 'UCP_MISSING_ROOT',
+    MISSING_VERSION: 'UCP_MISSING_VERSION',
+    INVALID_VERSION_FORMAT: 'UCP_INVALID_VERSION_FORMAT',
+    MISSING_SERVICES: 'UCP_MISSING_SERVICES',
+    MISSING_CAPABILITIES: 'UCP_MISSING_CAPABILITIES',
+    INVALID_SERVICE_STRUCTURE: 'UCP_INVALID_SERVICE',
+    INVALID_CAPABILITY_STRUCTURE: 'UCP_INVALID_CAPABILITY',
+    // UCP rules errors
+    NS_ORIGIN_MISMATCH: 'UCP_NS_ORIGIN_MISMATCH',
+    ORPHANED_EXTENSION: 'UCP_ORPHANED_EXTENSION',
+    ENDPOINT_NOT_HTTPS: 'UCP_ENDPOINT_NOT_HTTPS',
+    ENDPOINT_TRAILING_SLASH: 'UCP_ENDPOINT_TRAILING_SLASH',
+    MISSING_SIGNING_KEYS: 'UCP_MISSING_SIGNING_KEYS',
+    INVALID_SIGNING_KEY: 'UCP_INVALID_SIGNING_KEY',
+    // Network validation errors
+    PROFILE_FETCH_FAILED: 'UCP_PROFILE_FETCH_FAILED',
+    SCHEMA_FETCH_FAILED: 'UCP_SCHEMA_FETCH_FAILED',
+    SCHEMA_NOT_SELF_DESCRIBING: 'UCP_SCHEMA_NOT_SELF_DESCRIBING',
+    SCHEMA_NAME_MISMATCH: 'UCP_SCHEMA_NAME_MISMATCH',
+    SCHEMA_VERSION_MISMATCH: 'UCP_SCHEMA_VERSION_MISMATCH',
+    PRIVATE_IP_ENDPOINT: 'UCP_PRIVATE_IP_ENDPOINT',
+};
+//# sourceMappingURL=validation.js.map

package/dist/types/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/types/validation.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,yBAAyB;AACZ,QAAA,oBAAoB,GAAG;IAClC,oBAAoB;IACpB,kBAAkB,EAAE,kBAAkB;IACtC,eAAe,EAAE,qBAAqB;IACtC,sBAAsB,EAAE,4BAA4B;IACpD,gBAAgB,EAAE,sBAAsB;IACxC,oBAAoB,EAAE,0BAA0B;IAChD,yBAAyB,EAAE,qBAAqB;IAChD,4BAA4B,EAAE,wBAAwB;IAEtD,mBAAmB;IACnB,kBAAkB,EAAE,wBAAwB;IAC5C,kBAAkB,EAAE,wBAAwB;IAC5C,kBAAkB,EAAE,wBAAwB;IAC5C,uBAAuB,EAAE,6BAA6B;IACtD,oBAAoB,EAAE,0BAA0B;IAChD,mBAAmB,EAAE,yBAAyB;IAE9C,4BAA4B;IAC5B,oBAAoB,EAAE,0BAA0B;IAChD,mBAAmB,EAAE,yBAAyB;IAC9C,0BAA0B,EAAE,gCAAgC;IAC5D,oBAAoB,EAAE,0BAA0B;IAChD,uBAAuB,EAAE,6BAA6B;IACtD,mBAAmB,EAAE,yBAAyB;CACtC,CAAC"}

package/dist/validator/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * UCP Profile Validator
+ * Main entry point combining structural, rules, and network validation
+ */
+import type { ValidationReport, ValidationOptions } from '../types/validation.js';
+export { validateStructure } from './structural-validator.js';
+export { validateRules } from './rules-validator.js';
+export { validateNetwork, validateRemoteProfile, clearSchemaCache } from './network-validator.js';
+export { safeValidateWithSdk, validateWithSdk, getSdkVersion, isSdkCompliant, validateServiceWithSdk, validateCapabilityWithSdk, validateSigningKeysWithSdk, } from './sdk-validator.js';
+/**
+ * Validate a UCP profile (local JSON)
+ */
+export declare function validateProfile(profile: unknown, options?: ValidationOptions): Promise<ValidationReport>;
+/**
+ * Validate a remote UCP profile (fetches from domain)
+ */
+export declare function validateRemote(domain: string, options?: ValidationOptions): Promise<ValidationReport>;
+/**
+ * Quick validation (structural + rules only, no network)
+ */
+export declare function validateQuick(profile: unknown): ValidationReport;
+/**
+ * Parse and validate JSON string
+ */
+export declare function validateJsonString(json: string, options?: ValidationOptions): Promise<ValidationReport>;
+//# sourceMappingURL=index.d.ts.map

package/dist/validator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validator/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAGhB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAOhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAsC3B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAqB3B;AA4CD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAehE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAmB3B"}

package/dist/validator/index.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * UCP Profile Validator
+ * Main entry point combining structural, rules, and network validation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSigningKeysWithSdk = exports.validateCapabilityWithSdk = exports.validateServiceWithSdk = exports.isSdkCompliant = exports.getSdkVersion = exports.validateWithSdk = exports.safeValidateWithSdk = exports.clearSchemaCache = exports.validateRemoteProfile = exports.validateNetwork = exports.validateRules = exports.validateStructure = void 0;
+exports.validateProfile = validateProfile;
+exports.validateRemote = validateRemote;
+exports.validateQuick = validateQuick;
+exports.validateJsonString = validateJsonString;
+const structural_validator_js_1 = require("./structural-validator.js");
+const rules_validator_js_1 = require("./rules-validator.js");
+const network_validator_js_1 = require("./network-validator.js");
+const sdk_validator_js_1 = require("./sdk-validator.js");
+var structural_validator_js_2 = require("./structural-validator.js");
+Object.defineProperty(exports, "validateStructure", { enumerable: true, get: function () { return structural_validator_js_2.validateStructure; } });
+var rules_validator_js_2 = require("./rules-validator.js");
+Object.defineProperty(exports, "validateRules", { enumerable: true, get: function () { return rules_validator_js_2.validateRules; } });
+var network_validator_js_2 = require("./network-validator.js");
+Object.defineProperty(exports, "validateNetwork", { enumerable: true, get: function () { return network_validator_js_2.validateNetwork; } });
+Object.defineProperty(exports, "validateRemoteProfile", { enumerable: true, get: function () { return network_validator_js_2.validateRemoteProfile; } });
+Object.defineProperty(exports, "clearSchemaCache", { enumerable: true, get: function () { return network_validator_js_2.clearSchemaCache; } });
+var sdk_validator_js_2 = require("./sdk-validator.js");
+Object.defineProperty(exports, "safeValidateWithSdk", { enumerable: true, get: function () { return sdk_validator_js_2.safeValidateWithSdk; } });
+Object.defineProperty(exports, "validateWithSdk", { enumerable: true, get: function () { return sdk_validator_js_2.validateWithSdk; } });
+Object.defineProperty(exports, "getSdkVersion", { enumerable: true, get: function () { return sdk_validator_js_2.getSdkVersion; } });
+Object.defineProperty(exports, "isSdkCompliant", { enumerable: true, get: function () { return sdk_validator_js_2.isSdkCompliant; } });
+Object.defineProperty(exports, "validateServiceWithSdk", { enumerable: true, get: function () { return sdk_validator_js_2.validateServiceWithSdk; } });
+Object.defineProperty(exports, "validateCapabilityWithSdk", { enumerable: true, get: function () { return sdk_validator_js_2.validateCapabilityWithSdk; } });
+Object.defineProperty(exports, "validateSigningKeysWithSdk", { enumerable: true, get: function () { return sdk_validator_js_2.validateSigningKeysWithSdk; } });
+/**
+ * Validate a UCP profile (local JSON)
+ */
+async function validateProfile(profile, options = {}) {
+    const mode = options.mode || 'full';
+    const issues = [];
+    // Phase 1: Structural validation (always run)
+    if (mode === 'structural' || mode === 'rules' || mode === 'full') {
+        const structuralIssues = (0, structural_validator_js_1.validateStructure)(profile);
+        issues.push(...structuralIssues);
+        // If structural validation has errors, don't proceed with rules/network
+        const hasStructuralErrors = structuralIssues.some(i => i.severity === 'error');
+        if (hasStructuralErrors && mode !== 'structural') {
+            return buildReport(issues, mode, undefined, profile);
+        }
+    }
+    // At this point, profile structure is valid
+    const ucpProfile = profile;
+    // Phase 2: UCP rules validation
+    if (mode === 'rules' || mode === 'full') {
+        const rulesIssues = (0, rules_validator_js_1.validateRules)(ucpProfile);
+        issues.push(...rulesIssues);
+    }
+    // Phase 3: Network validation (optional)
+    if (mode === 'network' || mode === 'full') {
+        if (!options.skipNetworkChecks) {
+            const networkOptions = {
+                timeoutMs: options.timeoutMs,
+                cacheTtlMs: options.cacheTtlMs,
+            };
+            const networkIssues = await (0, network_validator_js_1.validateNetwork)(ucpProfile, networkOptions);
+            issues.push(...networkIssues);
+        }
+    }
+    return buildReport(issues, mode, undefined, ucpProfile);
+}
+/**
+ * Validate a remote UCP profile (fetches from domain)
+ */
+async function validateRemote(domain, options = {}) {
+    const issues = [];
+    // Fetch remote profile
+    const { profile, profileUrl: foundProfileUrl, issues: fetchIssues } = await (0, network_validator_js_1.validateRemoteProfile)(domain, {
+        timeoutMs: options.timeoutMs,
+        cacheTtlMs: options.cacheTtlMs,
+    });
+    issues.push(...fetchIssues);
+    const profileUrl = foundProfileUrl || `https://${domain}/.well-known/ucp`;
+    if (!profile) {
+        return buildReport(issues, 'network', profileUrl, undefined);
+    }
+    // Run full validation on fetched profile
+    const validationResult = await validateProfile(profile, options);
+    issues.push(...validationResult.issues);
+    return buildReport(issues, options.mode || 'full', profileUrl, profile);
+}
+/**
+ * Build validation report
+ */
+function buildReport(issues, mode, profileUrl, profile) {
+    // Determine if validation passed (no errors)
+    const hasErrors = issues.some(i => i.severity === 'error');
+    // Extract UCP version if available
+    let ucpVersion;
+    if (profile && typeof profile === 'object') {
+        const p = profile;
+        if (p.ucp && typeof p.ucp === 'object') {
+            const ucp = p.ucp;
+            if (typeof ucp.version === 'string') {
+                ucpVersion = ucp.version;
+            }
+        }
+    }
+    // Run SDK validation for compliance check
+    const sdkCompliant = profile ? (0, sdk_validator_js_1.isSdkCompliant)(profile) : false;
+    return {
+        ok: !hasErrors,
+        profile_url: profileUrl,
+        ucp_version: ucpVersion,
+        issues,
+        validated_at: new Date().toISOString(),
+        validation_mode: mode,
+        sdk_validation: {
+            validated: true,
+            sdk_version: (0, sdk_validator_js_1.getSdkVersion)(),
+            compliant: sdkCompliant,
+        },
+    };
+}
+/**
+ * Quick validation (structural + rules only, no network)
+ */
+function validateQuick(profile) {
+    const issues = [];
+    // Structural validation
+    const structuralIssues = (0, structural_validator_js_1.validateStructure)(profile);
+    issues.push(...structuralIssues);
+    // If structural is OK, run rules validation
+    const hasStructuralErrors = structuralIssues.some(i => i.severity === 'error');
+    if (!hasStructuralErrors) {
+        const rulesIssues = (0, rules_validator_js_1.validateRules)(profile);
+        issues.push(...rulesIssues);
+    }
+    return buildReport(issues, 'rules', undefined, profile);
+}
+/**
+ * Parse and validate JSON string
+ */
+async function validateJsonString(json, options = {}) {
+    try {
+        const profile = JSON.parse(json);
+        return validateProfile(profile, options);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Invalid JSON';
+        return {
+            ok: false,
+            issues: [{
+                    severity: 'error',
+                    code: 'UCP_MISSING_ROOT',
+                    path: '$',
+                    message: `Failed to parse JSON: ${message}`,
+                    hint: 'Ensure the input is valid JSON',
+                }],
+            validated_at: new Date().toISOString(),
+            validation_mode: options.mode || 'full',
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/validator/index.js.map

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

package/dist/validator/network-validator.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Network Validator
+ * Validates UCP profile with network checks (fetches remote schemas)
+ */
+import type { UcpProfile } from '../types/ucp-profile.js';
+import type { ValidationIssue } from '../types/validation.js';
+export interface NetworkValidationOptions {
+    timeoutMs?: number;
+    cacheTtlMs?: number;
+    skipSchemaFetch?: boolean;
+}
+/**
+ * Validate UCP profile with network checks
+ */
+export declare function validateNetwork(profile: UcpProfile, options?: NetworkValidationOptions): Promise<ValidationIssue[]>;
+/**
+ * Validate remote profile fetch
+ */
+export declare function validateRemoteProfile(domain: string, options?: NetworkValidationOptions): Promise<{
+    profile: UcpProfile | null;
+    profileUrl?: string;
+    issues: ValidationIssue[];
+}>;
+/**
+ * Clear the schema cache
+ */
+export declare function clearSchemaCache(): void;
+//# sourceMappingURL=network-validator.d.ts.map

package/dist/validator/network-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-validator.d.ts","sourceRoot":"","sources":["../../src/validator/network-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAiC,MAAM,wBAAwB,CAAC;AAQ7F,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,eAAe,EAAE,CAAC,CA8B5B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC;IAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC,CAwCzF;AAmTD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}