@litusarchieve18/agricore-utils 1.0.11 → 1.0.13

package/README.md

@@ -65,6 +65,8 @@ The universal vocabulary of the AgriCore platform, ensuring type-safety across a
 🔐 Security & Access Control
 The library now includes a centralized logic layer to enforce granular permissions across all AgriCore services.
 
+---------------------------------------------------------------------
+
 evaluateBaseAccess: Automatically determines a user's base permission level (NONE, READ, or WRITE) for a specific resource path (e.g., records.financials). It respects the OWNER role "God Mode" bypass and uses ROLE_SECTIONS_BY_KEY to provide sensible defaults for different app sections.
 
 Access Ranking (resolveEffectiveAccess): Implements an additive permission model. By ranking levels (NONE < READ < WRITE), it allows the system to compare base permissions against specific user overrides and resolve the highest authorized access level.
@@ -92,6 +94,8 @@ const recordToSave = {
 
 To completely eliminate database bottlenecks and solve serverless rate-limiting, AgriCore has migrated to a state-of-the-art, "Zero-DB" authorization architecture. By decoupling our security rules from the database SDK, our backend API endpoints now resolve complex multi-tenant boundaries and granular role-based access controls in roughly 1 millisecond.
 
+---------------------------------------------------------------------
+
 Key Features of the New Security Engine:
 
 One-Time Session Generation: On login, the backend dynamically aggregates a user's full hierarchical profile—including role assignments, availableScopes (Company > Legal Entity > Facility), and granular resourceOverrides—into a single, cryptographically signed JSON Web Token (JWT).
@@ -102,6 +106,56 @@ Smart Frontend Interceptor: A centralized React hook (useApiClient) acts as an a
 
 Instant Context Switching: Because the JWT securely holds the user's entire "VIP List" of permitted scopes, users can instantly switch between farms, legal entities, and facilities in the frontend global dropdown without triggering a new authentication handshake or database query.
 
+---------------------------------------------------------------------
+
+This Document Management Engine provides a standardized, compliant, and migration-ready architecture for handling agricultural records. It ensures that files are stored predictably and matched against audit requirements with high precision.
+
+Document Management & Compliance Engine
+This module handles the lifecycle of file assets, from standardized naming and path generation to intelligent metadata matching for compliance audits.
+
+1. Standardized Taxonomy (DocumentType)
+The DocumentType enum serves as the single source of truth for the AgriCore document ecosystem. It categorizes every record—from SPRAY_RECORD to MAPPING_FARM_MAPS—ensuring that the database remains searchable and consistent across different farms and legal entities.
+
+2. Smart Routing (generateDocumentPath)
+This function enforces the "Core vs. Seasonal" storage architecture. It ensures that permanent files (Fixed Assets) and crop-cycle files (Working Assets) are physically and logically separated:
+
+Static Assets (isStatic: true): Routed to {SiteName}/_CORE/{DocumentType}.
+
+Seasonal Assets: Routed to a strict temporal hierarchy: {SiteName}/_SEASONAL/{Year}/{DocumentType}/{Crop}.
+
+3. Intelligence Engine (calculateFileMetadataMatch)
+A 3-tier matching algorithm used to automatically suggest evidence for audit questions. It evaluates the relevance of a file based on three layers:
+
+Static Hard Fails: Strict equality checks for properties like documentType.
+
+Dynamic Hard Fails (mustMatchContext): Ensures files belong to the correct boundaries (e.g., siteId array inclusion) based on the current AuditHeader.
+
+Soft Relevance Scoring (contextMatch): Calculates a percentage score based on environmental tags like seasonId or crop, allowing the UI to surface the "best matches" first.
+
+Quick Example
+TypeScript
+// 1. Generate a path for a seasonal spray record
+const path = generateDocumentPath({
+  siteName: "North Farm",
+  docType: DocumentType.SPRAY_RECORD,
+  year: 2026,
+  crop: "Mango"
+}); 
+// Output: North_Farm/_SEASONAL/2026/SPRAY_RECORD/MANGO
+
+// 2. Score a file against an audit requirement
+const score = calculateFileMetadataMatch(
+  { 
+    mustMatch: { documentType: "SPRAY_RECORD" },
+    mustMatchContext: ["siteId"], // Hard fail if wrong farm
+    contextMatch: ["seasonId"]    // Soft score for season relevance
+  },
+  file.metadata,
+  auditHeader.context
+);
+
+============================================================================
+
 🛠️ Development & Publishing Guide
 Zero Dependencies
 To keep the package ultra-lightweight (~30KB), this library has zero runtime dependencies. All build tools (tsup, typescript) are strictly kept in devDependencies, and the package.json uses the "files": ["dist"] array to ensure only compiled code is uploaded.
@@ -129,6 +183,10 @@ 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.12 — add some functionality to add a file tag
+
 V1.0.11 — add userName and userEmail to AgriCoreSession
 
 V1.0.10 — add an explicit exports map

package/dist/chunk-QI4YXI4P.mjs

@@ -0,0 +1,585 @@
+// src/constants.ts
+var MOD = {
+  OPERATIONS: "OPR",
+  EQUIPMENT: "EQP",
+  PACKHOUSE: "PCK",
+  FARM: "FRM",
+  SAFETY: "SAF",
+  TEAM_HR: "THR",
+  RECORDS: "REC",
+  ADMIN: "ADM",
+  DOCUMENTS: "DOC",
+  ALERTS: "ALT",
+  INFRA: "INF",
+  SESSION: "SES"
+};
+var CAT = {
+  SUBSCRIPTION: "1",
+  PERMISSION: "2",
+  VALIDATION: "3",
+  INTEGRITY: "4"
+};
+var ACT = {
+  GENERIC: "00",
+  VIEW: "01",
+  CREATE: "02",
+  EDIT: "03",
+  DELETE: "04",
+  UPLOAD: "05"
+};
+var SENTINEL_UUID = "00000000-0000-0000-0000-000000000000";
+var MODULE_LABELS = {
+  [MOD.OPERATIONS]: "Operations",
+  [MOD.EQUIPMENT]: "Equipment & Fleet",
+  [MOD.PACKHOUSE]: "Packhouse",
+  [MOD.FARM]: "Farm Management",
+  [MOD.SAFETY]: "Safety & Compliance",
+  [MOD.TEAM_HR]: "Team & HR",
+  [MOD.RECORDS]: "Records & Reports",
+  [MOD.ADMIN]: "Admin Settings",
+  [MOD.DOCUMENTS]: "Documents",
+  [MOD.ALERTS]: "Alerts",
+  [MOD.INFRA]: "Infrastructure",
+  [MOD.SESSION]: "Session"
+};
+var ERROR_DICTIONARY = {
+  // ── Gate 1: Subscription ──────────────────────────────────────────────────
+  "100": { title: "Module Locked", text: "This feature is part of a module not enabled for your company. Contact your administrator to unlock it." },
+  // ── Gate 2: Permission ────────────────────────────────────────────────────
+  "200": { title: "Access Denied", text: "You do not have permission to perform this action. Contact your manager." },
+  "201": { title: "Restricted View", text: "Viewing this section requires higher access. Contact your administrator." },
+  "202": { title: "Creation Restricted", text: "You are not permitted to create new records here." },
+  "203": { title: "Edit Restricted", text: "You do not have permission to edit this record." },
+  "204": { title: "Protected Record", text: "You do not have permission to delete this record. Contact your administrator." },
+  "205": { title: "Upload Restricted", text: "You are not permitted to upload files here." },
+  // ── Gate 3: Validation ────────────────────────────────────────────────────
+  "300": { title: "Invalid Input", text: "Something is wrong with the data provided. Please review and try again." },
+  "301": { title: "Cannot Load Data", text: "Required information is missing to load this page." },
+  "302": { title: "Missing Fields", text: "Please fill in all required fields before saving." },
+  "303": { title: "Invalid Update", text: "The data you are trying to save is not valid. Please check your inputs." },
+  "304": { title: "Cannot Delete", text: "The record cannot be deleted due to a validation issue." },
+  "305": { title: "Upload Failed", text: "The file could not be uploaded. Please check the file type and size." },
+  // ── Gate 4: Integrity ─────────────────────────────────────────────────────
+  "400": { title: "Data Conflict", text: "A conflict occurred with an existing record. Please review and try again." },
+  "402": { title: "Duplicate Entry", text: "A record with this name or identifier already exists." },
+  "403": { title: "Edit Conflict", text: "This record was recently updated by someone else. Please refresh and try again." },
+  "404": { title: "Record In Use", text: "This record cannot be deleted because it is referenced by other data." }
+};
+var UserRole = {
+  OWNER: "owner",
+  MANAGER: "manager",
+  SUPERVISOR: "supervisor",
+  LEADING_HAND: "leadingHand",
+  WORKER: "worker"
+};
+var UserPrivilege = {
+  FINANCE: "finance",
+  HR: "hr",
+  MECHANIC: "mechanic",
+  AUDIT_COMPLIANCE: "auditCompliance",
+  ADMIN: "admin"
+};
+var AccessLevel = {
+  NONE: "NONE",
+  READ: "READ",
+  WRITE: "WRITE"
+};
+var EnabledModule = {
+  FARM_MANAGEMENT: "farm_management",
+  PACKHOUSE: "packhouse",
+  ACCOMMODATION: "accommodation"
+};
+var FacilityType = {
+  FARM: "farm",
+  PACKHOUSE: "packhouse",
+  ACCOMMODATION: "accommodation"
+};
+var LinkedStatus = {
+  NOT_LINKED: "not_linked",
+  PENDING_LINK: "pending_link",
+  LINKED: "linked"
+};
+var RelationshipType = {
+  SUPPLIER: "supplier",
+  CUSTOMER: "customer",
+  BOTH: "both"
+};
+var ApprovalType = {
+  ROLE: "role",
+  PRIVILEGE: "privilege",
+  SPECIFIC_USERS: "specific_users"
+};
+var TransactionType = {
+  PURCHASE_ORDER: "purchase_order",
+  SALES_ORDER: "sales_order",
+  REPAIR: "repair",
+  FUEL: "fuel",
+  OTHER: "other"
+};
+var ApprovalStatus = {
+  PENDING: "pending",
+  APPROVED: "approved",
+  REJECTED: "rejected"
+};
+var OrderStatus = {
+  DRAFT: "draft",
+  PENDING_FINANCE: "pending_finance",
+  NEW: "new",
+  ACKNOWLEDGED: "acknowledged",
+  IN_PROGRESS: "in_progress",
+  SHIPPED: "shipped",
+  RECEIVED: "received",
+  CANCELLED: "cancelled"
+};
+var NotificationMode = {
+  INTERNAL: "internal",
+  EXTERNAL_EMAIL: "external_email",
+  NONE: "none"
+};
+var TaskType = {
+  KML_PARSE: "KML_PARSE",
+  INVOICE_OCR: "INVOICE_OCR",
+  AUDIT_UPLOAD: "AUDIT_UPLOAD",
+  REPORT_GEN: "REPORT_GEN"
+};
+var TaskStatus = {
+  PENDING: "PENDING",
+  PROCESSING: "PROCESSING",
+  COMPLETED: "COMPLETED",
+  FAILED: "FAILED",
+  AWAITING_REVIEW: "AWAITING_REVIEW",
+  VERIFIED: "VERIFIED",
+  REJECTED: "REJECTED"
+};
+var MimeType = {
+  KML: "application/vnd.google-earth.kml+xml",
+  KMZ: "application/vnd.google-earth.kmz",
+  PDF: "application/pdf",
+  XLSX: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  XLS: "application/vnd.ms-excel",
+  JPEG: "image/jpeg",
+  PNG: "image/png"
+};
+var TargetEntityType = {
+  FARM: "FARM",
+  ZONE: "ZONE",
+  BLOCK: "BLOCK",
+  INFRASTRUCTURE: "INFRASTRUCTURE",
+  AUTO: "AUTO"
+};
+var AuditType = {
+  FRESHCARE: "Freshcare",
+  HACCP: "HACCP",
+  WHS: "WHS",
+  CUSTOM: "Custom"
+};
+var AuditStatus = {
+  DRAFT: "DRAFT",
+  IN_REVIEW: "IN_REVIEW",
+  FINALIZED: "FINALIZED"
+};
+var SoilTexture = {
+  SAND: "SAND",
+  LOAMY_SAND: "LOAMY_SAND",
+  SANDY_LOAM: "SANDY_LOAM",
+  LOAM: "LOAM",
+  SILT_LOAM: "SILT_LOAM",
+  SILT: "SILT",
+  SANDY_CLAY_LOAM: "SANDY_CLAY_LOAM",
+  CLAY_LOAM: "CLAY_LOAM",
+  SILTY_CLAY_LOAM: "SILTY_CLAY_LOAM",
+  SANDY_CLAY: "SANDY_CLAY",
+  SILTY_CLAY: "SILTY_CLAY",
+  CLAY: "CLAY"
+};
+var MicroclimateZone = {
+  STANDARD: "STANDARD",
+  FROST_POCKET: "FROST_POCKET",
+  WIND_CORRIDOR: "WIND_CORRIDOR",
+  EXPOSED_RIDGE: "EXPOSED_RIDGE",
+  HEAT_TRAP: "HEAT_TRAP",
+  RIPARIAN: "RIPARIAN"
+};
+var PlantingMethod = {
+  SQUARE: "SQUARE",
+  RECTANGULAR: "RECTANGULAR",
+  HEXAGONAL: "HEXAGONAL",
+  QUINCUNX: "QUINCUNX",
+  CONTOUR: "CONTOUR"
+};
+var RowOrientation = {
+  NORTH_SOUTH: "NORTH_SOUTH",
+  EAST_WEST: "EAST_WEST",
+  NORTHEAST_SOUTHWEST: "NORTHEAST_SOUTHWEST",
+  NORTHWEST_SOUTHEAST: "NORTHWEST_SOUTHEAST"
+};
+var EmitterType = {
+  SURFACE_DRIP: "SURFACE_DRIP",
+  SUBSURFACE_DRIP: "SUBSURFACE_DRIP",
+  MICRO_SPRINKLER: "MICRO_SPRINKLER",
+  JET_SPRAY: "JET_SPRAY",
+  INLINE_DRIPPER: "INLINE_DRIPPER",
+  PRESSURE_COMPENSATED: "PRESSURE_COMPENSATED"
+};
+var TrellisType = {
+  NONE: "NONE",
+  VERTICAL_AXIS: "VERTICAL_AXIS",
+  TWO_D_PLANE: "2D_PLANE",
+  V_TRELLIS: "V_TRELLIS",
+  T_BAR: "T_BAR",
+  PERGOLA: "PERGOLA",
+  Y_TRELLIS: "Y_TRELLIS"
+};
+var NettingType = {
+  NONE: "NONE",
+  OVERHEAD_HAIL: "OVERHEAD_HAIL",
+  SIDE_BIRD: "SIDE_BIRD",
+  FULL_EXCLUSION: "FULL_EXCLUSION",
+  SHADE_30: "SHADE_30",
+  SHADE_50: "SHADE_50",
+  CROSS_OVER: "CROSS_OVER"
+};
+var HarvestMethod = {
+  HAND: "HAND",
+  MACHINE: "MACHINE"
+};
+var VigorRating = {
+  VERY_LOW: "VERY_LOW",
+  LOW: "LOW",
+  MODERATE: "MODERATE",
+  HIGH: "HIGH",
+  VERY_HIGH: "VERY_HIGH"
+};
+var CropCycleStatus = {
+  NEW: "NEW",
+  CONFIRMED: "CONFIRMED",
+  ACTIVE: "ACTIVE",
+  COMPLETED: "COMPLETED"
+};
+var WaterSource = {
+  BORE_WELL: "BORE_WELL",
+  RIVER_STREAM: "RIVER_STREAM",
+  ON_FARM_DAM: "ON_FARM_DAM",
+  IRRIGATION_SCHEME: "IRRIGATION_SCHEME",
+  MUNICIPAL: "MUNICIPAL",
+  RECLAIMED_WASTE: "RECLAIMED_WASTE",
+  RAINWATER: "RAINWATER"
+};
+var PhysicalState = {
+  LIQUID: "LIQUID",
+  GAS: "GAS"
+};
+var FORM_REGISTRY = {
+  // ── Farm Management ──────────────────────────────────────────────────────
+  farmForm: { label: "Farm Profile", menuUrl: "/admin", module: "Farm Management" },
+  zoneForm: { label: "Zone Mapping", menuUrl: "/admin", module: "Farm Management" },
+  blockForm: { label: "Block Definition", menuUrl: "/admin", module: "Farm Management" },
+  // ── Crop & Variety ───────────────────────────────────────────────────────
+  cropForm: { label: "Crop Profile", menuUrl: "/admin", module: "Crop Library" },
+  varietyForm: { label: "Variety Blueprint", menuUrl: "/admin", module: "Crop Library" },
+  // ── Administration ───────────────────────────────────────────────────────
+  userAccessForm: { label: "User Access & Roles", menuUrl: "/admin/users", module: "Administration" },
+  companySettingsForm: { label: "Company Settings", menuUrl: "/admin/company", module: "Administration" },
+  financeTierForm: { label: "Finance Approval Tier", menuUrl: "/admin/company", module: "Administration" },
+  // ── Audit & Compliance ───────────────────────────────────────────────────
+  auditProjectForm: { label: "Audit Project", menuUrl: "/admin", module: "Audit & Compliance" }
+};
+var TASK_TYPE_REGISTRY = {
+  INVOICE_OCR: {
+    label: "Invoice / Receipt OCR",
+    targetEntity: "FuelInvoice",
+    description: "Extract invoice data (supplier, amount, date, line items) using AI.",
+    mimeTypes: [MimeType.PDF, MimeType.JPEG, MimeType.PNG],
+    icon: "FileText",
+    approveAction: "CREATE_FUEL_INVOICE"
+  },
+  KML_PARSE: {
+    label: "KML / Farm Boundary",
+    targetEntity: "Zone",
+    description: "Parse KML file to extract GPS polygon boundaries for a farm zone.",
+    mimeTypes: [MimeType.KML],
+    icon: "MapPin",
+    approveAction: "UPDATE_ZONE_POLYGON"
+  },
+  AUDIT_UPLOAD: {
+    label: "Audit / Compliance Document",
+    targetEntity: "AuditManifest",
+    description: "Attach evidence documents to a compliance audit project.",
+    mimeTypes: [MimeType.PDF, MimeType.JPEG, MimeType.PNG, MimeType.XLSX],
+    icon: "ShieldCheck",
+    approveAction: "LINK_AUDIT_MANIFEST"
+  },
+  REPORT_GEN: {
+    label: "Report Generation",
+    targetEntity: "AuditProject",
+    description: "Upload a completed audit report for storage and linking.",
+    mimeTypes: [MimeType.PDF],
+    icon: "BarChart2",
+    approveAction: "ATTACH_REPORT_FILE"
+  }
+};
+var RESOURCE_PATHS = {
+  // ── Top-level menu sections ────────────────────────────────────────────────
+  dashboard: "dashboard",
+  operations: "operations",
+  equipment: "equipment",
+  safety: "safety",
+  team: "team",
+  records: "records",
+  adminSettings: "adminSettings",
+  // ── Records & Reports ──────────────────────────────────────────────────────
+  documentHub: "records.documentHub",
+  documentHubTemplates: "records.documentHub.templates",
+  documentHubFolder: "records.documentHub.companyFolder",
+  documentHubExtraction: "records.documentHub.extractionHub",
+  documentHubQueue: "records.documentHub.verificationQueue",
+  analytics: "records.analytics",
+  // ── Admin Settings ─────────────────────────────────────────────────────────
+  adminUserRoster: "adminSettings.userRoster",
+  adminRolesPermissions: "adminSettings.rolesPermissions",
+  adminBlueprintsSites: "adminSettings.blueprintsSites",
+  adminCompanySettings: "adminSettings.companySettings",
+  // ── Operations ────────────────────────────────────────────────────────────
+  farmManagement: "operations.farmManagement",
+  packhouse: "operations.packhouse",
+  accommodation: "operations.accommodation",
+  // ── Equipment & Fleet ──────────────────────────────────────────────────────
+  equipPreStart: "equipment.preStart",
+  equipMaintenance: "equipment.maintenance",
+  equipFuelRegister: "equipment.fuelRegister",
+  equipCalibration: "equipment.calibration",
+  equipFleet: "equipment.fleetManagement",
+  // ── Safety, Quality & Compliance ──────────────────────────────────────────
+  safetyAuditing: "safety.auditing",
+  safetyFood: "safety.foodSafety",
+  safetyWhs: "safety.whs",
+  safetyCleaning: "safety.cleaning",
+  // ── Team & HR ──────────────────────────────────────────────────────────────
+  teamStaff: "team.staff",
+  teamTraining: "team.training"
+};
+var ALL_OPERATIONS = [
+  EnabledModule.FARM_MANAGEMENT,
+  EnabledModule.PACKHOUSE,
+  EnabledModule.ACCOMMODATION
+];
+var AGRI_ONLY = [
+  EnabledModule.FARM_MANAGEMENT,
+  EnabledModule.PACKHOUSE
+];
+var RESOURCE_MODULE_MAP = {
+  // ── Top-level menu sections ────────────────────────────────────────────────
+  [RESOURCE_PATHS.dashboard]: [],
+  [RESOURCE_PATHS.operations]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.equipment]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.safety]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.team]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.records]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.adminSettings]: ALL_OPERATIONS,
+  // ── Records & Reports ──────────────────────────────────────────────────────
+  [RESOURCE_PATHS.documentHub]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.documentHubTemplates]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.documentHubFolder]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.documentHubExtraction]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.documentHubQueue]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.analytics]: ALL_OPERATIONS,
+  // ── Admin Settings ─────────────────────────────────────────────────────────
+  [RESOURCE_PATHS.adminUserRoster]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.adminBlueprintsSites]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.adminRolesPermissions]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.adminCompanySettings]: ALL_OPERATIONS,
+  // ── Operations ────────────────────────────────────────────────────────────
+  [RESOURCE_PATHS.farmManagement]: [EnabledModule.FARM_MANAGEMENT],
+  [RESOURCE_PATHS.packhouse]: [EnabledModule.PACKHOUSE],
+  [RESOURCE_PATHS.accommodation]: [EnabledModule.ACCOMMODATION],
+  // ── Equipment & Fleet ──────────────────────────────────────────────────────
+  [RESOURCE_PATHS.equipPreStart]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.equipMaintenance]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.equipFuelRegister]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.equipCalibration]: AGRI_ONLY,
+  [RESOURCE_PATHS.equipFleet]: ALL_OPERATIONS,
+  // ── Safety, Quality & Compliance ──────────────────────────────────────────
+  [RESOURCE_PATHS.safetyAuditing]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.safetyFood]: AGRI_ONLY,
+  [RESOURCE_PATHS.safetyWhs]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.safetyCleaning]: ALL_OPERATIONS,
+  // ── Team & HR ──────────────────────────────────────────────────────────────
+  [RESOURCE_PATHS.teamStaff]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.teamTraining]: ALL_OPERATIONS
+};
+var ACCESS_RANK = {
+  NONE: 0,
+  READ: 1,
+  WRITE: 2
+};
+var ROLE_SECTIONS_BY_KEY = {
+  dashboard: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR, UserRole.LEADING_HAND, UserRole.WORKER],
+  operations: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR, UserRole.LEADING_HAND, UserRole.WORKER],
+  equipment: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR, UserRole.LEADING_HAND, UserRole.WORKER],
+  safety: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR],
+  team: [UserRole.OWNER, UserRole.MANAGER],
+  records: [UserRole.OWNER, UserRole.MANAGER],
+  adminSettings: []
+};
+var EVERYONE = Object.values(UserRole);
+var RESOURCE_REQUIREMENTS = {
+  [RESOURCE_PATHS.dashboard]: { allowedRoles: EVERYONE },
+  [RESOURCE_PATHS.operations]: { allowedRoles: EVERYONE },
+  // ── Records & Reports ──────────────────────────────────────────────────────
+  [RESOURCE_PATHS.documentHub]: {
+    allowedRoles: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR],
+    requiredPrivileges: [UserPrivilege.ADMIN, UserPrivilege.AUDIT_COMPLIANCE, UserPrivilege.FINANCE, UserPrivilege.HR]
+  },
+  [RESOURCE_PATHS.documentHubTemplates]: {
+    allowedRoles: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR],
+    requiredPrivileges: [UserPrivilege.ADMIN, UserPrivilege.AUDIT_COMPLIANCE, UserPrivilege.FINANCE, UserPrivilege.HR]
+  },
+  [RESOURCE_PATHS.documentHubFolder]: {
+    allowedRoles: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR],
+    requiredPrivileges: [UserPrivilege.ADMIN, UserPrivilege.AUDIT_COMPLIANCE, UserPrivilege.FINANCE, UserPrivilege.HR]
+  },
+  [RESOURCE_PATHS.documentHubExtraction]: {
+    allowedRoles: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR],
+    requiredPrivileges: [UserPrivilege.ADMIN, UserPrivilege.AUDIT_COMPLIANCE, UserPrivilege.FINANCE, UserPrivilege.HR]
+  },
+  [RESOURCE_PATHS.documentHubQueue]: {
+    allowedRoles: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR],
+    requiredPrivileges: [UserPrivilege.ADMIN, UserPrivilege.AUDIT_COMPLIANCE, UserPrivilege.FINANCE, UserPrivilege.HR]
+  },
+  // ── Admin Settings ─────────────────────────────────────────────────────────
+  [RESOURCE_PATHS.adminUserRoster]: {
+    allowedRoles: [UserRole.OWNER],
+    requiredPrivileges: [UserPrivilege.ADMIN]
+  },
+  [RESOURCE_PATHS.adminBlueprintsSites]: {
+    allowedRoles: [UserRole.OWNER],
+    requiredPrivileges: [UserPrivilege.ADMIN]
+  },
+  [RESOURCE_PATHS.adminRolesPermissions]: {
+    allowedRoles: [UserRole.OWNER],
+    requiredPrivileges: [UserPrivilege.ADMIN]
+  },
+  [RESOURCE_PATHS.adminCompanySettings]: {
+    allowedRoles: [UserRole.OWNER]
+  }
+};
+var DocumentType = /* @__PURE__ */ ((DocumentType2) => {
+  DocumentType2["SPRAY_RECORD"] = "SPRAY_RECORD";
+  DocumentType2["FERTIGATION_RECORD"] = "FERTIGATION_RECORD";
+  DocumentType2["FERTILIZER_RECORD"] = "FERTILIZER_RECORD";
+  DocumentType2["QA"] = "QA";
+  DocumentType2["CLEANING"] = "CLEANING";
+  DocumentType2["PEST"] = "PEST";
+  DocumentType2["EQUIPMENT_CALIBRATION_RECORD"] = "EQUIPMENT_CALIBRATION_RECORD";
+  DocumentType2["INVENTORY_CONSUMABLES"] = "INVENTORY_CONSUMABLES";
+  DocumentType2["INVENTORY_BOX_CARTON"] = "INVENTORY_BOX_CARTON";
+  DocumentType2["INVENTORY_CHEMICALS"] = "INVENTORY_CHEMICALS";
+  DocumentType2["STOCKTAKE"] = "STOCKTAKE";
+  DocumentType2["STOCKTAKE_MSDS"] = "STOCKTAKE_MSDS";
+  DocumentType2["MAPPING_FARM_MAPS"] = "MAPPING_FARM_MAPS";
+  DocumentType2["MAPPING_TRAFIC_MANAGEMENT"] = "MAPPING_TRAFIC_MANAGEMENT";
+  DocumentType2["MAPPING_EMERGENCY"] = "MAPPING_EMERGENCY";
+  DocumentType2["INCIDENT_REPORT"] = "INCIDENT_REPORT";
+  DocumentType2["TRAINING_RECORDS"] = "TRAINING_RECORDS";
+  DocumentType2["SOPS"] = "SOPS";
+  DocumentType2["RISK_ASSESSMENTS"] = "RISK_ASSESSMENTS";
+  DocumentType2["SERVICING_MAINTENANCE"] = "SERVICING_MAINTENANCE";
+  DocumentType2["SOIL_TEST"] = "SOIL_TEST";
+  DocumentType2["LEAF_TEST"] = "LEAF_TEST";
+  DocumentType2["WATER_TEST"] = "WATER_TEST";
+  DocumentType2["MRL_TESTING"] = "MRL_TESTING";
+  DocumentType2["HEAVY_METAL"] = "HEAVY_METAL";
+  DocumentType2["MICROBIAL"] = "MICROBIAL";
+  DocumentType2["HARVEST_LOG"] = "HARVEST_LOG";
+  DocumentType2["PACKHOUSE_INSPECTION"] = "PACKHOUSE_INSPECTION";
+  DocumentType2["TRAINING_CERTIFICATE"] = "TRAINING_CERTIFICATE";
+  DocumentType2["INVOICE"] = "INVOICE";
+  DocumentType2["LEGAL_CONTRACT"] = "LEGAL_CONTRACT";
+  DocumentType2["AUDIT_REPORT"] = "AUDIT_REPORT";
+  DocumentType2["SENSITIVE_IDENTITY"] = "SENSITIVE_IDENTITY";
+  return DocumentType2;
+})(DocumentType || {});
+var DOCUMENT_MENU_MAP = {
+  ["SPRAY_RECORD" /* SPRAY_RECORD */]: [RESOURCE_PATHS.farmManagement],
+  ["FERTIGATION_RECORD" /* FERTIGATION_RECORD */]: [RESOURCE_PATHS.farmManagement],
+  ["FERTILIZER_RECORD" /* FERTILIZER_RECORD */]: [RESOURCE_PATHS.farmManagement],
+  ["QA" /* QA */]: [RESOURCE_PATHS.safetyAuditing],
+  ["CLEANING" /* CLEANING */]: [RESOURCE_PATHS.safetyCleaning],
+  ["PEST" /* PEST */]: [RESOURCE_PATHS.farmManagement],
+  ["EQUIPMENT_CALIBRATION_RECORD" /* EQUIPMENT_CALIBRATION_RECORD */]: [RESOURCE_PATHS.equipCalibration],
+  ["SERVICING_MAINTENANCE" /* SERVICING_MAINTENANCE */]: [RESOURCE_PATHS.equipMaintenance],
+  ["INVENTORY_CONSUMABLES" /* INVENTORY_CONSUMABLES */]: [RESOURCE_PATHS.packhouse],
+  ["INVENTORY_BOX_CARTON" /* INVENTORY_BOX_CARTON */]: [RESOURCE_PATHS.packhouse],
+  ["INVENTORY_CHEMICALS" /* INVENTORY_CHEMICALS */]: [RESOURCE_PATHS.packhouse, RESOURCE_PATHS.farmManagement],
+  ["STOCKTAKE" /* STOCKTAKE */]: [RESOURCE_PATHS.packhouse],
+  ["STOCKTAKE_MSDS" /* STOCKTAKE_MSDS */]: [RESOURCE_PATHS.safetyWhs],
+  ["MAPPING_FARM_MAPS" /* MAPPING_FARM_MAPS */]: [RESOURCE_PATHS.adminBlueprintsSites],
+  ["MAPPING_TRAFIC_MANAGEMENT" /* MAPPING_TRAFIC_MANAGEMENT */]: [RESOURCE_PATHS.adminBlueprintsSites],
+  ["MAPPING_EMERGENCY" /* MAPPING_EMERGENCY */]: [RESOURCE_PATHS.adminBlueprintsSites],
+  ["INCIDENT_REPORT" /* INCIDENT_REPORT */]: [RESOURCE_PATHS.safetyWhs],
+  ["RISK_ASSESSMENTS" /* RISK_ASSESSMENTS */]: [RESOURCE_PATHS.safetyWhs],
+  ["TRAINING_RECORDS" /* TRAINING_RECORDS */]: [RESOURCE_PATHS.teamTraining],
+  ["TRAINING_CERTIFICATE" /* TRAINING_CERTIFICATE */]: [RESOURCE_PATHS.teamTraining],
+  ["SOPS" /* SOPS */]: [RESOURCE_PATHS.documentHubTemplates],
+  ["SOIL_TEST" /* SOIL_TEST */]: [RESOURCE_PATHS.farmManagement],
+  ["LEAF_TEST" /* LEAF_TEST */]: [RESOURCE_PATHS.farmManagement],
+  ["WATER_TEST" /* WATER_TEST */]: [RESOURCE_PATHS.farmManagement, RESOURCE_PATHS.safetyFood],
+  ["MRL_TESTING" /* MRL_TESTING */]: [RESOURCE_PATHS.safetyFood],
+  ["HEAVY_METAL" /* HEAVY_METAL */]: [RESOURCE_PATHS.safetyFood],
+  ["MICROBIAL" /* MICROBIAL */]: [RESOURCE_PATHS.safetyFood],
+  ["HARVEST_LOG" /* HARVEST_LOG */]: [RESOURCE_PATHS.farmManagement],
+  ["PACKHOUSE_INSPECTION" /* PACKHOUSE_INSPECTION */]: [RESOURCE_PATHS.packhouse],
+  ["INVOICE" /* INVOICE */]: [RESOURCE_PATHS.documentHub],
+  ["LEGAL_CONTRACT" /* LEGAL_CONTRACT */]: [RESOURCE_PATHS.documentHub],
+  ["AUDIT_REPORT" /* AUDIT_REPORT */]: [RESOURCE_PATHS.safetyAuditing, RESOURCE_PATHS.dashboard],
+  ["SENSITIVE_IDENTITY" /* SENSITIVE_IDENTITY */]: [RESOURCE_PATHS.adminUserRoster]
+};
+
+export {
+  MOD,
+  CAT,
+  ACT,
+  SENTINEL_UUID,
+  MODULE_LABELS,
+  ERROR_DICTIONARY,
+  UserRole,
+  UserPrivilege,
+  AccessLevel,
+  EnabledModule,
+  FacilityType,
+  LinkedStatus,
+  RelationshipType,
+  ApprovalType,
+  TransactionType,
+  ApprovalStatus,
+  OrderStatus,
+  NotificationMode,
+  TaskType,
+  TaskStatus,
+  MimeType,
+  TargetEntityType,
+  AuditType,
+  AuditStatus,
+  SoilTexture,
+  MicroclimateZone,
+  PlantingMethod,
+  RowOrientation,
+  EmitterType,
+  TrellisType,
+  NettingType,
+  HarvestMethod,
+  VigorRating,
+  CropCycleStatus,
+  WaterSource,
+  PhysicalState,
+  FORM_REGISTRY,
+  TASK_TYPE_REGISTRY,
+  RESOURCE_PATHS,
+  RESOURCE_MODULE_MAP,
+  ACCESS_RANK,
+  ROLE_SECTIONS_BY_KEY,
+  EVERYONE,
+  RESOURCE_REQUIREMENTS,
+  DocumentType,
+  DOCUMENT_MENU_MAP
+};