@litusarchieve18/agricore-utils 1.0.29 → 1.0.31

package/README.md

@@ -183,6 +183,10 @@ Run the publish command:
 Bash
 npm publish --access public
 📝 Version History
+V1.0.31 — Added Receival menu path, moving some procurement enum to library, and added a functional calculatePaymentDueDate function 
+
+V1.0.30 — altered authscoped Id to receive a list of string not a single string
+
 V1.0.29 — altered filtering logic from validFrom_lte: targetIso to validFrom: { $lte: targetIso }
 
 V1.0.28 — altered the logic and added scope aware filtering and write-time validation in priceHelpers.ts

package/dist/{chunk-Y5KVDVNY.mjs → chunk-OSHR422C.mjs}

@@ -381,6 +381,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",
@@ -416,6 +422,7 @@ var RESOURCE_PATHS = {
   equipFuelRegister: "equipment.fuelRegister",
   equipCalibration: "equipment.calibration",
   equipFleet: "equipment.fleetManagement",
+  // ── Finance ──────────────────────────────────────────────────────
   finance: "finance",
   financeProductRequisition: "finance.product.requistion",
   financeDashboard: "finance.dashboard",
@@ -479,12 +486,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,
@@ -533,6 +551,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]
@@ -647,6 +674,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";
@@ -660,6 +688,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 = {
@@ -834,6 +863,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 = [
@@ -871,6 +906,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]
@@ -887,10 +923,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",
@@ -956,6 +992,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"
+});
 
 export {
   MOD,
@@ -1010,7 +1082,7 @@ export {
   DOCUMENT_MENU_MAP,
   SIGNATURE_MODES,
   CORRECTIVE_ACTION_STATUSES,
-  TEMPLATE_SCOPE_LEVELS,
+  SCOPE_LEVELS,
   CORRECTIVE_ACTION_GENERATION_SOURCES,
   CAR_SUPPORTED_EVIDENCE_MIME_TYPES,
   CAR_SUPPORTED_SIGNATURE_MIME_TYPES,

package/dist/{constants-CrAPx_xU.d.mts → constants-KqcPqiCa.d.mts}

@@ -138,7 +138,7 @@ type CanonicalId = string;
 type SignatureMode = typeof SIGNATURE_MODES[keyof typeof SIGNATURE_MODES];
 type CorrectiveActionStatus = typeof CORRECTIVE_ACTION_STATUSES[keyof typeof CORRECTIVE_ACTION_STATUSES];
 type FileUploadTaskType = typeof TaskType[keyof typeof TaskType];
-type TemplateScopeLevel = typeof TEMPLATE_SCOPE_LEVELS[keyof typeof TEMPLATE_SCOPE_LEVELS];
+type TemplateScopeLevel = typeof SCOPE_LEVELS[keyof typeof SCOPE_LEVELS];
 type CorrectiveActionGenerationSource = typeof CORRECTIVE_ACTION_GENERATION_SOURCES[keyof typeof CORRECTIVE_ACTION_GENERATION_SOURCES];
 type CarSupportedEvidenceMimeType = typeof CAR_SUPPORTED_EVIDENCE_MIME_TYPES[number];
 type CarSupportedSignatureMimeType = typeof CAR_SUPPORTED_SIGNATURE_MIME_TYPES[number];
@@ -266,6 +266,86 @@ interface ShadowedCleanMatch {
         contractReferenceNumber?: string;
     };
 }
+type PaymentTerm = "cashOnDelivery" | "supplierTradeCredit" | "prePaymentProgram" | "forwardOrderingContract" | "thirdPartyInputFinance";
+/**
+ * NET n        -> transactionDate + n days
+ * EOM          -> last day of the month AFTER the transaction month
+ * EOM n        -> the n-th day of the month AFTER the transaction month
+ *
+ * Examples (transactionDate = 13 Jul):
+ *  { type: "NET", days: 7 }   -> 20 Jul
+ *  { type: "EOM" }            -> 31 Aug
+ *  { type: "EOM", days: 14 }  -> 14 Aug
+ */
+type CreditDaysWindow = {
+    type: "NET";
+    days: number;
+} | {
+    type: "EOM";
+    days?: number;
+};
+/**
+ * FIXED_DATE     -> contract specifies one exact calendar due date.
+ * FIXED_DAY      -> recurring monthly on a fixed day-of-month, relative to
+ *                    `triggerDate` (defaults to transactionDate if omitted).
+ *                    ASSUMPTION: if triggerDate's day-of-month <= dayOfMonth,
+ *                    the due date falls in the SAME month (same-day counts
+ *                    as due). Otherwise it rolls to next month. Flip this in
+ *                    calculateForwardOrderingContractDueDate() if the
+ *                    business rule is actually "always roll forward".
+ * END_OF_MONTH   -> due date = last day of triggerDate's month, optionally
+ *                    shifted by offsetDays (e.g. "EOM + 5 days").
+ * DELIVERY_BASED -> due date = triggerDate (e.g. actual delivery date) +
+ *                    offsetDays.
+ */
+type ForwardOrderingContractWindow = {
+    frequencyType: "FIXED_DATE";
+    dueDate: Date;
+} | {
+    frequencyType: "FIXED_DAY";
+    dayOfMonth: number;
+    triggerDate?: Date;
+} | {
+    frequencyType: "END_OF_MONTH";
+    triggerDate?: Date;
+    offsetDays?: number;
+} | {
+    frequencyType: "DELIVERY_BASED";
+    triggerDate: Date;
+    offsetDays: number;
+};
+/**
+ * Generates `numberOfInstallments` due dates, spaced every `periodInterval`
+ * periods (days or months) starting from `startDate` (defaults to
+ * transactionDate).
+ *
+ * ASSUMPTION: installment #1 falls ONE period after the start date (not on
+ * the start date itself). e.g. periodType "MONTHS", periodInterval 1,
+ * dayOfMonth 15, numberOfInstallments 3, starting 13 Jul ->
+ *   [15 Aug, 15 Sep, 15 Oct]
+ *
+ * `dayOfMonth` is required when periodType is "MONTHS" (pins each
+ * installment to a specific day, e.g. "every 1 month on the 15th").
+ */
+type InstallmentWindow = {
+    numberOfInstallments: number;
+    periodType: "DAYS" | "MONTHS";
+    periodInterval: number;
+    dayOfMonth?: number;
+    startDate?: Date;
+};
+interface CalculatePaymentDueDateInput {
+    transactionDate: Date;
+    paymentTerm: PaymentTerm;
+    /** Required when paymentTerm === "supplierTradeCredit" */
+    creditDaysWindow?: CreditDaysWindow;
+    /** Required when paymentTerm === "cashOnDelivery" (due date = delivery date) */
+    deliveryDate?: Date;
+    /** Required when paymentTerm === "forwardOrderingContract" */
+    forwardOrderingContractWindow?: ForwardOrderingContractWindow;
+    /** Required when paymentTerm === "thirdPartyInputFinance" */
+    installmentWindow?: InstallmentWindow;
+}
 
 declare const MOD: {
     readonly OPERATIONS: "OPR";
@@ -543,6 +623,11 @@ declare const RESOURCE_PATHS: {
     farmManagement: string;
     packhouse: string;
     accommodation: string;
+    logistics: string;
+    logisticsReceival: string;
+    logisticsReceivalReview: string;
+    logisticsDispatch: string;
+    logisticsDispatchReview: string;
     inventory: string;
     inventoryConsumable: string;
     inventoryConsumableProduct: string;
@@ -622,6 +707,7 @@ declare enum DocumentType {
     PACKHOUSE_INSPECTION = "PACKHOUSE_INSPECTION",
     TRAINING_CERTIFICATE = "TRAINING_CERTIFICATE",
     INVOICE = "INVOICE",
+    PURCHASE = "PURCHASE",
     LEGAL_CONTRACT = "LEGAL_CONTRACT",
     AUDIT_REPORT = "AUDIT_REPORT",
     SENSITIVE_IDENTITY = "SENSITIVE_IDENTITY"
@@ -633,7 +719,8 @@ declare enum DocumentCategory {
     INVENTORY_LOG = "Inventory & Logistics",
     ASSETS_MAINT = "Assets & Maintenance",
     HR_LEGAL_SAFETY = "HR, Legal & Safety",
-    FINANCE_ADMIN = "Finance & Admin"
+    FINANCE_ADMIN = "Finance & Admin",
+    LOGISTICS = "Logistics"
 }
 declare const DOCUMENT_DISPLAY_INFO: Record<DocumentType, {
     label: string;
@@ -670,10 +757,10 @@ declare const CORRECTIVE_ACTION_STATUSES: {
  * Scope level used when resolving templates from OperationalSettings.
  * Resolution precedence is facility -> legalEntity -> company.
  */
-declare const TEMPLATE_SCOPE_LEVELS: {
-    readonly FACILITY: "facility";
-    readonly LEGAL_ENTITY: "legalEntity";
+declare const SCOPE_LEVELS: {
     readonly COMPANY: "company";
+    readonly LEGAL_ENTITY: "legal_entity";
+    readonly FACILITY: "facility";
 };
 /**
  * Generation source for CAR creation.
@@ -746,4 +833,4 @@ declare const StockPolicyTier: {
     readonly BY_LOCATION: 3;
 };
 
-export { MimeType as $, ACCESS_RANK as A, BarcodeNamespace as B, CAR_SUPPORTED_EVIDENCE_MIME_TYPES as C, type CompanyConfig as D, type CorrectiveActionCompileTaskMetadata as E, type CorrectiveActionGenerationSource as F, type CorrectiveActionStatus as G, CropCycleStatus as H, DOCUMENT_DISPLAY_INFO as I, DOCUMENT_MENU_MAP as J, DocumentCategory as K, DocumentType as L, ERROR_DICTIONARY as M, EVERYONE as N, EmitterType as O, EnabledModule as P, FORM_REGISTRY as Q, FacilityType as R, type FileUploadTaskType as S, type FormMeta as T, HarvestMethod as U, type InfrastructureFields as V, LinkedStatus as W, MOD as X, MODULE_LABELS as Y, type MatrixRow as Z, MicroclimateZone as _, ACT as a, type ModCode as a0, NettingType as a1, type NormalizedSignatureValue as a2, NotificationMode as a3, OrderStatus as a4, type PermissionLevel as a5, PhysicalState as a6, PlantingMethod as a7, type PriceConflictCandidate as a8, type PriceResolutionResult as a9, type StockPolicyTierType as aA, StoragePhases as aB, type StorageType as aC, TASK_TYPE_REGISTRY as aD, TEMPLATE_SCOPE_LEVELS as aE, type TabConfig as aF, TargetEntityType as aG, TaskStatus as aH, TaskType as aI, type TaskTypeConfig as aJ, type TemplateScopeLevel as aK, type Tier as aL, TransactionType as aM, TrellisType as aN, UserPrivilege as aO, type UserPrivilegeType as aP, UserRole as aQ, type UserRoleAssignment as aR, type UserRoleType as aS, VigorRating as aT, WaterSource as aU, type WireSession as aV, type PricingContext as aa, type PricingDataSource as ab, ProductType as ac, type ProductTypeType as ad, ProductUnit as ae, type ProductUnitType as af, RESOURCE_MODULE_MAP as ag, RESOURCE_PATHS as ah, RESOURCE_REQUIREMENTS as ai, ROLE_SECTIONS_BY_KEY as aj, RelationshipType as ak, type ResolvedError as al, type ResourceOverrides as am, type ResourceRequirement as an, type RoleAssignment as ao, RowOrientation as ap, SENTINEL_UUID as aq, SESSION_SCHEMA as ar, SIGNATURE_MODES as as, type SchemaField as at, type ScopeType as au, type ShadowedCleanMatch as av, type SignatureInput as aw, type SignatureMode as ax, SoilTexture as ay, StockPolicyTier as az, AccessLevel as b, type AccessLevelType as c, type AgriCoreSession as d, ApprovalStatus as e, ApprovalType as f, AuditStatus as g, AuditType as h, type AuthScopeFields as i, type AvailableScope as j, type BarcodeNamespaceType as k, BarcodeType as l, type BarcodeTypeType as m, type Base44Id as n, type BaseProductRow as o, CAR_SUPPORTED_SIGNATURE_MIME_TYPES as p, CAT as q, CATEGORY_TABS as r, CORRECTIVE_ACTION_GENERATION_SOURCES as s, CORRECTIVE_ACTION_STATUSES as t, type CanonicalId as u, type CarSupportedEvidenceMimeType as v, type CarSupportedSignatureMimeType as w, type CarTemplateFileMetadata as x, CatalogSyncStatus as y, type CatalogSyncStatusType as z };
+export { MOD as $, ACCESS_RANK as A, BarcodeNamespace as B, CAR_SUPPORTED_EVIDENCE_MIME_TYPES as C, type CatalogSyncStatusType as D, type CompanyConfig as E, type CorrectiveActionCompileTaskMetadata as F, type CorrectiveActionGenerationSource as G, type CorrectiveActionStatus as H, type CreditDaysWindow as I, CropCycleStatus as J, DOCUMENT_DISPLAY_INFO as K, DOCUMENT_MENU_MAP as L, DocumentCategory as M, DocumentType as N, ERROR_DICTIONARY as O, EVERYONE as P, EmitterType as Q, EnabledModule as R, FORM_REGISTRY as S, FacilityType as T, type FileUploadTaskType as U, type FormMeta as V, type ForwardOrderingContractWindow as W, HarvestMethod as X, type InfrastructureFields as Y, type InstallmentWindow as Z, LinkedStatus as _, ACT as a, MODULE_LABELS as a0, type MatrixRow as a1, MicroclimateZone as a2, MimeType as a3, type ModCode as a4, NettingType as a5, type NormalizedSignatureValue as a6, NotificationMode as a7, OrderStatus as a8, type PaymentTerm as a9, type ScopeType as aA, type ShadowedCleanMatch as aB, type SignatureInput as aC, type SignatureMode as aD, SoilTexture as aE, StockPolicyTier as aF, type StockPolicyTierType as aG, StoragePhases as aH, type StorageType as aI, TASK_TYPE_REGISTRY as aJ, type TabConfig as aK, TargetEntityType as aL, TaskStatus as aM, TaskType as aN, type TaskTypeConfig as aO, type TemplateScopeLevel as aP, type Tier as aQ, TransactionType as aR, TrellisType as aS, UserPrivilege as aT, type UserPrivilegeType as aU, UserRole as aV, type UserRoleAssignment as aW, type UserRoleType as aX, VigorRating as aY, WaterSource as aZ, type WireSession as a_, type PermissionLevel as aa, PhysicalState as ab, PlantingMethod as ac, type PriceConflictCandidate as ad, type PriceResolutionResult as ae, type PricingContext as af, type PricingDataSource as ag, ProductType as ah, type ProductTypeType as ai, ProductUnit as aj, type ProductUnitType as ak, RESOURCE_MODULE_MAP as al, RESOURCE_PATHS as am, RESOURCE_REQUIREMENTS as an, ROLE_SECTIONS_BY_KEY as ao, RelationshipType as ap, type ResolvedError as aq, type ResourceOverrides as ar, type ResourceRequirement as as, type RoleAssignment as at, RowOrientation as au, SCOPE_LEVELS as av, SENTINEL_UUID as aw, SESSION_SCHEMA as ax, SIGNATURE_MODES as ay, type SchemaField as az, AccessLevel as b, type AccessLevelType as c, type AgriCoreSession as d, ApprovalStatus as e, ApprovalType as f, AuditStatus as g, AuditType as h, type AuthScopeFields as i, type AvailableScope as j, type BarcodeNamespaceType as k, BarcodeType as l, type BarcodeTypeType as m, type Base44Id as n, type BaseProductRow as o, CAR_SUPPORTED_SIGNATURE_MIME_TYPES as p, CAT as q, CATEGORY_TABS as r, CORRECTIVE_ACTION_GENERATION_SOURCES as s, CORRECTIVE_ACTION_STATUSES as t, type CalculatePaymentDueDateInput as u, type CanonicalId as v, type CarSupportedEvidenceMimeType as w, type CarSupportedSignatureMimeType as x, type CarTemplateFileMetadata as y, CatalogSyncStatus as z };

package/dist/{constants-CrAPx_xU.d.ts → constants-KqcPqiCa.d.ts}

@@ -138,7 +138,7 @@ type CanonicalId = string;
 type SignatureMode = typeof SIGNATURE_MODES[keyof typeof SIGNATURE_MODES];
 type CorrectiveActionStatus = typeof CORRECTIVE_ACTION_STATUSES[keyof typeof CORRECTIVE_ACTION_STATUSES];
 type FileUploadTaskType = typeof TaskType[keyof typeof TaskType];
-type TemplateScopeLevel = typeof TEMPLATE_SCOPE_LEVELS[keyof typeof TEMPLATE_SCOPE_LEVELS];
+type TemplateScopeLevel = typeof SCOPE_LEVELS[keyof typeof SCOPE_LEVELS];
 type CorrectiveActionGenerationSource = typeof CORRECTIVE_ACTION_GENERATION_SOURCES[keyof typeof CORRECTIVE_ACTION_GENERATION_SOURCES];
 type CarSupportedEvidenceMimeType = typeof CAR_SUPPORTED_EVIDENCE_MIME_TYPES[number];
 type CarSupportedSignatureMimeType = typeof CAR_SUPPORTED_SIGNATURE_MIME_TYPES[number];
@@ -266,6 +266,86 @@ interface ShadowedCleanMatch {
         contractReferenceNumber?: string;
     };
 }
+type PaymentTerm = "cashOnDelivery" | "supplierTradeCredit" | "prePaymentProgram" | "forwardOrderingContract" | "thirdPartyInputFinance";
+/**
+ * NET n        -> transactionDate + n days
+ * EOM          -> last day of the month AFTER the transaction month
+ * EOM n        -> the n-th day of the month AFTER the transaction month
+ *
+ * Examples (transactionDate = 13 Jul):
+ *  { type: "NET", days: 7 }   -> 20 Jul
+ *  { type: "EOM" }            -> 31 Aug
+ *  { type: "EOM", days: 14 }  -> 14 Aug
+ */
+type CreditDaysWindow = {
+    type: "NET";
+    days: number;
+} | {
+    type: "EOM";
+    days?: number;
+};
+/**
+ * FIXED_DATE     -> contract specifies one exact calendar due date.
+ * FIXED_DAY      -> recurring monthly on a fixed day-of-month, relative to
+ *                    `triggerDate` (defaults to transactionDate if omitted).
+ *                    ASSUMPTION: if triggerDate's day-of-month <= dayOfMonth,
+ *                    the due date falls in the SAME month (same-day counts
+ *                    as due). Otherwise it rolls to next month. Flip this in
+ *                    calculateForwardOrderingContractDueDate() if the
+ *                    business rule is actually "always roll forward".
+ * END_OF_MONTH   -> due date = last day of triggerDate's month, optionally
+ *                    shifted by offsetDays (e.g. "EOM + 5 days").
+ * DELIVERY_BASED -> due date = triggerDate (e.g. actual delivery date) +
+ *                    offsetDays.
+ */
+type ForwardOrderingContractWindow = {
+    frequencyType: "FIXED_DATE";
+    dueDate: Date;
+} | {
+    frequencyType: "FIXED_DAY";
+    dayOfMonth: number;
+    triggerDate?: Date;
+} | {
+    frequencyType: "END_OF_MONTH";
+    triggerDate?: Date;
+    offsetDays?: number;
+} | {
+    frequencyType: "DELIVERY_BASED";
+    triggerDate: Date;
+    offsetDays: number;
+};
+/**
+ * Generates `numberOfInstallments` due dates, spaced every `periodInterval`
+ * periods (days or months) starting from `startDate` (defaults to
+ * transactionDate).
+ *
+ * ASSUMPTION: installment #1 falls ONE period after the start date (not on
+ * the start date itself). e.g. periodType "MONTHS", periodInterval 1,
+ * dayOfMonth 15, numberOfInstallments 3, starting 13 Jul ->
+ *   [15 Aug, 15 Sep, 15 Oct]
+ *
+ * `dayOfMonth` is required when periodType is "MONTHS" (pins each
+ * installment to a specific day, e.g. "every 1 month on the 15th").
+ */
+type InstallmentWindow = {
+    numberOfInstallments: number;
+    periodType: "DAYS" | "MONTHS";
+    periodInterval: number;
+    dayOfMonth?: number;
+    startDate?: Date;
+};
+interface CalculatePaymentDueDateInput {
+    transactionDate: Date;
+    paymentTerm: PaymentTerm;
+    /** Required when paymentTerm === "supplierTradeCredit" */
+    creditDaysWindow?: CreditDaysWindow;
+    /** Required when paymentTerm === "cashOnDelivery" (due date = delivery date) */
+    deliveryDate?: Date;
+    /** Required when paymentTerm === "forwardOrderingContract" */
+    forwardOrderingContractWindow?: ForwardOrderingContractWindow;
+    /** Required when paymentTerm === "thirdPartyInputFinance" */
+    installmentWindow?: InstallmentWindow;
+}
 
 declare const MOD: {
     readonly OPERATIONS: "OPR";
@@ -543,6 +623,11 @@ declare const RESOURCE_PATHS: {
     farmManagement: string;
     packhouse: string;
     accommodation: string;
+    logistics: string;
+    logisticsReceival: string;
+    logisticsReceivalReview: string;
+    logisticsDispatch: string;
+    logisticsDispatchReview: string;
     inventory: string;
     inventoryConsumable: string;
     inventoryConsumableProduct: string;
@@ -622,6 +707,7 @@ declare enum DocumentType {
     PACKHOUSE_INSPECTION = "PACKHOUSE_INSPECTION",
     TRAINING_CERTIFICATE = "TRAINING_CERTIFICATE",
     INVOICE = "INVOICE",
+    PURCHASE = "PURCHASE",
     LEGAL_CONTRACT = "LEGAL_CONTRACT",
     AUDIT_REPORT = "AUDIT_REPORT",
     SENSITIVE_IDENTITY = "SENSITIVE_IDENTITY"
@@ -633,7 +719,8 @@ declare enum DocumentCategory {
     INVENTORY_LOG = "Inventory & Logistics",
     ASSETS_MAINT = "Assets & Maintenance",
     HR_LEGAL_SAFETY = "HR, Legal & Safety",
-    FINANCE_ADMIN = "Finance & Admin"
+    FINANCE_ADMIN = "Finance & Admin",
+    LOGISTICS = "Logistics"
 }
 declare const DOCUMENT_DISPLAY_INFO: Record<DocumentType, {
     label: string;
@@ -670,10 +757,10 @@ declare const CORRECTIVE_ACTION_STATUSES: {
  * Scope level used when resolving templates from OperationalSettings.
  * Resolution precedence is facility -> legalEntity -> company.
  */
-declare const TEMPLATE_SCOPE_LEVELS: {
-    readonly FACILITY: "facility";
-    readonly LEGAL_ENTITY: "legalEntity";
+declare const SCOPE_LEVELS: {
     readonly COMPANY: "company";
+    readonly LEGAL_ENTITY: "legal_entity";
+    readonly FACILITY: "facility";
 };
 /**
  * Generation source for CAR creation.
@@ -746,4 +833,4 @@ declare const StockPolicyTier: {
     readonly BY_LOCATION: 3;
 };
 
-export { MimeType as $, ACCESS_RANK as A, BarcodeNamespace as B, CAR_SUPPORTED_EVIDENCE_MIME_TYPES as C, type CompanyConfig as D, type CorrectiveActionCompileTaskMetadata as E, type CorrectiveActionGenerationSource as F, type CorrectiveActionStatus as G, CropCycleStatus as H, DOCUMENT_DISPLAY_INFO as I, DOCUMENT_MENU_MAP as J, DocumentCategory as K, DocumentType as L, ERROR_DICTIONARY as M, EVERYONE as N, EmitterType as O, EnabledModule as P, FORM_REGISTRY as Q, FacilityType as R, type FileUploadTaskType as S, type FormMeta as T, HarvestMethod as U, type InfrastructureFields as V, LinkedStatus as W, MOD as X, MODULE_LABELS as Y, type MatrixRow as Z, MicroclimateZone as _, ACT as a, type ModCode as a0, NettingType as a1, type NormalizedSignatureValue as a2, NotificationMode as a3, OrderStatus as a4, type PermissionLevel as a5, PhysicalState as a6, PlantingMethod as a7, type PriceConflictCandidate as a8, type PriceResolutionResult as a9, type StockPolicyTierType as aA, StoragePhases as aB, type StorageType as aC, TASK_TYPE_REGISTRY as aD, TEMPLATE_SCOPE_LEVELS as aE, type TabConfig as aF, TargetEntityType as aG, TaskStatus as aH, TaskType as aI, type TaskTypeConfig as aJ, type TemplateScopeLevel as aK, type Tier as aL, TransactionType as aM, TrellisType as aN, UserPrivilege as aO, type UserPrivilegeType as aP, UserRole as aQ, type UserRoleAssignment as aR, type UserRoleType as aS, VigorRating as aT, WaterSource as aU, type WireSession as aV, type PricingContext as aa, type PricingDataSource as ab, ProductType as ac, type ProductTypeType as ad, ProductUnit as ae, type ProductUnitType as af, RESOURCE_MODULE_MAP as ag, RESOURCE_PATHS as ah, RESOURCE_REQUIREMENTS as ai, ROLE_SECTIONS_BY_KEY as aj, RelationshipType as ak, type ResolvedError as al, type ResourceOverrides as am, type ResourceRequirement as an, type RoleAssignment as ao, RowOrientation as ap, SENTINEL_UUID as aq, SESSION_SCHEMA as ar, SIGNATURE_MODES as as, type SchemaField as at, type ScopeType as au, type ShadowedCleanMatch as av, type SignatureInput as aw, type SignatureMode as ax, SoilTexture as ay, StockPolicyTier as az, AccessLevel as b, type AccessLevelType as c, type AgriCoreSession as d, ApprovalStatus as e, ApprovalType as f, AuditStatus as g, AuditType as h, type AuthScopeFields as i, type AvailableScope as j, type BarcodeNamespaceType as k, BarcodeType as l, type BarcodeTypeType as m, type Base44Id as n, type BaseProductRow as o, CAR_SUPPORTED_SIGNATURE_MIME_TYPES as p, CAT as q, CATEGORY_TABS as r, CORRECTIVE_ACTION_GENERATION_SOURCES as s, CORRECTIVE_ACTION_STATUSES as t, type CanonicalId as u, type CarSupportedEvidenceMimeType as v, type CarSupportedSignatureMimeType as w, type CarTemplateFileMetadata as x, CatalogSyncStatus as y, type CatalogSyncStatusType as z };
+export { MOD as $, ACCESS_RANK as A, BarcodeNamespace as B, CAR_SUPPORTED_EVIDENCE_MIME_TYPES as C, type CatalogSyncStatusType as D, type CompanyConfig as E, type CorrectiveActionCompileTaskMetadata as F, type CorrectiveActionGenerationSource as G, type CorrectiveActionStatus as H, type CreditDaysWindow as I, CropCycleStatus as J, DOCUMENT_DISPLAY_INFO as K, DOCUMENT_MENU_MAP as L, DocumentCategory as M, DocumentType as N, ERROR_DICTIONARY as O, EVERYONE as P, EmitterType as Q, EnabledModule as R, FORM_REGISTRY as S, FacilityType as T, type FileUploadTaskType as U, type FormMeta as V, type ForwardOrderingContractWindow as W, HarvestMethod as X, type InfrastructureFields as Y, type InstallmentWindow as Z, LinkedStatus as _, ACT as a, MODULE_LABELS as a0, type MatrixRow as a1, MicroclimateZone as a2, MimeType as a3, type ModCode as a4, NettingType as a5, type NormalizedSignatureValue as a6, NotificationMode as a7, OrderStatus as a8, type PaymentTerm as a9, type ScopeType as aA, type ShadowedCleanMatch as aB, type SignatureInput as aC, type SignatureMode as aD, SoilTexture as aE, StockPolicyTier as aF, type StockPolicyTierType as aG, StoragePhases as aH, type StorageType as aI, TASK_TYPE_REGISTRY as aJ, type TabConfig as aK, TargetEntityType as aL, TaskStatus as aM, TaskType as aN, type TaskTypeConfig as aO, type TemplateScopeLevel as aP, type Tier as aQ, TransactionType as aR, TrellisType as aS, UserPrivilege as aT, type UserPrivilegeType as aU, UserRole as aV, type UserRoleAssignment as aW, type UserRoleType as aX, VigorRating as aY, WaterSource as aZ, type WireSession as a_, type PermissionLevel as aa, PhysicalState as ab, PlantingMethod as ac, type PriceConflictCandidate as ad, type PriceResolutionResult as ae, type PricingContext as af, type PricingDataSource as ag, ProductType as ah, type ProductTypeType as ai, ProductUnit as aj, type ProductUnitType as ak, RESOURCE_MODULE_MAP as al, RESOURCE_PATHS as am, RESOURCE_REQUIREMENTS as an, ROLE_SECTIONS_BY_KEY as ao, RelationshipType as ap, type ResolvedError as aq, type ResourceOverrides as ar, type ResourceRequirement as as, type RoleAssignment as at, RowOrientation as au, SCOPE_LEVELS as av, SENTINEL_UUID as aw, SESSION_SCHEMA as ax, SIGNATURE_MODES as ay, type SchemaField as az, AccessLevel as b, type AccessLevelType as c, type AgriCoreSession as d, ApprovalStatus as e, ApprovalType as f, AuditStatus as g, AuditType as h, type AuthScopeFields as i, type AvailableScope as j, type BarcodeNamespaceType as k, BarcodeType as l, type BarcodeTypeType as m, type Base44Id as n, type BaseProductRow as o, CAR_SUPPORTED_SIGNATURE_MIME_TYPES as p, CAT as q, CATEGORY_TABS as r, CORRECTIVE_ACTION_GENERATION_SOURCES as s, CORRECTIVE_ACTION_STATUSES as t, type CalculatePaymentDueDateInput as u, type CanonicalId as v, type CarSupportedEvidenceMimeType as w, type CarSupportedSignatureMimeType as x, type CarTemplateFileMetadata as y, CatalogSyncStatus as z };

package/dist/constants.d.mts

@@ -1 +1 @@
-export { A as ACCESS_RANK, a as ACT, b as AccessLevel, e as ApprovalStatus, f as ApprovalType, g as AuditStatus, h as AuditType, B as BarcodeNamespace, l as BarcodeType, C as CAR_SUPPORTED_EVIDENCE_MIME_TYPES, p as CAR_SUPPORTED_SIGNATURE_MIME_TYPES, q as CAT, r as CATEGORY_TABS, s as CORRECTIVE_ACTION_GENERATION_SOURCES, t as CORRECTIVE_ACTION_STATUSES, y as CatalogSyncStatus, H as CropCycleStatus, I as DOCUMENT_DISPLAY_INFO, J as DOCUMENT_MENU_MAP, K as DocumentCategory, L as DocumentType, M as ERROR_DICTIONARY, N as EVERYONE, O as EmitterType, P as EnabledModule, Q as FORM_REGISTRY, R as FacilityType, U as HarvestMethod, W as LinkedStatus, X as MOD, Y as MODULE_LABELS, _ as MicroclimateZone, $ as MimeType, a0 as ModCode, a1 as NettingType, a3 as NotificationMode, a4 as OrderStatus, a6 as PhysicalState, a7 as PlantingMethod, ac as ProductType, ae as ProductUnit, ag as RESOURCE_MODULE_MAP, ah as RESOURCE_PATHS, ai as RESOURCE_REQUIREMENTS, aj as ROLE_SECTIONS_BY_KEY, ak as RelationshipType, an as ResourceRequirement, ap as RowOrientation, aq as SENTINEL_UUID, ar as SESSION_SCHEMA, as as SIGNATURE_MODES, ay as SoilTexture, az as StockPolicyTier, aB as StoragePhases, aD as TASK_TYPE_REGISTRY, aE as TEMPLATE_SCOPE_LEVELS, aG as TargetEntityType, aH as TaskStatus, aI as TaskType, aM as TransactionType, aN as TrellisType, aO as UserPrivilege, aQ as UserRole, aT as VigorRating, aU as WaterSource } from './constants-CrAPx_xU.mjs';
+export { A as ACCESS_RANK, a as ACT, b as AccessLevel, e as ApprovalStatus, f as ApprovalType, g as AuditStatus, h as AuditType, B as BarcodeNamespace, l as BarcodeType, C as CAR_SUPPORTED_EVIDENCE_MIME_TYPES, p as CAR_SUPPORTED_SIGNATURE_MIME_TYPES, q as CAT, r as CATEGORY_TABS, s as CORRECTIVE_ACTION_GENERATION_SOURCES, t as CORRECTIVE_ACTION_STATUSES, z as CatalogSyncStatus, J as CropCycleStatus, K as DOCUMENT_DISPLAY_INFO, L as DOCUMENT_MENU_MAP, M as DocumentCategory, N as DocumentType, O as ERROR_DICTIONARY, P as EVERYONE, Q as EmitterType, R as EnabledModule, S as FORM_REGISTRY, T as FacilityType, X as HarvestMethod, _ as LinkedStatus, $ as MOD, a0 as MODULE_LABELS, a2 as MicroclimateZone, a3 as MimeType, a4 as ModCode, a5 as NettingType, a7 as NotificationMode, a8 as OrderStatus, ab as PhysicalState, ac as PlantingMethod, ah as ProductType, aj as ProductUnit, al as RESOURCE_MODULE_MAP, am as RESOURCE_PATHS, an as RESOURCE_REQUIREMENTS, ao as ROLE_SECTIONS_BY_KEY, ap as RelationshipType, as as ResourceRequirement, au as RowOrientation, av as SCOPE_LEVELS, aw as SENTINEL_UUID, ax as SESSION_SCHEMA, ay as SIGNATURE_MODES, aE as SoilTexture, aF as StockPolicyTier, aH as StoragePhases, aJ as TASK_TYPE_REGISTRY, aL as TargetEntityType, aM as TaskStatus, aN as TaskType, aR as TransactionType, aS as TrellisType, aT as UserPrivilege, aV as UserRole, aY as VigorRating, aZ as WaterSource } from './constants-KqcPqiCa.mjs';

package/dist/constants.d.ts

@@ -1 +1 @@
-export { A as ACCESS_RANK, a as ACT, b as AccessLevel, e as ApprovalStatus, f as ApprovalType, g as AuditStatus, h as AuditType, B as BarcodeNamespace, l as BarcodeType, C as CAR_SUPPORTED_EVIDENCE_MIME_TYPES, p as CAR_SUPPORTED_SIGNATURE_MIME_TYPES, q as CAT, r as CATEGORY_TABS, s as CORRECTIVE_ACTION_GENERATION_SOURCES, t as CORRECTIVE_ACTION_STATUSES, y as CatalogSyncStatus, H as CropCycleStatus, I as DOCUMENT_DISPLAY_INFO, J as DOCUMENT_MENU_MAP, K as DocumentCategory, L as DocumentType, M as ERROR_DICTIONARY, N as EVERYONE, O as EmitterType, P as EnabledModule, Q as FORM_REGISTRY, R as FacilityType, U as HarvestMethod, W as LinkedStatus, X as MOD, Y as MODULE_LABELS, _ as MicroclimateZone, $ as MimeType, a0 as ModCode, a1 as NettingType, a3 as NotificationMode, a4 as OrderStatus, a6 as PhysicalState, a7 as PlantingMethod, ac as ProductType, ae as ProductUnit, ag as RESOURCE_MODULE_MAP, ah as RESOURCE_PATHS, ai as RESOURCE_REQUIREMENTS, aj as ROLE_SECTIONS_BY_KEY, ak as RelationshipType, an as ResourceRequirement, ap as RowOrientation, aq as SENTINEL_UUID, ar as SESSION_SCHEMA, as as SIGNATURE_MODES, ay as SoilTexture, az as StockPolicyTier, aB as StoragePhases, aD as TASK_TYPE_REGISTRY, aE as TEMPLATE_SCOPE_LEVELS, aG as TargetEntityType, aH as TaskStatus, aI as TaskType, aM as TransactionType, aN as TrellisType, aO as UserPrivilege, aQ as UserRole, aT as VigorRating, aU as WaterSource } from './constants-CrAPx_xU.js';
+export { A as ACCESS_RANK, a as ACT, b as AccessLevel, e as ApprovalStatus, f as ApprovalType, g as AuditStatus, h as AuditType, B as BarcodeNamespace, l as BarcodeType, C as CAR_SUPPORTED_EVIDENCE_MIME_TYPES, p as CAR_SUPPORTED_SIGNATURE_MIME_TYPES, q as CAT, r as CATEGORY_TABS, s as CORRECTIVE_ACTION_GENERATION_SOURCES, t as CORRECTIVE_ACTION_STATUSES, z as CatalogSyncStatus, J as CropCycleStatus, K as DOCUMENT_DISPLAY_INFO, L as DOCUMENT_MENU_MAP, M as DocumentCategory, N as DocumentType, O as ERROR_DICTIONARY, P as EVERYONE, Q as EmitterType, R as EnabledModule, S as FORM_REGISTRY, T as FacilityType, X as HarvestMethod, _ as LinkedStatus, $ as MOD, a0 as MODULE_LABELS, a2 as MicroclimateZone, a3 as MimeType, a4 as ModCode, a5 as NettingType, a7 as NotificationMode, a8 as OrderStatus, ab as PhysicalState, ac as PlantingMethod, ah as ProductType, aj as ProductUnit, al as RESOURCE_MODULE_MAP, am as RESOURCE_PATHS, an as RESOURCE_REQUIREMENTS, ao as ROLE_SECTIONS_BY_KEY, ap as RelationshipType, as as ResourceRequirement, au as RowOrientation, av as SCOPE_LEVELS, aw as SENTINEL_UUID, ax as SESSION_SCHEMA, ay as SIGNATURE_MODES, aE as SoilTexture, aF as StockPolicyTier, aH as StoragePhases, aJ as TASK_TYPE_REGISTRY, aL as TargetEntityType, aM as TaskStatus, aN as TaskType, aR as TransactionType, aS as TrellisType, aT as UserPrivilege, aV as UserRole, aY as VigorRating, aZ as WaterSource } from './constants-KqcPqiCa.js';