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

package/dist/index.mjs

@@ -1118,7 +1118,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 },
@@ -1250,29 +1252,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() {
@@ -1322,7 +1326,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 {
@@ -1524,9 +1529,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;
@@ -1574,17 +1577,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);
@@ -1593,20 +1592,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;
@@ -1632,7 +1621,7 @@ function canTransition(request) {
     };
   }
   if (from === null) {
-    if (!pairInInitialList(to, config)) {
+    if (config.enforceValidInitialStates === true && !pairInInitialList(to, config)) {
       return {
         allowed: false,
         blockedBy: "path",
@@ -1690,15 +1679,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;
@@ -2468,6 +2453,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);
+    }
+  }
+};
 export {
   AttributeType,
   CONDITION_OPERATORS,
@@ -2481,6 +2487,7 @@ export {
   DEFAULT_CROSS_AXIS_RULES,
   DEFAULT_DISPLAY_STATE_MAP,
   DEFAULT_RESOLVED_CONFIG,
+  DualWriteStrategy,
   EUFixedRates,
   EUROPE,
   ExtensionCategory,
@@ -2490,6 +2497,7 @@ export {
   InventoryBaseActionEnum,
   InventorySpecificActionType,
   InvoiceStatus,
+  LegacyWriteStrategy,
   LibraryItemType,
   MenuProject,
   NAFixedRates,