@litusarchieve18/agricore-utils 1.0.1

package/dist/index.js

@@ -0,0 +1,894 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ACT: () => ACT,
+  AccessLevel: () => AccessLevel,
+  AgriLogger: () => AgriLogger,
+  AppError: () => AppError,
+  ApprovalStatus: () => ApprovalStatus,
+  ApprovalType: () => ApprovalType,
+  AuditStatus: () => AuditStatus,
+  AuditType: () => AuditType,
+  CAT: () => CAT,
+  Converter: () => Converter,
+  CropCycleStatus: () => CropCycleStatus,
+  ERROR_DICTIONARY: () => ERROR_DICTIONARY,
+  EmitterType: () => EmitterType,
+  EnabledModule: () => EnabledModule,
+  ErrorFactory: () => ErrorFactory,
+  FORM_REGISTRY: () => FORM_REGISTRY,
+  FacilityType: () => FacilityType,
+  HarvestMethod: () => HarvestMethod,
+  LinkedStatus: () => LinkedStatus,
+  MOD: () => MOD,
+  MODULE_LABELS: () => MODULE_LABELS,
+  MicroclimateZone: () => MicroclimateZone,
+  MimeType: () => MimeType,
+  NettingType: () => NettingType,
+  NotificationMode: () => NotificationMode,
+  OrderStatus: () => OrderStatus,
+  PhysicalState: () => PhysicalState,
+  PlantingMethod: () => PlantingMethod,
+  RESOURCE_PATHS: () => RESOURCE_PATHS,
+  RelationshipType: () => RelationshipType,
+  RowOrientation: () => RowOrientation,
+  SENTINEL_UUID: () => SENTINEL_UUID,
+  SoilTexture: () => SoilTexture,
+  TASK_TYPE_REGISTRY: () => TASK_TYPE_REGISTRY,
+  TargetEntityType: () => TargetEntityType,
+  TaskStatus: () => TaskStatus,
+  TaskType: () => TaskType,
+  TransactionType: () => TransactionType,
+  TrellisType: () => TrellisType,
+  UserPrivilege: () => UserPrivilege,
+  UserRole: () => UserRole,
+  Validator: () => Validator,
+  VigorRating: () => VigorRating,
+  WaterSource: () => WaterSource,
+  assertCanWrite: () => assertCanWrite,
+  buildRlsFilter: () => buildRlsFilter,
+  canRead: () => canRead,
+  canWrite: () => canWrite,
+  extractAppCode: () => extractAppCode,
+  generateCanonicalId: () => generateCanonicalId,
+  getAcceptedMimeTypes: () => getAcceptedMimeTypes,
+  getApproveAction: () => getApproveAction,
+  getFormMeta: () => getFormMeta,
+  getFormsGroupedByModule: () => getFormsGroupedByModule,
+  getTaskTypeOptions: () => getTaskTypeOptions,
+  handleAppErrorResponse: () => handleAppErrorResponse,
+  isTabVisible: () => isTabVisible,
+  isTabWritable: () => isTabWritable,
+  resolveAccess: () => resolveAccess,
+  resolveAppError: () => resolveAppError,
+  resolveAuthScopeId: () => resolveAuthScopeId,
+  resolveError: () => resolveError,
+  resolveMenuVisibility: () => resolveMenuVisibility,
+  withAgriLogging: () => withAgriLogging,
+  withSaveMiddleware: () => withSaveMiddleware
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/logger.ts
+var SENSITIVE_KEYS = ["password", "token", "secret", "apiKey", "creditCard", "authorization"];
+function redact(obj) {
+  if (!obj || typeof obj !== "object") return obj;
+  if (Array.isArray(obj)) return obj.map(redact);
+  const redactedObj = { ...obj };
+  for (const key in redactedObj) {
+    if (SENSITIVE_KEYS.includes(key.toLowerCase())) {
+      redactedObj[key] = "[REDACTED]";
+    } else if (typeof redactedObj[key] === "object") {
+      redactedObj[key] = redact(redactedObj[key]);
+    }
+  }
+  return redactedObj;
+}
+var AgriLogger = {
+  log(level, message, meta) {
+    const logEntry = {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level,
+      message,
+      functionName: meta.functionName,
+      duration: meta.duration ? `${meta.duration}ms` : void 0,
+      user: meta.session ? {
+        id: meta.session.userId,
+        companyId: meta.session.companyId
+      } : "SYSTEM",
+      context: {
+        input: redact(meta.input),
+        output: redact(meta.output),
+        error: meta.error instanceof Error ? { message: meta.error.message, stack: meta.error.stack } : redact(meta.error)
+      }
+    };
+    console.log(JSON.stringify(logEntry));
+  }
+};
+function withAgriLogging(fn, functionName, session) {
+  return (async (...args) => {
+    const startTime = Date.now();
+    AgriLogger.log("INFO", `Started ${functionName}`, { functionName, session, input: args });
+    try {
+      const result = await fn(...args);
+      const duration = Date.now() - startTime;
+      AgriLogger.log("INFO", `Completed ${functionName}`, {
+        functionName,
+        session,
+        output: result,
+        duration
+      });
+      return result;
+    } catch (error) {
+      const duration = Date.now() - startTime;
+      AgriLogger.log("ERROR", `Failed ${functionName}`, {
+        functionName,
+        session,
+        error,
+        duration
+      });
+      throw error;
+    }
+  });
+}
+
+// src/validators.ts
+var Validator = {
+  /** * 1. Email: The classic. Uses a standard RFC 5322 regex.
+   */
+  isEmail: (val) => {
+    const emailRegex = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+    return emailRegex.test(val);
+  },
+  /** * 2. UUID v4: Critical for your canonicalId and authScopeId checks.
+   */
+  isUUID: (value) => {
+    if (!value) return false;
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(value);
+  },
+  /** * 3. ISO Date String: Ensures dates are stored in UTC/ISO format.
+   */
+  isIsoDate: (val) => {
+    if (!val) return false;
+    const d = new Date(val);
+    return !isNaN(d.getTime()) && val.includes("T") && val.endsWith("Z");
+  },
+  isPositiveNumber: (value) => {
+    return value != null && typeof value === "number" && value > 0;
+  },
+  /** * 4. Strong Password: Min 8 chars, 1 uppercase, 1 lowercase, 1 number, 1 special char.
+   */
+  isStrongPassword: (val) => {
+    const passwordRegex = /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]{8,}$/;
+    return passwordRegex.test(val);
+  },
+  /** * 5. Phone Number (E.164): The international standard (e.g., +61400123456).
+   */
+  isE164Phone: (val) => {
+    const phoneRegex = /^\+[1-9]\d{1,14}$/;
+    return phoneRegex.test(val);
+  },
+  /** * 6. Range Checker: Useful for temperature sensors or quantity limits.
+   */
+  isInRange: (val, min, max) => {
+    return val >= min && val <= max;
+  },
+  /** * 7. URL: Basic validation for external documentation links.
+   */
+  isValidUrl: (val) => {
+    try {
+      new URL(val);
+      return true;
+    } catch {
+      return false;
+    }
+  },
+  /** * 8. Slug: Useful for URL-friendly names (e.g. "sunset-farm-01").
+   */
+  isSlug: (val) => {
+    const slugRegex = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+    return slugRegex.test(val);
+  },
+  isNotEmpty: (value) => {
+    return value != null && value.trim().length > 0;
+  },
+  /** * 9. Is Non-Empty Array: Ensures you don't save an empty list of IDs.
+   */
+  hasItems: (val) => {
+    return Array.isArray(val) && val.length > 0;
+  },
+  /** * 10. Coordinates: Validate GPS Latitude/Longitude for Farm maps.
+   */
+  isValidCoordinate: (lat, lng) => {
+    return lat >= -90 && lat <= 90 && lng >= -180 && lng <= 180;
+  }
+};
+
+// src/converters.ts
+var CONSTANTS = {
+  HA_TO_ACRE: 2.47105,
+  LITER_TO_GAL_US: 0.264172,
+  LITER_TO_GAL_UK: 0.219969
+};
+function roundTo(value, decimals = 2) {
+  const factor = Math.pow(10, decimals);
+  return Math.round(value * factor) / factor;
+}
+var Converter = {
+  // ─── Area Conversions ──────────────────────────────────────────────────────
+  /**
+   * Hectares to Acres
+   * Formula: $Acres = Hectares \times 2.47105$
+   */
+  haToAcre: (ha, precision = 2) => {
+    return roundTo(ha * CONSTANTS.HA_TO_ACRE, precision);
+  },
+  /**
+   * Acres to Hectares
+   * Formula: $Hectares = Acres \div 2.47105$
+   */
+  acreToHa: (acre, precision = 2) => {
+    return roundTo(acre / CONSTANTS.HA_TO_ACRE, precision);
+  },
+  // ─── Volume Conversions ────────────────────────────────────────────────────
+  /**
+   * Liters to US Gallons
+   * Formula: $Gallons = Liters \times 0.264172$
+   */
+  literToGal: (liters, precision = 2) => {
+    return roundTo(liters * CONSTANTS.LITER_TO_GAL_US, precision);
+  },
+  /**
+   * US Gallons to Liters
+   * Formula: $Liters = Gallons \div 0.264172$
+   */
+  galToLiter: (gal, precision = 2) => {
+    return roundTo(gal / CONSTANTS.LITER_TO_GAL_US, precision);
+  },
+  // ─── Mass Conversions (Bonus) ──────────────────────────────────────────────
+  /**
+   * Kilograms to Pounds (useful for yield/harvest data)
+   */
+  kgToLbs: (kg, precision = 2) => {
+    return roundTo(kg * 2.20462, precision);
+  }
+};
+
+// 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;
+  isOperational;
+  constructor(status, mod, cat, act, message) {
+    super(message);
+    this.status = status;
+    this.appCode = `${mod}-${status}-${cat}${act}`;
+    this.isOperational = true;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var ErrorFactory = {
+  unauthorized: (mod, msg = "Authentication required") => new AppError(401, mod, CAT.PERMISSION, ACT.GENERIC, msg),
+  forbidden: (mod, act, msg = "Access denied") => new AppError(403, mod, CAT.PERMISSION, act, msg),
+  badRequest: (mod, act, msg = "Bad request") => new AppError(400, mod, CAT.VALIDATION, act, msg),
+  notFound: (mod, act = ACT.GENERIC, msg = "Record not found") => new AppError(404, mod, CAT.VALIDATION, act, msg),
+  conflict: (mod, act, msg = "Record already exists") => new AppError(409, mod, CAT.INTEGRITY, act, msg),
+  integrity: (mod, act = ACT.GENERIC, msg = "Data integrity violation") => new AppError(409, mod, CAT.INTEGRITY, act, msg),
+  subscription: (mod, msg = "Module locked or subscription required") => new AppError(403, mod, CAT.SUBSCRIPTION, ACT.GENERIC, msg),
+  internal: (mod, msg = "Internal server error") => new AppError(500, mod, CAT.INTEGRITY, ACT.GENERIC, msg)
+};
+var handleAppErrorResponse = (error, mod = MOD.ADMIN) => {
+  if (error instanceof AppError && error.isOperational) {
+    return Response.json(
+      { error: { appCode: error.appCode, message: error.message } },
+      { status: error.status }
+    );
+  }
+  const e = error;
+  console.error(`[${mod}] UNEXPECTED ERROR:`, e?.message);
+  console.error(`[${mod}] STACK:`, e?.stack);
+  return Response.json(
+    { error: { appCode: `${mod}-500-000`, message: "An unexpected server error occurred. Please try again." } },
+    { 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."
+};
+var resolveAppError = (appCode) => {
+  if (!appCode || typeof appCode !== "string") {
+    return { ...FALLBACK, module: "UNK", moduleLabel: "Unknown", status: 500, catAct: "000", isSubscriptionIssue: false, isPermissionIssue: false };
+  }
+  const parts = appCode.split("-");
+  if (parts.length !== 3) {
+    return { ...FALLBACK, module: "UNK", moduleLabel: "Unknown", status: 500, catAct: "000", isSubscriptionIssue: false, isPermissionIssue: false };
+  }
+  const [mod, status, catAct] = parts;
+  const details = ERROR_DICTIONARY[catAct] || FALLBACK;
+  return {
+    title: details.title,
+    text: details.text,
+    module: mod,
+    moduleLabel: MODULE_LABELS[mod] || mod,
+    status: parseInt(status, 10),
+    catAct,
+    isSubscriptionIssue: catAct.startsWith("1"),
+    isPermissionIssue: catAct.startsWith("2")
+  };
+};
+var extractAppCode = (error) => {
+  const e = error;
+  return e?.response?.data?.error?.appCode ?? e?.data?.error?.appCode ?? null;
+};
+var resolveError = (error) => {
+  const appCode = extractAppCode(error);
+  if (appCode) return resolveAppError(appCode);
+  const e = error;
+  return { ...FALLBACK, module: "UNK", moduleLabel: "Unknown", status: e?.status || 500, catAct: "000", isSubscriptionIssue: false, isPermissionIssue: false };
+};
+function generateCanonicalId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    return (c === "x" ? r : r & 3 | 8).toString(16);
+  });
+}
+function resolveAuthScopeId(fields = {}) {
+  return fields.facilityId || fields.legalEntityId || fields.companyId || SENTINEL_UUID;
+}
+function withSaveMiddleware(data) {
+  const canonicalId = data.canonicalId || generateCanonicalId();
+  return {
+    ...data,
+    canonicalId,
+    authScopeId: data.authScopeId || resolveAuthScopeId(data)
+  };
+}
+function buildRlsFilter(session, extra = {}) {
+  return { ...extra, authScopeId: { $in: session.readScopes || [] } };
+}
+function canRead(session, authScopeId) {
+  return session.readScopes?.includes(authScopeId) ?? false;
+}
+function canWrite(session, authScopeId, resourcePath) {
+  const override = session.resourceOverrides?.[authScopeId]?.[resourcePath];
+  if (override === "WRITE") return true;
+  if (override === "NONE" || override === "READ") return false;
+  return session.writeScopes?.includes(authScopeId) ?? false;
+}
+function assertCanWrite(session, authScopeId, resourcePath) {
+  const override = session.resourceOverrides?.[authScopeId]?.[resourcePath];
+  if (override === "WRITE") return;
+  if (override === "NONE" || override === "READ") {
+    throw new AppError(
+      403,
+      MOD.SESSION,
+      CAT.PERMISSION,
+      ACT.GENERIC,
+      `You do not have write access to "${resourcePath}" in this scope.`
+    );
+  }
+  if (session.writeScopes?.includes(authScopeId)) return;
+  throw new AppError(
+    403,
+    MOD.SESSION,
+    CAT.PERMISSION,
+    ACT.GENERIC,
+    "You do not have permission to modify records in this scope."
+  );
+}
+function resolveAccess(session, activeScopeId, tabConfig) {
+  const resourcePath = tabConfig?.resourceId;
+  const overrides = session.resourceOverrides?.[activeScopeId] ?? {};
+  if (resourcePath) {
+    const segments = resourcePath.split(".");
+    for (let len = segments.length; len >= 1; len--) {
+      const path = segments.slice(0, len).join(".");
+      const override = overrides[path];
+      if (override === "NONE" || override === "READ" || override === "WRITE") return override;
+    }
+  }
+  const allowedRoles = tabConfig?.allowedRoles ?? [];
+  const requiredPrivileges = tabConfig?.requiredPrivileges ?? [];
+  const hasRestrictions = allowedRoles.length > 0 || requiredPrivileges.length > 0;
+  if (hasRestrictions) {
+    const role = session?.role ?? "";
+    const privileges = session?.privileges ?? [];
+    const passesRole = allowedRoles.length > 0 && allowedRoles.includes(role);
+    const passesPrivilege = requiredPrivileges.length > 0 && requiredPrivileges.some((p) => privileges.includes(p));
+    return passesRole || passesPrivilege ? "WRITE" : "NONE";
+  }
+  return "READ";
+}
+function resolveMenuVisibility(session, authScopeId, resourcePath) {
+  const override = session.resourceOverrides?.[authScopeId]?.[resourcePath];
+  if (override === "NONE") return "hidden";
+  if (override === "READ") return "read_only";
+  if (override === "WRITE") return "active";
+  if (session.writeScopes?.includes(authScopeId)) return "active";
+  if (session.readScopes?.includes(authScopeId)) return "read_only";
+  return "hidden";
+}
+function isTabVisible(session, activeScopeId, tabConfig) {
+  return resolveAccess(session, activeScopeId, tabConfig) !== "NONE";
+}
+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",
+  FUEL_SITE: "FUEL_SITE",
+  WORKSHOP: "WORKSHOP",
+  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"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ACT,
+  AccessLevel,
+  AgriLogger,
+  AppError,
+  ApprovalStatus,
+  ApprovalType,
+  AuditStatus,
+  AuditType,
+  CAT,
+  Converter,
+  CropCycleStatus,
+  ERROR_DICTIONARY,
+  EmitterType,
+  EnabledModule,
+  ErrorFactory,
+  FORM_REGISTRY,
+  FacilityType,
+  HarvestMethod,
+  LinkedStatus,
+  MOD,
+  MODULE_LABELS,
+  MicroclimateZone,
+  MimeType,
+  NettingType,
+  NotificationMode,
+  OrderStatus,
+  PhysicalState,
+  PlantingMethod,
+  RESOURCE_PATHS,
+  RelationshipType,
+  RowOrientation,
+  SENTINEL_UUID,
+  SoilTexture,
+  TASK_TYPE_REGISTRY,
+  TargetEntityType,
+  TaskStatus,
+  TaskType,
+  TransactionType,
+  TrellisType,
+  UserPrivilege,
+  UserRole,
+  Validator,
+  VigorRating,
+  WaterSource,
+  assertCanWrite,
+  buildRlsFilter,
+  canRead,
+  canWrite,
+  extractAppCode,
+  generateCanonicalId,
+  getAcceptedMimeTypes,
+  getApproveAction,
+  getFormMeta,
+  getFormsGroupedByModule,
+  getTaskTypeOptions,
+  handleAppErrorResponse,
+  isTabVisible,
+  isTabWritable,
+  resolveAccess,
+  resolveAppError,
+  resolveAuthScopeId,
+  resolveError,
+  resolveMenuVisibility,
+  withAgriLogging,
+  withSaveMiddleware
+});