@pisell/pisellos 2.3.28 → 2.3.30

package/lib/modules/Order/index.js

@@ -37,10 +37,13 @@ var import_types = require("./types");
 var import_utils = require("./utils");
 var import_utils2 = require("../Product/utils");
 var import_dayjs = __toESM(require("dayjs"));
+var import_payment_utils = require("./payment-utils");
+var import_payment_number = require("../../utils/payment-number");
 var import_cartPromotion = require("../../solution/BaseSales/utils/cartPromotion");
 var import_utils3 = require("../../solution/ScanOrder/utils");
 var import_manualProductDiscount = require("./utils/manualProductDiscount");
 var import_bundleDiscountHydration = require("./utils/bundleDiscountHydration");
+var import_orderCollectionIdentity = require("./utils/orderCollectionIdentity");
 var import_Discount = require("../Discount");
 var import_Rules = require("../Rules");
 var import_types2 = require("../Rules/types");
@@ -309,11 +312,11 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       this.store.summary = (0, import_utils.createEmptySummary)();
     }
     this.request = this.core.getPlugin("request");
-    const appPlugin = this.core.getPlugin("app");
-    if (!appPlugin) {
+    this.appPlugin = this.core.getPlugin("app");
+    if (!this.appPlugin) {
       throw new Error("Order 模块需要 app 插件支持");
     }
-    const app = appPlugin.getApp();
+    const app = this.appPlugin.getApp();
     this.logger = app.logger;
     this.window = this.core.getPlugin("window");
     const otherParams = options.otherParams || {};
@@ -1042,17 +1045,40 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const depositPaidAmount = this.calculateDepositPaidAmount(tempOrder.payments || []);
     return depositPaidAmount.lt(depositAmount) ? "deposit" : "normal";
   }
+  getPaymentNumberAppData(key) {
+    var _a, _b, _c, _d, _e;
+    const appPlugin = this.appPlugin;
+    if (!appPlugin)
+      return void 0;
+    const getData = (_a = appPlugin.getData) == null ? void 0 : _a.call(appPlugin);
+    if (typeof getData === "function")
+      return getData(key);
+    const app = appPlugin.getApp();
+    const coreData = (_e = (_c = (_b = app == null ? void 0 : app.models) == null ? void 0 : _b.getStore) == null ? void 0 : (_d = _c.call(_b)).getDataByModel) == null ? void 0 : _e.call(_d, "core", "core");
+    return coreData == null ? void 0 : coreData[key];
+  }
+  getPaymentNumberDevicePrefixSync() {
+    return (0, import_payment_number.resolvePaymentNumberDevicePrefixFromDeviceId)(
+      (key) => this.getPaymentNumberAppData(key)
+    );
+  }
+  getPaymentNumberDevicePrefixAsync() {
+    return (0, import_payment_number.resolvePaymentNumberDevicePrefix)(
+      (key) => this.getPaymentNumberAppData(key)
+    );
+  }
   normalizePaymentSource(payment, options) {
     const paymentRecord = payment;
     const metadata = paymentRecord.metadata && typeof paymentRecord.metadata === "object" ? { ...paymentRecord.metadata } : {};
-    if (!metadata.unique_payment_number) {
-      metadata.unique_payment_number = (0, import_utils.createUuidV4)();
-    }
-    const normalized = {
-      ...paymentRecord,
-      metadata,
-      origin_amount: paymentRecord.origin_amount ?? paymentRecord.amount ?? "0.00"
-    };
+    const normalized = (0, import_payment_utils.ensureOrderPaymentNumber)(
+      {
+        ...paymentRecord,
+        metadata,
+        origin_amount: paymentRecord.origin_amount ?? paymentRecord.amount ?? "0.00"
+      },
+      (options == null ? void 0 : options.devicePrefix) || this.getPaymentNumberDevicePrefixSync(),
+      import_utils.createUuidV4
+    );
     if (paymentRecord.status !== void 0) {
       normalized.status = paymentRecord.status;
     } else if ((options == null ? void 0 : options.defaultPaid) !== false) {
@@ -2471,17 +2497,36 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * 用一组支付来源覆盖当前订单支付项。
    *
    * 入参允许来自 PaymentModule 的 PaymentItem，内部统一映射为 Sales 协议：
-   * uuid -> metadata.unique_payment_number，id -> custom_payment_id，
+   * 新支付来源的 uuid 会作为 payment_number 的唯一号段，id -> custom_payment_id，
    * isSynced 等运行态字段不会进入 tempOrder.payments。
    */
   setOrderPayments(payments) {
     const tempOrder = this.ensureTempOrder();
-    tempOrder.payments = (0, import_utils.mapPaymentItemsToOrderPayments)(payments);
+    tempOrder.payments = (0, import_utils.mapPaymentItemsToOrderPayments)(
+      (payments || []).map((payment) => this.normalizePaymentSource(payment, { defaultPaid: false }))
+    );
     this.persistTempOrder();
     return tempOrder.payments;
   }
-  /** 追加单个支付项，并立即持久化当前 tempOrder。 */
+  /** 同步兼容入口：按调用当下的 device_id 或 LOCAL 生成支付编号。 */
   addOrderPayment(payment) {
+    const hasPaymentNumber = String(
+      payment.payment_number || ""
+    ).trim() !== "";
+    return this.addOrderPaymentWithDevicePrefix(
+      payment,
+      hasPaymentNumber ? "LOCAL" : this.getPaymentNumberDevicePrefixSync()
+    );
+  }
+  /** 异步入口：创建支付项时读取最新 IoT 设备短号。 */
+  async addOrderPaymentAsync(payment) {
+    const hasPaymentNumber = String(
+      payment.payment_number || ""
+    ).trim() !== "";
+    const devicePrefix = hasPaymentNumber ? "LOCAL" : await this.getPaymentNumberDevicePrefixAsync();
+    return this.addOrderPaymentWithDevicePrefix(payment, devicePrefix);
+  }
+  addOrderPaymentWithDevicePrefix(payment, devicePrefix) {
     this.logInfo("addOrderPayment", {
       payment
     });
@@ -2494,7 +2539,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           type: orderPaymentType,
           order_payment_type: orderPaymentType
         },
-        { defaultPaid: true }
+        { defaultPaid: true, devicePrefix }
       )
     ]);
     tempOrder.payments = [...tempOrder.payments || [], ...mapped];
@@ -2507,57 +2552,55 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     return tempOrder.payments;
   }
   /**
-   * 按支付唯一号、后端支付 ID、自定义支付方式 ID 或旧 uuid 更新支付项。
-   *
-   * 该方法服务 PaymentModal 的 void / 编辑场景；更新 metadata 时会做浅合并，
-   * 避免覆盖 unique_payment_number、现金实付/找零等已有元数据。
+   * 默认按支付唯一号精确更新；仅显式指定 legacy 时兼容历史支付标识。
+   * metadata 与 transactions 会分别合并，避免覆盖支付会话号和已有交易记录。
    */
-  updateOrderPayment(paymentIdentity, updates) {
+  async updateOrderPayment(paymentIdentity, updates, options = {}) {
     const tempOrder = this.ensureTempOrder();
     const identity = String(paymentIdentity);
-    tempOrder.payments = (tempOrder.payments || []).map((payment) => {
-      var _a;
-      const uniquePaymentNumber = (_a = payment == null ? void 0 : payment.metadata) == null ? void 0 : _a.unique_payment_number;
-      const orderPaymentId = payment == null ? void 0 : payment.order_payment_id;
-      const customPaymentId = payment == null ? void 0 : payment.custom_payment_id;
-      const uuid = payment == null ? void 0 : payment.uuid;
-      const matched = [
-        uniquePaymentNumber,
-        orderPaymentId,
-        customPaymentId,
-        uuid
-      ].some((value) => value !== void 0 && String(value) === identity);
-      if (!matched)
+    const matchMode = options.matchBy === "compat" || options.matchBy === "legacy" ? "compat" : "payment_number";
+    const matchedPayment = (0, import_payment_utils.resolveOrderPaymentIdentity)(
+      tempOrder.payments || [],
+      identity,
+      matchMode
+    );
+    if (!matchedPayment) {
+      throw new Error(`未找到支付项: ${identity}`);
+    }
+    let updatedPayment = null;
+    tempOrder.payments = (tempOrder.payments || []).map((payment, index) => {
+      if (index !== matchedPayment.index)
         return payment;
-      return {
-        ...payment,
+      const nextPayment = (0, import_payment_utils.mergeOrderPaymentRecord)(payment, {
         ...updates,
-        metadata: {
-          ...payment.metadata || {},
-          ...updates.metadata || {}
-        }
-      };
+        updated_at: updates.updated_at || (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss")
+      });
+      updatedPayment = nextPayment;
+      return nextPayment;
     });
     this.persistTempOrder();
-    return tempOrder.payments;
+    const summary = await this.recalculateSummary({ createIfMissing: true });
+    this.persistTempOrder();
+    const payments = tempOrder.payments;
+    return {
+      updated: true,
+      payment: payments[matchedPayment.index] || updatedPayment,
+      payments,
+      summary
+    };
   }
   /** 从当前订单支付项中移除指定支付项。 */
   deleteOrderPayment(paymentIdentity) {
     const tempOrder = this.ensureTempOrder();
     const identity = String(paymentIdentity);
-    tempOrder.payments = (tempOrder.payments || []).filter((payment) => {
-      var _a;
-      const uniquePaymentNumber = (_a = payment == null ? void 0 : payment.metadata) == null ? void 0 : _a.unique_payment_number;
-      const orderPaymentId = payment == null ? void 0 : payment.order_payment_id;
-      const customPaymentId = payment == null ? void 0 : payment.custom_payment_id;
-      const uuid = payment == null ? void 0 : payment.uuid;
-      return ![
-        uniquePaymentNumber,
-        orderPaymentId,
-        customPaymentId,
-        uuid
-      ].some((value) => value !== void 0 && String(value) === identity);
-    });
+    const matchedPayment = (0, import_payment_utils.resolveOrderPaymentIdentity)(
+      tempOrder.payments || [],
+      identity,
+      "compat"
+    );
+    if (!matchedPayment)
+      return tempOrder.payments;
+    tempOrder.payments = (tempOrder.payments || []).filter((_, index) => index !== matchedPayment.index);
     this.persistTempOrder();
     return tempOrder.payments;
   }
@@ -2666,7 +2709,10 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       payments.map(
         (payment) => this.normalizePaymentSource(
           normalizeVoucherPaymentStatus(withVoucherPaymentType(payment)),
-          { defaultPaid: false }
+          {
+            defaultPaid: false,
+            devicePrefix: options == null ? void 0 : options.devicePrefix
+          }
         )
       )
     ).filter((payment) => {
@@ -2717,6 +2763,14 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     });
     return tempOrder.payments;
   }
+  async updateVoucherOrderPaymentsAsync(payments, options) {
+    const needsPaymentNumber = (payments || []).some((payment) => String(payment.payment_number || "").trim() === "");
+    const devicePrefix = needsPaymentNumber ? await this.getPaymentNumberDevicePrefixAsync() : "LOCAL";
+    return this.updateVoucherOrderPayments(payments, {
+      ...options,
+      devicePrefix
+    });
+  }
   async shouldMergeProductToOrder(params) {
     var _a;
     const onBeforeMergeProductToOrder = (_a = this.orderHooks) == null ? void 0 : _a.onBeforeMergeProductToOrder;
@@ -3483,6 +3537,38 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     await this.saveDraft();
     return tempOrder;
   }
+  async saveTempOrderAsDraft(params) {
+    var _a, _b, _c, _d, _e;
+    const tempOrder = this.ensureTempOrder();
+    this.ensureExternalSaleNumber(tempOrder);
+    this.persistTempOrder();
+    const latestSummary = await this.recalculateSummary({ createIfMissing: true }) || this.store.summary || (0, import_utils.createEmptySummary)();
+    const payload = (0, import_utils.buildSubmitPayload)({
+      tempOrder,
+      cacheId: (params == null ? void 0 : params.cacheId) ?? this.cacheId,
+      platform: (params == null ? void 0 : params.platform) || ((_a = this.otherParams) == null ? void 0 : _a.platform),
+      businessCode: (params == null ? void 0 : params.businessCode) ?? ((_b = this.otherParams) == null ? void 0 : _b.businessCode) ?? ((_c = this.otherParams) == null ? void 0 : _c.business_code),
+      channel: params == null ? void 0 : params.channel,
+      type: (params == null ? void 0 : params.type) ?? ((_d = this.otherParams) == null ? void 0 : _d.type),
+      summary: latestSummary,
+      enhance: params == null ? void 0 : params.enhancePayload
+    });
+    if (!payload.created_at) {
+      payload.created_at = (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss");
+    }
+    payload.need_sync = 0;
+    payload.is_draft_order = 1;
+    this.logInfo("saveTempOrderAsDraft calling sales draft", {
+      orderId: payload.order_id,
+      externalSaleNumber: payload.external_sale_number,
+      productsCount: ((_e = payload.products) == null ? void 0 : _e.length) || 0
+    });
+    return this.request.post("/order/sales/draft", payload, {
+      osServer: true,
+      customToast: () => {
+      }
+    });
+  }
   /**
    * 提交当前 Sales tempOrder。
    *
@@ -3683,8 +3769,13 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   }
   async syncPaymentsToOrder(params) {
     const tempOrder = this.ensureTempOrder();
+    const needsPaymentNumber = (params.payments || []).some((payment) => String(payment.payment_number || "").trim() === "");
+    const devicePrefix = needsPaymentNumber ? await this.getPaymentNumberDevicePrefixAsync() : "LOCAL";
     const mappedPayments = (0, import_utils.mapPaymentItemsToOrderPayments)(
-      params.payments || []
+      (params.payments || []).map((payment) => this.normalizePaymentSource(payment, {
+        defaultPaid: false,
+        devicePrefix
+      }))
     );
     const shouldConfirmPendingVoucherPayments = params.confirmPendingVoucherPayments ?? params.submitWhenPaid === true;
     const effectivePayments = shouldConfirmPendingVoucherPayments ? this.confirmPendingVoucherPaymentsInList(mappedPayments) : params.confirmPendingVoucherPayments === false ? this.discardPendingVoucherPaymentsFromList(mappedPayments) : mappedPayments;
@@ -4030,8 +4121,42 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    */
   async hydrateTempOrderFromRecord(record, options) {
     var _a, _b, _c;
-    const raw = record && typeof record === "object" && record.data && record.order_id == null ? record.data : record || {};
+    const sourceRaw = record && typeof record === "object" && record.data && record.order_id == null ? record.data : record || {};
+    const identityReadySource = this.seedAnonymousBookingUidsFromProducts(
+      sourceRaw
+    );
+    const normalizedCollections = (0, import_orderCollectionIdentity.normalizeOrderCollections)(identityReadySource);
+    const raw = normalizedCollections.order;
+    const hasIdentityChanges = Object.values(normalizedCollections.stats).some(
+      (stats) => stats.backfilledUidCount > 0 || stats.collapsedDuplicateCount > 0 || stats.uidConflictCount > 0 || stats.anonymousRowCount > 0
+    );
+    if (hasIdentityChanges) {
+      const identityLogMetadata = {
+        collections: normalizedCollections.stats,
+        uidRemapCount: normalizedCollections.uidRemaps.length
+      };
+      const hasIdentityWarnings = Object.values(normalizedCollections.stats).some(
+        (stats) => stats.uidConflictCount > 0 || stats.anonymousRowCount > 0
+      );
+      if (hasIdentityWarnings) {
+        this.logWarning(
+          "Normalized hydrated order collection identities",
+          identityLogMetadata
+        );
+      } else {
+        this.logInfo(
+          "Normalized hydrated order collection identities",
+          identityLogMetadata
+        );
+      }
+    }
     const nextTempOrder = this.normalizeTempOrderForRuntime(raw, { makeEditMark: true });
+    const sourceLastOrderInfo = raw.lastOrderInfo || raw;
+    const isDraftOrder = Number(nextTempOrder.is_draft_order || 0) === 1;
+    const syntheticIdentityOptions = {
+      isDraftOrder,
+      externalSaleNumber: nextTempOrder.external_sale_number
+    };
     const rawSummary = raw.summary && typeof raw.summary === "object" ? raw.summary : {};
     const summarySurcharges = Array.isArray(rawSummary.surcharges) ? rawSummary.surcharges.map((s) => ({ ...s || {} })) : (0, import_lodash_es.cloneDeep)(nextTempOrder.surcharges || []);
     this.store.tempOrder = nextTempOrder;
@@ -4045,13 +4170,21 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       originalSalesSnapshot: {
         summary: (0, import_lodash_es.cloneDeep)(this.store.summary),
         products: (0, import_lodash_es.cloneDeep)(nextTempOrder.products || []),
+        bookings: (0, import_lodash_es.cloneDeep)(nextTempOrder.bookings || []),
         payments: (0, import_lodash_es.cloneDeep)(nextTempOrder.payments || []),
         surcharges: (0, import_lodash_es.cloneDeep)(nextTempOrder.surcharges || []),
         shop_discount: nextTempOrder.shop_discount || "0.00",
         productFingerprint: this.buildOrderProductsFingerprint(nextTempOrder.products || [])
       }
     };
-    this.store.lastOrderInfo = raw.lastOrderInfo || raw;
+    this.store.lastOrderInfo = this.withoutSyntheticDraftOrderIdForRuntime(
+      sourceLastOrderInfo,
+      syntheticIdentityOptions
+    );
+    const hadSyntheticDraftOrderId = this.isSyntheticDraftOrderIdForRuntime(raw, syntheticIdentityOptions) || this.isSyntheticDraftOrderIdForRuntime(sourceLastOrderInfo, syntheticIdentityOptions);
+    if (hadSyntheticDraftOrderId && this.store.syncState !== "submitting") {
+      this.store.syncState = "local";
+    }
     const hydratedEditDiscounts = this.collectHydratedEditDiscounts(nextTempOrder.products);
     const currentDiscounts = typeof ((_a = this.store.discount) == null ? void 0 : _a.getDiscountList) === "function" ? this.store.discount.getDiscountList() || [] : [];
     const currentScanDiscounts = currentDiscounts.filter((discount) => discount == null ? void 0 : discount.isScan);
@@ -4104,14 +4237,73 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     }
     return next;
   }
+  /**
+   * 匿名 booking 没有服务端行 ID 时，商品侧已有的 booking_uid 就是唯一可用的强引用。
+   * 在统一规范化生成 UUID 前先复用它；已落库 booking 仍按 schedule_event_id 派生稳定 UID。
+   */
+  seedAnonymousBookingUidsFromProducts(raw) {
+    var _a, _b;
+    if (!raw || typeof raw !== "object")
+      return {};
+    if (!Array.isArray(raw.bookings) || !Array.isArray(raw.products))
+      return raw;
+    const bookingUidsByProductUid = /* @__PURE__ */ new Map();
+    for (const product of raw.products) {
+      const productUid = (0, import_orderCollectionIdentity.getOrderCollectionUid)("product", product);
+      const bookingUid = (product == null ? void 0 : product.booking_uid) || ((_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.booking_uid);
+      if (!productUid || bookingUid === void 0 || bookingUid === null || bookingUid === "") {
+        continue;
+      }
+      const candidates = bookingUidsByProductUid.get(productUid) || /* @__PURE__ */ new Set();
+      candidates.add(String(bookingUid));
+      bookingUidsByProductUid.set(productUid, candidates);
+    }
+    if (bookingUidsByProductUid.size === 0)
+      return raw;
+    const anonymousBookingCountByProductUid = /* @__PURE__ */ new Map();
+    for (const booking of raw.bookings) {
+      if ((0, import_orderCollectionIdentity.getOrderCollectionPersistentId)("booking", booking) || (0, import_orderCollectionIdentity.getOrderCollectionUid)("booking", booking)) {
+        continue;
+      }
+      const productUid = (booking == null ? void 0 : booking.product_uid) || ((_b = booking == null ? void 0 : booking.metadata) == null ? void 0 : _b.product_uid);
+      if (productUid === void 0 || productUid === null || productUid === "")
+        continue;
+      const key = String(productUid);
+      anonymousBookingCountByProductUid.set(
+        key,
+        (anonymousBookingCountByProductUid.get(key) || 0) + 1
+      );
+    }
+    return {
+      ...raw,
+      bookings: raw.bookings.map((booking) => {
+        var _a2;
+        if ((0, import_orderCollectionIdentity.getOrderCollectionPersistentId)("booking", booking) || (0, import_orderCollectionIdentity.getOrderCollectionUid)("booking", booking)) {
+          return booking;
+        }
+        const productUid = (booking == null ? void 0 : booking.product_uid) || ((_a2 = booking == null ? void 0 : booking.metadata) == null ? void 0 : _a2.product_uid);
+        if (productUid === void 0 || productUid === null || productUid === "") {
+          return booking;
+        }
+        const productUidKey = String(productUid);
+        if (anonymousBookingCountByProductUid.get(productUidKey) !== 1) {
+          return booking;
+        }
+        const bookingUidCandidates = bookingUidsByProductUid.get(productUidKey);
+        const bookingUid = (bookingUidCandidates == null ? void 0 : bookingUidCandidates.size) === 1 ? [...bookingUidCandidates][0] : null;
+        return bookingUid ? (0, import_orderCollectionIdentity.setOrderCollectionUid)("booking", booking, bookingUid) : booking;
+      })
+    };
+  }
   normalizeTempOrderForRuntime(raw, options) {
     var _a, _b;
+    const runtimeRaw = this.withoutSyntheticDraftOrderIdForRuntime(raw);
     const nextTempOrder = {
       ...this.createDefaultTempOrderInstance(),
-      ...raw || {}
+      ...runtimeRaw || {}
     };
-    if ((nextTempOrder.order_id === void 0 || nextTempOrder.order_id === null) && (raw == null ? void 0 : raw.id) !== void 0 && (raw == null ? void 0 : raw.id) !== null) {
-      nextTempOrder.order_id = raw.id;
+    if ((nextTempOrder.order_id === void 0 || nextTempOrder.order_id === null) && (runtimeRaw == null ? void 0 : runtimeRaw.id) !== void 0 && (runtimeRaw == null ? void 0 : runtimeRaw.id) !== null) {
+      nextTempOrder.order_id = runtimeRaw.id;
     }
     delete nextTempOrder.summary;
     delete nextTempOrder.lastOrderInfo;
@@ -4179,6 +4371,22 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     nextTempOrder.vouchers = raw.vouchers || [];
     return nextTempOrder;
   }
+  isSyntheticDraftOrderIdForRuntime(record, options) {
+    const isDraftOrder = (options == null ? void 0 : options.isDraftOrder) ?? Number((record == null ? void 0 : record.is_draft_order) || 0) === 1;
+    const externalSaleNumber = (record == null ? void 0 : record.external_sale_number) ?? (options == null ? void 0 : options.externalSaleNumber);
+    const orderId = record == null ? void 0 : record.order_id;
+    return Boolean(
+      isDraftOrder && orderId !== void 0 && orderId !== null && orderId !== "" && externalSaleNumber !== void 0 && externalSaleNumber !== null && externalSaleNumber !== "" && String(orderId) === String(externalSaleNumber)
+    );
+  }
+  withoutSyntheticDraftOrderIdForRuntime(record, options) {
+    if (!this.isSyntheticDraftOrderIdForRuntime(record, options))
+      return record;
+    return {
+      ...record,
+      order_id: null
+    };
+  }
   hydrateLinkedBookingIdentity(tempOrder) {
     const bookingUidByProductUid = /* @__PURE__ */ new Map();
     const productByUid = /* @__PURE__ */ new Map();
@@ -4218,9 +4426,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       if (!product.metadata || typeof product.metadata !== "object") {
         product.metadata = {};
       }
-      const linkedBookingUid = String(
-        product.booking_uid || product.metadata.booking_uid || bookingUid
-      );
+      const linkedBookingUid = String(bookingUid);
       product.booking_uid = linkedBookingUid;
       product.metadata.booking_uid = linkedBookingUid;
     });

package/lib/modules/Order/payment-utils.d.ts

@@ -0,0 +1,23 @@
+export type OrderPaymentTransactionStatus = 'success' | 'fail';
+export interface OrderPaymentTransaction {
+    number: string;
+    status: OrderPaymentTransactionStatus;
+}
+export type OrderPaymentIdentityType = 'order_payment_id' | 'payment_number' | 'unique_payment_number';
+export interface OrderPaymentIdentityMatch<T> {
+    index: number;
+    payment: T;
+    matchedBy: OrderPaymentIdentityType;
+}
+export declare function getOrderPaymentIdentityKeys(payment: unknown): string[];
+export declare function hasOrderPaymentIdentityOverlap(left: unknown, right: unknown): boolean;
+export declare function resolveOrderPaymentIdentity<T extends Record<string, any>>(payments: T[] | null | undefined, identity: string | number, mode?: 'payment_number' | 'compat'): OrderPaymentIdentityMatch<T> | null;
+export declare function ensureOrderPaymentNumber<T extends Record<string, any>>(payment: T, devicePrefix: string, createPaymentNumber: () => string): T & {
+    payment_number: string;
+};
+export declare function mergeOrderPaymentTransactions(current: unknown, incoming: unknown): OrderPaymentTransaction[];
+export declare function mergeOrderPaymentRecord<T extends Record<string, any>>(payment: T, updates: Record<string, any>): T;
+export declare function mergeOrderPaymentSnapshot<T extends Record<string, any>>(current: T, incoming: T): T;
+export declare function mergeOrderPaymentListsByIdentity<T extends Record<string, any>>(existing: T[] | null | undefined, incoming: T[] | null | undefined, options?: {
+    preserveUnmatchedExisting?: boolean;
+}): T[];