@hed-hog/operations 0.0.300 → 0.0.301

package/dist/operations.service.d.ts

@@ -1,11 +1,22 @@
 import { PrismaService } from '@hed-hog/api-prisma';
-import { IntegrationDeveloperApiService } from '@hed-hog/core';
+import { AiService, FileService, IntegrationDeveloperApiService, SettingService } from '@hed-hog/core';
+declare const CONTRACT_CATEGORY_VALUES: readonly ["employee", "contractor", "client", "supplier", "vendor", "partner", "internal", "other"];
+declare const CONTRACT_TYPE_VALUES: readonly ["clt", "pj", "freelancer_agreement", "service_agreement", "fixed_term", "recurring_service", "nda", "amendment", "addendum", "other"];
+declare const BILLING_MODEL_VALUES: readonly ["time_and_material", "monthly_retainer", "fixed_price"];
+declare const SIGNATURE_STATUS_VALUES: readonly ["not_started", "pending", "partially_signed", "signed", "expired"];
+declare const CONTRACT_STATUS_VALUES: readonly ["draft", "under_review", "active", "renewal", "expired", "closed", "archived"];
+declare const CONTRACT_CREATION_MODE_VALUES: readonly ["blank", "template", "upload", "duplicate"];
+declare const ORIGIN_TYPE_VALUES: readonly ["manual", "employee_hiring", "client_project", "crm_proposal"];
+declare const CONTRACT_DOCUMENT_TYPE_VALUES: readonly ["source_upload", "generated_pdf", "attachment", "other"];
+declare const CONTRACT_DOCUMENT_EXTRACTION_STATUS_VALUES: readonly ["pending", "processing", "completed", "failed", "skipped"];
 type CollaboratorPayload = {
-    userId: number;
-    code: string;
-    displayName: string;
+    userId?: number | null;
+    personId?: number | null;
+    code?: string | null;
+    displayName?: string | null;
     collaboratorType?: 'clt' | 'pj' | 'freelancer' | 'intern' | 'other';
     department?: string | null;
+    departmentId?: number | null;
     title?: string | null;
     levelLabel?: string | null;
     supervisorCollaboratorId?: number | null;
@@ -25,10 +36,16 @@ type CollaboratorPayload = {
     }>;
     notes?: string | null;
 };
+type DepartmentPayload = {
+    code?: string | null;
+    name?: string | null;
+    description?: string | null;
+    status?: 'active' | 'inactive';
+};
 type ContractPayload = {
-    code: string;
-    name: string;
-    clientName: string;
+    code?: string | null;
+    name?: string | null;
+    clientName?: string | null;
     contractCategory?: 'employee' | 'contractor' | 'client' | 'supplier' | 'vendor' | 'partner' | 'internal' | 'other';
     contractType?: 'clt' | 'pj' | 'freelancer_agreement' | 'service_agreement' | 'fixed_term' | 'recurring_service' | 'nda' | 'amendment' | 'addendum' | 'other';
     billingModel?: 'time_and_material' | 'monthly_retainer' | 'fixed_price';
@@ -36,15 +53,18 @@ type ContractPayload = {
     isActive?: boolean;
     accountManagerCollaboratorId?: number | null;
     relatedCollaboratorId?: number | null;
-    originType?: 'manual' | 'employee_hiring' | 'client_project';
+    contractTemplateId?: number | null;
+    originType?: 'manual' | 'employee_hiring' | 'client_project' | 'crm_proposal';
     originId?: number | null;
-    startDate: string;
+    startDate?: string | null;
     endDate?: string | null;
     signedAt?: string | null;
     effectiveDate?: string | null;
     budgetAmount?: number | null;
     monthlyHourCap?: number | null;
     status?: 'draft' | 'under_review' | 'active' | 'renewal' | 'expired' | 'closed' | 'archived';
+    creationMode?: 'blank' | 'template' | 'upload' | 'duplicate';
+    wizardStep?: number | null;
     description?: string | null;
     contentHtml?: string | null;
     parties?: Array<{
@@ -79,14 +99,206 @@ type ContractPayload = {
         summary?: string | null;
     }>;
     replaceUploadedPdfDocument?: {
+        fileId?: number | null;
         fileName: string;
         mimeType: string;
-        fileContentBase64: string;
+        fileContentBase64?: string | null;
+        notes?: string | null;
+        extractionStatus?: 'pending' | 'processing' | 'completed' | 'failed' | 'skipped';
+        extractionSummary?: string | null;
+    } | null;
+};
+type ContractDraftPayload = {
+    creationMode?: 'blank' | 'template' | 'upload' | 'duplicate' | null;
+    templateId?: number | null;
+    duplicateFromId?: number | null;
+    sourceFileId?: number | null;
+    sourceFileName?: string | null;
+    sourceMimeType?: string | null;
+};
+type ProposalApprovedEventPayload = {
+    proposalId?: number;
+    proposalRevisionId?: number | null;
+    personId?: number | null;
+    approvedByUserId?: number | null;
+    approvedAt?: string | null;
+    correlationId?: string | null;
+    sourceModule?: string | null;
+    sourceEntity?: string | null;
+    sourceId?: string | null;
+    source_module?: string | null;
+    source_entity?: string | null;
+    source_id?: string | null;
+    code?: string | null;
+    title?: string | null;
+    version?: number | null;
+    total?: number | null;
+    currency?: string | null;
+    locale?: string | null;
+    validFrom?: string | null;
+    validUntil?: string | null;
+    commercialTerms?: {
+        contractCategory?: ContractPayload['contractCategory'];
+        contractType?: ContractPayload['contractType'];
+        billingModel?: ContractPayload['billingModel'];
+        validFrom?: string | null;
+        validUntil?: string | null;
+        notes?: string | null;
+    } | null;
+    proposal?: {
+        code?: string | null;
+        title?: string | null;
+        contractCategory?: ContractPayload['contractCategory'];
+        contractType?: ContractPayload['contractType'];
+        billingModel?: ContractPayload['billingModel'];
+        validFrom?: string | null;
+        validUntil?: string | null;
+        totalAmount?: number | null;
+        totalAmountCents?: number | null;
         notes?: string | null;
+    };
+    person?: {
+        id?: number | null;
+        name?: string | null;
+        tradeName?: string | null;
+        email?: string | null;
+        phone?: string | null;
+        document?: string | null;
     } | null;
+    revision?: {
+        id?: number | null;
+        revisionNumber?: number | null;
+        title?: string | null;
+        summary?: string | null;
+        contentHtml?: string | null;
+    } | null;
+    items?: Array<{
+        name?: string | null;
+        description?: string | null;
+        termType?: ContractPayload['financialTerms'][number]['termType'];
+        recurrence?: ContractPayload['financialTerms'][number]['recurrence'];
+        dueDay?: number | null;
+        amount?: number | null;
+        totalAmountCents?: number | null;
+    }>;
+};
+type ContractTemplatePayload = {
+    code?: string | null;
+    name?: string | null;
+    description?: string | null;
+    contractCategory?: 'employee' | 'contractor' | 'client' | 'supplier' | 'vendor' | 'partner' | 'internal' | 'other';
+    contractType?: 'clt' | 'pj' | 'freelancer_agreement' | 'service_agreement' | 'fixed_term' | 'recurring_service' | 'nda' | 'amendment' | 'addendum' | 'other';
+    billingModel?: 'time_and_material' | 'monthly_retainer' | 'fixed_price';
+    signatureStatus?: 'not_started' | 'pending' | 'partially_signed' | 'signed' | 'expired';
+    isActive?: boolean;
+    status?: 'draft' | 'active' | 'inactive' | 'archived';
+    contentHtml?: string | null;
+};
+type ContractExtractDraftPayload = {
+    contractId?: number | null;
+    fileName?: string | null;
+    mimeType?: string | null;
+    fileContentBase64?: string | null;
+    provider?: 'openai' | 'gemini' | null;
+    promptMessage?: string | null;
+};
+type ContractGenerateContentPayload = {
+    provider?: 'openai' | 'gemini' | null;
+    promptMessage?: string | null;
+    overwrite?: boolean;
+};
+type ContractLegalReviewPayload = {
+    provider?: 'openai' | 'gemini' | null;
+    promptMessage?: string | null;
+};
+type ContractLegalReviewResult = {
+    summary: string;
+    missingFields: string[];
+    warnings: string[];
+    checklist: string[];
+    status: 'ready_for_revision' | 'attention_required';
+    reviewedAt: string;
+};
+type ContractProjectSummary = {
+    id: number;
+    code: string;
+    name: string;
+    status: string;
+};
+type ContractScheduleDay = {
+    weekday: string;
+    isWorkingDay: boolean;
+    startTime: string | null;
+    endTime: string | null;
+    breakMinutes: number | null;
+};
+type ContractDocumentRecord = {
+    id: number;
+    documentType: (typeof CONTRACT_DOCUMENT_TYPE_VALUES)[number];
+    fileId: number | null;
+    fileName: string;
+    mimeType: string;
+    fileContentBase64: string | null;
+    isCurrent: boolean;
+    extractionStatus: (typeof CONTRACT_DOCUMENT_EXTRACTION_STATUS_VALUES)[number] | null;
+    extractionSummary: string | null;
+    notes: string | null;
+    createdAt: string;
+};
+type ContractHistoryRecord = {
+    id: number;
+    actorUserId: number | null;
+    action: string;
+    note: string | null;
+    metadataJson: string | null;
+    createdAt: string;
+};
+type ContractDetailRecord = {
+    id: number;
+    code: string;
+    name: string | null;
+    contractCategory: (typeof CONTRACT_CATEGORY_VALUES)[number];
+    contractType: (typeof CONTRACT_TYPE_VALUES)[number];
+    clientName: string | null;
+    signatureStatus: (typeof SIGNATURE_STATUS_VALUES)[number];
+    isActive: boolean;
+    billingModel: (typeof BILLING_MODEL_VALUES)[number];
+    accountManagerCollaboratorId: number | null;
+    relatedCollaboratorId: number | null;
+    contractTemplateId: number | null;
+    contractTemplateName: string | null;
+    contractTemplateSlug: string | null;
+    contractTemplateCode: string | null;
+    originType: (typeof ORIGIN_TYPE_VALUES)[number];
+    originId: number | null;
+    startDate: string | null;
+    endDate: string | null;
+    signedAt: string | null;
+    effectiveDate: string | null;
+    budgetAmount: number | null;
+    monthlyHourCap: number | null;
+    status: (typeof CONTRACT_STATUS_VALUES)[number];
+    creationMode: (typeof CONTRACT_CREATION_MODE_VALUES)[number] | null;
+    wizardStep: number | null;
+    description: string | null;
+    contentHtml: string | null;
+    accountManagerName: string | null;
+    relatedCollaboratorName: string | null;
+};
+type ContractDetailsRecord = ContractDetailRecord & {
+    mainRelatedPartyName: string | null;
+    projects: ContractProjectSummary[];
+    scheduleSummary: ContractScheduleDay[];
+    parties: NonNullable<ContractPayload['parties']>;
+    signatures: NonNullable<ContractPayload['signatures']>;
+    financialTerms: NonNullable<ContractPayload['financialTerms']>;
+    documents: ContractDocumentRecord[];
+    revisions: NonNullable<ContractPayload['revisions']>;
+    history: ContractHistoryRecord[];
 };
 type ProjectPayload = {
     contractId?: number | null;
+    contractTemplateId?: number | null;
     managerCollaboratorId?: number | null;
     code: string;
     name: string;
@@ -170,8 +382,11 @@ type PublishAccountsPayableReferencePayload = {
 };
 export declare class OperationsService {
     private readonly prisma;
+    private readonly aiService;
     private readonly integrationApi;
-    constructor(prisma: PrismaService, integrationApi: IntegrationDeveloperApiService);
+    private readonly fileService;
+    private readonly settingService;
+    constructor(prisma: PrismaService, aiService: AiService, integrationApi: IntegrationDeveloperApiService, fileService: FileService, settingService: SettingService);
     getDashboard(userId: number): Promise<{
         actor: {
             roleScope: string;
@@ -214,10 +429,14 @@ export declare class OperationsService {
         };
         scheduleAdjustmentRequests: Record<string, unknown>[];
         id: number;
-        userId: number;
+        userId: number | null;
+        personId: number | null;
+        personName: string | null;
+        personAvatarId: number | null;
         code: string;
         collaboratorType: string;
         displayName: string;
+        departmentId: number | null;
         department: string | null;
         title: string | null;
         levelLabel: string | null;
@@ -248,10 +467,14 @@ export declare class OperationsService {
         };
         scheduleAdjustmentRequests: Record<string, unknown>[];
         id: number;
-        userId: number;
+        userId: number | null;
+        personId: number | null;
+        personName: string | null;
+        personAvatarId: number | null;
         code: string;
         collaboratorType: string;
         displayName: string;
+        departmentId: number | null;
         department: string | null;
         title: string | null;
         levelLabel: string | null;
@@ -296,10 +519,14 @@ export declare class OperationsService {
         };
         scheduleAdjustmentRequests: Record<string, unknown>[];
         id: number;
-        userId: number;
+        userId: number | null;
+        personId: number | null;
+        personName: string | null;
+        personAvatarId: number | null;
         code: string;
         collaboratorType: string;
         displayName: string;
+        departmentId: number | null;
         department: string | null;
         title: string | null;
         levelLabel: string | null;
@@ -330,10 +557,14 @@ export declare class OperationsService {
         };
         scheduleAdjustmentRequests: Record<string, unknown>[];
         id: number;
-        userId: number;
+        userId: number | null;
+        personId: number | null;
+        personName: string | null;
+        personAvatarId: number | null;
         code: string;
         collaboratorType: string;
         displayName: string;
+        departmentId: number | null;
         department: string | null;
         title: string | null;
         levelLabel: string | null;
@@ -348,6 +579,29 @@ export declare class OperationsService {
         contractStatus: string | null;
         activeAssignments: number;
     }>;
+    listDepartments(userId: number): Promise<Record<string, unknown>[]>;
+    createDepartment(userId: number, data: DepartmentPayload): Promise<{
+        id: number;
+        slug: string;
+        code: string | null;
+        name: string;
+        description: string | null;
+        createdAt: string | null;
+        updatedAt: string | null;
+        deletedAt: string | null;
+        status: "active" | "inactive";
+    }>;
+    updateDepartment(userId: number, departmentId: number, data: Partial<DepartmentPayload>): Promise<{
+        id: number;
+        slug: string;
+        code: string | null;
+        name: string;
+        description: string | null;
+        createdAt: string | null;
+        updatedAt: string | null;
+        deletedAt: string | null;
+        status: "active" | "inactive";
+    }>;
     listProjects(userId: number): Promise<Record<string, unknown>[]>;
     getProjectById(userId: number, projectId: number): Promise<{
         assignments: {
@@ -487,39 +741,191 @@ export declare class OperationsService {
         myRoleLabel: string | null;
         teamSize: number;
     }>;
+    listContractTemplates(userId: number): Promise<Record<string, unknown>[]>;
+    getContractTemplateById(userId: number, templateId: number): Promise<{
+        id: number;
+        slug: string;
+        code: string | null;
+        name: string;
+        description: string | null;
+        contractCategory: string | null;
+        contractType: string | null;
+        billingModel: string | null;
+        signatureStatus: string | null;
+        isActive: boolean;
+        status: string | null;
+        contentHtml: string | null;
+        usageCount: number;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    createContractTemplate(userId: number, data: ContractTemplatePayload): Promise<{
+        id: number;
+        slug: string;
+        code: string | null;
+        name: string;
+        description: string | null;
+        contractCategory: string | null;
+        contractType: string | null;
+        billingModel: string | null;
+        signatureStatus: string | null;
+        isActive: boolean;
+        status: string | null;
+        contentHtml: string | null;
+        usageCount: number;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    updateContractTemplate(userId: number, templateId: number, data: Partial<ContractTemplatePayload>): Promise<{
+        id: number;
+        slug: string;
+        code: string | null;
+        name: string;
+        description: string | null;
+        contractCategory: string | null;
+        contractType: string | null;
+        billingModel: string | null;
+        signatureStatus: string | null;
+        isActive: boolean;
+        status: string | null;
+        contentHtml: string | null;
+        usageCount: number;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
     listContracts(userId: number): Promise<Record<string, unknown>[]>;
-    getContractById(userId: number, contractId: number): Promise<{
-        mainRelatedPartyName: unknown;
-        projects: Record<string, unknown>[];
-        scheduleSummary: any[];
-        parties: Record<string, unknown>[];
-        signatures: Record<string, unknown>[];
-        financialTerms: Record<string, unknown>[];
-        documents: Record<string, unknown>[];
-        revisions: Record<string, unknown>[];
-        history: Record<string, unknown>[];
+    getContractById(userId: number, contractId: number): Promise<ContractDetailsRecord>;
+    createContract(userId: number, data: ContractPayload): Promise<ContractDetailsRecord>;
+    createContractDraft(userId: number, data: ContractDraftPayload): Promise<ContractDetailsRecord>;
+    extractContractSource(userId: number, contractId: number, data: Omit<ContractExtractDraftPayload, 'fileName' | 'mimeType' | 'fileContentBase64' | 'contractId'>): Promise<{
+        warnings: string[];
+        summary: string;
+        missingFields: string[];
+        code: string;
+        name: string;
+        clientName: string;
+        contractCategory: "other" | "client" | "internal" | "employee" | "contractor" | "supplier" | "vendor" | "partner";
+        contractType: "other" | "clt" | "pj" | "freelancer_agreement" | "service_agreement" | "fixed_term" | "recurring_service" | "nda" | "amendment" | "addendum";
+        signatureStatus: "pending" | "expired" | "not_started" | "partially_signed" | "signed";
+        isActive: boolean;
+        billingModel: "time_and_material" | "monthly_retainer" | "fixed_price";
+        originType: "manual" | "employee_hiring" | "client_project" | "crm_proposal";
+        originId: string;
+        startDate: string;
+        endDate: string;
+        signedAt: string;
+        effectiveDate: string;
+        budgetAmount: string | number;
+        monthlyHourCap: string | number;
+        status: "active" | "draft" | "expired" | "archived" | "closed" | "under_review" | "renewal";
+        description: string;
+        contentHtml: string;
+        parties: {
+            displayName: string;
+            partyRole: "other" | "client" | "employee" | "supplier" | "vendor" | "partner" | "employer" | "witness" | "internal_owner";
+            partyType: "other" | "individual" | "company" | "internal_team";
+            documentNumber: string;
+            email: string;
+            phone: string;
+            isPrimary: boolean;
+        }[];
+        signatures: {
+            signerName: string;
+            signerRole: string;
+            signerEmail: string;
+            status: "rejected" | "pending" | "signed";
+            signedAt: string;
+        }[];
+        financialTerms: {
+            label: string;
+            termType: "value" | "other" | "revenue" | "payment" | "fine";
+            amount: string | number;
+            recurrence: "other" | "one_time" | "monthly" | "quarterly" | "yearly";
+            dueDay: string | number;
+            notes: string;
+        }[];
+        revisions: {
+            title: string;
+            revisionType: "other" | "amendment" | "addendum" | "renewal" | "revision";
+            effectiveDate: string;
+            status: "active" | "draft" | "completed" | "cancelled";
+            summary: string;
+        }[];
+    }>;
+    generateContractContent(userId: number, contractId: number, data?: ContractGenerateContentPayload): Promise<ContractDetailsRecord>;
+    reviewContractLegally(userId: number, contractId: number, data?: ContractLegalReviewPayload): Promise<ContractLegalReviewResult>;
+    generateContractPdf(userId: number, contractId: number): Promise<{
+        contractId: number;
+        fileId: number;
+        fileName: string;
+        mimeType: string;
+        documentType: string;
+        downloadUrl: string;
     }>;
-    createContract(userId: number, data: ContractPayload): Promise<{
-        mainRelatedPartyName: unknown;
-        projects: Record<string, unknown>[];
-        scheduleSummary: any[];
-        parties: Record<string, unknown>[];
-        signatures: Record<string, unknown>[];
-        financialTerms: Record<string, unknown>[];
-        documents: Record<string, unknown>[];
-        revisions: Record<string, unknown>[];
-        history: Record<string, unknown>[];
+    extractContractDraft(userId: number, data: ContractExtractDraftPayload): Promise<{
+        warnings: string[];
+        summary: string;
+        missingFields: string[];
+        code: string;
+        name: string;
+        clientName: string;
+        contractCategory: "other" | "client" | "internal" | "employee" | "contractor" | "supplier" | "vendor" | "partner";
+        contractType: "other" | "clt" | "pj" | "freelancer_agreement" | "service_agreement" | "fixed_term" | "recurring_service" | "nda" | "amendment" | "addendum";
+        signatureStatus: "pending" | "expired" | "not_started" | "partially_signed" | "signed";
+        isActive: boolean;
+        billingModel: "time_and_material" | "monthly_retainer" | "fixed_price";
+        originType: "manual" | "employee_hiring" | "client_project" | "crm_proposal";
+        originId: string;
+        startDate: string;
+        endDate: string;
+        signedAt: string;
+        effectiveDate: string;
+        budgetAmount: string | number;
+        monthlyHourCap: string | number;
+        status: "active" | "draft" | "expired" | "archived" | "closed" | "under_review" | "renewal";
+        description: string;
+        contentHtml: string;
+        parties: {
+            displayName: string;
+            partyRole: "other" | "client" | "employee" | "supplier" | "vendor" | "partner" | "employer" | "witness" | "internal_owner";
+            partyType: "other" | "individual" | "company" | "internal_team";
+            documentNumber: string;
+            email: string;
+            phone: string;
+            isPrimary: boolean;
+        }[];
+        signatures: {
+            signerName: string;
+            signerRole: string;
+            signerEmail: string;
+            status: "rejected" | "pending" | "signed";
+            signedAt: string;
+        }[];
+        financialTerms: {
+            label: string;
+            termType: "value" | "other" | "revenue" | "payment" | "fine";
+            amount: string | number;
+            recurrence: "other" | "one_time" | "monthly" | "quarterly" | "yearly";
+            dueDay: string | number;
+            notes: string;
+        }[];
+        revisions: {
+            title: string;
+            revisionType: "other" | "amendment" | "addendum" | "renewal" | "revision";
+            effectiveDate: string;
+            status: "active" | "draft" | "completed" | "cancelled";
+            summary: string;
+        }[];
+    }>;
+    createContractFromProposalIntegration(payload: ProposalApprovedEventPayload): Promise<{
+        id: number;
+        code: string;
     }>;
-    updateContract(userId: number, contractId: number, data: Partial<ContractPayload>): Promise<{
-        mainRelatedPartyName: unknown;
-        projects: Record<string, unknown>[];
-        scheduleSummary: any[];
-        parties: Record<string, unknown>[];
-        signatures: Record<string, unknown>[];
-        financialTerms: Record<string, unknown>[];
-        documents: Record<string, unknown>[];
-        revisions: Record<string, unknown>[];
-        history: Record<string, unknown>[];
+    private buildContractCreatedEventPayload;
+    private buildContractActivatedEventPayload;
+    updateContract(userId: number, contractId: number, data: Partial<ContractPayload>): Promise<ContractDetailsRecord>;
+    removeContract(userId: number, contractId: number): Promise<{
+        success: boolean;
     }>;
     listTimesheets(userId: number): Promise<{
         id: number;
@@ -571,6 +977,18 @@ export declare class OperationsService {
     private getActorContext;
     private getCollaboratorByUserId;
     private getCollaboratorById;
+    private getPersonById;
+    private getDepartmentById;
+    private assertDepartmentNameAvailable;
+    private assertDepartmentCodeAvailable;
+    private resolveDepartmentReference;
+    private generateUniqueDepartmentSlug;
+    private getContractTemplateRecord;
+    private assertContractTemplateNameAvailable;
+    private assertContractTemplateCodeAvailable;
+    private generateUniqueContractTemplateSlug;
+    private slugifyValue;
+    private normalizeOptionalText;
     private getProjectDetails;
     private getCollaboratorDetails;
     private getDirectReportIds;
@@ -598,8 +1016,34 @@ export declare class OperationsService {
     private replaceContractSignatures;
     private replaceContractFinancialTerms;
     private replaceContractRevisions;
-    private replaceContractPdfDocument;
+    private replaceContractDocument;
+    private resolveContractExtractionFile;
+    private buildContractExtractionFile;
+    private renderContractPdfBuffer;
+    private buildContractPdfHtml;
+    private resolveContractPdfLogoUrl;
+    private buildContractPdfFileName;
+    private humanizeEnumLabel;
+    private escapeHtml;
     private insertContractHistory;
+    private generateCollaboratorCode;
+    private generateContractCode;
+    private generateContractContentHtml;
+    private buildFallbackContractContent;
+    private buildContractLegalReview;
+    private buildHeuristicContractLegalReview;
+    private buildContractExtractionSystemPrompt;
+    private parseAiJsonPayload;
+    private normalizeContractExtractDraft;
+    private normalizeExtractionString;
+    private normalizeExtractionBoolean;
+    private normalizeExtractionNumber;
+    private normalizeExtractionDate;
+    private normalizeStringList;
+    private normalizeObjectList;
+    private normalizeEnumValue;
+    private normalizeContractExtractionMimeType;
+    private isAllowedContractExtractionMimeType;
     private requireFields;
     private buildIdFilter;
     private uniqueNumbers;