@litusarchieve18/agricore-utils 1.0.11 → 1.0.13

package/dist/index.mjs

@@ -1,3 +1,52 @@
+import {
+  ACCESS_RANK,
+  ACT,
+  AccessLevel,
+  ApprovalStatus,
+  ApprovalType,
+  AuditStatus,
+  AuditType,
+  CAT,
+  CropCycleStatus,
+  DOCUMENT_MENU_MAP,
+  DocumentType,
+  ERROR_DICTIONARY,
+  EVERYONE,
+  EmitterType,
+  EnabledModule,
+  FORM_REGISTRY,
+  FacilityType,
+  HarvestMethod,
+  LinkedStatus,
+  MOD,
+  MODULE_LABELS,
+  MicroclimateZone,
+  MimeType,
+  NettingType,
+  NotificationMode,
+  OrderStatus,
+  PhysicalState,
+  PlantingMethod,
+  RESOURCE_MODULE_MAP,
+  RESOURCE_PATHS,
+  RESOURCE_REQUIREMENTS,
+  ROLE_SECTIONS_BY_KEY,
+  RelationshipType,
+  RowOrientation,
+  SENTINEL_UUID,
+  SoilTexture,
+  TASK_TYPE_REGISTRY,
+  TargetEntityType,
+  TaskStatus,
+  TaskType,
+  TransactionType,
+  TrellisType,
+  UserPrivilege,
+  UserRole,
+  VigorRating,
+  WaterSource
+} from "./chunk-QI4YXI4P.mjs";
+
 // src/index.ts
 import { jwtVerify } from "jose";
 
@@ -188,36 +237,6 @@ var Converter = {
 };
 
 // src/index.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"
-  // ← added: used in generateSessionContext but was missing from errorRegistry.js
-};
-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 AppError = class extends Error {
   status;
   appCode;
@@ -255,43 +274,6 @@ var handleAppErrorResponse = (error, mod = MOD.ADMIN) => {
     { status: 500 }
   );
 };
-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 FALLBACK = {
   title: "Something Went Wrong",
   text: "An unexpected error occurred. Please try again or contact your administrator."
@@ -433,458 +415,6 @@ function isTabVisible(session, activeScopeId, tabConfig) {
 function isTabWritable(session, activeScopeId, tabConfig) {
   return resolveAccess(session, activeScopeId, tabConfig) === "WRITE";
 }
-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" }
-};
-function getFormMeta(componentId) {
-  return FORM_REGISTRY[componentId] ?? null;
-}
-function getFormsGroupedByModule() {
-  const groups = {};
-  for (const [id, meta] of Object.entries(FORM_REGISTRY)) {
-    if (!groups[meta.module]) groups[meta.module] = [];
-    groups[meta.module].push({ id, ...meta });
-  }
-  return groups;
-}
-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 getTaskTypeOptions = () => Object.entries(TASK_TYPE_REGISTRY).map(([value, config]) => ({
-  value,
-  label: config.label,
-  description: config.description,
-  mimeTypes: config.mimeTypes,
-  icon: config.icon
-}));
-var getAcceptedMimeTypes = (taskType) => {
-  const config = TASK_TYPE_REGISTRY[taskType];
-  return config ? config.mimeTypes.join(",") : "*/*";
-};
-var getApproveAction = (taskType) => {
-  return TASK_TYPE_REGISTRY[taskType]?.approveAction ?? null;
-};
-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 ────────────────────────────────────────────────
-  // CORE features (accessible to everyone with an account)
-  [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
-  },
-  // [RESOURCE_PATHS.equipment]: EVERYONE, 
-  // [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]: {
-    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]
-  },
-  // [RESOURCE_PATHS.analytics]: ALL_OPERATIONS,
-  // ── 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]
-  }
-  //  // ── 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,
-};
 function evaluateBaseAccess(resourcePath, session, requirements = {}) {
   if (!session?.role) return "NONE";
   if (session.role === UserRole.OWNER) return "WRITE";
@@ -961,6 +491,68 @@ async function verifyAndExtractSession(token, secret) {
     throw ErrorFactory.unauthorized(MOD.SESSION, "UNAUTHORIZED: No secure session token provided.");
   }
 }
+function getFormMeta(componentId) {
+  return FORM_REGISTRY[componentId] ?? null;
+}
+function getFormsGroupedByModule() {
+  const groups = {};
+  for (const [id, meta] of Object.entries(FORM_REGISTRY)) {
+    if (!groups[meta.module]) groups[meta.module] = [];
+    groups[meta.module].push({ id, ...meta });
+  }
+  return groups;
+}
+var getTaskTypeOptions = () => Object.entries(TASK_TYPE_REGISTRY).map(([value, config]) => ({
+  value,
+  label: config.label,
+  description: config.description,
+  mimeTypes: config.mimeTypes,
+  icon: config.icon
+}));
+var getAcceptedMimeTypes = (taskType) => {
+  const config = TASK_TYPE_REGISTRY[taskType];
+  return config ? config.mimeTypes.join(",") : "*/*";
+};
+var getApproveAction = (taskType) => {
+  return TASK_TYPE_REGISTRY[taskType]?.approveAction ?? null;
+};
+function generateDocumentPath(params) {
+  const sanitizedName = params.siteName.replace(/[^a-z0-9]/gi, "_");
+  if (params.isStatic) {
+    return `${sanitizedName}/_CORE/${params.docType}`;
+  } else {
+    const folderYear = params.year || (/* @__PURE__ */ new Date()).getUTCFullYear();
+    const folderCrop = params.crop ? `/${params.crop.toUpperCase()}` : "";
+    return `${sanitizedName}/_SEASONAL/${folderYear}/${params.docType}${folderCrop}`;
+  }
+}
+function isValueMatch(fileValue, expectedValue) {
+  if (Array.isArray(expectedValue)) return expectedValue.includes(fileValue);
+  return fileValue === expectedValue;
+}
+function calculateFileMetadataMatch(criteria, fileMetadata, auditContext) {
+  for (const [key, expectedValue] of Object.entries(criteria.mustMatch)) {
+    if (!isValueMatch(fileMetadata[key], expectedValue)) return 0;
+  }
+  if (criteria.mustMatchContext) {
+    for (const field of criteria.mustMatchContext) {
+      const contextValue = auditContext[field];
+      if (contextValue === void 0) continue;
+      if (!isValueMatch(fileMetadata[field], contextValue)) return 0;
+    }
+  }
+  if (fileMetadata.isStatic === true) return 100;
+  if (!criteria.contextMatch || criteria.contextMatch.length === 0) return 100;
+  let matches = 0;
+  let validChecks = 0;
+  criteria.contextMatch.forEach((field) => {
+    const contextValue = auditContext[field];
+    if (contextValue === void 0) return;
+    validChecks++;
+    if (isValueMatch(fileMetadata[field], contextValue)) matches++;
+  });
+  return validChecks > 0 ? Math.round(matches / validChecks * 100) : 100;
+}
 export {
   ACCESS_RANK,
   ACT,
@@ -974,6 +566,8 @@ export {
   CAT,
   Converter,
   CropCycleStatus,
+  DOCUMENT_MENU_MAP,
+  DocumentType,
   ERROR_DICTIONARY,
   EVERYONE,
   EmitterType,
@@ -1014,12 +608,14 @@ export {
   assertCanWrite,
   assertTenantBoundary,
   buildRlsFilter,
+  calculateFileMetadataMatch,
   canRead,
   canWrite,
   evaluateBaseAccess,
   extractAppCode,
   findSpecificOverride,
   generateCanonicalId,
+  generateDocumentPath,
   generateInfrastructureFields,
   getAcceptedMimeTypes,
   getApproveAction,