@final-commerce/common 2.6.1-staging2.1 → 2.7.0

package/dist/index.d.mts

@@ -1038,21 +1038,6 @@ declare function isConditionOperator(value: string): value is ConditionOperator;
 type PathMode = 'strict' | 'permissive';
 declare const PATH_MODES: readonly PathMode[];
 
-interface OrderStatusDefinition {
-    id: string;
-    label: string;
-    color?: string;
-    icon?: string;
-    fulfillmentState?: FulfillmentState;
-    requiresPaymentState?: PaymentState[];
-}
-interface OrderStatusValidationError {
-    index: number;
-    field: string;
-    message: string;
-}
-declare function validateOrderStatuses(statuses: unknown): OrderStatusValidationError[];
-
 interface OrderPaymentMethod {
     id?: string;
     amount?: number;
@@ -1226,7 +1211,6 @@ interface StoredStateConfig {
     validInitialStates: StatePair[];
     enforceValidInitialStates?: boolean;
     displayStateMap: DisplayStateRule[];
-    orderStatuses?: OrderStatusDefinition[];
     createdAt: Date;
     updatedAt: Date;
 }
@@ -1358,6 +1342,22 @@ interface OrderLikeForInCart {
 declare function hasInCartFlag(order: OrderLikeForInCart): boolean;
 declare function isInCart(order: OrderLikeForInCart): boolean;
 
+interface OrderStatusDefinition {
+    id: string;
+    key: string;
+    defaultLabel: string;
+    color?: string;
+    icon?: string;
+    fulfillmentState?: FulfillmentState;
+    requiresPaymentState?: PaymentState[];
+}
+interface OrderStatusValidationError {
+    index: number;
+    field: string;
+    message: string;
+}
+declare function validateOrderStatuses(statuses: unknown): OrderStatusValidationError[];
+
 interface OrderMutationData extends OrderStateWritable {
     total?: number;
     balance?: number;

package/dist/index.d.ts

@@ -1038,21 +1038,6 @@ declare function isConditionOperator(value: string): value is ConditionOperator;
 type PathMode = 'strict' | 'permissive';
 declare const PATH_MODES: readonly PathMode[];
 
-interface OrderStatusDefinition {
-    id: string;
-    label: string;
-    color?: string;
-    icon?: string;
-    fulfillmentState?: FulfillmentState;
-    requiresPaymentState?: PaymentState[];
-}
-interface OrderStatusValidationError {
-    index: number;
-    field: string;
-    message: string;
-}
-declare function validateOrderStatuses(statuses: unknown): OrderStatusValidationError[];
-
 interface OrderPaymentMethod {
     id?: string;
     amount?: number;
@@ -1226,7 +1211,6 @@ interface StoredStateConfig {
     validInitialStates: StatePair[];
     enforceValidInitialStates?: boolean;
     displayStateMap: DisplayStateRule[];
-    orderStatuses?: OrderStatusDefinition[];
     createdAt: Date;
     updatedAt: Date;
 }
@@ -1358,6 +1342,22 @@ interface OrderLikeForInCart {
 declare function hasInCartFlag(order: OrderLikeForInCart): boolean;
 declare function isInCart(order: OrderLikeForInCart): boolean;
 
+interface OrderStatusDefinition {
+    id: string;
+    key: string;
+    defaultLabel: string;
+    color?: string;
+    icon?: string;
+    fulfillmentState?: FulfillmentState;
+    requiresPaymentState?: PaymentState[];
+}
+interface OrderStatusValidationError {
+    index: number;
+    field: string;
+    message: string;
+}
+declare function validateOrderStatuses(statuses: unknown): OrderStatusValidationError[];
+
 interface OrderMutationData extends OrderStateWritable {
     total?: number;
     balance?: number;

package/dist/index.js

@@ -3038,19 +3038,27 @@ function isInCart(order) {
 }
 
 // order-state-machine/order-status.ts
+var STATUS_KEY = /^[a-z0-9][a-z0-9_-]*$/;
 function validateOrderStatuses(statuses) {
   if (!Array.isArray(statuses)) {
     return [{ index: -1, field: "orderStatuses", message: "must be an array" }];
   }
   const errors = [];
-  const seen = /* @__PURE__ */ new Set();
+  const seenIds = /* @__PURE__ */ new Set();
+  const seenKeys = /* @__PURE__ */ new Set();
   statuses.forEach((raw, index) => {
     const s = raw ?? {};
     const add = (field, message) => errors.push({ index, field, message });
     if (typeof s.id !== "string" || !s.id.trim()) add("id", "must be a non-empty string");
-    else if (seen.has(s.id)) add("id", `duplicate id "${s.id}"`);
-    else seen.add(s.id);
-    if (typeof s.label !== "string" || !s.label.trim()) add("label", "must be a non-empty string");
+    else if (seenIds.has(s.id)) add("id", `duplicate id "${s.id}"`);
+    else seenIds.add(s.id);
+    if (typeof s.key !== "string" || !STATUS_KEY.test(s.key)) {
+      add("key", 'must be lowercase letters, digits, "-" or "_"');
+    } else if (seenKeys.has(s.key)) add("key", `duplicate key "${s.key}"`);
+    else seenKeys.add(s.key);
+    if (typeof s.defaultLabel !== "string" || !s.defaultLabel.trim()) {
+      add("defaultLabel", "must be a non-empty string");
+    }
     for (const field of ["color", "icon"]) {
       if (s[field] !== void 0 && typeof s[field] !== "string") add(field, "must be a string");
     }