@final-commerce/common 2.0.18-beta.1 → 2.1.1

package/dist/index.d.mts

@@ -830,6 +830,7 @@ interface StoredStateConfig {
     crossAxisRules: CrossAxisRule[];
     transitionConditions: TransitionConditionSet[];
     validInitialStates: StatePair[];
+    enforceValidInitialStates?: boolean;
     displayStateMap: DisplayStateRule[];
     createdAt: Date;
     updatedAt: Date;
@@ -1067,6 +1068,40 @@ interface ConfigUpdatedPayload {
 }
 type OrderStateEventPayload = StateTransitionCompletedPayload | StateTransitionBlockedPayload | ConfigUpdatedPayload;
 
+interface OrderMutationData extends OrderStateWritable {
+    total?: number;
+    balance?: number;
+    paymentMethods?: {
+        amount?: number;
+        [key: string]: unknown;
+    }[];
+    refunds?: {
+        quantity?: number;
+        [key: string]: unknown;
+    }[];
+    refund?: {
+        quantity?: number;
+        [key: string]: unknown;
+    }[];
+    lineItems?: {
+        quantity?: number;
+        fulfilledQuantity?: number;
+        returnedQuantity?: number;
+        [key: string]: unknown;
+    }[];
+}
+interface OrderWriteStrategy {
+    applyState(order: OrderMutationData): void;
+}
+declare class LegacyWriteStrategy implements OrderWriteStrategy {
+    applyState(_order: OrderMutationData): void;
+}
+declare class DualWriteStrategy implements OrderWriteStrategy {
+    private readonly config;
+    constructor(config: StoredStateConfig);
+    applyState(order: OrderMutationData): void;
+}
+
 interface CurrencyRate {
     rate: number;
     country: string;
@@ -1078,4 +1113,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_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 };
+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, DualWriteStrategy, 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, LegacyWriteStrategy, LibraryItemType, MenuProject, NAFixedRates, NORTH_AMERICA, NonRevenueItemType, ORDER_STATE_ACTIONS, ORDER_STATE_EVENTS, ORDER_STATE_TOPIC, type OrderContext, type OrderLikeForContext, type OrderLikeForLegacyInference, type OrderLineItem, type OrderMutationData, type OrderPaymentMethod, OrderPlatform, type OrderRefund, type OrderStateEventPayload, type OrderStateWritable, type OrderWriteStrategy, 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

@@ -830,6 +830,7 @@ interface StoredStateConfig {
     crossAxisRules: CrossAxisRule[];
     transitionConditions: TransitionConditionSet[];
     validInitialStates: StatePair[];
+    enforceValidInitialStates?: boolean;
     displayStateMap: DisplayStateRule[];
     createdAt: Date;
     updatedAt: Date;
@@ -1067,6 +1068,40 @@ interface ConfigUpdatedPayload {
 }
 type OrderStateEventPayload = StateTransitionCompletedPayload | StateTransitionBlockedPayload | ConfigUpdatedPayload;
 
+interface OrderMutationData extends OrderStateWritable {
+    total?: number;
+    balance?: number;
+    paymentMethods?: {
+        amount?: number;
+        [key: string]: unknown;
+    }[];
+    refunds?: {
+        quantity?: number;
+        [key: string]: unknown;
+    }[];
+    refund?: {
+        quantity?: number;
+        [key: string]: unknown;
+    }[];
+    lineItems?: {
+        quantity?: number;
+        fulfilledQuantity?: number;
+        returnedQuantity?: number;
+        [key: string]: unknown;
+    }[];
+}
+interface OrderWriteStrategy {
+    applyState(order: OrderMutationData): void;
+}
+declare class LegacyWriteStrategy implements OrderWriteStrategy {
+    applyState(_order: OrderMutationData): void;
+}
+declare class DualWriteStrategy implements OrderWriteStrategy {
+    private readonly config;
+    constructor(config: StoredStateConfig);
+    applyState(order: OrderMutationData): void;
+}
+
 interface CurrencyRate {
     rate: number;
     country: string;
@@ -1078,4 +1113,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_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 };
+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, DualWriteStrategy, 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, LegacyWriteStrategy, LibraryItemType, MenuProject, NAFixedRates, NORTH_AMERICA, NonRevenueItemType, ORDER_STATE_ACTIONS, ORDER_STATE_EVENTS, ORDER_STATE_TOPIC, type OrderContext, type OrderLikeForContext, type OrderLikeForLegacyInference, type OrderLineItem, type OrderMutationData, type OrderPaymentMethod, OrderPlatform, type OrderRefund, type OrderStateEventPayload, type OrderStateWritable, type OrderWriteStrategy, 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

@@ -31,6 +31,7 @@ __export(index_exports, {
   DEFAULT_CROSS_AXIS_RULES: () => DEFAULT_CROSS_AXIS_RULES,
   DEFAULT_DISPLAY_STATE_MAP: () => DEFAULT_DISPLAY_STATE_MAP,
   DEFAULT_RESOLVED_CONFIG: () => DEFAULT_RESOLVED_CONFIG,
+  DualWriteStrategy: () => DualWriteStrategy,
   EUFixedRates: () => EUFixedRates,
   EUROPE: () => EUROPE,
   ExtensionCategory: () => ExtensionCategory,
@@ -40,6 +41,7 @@ __export(index_exports, {
   InventoryBaseActionEnum: () => InventoryBaseActionEnum,
   InventorySpecificActionType: () => InventorySpecificActionType,
   InvoiceStatus: () => InvoiceStatus,
+  LegacyWriteStrategy: () => LegacyWriteStrategy,
   LibraryItemType: () => LibraryItemType,
   MenuProject: () => MenuProject,
   NAFixedRates: () => NAFixedRates,
@@ -1260,7 +1262,9 @@ var PAYMENT_DEFS = [
 var FULFILLMENT_DEFS = [
   { id: "draft", label: "Draft", terminal: false },
   { id: "pending", label: "Pending", terminal: false },
-  { id: "on_hold", label: "On Hold", terminal: false },
+  // 'Parked' is the product term for a held order (OS bug #30) — the atom id
+  // stays `on_hold`; only the human label realigns.
+  { id: "on_hold", label: "Parked", terminal: false },
   { id: "in_progress", label: "In Progress", terminal: false },
   { id: "fulfilled", label: "Fulfilled", terminal: true },
   { id: "partially_fulfilled", label: "Partially Fulfilled", terminal: false },
@@ -1392,29 +1396,31 @@ var DEFAULT_CROSS_AXIS_RULES = [
 
 // order-state-machine/default-config.ts
 var DEFAULT_EPOCH = /* @__PURE__ */ new Date(0);
-var PAYMENT_LABELS = new Map(
-  basePaymentDefinitions().map((d) => [d.id, d.label])
-);
-var FULFILLMENT_LABELS = new Map(
-  baseFulfillmentDefinitions().map((d) => [d.id, d.label])
-);
+var PAYMENT_LABELS = new Map(basePaymentDefinitions().map((d) => [d.id, d.label]));
+var FULFILLMENT_LABELS = new Map(baseFulfillmentDefinitions().map((d) => [d.id, d.label]));
 var TERMINAL_PAYMENT_STATES = new Set(
   basePaymentDefinitions().filter((d) => d.isTerminal).map((d) => d.id)
 );
 var DISPLAY_LABEL_OVERRIDES = {
   "unpaid|draft": "In Cart",
   "unpaid|pending": "Pending Payment",
-  "unpaid|on_hold": "On Hold",
+  "unpaid|on_hold": "Parked",
   "unpaid|cancelled": "Cancelled",
   "partially_paid|pending": "Deposit Received",
-  "partially_paid|on_hold": "On Hold - Deposit Received",
+  "partially_paid|on_hold": "Parked - Deposit Received",
+  "partially_paid|in_progress": "Partially Paid",
   "paid|pending": "Paid - Awaiting Fulfillment",
-  "paid|on_hold": "Paid - On Hold",
+  "paid|on_hold": "Parked - Paid",
   "paid|fulfilled": "Completed",
   "partially_refunded|fulfilled": "Partially Refunded",
-  "partially_refunded|partially_returned": "Partially Returned",
+  "partially_refunded|partially_returned": "Partially Refunded",
   "refunded|fulfilled": "Refunded",
-  "refunded|returned": "Returned and Refunded",
+  "refunded|returned": "Refunded",
+  // Full refund of a never-fulfilled order (kaching refund op lands on
+  // cancelled when nothing was delivered). Terminal payment states emit no
+  // generic rows, so without this the pair fell through to the raw
+  // "refunded / cancelled" engine fallback.
+  "refunded|cancelled": "Refunded",
   "voided|cancelled": "Cancelled"
 };
 function buildDefaultDisplayStateMap() {
@@ -1464,7 +1470,8 @@ var POS_VALID_INITIAL_STATES = [
   { payment: "unpaid", fulfillment: "pending" },
   { payment: "paid", fulfillment: "fulfilled" },
   { payment: "partially_paid", fulfillment: "draft" },
-  { payment: "partially_paid", fulfillment: "pending" }
+  { payment: "partially_paid", fulfillment: "pending" },
+  { payment: "partially_paid", fulfillment: "in_progress" }
 ];
 function buildPosPresetConfig(companyId) {
   return {
@@ -1666,9 +1673,7 @@ function conditionSummary(c) {
 
 // order-state-machine/engine.ts
 function pairInInitialList(to, config) {
-  return config.validInitialStates.some(
-    (p) => p.payment === to.payment && p.fulfillment === to.fulfillment
-  );
+  return config.validInitialStates.some((p) => p.payment === to.payment && p.fulfillment === to.fulfillment);
 }
 function triggerTargets(rule) {
   const t = rule.trigger.to;
@@ -1716,17 +1721,13 @@ function collectPathConditionFailures(config, from, to, context) {
   const failed = [];
   if (from === null) return { failed };
   if (from.payment !== to.payment) {
-    const p = config.paymentPaths.find(
-      (x) => x.from === from.payment && x.to === to.payment
-    );
+    const p = config.paymentPaths.find((x) => x.from === from.payment && x.to === to.payment);
     const set = findConditionSet(config, p?.conditionSetId);
     const ev = evaluateConditionSet(set, context);
     if (!ev.ok) failed.push(...ev.failedConditions);
   }
   if (from.fulfillment !== to.fulfillment) {
-    const p = config.fulfillmentPaths.find(
-      (x) => x.from === from.fulfillment && x.to === to.fulfillment
-    );
+    const p = config.fulfillmentPaths.find((x) => x.from === from.fulfillment && x.to === to.fulfillment);
     const set = findConditionSet(config, p?.conditionSetId);
     const ev = evaluateConditionSet(set, context);
     if (!ev.ok) failed.push(...ev.failedConditions);
@@ -1735,20 +1736,10 @@ function collectPathConditionFailures(config, from, to, context) {
 }
 function pathBlocked(config, from, to) {
   if (from === null) return false;
-  if (from.payment !== to.payment && !axisTransitionAllowed(
-    config.paymentPathMode,
-    config.paymentPaths,
-    from.payment,
-    to.payment
-  )) {
+  if (from.payment !== to.payment && !axisTransitionAllowed(config.paymentPathMode, config.paymentPaths, from.payment, to.payment)) {
     return true;
   }
-  if (from.fulfillment !== to.fulfillment && !axisTransitionAllowed(
-    config.fulfillmentPathMode,
-    config.fulfillmentPaths,
-    from.fulfillment,
-    to.fulfillment
-  )) {
+  if (from.fulfillment !== to.fulfillment && !axisTransitionAllowed(config.fulfillmentPathMode, config.fulfillmentPaths, from.fulfillment, to.fulfillment)) {
     return true;
   }
   return false;
@@ -1774,7 +1765,7 @@ function canTransition(request) {
     };
   }
   if (from === null) {
-    if (!pairInInitialList(to, config)) {
+    if (config.enforceValidInitialStates === true && !pairInInitialList(to, config)) {
       return {
         allowed: false,
         blockedBy: "path",
@@ -1832,15 +1823,11 @@ function conditionMetLines(config, from, to, context) {
     }
   };
   if (from.payment !== to.payment) {
-    const p = config.paymentPaths.find(
-      (x) => x.from === from.payment && x.to === to.payment
-    );
+    const p = config.paymentPaths.find((x) => x.from === from.payment && x.to === to.payment);
     appendForPath(p);
   }
   if (from.fulfillment !== to.fulfillment) {
-    const p = config.fulfillmentPaths.find(
-      (x) => x.from === from.fulfillment && x.to === to.fulfillment
-    );
+    const p = config.fulfillmentPaths.find((x) => x.from === from.fulfillment && x.to === to.fulfillment);
     appendForPath(p);
   }
   return lines;
@@ -2610,6 +2597,27 @@ var ORDER_STATE_EVENTS = {
   stateTransitionBlocked: "state-transition-blocked",
   configUpdated: "config-updated"
 };
+
+// order-state-machine/write-strategy.ts
+var LegacyWriteStrategy = class {
+  applyState(_order) {
+  }
+};
+var DualWriteStrategy = class {
+  constructor(config) {
+    this.config = config;
+  }
+  applyState(order) {
+    if (order.paymentState && order.fulfillmentState) {
+      setOrderState(order, order.paymentState, order.fulfillmentState, this.config);
+      return;
+    }
+    if (order.status) {
+      const inferred = inferStatesFromLegacyStatus(order);
+      setOrderState(order, inferred.payment, inferred.fulfillment, this.config);
+    }
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AttributeType,
@@ -2624,6 +2632,7 @@ var ORDER_STATE_EVENTS = {
   DEFAULT_CROSS_AXIS_RULES,
   DEFAULT_DISPLAY_STATE_MAP,
   DEFAULT_RESOLVED_CONFIG,
+  DualWriteStrategy,
   EUFixedRates,
   EUROPE,
   ExtensionCategory,
@@ -2633,6 +2642,7 @@ var ORDER_STATE_EVENTS = {
   InventoryBaseActionEnum,
   InventorySpecificActionType,
   InvoiceStatus,
+  LegacyWriteStrategy,
   LibraryItemType,
   MenuProject,
   NAFixedRates,