@pisell/pisellos 2.3.29 → 2.3.31

package/dist/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[];

package/dist/modules/Order/payment-utils.js

@@ -0,0 +1,203 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+var PAYMENT_IDENTITY_TYPES = ['payment_number', 'order_payment_id', 'unique_payment_number'];
+function normalizePaymentIdentityValue(value) {
+  if (value === undefined || value === null || value === '') return null;
+  return String(value);
+}
+function getPaymentIdentityValue(payment, type) {
+  if (type === 'unique_payment_number') {
+    var _payment$metadata;
+    return payment === null || payment === void 0 || (_payment$metadata = payment.metadata) === null || _payment$metadata === void 0 ? void 0 : _payment$metadata.unique_payment_number;
+  }
+  return payment === null || payment === void 0 ? void 0 : payment[type];
+}
+export function getOrderPaymentIdentityKeys(payment) {
+  var record = payment;
+  if (!record) return [];
+  return PAYMENT_IDENTITY_TYPES.flatMap(function (type) {
+    var value = normalizePaymentIdentityValue(getPaymentIdentityValue(record, type));
+    return value === null ? [] : ["".concat(type, ":").concat(value)];
+  });
+}
+export function hasOrderPaymentIdentityOverlap(left, right) {
+  var leftKeys = new Set(getOrderPaymentIdentityKeys(left));
+  if (leftKeys.size === 0) return false;
+  return getOrderPaymentIdentityKeys(right).some(function (key) {
+    return leftKeys.has(key);
+  });
+}
+export function resolveOrderPaymentIdentity(payments, identity) {
+  var mode = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'payment_number';
+  var target = String(identity);
+  var identityTypes = mode === 'payment_number' ? ['payment_number'] : PAYMENT_IDENTITY_TYPES;
+  var matchesByIndex = new Map();
+  var _iterator = _createForOfIteratorHelper(identityTypes),
+    _step;
+  try {
+    var _loop = function _loop() {
+      var type = _step.value;
+      (payments || []).forEach(function (payment, index) {
+        var value = normalizePaymentIdentityValue(getPaymentIdentityValue(payment, type));
+        if (value === target && !matchesByIndex.has(index)) {
+          matchesByIndex.set(index, {
+            index: index,
+            payment: payment,
+            matchedBy: type
+          });
+        }
+      });
+    };
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      _loop();
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  var matches = _toConsumableArray(matchesByIndex.values());
+  if (matches.length > 1) {
+    throw new Error("\u652F\u4ED8\u9879\u8EAB\u4EFD\u5B58\u5728\u6B67\u4E49: ".concat(target));
+  }
+  return matches[0] || null;
+}
+export function ensureOrderPaymentNumber(payment, devicePrefix, createPaymentNumber) {
+  var existing = normalizePaymentIdentityValue(payment.payment_number);
+  if (existing) return _objectSpread(_objectSpread({}, payment), {}, {
+    payment_number: existing
+  });
+  var uuid = normalizePaymentIdentityValue(payment.uuid) || createPaymentNumber();
+  var prefix = normalizePaymentIdentityValue(devicePrefix) || 'LOCAL';
+  // TODO: 使用 ID Generator 替换当前 UUID 段生成器。
+  return _objectSpread(_objectSpread({}, payment), {}, {
+    payment_number: "".concat(prefix, "_").concat(uuid)
+  });
+}
+export function mergeOrderPaymentTransactions(current, incoming) {
+  var records = new Map();
+  var append = function append(value) {
+    if (!Array.isArray(value)) return;
+    value.forEach(function (item) {
+      var number = item && _typeof(item) === 'object' ? String(item.number || '') : '';
+      var status = item && _typeof(item) === 'object' ? item.status : undefined;
+      if (!number || status !== 'success' && status !== 'fail') return;
+      var previous = records.get(number);
+      if ((previous === null || previous === void 0 ? void 0 : previous.status) === 'success' && status === 'fail') return;
+      records.set(number, {
+        number: number,
+        status: status
+      });
+    });
+  };
+  append(current);
+  append(incoming);
+  return _toConsumableArray(records.values());
+}
+export function mergeOrderPaymentRecord(payment, updates) {
+  var _updates$status, _updates$updated_at;
+  var currentMetadata = payment.metadata || {};
+  var incomingMetadata = updates.metadata || {};
+  var transactions = mergeOrderPaymentTransactions(currentMetadata.transactions, incomingMetadata.transactions);
+  var currentPaid = payment.status === 'paid';
+  var nextStatus = currentPaid && updates.status !== 'paid' ? 'paid' : (_updates$status = updates.status) !== null && _updates$status !== void 0 ? _updates$status : payment.status;
+  return _objectSpread(_objectSpread(_objectSpread({}, payment), updates), {}, {
+    status: nextStatus,
+    updated_at: (_updates$updated_at = updates.updated_at) !== null && _updates$updated_at !== void 0 ? _updates$updated_at : payment.updated_at,
+    metadata: _objectSpread(_objectSpread(_objectSpread({}, currentMetadata), incomingMetadata), transactions.length > 0 || Array.isArray(incomingMetadata.transactions) ? {
+      transactions: transactions
+    } : {})
+  });
+}
+export function mergeOrderPaymentSnapshot(current, incoming) {
+  var currentMetadata = current.metadata || {};
+  var incomingMetadata = incoming.metadata || {};
+  var transactions = mergeOrderPaymentTransactions(currentMetadata.transactions, incomingMetadata.transactions);
+  return _objectSpread(_objectSpread(_objectSpread({}, current), incoming), {}, {
+    payment_number: incoming.payment_number || current.payment_number,
+    metadata: _objectSpread(_objectSpread(_objectSpread({}, currentMetadata), incomingMetadata), transactions.length > 0 ? {
+      transactions: transactions
+    } : {})
+  });
+}
+function compactOrderPaymentList(payments) {
+  var result = [];
+  var _iterator2 = _createForOfIteratorHelper(payments),
+    _step2;
+  try {
+    var _loop2 = function _loop2() {
+      var payment = _step2.value;
+      var matchingIndexes = result.flatMap(function (existing, index) {
+        return hasOrderPaymentIdentityOverlap(existing, payment) ? [index] : [];
+      });
+      if (matchingIndexes.length === 0) {
+        result.push(mergeOrderPaymentSnapshot({}, payment));
+        return 1; // continue
+      }
+      var firstIndex = matchingIndexes[0];
+      var merged = result[firstIndex];
+      var _iterator3 = _createForOfIteratorHelper(matchingIndexes.slice(1)),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var index = _step3.value;
+          merged = mergeOrderPaymentSnapshot(merged, result[index]);
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+      result[firstIndex] = mergeOrderPaymentSnapshot(merged, payment);
+      var _iterator4 = _createForOfIteratorHelper(matchingIndexes.slice(1).sort(function (a, b) {
+          return b - a;
+        })),
+        _step4;
+      try {
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var _index = _step4.value;
+          result.splice(_index, 1);
+        }
+      } catch (err) {
+        _iterator4.e(err);
+      } finally {
+        _iterator4.f();
+      }
+    };
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      if (_loop2()) continue;
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  return result;
+}
+export function mergeOrderPaymentListsByIdentity(existing, incoming) {
+  var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  var existingList = compactOrderPaymentList(_toConsumableArray(existing || []));
+  var incomingList = compactOrderPaymentList(_toConsumableArray(incoming || []));
+  if (options.preserveUnmatchedExisting) {
+    return compactOrderPaymentList([].concat(_toConsumableArray(existingList), _toConsumableArray(incomingList)));
+  }
+  return compactOrderPaymentList(incomingList.map(function (incomingPayment) {
+    var matchingExisting = existingList.filter(function (existingPayment) {
+      return hasOrderPaymentIdentityOverlap(existingPayment, incomingPayment);
+    });
+    return matchingExisting.reduce(function (merged, existingPayment) {
+      return mergeOrderPaymentSnapshot(existingPayment, merged);
+    }, incomingPayment);
+  }));
+}

package/dist/modules/Order/types.d.ts

@@ -468,6 +468,8 @@ export interface SubmitSalesOrderParams {
 export interface PaymentItemData {
     /** 当前支付项的唯一 ID */
     uuid: string;
+    /** 支付项稳定唯一号 */
+    payment_number?: string;
     /** 当前支付方式付出去多少钱 */
     amount: string;
     /** 支付类型代码 */
@@ -490,13 +492,22 @@ export interface PaymentItemData {
 export interface OrderPaymentMetadata {
     rounding_rule?: Record<string, any>;
     unique_payment_number?: string;
+    /** 刷卡机设备快照；OS 不解析内部字段，仅透传并持久化 */
+    card_reader_snapshot?: Record<string, unknown>;
     shop_wallet_pass_id?: number | string;
     actual_paid_amount?: number | string;
     change_given_amount?: number | string;
+    transactions?: OrderPaymentTransaction[];
     [key: string]: any;
 }
+export interface OrderPaymentTransaction {
+    number: string;
+    status: 'success' | 'fail';
+}
 export interface OrderPaymentData {
     order_payment_id?: number | string;
+    /** 支付项稳定唯一号；历史支付项允许缺失 */
+    payment_number?: string;
     amount: string;
     code: string;
     custom_payment_id: number;
@@ -523,6 +534,15 @@ export interface OrderPaymentData {
     created_at?: string;
     updated_at?: string;
 }
+export interface OrderPaymentUpdateOptions {
+    matchBy?: 'payment_number' | 'compat' | 'legacy';
+}
+export interface OrderPaymentUpdateResult {
+    updated: boolean;
+    payment: OrderPaymentData | null;
+    payments: OrderPaymentData[];
+    summary: OrderSummary | null;
+}
 export type OrderPaymentSource = PaymentItem | OrderPaymentData | Record<string, any>;
 export interface MapOrderPaymentsOptions {
     includeVoided?: boolean;
@@ -673,6 +693,14 @@ export interface OrderModuleAPI {
         channel?: string;
         type?: string;
     }) => OrderSubmitPayload;
+    saveTempOrderAsDraft: <T = any>(params?: {
+        cacheId?: string;
+        platform?: string;
+        businessCode?: string;
+        channel?: string;
+        type?: string;
+        enhancePayload?: SubmitPayloadEnhancer;
+    }) => Promise<T>;
     applyLocalPrintOrderNumbers: (order?: Record<string, any> | null) => Promise<OrderTempOrder>;
     getTempOrderNote: () => string;
     updateTempOrderNote: {
@@ -730,11 +758,15 @@ export interface OrderModuleAPI {
     getOrderPayments: () => OrderPaymentData[];
     setOrderPayments: (payments: OrderPaymentSource[]) => OrderPaymentData[];
     addOrderPayment: (payment: OrderPaymentSource) => OrderPaymentData[];
-    updateOrderPayment: (paymentIdentity: string | number, updates: Partial<OrderPaymentData> & Record<string, any>) => OrderPaymentData[];
+    addOrderPaymentAsync: (payment: OrderPaymentSource) => Promise<OrderPaymentData[]>;
+    updateOrderPayment: (paymentIdentity: string | number, updates: Partial<OrderPaymentData> & Record<string, any>, options?: OrderPaymentUpdateOptions) => Promise<OrderPaymentUpdateResult>;
     deleteOrderPayment: (paymentIdentity: string | number) => OrderPaymentData[];
     updateVoucherOrderPayments: (payments: OrderPaymentSource[], options?: {
         status?: 'paid' | 'payment_pending';
     }) => OrderPaymentData[];
+    updateVoucherOrderPaymentsAsync: (payments: OrderPaymentSource[], options?: {
+        status?: 'paid' | 'payment_pending';
+    }) => Promise<OrderPaymentData[]>;
     confirmPendingVoucherPayments: (options?: {
         persist?: boolean;
         recalculateSummary?: boolean;

package/dist/modules/Order/utils.js

@@ -1152,9 +1152,7 @@ export function mapPaymentItemToOrderPayment(paymentItem) {
   var item = paymentItem;
   var customPaymentId = (_item$custom_payment_ = item.custom_payment_id) !== null && _item$custom_payment_ !== void 0 ? _item$custom_payment_ : item.id;
   var metadata = item.metadata && _typeof(item.metadata) === 'object' ? _objectSpread({}, item.metadata) : {};
-  if (item.uuid && !metadata.unique_payment_number) {
-    metadata.unique_payment_number = String(item.uuid);
-  }
+  var paymentNumber = item.payment_number;
   var paymentMetadataKeys = ['rounding_rule', 'shop_wallet_pass_id', 'actual_paid_amount', 'change_given_amount'];
   for (var _i3 = 0, _paymentMetadataKeys = paymentMetadataKeys; _i3 < _paymentMetadataKeys.length; _i3++) {
     var key = _paymentMetadataKeys[_i3];
@@ -1165,8 +1163,10 @@ export function mapPaymentItemToOrderPayment(paymentItem) {
   var timestamp = dayjs().format('YYYY-MM-DD HH:mm:ss');
   var paymentTime = (_item$payment_time = item.payment_time) !== null && _item$payment_time !== void 0 ? _item$payment_time : timestamp;
   var createdAt = (_item$created_at = item.created_at) !== null && _item$created_at !== void 0 ? _item$created_at : timestamp;
-  return _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, item.order_payment_id !== undefined ? {
+  return _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, item.order_payment_id !== undefined ? {
     order_payment_id: item.order_payment_id
+  } : {}), paymentNumber !== undefined && paymentNumber !== null && paymentNumber !== '' ? {
+    payment_number: String(paymentNumber)
   } : {}), {}, {
     amount: String((_item$amount = item.amount) !== null && _item$amount !== void 0 ? _item$amount : '0.00'),
     code: String(item.code || ''),

package/dist/modules/Payment/index.d.ts

@@ -20,6 +20,7 @@ export declare class PaymentModule extends BaseModule implements Module, Payment
     protected defaultVersion: string;
     request: RequestPlugin;
     private app;
+    private appPlugin;
     private store;
     window: WindowPlugin;
     private dbManager;
@@ -40,6 +41,7 @@ export declare class PaymentModule extends BaseModule implements Module, Payment
      * paymentModule.updateOtherParams({ fatherModule: 'bookingTicket' });
      */
     updateOtherParams(params: Record<string, any>): void;
+    private getPaymentNumberAppData;
     /**
      * 记录信息日志
      */