@pisell/pisellos 2.3.166 → 2.3.168

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

@@ -0,0 +1,8 @@
+import type { CommittedProducts, ReplicatedProducts } from './types';
+/** A separate committed view: failed writes must never leak into recovery snapshots. */
+export declare class CommittedProductState {
+    private products;
+    private revision;
+    commit(change: ReplicatedProducts): CommittedProducts;
+    snapshot(): CommittedProducts;
+}

package/dist/server/modules/products/replication.js

@@ -0,0 +1,69 @@
+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 _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 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 _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; }
+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 _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); }
+/** A separate committed view: failed writes must never leak into recovery snapshots. */
+export var CommittedProductState = /*#__PURE__*/function () {
+  function CommittedProductState() {
+    _classCallCheck(this, CommittedProductState);
+    _defineProperty(this, "products", new Map());
+    _defineProperty(this, "revision", 0);
+  }
+  _createClass(CommittedProductState, [{
+    key: "commit",
+    value: function commit(change) {
+      var copy = structuredClone(change);
+      if (copy.kind === 'snapshot') this.products.clear();
+      var _iterator = _createForOfIteratorHelper(copy.deletedIds),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var id = _step.value;
+          this.products.delete(id);
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      var _iterator2 = _createForOfIteratorHelper(copy.upserts),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var product = _step2.value;
+          this.products.set(product.id, product);
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+      return _objectSpread(_objectSpread({}, copy), {}, {
+        revision: ++this.revision
+      });
+    }
+  }, {
+    key: "snapshot",
+    value: function snapshot() {
+      return {
+        kind: 'snapshot',
+        revision: this.revision,
+        upserts: structuredClone(_toConsumableArray(this.products.values())),
+        deletedIds: []
+      };
+    }
+  }]);
+  return CommittedProductState;
+}();

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

@@ -32,6 +32,15 @@ export interface ProductSnapshot {
     cover?: ProductData['cover'];
     holder_config?: ProductData['holder_config'];
 }
+/** Raw product data only; each screen applies its own query/pricing context. */
+export interface ReplicatedProducts {
+    kind: 'snapshot' | 'delta';
+    upserts: ProductData[];
+    deletedIds: number[];
+}
+export interface CommittedProducts extends ReplicatedProducts {
+    revision: number;
+}
 /**
  * 加载报价单商品价格参数
  */
@@ -96,7 +105,9 @@ export declare enum ProductsHooks {
     onProductSelected = "products:onProductSelected",
     onProductsPriceApplied = "products:onProductsPriceApplied",
     /** pubsub 同步批次处理完成后触发，Server 层监听此事件重新计算并推送 */
-    onProductsSyncCompleted = "products:onProductsSyncCompleted"
+    onProductsSyncCompleted = "products:onProductsSyncCompleted",
+    onProductsCommitted = "products:onProductsCommitted",
+    onProductSyncDestroyed = "products:onProductSyncDestroyed"
 }
 /** pubsub 商品同步消息结构 */
 export interface ProductSyncMessage {

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

@@ -10,6 +10,8 @@
  * 商品轻量查询范围
  */
 
+/** Raw product data only; each screen applies its own query/pricing context. */
+
 /**
  * 加载报价单商品价格参数
  */
@@ -35,6 +37,8 @@ export var ProductsHooks = /*#__PURE__*/function (ProductsHooks) {
   ProductsHooks["onProductSelected"] = "products:onProductSelected";
   ProductsHooks["onProductsPriceApplied"] = "products:onProductsPriceApplied";
   ProductsHooks["onProductsSyncCompleted"] = "products:onProductsSyncCompleted";
+  ProductsHooks["onProductsCommitted"] = "products:onProductsCommitted";
+  ProductsHooks["onProductSyncDestroyed"] = "products:onProductSyncDestroyed";
   return ProductsHooks;
 }({});
 

package/dist/solution/BookingByStep/index.d.ts

@@ -328,7 +328,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
         date: string;
         status: string;
         week: string;
-        weekNum: 0 | 2 | 1 | 6 | 4 | 5 | 3;
+        weekNum: 0 | 5 | 1 | 2 | 4 | 3 | 6;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;
@@ -347,7 +347,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
         count: number;
         left: number;
         summaryCount: number;
-        status: "lots_of_space" | "filling_up_fast" | "sold_out";
+        status: "sold_out" | "lots_of_space" | "filling_up_fast";
     }[];
     /**
      * 找到多个资源的公共可用时间段

package/dist/solution/ScanOrder/index.js

@@ -2168,7 +2168,7 @@ export var ScanOrderImpl = /*#__PURE__*/function (_BaseSalesImpl) {
     key: "applyPrefillByItemRule",
     value: function () {
       var _applyPrefillByItemRule = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee30() {
-        var strategyConfigs, businessData, prefillItems, productSourceMap, tempOrder, hasChanges, _iterator6, _step6, _prefillItem$product_, _origin2, _origin3, _origin4, prefillItem, productId, productVariantId, targetQuantity, sourceItem, productIndex, _sourceItem$price, sellingPrice, targetProduct, existedQuantity, delta, nextProduct, hasQuantityChanged, hasOriginChanged;
+        var strategyConfigs, businessData, prefillItems, productSourceMap, tempOrder, hasChanges, _iterator6, _step6, _prefillItem$product_, _origin2, _origin3, _origin4, prefillItem, productId, productVariantId, targetQuantity, sourceItem, sourceTitle, productTitle, displayFields, productIndex, _sourceItem$price, sellingPrice, targetProduct, existedQuantity, delta, nextProduct, hasQuantityChanged, hasTitleChanged, hasOriginChanged;
         return _regeneratorRuntime().wrap(function _callee30$(_context30) {
           while (1) switch (_context30.prev = _context30.next) {
             case 0:
@@ -2218,7 +2218,7 @@ export var ScanOrderImpl = /*#__PURE__*/function (_BaseSalesImpl) {
               _iterator6.s();
             case 22:
               if ((_step6 = _iterator6.n()).done) {
-                _context30.next = 47;
+                _context30.next = 51;
                 break;
               }
               prefillItem = _step6.value;
@@ -2229,25 +2229,32 @@ export var ScanOrderImpl = /*#__PURE__*/function (_BaseSalesImpl) {
                 _context30.next = 29;
                 break;
               }
-              return _context30.abrupt("continue", 45);
+              return _context30.abrupt("continue", 49);
             case 29:
               if (!Number.isNaN(productVariantId)) {
                 _context30.next = 31;
                 break;
               }
-              return _context30.abrupt("continue", 45);
+              return _context30.abrupt("continue", 49);
             case 31:
               sourceItem = productSourceMap.get(buildProductKey(productId, productVariantId)) || productSourceMap.get(buildProductKey(productId, 0)) || null;
+              sourceTitle = (sourceItem === null || sourceItem === void 0 ? void 0 : sourceItem.product_title) || (sourceItem === null || sourceItem === void 0 ? void 0 : sourceItem.title) || (sourceItem === null || sourceItem === void 0 ? void 0 : sourceItem.name);
+              productTitle = typeof sourceTitle === 'string' ? {
+                auto: sourceTitle
+              } : sourceTitle; // 标准标题在归一化后补入，供购物车展示，并由 Order 在折扣重算时保留。
+              displayFields = productTitle ? {
+                product_title: productTitle
+              } : {};
               productIndex = getProductIdentityIndex(tempOrder.products, {
                 product_id: productId,
                 product_variant_id: productVariantId
               });
               if (!(productIndex === -1)) {
-                _context30.next = 38;
+                _context30.next = 41;
                 break;
               }
               sellingPrice = toPriceString((_sourceItem$price = sourceItem === null || sourceItem === void 0 ? void 0 : sourceItem.price) !== null && _sourceItem$price !== void 0 ? _sourceItem$price : sourceItem === null || sourceItem === void 0 ? void 0 : sourceItem.selling_price, '0.00');
-              tempOrder.products.push(normalizeOrderProduct(_objectSpread(_objectSpread({}, sourceItem), {}, {
+              tempOrder.products.push(_objectSpread(_objectSpread({}, normalizeOrderProduct(_objectSpread(_objectSpread({}, sourceItem), {}, {
                 product_id: productId,
                 product_variant_id: productVariantId,
                 num: targetQuantity,
@@ -2261,14 +2268,14 @@ export var ScanOrderImpl = /*#__PURE__*/function (_BaseSalesImpl) {
                   item_rule_prefill: true,
                   item_rule_id: prefillItem.ruleId
                 })
-              })));
+              }))), displayFields));
               hasChanges = true;
-              return _context30.abrupt("continue", 45);
-            case 38:
+              return _context30.abrupt("continue", 49);
+            case 41:
               targetProduct = tempOrder.products[productIndex];
               existedQuantity = toNonNegativeInt(targetProduct.num);
               delta = targetQuantity - existedQuantity;
-              nextProduct = _objectSpread(_objectSpread(_objectSpread({}, targetProduct), delta > 0 ? {
+              nextProduct = _objectSpread(_objectSpread(_objectSpread(_objectSpread({}, targetProduct), displayFields), delta > 0 ? {
                 num: getSafeProductNum(existedQuantity + delta)
               } : {}), {}, {
                 metadata: _objectSpread(_objectSpread({}, targetProduct.metadata || {}), {}, {
@@ -2278,52 +2285,53 @@ export var ScanOrderImpl = /*#__PURE__*/function (_BaseSalesImpl) {
                 _origin: sourceItem ? _objectSpread(_objectSpread({}, targetProduct._origin || {}), sourceItem) : targetProduct._origin
               });
               hasQuantityChanged = delta > 0;
+              hasTitleChanged = Boolean(productTitle && JSON.stringify(targetProduct.product_title) !== JSON.stringify(productTitle));
               hasOriginChanged = Boolean(sourceItem && (!targetProduct._origin || ((_origin2 = targetProduct._origin) === null || _origin2 === void 0 ? void 0 : _origin2.name) !== (sourceItem === null || sourceItem === void 0 ? void 0 : sourceItem.name) || ((_origin3 = targetProduct._origin) === null || _origin3 === void 0 ? void 0 : _origin3.title) !== (sourceItem === null || sourceItem === void 0 ? void 0 : sourceItem.title) || ((_origin4 = targetProduct._origin) === null || _origin4 === void 0 ? void 0 : _origin4.price) !== (sourceItem === null || sourceItem === void 0 ? void 0 : sourceItem.price)));
-              if (hasQuantityChanged || hasOriginChanged) {
+              if (hasQuantityChanged || hasTitleChanged || hasOriginChanged) {
                 tempOrder.products[productIndex] = nextProduct;
                 hasChanges = true;
               }
-            case 45:
+            case 49:
               _context30.next = 22;
               break;
-            case 47:
-              _context30.next = 52;
+            case 51:
+              _context30.next = 56;
               break;
-            case 49:
-              _context30.prev = 49;
+            case 53:
+              _context30.prev = 53;
               _context30.t0 = _context30["catch"](20);
               _iterator6.e(_context30.t0);
-            case 52:
-              _context30.prev = 52;
+            case 56:
+              _context30.prev = 56;
               _iterator6.f();
-              return _context30.finish(52);
-            case 55:
+              return _context30.finish(56);
+            case 59:
               if (!hasChanges) {
-                _context30.next = 60;
+                _context30.next = 64;
                 break;
               }
               // Prefill 属于 products CRUD 的一种形式：新增后让 Rules 重算，以支持自动应用可用优惠券。
               this.store.order.applyDiscount();
-              _context30.next = 59;
+              _context30.next = 63;
               return this.store.order.recalculateSummary({
                 createIfMissing: true
               });
-            case 59:
+            case 63:
               this.store.order.persistTempOrder();
-            case 60:
-              _context30.next = 62;
+            case 64:
+              _context30.next = 66;
               return this.refreshItemRuleQuantityLimits();
-            case 62:
+            case 66:
               this.itemRulePrefillApplied = true;
               this.logMethodSuccess('applyPrefillByItemRule', {
                 prefillCount: prefillItems.length,
                 hasChanges: hasChanges
               });
-            case 64:
+            case 68:
             case "end":
               return _context30.stop();
           }
-        }, _callee30, this, [[20, 49, 52, 55]]);
+        }, _callee30, this, [[20, 53, 56, 59]]);
       }));
       function applyPrefillByItemRule() {
         return _applyPrefillByItemRule.apply(this, arguments);

package/dist/solution/ScanOrder/types.d.ts

@@ -1,5 +1,6 @@
 import { OrderModule, ProductList, SalesSummaryModule, ScanOrderLogInput, ScanOrderLoggerModule, ScanOrderLoggerProviderConfig, ScanOrderLoggerProviderType, ScheduleModule } from '../../modules';
 import type { QuantityCheckResult, QuantityLimitResult } from '../../model/strategy/adapter/itemRule';
+import type { OrderLocalizedText } from '../../modules/Order/types';
 /**
  * 扫码下单流程 hook
  */
@@ -43,6 +44,8 @@ export interface ScanOrderProductSku {
 }
 export interface ScanOrderOrderProduct extends ScanOrderOrderProductIdentity {
     order_detail_id: number | null;
+    /** 与 Order 一致的商品展示名称。 */
+    product_title?: OrderLocalizedText;
     num: number;
     /** Product 或当前 Variant 的生产编码 */
     production_code?: string;

package/lib/model/strategy/adapter/promotion/index.js

@@ -1 +1,46 @@
-"use strict";
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "BUY_X_GET_Y_FREE_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.BUY_X_GET_Y_FREE_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "ITEM_REWARD_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.ITEM_REWARD_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "PromotionAdapter", {
+  enumerable: true,
+  get: function () {
+    return _adapter.PromotionAdapter;
+  }
+});
+Object.defineProperty(exports, "PromotionEvaluator", {
+  enumerable: true,
+  get: function () {
+    return _evaluator.PromotionEvaluator;
+  }
+});
+Object.defineProperty(exports, "X_ITEMS_FOR_Y_PRICE_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.X_ITEMS_FOR_Y_PRICE_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _adapter.default;
+  }
+});
+var _evaluator = require("./evaluator");
+var _adapter = _interopRequireWildcard(require("./adapter"));
+var _examples = require("./examples");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }

package/lib/modules/Order/index.d.ts

@@ -595,7 +595,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     generateIdempotencyToken(): string;
     syncPaymentsToOrder<T = any>(params: SyncPaymentsToOrderParams): Promise<SyncPaymentsToOrderResult<T>>;
     createOrder(params: CommitOrderParams['query']): {
-        type: "appointment_booking" | "virtual";
+        type: "virtual" | "appointment_booking";
         platform: string;
         sales_channel: string;
         order_sales_channel: string;

package/lib/server/index.js

@@ -540,7 +540,7 @@ class Server {
 
     // 监听 ProductsModule 同步完成事件，重新计算并推送查询结果
     this.core.effects.on(_types2.ProductsHooks.onProductsSyncCompleted, payload => {
-      this.recomputeAndNotifyProductQuery({
+      return this.recomputeAndNotifyProductQuery({
         changedIds: payload?.changedIds
       });
     });
@@ -6247,7 +6247,7 @@ class Server {
         const result = await this.computeProductQueryResult(subscriber.context, {
           changedIds: options?.changedIds
         });
-        subscriber.callback(result);
+        await subscriber.callback(result);
         this.logInfo('recomputeAndNotifyProductQuery: 已推送', {
           subscriberId
         });

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

@@ -3,6 +3,7 @@ import { BaseModule } from '../../../modules/BaseModule';
 import { ProductData } from '../../../modules/Product/types';
 import type { RouteDefinition } from '../../types';
 import { ProductIdScope, type ProductSnapshot, ProductFormatter, ProductFormatterContext } from './types';
+import type { CommittedProducts, ReplicatedProducts } from './types';
 /**
  * Products 模块 - 用于获取和管理完整的商品详细数据
  * 相比 ProductList 模块，Products 会获取所有详细信息并缓存
@@ -40,6 +41,26 @@ export declare class ProductsModule extends BaseModule implements Module {
     private productIndexDBSaveQueue;
     /** 最近一次智能定价评估提取的 schedule 变价时间点（HH:mm），供 Server 订阅定时刷新使用 */
     private lastScheduleTimePoints;
+    private committedProductState?;
+    private productReplicationSourceGeneration;
+    private productPersistenceFailed;
+    private runtimeSyncMode;
+    private runtimeSyncGeneration;
+    private requestReplicaRefresh?;
+    private replicaApplyQueue;
+    private productSyncQueue;
+    private replicaPriceDirtyIds;
+    /** Installed after initial preload; initial cache/network loading stays unchanged. */
+    setRuntimeSyncMode(mode: 'normal' | 'memoryReplica', requestRefresh?: (trigger: string) => Promise<void>): Promise<void>;
+    isMemoryReplica(): boolean;
+    /** Read persisted data once on the main screen to establish a committed baseline. */
+    enableProductReplicationSource(): Promise<void>;
+    /** Release the extra catalog without changing the normal product store or persistence. */
+    disableProductReplicationSource(): void;
+    getCommittedProductSnapshot(): CommittedProducts | null;
+    private recordProductCommit;
+    applyReplicatedProducts(change: ReplicatedProducts): Promise<void>;
+    private refreshFromReplica;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: any): Promise<void>;
     /**
@@ -230,7 +251,10 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 根据 ID 列表删除商品（用于 pubsub 同步删除场景）
      * 同时更新 store.list、store.map、IndexDB 和价格缓存
      */
-    removeProductsByIds(ids: number[]): Promise<void>;
+    removeProductsByIds(ids: number[], options?: {
+        skipIndexDB?: boolean;
+        skipEmit?: boolean;
+    }): Promise<void>;
     /**
      * 重新从服务器加载全量商品列表并更新本地 store
      * 用于 pubsub 同步 create / update / batch_update 场景
@@ -261,13 +285,8 @@ export declare class ProductsModule extends BaseModule implements Module {
      * await this.replaceProductsSnapshotInIndexDB(list, 'loadProductsByServer')
      */
     private replaceProductsSnapshotInIndexDB;
-    /**
-     * 增量 upsert 商品到 IndexDB，不清空表；用于 pubsub 批次合并后的变更商品。
-     *
-     * @example
-     * await this.patchProductsInIndexDB(changedProducts, 'pubsub.processProductSyncMessages', mergeActions)
-     */
     private patchProductsInIndexDB;
+    private persistProductDelta;
     /**
      * 同步更新商品 Map 缓存
      * 将 list 中的商品同步到 map，以 id 为 key
@@ -309,6 +328,7 @@ export declare class ProductsModule extends BaseModule implements Module {
      * Server 层监听该事件后对变更商品增量执行 prepareProductsWithPrice 并更新缓存
      */
     private processProductSyncMessages;
+    private processProductSyncBatch;
     /**
      * 通过 SSE 按 ids 增量拉取商品数据
      * 请求 GET /shop/core/stream?type=product&ids={ids}
@@ -342,6 +362,7 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 销毁同步资源（取消 pubsub 订阅、清除定时器）
      */
     destroyProductSync(): void;
+    destroy(): void;
     /**
      * 获取模块的路由定义
      * Products 模块暂不提供路由，由 Server 层统一处理