@pisell/pisellos 2.3.28 → 2.3.30

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

@@ -467,6 +467,8 @@ export interface SubmitSalesOrderParams {
 export interface PaymentItemData {
     /** 当前支付项的唯一 ID */
     uuid: string;
+    /** 支付项稳定唯一号 */
+    payment_number?: string;
     /** 当前支付方式付出去多少钱 */
     amount: string;
     /** 支付类型代码 */
@@ -489,13 +491,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;
@@ -522,6 +533,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;
@@ -672,6 +692,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: {
@@ -729,11 +757,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/orderCollectionIdentity.d.ts

@@ -0,0 +1,53 @@
+export type OrderCollectionKind = 'product' | 'booking' | 'payment';
+export interface OrderCollectionIdentityStats {
+    backfilledUidCount: number;
+    collapsedDuplicateCount: number;
+    uidConflictCount: number;
+    anonymousRowCount: number;
+}
+export interface OrderCollectionUidRemap {
+    kind: OrderCollectionKind;
+    from: string;
+    to: string;
+    persistentId: string | null;
+    /** 默认全局迁移；UID 冲突时只能迁移能由另一侧 UID 明确定位的引用。 */
+    scope?: 'global' | 'linked-owner';
+    referenceOwnerUid?: string | null;
+}
+export interface NormalizeOrderCollectionResult<T> {
+    items: T[];
+    stats: OrderCollectionIdentityStats;
+    uidRemaps: OrderCollectionUidRemap[];
+}
+export interface NormalizeOrderCollectionsResult<T> {
+    order: T;
+    stats: Record<OrderCollectionKind, OrderCollectionIdentityStats>;
+    uidRemaps: OrderCollectionUidRemap[];
+}
+export declare function createUuidV4(): string;
+export declare function isBlankOrderCollectionIdentity(value: unknown): boolean;
+export declare function getOrderCollectionPersistentId(kind: OrderCollectionKind, item: unknown): string | null;
+export declare function getOrderCollectionUid(kind: OrderCollectionKind, item: unknown): string | null;
+export declare function buildOrderCollectionFallbackUid(kind: OrderCollectionKind, persistentId: string | number): string;
+export declare function getOrderCollectionReferenceUid(kind: OrderCollectionKind, item: unknown): string | null;
+export declare function setOrderCollectionUid<T>(kind: OrderCollectionKind, item: T, uid: string): T;
+/**
+ * 持久化行 ID 是服务端事实主键；只有至少一侧尚未持久化时，才允许用 runtime UID 对齐。
+ */
+export declare function isSameOrderCollectionItem(kind: OrderCollectionKind, left: unknown, right: unknown): boolean;
+export declare function mergeOrderCollectionItems<T>(kind: OrderCollectionKind, currentItem: T, incomingItem: T, options?: {
+    ensureUid?: boolean;
+    createAnonymousUid?: () => string;
+}): T;
+/**
+ * 规范化单一数组：强身份重复时保留首次位置、用最后一条业务字段覆盖，并统一补 UID。
+ */
+export declare function normalizeOrderCollection<T>(kind: OrderCollectionKind, items: T[] | null | undefined, options?: {
+    ensureUid?: boolean;
+    createAnonymousUid?: () => string;
+}): NormalizeOrderCollectionResult<T>;
+export declare function applyOrderCollectionUidRemaps<T extends Record<string, any>>(sourceOrder: T, uidRemaps: OrderCollectionUidRemap[]): T;
+export declare function normalizeOrderCollections<T extends Record<string, any>>(sourceOrder: T, options?: {
+    ensureUid?: boolean;
+    createAnonymousUid?: () => string;
+}): NormalizeOrderCollectionsResult<T>;