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

package/dist/index.d.mts

@@ -218,7 +218,8 @@ declare enum InventorySpecificActionType {
     SALE = "SALE",
     TRANSFER = "TRANSFER",
     BULK_RECOUNT = "BULK_RECOUNT",
-    APPLIED_FROM_WOO = "APPLIED_FROM_WOO"
+    APPLIED_FROM_WOO = "APPLIED_FROM_WOO",
+    PO_RECEIVED = "PO_RECEIVED"
 }
 declare enum ExtensionCategory {
     SYNC = "sync",
@@ -391,6 +392,12 @@ declare enum ProductStatus {
     DRAFT = "draft"
 }
 
+declare enum PaymentProcessor {
+    STRIPE = "stripe",
+    ADYEN = "adyen",
+    EXTERNAL = "external"
+}
+
 interface CurrencyConfig {
     minorUnits: number;
     symbol: string;
@@ -619,6 +626,19 @@ declare function getMinorUnits(currency: CurrencyCode): number;
 declare function createAmount(value: string | number | null | undefined, currency: CurrencyCode): Amount | undefined;
 declare function amountToString(amount: Amount | undefined | null): string;
 
+type MoneyInput = number | string | null | undefined;
+declare function getTotalCollected(amountPaid: MoneyInput, tipTotal: MoneyInput): number;
+declare function getPaymentLegTotal(amount: MoneyInput, tipAmount: MoneyInput): number;
+declare function getCashAmountDue(amount: MoneyInput, cashRounding: MoneyInput): number;
+interface SettlementBuckets {
+    cardTotal?: MoneyInput;
+    cashTotal?: MoneyInput;
+    customTotal?: MoneyInput;
+}
+declare function getSettlementTotal(payments: SettlementBuckets | undefined | null, tipTotal: MoneyInput): number;
+declare function getLineSubtotal(price: MoneyInput, quantity: MoneyInput): number;
+declare function getGoodsPortion(total: MoneyInput, totalTax: MoneyInput): number;
+
 declare function getPricingRegionFromCountry(countryCode?: string): PricingRegionEnum;
 declare const NORTH_AMERICA: Set<string>;
 declare const EUROPE: Set<string>;
@@ -899,7 +919,6 @@ declare const DEFAULT_CONFIG: StoredStateConfig;
 declare function buildResolvedConfig(config: StoredStateConfig): StateConfig;
 declare const DEFAULT_RESOLVED_CONFIG: StateConfig;
 
-declare const POS_CROSS_AXIS_RULES: readonly CrossAxisRule[];
 declare const POS_VALID_INITIAL_STATES: readonly StatePair[];
 declare function buildPosPresetConfig(companyId?: string): StoredStateConfig;
 
@@ -1059,4 +1078,4 @@ declare const EUFixedRates: Record<string, CurrencyRate>;
 declare const OtherFixedRates: Record<string, CurrencyRate>;
 declare const COUNTRY_CURRENCIES: Record<string, string>;
 
-export { type Amount, AttributeType, type AvailableTransition, CONDITION_OPERATORS, COUNTRY_CURRENCIES, CURRENCY_CONFIG, type CartDiscountBucket, type CartFeeBucket, type CashDrawer, type CashRoundingTuple, CompanyType, type Condition, type ConditionGroup, type ConditionOperator, type ConfigUpdatedPayload, type ConfigValidationError, type ConfigValidationResult, type ConfigValidationWarning, type CrossAxisRequires, type CrossAxisRule, type CrossAxisTrigger, CurrencyCode, type CurrencyConfig, type CurrencyRate, CustomTableAvailability, CustomerPlatform, DEFAULT_CONFIG, DEFAULT_CROSS_AXIS_RULES, DEFAULT_DISPLAY_STATE_MAP, DEFAULT_RESOLVED_CONFIG, type DeleteStateConfigFragmentParams, type DeleteStateConfigFragmentResponse, type DiscountsBreakdown, type DiscountsTuple, type DisplayStateResult, type DisplayStateRule, EUFixedRates, EUROPE, type EndOfSessionReport, ExtensionCategory, FINANCIAL_INVARIANTS, FULFILLMENT_STATES, type FailedCondition, type FeesBreakdown, FeesCustomBillingStatus, type FeesTuple, type FinancialInvariant, type FragmentParam, type FragmentValidationResult, type FulfillmentState, type FulfillmentStateDefinition, type FulfillmentTransitionPath, type GetAvailableTransitionsParams, type GetAvailableTransitionsResponse, type GetOrderDisplayStateParams, type GetOrderDisplayStateResponse, type GetOrderStateConfigParams, type GetOrderStateConfigResponse, type GetStateConfigFragmentParams, type GetStateConfigFragmentResponse, InventoryBaseActionEnum, type InventoryBaseActionType, InventorySpecificActionType, InvoiceStatus, LibraryItemType, MenuProject, NAFixedRates, NORTH_AMERICA, NonRevenueItemType, ORDER_STATE_ACTIONS, ORDER_STATE_EVENTS, ORDER_STATE_TOPIC, type OrderContext, type OrderLikeForContext, type OrderLikeForLegacyInference, type OrderLineItem, type OrderPaymentMethod, OrderPlatform, type OrderRefund, type OrderStateEventPayload, type OrderStateWritable, OtherFixedRates, OwnerType, PATH_MODES, PAYMENT_STATES, POS_CROSS_AXIS_RULES, POS_VALID_INITIAL_STATES, type PathMode, PaymentMethod, type PaymentState, type PaymentStateDefinition, type PaymentTransitionPath, Platform, PreviewImageMode, PricingLevel, PricingPlanEnum, PricingRegionEnum, type ProductDiscountBucket, type ProductFeeBucket, ProductStatus, ProductType, PublicationAvailability, type PublicationConfig, PublicationStatus, REGION_MAPPING, REPORT_NEGATE_PATHS, ReceiptSendChannel, ReceiptType, type RefundsBreakdown, ResidualPaymentMethod, ResidualStatus, type ResolveTemplateResult, STATE_SCHEMA, STRIPE_SUPPORTED_COUNTRIES, type SalesSummary, type SaveStateConfigFragmentParams, type SaveStateConfigFragmentResponse, type SettlementBreakdown, type SettlementCardSection, type SettlementCashSection, type SettlementCustomEntry, type SplitPayment, type SplitPaymentPayment, type StaffSales, type StaffSalesEntry, type StateConfig, type StateConfigFragment, type StateDefinition, type StatePair, type StateSchema, type StateTransitionBlockedPayload, type StateTransitionCompletedPayload, StationStatus, type StoredStateConfig, StripeCurrencyCode, StripeStatus, type TaxBreakdown, type TaxBreakdownRateEntry, type TaxBreakdownSection, type TaxBreakdownSubtotal, type TaxesTuple, TimePeriod, type TipEntry, type TipsBreakdown, type TipsTuple, TopMetericsSort, type TransitionBlockedBy, type TransitionConditionSet, type TransitionOrderStateParams, type TransitionOrderStateResponse, type TransitionPath, type TransitionRequest, type TransitionResult, UserTypes, addAmounts, amountToString, baseFulfillmentDefinitions, basePaymentDefinitions, buildOrderContext, buildPosPresetConfig, buildResolvedConfig, calculatePercentage, canTransition, conditionSummary, convertFixedFeeToLocalCurrency, createAmount, crossAxisRuleApplies, deriveDisplayState, displayRuleMatchesPair, divideAmount, evaluateCondition, evaluateConditionSet, formatCurrency, formatMinorUnitsToString, fromMinorUnits, generateMongoID, getAvailableTransitions, getCountriesByRegion, getCurrencyConfig, getCurrentISODate, getFinancialInvariantViolations, getMinorUnitMultiplier, getMinorUnits, getPricingRegionFromCountry, inferStatesFromLegacyStatus, isConditionOperator, isFulfillmentState, isPaymentState, isSupportedCurrency, mapToLegacyStatus, mergeFragment, multiplyAmount, normalizeMongoIdString, parseAmountToMinorUnits, parseCurrencyCode, parseStripeCurrencyCode, removeFragment, resolveTemplate, setOrderState, signReportForDisplay, stringifyMinorUnits, subtractAmounts, toMinorUnits, validateConfig, validateFragmentCompatibility, violatesFinancialInvariant };
+export { type Amount, AttributeType, type AvailableTransition, CONDITION_OPERATORS, COUNTRY_CURRENCIES, CURRENCY_CONFIG, type CartDiscountBucket, type CartFeeBucket, type CashDrawer, type CashRoundingTuple, CompanyType, type Condition, type ConditionGroup, type ConditionOperator, type ConfigUpdatedPayload, type ConfigValidationError, type ConfigValidationResult, type ConfigValidationWarning, type CrossAxisRequires, type CrossAxisRule, type CrossAxisTrigger, CurrencyCode, type CurrencyConfig, type CurrencyRate, CustomTableAvailability, CustomerPlatform, DEFAULT_CONFIG, DEFAULT_CROSS_AXIS_RULES, DEFAULT_DISPLAY_STATE_MAP, DEFAULT_RESOLVED_CONFIG, type DeleteStateConfigFragmentParams, type DeleteStateConfigFragmentResponse, type DiscountsBreakdown, type DiscountsTuple, type DisplayStateResult, type DisplayStateRule, EUFixedRates, EUROPE, type EndOfSessionReport, ExtensionCategory, FINANCIAL_INVARIANTS, FULFILLMENT_STATES, type FailedCondition, type FeesBreakdown, FeesCustomBillingStatus, type FeesTuple, type FinancialInvariant, type FragmentParam, type FragmentValidationResult, type FulfillmentState, type FulfillmentStateDefinition, type FulfillmentTransitionPath, type GetAvailableTransitionsParams, type GetAvailableTransitionsResponse, type GetOrderDisplayStateParams, type GetOrderDisplayStateResponse, type GetOrderStateConfigParams, type GetOrderStateConfigResponse, type GetStateConfigFragmentParams, type GetStateConfigFragmentResponse, InventoryBaseActionEnum, type InventoryBaseActionType, InventorySpecificActionType, InvoiceStatus, LibraryItemType, MenuProject, NAFixedRates, NORTH_AMERICA, NonRevenueItemType, ORDER_STATE_ACTIONS, ORDER_STATE_EVENTS, ORDER_STATE_TOPIC, type OrderContext, type OrderLikeForContext, type OrderLikeForLegacyInference, type OrderLineItem, type OrderPaymentMethod, OrderPlatform, type OrderRefund, type OrderStateEventPayload, type OrderStateWritable, OtherFixedRates, OwnerType, PATH_MODES, PAYMENT_STATES, POS_VALID_INITIAL_STATES, type PathMode, PaymentMethod, PaymentProcessor, type PaymentState, type PaymentStateDefinition, type PaymentTransitionPath, Platform, PreviewImageMode, PricingLevel, PricingPlanEnum, PricingRegionEnum, type ProductDiscountBucket, type ProductFeeBucket, ProductStatus, ProductType, PublicationAvailability, type PublicationConfig, PublicationStatus, REGION_MAPPING, REPORT_NEGATE_PATHS, ReceiptSendChannel, ReceiptType, type RefundsBreakdown, ResidualPaymentMethod, ResidualStatus, type ResolveTemplateResult, STATE_SCHEMA, STRIPE_SUPPORTED_COUNTRIES, type SalesSummary, type SaveStateConfigFragmentParams, type SaveStateConfigFragmentResponse, type SettlementBreakdown, type SettlementBuckets, type SettlementCardSection, type SettlementCashSection, type SettlementCustomEntry, type SplitPayment, type SplitPaymentPayment, type StaffSales, type StaffSalesEntry, type StateConfig, type StateConfigFragment, type StateDefinition, type StatePair, type StateSchema, type StateTransitionBlockedPayload, type StateTransitionCompletedPayload, StationStatus, type StoredStateConfig, StripeCurrencyCode, StripeStatus, type TaxBreakdown, type TaxBreakdownRateEntry, type TaxBreakdownSection, type TaxBreakdownSubtotal, type TaxesTuple, TimePeriod, type TipEntry, type TipsBreakdown, type TipsTuple, TopMetericsSort, type TransitionBlockedBy, type TransitionConditionSet, type TransitionOrderStateParams, type TransitionOrderStateResponse, type TransitionPath, type TransitionRequest, type TransitionResult, UserTypes, addAmounts, amountToString, baseFulfillmentDefinitions, basePaymentDefinitions, buildOrderContext, buildPosPresetConfig, buildResolvedConfig, calculatePercentage, canTransition, conditionSummary, convertFixedFeeToLocalCurrency, createAmount, crossAxisRuleApplies, deriveDisplayState, displayRuleMatchesPair, divideAmount, evaluateCondition, evaluateConditionSet, formatCurrency, formatMinorUnitsToString, fromMinorUnits, generateMongoID, getAvailableTransitions, getCashAmountDue, getCountriesByRegion, getCurrencyConfig, getCurrentISODate, getFinancialInvariantViolations, getGoodsPortion, getLineSubtotal, getMinorUnitMultiplier, getMinorUnits, getPaymentLegTotal, getPricingRegionFromCountry, getSettlementTotal, getTotalCollected, inferStatesFromLegacyStatus, isConditionOperator, isFulfillmentState, isPaymentState, isSupportedCurrency, mapToLegacyStatus, mergeFragment, multiplyAmount, normalizeMongoIdString, parseAmountToMinorUnits, parseCurrencyCode, parseStripeCurrencyCode, removeFragment, resolveTemplate, setOrderState, signReportForDisplay, stringifyMinorUnits, subtractAmounts, toMinorUnits, validateConfig, validateFragmentCompatibility, violatesFinancialInvariant };

package/dist/index.d.ts

@@ -218,7 +218,8 @@ declare enum InventorySpecificActionType {
     SALE = "SALE",
     TRANSFER = "TRANSFER",
     BULK_RECOUNT = "BULK_RECOUNT",
-    APPLIED_FROM_WOO = "APPLIED_FROM_WOO"
+    APPLIED_FROM_WOO = "APPLIED_FROM_WOO",
+    PO_RECEIVED = "PO_RECEIVED"
 }
 declare enum ExtensionCategory {
     SYNC = "sync",
@@ -391,6 +392,12 @@ declare enum ProductStatus {
     DRAFT = "draft"
 }
 
+declare enum PaymentProcessor {
+    STRIPE = "stripe",
+    ADYEN = "adyen",
+    EXTERNAL = "external"
+}
+
 interface CurrencyConfig {
     minorUnits: number;
     symbol: string;
@@ -619,6 +626,19 @@ declare function getMinorUnits(currency: CurrencyCode): number;
 declare function createAmount(value: string | number | null | undefined, currency: CurrencyCode): Amount | undefined;
 declare function amountToString(amount: Amount | undefined | null): string;
 
+type MoneyInput = number | string | null | undefined;
+declare function getTotalCollected(amountPaid: MoneyInput, tipTotal: MoneyInput): number;
+declare function getPaymentLegTotal(amount: MoneyInput, tipAmount: MoneyInput): number;
+declare function getCashAmountDue(amount: MoneyInput, cashRounding: MoneyInput): number;
+interface SettlementBuckets {
+    cardTotal?: MoneyInput;
+    cashTotal?: MoneyInput;
+    customTotal?: MoneyInput;
+}
+declare function getSettlementTotal(payments: SettlementBuckets | undefined | null, tipTotal: MoneyInput): number;
+declare function getLineSubtotal(price: MoneyInput, quantity: MoneyInput): number;
+declare function getGoodsPortion(total: MoneyInput, totalTax: MoneyInput): number;
+
 declare function getPricingRegionFromCountry(countryCode?: string): PricingRegionEnum;
 declare const NORTH_AMERICA: Set<string>;
 declare const EUROPE: Set<string>;
@@ -899,7 +919,6 @@ declare const DEFAULT_CONFIG: StoredStateConfig;
 declare function buildResolvedConfig(config: StoredStateConfig): StateConfig;
 declare const DEFAULT_RESOLVED_CONFIG: StateConfig;
 
-declare const POS_CROSS_AXIS_RULES: readonly CrossAxisRule[];
 declare const POS_VALID_INITIAL_STATES: readonly StatePair[];
 declare function buildPosPresetConfig(companyId?: string): StoredStateConfig;
 
@@ -1059,4 +1078,4 @@ declare const EUFixedRates: Record<string, CurrencyRate>;
 declare const OtherFixedRates: Record<string, CurrencyRate>;
 declare const COUNTRY_CURRENCIES: Record<string, string>;
 
-export { type Amount, AttributeType, type AvailableTransition, CONDITION_OPERATORS, COUNTRY_CURRENCIES, CURRENCY_CONFIG, type CartDiscountBucket, type CartFeeBucket, type CashDrawer, type CashRoundingTuple, CompanyType, type Condition, type ConditionGroup, type ConditionOperator, type ConfigUpdatedPayload, type ConfigValidationError, type ConfigValidationResult, type ConfigValidationWarning, type CrossAxisRequires, type CrossAxisRule, type CrossAxisTrigger, CurrencyCode, type CurrencyConfig, type CurrencyRate, CustomTableAvailability, CustomerPlatform, DEFAULT_CONFIG, DEFAULT_CROSS_AXIS_RULES, DEFAULT_DISPLAY_STATE_MAP, DEFAULT_RESOLVED_CONFIG, type DeleteStateConfigFragmentParams, type DeleteStateConfigFragmentResponse, type DiscountsBreakdown, type DiscountsTuple, type DisplayStateResult, type DisplayStateRule, EUFixedRates, EUROPE, type EndOfSessionReport, ExtensionCategory, FINANCIAL_INVARIANTS, FULFILLMENT_STATES, type FailedCondition, type FeesBreakdown, FeesCustomBillingStatus, type FeesTuple, type FinancialInvariant, type FragmentParam, type FragmentValidationResult, type FulfillmentState, type FulfillmentStateDefinition, type FulfillmentTransitionPath, type GetAvailableTransitionsParams, type GetAvailableTransitionsResponse, type GetOrderDisplayStateParams, type GetOrderDisplayStateResponse, type GetOrderStateConfigParams, type GetOrderStateConfigResponse, type GetStateConfigFragmentParams, type GetStateConfigFragmentResponse, InventoryBaseActionEnum, type InventoryBaseActionType, InventorySpecificActionType, InvoiceStatus, LibraryItemType, MenuProject, NAFixedRates, NORTH_AMERICA, NonRevenueItemType, ORDER_STATE_ACTIONS, ORDER_STATE_EVENTS, ORDER_STATE_TOPIC, type OrderContext, type OrderLikeForContext, type OrderLikeForLegacyInference, type OrderLineItem, type OrderPaymentMethod, OrderPlatform, type OrderRefund, type OrderStateEventPayload, type OrderStateWritable, OtherFixedRates, OwnerType, PATH_MODES, PAYMENT_STATES, POS_CROSS_AXIS_RULES, POS_VALID_INITIAL_STATES, type PathMode, PaymentMethod, type PaymentState, type PaymentStateDefinition, type PaymentTransitionPath, Platform, PreviewImageMode, PricingLevel, PricingPlanEnum, PricingRegionEnum, type ProductDiscountBucket, type ProductFeeBucket, ProductStatus, ProductType, PublicationAvailability, type PublicationConfig, PublicationStatus, REGION_MAPPING, REPORT_NEGATE_PATHS, ReceiptSendChannel, ReceiptType, type RefundsBreakdown, ResidualPaymentMethod, ResidualStatus, type ResolveTemplateResult, STATE_SCHEMA, STRIPE_SUPPORTED_COUNTRIES, type SalesSummary, type SaveStateConfigFragmentParams, type SaveStateConfigFragmentResponse, type SettlementBreakdown, type SettlementCardSection, type SettlementCashSection, type SettlementCustomEntry, type SplitPayment, type SplitPaymentPayment, type StaffSales, type StaffSalesEntry, type StateConfig, type StateConfigFragment, type StateDefinition, type StatePair, type StateSchema, type StateTransitionBlockedPayload, type StateTransitionCompletedPayload, StationStatus, type StoredStateConfig, StripeCurrencyCode, StripeStatus, type TaxBreakdown, type TaxBreakdownRateEntry, type TaxBreakdownSection, type TaxBreakdownSubtotal, type TaxesTuple, TimePeriod, type TipEntry, type TipsBreakdown, type TipsTuple, TopMetericsSort, type TransitionBlockedBy, type TransitionConditionSet, type TransitionOrderStateParams, type TransitionOrderStateResponse, type TransitionPath, type TransitionRequest, type TransitionResult, UserTypes, addAmounts, amountToString, baseFulfillmentDefinitions, basePaymentDefinitions, buildOrderContext, buildPosPresetConfig, buildResolvedConfig, calculatePercentage, canTransition, conditionSummary, convertFixedFeeToLocalCurrency, createAmount, crossAxisRuleApplies, deriveDisplayState, displayRuleMatchesPair, divideAmount, evaluateCondition, evaluateConditionSet, formatCurrency, formatMinorUnitsToString, fromMinorUnits, generateMongoID, getAvailableTransitions, getCountriesByRegion, getCurrencyConfig, getCurrentISODate, getFinancialInvariantViolations, getMinorUnitMultiplier, getMinorUnits, getPricingRegionFromCountry, inferStatesFromLegacyStatus, isConditionOperator, isFulfillmentState, isPaymentState, isSupportedCurrency, mapToLegacyStatus, mergeFragment, multiplyAmount, normalizeMongoIdString, parseAmountToMinorUnits, parseCurrencyCode, parseStripeCurrencyCode, removeFragment, resolveTemplate, setOrderState, signReportForDisplay, stringifyMinorUnits, subtractAmounts, toMinorUnits, validateConfig, validateFragmentCompatibility, violatesFinancialInvariant };
+export { type Amount, AttributeType, type AvailableTransition, CONDITION_OPERATORS, COUNTRY_CURRENCIES, CURRENCY_CONFIG, type CartDiscountBucket, type CartFeeBucket, type CashDrawer, type CashRoundingTuple, CompanyType, type Condition, type ConditionGroup, type ConditionOperator, type ConfigUpdatedPayload, type ConfigValidationError, type ConfigValidationResult, type ConfigValidationWarning, type CrossAxisRequires, type CrossAxisRule, type CrossAxisTrigger, CurrencyCode, type CurrencyConfig, type CurrencyRate, CustomTableAvailability, CustomerPlatform, DEFAULT_CONFIG, DEFAULT_CROSS_AXIS_RULES, DEFAULT_DISPLAY_STATE_MAP, DEFAULT_RESOLVED_CONFIG, type DeleteStateConfigFragmentParams, type DeleteStateConfigFragmentResponse, type DiscountsBreakdown, type DiscountsTuple, type DisplayStateResult, type DisplayStateRule, EUFixedRates, EUROPE, type EndOfSessionReport, ExtensionCategory, FINANCIAL_INVARIANTS, FULFILLMENT_STATES, type FailedCondition, type FeesBreakdown, FeesCustomBillingStatus, type FeesTuple, type FinancialInvariant, type FragmentParam, type FragmentValidationResult, type FulfillmentState, type FulfillmentStateDefinition, type FulfillmentTransitionPath, type GetAvailableTransitionsParams, type GetAvailableTransitionsResponse, type GetOrderDisplayStateParams, type GetOrderDisplayStateResponse, type GetOrderStateConfigParams, type GetOrderStateConfigResponse, type GetStateConfigFragmentParams, type GetStateConfigFragmentResponse, InventoryBaseActionEnum, type InventoryBaseActionType, InventorySpecificActionType, InvoiceStatus, LibraryItemType, MenuProject, NAFixedRates, NORTH_AMERICA, NonRevenueItemType, ORDER_STATE_ACTIONS, ORDER_STATE_EVENTS, ORDER_STATE_TOPIC, type OrderContext, type OrderLikeForContext, type OrderLikeForLegacyInference, type OrderLineItem, type OrderPaymentMethod, OrderPlatform, type OrderRefund, type OrderStateEventPayload, type OrderStateWritable, OtherFixedRates, OwnerType, PATH_MODES, PAYMENT_STATES, POS_VALID_INITIAL_STATES, type PathMode, PaymentMethod, PaymentProcessor, type PaymentState, type PaymentStateDefinition, type PaymentTransitionPath, Platform, PreviewImageMode, PricingLevel, PricingPlanEnum, PricingRegionEnum, type ProductDiscountBucket, type ProductFeeBucket, ProductStatus, ProductType, PublicationAvailability, type PublicationConfig, PublicationStatus, REGION_MAPPING, REPORT_NEGATE_PATHS, ReceiptSendChannel, ReceiptType, type RefundsBreakdown, ResidualPaymentMethod, ResidualStatus, type ResolveTemplateResult, STATE_SCHEMA, STRIPE_SUPPORTED_COUNTRIES, type SalesSummary, type SaveStateConfigFragmentParams, type SaveStateConfigFragmentResponse, type SettlementBreakdown, type SettlementBuckets, type SettlementCardSection, type SettlementCashSection, type SettlementCustomEntry, type SplitPayment, type SplitPaymentPayment, type StaffSales, type StaffSalesEntry, type StateConfig, type StateConfigFragment, type StateDefinition, type StatePair, type StateSchema, type StateTransitionBlockedPayload, type StateTransitionCompletedPayload, StationStatus, type StoredStateConfig, StripeCurrencyCode, StripeStatus, type TaxBreakdown, type TaxBreakdownRateEntry, type TaxBreakdownSection, type TaxBreakdownSubtotal, type TaxesTuple, TimePeriod, type TipEntry, type TipsBreakdown, type TipsTuple, TopMetericsSort, type TransitionBlockedBy, type TransitionConditionSet, type TransitionOrderStateParams, type TransitionOrderStateResponse, type TransitionPath, type TransitionRequest, type TransitionResult, UserTypes, addAmounts, amountToString, baseFulfillmentDefinitions, basePaymentDefinitions, buildOrderContext, buildPosPresetConfig, buildResolvedConfig, calculatePercentage, canTransition, conditionSummary, convertFixedFeeToLocalCurrency, createAmount, crossAxisRuleApplies, deriveDisplayState, displayRuleMatchesPair, divideAmount, evaluateCondition, evaluateConditionSet, formatCurrency, formatMinorUnitsToString, fromMinorUnits, generateMongoID, getAvailableTransitions, getCashAmountDue, getCountriesByRegion, getCurrencyConfig, getCurrentISODate, getFinancialInvariantViolations, getGoodsPortion, getLineSubtotal, getMinorUnitMultiplier, getMinorUnits, getPaymentLegTotal, getPricingRegionFromCountry, getSettlementTotal, getTotalCollected, inferStatesFromLegacyStatus, isConditionOperator, isFulfillmentState, isPaymentState, isSupportedCurrency, mapToLegacyStatus, mergeFragment, multiplyAmount, normalizeMongoIdString, parseAmountToMinorUnits, parseCurrencyCode, parseStripeCurrencyCode, removeFragment, resolveTemplate, setOrderState, signReportForDisplay, stringifyMinorUnits, subtractAmounts, toMinorUnits, validateConfig, validateFragmentCompatibility, violatesFinancialInvariant };

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,