@litusarchieve18/agricore-utils 1.0.30 → 1.0.32

package/dist/index.mjs

@@ -35,16 +35,21 @@ import {
   NettingType,
   NotificationMode,
   OrderStatus,
+  PO_STATUSES,
+  PREFLIGHT_CHECK_STATUSES,
+  PRODUCT_TYPE_TO_BUDGET_CATEGORY,
   PhysicalState,
   PlantingMethod,
   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,
@@ -52,7 +57,7 @@ import {
   StockPolicyTier,
   StoragePhases,
   TASK_TYPE_REGISTRY,
-  TEMPLATE_SCOPE_LEVELS,
+  TERM_RESOLUTION_MODES,
   TargetEntityType,
   TaskStatus,
   TaskType,
@@ -62,7 +67,7 @@ import {
   UserRole,
   VigorRating,
   WaterSource
-} from "./chunk-Y5KVDVNY.mjs";
+} from "./chunk-U332M2N6.mjs";
 
 // src/index.ts
 import { jwtVerify } from "jose";
@@ -410,6 +415,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.
@@ -903,15 +1067,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);
@@ -982,17 +1146,22 @@ export {
   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,
@@ -1000,7 +1169,7 @@ export {
   StockPolicyTier,
   StoragePhases,
   TASK_TYPE_REGISTRY,
-  TEMPLATE_SCOPE_LEVELS,
+  TERM_RESOLUTION_MODES,
   TargetEntityType,
   TaskStatus,
   TaskType,
@@ -1013,6 +1182,7 @@ export {
   WaterSource,
   assertTenantBoundary,
   calculateFileMetadataMatch,
+  calculatePaymentDueDate,
   createBase44PricingAdapter,
   decodeSession,
   encodeSession,
@@ -1023,6 +1193,7 @@ export {
   generateCanonicalId,
   generateDocumentPath,
   generateInfrastructureFields,
+  generateSystemFolderPath,
   getAcceptedMimeTypes,
   getApproveAction,
   getFormMeta,
@@ -1034,6 +1205,9 @@ export {
   handleAppErrorResponse,
   hasPrivilegeAt,
   hasRoleAt,
+  isDueDatePending,
+  isInstallmentSchedule,
+  isSingleDueDate,
   isTabVisible,
   isTabWritable,
   resolveAccess,
@@ -1041,6 +1215,7 @@ export {
   resolveEffectiveAccess,
   resolveError,
   resolvePrice,
+  sanitizeSiteName,
   transformRoleAssignments,
   verifyAndExtractSession,
   withAgriLogging

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litusarchieve18/agricore-utils",
-  "version": "1.0.30",
+  "version": "1.0.32",
   "description": "Canonical Backend Utility Library for AgriCore",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",