@litusarchieve18/agricore-utils 1.0.30 → 1.0.32

package/dist/constants.js

@@ -56,16 +56,21 @@ __export(constants_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,
   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,
@@ -73,7 +78,7 @@ __export(constants_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,
@@ -467,6 +472,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",
@@ -502,6 +513,7 @@ var RESOURCE_PATHS = {
   equipFuelRegister: "equipment.fuelRegister",
   equipCalibration: "equipment.calibration",
   equipFleet: "equipment.fleetManagement",
+  // ── Finance ──────────────────────────────────────────────────────
   finance: "finance",
   financeProductRequisition: "finance.product.requistion",
   financeDashboard: "finance.dashboard",
@@ -565,12 +577,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,
@@ -619,6 +642,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]
@@ -733,6 +765,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";
@@ -746,6 +779,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 = {
@@ -920,6 +954,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 = [
@@ -957,6 +997,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]
@@ -973,10 +1014,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",
@@ -1042,6 +1083,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"
+});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ACCESS_RANK,
@@ -1080,16 +1157,21 @@ var StockPolicyTier = {
   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,
@@ -1097,7 +1179,7 @@ var StockPolicyTier = {
   StockPolicyTier,
   StoragePhases,
   TASK_TYPE_REGISTRY,
-  TEMPLATE_SCOPE_LEVELS,
+  TERM_RESOLUTION_MODES,
   TargetEntityType,
   TaskStatus,
   TaskType,

package/dist/constants.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";
 export {
   ACCESS_RANK,
   ACT,
@@ -100,16 +105,21 @@ export {
   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,
@@ -117,7 +127,7 @@ export {
   StockPolicyTier,
   StoragePhases,
   TASK_TYPE_REGISTRY,
-  TEMPLATE_SCOPE_LEVELS,
+  TERM_RESOLUTION_MODES,
   TargetEntityType,
   TaskStatus,
   TaskType,

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { d as AgriCoreSession, aR as UserRoleAssignment, aL as Tier, a8 as PriceConflictCandidate, av as ShadowedCleanMatch, ab as PricingDataSource, aa as PricingContext, a9 as PriceResolutionResult, au as ScopeType, aV as WireSession, an as ResourceRequirement, c as AccessLevelType, j as AvailableScope, V as InfrastructureFields, T as FormMeta, aF as TabConfig, al as ResolvedError } 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, i as AuthScopeFields, B as BarcodeNamespace, k as BarcodeNamespaceType, l as BarcodeType, m as BarcodeTypeType, n as Base44Id, o as BaseProductRow, 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, u as CanonicalId, v as CarSupportedEvidenceMimeType, w as CarSupportedSignatureMimeType, x as CarTemplateFileMetadata, y as CatalogSyncStatus, z as CatalogSyncStatusType, D as CompanyConfig, E as CorrectiveActionCompileTaskMetadata, F as CorrectiveActionGenerationSource, G as CorrectiveActionStatus, 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, S as FileUploadTaskType, U as HarvestMethod, W as LinkedStatus, X as MOD, Y as MODULE_LABELS, Z as MatrixRow, _ as MicroclimateZone, $ as MimeType, a0 as ModCode, a1 as NettingType, a2 as NormalizedSignatureValue, a3 as NotificationMode, a4 as OrderStatus, a5 as PermissionLevel, a6 as PhysicalState, a7 as PlantingMethod, ac as ProductType, ad as ProductTypeType, ae as ProductUnit, af as ProductUnitType, ag as RESOURCE_MODULE_MAP, ah as RESOURCE_PATHS, ai as RESOURCE_REQUIREMENTS, aj as ROLE_SECTIONS_BY_KEY, ak as RelationshipType, am as ResourceOverrides, ao as RoleAssignment, ap as RowOrientation, aq as SENTINEL_UUID, ar as SESSION_SCHEMA, as as SIGNATURE_MODES, at as SchemaField, aw as SignatureInput, ax as SignatureMode, ay as SoilTexture, az as StockPolicyTier, aA as StockPolicyTierType, aB as StoragePhases, aC as StorageType, aD as TASK_TYPE_REGISTRY, aE as TEMPLATE_SCOPE_LEVELS, aG as TargetEntityType, aH as TaskStatus, aI as TaskType, aJ as TaskTypeConfig, aK as TemplateScopeLevel, aM as TransactionType, aN as TrellisType, aO as UserPrivilege, aP as UserPrivilegeType, aQ as UserRole, aS as UserRoleType, aT as VigorRating, aU as WaterSource } from './constants-CrAPx_xU.mjs';
+import { d as AgriCoreSession, a$ as UserRoleAssignment, aV as Tier, ag as PriceConflictCandidate, aF as ShadowedCleanMatch, aj as PricingDataSource, ai as PricingContext, ah as PriceResolutionResult, u as CalculatePaymentDueDateInput, aE as ScopeType, b3 as WireSession, aw as ResourceRequirement, c as AccessLevelType, j as AvailableScope, Y as InfrastructureFields, V as FormMeta, aP as TabConfig, au as ResolvedError } from './constants-x8gYRJIw.mjs';
+export { A as ACCESS_RANK, a as ACT, b as AccessLevel, e as ApprovalStatus, f as ApprovalType, g as AuditStatus, h as AuditType, i as AuthScopeFields, B as BarcodeNamespace, k as BarcodeNamespaceType, l as BarcodeType, m as BarcodeTypeType, n as Base44Id, o as BaseProductRow, 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, v as CanonicalId, w as CarSupportedEvidenceMimeType, x as CarSupportedSignatureMimeType, y as CarTemplateFileMetadata, z as CatalogSyncStatus, D as CatalogSyncStatusType, E as CompanyConfig, F as CorrectiveActionCompileTaskMetadata, G as CorrectiveActionGenerationSource, H as CorrectiveActionStatus, I as CreditDaysWindow, 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, U as FileUploadTaskType, W as ForwardOrderingContractWindow, X as HarvestMethod, Z as InstallmentWindow, _ as LinkedStatus, $ as MOD, a0 as MODULE_LABELS, a1 as MatrixRow, a2 as MicroclimateZone, a3 as MimeType, a4 as ModCode, a5 as NettingType, a6 as NormalizedSignatureValue, a7 as NotificationMode, a8 as OrderStatus, a9 as PO_STATUSES, aa as PREFLIGHT_CHECK_STATUSES, ab as PRODUCT_TYPE_TO_BUDGET_CATEGORY, ac as PaymentTerm, ad as PermissionLevel, ae as PhysicalState, af as PlantingMethod, ak as ProductType, al as ProductTypeType, am as ProductUnit, an as ProductUnitType, ao as REQUISITION_STATUSES, ap as RESOURCE_MODULE_MAP, aq as RESOURCE_PATHS, ar as RESOURCE_REQUIREMENTS, as as ROLE_SECTIONS_BY_KEY, at as RelationshipType, av as ResourceOverrides, ax as RoleAssignment, ay as RowOrientation, az as SCOPE_LEVELS, aA as SENTINEL_UUID, aB as SESSION_SCHEMA, aC as SIGNATURE_MODES, aD as SchemaField, aG as SignatureInput, aH as SignatureMode, aI as SoilTexture, aJ as StockPolicyTier, aK as StockPolicyTierType, aL as StoragePhases, aM as StorageType, aN as TASK_TYPE_REGISTRY, aO as TERM_RESOLUTION_MODES, aQ as TargetEntityType, aR as TaskStatus, aS as TaskType, aT as TaskTypeConfig, aU as TemplateScopeLevel, aW as TransactionType, aX as TrellisType, aY as UserPrivilege, aZ as UserPrivilegeType, a_ as UserRole, b0 as UserRoleType, b1 as VigorRating, b2 as WaterSource } from './constants-x8gYRJIw.mjs';
 
 declare const AgriLogger: {
     log(level: "INFO" | "WARN" | "ERROR", message: string, meta: any): void;
@@ -54,6 +54,50 @@ declare function findOverlappingPriceWindows(db: any, scope: OverlapCheckScope,
     validTo: string | null;
 }, excludeId?: string): Promise<PriceConflictCandidate[]>;
 
+/**
+ * Payment Due Date Calculation Utility
+ * ------------------------------------
+ * Computes `paymentDueDate` (or, for installments, the full due-date
+ * schedule) from a `transactionDate`, a `paymentTerm`, and term-specific
+ * config.
+ *
+ * Dates are handled as UTC-normalized "calendar dates" (year/month/day only)
+ * to avoid timezone/DST bugs when adding days or jumping months. If you pass
+ * in a Date with a time component, it's normalized to midnight UTC first,
+ * and results are also midnight UTC.
+ */
+
+/**
+ * Returns a single `Date` for most payment terms, a `Date[]` for
+ * "thirdPartyInputFinance" (the full installment schedule), or `null` when
+ * the due date can't be determined yet from the info available so far
+ * (currently only "cashOnDelivery" before a deliveryDate is known).
+ *
+ * Designed to be called from one central place regardless of paymentTerm —
+ * e.g. at order creation, then again once delivery is confirmed. Callers
+ * should handle the `null` case as "not yet known, try again later" rather
+ * than treating it as an error.
+ *
+ * Narrow with Array.isArray() / === null at the call site as needed.
+ */
+declare function calculatePaymentDueDate(input: CalculatePaymentDueDateInput): Date | Date[] | null;
+/**
+ * True when the due date isn't determinable yet (currently only
+ * "cashOnDelivery" before deliveryDate is known). Call
+ * calculatePaymentDueDate() again later once the missing info is available.
+ */
+declare function isDueDatePending(result: Date | Date[] | null): result is null;
+/**
+ * True when the result is a single due date (all terms except
+ * "thirdPartyInputFinance", and excluding the pending/null case).
+ */
+declare function isSingleDueDate(result: Date | Date[] | null): result is Date;
+/**
+ * True when the result is a full installment schedule
+ * (paymentTerm === "thirdPartyInputFinance").
+ */
+declare function isInstallmentSchedule(result: Date | Date[] | null): result is Date[];
+
 declare const Validator: {
     /** * 1. Email: The classic. Uses a standard RFC 5322 regex.
      */
@@ -202,6 +246,7 @@ declare const getApproveAction: (taskType: string) => string | null;
  * Static:  {SiteName}/_CORE/{DocumentType}
  * Dynamic: {SiteName}/_SEASONAL/{Year}/{DocumentType}/{Crop}
  */
+declare function sanitizeSiteName(name: string): string;
 declare function generateDocumentPath(params: {
     siteName: string;
     docType: DocumentType;
@@ -209,10 +254,11 @@ declare function generateDocumentPath(params: {
     year?: number | string;
     crop?: string;
 }): string;
+declare function generateSystemFolderPath(siteName: string, systemFolderKey: string): string;
 declare function calculateFileMetadataMatch(criteria: {
     mustMatch: Record<string, any>;
     mustMatchContext?: string[];
     contextMatch?: string[];
 }, fileMetadata: Record<string, any>, auditContext: Record<string, any>): number;
 
-export { AccessLevelType, AggregatePriceAmbiguityError, AgriCoreSession, AgriLogger, AppError, AvailableScope, Converter, ErrorFactory, FormMeta, InfrastructureFields, type OverlapCheckScope, PriceAmbiguityError, PriceConflictCandidate, PriceResolutionResult, type PricingAdapterScope, PricingContext, PricingDataSource, ResolvedError, ResourceRequirement, ScopeType, ShadowedCleanMatch, TabConfig, Tier, UserRoleAssignment, Validator, WireSession, assertTenantBoundary, calculateFileMetadataMatch, createBase44PricingAdapter, decodeSession, encodeSession, evaluateBaseAccess, extractAppCode, findOverlappingPriceWindows, findSpecificOverride, generateCanonicalId, generateDocumentPath, generateInfrastructureFields, getAcceptedMimeTypes, getApproveAction, getFormMeta, getFormsGroupedByModule, getPrivilegesAt, getRoleAt, getScopeAncestry, getTaskTypeOptions, handleAppErrorResponse, hasPrivilegeAt, hasRoleAt, isTabVisible, isTabWritable, resolveAccess, resolveAppError, resolveEffectiveAccess, resolveError, resolvePrice, transformRoleAssignments, verifyAndExtractSession, withAgriLogging };
+export { AccessLevelType, AggregatePriceAmbiguityError, AgriCoreSession, AgriLogger, AppError, AvailableScope, CalculatePaymentDueDateInput, Converter, ErrorFactory, FormMeta, InfrastructureFields, type OverlapCheckScope, PriceAmbiguityError, PriceConflictCandidate, PriceResolutionResult, type PricingAdapterScope, PricingContext, PricingDataSource, ResolvedError, ResourceRequirement, ScopeType, ShadowedCleanMatch, TabConfig, Tier, UserRoleAssignment, Validator, WireSession, assertTenantBoundary, calculateFileMetadataMatch, calculatePaymentDueDate, createBase44PricingAdapter, decodeSession, encodeSession, evaluateBaseAccess, extractAppCode, findOverlappingPriceWindows, findSpecificOverride, generateCanonicalId, generateDocumentPath, generateInfrastructureFields, generateSystemFolderPath, getAcceptedMimeTypes, getApproveAction, getFormMeta, getFormsGroupedByModule, getPrivilegesAt, getRoleAt, getScopeAncestry, getTaskTypeOptions, handleAppErrorResponse, hasPrivilegeAt, hasRoleAt, isDueDatePending, isInstallmentSchedule, isSingleDueDate, isTabVisible, isTabWritable, resolveAccess, resolveAppError, resolveEffectiveAccess, resolveError, resolvePrice, sanitizeSiteName, transformRoleAssignments, verifyAndExtractSession, withAgriLogging };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { d as AgriCoreSession, aR as UserRoleAssignment, aL as Tier, a8 as PriceConflictCandidate, av as ShadowedCleanMatch, ab as PricingDataSource, aa as PricingContext, a9 as PriceResolutionResult, au as ScopeType, aV as WireSession, an as ResourceRequirement, c as AccessLevelType, j as AvailableScope, V as InfrastructureFields, T as FormMeta, aF as TabConfig, al as ResolvedError } 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, i as AuthScopeFields, B as BarcodeNamespace, k as BarcodeNamespaceType, l as BarcodeType, m as BarcodeTypeType, n as Base44Id, o as BaseProductRow, 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, u as CanonicalId, v as CarSupportedEvidenceMimeType, w as CarSupportedSignatureMimeType, x as CarTemplateFileMetadata, y as CatalogSyncStatus, z as CatalogSyncStatusType, D as CompanyConfig, E as CorrectiveActionCompileTaskMetadata, F as CorrectiveActionGenerationSource, G as CorrectiveActionStatus, 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, S as FileUploadTaskType, U as HarvestMethod, W as LinkedStatus, X as MOD, Y as MODULE_LABELS, Z as MatrixRow, _ as MicroclimateZone, $ as MimeType, a0 as ModCode, a1 as NettingType, a2 as NormalizedSignatureValue, a3 as NotificationMode, a4 as OrderStatus, a5 as PermissionLevel, a6 as PhysicalState, a7 as PlantingMethod, ac as ProductType, ad as ProductTypeType, ae as ProductUnit, af as ProductUnitType, ag as RESOURCE_MODULE_MAP, ah as RESOURCE_PATHS, ai as RESOURCE_REQUIREMENTS, aj as ROLE_SECTIONS_BY_KEY, ak as RelationshipType, am as ResourceOverrides, ao as RoleAssignment, ap as RowOrientation, aq as SENTINEL_UUID, ar as SESSION_SCHEMA, as as SIGNATURE_MODES, at as SchemaField, aw as SignatureInput, ax as SignatureMode, ay as SoilTexture, az as StockPolicyTier, aA as StockPolicyTierType, aB as StoragePhases, aC as StorageType, aD as TASK_TYPE_REGISTRY, aE as TEMPLATE_SCOPE_LEVELS, aG as TargetEntityType, aH as TaskStatus, aI as TaskType, aJ as TaskTypeConfig, aK as TemplateScopeLevel, aM as TransactionType, aN as TrellisType, aO as UserPrivilege, aP as UserPrivilegeType, aQ as UserRole, aS as UserRoleType, aT as VigorRating, aU as WaterSource } from './constants-CrAPx_xU.js';
+import { d as AgriCoreSession, a$ as UserRoleAssignment, aV as Tier, ag as PriceConflictCandidate, aF as ShadowedCleanMatch, aj as PricingDataSource, ai as PricingContext, ah as PriceResolutionResult, u as CalculatePaymentDueDateInput, aE as ScopeType, b3 as WireSession, aw as ResourceRequirement, c as AccessLevelType, j as AvailableScope, Y as InfrastructureFields, V as FormMeta, aP as TabConfig, au as ResolvedError } from './constants-x8gYRJIw.js';
+export { A as ACCESS_RANK, a as ACT, b as AccessLevel, e as ApprovalStatus, f as ApprovalType, g as AuditStatus, h as AuditType, i as AuthScopeFields, B as BarcodeNamespace, k as BarcodeNamespaceType, l as BarcodeType, m as BarcodeTypeType, n as Base44Id, o as BaseProductRow, 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, v as CanonicalId, w as CarSupportedEvidenceMimeType, x as CarSupportedSignatureMimeType, y as CarTemplateFileMetadata, z as CatalogSyncStatus, D as CatalogSyncStatusType, E as CompanyConfig, F as CorrectiveActionCompileTaskMetadata, G as CorrectiveActionGenerationSource, H as CorrectiveActionStatus, I as CreditDaysWindow, 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, U as FileUploadTaskType, W as ForwardOrderingContractWindow, X as HarvestMethod, Z as InstallmentWindow, _ as LinkedStatus, $ as MOD, a0 as MODULE_LABELS, a1 as MatrixRow, a2 as MicroclimateZone, a3 as MimeType, a4 as ModCode, a5 as NettingType, a6 as NormalizedSignatureValue, a7 as NotificationMode, a8 as OrderStatus, a9 as PO_STATUSES, aa as PREFLIGHT_CHECK_STATUSES, ab as PRODUCT_TYPE_TO_BUDGET_CATEGORY, ac as PaymentTerm, ad as PermissionLevel, ae as PhysicalState, af as PlantingMethod, ak as ProductType, al as ProductTypeType, am as ProductUnit, an as ProductUnitType, ao as REQUISITION_STATUSES, ap as RESOURCE_MODULE_MAP, aq as RESOURCE_PATHS, ar as RESOURCE_REQUIREMENTS, as as ROLE_SECTIONS_BY_KEY, at as RelationshipType, av as ResourceOverrides, ax as RoleAssignment, ay as RowOrientation, az as SCOPE_LEVELS, aA as SENTINEL_UUID, aB as SESSION_SCHEMA, aC as SIGNATURE_MODES, aD as SchemaField, aG as SignatureInput, aH as SignatureMode, aI as SoilTexture, aJ as StockPolicyTier, aK as StockPolicyTierType, aL as StoragePhases, aM as StorageType, aN as TASK_TYPE_REGISTRY, aO as TERM_RESOLUTION_MODES, aQ as TargetEntityType, aR as TaskStatus, aS as TaskType, aT as TaskTypeConfig, aU as TemplateScopeLevel, aW as TransactionType, aX as TrellisType, aY as UserPrivilege, aZ as UserPrivilegeType, a_ as UserRole, b0 as UserRoleType, b1 as VigorRating, b2 as WaterSource } from './constants-x8gYRJIw.js';
 
 declare const AgriLogger: {
     log(level: "INFO" | "WARN" | "ERROR", message: string, meta: any): void;
@@ -54,6 +54,50 @@ declare function findOverlappingPriceWindows(db: any, scope: OverlapCheckScope,
     validTo: string | null;
 }, excludeId?: string): Promise<PriceConflictCandidate[]>;
 
+/**
+ * Payment Due Date Calculation Utility
+ * ------------------------------------
+ * Computes `paymentDueDate` (or, for installments, the full due-date
+ * schedule) from a `transactionDate`, a `paymentTerm`, and term-specific
+ * config.
+ *
+ * Dates are handled as UTC-normalized "calendar dates" (year/month/day only)
+ * to avoid timezone/DST bugs when adding days or jumping months. If you pass
+ * in a Date with a time component, it's normalized to midnight UTC first,
+ * and results are also midnight UTC.
+ */
+
+/**
+ * Returns a single `Date` for most payment terms, a `Date[]` for
+ * "thirdPartyInputFinance" (the full installment schedule), or `null` when
+ * the due date can't be determined yet from the info available so far
+ * (currently only "cashOnDelivery" before a deliveryDate is known).
+ *
+ * Designed to be called from one central place regardless of paymentTerm —
+ * e.g. at order creation, then again once delivery is confirmed. Callers
+ * should handle the `null` case as "not yet known, try again later" rather
+ * than treating it as an error.
+ *
+ * Narrow with Array.isArray() / === null at the call site as needed.
+ */
+declare function calculatePaymentDueDate(input: CalculatePaymentDueDateInput): Date | Date[] | null;
+/**
+ * True when the due date isn't determinable yet (currently only
+ * "cashOnDelivery" before deliveryDate is known). Call
+ * calculatePaymentDueDate() again later once the missing info is available.
+ */
+declare function isDueDatePending(result: Date | Date[] | null): result is null;
+/**
+ * True when the result is a single due date (all terms except
+ * "thirdPartyInputFinance", and excluding the pending/null case).
+ */
+declare function isSingleDueDate(result: Date | Date[] | null): result is Date;
+/**
+ * True when the result is a full installment schedule
+ * (paymentTerm === "thirdPartyInputFinance").
+ */
+declare function isInstallmentSchedule(result: Date | Date[] | null): result is Date[];
+
 declare const Validator: {
     /** * 1. Email: The classic. Uses a standard RFC 5322 regex.
      */
@@ -202,6 +246,7 @@ declare const getApproveAction: (taskType: string) => string | null;
  * Static:  {SiteName}/_CORE/{DocumentType}
  * Dynamic: {SiteName}/_SEASONAL/{Year}/{DocumentType}/{Crop}
  */
+declare function sanitizeSiteName(name: string): string;
 declare function generateDocumentPath(params: {
     siteName: string;
     docType: DocumentType;
@@ -209,10 +254,11 @@ declare function generateDocumentPath(params: {
     year?: number | string;
     crop?: string;
 }): string;
+declare function generateSystemFolderPath(siteName: string, systemFolderKey: string): string;
 declare function calculateFileMetadataMatch(criteria: {
     mustMatch: Record<string, any>;
     mustMatchContext?: string[];
     contextMatch?: string[];
 }, fileMetadata: Record<string, any>, auditContext: Record<string, any>): number;
 
-export { AccessLevelType, AggregatePriceAmbiguityError, AgriCoreSession, AgriLogger, AppError, AvailableScope, Converter, ErrorFactory, FormMeta, InfrastructureFields, type OverlapCheckScope, PriceAmbiguityError, PriceConflictCandidate, PriceResolutionResult, type PricingAdapterScope, PricingContext, PricingDataSource, ResolvedError, ResourceRequirement, ScopeType, ShadowedCleanMatch, TabConfig, Tier, UserRoleAssignment, Validator, WireSession, assertTenantBoundary, calculateFileMetadataMatch, createBase44PricingAdapter, decodeSession, encodeSession, evaluateBaseAccess, extractAppCode, findOverlappingPriceWindows, findSpecificOverride, generateCanonicalId, generateDocumentPath, generateInfrastructureFields, getAcceptedMimeTypes, getApproveAction, getFormMeta, getFormsGroupedByModule, getPrivilegesAt, getRoleAt, getScopeAncestry, getTaskTypeOptions, handleAppErrorResponse, hasPrivilegeAt, hasRoleAt, isTabVisible, isTabWritable, resolveAccess, resolveAppError, resolveEffectiveAccess, resolveError, resolvePrice, transformRoleAssignments, verifyAndExtractSession, withAgriLogging };
+export { AccessLevelType, AggregatePriceAmbiguityError, AgriCoreSession, AgriLogger, AppError, AvailableScope, CalculatePaymentDueDateInput, Converter, ErrorFactory, FormMeta, InfrastructureFields, type OverlapCheckScope, PriceAmbiguityError, PriceConflictCandidate, PriceResolutionResult, type PricingAdapterScope, PricingContext, PricingDataSource, ResolvedError, ResourceRequirement, ScopeType, ShadowedCleanMatch, TabConfig, Tier, UserRoleAssignment, Validator, WireSession, assertTenantBoundary, calculateFileMetadataMatch, calculatePaymentDueDate, createBase44PricingAdapter, decodeSession, encodeSession, evaluateBaseAccess, extractAppCode, findOverlappingPriceWindows, findSpecificOverride, generateCanonicalId, generateDocumentPath, generateInfrastructureFields, generateSystemFolderPath, getAcceptedMimeTypes, getApproveAction, getFormMeta, getFormsGroupedByModule, getPrivilegesAt, getRoleAt, getScopeAncestry, getTaskTypeOptions, handleAppErrorResponse, hasPrivilegeAt, hasRoleAt, isDueDatePending, isInstallmentSchedule, isSingleDueDate, isTabVisible, isTabWritable, resolveAccess, resolveAppError, resolveEffectiveAccess, resolveError, resolvePrice, sanitizeSiteName, transformRoleAssignments, verifyAndExtractSession, withAgriLogging };