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

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;

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;

package/dist/index.js

@@ -1260,7 +1260,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 +1394,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 +1468,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 +1671,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 +1719,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 +1734,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 +1763,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 +1821,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;