/**
 * Zod Schema Integration Interfaces
 * Provides type-safe schema validation and structured extraction
 */
import { z, ZodSchema, ZodType, ZodError } from 'zod';
import { VisionParserResult } from '../interfaces';
/**
 * Options for structured parsing with Zod schema
 */
export interface StructuredParseOptions<T extends ZodType = ZodType> {
    /** Zod schema for validation */
    schema: T;
    /** Whether to enable structured extraction mode */
    structured: boolean;
    /** Number of retry attempts on validation failure (default: 2) */
    maxRetries?: number;
    /** Whether to return partial results on validation errors */
    allowPartial?: boolean;
    /** Custom prompt to guide schema extraction */
    schemaPrompt?: string;
}
/**
 * Result of structured parsing with validation
 */
export interface StructuredParseResult<T = any> {
    /** Parsed and validated data matching the schema */
    data: T;
    /** Raw vision parser result */
    raw: VisionParserResult;
    /** Whether validation was successful */
    isValid: boolean;
    /** Validation errors if any */
    validationErrors?: ZodError;
    /** Number of retry attempts made */
    retryCount: number;
}
/**
 * Schema-guided extraction configuration
 */
export interface SchemaGuidedConfig {
    /** Whether to use schema to generate extraction prompts */
    generatePromptFromSchema: boolean;
    /** Custom prompt template with schema placeholders */
    promptTemplate?: string;
}
/**
 * Validation result with detailed error reporting
 */
export interface ValidationResult<T = any> {
    /** Whether validation passed */
    success: boolean;
    /** Validated data if successful */
    data?: T;
    /** Validation errors with field-level feedback */
    errors?: Array<{
        path: string[];
        message: string;
        code: string;
    }>;
}
/**
 * Common predefined Zod schemas for document parsing
 */
export declare class CommonSchemas {
    /**
     * Invoice schema
     */
    static Invoice: z.ZodObject<{
        invoiceNumber: z.ZodString;
        date: z.ZodString;
        dueDate: z.ZodOptional<z.ZodString>;
        vendor: z.ZodObject<{
            name: z.ZodString;
            address: z.ZodOptional<z.ZodString>;
            taxId: z.ZodOptional<z.ZodString>;
        }, "strip", z.ZodTypeAny, {
            name: string;
            address?: string | undefined;
            taxId?: string | undefined;
        }, {
            name: string;
            address?: string | undefined;
            taxId?: string | undefined;
        }>;
        customer: z.ZodObject<{
            name: z.ZodString;
            address: z.ZodOptional<z.ZodString>;
        }, "strip", z.ZodTypeAny, {
            name: string;
            address?: string | undefined;
        }, {
            name: string;
            address?: string | undefined;
        }>;
        items: z.ZodArray<z.ZodObject<{
            description: z.ZodString;
            quantity: z.ZodNumber;
            unitPrice: z.ZodNumber;
            total: z.ZodNumber;
        }, "strip", z.ZodTypeAny, {
            description: string;
            quantity: number;
            unitPrice: number;
            total: number;
        }, {
            description: string;
            quantity: number;
            unitPrice: number;
            total: number;
        }>, "many">;
        subtotal: z.ZodNumber;
        tax: z.ZodOptional<z.ZodNumber>;
        total: z.ZodNumber;
        currency: z.ZodOptional<z.ZodString>;
    }, "strip", z.ZodTypeAny, {
        invoiceNumber: string;
        date: string;
        vendor: {
            name: string;
            address?: string | undefined;
            taxId?: string | undefined;
        };
        customer: {
            name: string;
            address?: string | undefined;
        };
        total: number;
        items: {
            description: string;
            quantity: number;
            unitPrice: number;
            total: number;
        }[];
        subtotal: number;
        dueDate?: string | undefined;
        tax?: number | undefined;
        currency?: string | undefined;
    }, {
        invoiceNumber: string;
        date: string;
        vendor: {
            name: string;
            address?: string | undefined;
            taxId?: string | undefined;
        };
        customer: {
            name: string;
            address?: string | undefined;
        };
        total: number;
        items: {
            description: string;
            quantity: number;
            unitPrice: number;
            total: number;
        }[];
        subtotal: number;
        dueDate?: string | undefined;
        tax?: number | undefined;
        currency?: string | undefined;
    }>;
    /**
     * Receipt schema
     */
    static Receipt: z.ZodObject<{
        merchant: z.ZodString;
        date: z.ZodString;
        items: z.ZodArray<z.ZodObject<{
            name: z.ZodString;
            quantity: z.ZodOptional<z.ZodNumber>;
            price: z.ZodNumber;
        }, "strip", z.ZodTypeAny, {
            name: string;
            price: number;
            quantity?: number | undefined;
        }, {
            name: string;
            price: number;
            quantity?: number | undefined;
        }>, "many">;
        subtotal: z.ZodNumber;
        tax: z.ZodOptional<z.ZodNumber>;
        total: z.ZodNumber;
        paymentMethod: z.ZodOptional<z.ZodString>;
    }, "strip", z.ZodTypeAny, {
        date: string;
        total: number;
        items: {
            name: string;
            price: number;
            quantity?: number | undefined;
        }[];
        subtotal: number;
        merchant: string;
        tax?: number | undefined;
        paymentMethod?: string | undefined;
    }, {
        date: string;
        total: number;
        items: {
            name: string;
            price: number;
            quantity?: number | undefined;
        }[];
        subtotal: number;
        merchant: string;
        tax?: number | undefined;
        paymentMethod?: string | undefined;
    }>;
    /**
     * Business card schema
     */
    static BusinessCard: z.ZodObject<{
        name: z.ZodString;
        title: z.ZodOptional<z.ZodString>;
        company: z.ZodOptional<z.ZodString>;
        email: z.ZodOptional<z.ZodString>;
        phone: z.ZodOptional<z.ZodString>;
        website: z.ZodOptional<z.ZodString>;
        address: z.ZodOptional<z.ZodString>;
    }, "strip", z.ZodTypeAny, {
        name: string;
        address?: string | undefined;
        title?: string | undefined;
        company?: string | undefined;
        email?: string | undefined;
        phone?: string | undefined;
        website?: string | undefined;
    }, {
        name: string;
        address?: string | undefined;
        title?: string | undefined;
        company?: string | undefined;
        email?: string | undefined;
        phone?: string | undefined;
        website?: string | undefined;
    }>;
    /**
     * Contract schema
     */
    static Contract: z.ZodObject<{
        title: z.ZodString;
        parties: z.ZodArray<z.ZodObject<{
            name: z.ZodString;
            role: z.ZodString;
            address: z.ZodOptional<z.ZodString>;
        }, "strip", z.ZodTypeAny, {
            name: string;
            role: string;
            address?: string | undefined;
        }, {
            name: string;
            role: string;
            address?: string | undefined;
        }>, "many">;
        effectiveDate: z.ZodString;
        expirationDate: z.ZodOptional<z.ZodString>;
        terms: z.ZodArray<z.ZodString, "many">;
        obligations: z.ZodOptional<z.ZodArray<z.ZodObject<{
            party: z.ZodString;
            obligation: z.ZodString;
        }, "strip", z.ZodTypeAny, {
            party: string;
            obligation: string;
        }, {
            party: string;
            obligation: string;
        }>, "many">>;
        signatures: z.ZodOptional<z.ZodArray<z.ZodObject<{
            party: z.ZodString;
            date: z.ZodString;
            signed: z.ZodBoolean;
        }, "strip", z.ZodTypeAny, {
            date: string;
            party: string;
            signed: boolean;
        }, {
            date: string;
            party: string;
            signed: boolean;
        }>, "many">>;
    }, "strip", z.ZodTypeAny, {
        title: string;
        parties: {
            name: string;
            role: string;
            address?: string | undefined;
        }[];
        effectiveDate: string;
        terms: string[];
        expirationDate?: string | undefined;
        obligations?: {
            party: string;
            obligation: string;
        }[] | undefined;
        signatures?: {
            date: string;
            party: string;
            signed: boolean;
        }[] | undefined;
    }, {
        title: string;
        parties: {
            name: string;
            role: string;
            address?: string | undefined;
        }[];
        effectiveDate: string;
        terms: string[];
        expirationDate?: string | undefined;
        obligations?: {
            party: string;
            obligation: string;
        }[] | undefined;
        signatures?: {
            date: string;
            party: string;
            signed: boolean;
        }[] | undefined;
    }>;
    /**
     * Research paper schema
     */
    static ResearchPaper: z.ZodObject<{
        title: z.ZodString;
        authors: z.ZodArray<z.ZodString, "many">;
        abstract: z.ZodString;
        keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
        sections: z.ZodArray<z.ZodObject<{
            title: z.ZodString;
            content: z.ZodString;
        }, "strip", z.ZodTypeAny, {
            title: string;
            content: string;
        }, {
            title: string;
            content: string;
        }>, "many">;
        references: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
        publishedDate: z.ZodOptional<z.ZodString>;
        doi: z.ZodOptional<z.ZodString>;
    }, "strip", z.ZodTypeAny, {
        title: string;
        authors: string[];
        abstract: string;
        sections: {
            title: string;
            content: string;
        }[];
        keywords?: string[] | undefined;
        references?: string[] | undefined;
        publishedDate?: string | undefined;
        doi?: string | undefined;
    }, {
        title: string;
        authors: string[];
        abstract: string;
        sections: {
            title: string;
            content: string;
        }[];
        keywords?: string[] | undefined;
        references?: string[] | undefined;
        publishedDate?: string | undefined;
        doi?: string | undefined;
    }>;
    /**
     * Form data schema
     */
    static FormData: z.ZodObject<{
        formTitle: z.ZodOptional<z.ZodString>;
        fields: z.ZodArray<z.ZodObject<{
            fieldName: z.ZodString;
            fieldValue: z.ZodString;
            fieldType: z.ZodOptional<z.ZodString>;
        }, "strip", z.ZodTypeAny, {
            fieldName: string;
            fieldValue: string;
            fieldType?: string | undefined;
        }, {
            fieldName: string;
            fieldValue: string;
            fieldType?: string | undefined;
        }>, "many">;
        submissionDate: z.ZodOptional<z.ZodString>;
    }, "strip", z.ZodTypeAny, {
        fields: {
            fieldName: string;
            fieldValue: string;
            fieldType?: string | undefined;
        }[];
        formTitle?: string | undefined;
        submissionDate?: string | undefined;
    }, {
        fields: {
            fieldName: string;
            fieldValue: string;
            fieldType?: string | undefined;
        }[];
        formTitle?: string | undefined;
        submissionDate?: string | undefined;
    }>;
    /**
     * Table extraction schema
     */
    static Table: z.ZodObject<{
        title: z.ZodOptional<z.ZodString>;
        headers: z.ZodArray<z.ZodString, "many">;
        rows: z.ZodArray<z.ZodArray<z.ZodString, "many">, "many">;
        pageNumber: z.ZodOptional<z.ZodNumber>;
    }, "strip", z.ZodTypeAny, {
        headers: string[];
        rows: string[][];
        title?: string | undefined;
        pageNumber?: number | undefined;
    }, {
        headers: string[];
        rows: string[][];
        title?: string | undefined;
        pageNumber?: number | undefined;
    }>;
}
/**
 * Schema builder utility for creating custom schemas
 */
export declare class SchemaBuilder {
    /**
     * Create a schema from a plain object structure
     */
    static fromObject(obj: Record<string, any>): ZodSchema;
    /**
     * Generate prompt text from Zod schema
     */
    static generatePromptFromSchema(schema: ZodType, schemaName?: string): string;
}
//# sourceMappingURL=zod-interfaces.d.ts.map