@sonate/schemas 2.0.0

package/dist/validator.d.ts

@@ -0,0 +1,452 @@
+/**
+ * @sonate/schemas - Schema Validator
+ * Runtime validation using AJV (JSON Schema) and Zod
+ */
+import { z } from 'zod';
+import type { TrustReceipt, VerificationResult } from './receipt.types';
+/**
+ * Zod schema for runtime validation with better errors
+ */
+declare const ReceiptZodSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodLiteral<"2.0.0">;
+    timestamp: z.ZodString;
+    session_id: z.ZodString;
+    agent_did: z.ZodString;
+    human_did: z.ZodString;
+    policy_version: z.ZodString;
+    mode: z.ZodEnum<["constitutional", "directive"]>;
+    interaction: z.ZodObject<{
+        prompt: z.ZodString;
+        response: z.ZodString;
+        model: z.ZodString;
+        provider: z.ZodOptional<z.ZodEnum<["openai", "anthropic", "aws-bedrock", "local"]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+        reasoning: z.ZodOptional<z.ZodObject<{
+            thought_process: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            retrieved_context: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            thought_process?: string | undefined;
+            confidence?: number | undefined;
+            retrieved_context?: string[] | undefined;
+        }, {
+            thought_process?: string | undefined;
+            confidence?: number | undefined;
+            retrieved_context?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        model: string;
+        prompt: string;
+        response: string;
+        provider?: "openai" | "anthropic" | "aws-bedrock" | "local" | undefined;
+        temperature?: number | undefined;
+        max_tokens?: number | undefined;
+        reasoning?: {
+            thought_process?: string | undefined;
+            confidence?: number | undefined;
+            retrieved_context?: string[] | undefined;
+        } | undefined;
+    }, {
+        model: string;
+        prompt: string;
+        response: string;
+        provider?: "openai" | "anthropic" | "aws-bedrock" | "local" | undefined;
+        temperature?: number | undefined;
+        max_tokens?: number | undefined;
+        reasoning?: {
+            thought_process?: string | undefined;
+            confidence?: number | undefined;
+            retrieved_context?: string[] | undefined;
+        } | undefined;
+    }>;
+    telemetry: z.ZodOptional<z.ZodObject<{
+        resonance_score: z.ZodOptional<z.ZodNumber>;
+        resonance_rm: z.ZodOptional<z.ZodNumber>;
+        trust_resonance_gap: z.ZodOptional<z.ZodNumber>;
+        resonance_input_mode: z.ZodOptional<z.ZodEnum<["paired_turns", "labeled_sections", "single_text_fallback"]>>;
+        resonance_quality: z.ZodOptional<z.ZodEnum<["STRONG", "ADVANCED", "BREAKTHROUGH"]>>;
+        bedau_index: z.ZodOptional<z.ZodNumber>;
+        coherence_score: z.ZodOptional<z.ZodNumber>;
+        truth_debt: z.ZodOptional<z.ZodNumber>;
+        volatility: z.ZodOptional<z.ZodNumber>;
+        ciq_metrics: z.ZodOptional<z.ZodObject<{
+            clarity: z.ZodOptional<z.ZodNumber>;
+            integrity: z.ZodOptional<z.ZodNumber>;
+            quality: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            clarity?: number | undefined;
+            integrity?: number | undefined;
+            quality?: number | undefined;
+        }, {
+            clarity?: number | undefined;
+            integrity?: number | undefined;
+            quality?: number | undefined;
+        }>>;
+        resonance_components: z.ZodOptional<z.ZodObject<{
+            vector_alignment: z.ZodOptional<z.ZodNumber>;
+            context_continuity: z.ZodOptional<z.ZodNumber>;
+            semantic_mirroring: z.ZodOptional<z.ZodNumber>;
+            entropy_delta: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            vector_alignment?: number | undefined;
+            context_continuity?: number | undefined;
+            semantic_mirroring?: number | undefined;
+            entropy_delta?: number | undefined;
+        }, {
+            vector_alignment?: number | undefined;
+            context_continuity?: number | undefined;
+            semantic_mirroring?: number | undefined;
+            entropy_delta?: number | undefined;
+        }>>;
+        resonance_stakes: z.ZodOptional<z.ZodObject<{
+            level: z.ZodOptional<z.ZodEnum<["HIGH", "MEDIUM", "LOW"]>>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            confidence?: number | undefined;
+            level?: "HIGH" | "MEDIUM" | "LOW" | undefined;
+        }, {
+            confidence?: number | undefined;
+            level?: "HIGH" | "MEDIUM" | "LOW" | undefined;
+        }>>;
+        resonance_adversarial: z.ZodOptional<z.ZodObject<{
+            detected: z.ZodOptional<z.ZodBoolean>;
+            penalty: z.ZodOptional<z.ZodNumber>;
+            keyword_density: z.ZodOptional<z.ZodNumber>;
+            ethics_bypass_score: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            detected?: boolean | undefined;
+            penalty?: number | undefined;
+            keyword_density?: number | undefined;
+            ethics_bypass_score?: number | undefined;
+        }, {
+            detected?: boolean | undefined;
+            penalty?: number | undefined;
+            keyword_density?: number | undefined;
+            ethics_bypass_score?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        resonance_score?: number | undefined;
+        resonance_rm?: number | undefined;
+        trust_resonance_gap?: number | undefined;
+        resonance_input_mode?: "paired_turns" | "labeled_sections" | "single_text_fallback" | undefined;
+        resonance_quality?: "STRONG" | "ADVANCED" | "BREAKTHROUGH" | undefined;
+        bedau_index?: number | undefined;
+        coherence_score?: number | undefined;
+        truth_debt?: number | undefined;
+        volatility?: number | undefined;
+        ciq_metrics?: {
+            clarity?: number | undefined;
+            integrity?: number | undefined;
+            quality?: number | undefined;
+        } | undefined;
+        resonance_components?: {
+            vector_alignment?: number | undefined;
+            context_continuity?: number | undefined;
+            semantic_mirroring?: number | undefined;
+            entropy_delta?: number | undefined;
+        } | undefined;
+        resonance_stakes?: {
+            confidence?: number | undefined;
+            level?: "HIGH" | "MEDIUM" | "LOW" | undefined;
+        } | undefined;
+        resonance_adversarial?: {
+            detected?: boolean | undefined;
+            penalty?: number | undefined;
+            keyword_density?: number | undefined;
+            ethics_bypass_score?: number | undefined;
+        } | undefined;
+    }, {
+        resonance_score?: number | undefined;
+        resonance_rm?: number | undefined;
+        trust_resonance_gap?: number | undefined;
+        resonance_input_mode?: "paired_turns" | "labeled_sections" | "single_text_fallback" | undefined;
+        resonance_quality?: "STRONG" | "ADVANCED" | "BREAKTHROUGH" | undefined;
+        bedau_index?: number | undefined;
+        coherence_score?: number | undefined;
+        truth_debt?: number | undefined;
+        volatility?: number | undefined;
+        ciq_metrics?: {
+            clarity?: number | undefined;
+            integrity?: number | undefined;
+            quality?: number | undefined;
+        } | undefined;
+        resonance_components?: {
+            vector_alignment?: number | undefined;
+            context_continuity?: number | undefined;
+            semantic_mirroring?: number | undefined;
+            entropy_delta?: number | undefined;
+        } | undefined;
+        resonance_stakes?: {
+            confidence?: number | undefined;
+            level?: "HIGH" | "MEDIUM" | "LOW" | undefined;
+        } | undefined;
+        resonance_adversarial?: {
+            detected?: boolean | undefined;
+            penalty?: number | undefined;
+            keyword_density?: number | undefined;
+            ethics_bypass_score?: number | undefined;
+        } | undefined;
+    }>>;
+    policy_state: z.ZodOptional<z.ZodObject<{
+        constraints_applied: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        violations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            rule: z.ZodString;
+            severity: z.ZodEnum<["warning", "violation", "critical"]>;
+            action: z.ZodEnum<["warn", "slow", "halt", "escalate"]>;
+        }, "strip", z.ZodTypeAny, {
+            severity: "warning" | "violation" | "critical";
+            rule: string;
+            action: "warn" | "escalate" | "slow" | "halt";
+        }, {
+            severity: "warning" | "violation" | "critical";
+            rule: string;
+            action: "warn" | "escalate" | "slow" | "halt";
+        }>, "many">>;
+        consent_verified: z.ZodOptional<z.ZodBoolean>;
+        override_available: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        consent_verified?: boolean | undefined;
+        constraints_applied?: string[] | undefined;
+        violations?: {
+            severity: "warning" | "violation" | "critical";
+            rule: string;
+            action: "warn" | "escalate" | "slow" | "halt";
+        }[] | undefined;
+        override_available?: boolean | undefined;
+    }, {
+        consent_verified?: boolean | undefined;
+        constraints_applied?: string[] | undefined;
+        violations?: {
+            severity: "warning" | "violation" | "critical";
+            rule: string;
+            action: "warn" | "escalate" | "slow" | "halt";
+        }[] | undefined;
+        override_available?: boolean | undefined;
+    }>>;
+    chain: z.ZodObject<{
+        previous_hash: z.ZodString;
+        chain_hash: z.ZodString;
+        chain_length: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        previous_hash: string;
+        chain_hash: string;
+        chain_length?: number | undefined;
+    }, {
+        previous_hash: string;
+        chain_hash: string;
+        chain_length?: number | undefined;
+    }>;
+    signature: z.ZodObject<{
+        algorithm: z.ZodLiteral<"Ed25519">;
+        value: z.ZodString;
+        key_version: z.ZodString;
+        timestamp_signed: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        algorithm: "Ed25519";
+        value: string;
+        key_version: string;
+        timestamp_signed?: string | undefined;
+    }, {
+        algorithm: "Ed25519";
+        value: string;
+        key_version: string;
+        timestamp_signed?: string | undefined;
+    }>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        user_agent: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        tags?: string[] | undefined;
+        context?: Record<string, any> | undefined;
+        user_agent?: string | undefined;
+    }, {
+        tags?: string[] | undefined;
+        context?: Record<string, any> | undefined;
+        user_agent?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    version: "2.0.0";
+    timestamp: string;
+    session_id: string;
+    agent_did: string;
+    human_did: string;
+    policy_version: string;
+    mode: "constitutional" | "directive";
+    interaction: {
+        model: string;
+        prompt: string;
+        response: string;
+        provider?: "openai" | "anthropic" | "aws-bedrock" | "local" | undefined;
+        temperature?: number | undefined;
+        max_tokens?: number | undefined;
+        reasoning?: {
+            thought_process?: string | undefined;
+            confidence?: number | undefined;
+            retrieved_context?: string[] | undefined;
+        } | undefined;
+    };
+    signature: {
+        algorithm: "Ed25519";
+        value: string;
+        key_version: string;
+        timestamp_signed?: string | undefined;
+    };
+    chain: {
+        previous_hash: string;
+        chain_hash: string;
+        chain_length?: number | undefined;
+    };
+    metadata?: {
+        tags?: string[] | undefined;
+        context?: Record<string, any> | undefined;
+        user_agent?: string | undefined;
+    } | undefined;
+    telemetry?: {
+        resonance_score?: number | undefined;
+        resonance_rm?: number | undefined;
+        trust_resonance_gap?: number | undefined;
+        resonance_input_mode?: "paired_turns" | "labeled_sections" | "single_text_fallback" | undefined;
+        resonance_quality?: "STRONG" | "ADVANCED" | "BREAKTHROUGH" | undefined;
+        bedau_index?: number | undefined;
+        coherence_score?: number | undefined;
+        truth_debt?: number | undefined;
+        volatility?: number | undefined;
+        ciq_metrics?: {
+            clarity?: number | undefined;
+            integrity?: number | undefined;
+            quality?: number | undefined;
+        } | undefined;
+        resonance_components?: {
+            vector_alignment?: number | undefined;
+            context_continuity?: number | undefined;
+            semantic_mirroring?: number | undefined;
+            entropy_delta?: number | undefined;
+        } | undefined;
+        resonance_stakes?: {
+            confidence?: number | undefined;
+            level?: "HIGH" | "MEDIUM" | "LOW" | undefined;
+        } | undefined;
+        resonance_adversarial?: {
+            detected?: boolean | undefined;
+            penalty?: number | undefined;
+            keyword_density?: number | undefined;
+            ethics_bypass_score?: number | undefined;
+        } | undefined;
+    } | undefined;
+    policy_state?: {
+        consent_verified?: boolean | undefined;
+        constraints_applied?: string[] | undefined;
+        violations?: {
+            severity: "warning" | "violation" | "critical";
+            rule: string;
+            action: "warn" | "escalate" | "slow" | "halt";
+        }[] | undefined;
+        override_available?: boolean | undefined;
+    } | undefined;
+}, {
+    id: string;
+    version: "2.0.0";
+    timestamp: string;
+    session_id: string;
+    agent_did: string;
+    human_did: string;
+    policy_version: string;
+    mode: "constitutional" | "directive";
+    interaction: {
+        model: string;
+        prompt: string;
+        response: string;
+        provider?: "openai" | "anthropic" | "aws-bedrock" | "local" | undefined;
+        temperature?: number | undefined;
+        max_tokens?: number | undefined;
+        reasoning?: {
+            thought_process?: string | undefined;
+            confidence?: number | undefined;
+            retrieved_context?: string[] | undefined;
+        } | undefined;
+    };
+    signature: {
+        algorithm: "Ed25519";
+        value: string;
+        key_version: string;
+        timestamp_signed?: string | undefined;
+    };
+    chain: {
+        previous_hash: string;
+        chain_hash: string;
+        chain_length?: number | undefined;
+    };
+    metadata?: {
+        tags?: string[] | undefined;
+        context?: Record<string, any> | undefined;
+        user_agent?: string | undefined;
+    } | undefined;
+    telemetry?: {
+        resonance_score?: number | undefined;
+        resonance_rm?: number | undefined;
+        trust_resonance_gap?: number | undefined;
+        resonance_input_mode?: "paired_turns" | "labeled_sections" | "single_text_fallback" | undefined;
+        resonance_quality?: "STRONG" | "ADVANCED" | "BREAKTHROUGH" | undefined;
+        bedau_index?: number | undefined;
+        coherence_score?: number | undefined;
+        truth_debt?: number | undefined;
+        volatility?: number | undefined;
+        ciq_metrics?: {
+            clarity?: number | undefined;
+            integrity?: number | undefined;
+            quality?: number | undefined;
+        } | undefined;
+        resonance_components?: {
+            vector_alignment?: number | undefined;
+            context_continuity?: number | undefined;
+            semantic_mirroring?: number | undefined;
+            entropy_delta?: number | undefined;
+        } | undefined;
+        resonance_stakes?: {
+            confidence?: number | undefined;
+            level?: "HIGH" | "MEDIUM" | "LOW" | undefined;
+        } | undefined;
+        resonance_adversarial?: {
+            detected?: boolean | undefined;
+            penalty?: number | undefined;
+            keyword_density?: number | undefined;
+            ethics_bypass_score?: number | undefined;
+        } | undefined;
+    } | undefined;
+    policy_state?: {
+        consent_verified?: boolean | undefined;
+        constraints_applied?: string[] | undefined;
+        violations?: {
+            severity: "warning" | "violation" | "critical";
+            rule: string;
+            action: "warn" | "escalate" | "slow" | "halt";
+        }[] | undefined;
+        override_available?: boolean | undefined;
+    } | undefined;
+}>;
+/**
+ * Validate receipt against JSON Schema
+ */
+export declare function validateReceiptJSON(receipt: unknown): VerificationResult;
+/**
+ * Validate receipt using Zod (with better error messages)
+ */
+export declare function validateReceiptZod(receipt: unknown): ReturnType<typeof ReceiptZodSchema.safeParse>;
+/**
+ * Check if receipt has required fields for processing
+ */
+export declare function isReceiptProcessable(receipt: unknown): receipt is TrustReceipt;
+/**
+ * Export receipt validator
+ */
+export declare const receiptValidator: {
+    validateJSON: typeof validateReceiptJSON;
+    validateZod: typeof validateReceiptZod;
+    isProcessable: typeof isReceiptProcessable;
+};
+export {};
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAexE;;GAEG;AACH,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgFpB,CAAC;AAEH;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,kBAAkB,CA4DxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,SAAS,CAAC,CAElG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,YAAY,CAM9E;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAC"}

package/dist/validator.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * @sonate/schemas - Schema Validator
+ * Runtime validation using AJV (JSON Schema) and Zod
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.receiptValidator = void 0;
+exports.validateReceiptJSON = validateReceiptJSON;
+exports.validateReceiptZod = validateReceiptZod;
+exports.isReceiptProcessable = isReceiptProcessable;
+const ajv_1 = __importDefault(require("ajv"));
+const zod_1 = require("zod");
+const receipt_schema_json_1 = __importDefault(require("./receipt.schema.json"));
+/**
+ * Initialize AJV for JSON Schema validation
+ */
+const ajv = new ajv_1.default({
+    strict: false,
+    validateFormats: false,
+});
+/**
+ * Compile receipt schema for validation
+ */
+const validateReceiptSchema = ajv.compile(receipt_schema_json_1.default);
+/**
+ * Zod schema for runtime validation with better errors
+ */
+const ReceiptZodSchema = zod_1.z.object({
+    id: zod_1.z.string().regex(/^[a-f0-9]{64}$/, 'Invalid receipt ID format'),
+    version: zod_1.z.literal('2.0.0'),
+    timestamp: zod_1.z.string().datetime('Invalid ISO 8601 timestamp'),
+    session_id: zod_1.z.string().min(1),
+    agent_did: zod_1.z.string().regex(/^did:(web|sonate):.+$/, 'Invalid agent DID'),
+    human_did: zod_1.z.string().regex(/^did:(web|sonate):.+$/, 'Invalid human DID'),
+    policy_version: zod_1.z.string(),
+    mode: zod_1.z.enum(['constitutional', 'directive']),
+    interaction: zod_1.z.object({
+        prompt: zod_1.z.string(),
+        response: zod_1.z.string(),
+        model: zod_1.z.string(),
+        provider: zod_1.z.enum(['openai', 'anthropic', 'aws-bedrock', 'local']).optional(),
+        temperature: zod_1.z.number().min(0).max(2).optional(),
+        max_tokens: zod_1.z.number().int().positive().optional(),
+        reasoning: zod_1.z.object({
+            thought_process: zod_1.z.string().optional(),
+            confidence: zod_1.z.number().min(0).max(1).optional(),
+            retrieved_context: zod_1.z.array(zod_1.z.string()).optional(),
+        }).optional(),
+    }),
+    telemetry: zod_1.z.object({
+        resonance_score: zod_1.z.number().min(0).max(1).optional(),
+        resonance_rm: zod_1.z.number().min(0).max(1).optional(),
+        trust_resonance_gap: zod_1.z.number().min(0).max(1).optional(),
+        resonance_input_mode: zod_1.z.enum(['paired_turns', 'labeled_sections', 'single_text_fallback']).optional(),
+        resonance_quality: zod_1.z.enum(['STRONG', 'ADVANCED', 'BREAKTHROUGH']).optional(),
+        bedau_index: zod_1.z.number().min(0).max(1).optional(),
+        coherence_score: zod_1.z.number().min(0).max(1).optional(),
+        truth_debt: zod_1.z.number().min(0).max(1).optional(),
+        volatility: zod_1.z.number().min(0).max(1).optional(),
+        ciq_metrics: zod_1.z.object({
+            clarity: zod_1.z.number().min(0).max(1).optional(),
+            integrity: zod_1.z.number().min(0).max(1).optional(),
+            quality: zod_1.z.number().min(0).max(1).optional(),
+        }).optional(),
+        resonance_components: zod_1.z.object({
+            vector_alignment: zod_1.z.number().min(0).max(1).optional(),
+            context_continuity: zod_1.z.number().min(0).max(1).optional(),
+            semantic_mirroring: zod_1.z.number().min(0).max(1).optional(),
+            entropy_delta: zod_1.z.number().min(0).max(1).optional(),
+        }).optional(),
+        resonance_stakes: zod_1.z.object({
+            level: zod_1.z.enum(['HIGH', 'MEDIUM', 'LOW']).optional(),
+            confidence: zod_1.z.number().min(0).max(1).optional(),
+        }).optional(),
+        resonance_adversarial: zod_1.z.object({
+            detected: zod_1.z.boolean().optional(),
+            penalty: zod_1.z.number().min(0).max(1).optional(),
+            keyword_density: zod_1.z.number().min(0).max(1).optional(),
+            ethics_bypass_score: zod_1.z.number().min(0).max(1).optional(),
+        }).optional(),
+    }).optional(),
+    policy_state: zod_1.z.object({
+        constraints_applied: zod_1.z.array(zod_1.z.string()).optional(),
+        violations: zod_1.z.array(zod_1.z.object({
+            rule: zod_1.z.string(),
+            severity: zod_1.z.enum(['warning', 'violation', 'critical']),
+            action: zod_1.z.enum(['warn', 'slow', 'halt', 'escalate']),
+        })).optional(),
+        consent_verified: zod_1.z.boolean().optional(),
+        override_available: zod_1.z.boolean().optional(),
+    }).optional(),
+    chain: zod_1.z.object({
+        previous_hash: zod_1.z.string().regex(/^[a-f0-9]{64}$|^GENESIS$/),
+        chain_hash: zod_1.z.string().regex(/^[a-f0-9]{64}$/),
+        chain_length: zod_1.z.number().int().positive().optional(),
+    }),
+    signature: zod_1.z.object({
+        algorithm: zod_1.z.literal('Ed25519'),
+        value: zod_1.z.string(),
+        key_version: zod_1.z.string(),
+        timestamp_signed: zod_1.z.string().datetime().optional(),
+    }),
+    metadata: zod_1.z.object({
+        tags: zod_1.z.array(zod_1.z.string()).optional(),
+        context: zod_1.z.record(zod_1.z.any()).optional(),
+        user_agent: zod_1.z.string().optional(),
+    }).optional(),
+});
+/**
+ * Validate receipt against JSON Schema
+ */
+function validateReceiptJSON(receipt) {
+    const checks = {
+        schema_valid: false,
+        signature_valid: false,
+        chain_valid: false,
+        chain_hash_valid: false,
+    };
+    const errors = [];
+    const warnings = [];
+    try {
+        // Step 1: Validate schema
+        const valid = validateReceiptSchema(receipt);
+        if (!valid) {
+            checks.schema_valid = false;
+            errors.push('Schema validation failed');
+            if (validateReceiptSchema.errors) {
+                validateReceiptSchema.errors.forEach(err => {
+                    errors.push(`${err.instancePath || 'root'}: ${err.message}`);
+                });
+            }
+            return { valid: false, checks, errors, warnings };
+        }
+        checks.schema_valid = true;
+        const typedReceipt = receipt;
+        // Step 2: Validate chain structure
+        if (!typedReceipt.chain?.previous_hash || !typedReceipt.chain?.chain_hash) {
+            errors.push('Invalid chain structure');
+            return { valid: false, checks, errors, warnings };
+        }
+        checks.chain_valid = true;
+        // Step 3: Verify signature structure (not crypto verification - that's separate)
+        if (!typedReceipt.signature?.value) {
+            errors.push('Invalid signature structure');
+            return { valid: false, checks, errors, warnings };
+        }
+        checks.signature_valid = true; // Crypto verification happens separately
+        // Step 4: Validate chain hash format
+        const chainHashValid = /^[a-f0-9]{64}$/.test(typedReceipt.chain.chain_hash);
+        if (!chainHashValid) {
+            errors.push('Invalid chain hash format');
+            return { valid: false, checks, errors, warnings };
+        }
+        checks.chain_hash_valid = true;
+        return {
+            valid: errors.length === 0,
+            checks,
+            errors,
+            warnings,
+        };
+    }
+    catch (err) {
+        errors.push(`Validation error: ${err instanceof Error ? err.message : String(err)}`);
+        return { valid: false, checks, errors, warnings };
+    }
+}
+/**
+ * Validate receipt using Zod (with better error messages)
+ */
+function validateReceiptZod(receipt) {
+    return ReceiptZodSchema.safeParse(receipt);
+}
+/**
+ * Check if receipt has required fields for processing
+ */
+function isReceiptProcessable(receipt) {
+    if (typeof receipt !== 'object' || receipt === null) {
+        return false;
+    }
+    const result = validateReceiptJSON(receipt);
+    return result.valid && Object.values(result.checks).every(check => check);
+}
+/**
+ * Export receipt validator
+ */
+exports.receiptValidator = {
+    validateJSON: validateReceiptJSON,
+    validateZod: validateReceiptZod,
+    isProcessable: isReceiptProcessable,
+};
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

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