@pisell/pisellos 2.2.244 → 2.2.246

package/dist/server/modules/order/types.d.ts

@@ -80,6 +80,16 @@ export interface OrderProductMetadata {
     unique_identification_number?: string;
     [key: string]: unknown;
 }
+export interface OrderProductTitleSnapshot {
+    en: string | null;
+    ja: string | null;
+    pt: string | null;
+    auto: string | null;
+    'zh-CN': string | null;
+    'zh-HK': string | null;
+    kitchen: string | null;
+    original: string | null;
+}
 /**
  * 订单级商品行（3.3 products）。
  * 订单级别的非预约关联商品；预约关联商品在 bookings 内。
@@ -92,10 +102,10 @@ export interface OrderProductLineItem {
     product_id?: number | null;
     /** 数量。创建/更新时必填。来源：Detail.product_quantity */
     num: number;
+    /** 商品标题快照；本地待同步订单会补齐为多语言对象。 */
+    product_title?: OrderProductTitleSnapshot | string | null;
     /** 多规格 ID。来源：Detail.product_variant_id */
     product_variant_id?: number;
-    /** 选项配置 */
-    product_option_item?: unknown[];
     /**
      * 销售单价（交易快照，仅输出）。
      * 来源：Detail.selling_price
@@ -229,8 +239,10 @@ export interface OrderPaymentItem {
     rounding_amount?: OrderMoneyString;
     /** 支付状态：paid / voided / payment_pending 等 */
     status?: OrderPaymentRecordStatus;
-    /** 支付时间（仅输出）。来源：OrderPayment.payment_time */
+    /** 支付时间（输入/输出均保留）。来源：OrderPayment.payment_time */
     payment_time?: string | null;
+    /** 支付创建时间（输入/输出均保留）。来源：OrderPayment.created_at */
+    created_at?: string | null;
     /** 手续费配置。来源：OrderPayment.service_charge */
     service_charge?: Record<string, unknown> | null;
     /** Wallet Pass 使用单位 */
@@ -395,6 +407,8 @@ export interface OrderData {
     /** 本地辅助字段 */
     shop_id?: number;
     create_date?: string;
+    /** 本地待同步标记：1 表示需要后续同步到云端 */
+    need_sync?: 0 | 1 | number;
     /** 兼容：部分场景仍使用顶层 total_amount */
     total_amount?: OrderMoneyString | number;
     /** 扩展字段（物流、标签等）；使用 any 以便筛选与数据源扩展 */
@@ -524,6 +538,21 @@ export interface OrderAblyEventPayload {
     order_id?: OrderId;
     timestamp: number;
 }
+/**
+ * 订单变更广播载荷。
+ * 用于保留原有全量列表通知能力，同时让订阅方可按 changedOrders 做增量处理。
+ *
+ * @example
+ * const changedOrders = payload.changedOrders
+ */
+export interface OrderChangedPayload {
+    /** 当前订单 store 全量列表，兼容既有重算列表订阅 */
+    list: OrderData[];
+    /** 本次明确发生变更的订单；全量刷新等无法确定 delta 的场景可为空 */
+    changedOrders: OrderData[];
+    /** 触发来源，便于订阅者区分 pubsub / 远端覆盖 / 清空等场景 */
+    source?: string;
+}
 /**
  * OrderSyncMessage - pubsub 同步消息结构
  */

package/dist/server/modules/order/types.js

@@ -127,6 +127,14 @@
  * Ably 事件载荷
  */
 
+/**
+ * 订单变更广播载荷。
+ * 用于保留原有全量列表通知能力，同时让订阅方可按 changedOrders 做增量处理。
+ *
+ * @example
+ * const changedOrders = payload.changedOrders
+ */
+
 /**
  * OrderSyncMessage - pubsub 同步消息结构
  */

package/dist/server/modules/order/utils/filterBookings.js

@@ -54,6 +54,29 @@ function bookingDateTimeString(datePart, timePart) {
   }
   return "".concat(d, " ").concat(t).trim();
 }
+
+/**
+ * 解析预约自身的起止时间区间，供 `sales_time_between` 做区间重叠匹配。
+ *
+ * @example
+ * const span = resolveBookingTimeRange({ start_date: '2026-06-09', start_time: '10:00', end_date: '2026-06-15', end_time: '10:00' })
+ */
+function resolveBookingTimeRange(booking) {
+  var start = toTimestamp(bookingDateTimeString(booking.start_date, booking.start_time));
+  if (!start) return null;
+  var end = toTimestamp(bookingDateTimeString(booking.end_date || booking.start_date, booking.end_time || booking.start_time)) || start;
+  return end >= start ? [start, end] : [end, start];
+}
+
+/**
+ * 判断两个闭区间是否有交集。
+ *
+ * @example
+ * isRangeOverlapping([1, 10], [5, 6]) // true
+ */
+function isRangeOverlapping(left, right) {
+  return left[0] <= right[1] && left[1] >= right[0];
+}
 function parseDateRange(range) {
   if (!Array.isArray(range) || range.length < 2) return null;
   var start = toRangeBoundary(range[0], false);
@@ -151,7 +174,7 @@ function matchOrder(order, ctx) {
 // ─────────────────────────────────────────────────────────────────
 
 function matchBooking(booking, orderInfo, ctx) {
-  if (ctx.enableChildBookingFilter) {
+  if (ctx.enableChildBookingFilter && booking.booking_id) {
     var _parent_id, _item_type;
     var parentId = Number((_parent_id = booking.parent_id) !== null && _parent_id !== void 0 ? _parent_id : 0);
     var itemType = String((_item_type = booking.item_type) !== null && _item_type !== void 0 ? _item_type : '');
@@ -160,8 +183,8 @@ function matchBooking(booking, orderInfo, ctx) {
   }
   if (ctx.appointmentStatusSet && !ctx.appointmentStatusSet.has(getBookingAppointmentStatus(booking))) return false;
   if (ctx.bookingTimeRange) {
-    var ts = toTimestamp(bookingDateTimeString(booking.start_date, booking.start_time));
-    if (ts < ctx.bookingTimeRange[0] || ts > ctx.bookingTimeRange[1]) return false;
+    var bookingRange = resolveBookingTimeRange(booking);
+    if (!bookingRange || !isRangeOverlapping(bookingRange, ctx.bookingTimeRange)) return false;
   }
   if (ctx.afterExecutionTimeMs != null) {
     var bookingStartMs = toTimestamp(bookingDateTimeString(booking.start_date, booking.start_time));

package/dist/server/modules/order/utils/filterOrders.js

@@ -1,4 +1,17 @@
 import dayjs from 'dayjs';
+/** 从订单 payments 提取支付方式 code，与 UI 筛选选项及 filterBookings 一致 */
+function getOrderPaymentCodes(order) {
+  var payments = order.payments;
+  if (!Array.isArray(payments) || payments.length === 0) {
+    return [];
+  }
+  return payments.map(function (item) {
+    return item === null || item === void 0 ? void 0 : item.code;
+  }).filter(function (code) {
+    return typeof code === 'string' && code.length > 0;
+  });
+}
+
 /**
  * 订单过滤函数
  * @param orders 原始订单列表
@@ -126,22 +139,23 @@ export function filterOrders(orders, filters) {
       }
     }
 
-    // payment_methods - 支付方式
+    // payment_methods - 支付方式（按 payments[].code 匹配，不再使用 order.payment_methods）
     if (safeFilters.payment_methods && safeFilters.payment_methods.length > 0) {
-      if (!order.payment_methods || !Array.isArray(order.payment_methods) || order.payment_methods.length === 0) {
+      var orderPaymentCodes = getOrderPaymentCodes(order);
+      if (orderPaymentCodes.length === 0) {
         rejected.push({
           order_id: order.order_id,
           order_number: order.order_number,
           reason: {
             field: 'payment_methods',
-            actual: order.payment_methods,
+            actual: order.payments,
             expected: safeFilters.payment_methods
           }
         });
         return false;
       }
-      var hasMatch = order.payment_methods.some(function (pm) {
-        return safeFilters.payment_methods.includes(pm);
+      var hasMatch = orderPaymentCodes.some(function (code) {
+        return safeFilters.payment_methods.includes(code);
       });
       if (!hasMatch) {
         rejected.push({
@@ -149,7 +163,7 @@ export function filterOrders(orders, filters) {
           order_number: order.order_number,
           reason: {
             field: 'payment_methods',
-            actual: order.payment_methods,
+            actual: orderPaymentCodes,
             expected: safeFilters.payment_methods
           }
         });
@@ -348,10 +362,11 @@ export function filterOrders(orders, filters) {
 
     // start_time / end_time - 创建时间范围
     if (safeFilters.start_time || safeFilters.end_time) {
+      var isCreatedIsUndefined = order.created_at === undefined;
       // 统一用 dayjs 按本地时区解析，避免 new Date("YYYY-MM-DD") 被当作 UTC 0 点
       // 与含时分的本地时间字符串比较时产生时区错位
       var orderTime = order.created_at ? typeof order.created_at === 'number' ? order.created_at : dayjs(String(order.created_at)).valueOf() : 0;
-      if (safeFilters.start_time) {
+      if (safeFilters.start_time && !isCreatedIsUndefined) {
         var startTs = dayjs(safeFilters.start_time).startOf('day').valueOf();
         if (orderTime < startTs) {
           rejected.push({
@@ -366,7 +381,7 @@ export function filterOrders(orders, filters) {
           return false;
         }
       }
-      if (safeFilters.end_time) {
+      if (safeFilters.end_time && !isCreatedIsUndefined) {
         var endTs = dayjs(safeFilters.end_time).endOf('day').valueOf();
         if (orderTime > endTs) {
           rejected.push({

package/dist/server/modules/payment/index.d.ts

@@ -0,0 +1,28 @@
+import { Module, ModuleOptions, PisellCore } from '../../../types';
+import { BaseModule } from '../../../modules/BaseModule';
+import type { PaymentMethod } from './types';
+export declare class PaymentServerModule extends BaseModule implements Module {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    private request;
+    private app;
+    private logger;
+    private store;
+    private payMethodMemoryCache;
+    private payMethodListInFlight;
+    constructor(name?: string, version?: string);
+    initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
+    getPayMethodListAsync(options?: {
+        shouldFilter?: boolean;
+    }): Promise<PaymentMethod[]>;
+    clearPayMethodCache(): void;
+    private loadPayMethodListAsync;
+    private fetchRemotePayMethods;
+    private shouldFilterPayMethods;
+    private resolvePayMethods;
+    private filterPayMethods;
+    private setPayMethodCache;
+    private logInfo;
+    private logWarning;
+    private logError;
+}

package/dist/server/modules/payment/index.js

@@ -0,0 +1,305 @@
+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 _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+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); }
+import { BaseModule } from "../../../modules/BaseModule";
+var WALLET_PASS_CODE = 'WALLET_PASS';
+var WALLET_DEPENDENT_CODES = new Set(['PRODUCTVOUCHER', 'GIFTCARD', 'POINTCARD']);
+var PAYMENT_METHODS_LOADED_EVENT = 'payment:onPaymentMethodsLoaded';
+export var PaymentServerModule = /*#__PURE__*/function (_BaseModule) {
+  _inherits(PaymentServerModule, _BaseModule);
+  var _super = _createSuper(PaymentServerModule);
+  function PaymentServerModule(name, version) {
+    var _this;
+    _classCallCheck(this, PaymentServerModule);
+    _this = _super.call(this, name || 'payment', version);
+    _defineProperty(_assertThisInitialized(_this), "defaultName", 'payment');
+    _defineProperty(_assertThisInitialized(_this), "defaultVersion", '1.0.0');
+    _defineProperty(_assertThisInitialized(_this), "request", void 0);
+    _defineProperty(_assertThisInitialized(_this), "app", void 0);
+    _defineProperty(_assertThisInitialized(_this), "logger", void 0);
+    _defineProperty(_assertThisInitialized(_this), "store", void 0);
+    _defineProperty(_assertThisInitialized(_this), "payMethodMemoryCache", null);
+    _defineProperty(_assertThisInitialized(_this), "payMethodListInFlight", null);
+    return _this;
+  }
+  _createClass(PaymentServerModule, [{
+    key: "initialize",
+    value: function () {
+      var _initialize = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(core, options) {
+        var _this$app, _this$app2, _this$app3;
+        var appPlugin;
+        return _regeneratorRuntime().wrap(function _callee$(_context) {
+          while (1) switch (_context.prev = _context.next) {
+            case 0:
+              this.core = core;
+              this.store = options === null || options === void 0 ? void 0 : options.store;
+              if (!this.store) this.store = {
+                payMethods: []
+              };
+              if (!Array.isArray(this.store.payMethods)) this.store.payMethods = [];
+              this.request = core.getPlugin('request');
+              appPlugin = core.getPlugin('app');
+              this.app = appPlugin === null || appPlugin === void 0 ? void 0 : appPlugin.getApp();
+              this.logger = (_this$app = this.app) === null || _this$app === void 0 ? void 0 : _this$app.logger;
+              if (!(!this.request && !((_this$app2 = this.app) !== null && _this$app2 !== void 0 && _this$app2.request))) {
+                _context.next = 10;
+                break;
+              }
+              throw new Error('PaymentServerModule 需要 request 插件或 app.request 支持');
+            case 10:
+              this.logInfo('PaymentServerModule initialized successfully', {
+                hasAppRequest: !!((_this$app3 = this.app) !== null && _this$app3 !== void 0 && _this$app3.request)
+              });
+            case 11:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee, this);
+      }));
+      function initialize(_x, _x2) {
+        return _initialize.apply(this, arguments);
+      }
+      return initialize;
+    }() // getRoutes(): RouteDefinition[] {
+    //   return [
+    //     {
+    //       method: 'get',
+    //       path: '/pay/custom-payment/all',
+    //       handler: async ({ data, config }) => {
+    //         const payMethods = await this.getPayMethodListAsync({
+    //           shouldFilter: this.shouldFilterPayMethods(data, config),
+    //         });
+    //         return {
+    //           code: 200,
+    //           status: true,
+    //           data: payMethods,
+    //         };
+    //       },
+    //     },
+    //   ];
+    // }
+  }, {
+    key: "getPayMethodListAsync",
+    value: function () {
+      var _getPayMethodListAsync = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+        var _this$payMethodMemory,
+          _this2 = this;
+        var options,
+          _payMethods,
+          payMethods,
+          _args2 = arguments;
+        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              options = _args2.length > 0 && _args2[0] !== undefined ? _args2[0] : {};
+              this.logInfo('Starting getPayMethodListAsync');
+              if (!((_this$payMethodMemory = this.payMethodMemoryCache) !== null && _this$payMethodMemory !== void 0 && _this$payMethodMemory.length)) {
+                _context2.next = 4;
+                break;
+              }
+              return _context2.abrupt("return", this.resolvePayMethods(this.payMethodMemoryCache, options));
+            case 4:
+              if (!this.payMethodListInFlight) {
+                _context2.next = 9;
+                break;
+              }
+              _context2.next = 7;
+              return this.payMethodListInFlight;
+            case 7:
+              _payMethods = _context2.sent;
+              return _context2.abrupt("return", this.resolvePayMethods(_payMethods, options));
+            case 9:
+              this.payMethodListInFlight = this.loadPayMethodListAsync().finally(function () {
+                _this2.payMethodListInFlight = null;
+              });
+              _context2.next = 12;
+              return this.payMethodListInFlight;
+            case 12:
+              payMethods = _context2.sent;
+              return _context2.abrupt("return", this.resolvePayMethods(payMethods, options));
+            case 14:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2, this);
+      }));
+      function getPayMethodListAsync() {
+        return _getPayMethodListAsync.apply(this, arguments);
+      }
+      return getPayMethodListAsync;
+    }()
+  }, {
+    key: "clearPayMethodCache",
+    value: function clearPayMethodCache() {
+      this.payMethodMemoryCache = null;
+      this.store.payMethods = [];
+    }
+  }, {
+    key: "loadPayMethodListAsync",
+    value: function () {
+      var _loadPayMethodListAsync = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
+        var payMethods;
+        return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+          while (1) switch (_context3.prev = _context3.next) {
+            case 0:
+              _context3.prev = 0;
+              _context3.next = 3;
+              return this.fetchRemotePayMethods();
+            case 3:
+              payMethods = _context3.sent;
+              this.setPayMethodCache(payMethods);
+              _context3.next = 7;
+              return this.core.effects.emit(PAYMENT_METHODS_LOADED_EVENT, payMethods);
+            case 7:
+              this.logInfo('getPayMethodListAsync completed successfully', {
+                payMethods: payMethods
+              });
+              return _context3.abrupt("return", payMethods);
+            case 11:
+              _context3.prev = 11;
+              _context3.t0 = _context3["catch"](0);
+              console.error('[PaymentServerModule] 获取支付方式列表失败', _context3.t0);
+              this.logError('getPayMethodListAsync failed', _context3.t0);
+              return _context3.abrupt("return", []);
+            case 16:
+            case "end":
+              return _context3.stop();
+          }
+        }, _callee3, this, [[0, 11]]);
+      }));
+      function loadPayMethodListAsync() {
+        return _loadPayMethodListAsync.apply(this, arguments);
+      }
+      return loadPayMethodListAsync;
+    }()
+  }, {
+    key: "fetchRemotePayMethods",
+    value: function () {
+      var _fetchRemotePayMethods = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
+        var _this$app4;
+        var requester, response, payMethods;
+        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
+            case 0:
+              requester = ((_this$app4 = this.app) === null || _this$app4 === void 0 ? void 0 : _this$app4.request) || this.request;
+              _context4.next = 3;
+              return requester.get('/shop/pay/custom-payment/all', undefined);
+            case 3:
+              response = _context4.sent;
+              payMethods = (response === null || response === void 0 ? void 0 : response.data) || response || [];
+              return _context4.abrupt("return", Array.isArray(payMethods) ? payMethods : []);
+            case 6:
+            case "end":
+              return _context4.stop();
+          }
+        }, _callee4, this);
+      }));
+      function fetchRemotePayMethods() {
+        return _fetchRemotePayMethods.apply(this, arguments);
+      }
+      return fetchRemotePayMethods;
+    }()
+  }, {
+    key: "shouldFilterPayMethods",
+    value: function shouldFilterPayMethods(data, config) {
+      return (data === null || data === void 0 ? void 0 : data.filterPaymentMethods) === true || (config === null || config === void 0 ? void 0 : config.filterPaymentMethods) === true;
+    }
+  }, {
+    key: "resolvePayMethods",
+    value: function resolvePayMethods(payMethods, options) {
+      if (!options.shouldFilter) return payMethods;
+      return this.filterPayMethods(payMethods);
+    }
+  }, {
+    key: "filterPayMethods",
+    value: function filterPayMethods(payMethods) {
+      if (!Array.isArray(payMethods)) return [];
+      var availableMethods = payMethods.filter(function (method) {
+        return method.status === 1 && method.disable === 0;
+      });
+      var walletPassMethod = availableMethods.find(function (method) {
+        return method.code === WALLET_PASS_CODE;
+      });
+      if (!walletPassMethod) {
+        return availableMethods.filter(function (method) {
+          return !WALLET_DEPENDENT_CODES.has(method.code);
+        });
+      }
+      availableMethods = availableMethods.map(function (method) {
+        if (!WALLET_DEPENDENT_CODES.has(method.code)) return method;
+        return _objectSpread(_objectSpread({}, method), {}, {
+          channel_application: walletPassMethod.channel_application
+        });
+      });
+      return availableMethods;
+    }
+  }, {
+    key: "setPayMethodCache",
+    value: function setPayMethodCache(payMethods) {
+      this.payMethodMemoryCache = payMethods;
+      this.store.payMethods = payMethods;
+    }
+  }, {
+    key: "logInfo",
+    value: function logInfo(title, metadata) {
+      try {
+        if (this.logger) {
+          this.logger.addLog({
+            type: 'info',
+            title: "[PaymentServerModule] ".concat(title),
+            metadata: metadata || {}
+          });
+        }
+      } catch (_unused) {
+        // 日志记录失败不影响主流程
+      }
+    }
+  }, {
+    key: "logWarning",
+    value: function logWarning(title, metadata) {
+      try {
+        if (this.logger) {
+          this.logger.addLog({
+            type: 'warning',
+            title: "[PaymentServerModule] ".concat(title),
+            metadata: metadata || {}
+          });
+        }
+      } catch (_unused2) {
+        // 日志记录失败不影响主流程
+      }
+    }
+  }, {
+    key: "logError",
+    value: function logError(title, metadata) {
+      try {
+        if (this.logger) {
+          this.logger.addLog({
+            type: 'error',
+            title: "[PaymentServerModule] ".concat(title),
+            metadata: metadata || {}
+          });
+        }
+      } catch (_unused3) {
+        // 日志记录失败不影响主流程
+      }
+    }
+  }]);
+  return PaymentServerModule;
+}(BaseModule);

package/dist/server/modules/payment/types.d.ts

@@ -0,0 +1,9 @@
+import type { PaymentMethod } from '../../../modules/Payment/types';
+export interface PaymentServerState {
+    payMethods: PaymentMethod[];
+}
+export interface PaymentMethodsChangedEventData {
+    oldMethods: PaymentMethod[];
+    newMethods: PaymentMethod[];
+}
+export type { PaymentMethod };

package/dist/server/modules/payment/types.js

@@ -0,0 +1 @@
+export {};

package/dist/server/modules/products/index.d.ts

@@ -21,12 +21,18 @@ export declare class ProductsModule extends BaseModule implements Module {
     private isPriceFormatterRegistered;
     private quotationPriceBridge?;
     private quotationBridgeChannel?;
-    private quotationBridgeCustomerId?;
+    private quotationBridgeLoadedKey?;
     private quotationBridgeRefreshPromise?;
     private quotationBridgeRefreshKey?;
     private productDataSource;
     private pendingSyncMessages;
     private syncTimer?;
+    /** 最近一次 SSE 全量拉取完成时间 */
+    private lastServerFullFetchAtMs;
+    /** 最近一次 preload 完成时间（含 IndexDB 命中） */
+    private lastPreloadCompletedAtMs;
+    /** IndexDB 写入串行队列，避免快照与 patch 并发交错 */
+    private productIndexDBSaveQueue;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: any): Promise<void>;
     /**
@@ -209,10 +215,28 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     private loadProductsFromIndexDB;
     /**
-     * 保存商品数据到 IndexDB（平铺存储）
-     * @private
+     * 串行执行商品 IndexDB 写入，避免快照替换与增量 patch 并发交错。
+     *
+     * @example
+     * await this.runInProductIndexDBSaveQueue(async () => {
+     *   await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products)
+     * })
+     */
+    private runInProductIndexDBSaveQueue;
+    /**
+     * 全量快照写入 IndexDB：clear + bulkUpdate，仅用于 SSE/HTTP 全量拉取。
+     *
+     * @example
+     * await this.replaceProductsSnapshotInIndexDB(list, 'loadProductsByServer')
      */
-    private saveProductsToIndexDB;
+    private replaceProductsSnapshotInIndexDB;
+    /**
+     * 增量 upsert 商品到 IndexDB，不清空表；用于 pubsub 批次合并后的变更商品。
+     *
+     * @example
+     * await this.patchProductsInIndexDB(changedProducts, 'pubsub.processProductSyncMessages', mergeActions)
+     */
+    private patchProductsInIndexDB;
     /**
      * 同步更新商品 Map 缓存
      * 将 list 中的商品同步到 map，以 id 为 key
@@ -262,14 +286,17 @@ export declare class ProductsModule extends BaseModule implements Module {
     /**
      * 将 body 完整数据直接覆盖到本地 store（不调用报价单接口）
      * 已存在的 → 直接替换；不存在的 → 追加
-     * 同时更新 Map 缓存、IndexDB，触发 onProductsChanged
-     * 价格缓存由 processProductSyncMessages 末尾统一清除
+     *
+     * @example
+     * await this.applyBodyUpdatesToStore(bodyUpdates, { skipIndexDB: true })
      */
     private applyBodyUpdatesToStore;
     /**
      * 将增量拉取的商品合并到 store
      * 已存在的 → 替换；新的 → 追加
-     * 同时更新 store.map、IndexDB，触发 onProductsChanged
+     *
+     * @example
+     * await this.mergeProductsToStore(freshProducts, { skipIndexDB: true })
      */
     private mergeProductsToStore;
     /**