@final-commerce/common 1.1.4-beta.4 → 1.2.4-beta.2

package/dist/index.js

@@ -53,9 +53,9 @@ __export(index_exports, {
   OwnerType: () => OwnerType,
   PATH_MODES: () => PATH_MODES,
   PAYMENT_STATES: () => PAYMENT_STATES,
-  POS_CROSS_AXIS_RULES: () => POS_CROSS_AXIS_RULES,
   POS_VALID_INITIAL_STATES: () => POS_VALID_INITIAL_STATES,
   PaymentMethod: () => PaymentMethod,
+  PaymentProcessor: () => PaymentProcessor,
   Platform: () => Platform,
   PreviewImageMode: () => PreviewImageMode,
   PricingLevel: () => PricingLevel,
@@ -102,13 +102,19 @@ __export(index_exports, {
   fromMinorUnits: () => fromMinorUnits,
   generateMongoID: () => generateMongoID,
   getAvailableTransitions: () => getAvailableTransitions,
+  getCashAmountDue: () => getCashAmountDue,
   getCountriesByRegion: () => getCountriesByRegion,
   getCurrencyConfig: () => getCurrencyConfig,
   getCurrentISODate: () => getCurrentISODate,
   getFinancialInvariantViolations: () => getFinancialInvariantViolations,
+  getGoodsPortion: () => getGoodsPortion,
+  getLineSubtotal: () => getLineSubtotal,
   getMinorUnitMultiplier: () => getMinorUnitMultiplier,
   getMinorUnits: () => getMinorUnits,
+  getPaymentLegTotal: () => getPaymentLegTotal,
   getPricingRegionFromCountry: () => getPricingRegionFromCountry,
+  getSettlementTotal: () => getSettlementTotal,
+  getTotalCollected: () => getTotalCollected,
   inferStatesFromLegacyStatus: () => inferStatesFromLegacyStatus,
   isConditionOperator: () => isConditionOperator,
   isFulfillmentState: () => isFulfillmentState,
@@ -367,6 +373,7 @@ var InventorySpecificActionType = /* @__PURE__ */ ((InventorySpecificActionType2
   InventorySpecificActionType2["TRANSFER"] = "TRANSFER";
   InventorySpecificActionType2["BULK_RECOUNT"] = "BULK_RECOUNT";
   InventorySpecificActionType2["APPLIED_FROM_WOO"] = "APPLIED_FROM_WOO";
+  InventorySpecificActionType2["PO_RECEIVED"] = "PO_RECEIVED";
   return InventorySpecificActionType2;
 })(InventorySpecificActionType || {});
 var ExtensionCategory = /* @__PURE__ */ ((ExtensionCategory2) => {
@@ -561,6 +568,14 @@ var ProductStatus = /* @__PURE__ */ ((ProductStatus2) => {
   return ProductStatus2;
 })(ProductStatus || {});
 
+// enums/payments.enum.ts
+var PaymentProcessor = /* @__PURE__ */ ((PaymentProcessor2) => {
+  PaymentProcessor2["STRIPE"] = "stripe";
+  PaymentProcessor2["ADYEN"] = "adyen";
+  PaymentProcessor2["EXTERNAL"] = "external";
+  return PaymentProcessor2;
+})(PaymentProcessor || {});
+
 // utils/currency.util.ts
 var CURRENCY_CONFIG = {
   // Major currencies with 2 decimal places
@@ -844,6 +859,29 @@ function amountToString(amount) {
   return majorValue.toFixed(amount.minorUnits);
 }
 
+// utils/order-totals.util.ts
+function toMinorUnits2(value) {
+  return Number(value) || 0;
+}
+function getTotalCollected(amountPaid, tipTotal) {
+  return toMinorUnits2(amountPaid) + toMinorUnits2(tipTotal);
+}
+function getPaymentLegTotal(amount, tipAmount) {
+  return toMinorUnits2(amount) + toMinorUnits2(tipAmount);
+}
+function getCashAmountDue(amount, cashRounding) {
+  return toMinorUnits2(amount) - toMinorUnits2(cashRounding);
+}
+function getSettlementTotal(payments, tipTotal) {
+  return toMinorUnits2(payments?.cardTotal) + toMinorUnits2(payments?.cashTotal) + toMinorUnits2(payments?.customTotal) + toMinorUnits2(tipTotal);
+}
+function getLineSubtotal(price, quantity) {
+  return toMinorUnits2(price) * toMinorUnits2(quantity);
+}
+function getGoodsPortion(total, totalTax) {
+  return toMinorUnits2(total) - toMinorUnits2(totalTax);
+}
+
 // constants/pricing.constants.ts
 var REGION_MAPPING = {
   // North America
@@ -1093,7 +1131,8 @@ var REPORT_NEGATE_PATHS = /* @__PURE__ */ new Set([
   "taxBreakdown.refunds.total.tax",
   // Refunds breakdown — reductions and naturally-signed entries
   "refundsBreakdown.discountsReversed",
-  "refundsBreakdown.cashRoundingRefund",
+  // 2026 AUG10, cashRoundingRefund is showing as natural sign
+  // 'refundsBreakdown.cashRoundingRefund',
   // Fees breakdown — refunded magnitudes are money flowing back out
   "feesBreakdown.productFee.refundedProductFees",
   "feesBreakdown.cartFee.refundedCartFees",
@@ -1402,7 +1441,7 @@ var DEFAULT_CONFIG = {
   fulfillmentPaths: [],
   paymentPathMode: "permissive",
   fulfillmentPathMode: "permissive",
-  crossAxisRules: [...DEFAULT_CROSS_AXIS_RULES],
+  crossAxisRules: [],
   transitionConditions: [],
   validInitialStates: [{ payment: "unpaid", fulfillment: "draft" }],
   displayStateMap: [...DEFAULT_DISPLAY_STATE_MAP],
@@ -1419,19 +1458,6 @@ function buildResolvedConfig(config) {
 var DEFAULT_RESOLVED_CONFIG = buildResolvedConfig(DEFAULT_CONFIG);
 
 // order-state-machine/pos-preset.ts
-var POS_CROSS_AXIS_RULES = [
-  {
-    id: "pos-pay-requires-open-fulfillment",
-    label: "Payments only on open fulfillment states",
-    description: "POS payments are only valid on orders whose fulfillment is open (draft / pending / on_hold) or auto-fulfilled in lock-step (fulfilled). Returned / cancelled / in-progress fulfillment must use refund flows instead.",
-    enabled: true,
-    trigger: { axis: "payment", to: ["payment_pending", "paid", "partially_paid"] },
-    requires: {
-      axis: "fulfillment",
-      states: ["draft", "pending", "on_hold", "fulfilled"]
-    }
-  }
-];
 var POS_VALID_INITIAL_STATES = [
   { payment: "unpaid", fulfillment: "draft" },
   { payment: "unpaid", fulfillment: "on_hold" },
@@ -1446,7 +1472,7 @@ function buildPosPresetConfig(companyId) {
     _id: "pos-preset",
     companyId: companyId ?? DEFAULT_CONFIG.companyId,
     name: "POS Preset",
-    crossAxisRules: [...DEFAULT_CROSS_AXIS_RULES, ...POS_CROSS_AXIS_RULES],
+    crossAxisRules: [],
     validInitialStates: [...POS_VALID_INITIAL_STATES],
     displayStateMap: [...DEFAULT_DISPLAY_STATE_MAP]
   };
@@ -2620,9 +2646,9 @@ var ORDER_STATE_EVENTS = {
   OwnerType,
   PATH_MODES,
   PAYMENT_STATES,
-  POS_CROSS_AXIS_RULES,
   POS_VALID_INITIAL_STATES,
   PaymentMethod,
+  PaymentProcessor,
   Platform,
   PreviewImageMode,
   PricingLevel,
@@ -2669,13 +2695,19 @@ var ORDER_STATE_EVENTS = {
   fromMinorUnits,
   generateMongoID,
   getAvailableTransitions,
+  getCashAmountDue,
   getCountriesByRegion,
   getCurrencyConfig,
   getCurrentISODate,
   getFinancialInvariantViolations,
+  getGoodsPortion,
+  getLineSubtotal,
   getMinorUnitMultiplier,
   getMinorUnits,
+  getPaymentLegTotal,
   getPricingRegionFromCountry,
+  getSettlementTotal,
+  getTotalCollected,
   inferStatesFromLegacyStatus,
   isConditionOperator,
   isFulfillmentState,