@litusarchieve18/agricore-utils 1.0.13 → 1.0.15

package/README.md

@@ -183,7 +183,11 @@ Run the publish command:
 Bash
 npm publish --access public
 📝 Version History
-V1.0.12 — add DocumentMenuMap and refactoring library code to export enum
+V1.0.15 — add some standardized enum and types for CAR 
+
+V1.0.14 — add DOCUMENT_DISPLAY_INFO do manage the grouping and a little description for UI 
+
+V1.0.13 — add DocumentMenuMap and refactoring library code to export enum
 
 V1.0.12 — add some functionality to add a file tag
 

package/dist/{chunk-QI4YXI4P.mjs → chunk-LYIT2TMM.mjs}

@@ -140,7 +140,10 @@ var TaskType = {
   KML_PARSE: "KML_PARSE",
   INVOICE_OCR: "INVOICE_OCR",
   AUDIT_UPLOAD: "AUDIT_UPLOAD",
-  REPORT_GEN: "REPORT_GEN"
+  REPORT_GEN: "REPORT_GEN",
+  PDF_STAMPING: "PDF_STAMPING",
+  CAR_TEMPLATE_UPLOAD: "CAR_TEMPLATE_UPLOAD",
+  CORRECTIVE_ACTION_COMPILE: "CORRECTIVE_ACTION_COMPILE"
 };
 var TaskStatus = {
   PENDING: "PENDING",
@@ -499,6 +502,194 @@ var DocumentType = /* @__PURE__ */ ((DocumentType2) => {
   DocumentType2["SENSITIVE_IDENTITY"] = "SENSITIVE_IDENTITY";
   return DocumentType2;
 })(DocumentType || {});
+var DocumentCategory = /* @__PURE__ */ ((DocumentCategory2) => {
+  DocumentCategory2["AGRONOMY_TESTING"] = "Agronomy & Testing";
+  DocumentCategory2["FARM_OPERATIONS"] = "Farm Operations";
+  DocumentCategory2["COMPLIANCE_QA"] = "Compliance & Quality";
+  DocumentCategory2["INVENTORY_LOG"] = "Inventory & Logistics";
+  DocumentCategory2["ASSETS_MAINT"] = "Assets & Maintenance";
+  DocumentCategory2["HR_LEGAL_SAFETY"] = "HR, Legal & Safety";
+  DocumentCategory2["FINANCE_ADMIN"] = "Finance & Admin";
+  return DocumentCategory2;
+})(DocumentCategory || {});
+var DOCUMENT_DISPLAY_INFO = {
+  // --- AGRONOMY & TESTING ---
+  ["SOIL_TEST" /* SOIL_TEST */]: {
+    label: "Soil Analysis",
+    description: "Detailed lab results for soil nutrients, pH, and health.",
+    category: "Agronomy & Testing" /* AGRONOMY_TESTING */
+  },
+  ["LEAF_TEST" /* LEAF_TEST */]: {
+    label: "Leaf & Tissue Test",
+    description: "Nutrient analysis of plant tissue samples.",
+    category: "Agronomy & Testing" /* AGRONOMY_TESTING */
+  },
+  ["WATER_TEST" /* WATER_TEST */]: {
+    label: "Water Quality Test",
+    description: "Testing for irrigation suitability and microbial levels.",
+    category: "Agronomy & Testing" /* AGRONOMY_TESTING */
+  },
+  ["MRL_TESTING" /* MRL_TESTING */]: {
+    label: "MRL Residue Analysis",
+    description: "Maximum Residue Limit reports for chemical compliance.",
+    category: "Agronomy & Testing" /* AGRONOMY_TESTING */
+  },
+  ["HEAVY_METAL" /* HEAVY_METAL */]: {
+    label: "Heavy Metal Analysis",
+    description: "Testing for lead, cadmium, and other metal contaminants.",
+    category: "Agronomy & Testing" /* AGRONOMY_TESTING */
+  },
+  ["MICROBIAL" /* MICROBIAL */]: {
+    label: "Microbial Testing",
+    description: "Pathogen detection reports (e.g., E. coli, Salmonella).",
+    category: "Agronomy & Testing" /* AGRONOMY_TESTING */
+  },
+  // --- FARM OPERATIONS ---
+  ["SPRAY_RECORD" /* SPRAY_RECORD */]: {
+    label: "Spray Operations",
+    description: "Chemical application logs and weather conditions.",
+    category: "Farm Operations" /* FARM_OPERATIONS */
+  },
+  ["FERTIGATION_RECORD" /* FERTIGATION_RECORD */]: {
+    label: "Fertigation Logs",
+    description: "Records of liquid fertilizer applied via irrigation.",
+    category: "Farm Operations" /* FARM_OPERATIONS */
+  },
+  ["FERTILIZER_RECORD" /* FERTILIZER_RECORD */]: {
+    label: "Fertilizer Records",
+    description: "Manual granular or bulk fertilizer application logs.",
+    category: "Farm Operations" /* FARM_OPERATIONS */
+  },
+  ["HARVEST_LOG" /* HARVEST_LOG */]: {
+    label: "Harvest Manifests",
+    description: "Daily picking volumes and block yield data.",
+    category: "Farm Operations" /* FARM_OPERATIONS */
+  },
+  ["PACKHOUSE_INSPECTION" /* PACKHOUSE_INSPECTION */]: {
+    label: "Packhouse Inspections",
+    description: "Quality and hygiene checks conducted in the packhouse.",
+    category: "Farm Operations" /* FARM_OPERATIONS */
+  },
+  ["MAPPING_TRAFIC_MANAGEMENT" /* MAPPING_TRAFIC_MANAGEMENT */]: {
+    label: "Traffic Management",
+    description: "Maps and rules for vehicle and heavy machinery movement.",
+    category: "Farm Operations" /* FARM_OPERATIONS */
+  },
+  // --- COMPLIANCE & QUALITY ---
+  ["QA" /* QA */]: {
+    label: "Quality Assurance",
+    description: "General product quality checks and grading standards.",
+    category: "Compliance & Quality" /* COMPLIANCE_QA */
+  },
+  ["PEST" /* PEST */]: {
+    label: "Pest & Disease Monitoring",
+    description: "Scouting reports and pest pressure assessments.",
+    category: "Compliance & Quality" /* COMPLIANCE_QA */
+  },
+  ["AUDIT_REPORT" /* AUDIT_REPORT */]: {
+    label: "External Audit Reports",
+    description: "Final results from Freshcare, GlobalGAP, or Organic audits.",
+    category: "Compliance & Quality" /* COMPLIANCE_QA */
+  },
+  ["RISK_ASSESSMENTS" /* RISK_ASSESSMENTS */]: {
+    label: "Risk Assessments",
+    description: "Operational hazard identification and safety mitigations.",
+    category: "Compliance & Quality" /* COMPLIANCE_QA */
+  },
+  // --- ASSETS & MAINTENANCE ---
+  ["SERVICING_MAINTENANCE" /* SERVICING_MAINTENANCE */]: {
+    label: "Equipment Maintenance",
+    description: "Service history and repair logs for farm machinery.",
+    category: "Assets & Maintenance" /* ASSETS_MAINT */
+  },
+  ["EQUIPMENT_CALIBRATION_RECORD" /* EQUIPMENT_CALIBRATION_RECORD */]: {
+    label: "Calibration Records",
+    description: "Accuracy checks for sprayers, scales, and moisture probes.",
+    category: "Assets & Maintenance" /* ASSETS_MAINT */
+  },
+  ["CLEANING" /* CLEANING */]: {
+    label: "Sanitation Logs",
+    description: "Daily/weekly cleaning schedules for tools and facilities.",
+    category: "Assets & Maintenance" /* ASSETS_MAINT */
+  },
+  ["MAPPING_FARM_MAPS" /* MAPPING_FARM_MAPS */]: {
+    label: "Farm Infrastructure Maps",
+    description: "Layouts of blocks, irrigation, and fixed assets.",
+    category: "Assets & Maintenance" /* ASSETS_MAINT */
+  },
+  // --- INVENTORY & LOGISTICS ---
+  ["INVENTORY_CHEMICALS" /* INVENTORY_CHEMICALS */]: {
+    label: "Chemical Inventory",
+    description: "Manifests for stored pesticides and fertilizers.",
+    category: "Inventory & Logistics" /* INVENTORY_LOG */
+  },
+  ["INVENTORY_BOX_CARTON" /* INVENTORY_BOX_CARTON */]: {
+    label: "Packaging Inventory",
+    description: "Stock levels for cartons, bins, and packaging materials.",
+    category: "Inventory & Logistics" /* INVENTORY_LOG */
+  },
+  ["INVENTORY_CONSUMABLES" /* INVENTORY_CONSUMABLES */]: {
+    label: "General Consumables",
+    description: "Stock tracking for fuel, PPE, and workshop supplies.",
+    category: "Inventory & Logistics" /* INVENTORY_LOG */
+  },
+  ["STOCKTAKE" /* STOCKTAKE */]: {
+    label: "Physical Stocktake",
+    description: "Periodic audits of physical vs. recorded stock levels.",
+    category: "Inventory & Logistics" /* INVENTORY_LOG */
+  },
+  ["STOCKTAKE_MSDS" /* STOCKTAKE_MSDS */]: {
+    label: "MSDS / Safety Data",
+    description: "Material Safety Data Sheets for stored chemicals.",
+    category: "Inventory & Logistics" /* INVENTORY_LOG */
+  },
+  // --- HR, LEGAL & SAFETY ---
+  ["TRAINING_RECORDS" /* TRAINING_RECORDS */]: {
+    label: "Staff Inductions",
+    description: "General staff onboarding and safety training logs.",
+    category: "HR, Legal & Safety" /* HR_LEGAL_SAFETY */
+  },
+  ["TRAINING_CERTIFICATE" /* TRAINING_CERTIFICATE */]: {
+    label: "Training Certificates",
+    description: "External licenses, ChemCert, and first aid tickets.",
+    category: "HR, Legal & Safety" /* HR_LEGAL_SAFETY */
+  },
+  ["SOPS" /* SOPS */]: {
+    label: "Standard Procedures (SOPs)",
+    description: "Formalized instructions for farm and packhouse tasks.",
+    category: "HR, Legal & Safety" /* HR_LEGAL_SAFETY */
+  },
+  ["LEGAL_CONTRACT" /* LEGAL_CONTRACT */]: {
+    label: "Legal Contracts",
+    description: "Lease agreements, supply contracts, and employment terms.",
+    category: "HR, Legal & Safety" /* HR_LEGAL_SAFETY */
+  },
+  ["INCIDENT_REPORT" /* INCIDENT_REPORT */]: {
+    label: "Incident Reports",
+    description: "Logs of injuries, near-misses, or property damage.",
+    category: "HR, Legal & Safety" /* HR_LEGAL_SAFETY */
+  },
+  ["SENSITIVE_IDENTITY" /* SENSITIVE_IDENTITY */]: {
+    label: "Identity & Visas",
+    description: "Sensitive data: Passports, ID cards, and work permits.",
+    category: "HR, Legal & Safety" /* HR_LEGAL_SAFETY */
+  },
+  ["MAPPING_EMERGENCY" /* MAPPING_EMERGENCY */]: {
+    label: "Emergency Response Maps",
+    description: "Evacuation routes and emergency assembly points.",
+    category: "HR, Legal & Safety" /* HR_LEGAL_SAFETY */
+  },
+  // --- FINANCE & ADMIN ---
+  ["INVOICE" /* INVOICE */]: {
+    label: "Supplier Invoices",
+    description: "Billing records for inputs, utilities, and services.",
+    category: "Finance & Admin" /* FINANCE_ADMIN */
+  }
+};
+var CATEGORY_TABS = [
+  "All",
+  ...Object.values(DocumentCategory)
+];
 var DOCUMENT_MENU_MAP = {
   ["SPRAY_RECORD" /* SPRAY_RECORD */]: [RESOURCE_PATHS.farmManagement],
   ["FERTIGATION_RECORD" /* FERTIGATION_RECORD */]: [RESOURCE_PATHS.farmManagement],
@@ -534,6 +725,36 @@ var DOCUMENT_MENU_MAP = {
   ["AUDIT_REPORT" /* AUDIT_REPORT */]: [RESOURCE_PATHS.safetyAuditing, RESOURCE_PATHS.dashboard],
   ["SENSITIVE_IDENTITY" /* SENSITIVE_IDENTITY */]: [RESOURCE_PATHS.adminUserRoster]
 };
+var SIGNATURE_MODES = {
+  TYPED_NAME: "typed_name",
+  DRAWN_IMAGE: "drawn_image",
+  UPLOADED_IMAGE: "uploaded_image"
+};
+var CORRECTIVE_ACTION_STATUSES = {
+  DRAFT: "draft",
+  GENERATED: "generated",
+  REVIEWED: "reviewed",
+  CLOSED: "closed",
+  FAILED: "failed"
+};
+var TEMPLATE_SCOPE_LEVELS = {
+  FACILITY: "facility",
+  LEGAL_ENTITY: "legalEntity",
+  COMPANY: "company"
+};
+var CORRECTIVE_ACTION_GENERATION_SOURCES = {
+  CREATE: "CREATE",
+  RECREATE: "RECREATE"
+};
+var CAR_SUPPORTED_EVIDENCE_MIME_TYPES = [
+  "application/pdf",
+  "image/png",
+  "image/jpeg"
+];
+var CAR_SUPPORTED_SIGNATURE_MIME_TYPES = [
+  "image/png",
+  "image/jpeg"
+];
 
 export {
   MOD,
@@ -581,5 +802,14 @@ export {
   EVERYONE,
   RESOURCE_REQUIREMENTS,
   DocumentType,
-  DOCUMENT_MENU_MAP
+  DocumentCategory,
+  DOCUMENT_DISPLAY_INFO,
+  CATEGORY_TABS,
+  DOCUMENT_MENU_MAP,
+  SIGNATURE_MODES,
+  CORRECTIVE_ACTION_STATUSES,
+  TEMPLATE_SCOPE_LEVELS,
+  CORRECTIVE_ACTION_GENERATION_SOURCES,
+  CAR_SUPPORTED_EVIDENCE_MIME_TYPES,
+  CAR_SUPPORTED_SIGNATURE_MIME_TYPES
 };

package/dist/{constants-DxCjnH4L.d.mts → constants-DOmJizGn.d.mts}

@@ -76,6 +76,82 @@ interface InfrastructureFields {
     facilityId: string | null;
     authScopeId: string;
 }
+/**
+ * Base44 ID alias for readability only.
+ * Still just string at runtime.
+ */
+type Base44Id = string;
+/**
+ * Canonical UUID alias for readability only.
+ */
+type CanonicalId = string;
+/**
+ * Derived union types from constants.
+ */
+type SignatureMode = typeof SIGNATURE_MODES[keyof typeof SIGNATURE_MODES];
+type CorrectiveActionStatus = typeof CORRECTIVE_ACTION_STATUSES[keyof typeof CORRECTIVE_ACTION_STATUSES];
+type FileUploadTaskType = typeof TaskType[keyof typeof TaskType];
+type TemplateScopeLevel = typeof TEMPLATE_SCOPE_LEVELS[keyof typeof TEMPLATE_SCOPE_LEVELS];
+type CorrectiveActionGenerationSource = typeof CORRECTIVE_ACTION_GENERATION_SOURCES[keyof typeof CORRECTIVE_ACTION_GENERATION_SOURCES];
+type CarSupportedEvidenceMimeType = typeof CAR_SUPPORTED_EVIDENCE_MIME_TYPES[number];
+type CarSupportedSignatureMimeType = typeof CAR_SUPPORTED_SIGNATURE_MIME_TYPES[number];
+/**
+* Shared signature payload used by create/preview CAR requests.
+* typed_name stores text only.
+* drawn_image / uploaded_image store a FileAsset Base44 ID.
+*/
+type SignatureInput = {
+    mode: typeof SIGNATURE_MODES.TYPED_NAME;
+    typedName: string;
+    fileAssetId?: null;
+} | {
+    mode: typeof SIGNATURE_MODES.DRAWN_IMAGE | typeof SIGNATURE_MODES.UPLOADED_IMAGE;
+    typedName?: null;
+    fileAssetId: Base44Id;
+};
+/**
+* Optional normalized signature value that can also be reused inside entities later.
+* Useful if you want one stable shape for mapped/flattened signature data.
+*/
+type NormalizedSignatureValue = {
+    mode: SignatureMode;
+    typedName?: string | null;
+    fileAssetId?: Base44Id | null;
+};
+/**
+ * Metadata stored inside FileUploadTask for CAR compilation.
+ * Keep this lean: execution references only, not full form content.
+ */
+type CorrectiveActionCompileTaskMetadata = {
+    correctiveActionId: Base44Id;
+    companyAuditDetailResponseId: Base44Id;
+    companyAuditHeaderId: Base44Id;
+    templateAssetId: Base44Id;
+    resolvedTemplateScopeLevel: TemplateScopeLevel;
+    operationalSettingsId: Base44Id;
+    supportingEvidenceFileIds: Base44Id[];
+    appendSupportingEvidenceInOrder: true;
+    linkCompiledPdfToResponseEvidence: true;
+    linkOriginalSupportingEvidenceToResponseEvidence: true;
+    generationSource: CorrectiveActionGenerationSource;
+    previousCorrectiveActionId: Base44Id | null;
+};
+/**
+ * FileAsset.metadata shape for CAR templates.
+ * Stored on the uploaded template PDF asset.
+ */
+type CarTemplateFileMetadata = {
+    templateType: 'CAR';
+    stampingZone: {
+        xPct: number;
+        yPct: number;
+        wPct: number;
+        hPct: number;
+    };
+    pageNumber: number;
+    applyToAllPages: boolean;
+    promotedAt?: string;
+};
 
 declare const MOD: {
     readonly OPERATIONS: "OPR";
@@ -185,11 +261,18 @@ declare const NotificationMode: {
     readonly EXTERNAL_EMAIL: "external_email";
     readonly NONE: "none";
 };
+/**
+ * FileUploadTask type for CAR compilation worker.
+ * Reused between service layer and async worker.
+ */
 declare const TaskType: {
     readonly KML_PARSE: "KML_PARSE";
     readonly INVOICE_OCR: "INVOICE_OCR";
     readonly AUDIT_UPLOAD: "AUDIT_UPLOAD";
     readonly REPORT_GEN: "REPORT_GEN";
+    readonly PDF_STAMPING: "PDF_STAMPING";
+    readonly CAR_TEMPLATE_UPLOAD: "CAR_TEMPLATE_UPLOAD";
+    readonly CORRECTIVE_ACTION_COMPILE: "CORRECTIVE_ACTION_COMPILE";
 };
 declare const TaskStatus: {
     readonly PENDING: "PENDING";
@@ -397,6 +480,73 @@ declare enum DocumentType {
     AUDIT_REPORT = "AUDIT_REPORT",
     SENSITIVE_IDENTITY = "SENSITIVE_IDENTITY"
 }
+declare enum DocumentCategory {
+    AGRONOMY_TESTING = "Agronomy & Testing",
+    FARM_OPERATIONS = "Farm Operations",
+    COMPLIANCE_QA = "Compliance & Quality",
+    INVENTORY_LOG = "Inventory & Logistics",
+    ASSETS_MAINT = "Assets & Maintenance",
+    HR_LEGAL_SAFETY = "HR, Legal & Safety",
+    FINANCE_ADMIN = "Finance & Admin"
+}
+declare const DOCUMENT_DISPLAY_INFO: Record<DocumentType, {
+    label: string;
+    description: string;
+    category: DocumentCategory;
+}>;
+declare const CATEGORY_TABS: string[];
 declare const DOCUMENT_MENU_MAP: Record<DocumentType, string[]>;
+/**
+ * Signature modes supported by CAR and similar official document flows.
+ * Use this for both frontend UI selectors and backend validation.
+ */
+declare const SIGNATURE_MODES: {
+    readonly TYPED_NAME: "typed_name";
+    readonly DRAWN_IMAGE: "drawn_image";
+    readonly UPLOADED_IMAGE: "uploaded_image";
+};
+/**
+ * Corrective Action lifecycle states.
+ * draft = record created, generation not finalized yet
+ * generated = compiled PDF created and linked successfully
+ * reviewed = optional later review completed
+ * closed = final business closure
+ * failed = generation failed
+ */
+declare const CORRECTIVE_ACTION_STATUSES: {
+    readonly DRAFT: "draft";
+    readonly GENERATED: "generated";
+    readonly REVIEWED: "reviewed";
+    readonly CLOSED: "closed";
+    readonly FAILED: "failed";
+};
+/**
+ * Scope level used when resolving templates from OperationalSettings.
+ * Resolution precedence is facility -> legalEntity -> company.
+ */
+declare const TEMPLATE_SCOPE_LEVELS: {
+    readonly FACILITY: "facility";
+    readonly LEGAL_ENTITY: "legalEntity";
+    readonly COMPANY: "company";
+};
+/**
+ * Generation source for CAR creation.
+ * CREATE = fresh new CAR
+ * RECREATE = new CAR created from a failed prior CAR
+ */
+declare const CORRECTIVE_ACTION_GENERATION_SOURCES: {
+    readonly CREATE: "CREATE";
+    readonly RECREATE: "RECREATE";
+};
+/**
+ * Allowed supporting evidence mime types for CAR.
+ * Used by frontend upload filter and backend validation.
+ */
+declare const CAR_SUPPORTED_EVIDENCE_MIME_TYPES: readonly ["application/pdf", "image/png", "image/jpeg"];
+/**
+ * Allowed mime types for signature file uploads.
+ * Drawn signatures usually become PNG; uploaded signatures should stay image-only.
+ */
+declare const CAR_SUPPORTED_SIGNATURE_MIME_TYPES: readonly ["image/png", "image/jpeg"];
 
-export { TaskType as $, ACCESS_RANK as A, RESOURCE_REQUIREMENTS as B, CAT as C, DOCUMENT_MENU_MAP as D, ERROR_DICTIONARY as E, FORM_REGISTRY as F, ROLE_SECTIONS_BY_KEY as G, HarvestMethod as H, type InfrastructureFields as I, RelationshipType as J, type ResolvedError as K, LinkedStatus as L, MOD as M, NettingType as N, OrderStatus as O, type PermissionLevel as P, type ResourceOverrides as Q, RESOURCE_MODULE_MAP as R, type ResourceRequirement as S, RowOrientation as T, SENTINEL_UUID as U, type ScopeType as V, SoilTexture as W, TASK_TYPE_REGISTRY as X, type TabConfig as Y, TargetEntityType as Z, TaskStatus as _, ACT as a, type TaskTypeConfig as a0, TransactionType as a1, TrellisType as a2, UserPrivilege as a3, UserRole as a4, type UserRoleType as a5, VigorRating as a6, WaterSource as a7, AccessLevel as b, type AccessLevelType as c, type AgriCoreSession as d, ApprovalStatus as e, ApprovalType as f, AuditStatus as g, AuditType as h, type AuthScopeFields as i, type AvailableScope as j, type CompanyConfig as k, CropCycleStatus as l, DocumentType as m, EVERYONE as n, EmitterType as o, EnabledModule as p, FacilityType as q, type FormMeta as r, MODULE_LABELS as s, MicroclimateZone as t, MimeType as u, type ModCode as v, NotificationMode as w, PhysicalState as x, PlantingMethod as y, RESOURCE_PATHS as z };
+export { PlantingMethod as $, ACCESS_RANK as A, type Base44Id as B, CAR_SUPPORTED_EVIDENCE_MIME_TYPES as C, DOCUMENT_DISPLAY_INFO as D, DocumentType as E, ERROR_DICTIONARY as F, EVERYONE as G, EmitterType as H, EnabledModule as I, FORM_REGISTRY as J, FacilityType as K, type FileUploadTaskType as L, type FormMeta as M, HarvestMethod as N, type InfrastructureFields as O, LinkedStatus as P, MOD as Q, MODULE_LABELS as R, MicroclimateZone as S, MimeType as T, type ModCode as U, NettingType as V, type NormalizedSignatureValue as W, NotificationMode as X, OrderStatus as Y, type PermissionLevel as Z, PhysicalState as _, ACT as a, RESOURCE_MODULE_MAP as a0, RESOURCE_PATHS as a1, RESOURCE_REQUIREMENTS as a2, ROLE_SECTIONS_BY_KEY as a3, RelationshipType as a4, type ResolvedError as a5, type ResourceOverrides as a6, type ResourceRequirement as a7, RowOrientation as a8, SENTINEL_UUID as a9, SIGNATURE_MODES as aa, type ScopeType as ab, type SignatureInput as ac, type SignatureMode as ad, SoilTexture as ae, TASK_TYPE_REGISTRY as af, TEMPLATE_SCOPE_LEVELS as ag, type TabConfig as ah, TargetEntityType as ai, TaskStatus as aj, TaskType as ak, type TaskTypeConfig as al, type TemplateScopeLevel as am, TransactionType as an, TrellisType as ao, UserPrivilege as ap, UserRole as aq, type UserRoleType as ar, VigorRating as as, WaterSource as at, AccessLevel as b, type AccessLevelType as c, type AgriCoreSession as d, ApprovalStatus as e, ApprovalType as f, AuditStatus as g, AuditType as h, type AuthScopeFields as i, type AvailableScope as j, CAR_SUPPORTED_SIGNATURE_MIME_TYPES as k, CAT as l, CATEGORY_TABS as m, CORRECTIVE_ACTION_GENERATION_SOURCES as n, CORRECTIVE_ACTION_STATUSES as o, type CanonicalId as p, type CarSupportedEvidenceMimeType as q, type CarSupportedSignatureMimeType as r, type CarTemplateFileMetadata as s, type CompanyConfig as t, type CorrectiveActionCompileTaskMetadata as u, type CorrectiveActionGenerationSource as v, type CorrectiveActionStatus as w, CropCycleStatus as x, DOCUMENT_MENU_MAP as y, DocumentCategory as z };

package/dist/{constants-DxCjnH4L.d.ts → constants-DOmJizGn.d.ts}

@@ -76,6 +76,82 @@ interface InfrastructureFields {
     facilityId: string | null;
     authScopeId: string;
 }
+/**
+ * Base44 ID alias for readability only.
+ * Still just string at runtime.
+ */
+type Base44Id = string;
+/**
+ * Canonical UUID alias for readability only.
+ */
+type CanonicalId = string;
+/**
+ * Derived union types from constants.
+ */
+type SignatureMode = typeof SIGNATURE_MODES[keyof typeof SIGNATURE_MODES];
+type CorrectiveActionStatus = typeof CORRECTIVE_ACTION_STATUSES[keyof typeof CORRECTIVE_ACTION_STATUSES];
+type FileUploadTaskType = typeof TaskType[keyof typeof TaskType];
+type TemplateScopeLevel = typeof TEMPLATE_SCOPE_LEVELS[keyof typeof TEMPLATE_SCOPE_LEVELS];
+type CorrectiveActionGenerationSource = typeof CORRECTIVE_ACTION_GENERATION_SOURCES[keyof typeof CORRECTIVE_ACTION_GENERATION_SOURCES];
+type CarSupportedEvidenceMimeType = typeof CAR_SUPPORTED_EVIDENCE_MIME_TYPES[number];
+type CarSupportedSignatureMimeType = typeof CAR_SUPPORTED_SIGNATURE_MIME_TYPES[number];
+/**
+* Shared signature payload used by create/preview CAR requests.
+* typed_name stores text only.
+* drawn_image / uploaded_image store a FileAsset Base44 ID.
+*/
+type SignatureInput = {
+    mode: typeof SIGNATURE_MODES.TYPED_NAME;
+    typedName: string;
+    fileAssetId?: null;
+} | {
+    mode: typeof SIGNATURE_MODES.DRAWN_IMAGE | typeof SIGNATURE_MODES.UPLOADED_IMAGE;
+    typedName?: null;
+    fileAssetId: Base44Id;
+};
+/**
+* Optional normalized signature value that can also be reused inside entities later.
+* Useful if you want one stable shape for mapped/flattened signature data.
+*/
+type NormalizedSignatureValue = {
+    mode: SignatureMode;
+    typedName?: string | null;
+    fileAssetId?: Base44Id | null;
+};
+/**
+ * Metadata stored inside FileUploadTask for CAR compilation.
+ * Keep this lean: execution references only, not full form content.
+ */
+type CorrectiveActionCompileTaskMetadata = {
+    correctiveActionId: Base44Id;
+    companyAuditDetailResponseId: Base44Id;
+    companyAuditHeaderId: Base44Id;
+    templateAssetId: Base44Id;
+    resolvedTemplateScopeLevel: TemplateScopeLevel;
+    operationalSettingsId: Base44Id;
+    supportingEvidenceFileIds: Base44Id[];
+    appendSupportingEvidenceInOrder: true;
+    linkCompiledPdfToResponseEvidence: true;
+    linkOriginalSupportingEvidenceToResponseEvidence: true;
+    generationSource: CorrectiveActionGenerationSource;
+    previousCorrectiveActionId: Base44Id | null;
+};
+/**
+ * FileAsset.metadata shape for CAR templates.
+ * Stored on the uploaded template PDF asset.
+ */
+type CarTemplateFileMetadata = {
+    templateType: 'CAR';
+    stampingZone: {
+        xPct: number;
+        yPct: number;
+        wPct: number;
+        hPct: number;
+    };
+    pageNumber: number;
+    applyToAllPages: boolean;
+    promotedAt?: string;
+};
 
 declare const MOD: {
     readonly OPERATIONS: "OPR";
@@ -185,11 +261,18 @@ declare const NotificationMode: {
     readonly EXTERNAL_EMAIL: "external_email";
     readonly NONE: "none";
 };
+/**
+ * FileUploadTask type for CAR compilation worker.
+ * Reused between service layer and async worker.
+ */
 declare const TaskType: {
     readonly KML_PARSE: "KML_PARSE";
     readonly INVOICE_OCR: "INVOICE_OCR";
     readonly AUDIT_UPLOAD: "AUDIT_UPLOAD";
     readonly REPORT_GEN: "REPORT_GEN";
+    readonly PDF_STAMPING: "PDF_STAMPING";
+    readonly CAR_TEMPLATE_UPLOAD: "CAR_TEMPLATE_UPLOAD";
+    readonly CORRECTIVE_ACTION_COMPILE: "CORRECTIVE_ACTION_COMPILE";
 };
 declare const TaskStatus: {
     readonly PENDING: "PENDING";
@@ -397,6 +480,73 @@ declare enum DocumentType {
     AUDIT_REPORT = "AUDIT_REPORT",
     SENSITIVE_IDENTITY = "SENSITIVE_IDENTITY"
 }
+declare enum DocumentCategory {
+    AGRONOMY_TESTING = "Agronomy & Testing",
+    FARM_OPERATIONS = "Farm Operations",
+    COMPLIANCE_QA = "Compliance & Quality",
+    INVENTORY_LOG = "Inventory & Logistics",
+    ASSETS_MAINT = "Assets & Maintenance",
+    HR_LEGAL_SAFETY = "HR, Legal & Safety",
+    FINANCE_ADMIN = "Finance & Admin"
+}
+declare const DOCUMENT_DISPLAY_INFO: Record<DocumentType, {
+    label: string;
+    description: string;
+    category: DocumentCategory;
+}>;
+declare const CATEGORY_TABS: string[];
 declare const DOCUMENT_MENU_MAP: Record<DocumentType, string[]>;
+/**
+ * Signature modes supported by CAR and similar official document flows.
+ * Use this for both frontend UI selectors and backend validation.
+ */
+declare const SIGNATURE_MODES: {
+    readonly TYPED_NAME: "typed_name";
+    readonly DRAWN_IMAGE: "drawn_image";
+    readonly UPLOADED_IMAGE: "uploaded_image";
+};
+/**
+ * Corrective Action lifecycle states.
+ * draft = record created, generation not finalized yet
+ * generated = compiled PDF created and linked successfully
+ * reviewed = optional later review completed
+ * closed = final business closure
+ * failed = generation failed
+ */
+declare const CORRECTIVE_ACTION_STATUSES: {
+    readonly DRAFT: "draft";
+    readonly GENERATED: "generated";
+    readonly REVIEWED: "reviewed";
+    readonly CLOSED: "closed";
+    readonly FAILED: "failed";
+};
+/**
+ * Scope level used when resolving templates from OperationalSettings.
+ * Resolution precedence is facility -> legalEntity -> company.
+ */
+declare const TEMPLATE_SCOPE_LEVELS: {
+    readonly FACILITY: "facility";
+    readonly LEGAL_ENTITY: "legalEntity";
+    readonly COMPANY: "company";
+};
+/**
+ * Generation source for CAR creation.
+ * CREATE = fresh new CAR
+ * RECREATE = new CAR created from a failed prior CAR
+ */
+declare const CORRECTIVE_ACTION_GENERATION_SOURCES: {
+    readonly CREATE: "CREATE";
+    readonly RECREATE: "RECREATE";
+};
+/**
+ * Allowed supporting evidence mime types for CAR.
+ * Used by frontend upload filter and backend validation.
+ */
+declare const CAR_SUPPORTED_EVIDENCE_MIME_TYPES: readonly ["application/pdf", "image/png", "image/jpeg"];
+/**
+ * Allowed mime types for signature file uploads.
+ * Drawn signatures usually become PNG; uploaded signatures should stay image-only.
+ */
+declare const CAR_SUPPORTED_SIGNATURE_MIME_TYPES: readonly ["image/png", "image/jpeg"];
 
-export { TaskType as $, ACCESS_RANK as A, RESOURCE_REQUIREMENTS as B, CAT as C, DOCUMENT_MENU_MAP as D, ERROR_DICTIONARY as E, FORM_REGISTRY as F, ROLE_SECTIONS_BY_KEY as G, HarvestMethod as H, type InfrastructureFields as I, RelationshipType as J, type ResolvedError as K, LinkedStatus as L, MOD as M, NettingType as N, OrderStatus as O, type PermissionLevel as P, type ResourceOverrides as Q, RESOURCE_MODULE_MAP as R, type ResourceRequirement as S, RowOrientation as T, SENTINEL_UUID as U, type ScopeType as V, SoilTexture as W, TASK_TYPE_REGISTRY as X, type TabConfig as Y, TargetEntityType as Z, TaskStatus as _, ACT as a, type TaskTypeConfig as a0, TransactionType as a1, TrellisType as a2, UserPrivilege as a3, UserRole as a4, type UserRoleType as a5, VigorRating as a6, WaterSource as a7, AccessLevel as b, type AccessLevelType as c, type AgriCoreSession as d, ApprovalStatus as e, ApprovalType as f, AuditStatus as g, AuditType as h, type AuthScopeFields as i, type AvailableScope as j, type CompanyConfig as k, CropCycleStatus as l, DocumentType as m, EVERYONE as n, EmitterType as o, EnabledModule as p, FacilityType as q, type FormMeta as r, MODULE_LABELS as s, MicroclimateZone as t, MimeType as u, type ModCode as v, NotificationMode as w, PhysicalState as x, PlantingMethod as y, RESOURCE_PATHS as z };
+export { PlantingMethod as $, ACCESS_RANK as A, type Base44Id as B, CAR_SUPPORTED_EVIDENCE_MIME_TYPES as C, DOCUMENT_DISPLAY_INFO as D, DocumentType as E, ERROR_DICTIONARY as F, EVERYONE as G, EmitterType as H, EnabledModule as I, FORM_REGISTRY as J, FacilityType as K, type FileUploadTaskType as L, type FormMeta as M, HarvestMethod as N, type InfrastructureFields as O, LinkedStatus as P, MOD as Q, MODULE_LABELS as R, MicroclimateZone as S, MimeType as T, type ModCode as U, NettingType as V, type NormalizedSignatureValue as W, NotificationMode as X, OrderStatus as Y, type PermissionLevel as Z, PhysicalState as _, ACT as a, RESOURCE_MODULE_MAP as a0, RESOURCE_PATHS as a1, RESOURCE_REQUIREMENTS as a2, ROLE_SECTIONS_BY_KEY as a3, RelationshipType as a4, type ResolvedError as a5, type ResourceOverrides as a6, type ResourceRequirement as a7, RowOrientation as a8, SENTINEL_UUID as a9, SIGNATURE_MODES as aa, type ScopeType as ab, type SignatureInput as ac, type SignatureMode as ad, SoilTexture as ae, TASK_TYPE_REGISTRY as af, TEMPLATE_SCOPE_LEVELS as ag, type TabConfig as ah, TargetEntityType as ai, TaskStatus as aj, TaskType as ak, type TaskTypeConfig as al, type TemplateScopeLevel as am, TransactionType as an, TrellisType as ao, UserPrivilege as ap, UserRole as aq, type UserRoleType as ar, VigorRating as as, WaterSource as at, AccessLevel as b, type AccessLevelType as c, type AgriCoreSession as d, ApprovalStatus as e, ApprovalType as f, AuditStatus as g, AuditType as h, type AuthScopeFields as i, type AvailableScope as j, CAR_SUPPORTED_SIGNATURE_MIME_TYPES as k, CAT as l, CATEGORY_TABS as m, CORRECTIVE_ACTION_GENERATION_SOURCES as n, CORRECTIVE_ACTION_STATUSES as o, type CanonicalId as p, type CarSupportedEvidenceMimeType as q, type CarSupportedSignatureMimeType as r, type CarTemplateFileMetadata as s, type CompanyConfig as t, type CorrectiveActionCompileTaskMetadata as u, type CorrectiveActionGenerationSource as v, type CorrectiveActionStatus as w, CropCycleStatus as x, DOCUMENT_MENU_MAP as y, DocumentCategory as z };

package/dist/constants.d.mts

@@ -1 +1 @@
-export { A as ACCESS_RANK, a as ACT, b as AccessLevel, c as AccessLevelType, e as ApprovalStatus, f as ApprovalType, g as AuditStatus, h as AuditType, C as CAT, l as CropCycleStatus, D as DOCUMENT_MENU_MAP, m as DocumentType, E as ERROR_DICTIONARY, n as EVERYONE, o as EmitterType, p as EnabledModule, F as FORM_REGISTRY, q as FacilityType, H as HarvestMethod, L as LinkedStatus, M as MOD, s as MODULE_LABELS, t as MicroclimateZone, u as MimeType, v as ModCode, N as NettingType, w as NotificationMode, O as OrderStatus, x as PhysicalState, y as PlantingMethod, R as RESOURCE_MODULE_MAP, z as RESOURCE_PATHS, B as RESOURCE_REQUIREMENTS, G as ROLE_SECTIONS_BY_KEY, J as RelationshipType, S as ResourceRequirement, T as RowOrientation, U as SENTINEL_UUID, W as SoilTexture, X as TASK_TYPE_REGISTRY, Z as TargetEntityType, _ as TaskStatus, $ as TaskType, a1 as TransactionType, a2 as TrellisType, a3 as UserPrivilege, a4 as UserRole, a5 as UserRoleType, a6 as VigorRating, a7 as WaterSource } from './constants-DxCjnH4L.mjs';
+export { A as ACCESS_RANK, a as ACT, b as AccessLevel, c as AccessLevelType, e as ApprovalStatus, f as ApprovalType, g as AuditStatus, h as AuditType, C as CAR_SUPPORTED_EVIDENCE_MIME_TYPES, k as CAR_SUPPORTED_SIGNATURE_MIME_TYPES, l as CAT, m as CATEGORY_TABS, n as CORRECTIVE_ACTION_GENERATION_SOURCES, o as CORRECTIVE_ACTION_STATUSES, x as CropCycleStatus, D as DOCUMENT_DISPLAY_INFO, y as DOCUMENT_MENU_MAP, z as DocumentCategory, E as DocumentType, F as ERROR_DICTIONARY, G as EVERYONE, H as EmitterType, I as EnabledModule, J as FORM_REGISTRY, K as FacilityType, N as HarvestMethod, P as LinkedStatus, Q as MOD, R as MODULE_LABELS, S as MicroclimateZone, T as MimeType, U as ModCode, V as NettingType, X as NotificationMode, Y as OrderStatus, _ as PhysicalState, $ as PlantingMethod, a0 as RESOURCE_MODULE_MAP, a1 as RESOURCE_PATHS, a2 as RESOURCE_REQUIREMENTS, a3 as ROLE_SECTIONS_BY_KEY, a4 as RelationshipType, a7 as ResourceRequirement, a8 as RowOrientation, a9 as SENTINEL_UUID, aa as SIGNATURE_MODES, ae as SoilTexture, af as TASK_TYPE_REGISTRY, ag as TEMPLATE_SCOPE_LEVELS, ai as TargetEntityType, aj as TaskStatus, ak as TaskType, an as TransactionType, ao as TrellisType, ap as UserPrivilege, aq as UserRole, ar as UserRoleType, as as VigorRating, at as WaterSource } from './constants-DOmJizGn.mjs';

package/dist/constants.d.ts

@@ -1 +1 @@
-export { A as ACCESS_RANK, a as ACT, b as AccessLevel, c as AccessLevelType, e as ApprovalStatus, f as ApprovalType, g as AuditStatus, h as AuditType, C as CAT, l as CropCycleStatus, D as DOCUMENT_MENU_MAP, m as DocumentType, E as ERROR_DICTIONARY, n as EVERYONE, o as EmitterType, p as EnabledModule, F as FORM_REGISTRY, q as FacilityType, H as HarvestMethod, L as LinkedStatus, M as MOD, s as MODULE_LABELS, t as MicroclimateZone, u as MimeType, v as ModCode, N as NettingType, w as NotificationMode, O as OrderStatus, x as PhysicalState, y as PlantingMethod, R as RESOURCE_MODULE_MAP, z as RESOURCE_PATHS, B as RESOURCE_REQUIREMENTS, G as ROLE_SECTIONS_BY_KEY, J as RelationshipType, S as ResourceRequirement, T as RowOrientation, U as SENTINEL_UUID, W as SoilTexture, X as TASK_TYPE_REGISTRY, Z as TargetEntityType, _ as TaskStatus, $ as TaskType, a1 as TransactionType, a2 as TrellisType, a3 as UserPrivilege, a4 as UserRole, a5 as UserRoleType, a6 as VigorRating, a7 as WaterSource } from './constants-DxCjnH4L.js';
+export { A as ACCESS_RANK, a as ACT, b as AccessLevel, c as AccessLevelType, e as ApprovalStatus, f as ApprovalType, g as AuditStatus, h as AuditType, C as CAR_SUPPORTED_EVIDENCE_MIME_TYPES, k as CAR_SUPPORTED_SIGNATURE_MIME_TYPES, l as CAT, m as CATEGORY_TABS, n as CORRECTIVE_ACTION_GENERATION_SOURCES, o as CORRECTIVE_ACTION_STATUSES, x as CropCycleStatus, D as DOCUMENT_DISPLAY_INFO, y as DOCUMENT_MENU_MAP, z as DocumentCategory, E as DocumentType, F as ERROR_DICTIONARY, G as EVERYONE, H as EmitterType, I as EnabledModule, J as FORM_REGISTRY, K as FacilityType, N as HarvestMethod, P as LinkedStatus, Q as MOD, R as MODULE_LABELS, S as MicroclimateZone, T as MimeType, U as ModCode, V as NettingType, X as NotificationMode, Y as OrderStatus, _ as PhysicalState, $ as PlantingMethod, a0 as RESOURCE_MODULE_MAP, a1 as RESOURCE_PATHS, a2 as RESOURCE_REQUIREMENTS, a3 as ROLE_SECTIONS_BY_KEY, a4 as RelationshipType, a7 as ResourceRequirement, a8 as RowOrientation, a9 as SENTINEL_UUID, aa as SIGNATURE_MODES, ae as SoilTexture, af as TASK_TYPE_REGISTRY, ag as TEMPLATE_SCOPE_LEVELS, ai as TargetEntityType, aj as TaskStatus, ak as TaskType, an as TransactionType, ao as TrellisType, ap as UserPrivilege, aq as UserRole, ar as UserRoleType, as as VigorRating, at as WaterSource } from './constants-DOmJizGn.js';