@litusarchieve18/agricore-utils 1.0.30 → 1.0.32

package/dist/index.js

@@ -61,17 +61,22 @@ __export(index_exports, {
   NettingType: () => NettingType,
   NotificationMode: () => NotificationMode,
   OrderStatus: () => OrderStatus,
+  PO_STATUSES: () => PO_STATUSES,
+  PREFLIGHT_CHECK_STATUSES: () => PREFLIGHT_CHECK_STATUSES,
+  PRODUCT_TYPE_TO_BUDGET_CATEGORY: () => PRODUCT_TYPE_TO_BUDGET_CATEGORY,
   PhysicalState: () => PhysicalState,
   PlantingMethod: () => PlantingMethod,
   PriceAmbiguityError: () => PriceAmbiguityError,
   ProductType: () => ProductType,
   ProductUnit: () => ProductUnit,
+  REQUISITION_STATUSES: () => REQUISITION_STATUSES,
   RESOURCE_MODULE_MAP: () => RESOURCE_MODULE_MAP,
   RESOURCE_PATHS: () => RESOURCE_PATHS,
   RESOURCE_REQUIREMENTS: () => RESOURCE_REQUIREMENTS,
   ROLE_SECTIONS_BY_KEY: () => ROLE_SECTIONS_BY_KEY,
   RelationshipType: () => RelationshipType,
   RowOrientation: () => RowOrientation,
+  SCOPE_LEVELS: () => SCOPE_LEVELS,
   SENTINEL_UUID: () => SENTINEL_UUID,
   SESSION_SCHEMA: () => SESSION_SCHEMA,
   SIGNATURE_MODES: () => SIGNATURE_MODES,
@@ -79,7 +84,7 @@ __export(index_exports, {
   StockPolicyTier: () => StockPolicyTier,
   StoragePhases: () => StoragePhases,
   TASK_TYPE_REGISTRY: () => TASK_TYPE_REGISTRY,
-  TEMPLATE_SCOPE_LEVELS: () => TEMPLATE_SCOPE_LEVELS,
+  TERM_RESOLUTION_MODES: () => TERM_RESOLUTION_MODES,
   TargetEntityType: () => TargetEntityType,
   TaskStatus: () => TaskStatus,
   TaskType: () => TaskType,
@@ -92,6 +97,7 @@ __export(index_exports, {
   WaterSource: () => WaterSource,
   assertTenantBoundary: () => assertTenantBoundary,
   calculateFileMetadataMatch: () => calculateFileMetadataMatch,
+  calculatePaymentDueDate: () => calculatePaymentDueDate,
   createBase44PricingAdapter: () => createBase44PricingAdapter,
   decodeSession: () => decodeSession,
   encodeSession: () => encodeSession,
@@ -102,6 +108,7 @@ __export(index_exports, {
   generateCanonicalId: () => generateCanonicalId,
   generateDocumentPath: () => generateDocumentPath,
   generateInfrastructureFields: () => generateInfrastructureFields,
+  generateSystemFolderPath: () => generateSystemFolderPath,
   getAcceptedMimeTypes: () => getAcceptedMimeTypes,
   getApproveAction: () => getApproveAction,
   getFormMeta: () => getFormMeta,
@@ -113,6 +120,9 @@ __export(index_exports, {
   handleAppErrorResponse: () => handleAppErrorResponse,
   hasPrivilegeAt: () => hasPrivilegeAt,
   hasRoleAt: () => hasRoleAt,
+  isDueDatePending: () => isDueDatePending,
+  isInstallmentSchedule: () => isInstallmentSchedule,
+  isSingleDueDate: () => isSingleDueDate,
   isTabVisible: () => isTabVisible,
   isTabWritable: () => isTabWritable,
   resolveAccess: () => resolveAccess,
@@ -120,6 +130,7 @@ __export(index_exports, {
   resolveEffectiveAccess: () => resolveEffectiveAccess,
   resolveError: () => resolveError,
   resolvePrice: () => resolvePrice,
+  sanitizeSiteName: () => sanitizeSiteName,
   transformRoleAssignments: () => transformRoleAssignments,
   verifyAndExtractSession: () => verifyAndExtractSession,
   withAgriLogging: () => withAgriLogging
@@ -470,6 +481,165 @@ async function findOverlappingPriceWindows(db, scope, newRow, excludeId) {
   }));
 }
 
+// src/paymentDueDateHelpers.ts
+function toUtcMidnight(date) {
+  return new Date(
+    Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate())
+  );
+}
+function addDaysUtc(date, days) {
+  const result = new Date(date);
+  result.setUTCDate(result.getUTCDate() + days);
+  return result;
+}
+function lastDayOfNextMonthUtc(date) {
+  return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + 2, 0));
+}
+function nthDayOfNextMonthUtc(date, day) {
+  return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + 1, day));
+}
+function lastDayOfMonthUtc(date) {
+  return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + 1, 0));
+}
+function calculateSupplierTradeCreditDueDate(transactionDate, window) {
+  if (!window) {
+    throw new Error(
+      "creditDaysWindow is required when paymentTerm is 'supplierTradeCredit'"
+    );
+  }
+  switch (window.type) {
+    case "NET":
+      if (!Number.isInteger(window.days) || window.days < 0) {
+        throw new Error(`Invalid NET days: ${window.days}`);
+      }
+      return addDaysUtc(transactionDate, window.days);
+    case "EOM":
+      if (window.days === void 0) {
+        return lastDayOfNextMonthUtc(transactionDate);
+      }
+      if (!Number.isInteger(window.days) || window.days < 1 || window.days > 31) {
+        throw new Error(`Invalid EOM day-of-month: ${window.days}`);
+      }
+      return nthDayOfNextMonthUtc(transactionDate, window.days);
+    default: {
+      const exhaustiveCheck = window;
+      throw new Error(`Unknown creditDaysWindow type: ${JSON.stringify(exhaustiveCheck)}`);
+    }
+  }
+}
+function calculateForwardOrderingContractDueDate(transactionDate, window) {
+  if (!window) {
+    throw new Error(
+      "forwardOrderingContractWindow is required when paymentTerm is 'forwardOrderingContract'"
+    );
+  }
+  switch (window.frequencyType) {
+    case "FIXED_DATE":
+      return toUtcMidnight(window.dueDate);
+    case "FIXED_DAY": {
+      if (!Number.isInteger(window.dayOfMonth) || window.dayOfMonth < 1 || window.dayOfMonth > 31) {
+        throw new Error(`Invalid dayOfMonth: ${window.dayOfMonth}`);
+      }
+      const trigger = window.triggerDate ? toUtcMidnight(window.triggerDate) : transactionDate;
+      const candidateThisMonth = new Date(
+        Date.UTC(trigger.getUTCFullYear(), trigger.getUTCMonth(), window.dayOfMonth)
+      );
+      if (trigger.getUTCDate() <= window.dayOfMonth) {
+        return candidateThisMonth;
+      }
+      return new Date(
+        Date.UTC(trigger.getUTCFullYear(), trigger.getUTCMonth() + 1, window.dayOfMonth)
+      );
+    }
+    case "END_OF_MONTH": {
+      const trigger = window.triggerDate ? toUtcMidnight(window.triggerDate) : transactionDate;
+      const eom = lastDayOfMonthUtc(trigger);
+      return window.offsetDays ? addDaysUtc(eom, window.offsetDays) : eom;
+    }
+    case "DELIVERY_BASED": {
+      if (!window.triggerDate) {
+        throw new Error("triggerDate is required for DELIVERY_BASED forward ordering contracts");
+      }
+      const trigger = toUtcMidnight(window.triggerDate);
+      return addDaysUtc(trigger, window.offsetDays);
+    }
+    default: {
+      const exhaustiveCheck = window;
+      throw new Error(`Unknown frequencyType: ${JSON.stringify(exhaustiveCheck)}`);
+    }
+  }
+}
+function calculateInstallmentSchedule(transactionDate, window) {
+  if (!window) {
+    throw new Error(
+      "installmentWindow is required when paymentTerm is 'thirdPartyInputFinance'"
+    );
+  }
+  if (!Number.isInteger(window.numberOfInstallments) || window.numberOfInstallments < 1) {
+    throw new Error(`Invalid numberOfInstallments: ${window.numberOfInstallments}`);
+  }
+  if (!Number.isInteger(window.periodInterval) || window.periodInterval < 1) {
+    throw new Error(`Invalid periodInterval: ${window.periodInterval}`);
+  }
+  const start = window.startDate ? toUtcMidnight(window.startDate) : transactionDate;
+  const dueDates = [];
+  for (let installmentNumber = 1; installmentNumber <= window.numberOfInstallments; installmentNumber++) {
+    if (window.periodType === "DAYS") {
+      dueDates.push(addDaysUtc(start, window.periodInterval * installmentNumber));
+    } else {
+      if (window.dayOfMonth == null) {
+        throw new Error("dayOfMonth is required when periodType is 'MONTHS'");
+      }
+      const monthOffset = window.periodInterval * installmentNumber;
+      dueDates.push(
+        new Date(Date.UTC(start.getUTCFullYear(), start.getUTCMonth() + monthOffset, window.dayOfMonth))
+      );
+    }
+  }
+  return dueDates;
+}
+function calculatePaymentDueDate(input) {
+  const { transactionDate, paymentTerm } = input;
+  const normalizedTransactionDate = toUtcMidnight(transactionDate);
+  switch (paymentTerm) {
+    case "cashOnDelivery":
+      if (!input.deliveryDate) {
+        return null;
+      }
+      return toUtcMidnight(input.deliveryDate);
+    case "prePaymentProgram":
+      return normalizedTransactionDate;
+    case "supplierTradeCredit":
+      return calculateSupplierTradeCreditDueDate(
+        normalizedTransactionDate,
+        input.creditDaysWindow
+      );
+    case "forwardOrderingContract":
+      return calculateForwardOrderingContractDueDate(
+        normalizedTransactionDate,
+        input.forwardOrderingContractWindow
+      );
+    case "thirdPartyInputFinance":
+      return calculateInstallmentSchedule(
+        normalizedTransactionDate,
+        input.installmentWindow
+      );
+    default: {
+      const exhaustiveCheck = paymentTerm;
+      throw new Error(`Unknown paymentTerm: ${JSON.stringify(exhaustiveCheck)}`);
+    }
+  }
+}
+function isDueDatePending(result) {
+  return result === null;
+}
+function isSingleDueDate(result) {
+  return result instanceof Date;
+}
+function isInstallmentSchedule(result) {
+  return Array.isArray(result);
+}
+
 // src/validators.ts
 var Validator = {
   /** * 1. Email: The classic. Uses a standard RFC 5322 regex.
@@ -976,6 +1146,12 @@ var RESOURCE_PATHS = {
   farmManagement: "operations.farmManagement",
   packhouse: "operations.packhouse",
   accommodation: "operations.accommodation",
+  logistics: "operations.logistics",
+  logisticsReceival: "operations.logistics.receival",
+  logisticsReceivalReview: "operations.logistics.receival.review",
+  // being reviewed by manager/owner
+  logisticsDispatch: "operations.logistics.dispatch",
+  logisticsDispatchReview: "operations.logistics.dispatch.review",
   // ── Inventory ────────────────────────────────────────────────────────────
   // === Consumables ===
   inventory: "inventory",
@@ -1011,6 +1187,7 @@ var RESOURCE_PATHS = {
   equipFuelRegister: "equipment.fuelRegister",
   equipCalibration: "equipment.calibration",
   equipFleet: "equipment.fleetManagement",
+  // ── Finance ──────────────────────────────────────────────────────
   finance: "finance",
   financeProductRequisition: "finance.product.requistion",
   financeDashboard: "finance.dashboard",
@@ -1074,12 +1251,23 @@ var RESOURCE_MODULE_MAP = {
   [RESOURCE_PATHS.farmManagement]: [EnabledModule.FARM_MANAGEMENT],
   [RESOURCE_PATHS.packhouse]: [EnabledModule.PACKHOUSE],
   [RESOURCE_PATHS.accommodation]: [EnabledModule.ACCOMMODATION],
+  // ── Logistics ──────────────────────────────────────────────────────────────
+  [RESOURCE_PATHS.logistics]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.logisticsReceival]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.logisticsReceivalReview]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.logisticsDispatch]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.logisticsDispatchReview]: ALL_OPERATIONS,
   // ── 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,
+  // ── Finance ──────────────────────────────────────────────────────────────
+  [RESOURCE_PATHS.financeProductRequisition]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.financeDashboard]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.financeTransaction]: ALL_OPERATIONS,
+  [RESOURCE_PATHS.financeBudgetAllocation]: ALL_OPERATIONS,
   // ── Safety, Quality & Compliance ──────────────────────────────────────────
   [RESOURCE_PATHS.safetyAuditing]: ALL_OPERATIONS,
   [RESOURCE_PATHS.safetyFood]: AGRI_ONLY,
@@ -1128,6 +1316,15 @@ var RESOURCE_REQUIREMENTS = {
     allowedRoles: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR],
     requiredPrivileges: [UserPrivilege.ADMIN, UserPrivilege.AUDIT_COMPLIANCE, UserPrivilege.FINANCE, UserPrivilege.DOCUMENT]
   },
+  // ── Logistics ──────────────────────────────────────────────────────────────
+  [RESOURCE_PATHS.logisticsReceival]: {
+    allowedRoles: EVERYONE
+  },
+  [RESOURCE_PATHS.logisticsReceivalReview]: {
+    allowedRoles: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR]
+  },
+  [RESOURCE_PATHS.logisticsDispatch]: { allowedRoles: EVERYONE },
+  [RESOURCE_PATHS.logisticsDispatchReview]: { allowedRoles: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR] },
   // CONSUMABLES PERMISSIONS
   [RESOURCE_PATHS.inventoryConsumableProduct]: {
     allowedRoles: [UserRole.OWNER, UserRole.MANAGER, UserRole.SUPERVISOR]
@@ -1242,6 +1439,7 @@ var DocumentType = /* @__PURE__ */ ((DocumentType2) => {
   DocumentType2["PACKHOUSE_INSPECTION"] = "PACKHOUSE_INSPECTION";
   DocumentType2["TRAINING_CERTIFICATE"] = "TRAINING_CERTIFICATE";
   DocumentType2["INVOICE"] = "INVOICE";
+  DocumentType2["PURCHASE"] = "PURCHASE";
   DocumentType2["LEGAL_CONTRACT"] = "LEGAL_CONTRACT";
   DocumentType2["AUDIT_REPORT"] = "AUDIT_REPORT";
   DocumentType2["SENSITIVE_IDENTITY"] = "SENSITIVE_IDENTITY";
@@ -1255,6 +1453,7 @@ var DocumentCategory = /* @__PURE__ */ ((DocumentCategory2) => {
   DocumentCategory2["ASSETS_MAINT"] = "Assets & Maintenance";
   DocumentCategory2["HR_LEGAL_SAFETY"] = "HR, Legal & Safety";
   DocumentCategory2["FINANCE_ADMIN"] = "Finance & Admin";
+  DocumentCategory2["LOGISTICS"] = "Logistics";
   return DocumentCategory2;
 })(DocumentCategory || {});
 var DOCUMENT_DISPLAY_INFO = {
@@ -1429,6 +1628,12 @@ var DOCUMENT_DISPLAY_INFO = {
     label: "Supplier Invoices",
     description: "Billing records for inputs, utilities, and services.",
     category: "Finance & Admin" /* FINANCE_ADMIN */
+  },
+  // --- LOGISTICS ---
+  ["PURCHASE" /* PURCHASE */]: {
+    label: "Purchase Orders",
+    description: "Purchase orders for goods and services.",
+    category: "Logistics" /* LOGISTICS */
   }
 };
 var CATEGORY_TABS = [
@@ -1466,6 +1671,7 @@ var DOCUMENT_MENU_MAP = {
   ["HARVEST_LOG" /* HARVEST_LOG */]: [RESOURCE_PATHS.farmManagement],
   ["PACKHOUSE_INSPECTION" /* PACKHOUSE_INSPECTION */]: [RESOURCE_PATHS.packhouse],
   ["INVOICE" /* INVOICE */]: [RESOURCE_PATHS.documentHub],
+  ["PURCHASE" /* PURCHASE */]: [RESOURCE_PATHS.logistics],
   ["LEGAL_CONTRACT" /* LEGAL_CONTRACT */]: [RESOURCE_PATHS.documentHub],
   ["AUDIT_REPORT" /* AUDIT_REPORT */]: [RESOURCE_PATHS.safetyAuditing, RESOURCE_PATHS.dashboard],
   ["SENSITIVE_IDENTITY" /* SENSITIVE_IDENTITY */]: [RESOURCE_PATHS.adminUserRoster]
@@ -1482,10 +1688,10 @@ var CORRECTIVE_ACTION_STATUSES = {
   CLOSED: "closed",
   FAILED: "failed"
 };
-var TEMPLATE_SCOPE_LEVELS = {
-  FACILITY: "facility",
-  LEGAL_ENTITY: "legalEntity",
-  COMPANY: "company"
+var SCOPE_LEVELS = {
+  COMPANY: "company",
+  LEGAL_ENTITY: "legal_entity",
+  FACILITY: "facility"
 };
 var CORRECTIVE_ACTION_GENERATION_SOURCES = {
   CREATE: "CREATE",
@@ -1551,6 +1757,42 @@ var StockPolicyTier = {
   BY_STORAGE_PHASE: 2,
   BY_LOCATION: 3
 };
+var PRODUCT_TYPE_TO_BUDGET_CATEGORY = Object.freeze({
+  carton: "packaging",
+  tray: "packaging",
+  liner: "packaging",
+  label: "packaging",
+  tape: "packaging",
+  strapping: "packaging",
+  pallet: "packaging",
+  stretch_wrap: "packaging",
+  other: "general"
+  // fallback — reviewer must confirm at Step 3
+});
+var TERM_RESOLUTION_MODES = Object.freeze({
+  SUPPLIER_LEVEL: "SUPPLIER_LEVEL",
+  PRODUCT_LEVEL: "PRODUCT_LEVEL"
+});
+var REQUISITION_STATUSES = Object.freeze({
+  DRAFT: "draft",
+  PENDING_FINANCE: "pending_finance",
+  APPROVED: "approved",
+  REJECTED: "rejected",
+  ORDERED: "ordered"
+});
+var PO_STATUSES = Object.freeze({
+  NEW: "new",
+  ACKNOWLEDGED: "acknowledged",
+  IN_PROGRESS: "in_progress",
+  SHIPPED: "shipped",
+  RECEIVED: "received",
+  CANCELLED: "cancelled"
+});
+var PREFLIGHT_CHECK_STATUSES = Object.freeze({
+  OK: "ok",
+  WARNING: "warning",
+  BLOCKED: "blocked"
+});
 
 // src/index.ts
 var AppError = class extends Error {
@@ -1922,15 +2164,15 @@ var getAcceptedMimeTypes = (taskType) => {
 var getApproveAction = (taskType) => {
   return TASK_TYPE_REGISTRY[taskType]?.approveAction ?? null;
 };
+function sanitizeSiteName(name) {
+  return name.replace(/[^a-z0-9]/gi, "_");
+}
 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}`;
-  }
+  const sanitized = sanitizeSiteName(params.siteName);
+  return params.isStatic ? `${sanitized}/_CORE/${params.docType}` : `${sanitized}/_SEASONAL/${params.year || (/* @__PURE__ */ new Date()).getUTCFullYear()}/${params.docType}${params.crop ? `/${params.crop.toUpperCase()}` : ""}`;
+}
+function generateSystemFolderPath(siteName, systemFolderKey) {
+  return `${sanitizeSiteName(siteName)}/.system/${systemFolderKey}`;
 }
 function isValueMatch(fileValue, expectedValue) {
   if (Array.isArray(expectedValue)) return expectedValue.includes(fileValue);
@@ -2002,17 +2244,22 @@ function calculateFileMetadataMatch(criteria, fileMetadata, auditContext) {
   NettingType,
   NotificationMode,
   OrderStatus,
+  PO_STATUSES,
+  PREFLIGHT_CHECK_STATUSES,
+  PRODUCT_TYPE_TO_BUDGET_CATEGORY,
   PhysicalState,
   PlantingMethod,
   PriceAmbiguityError,
   ProductType,
   ProductUnit,
+  REQUISITION_STATUSES,
   RESOURCE_MODULE_MAP,
   RESOURCE_PATHS,
   RESOURCE_REQUIREMENTS,
   ROLE_SECTIONS_BY_KEY,
   RelationshipType,
   RowOrientation,
+  SCOPE_LEVELS,
   SENTINEL_UUID,
   SESSION_SCHEMA,
   SIGNATURE_MODES,
@@ -2020,7 +2267,7 @@ function calculateFileMetadataMatch(criteria, fileMetadata, auditContext) {
   StockPolicyTier,
   StoragePhases,
   TASK_TYPE_REGISTRY,
-  TEMPLATE_SCOPE_LEVELS,
+  TERM_RESOLUTION_MODES,
   TargetEntityType,
   TaskStatus,
   TaskType,
@@ -2033,6 +2280,7 @@ function calculateFileMetadataMatch(criteria, fileMetadata, auditContext) {
   WaterSource,
   assertTenantBoundary,
   calculateFileMetadataMatch,
+  calculatePaymentDueDate,
   createBase44PricingAdapter,
   decodeSession,
   encodeSession,
@@ -2043,6 +2291,7 @@ function calculateFileMetadataMatch(criteria, fileMetadata, auditContext) {
   generateCanonicalId,
   generateDocumentPath,
   generateInfrastructureFields,
+  generateSystemFolderPath,
   getAcceptedMimeTypes,
   getApproveAction,
   getFormMeta,
@@ -2054,6 +2303,9 @@ function calculateFileMetadataMatch(criteria, fileMetadata, auditContext) {
   handleAppErrorResponse,
   hasPrivilegeAt,
   hasRoleAt,
+  isDueDatePending,
+  isInstallmentSchedule,
+  isSingleDueDate,
   isTabVisible,
   isTabWritable,
   resolveAccess,
@@ -2061,6 +2313,7 @@ function calculateFileMetadataMatch(criteria, fileMetadata, auditContext) {
   resolveEffectiveAccess,
   resolveError,
   resolvePrice,
+  sanitizeSiteName,
   transformRoleAssignments,
   verifyAndExtractSession,
   withAgriLogging