@pisell/pisellos 2.2.315 → 2.2.316

package/lib/server/modules/products/index.js

@@ -5,9 +5,11 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.ProductsModule = void 0;
 var _BaseModule = require("../../../modules/BaseModule");
+var _utils = require("../../../modules/Holder/utils");
 var _Quotation = require("../../../modules/Quotation");
 var _types = require("./types");
 var _product = require("../../utils/product");
+var _replication = require("./replication");
 /**
  * IndexDB 存储名称
  */
@@ -68,6 +70,119 @@ class ProductsModule extends _BaseModule.BaseModule {
 
   /** 最近一次智能定价评估提取的 schedule 变价时间点（HH:mm），供 Server 订阅定时刷新使用 */
   lastScheduleTimePoints = [];
+  committedProductState;
+  productReplicationSourceGeneration = 0;
+  productPersistenceFailed = false;
+  runtimeSyncMode = 'normal';
+  runtimeSyncGeneration = 0;
+  requestReplicaRefresh;
+  replicaApplyQueue = Promise.resolve();
+  productSyncQueue = Promise.resolve();
+  replicaPriceDirtyIds = new Map();
+
+  /** Installed after initial preload; initial cache/network loading stays unchanged. */
+  async setRuntimeSyncMode(mode, requestRefresh) {
+    this.runtimeSyncGeneration += 1;
+    this.runtimeSyncMode = mode;
+    this.requestReplicaRefresh = requestRefresh;
+    if (mode === 'memoryReplica') {
+      if (this.syncTimer) clearTimeout(this.syncTimer);
+      this.pendingSyncMessages = [];
+      await this.productSyncQueue;
+      await this.productIndexDBSaveQueue;
+    }
+  }
+  isMemoryReplica() {
+    return this.runtimeSyncMode === 'memoryReplica';
+  }
+
+  /** Read persisted data once on the main screen to establish a committed baseline. */
+  async enableProductReplicationSource() {
+    const generation = this.productReplicationSourceGeneration;
+    await this.runInProductIndexDBSaveQueue(async () => {
+      if (generation !== this.productReplicationSourceGeneration) return;
+      if (this.committedProductState) return;
+      if (!this.dbManager || this.productPersistenceFailed) {
+        throw new Error('Product replication requires a successful persistence baseline');
+      }
+      const products = await this.dbManager.getAll(INDEXDB_STORE_NAME);
+      if (generation !== this.productReplicationSourceGeneration) return;
+      if (!Array.isArray(products)) throw new Error('Invalid persisted product snapshot');
+      this.committedProductState = new _replication.CommittedProductState();
+      this.committedProductState.commit({
+        kind: 'snapshot',
+        upserts: products,
+        deletedIds: []
+      });
+    });
+  }
+
+  /** Release the extra catalog without changing the normal product store or persistence. */
+  disableProductReplicationSource() {
+    this.productReplicationSourceGeneration += 1;
+    this.committedProductState = undefined;
+  }
+  getCommittedProductSnapshot() {
+    return this.committedProductState?.snapshot() ?? null;
+  }
+  async recordProductCommit(change) {
+    this.productPersistenceFailed = false;
+    if (!this.committedProductState) return;
+    const committed = this.committedProductState.commit(change);
+    try {
+      await this.core.effects.emit(_types.ProductsHooks.onProductsCommitted, committed);
+    } catch (error) {
+      // Transport failure is not a persistence failure; peers recover using the snapshot.
+      this.logWarning('商品提交通知失败', {
+        revision: committed.revision,
+        error: String(error)
+      });
+    }
+  }
+  async applyReplicatedProducts(change) {
+    if (!this.isMemoryReplica()) throw new Error('Product module is not a memory replica');
+    const generation = this.runtimeSyncGeneration;
+    const apply = async () => {
+      if (!this.isMemoryReplica() || generation !== this.runtimeSyncGeneration) return;
+      const changedIds = [...new Set([...change.deletedIds, ...change.upserts.map(p => p.id)])];
+      if (change.kind === 'snapshot') {
+        this.store.list = change.upserts;
+        this.syncProductsMap();
+        this.clearPriceCache();
+      } else {
+        const removed = new Set(change.deletedIds);
+        const updates = new Map(change.upserts.map(p => [p.id, p]));
+        this.store.list = this.store.list.filter(p => !removed.has(p.id)).map(p => {
+          const next = updates.get(p.id);
+          if (!next) return p;
+          updates.delete(p.id);
+          return next;
+        });
+        this.store.list.push(...updates.values());
+        for (const id of removed) this.store.map.delete(id);
+        for (const product of change.upserts) this.store.map.set(product.id, product);
+        for (const [key, cached] of this.productsPriceCache) {
+          this.productsPriceCache.set(key, cached.filter(p => !removed.has(p.id)));
+          const dirty = this.replicaPriceDirtyIds.get(key) ?? new Set();
+          change.upserts.forEach(p => dirty.add(p.id));
+          removed.forEach(id => dirty.delete(id));
+          this.replicaPriceDirtyIds.set(key, dirty);
+        }
+      }
+      await this.core.effects.emit(_types.ProductsHooks.onProductsChanged, this.store.list);
+      if (generation !== this.runtimeSyncGeneration) return;
+      await this.core.effects.emit(_types.ProductsHooks.onProductsSyncCompleted, {
+        changedIds
+      });
+    };
+    const task = this.replicaApplyQueue.then(apply, apply);
+    this.replicaApplyQueue = task.catch(() => undefined);
+    return task;
+  }
+  async refreshFromReplica(trigger) {
+    await this.requestReplicaRefresh?.(trigger);
+    return this.store.list;
+  }
   constructor(name, version) {
     super(name, version);
   }
@@ -408,7 +523,8 @@ class ProductsModule extends _BaseModule.BaseModule {
     const scopedProductIds = this.normalizeProductIds(options?.productIds);
     const cacheKey = this.getProductsPriceCacheKey(schedule_date, extraContext, scopedProductIds);
     const scopedProductIdSet = scopedProductIds ? new Set(scopedProductIds) : undefined;
-    const changedIds = scopedProductIdSet ? options?.changedIds?.filter(id => scopedProductIdSet.has(id)) : options?.changedIds;
+    const pendingIds = [...new Set([...(options?.changedIds ?? []), ...(this.replicaPriceDirtyIds.get(cacheKey) ?? [])])];
+    const changedIds = scopedProductIdSet ? pendingIds.filter(id => scopedProductIdSet.has(id)) : pendingIds;
     if (this.productsPriceCache.has(cacheKey)) {
       const cachedProducts = this.productsPriceCache.get(cacheKey);
 
@@ -423,7 +539,7 @@ class ProductsModule extends _BaseModule.BaseModule {
           const updatedProducts = await this.prepareProductsWithPrice(schedule_date, extraContext, {
             productIds: changedIds
           });
-          if (updatedProducts.length > 0) {
+          if (updatedProducts.length > 0 || this.isMemoryReplica()) {
             // merge：用更新结果替换缓存中对应的商品，新增的追加
             const updatedMap = new Map(updatedProducts.map(p => [p.id, p]));
             const mergedCache = [];
@@ -431,7 +547,7 @@ class ProductsModule extends _BaseModule.BaseModule {
               if (updatedMap.has(p.id)) {
                 mergedCache.push(updatedMap.get(p.id));
                 updatedMap.delete(p.id);
-              } else {
+              } else if (!this.isMemoryReplica() || !changedIds.includes(p.id)) {
                 mergedCache.push(p);
               }
             }
@@ -440,6 +556,7 @@ class ProductsModule extends _BaseModule.BaseModule {
               mergedCache.push(p);
             }
             this.productsPriceCache.set(cacheKey, mergedCache);
+            this.replicaPriceDirtyIds.delete(cacheKey);
             this.logInfo('增量更新完成', {
               cacheKey,
               changedCount: updatedProducts.length,
@@ -485,6 +602,7 @@ class ProductsModule extends _BaseModule.BaseModule {
       productIds: scopedProductIds
     } : undefined);
     this.productsPriceCache.set(cacheKey, result);
+    this.replicaPriceDirtyIds.delete(cacheKey);
     this.logInfo('商品价格已缓存', {
       cacheKey,
       productCount: result.length
@@ -823,6 +941,7 @@ class ProductsModule extends _BaseModule.BaseModule {
       const keys = Array.from(this.productsPriceCache.keys());
       const oldestKey = keys[0];
       this.productsPriceCache.delete(oldestKey);
+      this.replicaPriceDirtyIds.delete(oldestKey);
     }
   }
 
@@ -832,6 +951,7 @@ class ProductsModule extends _BaseModule.BaseModule {
    */
   clearPriceCache() {
     this.productsPriceCache.clear();
+    this.replicaPriceDirtyIds.clear();
     this.quotationScheduleCache.clear();
     this.quotationScheduleCacheLoaded = false;
   }
@@ -840,6 +960,7 @@ class ProductsModule extends _BaseModule.BaseModule {
    * 通过 ProductDataSource SSE 加载完整商品列表
    */
   async loadProductsByServer(options = {}) {
+    if (this.isMemoryReplica()) return this.refreshFromReplica(options.trigger || 'loadProductsByServer');
     if (!this.productDataSource) {
       this.logWarning('loadProductsByServer: ProductDataSource 不可用');
       return [];
@@ -855,6 +976,7 @@ class ProductsModule extends _BaseModule.BaseModule {
         sse: {}
       });
       const list = productList || [];
+      if (this.isMemoryReplica()) return this.store.list;
       (0, _product.perfMark)('loadProductsByServer.SSE', performance.now() - tSSE, {
         count: list.length
       });
@@ -949,7 +1071,9 @@ class ProductsModule extends _BaseModule.BaseModule {
    * @param params 查询参数
    */
   async loadProductsByServerHttp(params) {
+    if (this.isMemoryReplica()) return this.refreshFromReplica('loadProductsByServerHttp');
     const productList = await this.fetchProductsByHttp(params);
+    if (this.isMemoryReplica()) return this.store.list;
     if (productList.length > 0) {
       await this.replaceProductsSnapshotInIndexDB(productList, 'loadProductsByServerHttp');
       this.lastServerFullFetchAtMs = Date.now();
@@ -983,7 +1107,7 @@ class ProductsModule extends _BaseModule.BaseModule {
       if (!product) continue;
       snapshots[String(id)] = {
         cover: product.cover,
-        holder_config: product.holder_config
+        holder_config: (0, _utils.resolveProductHolderConfig)(product) ?? undefined
       };
     }
     return snapshots;
@@ -1022,7 +1146,11 @@ class ProductsModule extends _BaseModule.BaseModule {
    * 根据 ID 列表删除商品（用于 pubsub 同步删除场景）
    * 同时更新 store.list、store.map、IndexDB 和价格缓存
    */
-  async removeProductsByIds(ids) {
+  async removeProductsByIds(ids, options) {
+    if (this.isMemoryReplica() && !options?.skipIndexDB) {
+      await this.refreshFromReplica('removeProducts');
+      return;
+    }
     const idSet = new Set(ids);
     this.logInfo('removeProductsByIds', {
       ids,
@@ -1032,23 +1160,11 @@ class ProductsModule extends _BaseModule.BaseModule {
     for (const id of ids) {
       this.store.map.delete(id);
     }
-    if (this.dbManager) {
-      try {
-        for (const id of ids) {
-          await this.dbManager.delete(INDEXDB_STORE_NAME, id);
-        }
-      } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        this.logError('removeProductsByIds: IndexDB 删除失败', {
-          ids,
-          error: errorMessage
-        });
-      }
-    }
+    if (!options?.skipIndexDB) await this.persistProductDelta([], ids, 'removeProductsByIds');
     for (const [dateKey, cachedProducts] of this.productsPriceCache.entries()) {
       this.productsPriceCache.set(dateKey, cachedProducts.filter(p => !idSet.has(p.id)));
     }
-    this.core.effects.emit(_types.ProductsHooks.onProductsChanged, this.store.list);
+    if (!options?.skipEmit) this.core.effects.emit(_types.ProductsHooks.onProductsChanged, this.store.list);
     this.logInfo('removeProductsByIds 完成', {
       remaining: this.store.list.length
     });
@@ -1059,6 +1175,7 @@ class ProductsModule extends _BaseModule.BaseModule {
    * 用于 pubsub 同步 create / update / batch_update 场景
    */
   async refreshProducts() {
+    if (this.isMemoryReplica()) return this.refreshFromReplica('refreshProducts');
     const tTotal = performance.now();
     this.logInfo('refreshProducts 开始');
     const products = await this.loadProductsByServer({
@@ -1161,9 +1278,10 @@ class ProductsModule extends _BaseModule.BaseModule {
    * await this.replaceProductsSnapshotInIndexDB(list, 'loadProductsByServer')
    */
   async replaceProductsSnapshotInIndexDB(products, source) {
+    if (this.isMemoryReplica()) return false;
     if (!this.dbManager) {
       this.logWarning('replaceProductsSnapshotInIndexDB: dbManager 不可用');
-      return;
+      return false;
     }
     const enqueuedAt = performance.now();
     let queueWaitMs = 0;
@@ -1192,6 +1310,11 @@ class ProductsModule extends _BaseModule.BaseModule {
             writeDurationMs = +(performance.now() - writeStartedAt).toFixed(2);
           }
         }
+        await this.recordProductCommit({
+          kind: 'snapshot',
+          upserts: products,
+          deletedIds: []
+        });
         const executeDurationMs = +(performance.now() - operationStartedAt).toFixed(2);
         (0, _product.perfMark)('replaceProductsSnapshotInIndexDB', executeDurationMs, {
           count: products.length
@@ -1206,7 +1329,9 @@ class ProductsModule extends _BaseModule.BaseModule {
           totalDurationMs: +(performance.now() - enqueuedAt).toFixed(2)
         });
       });
+      return true;
     } catch (error) {
+      this.productPersistenceFailed = true;
       const errorMessage = error instanceof Error ? error.message : String(error);
       this.logError('全量保存商品到 IndexDB 失败', {
         source,
@@ -1217,52 +1342,51 @@ class ProductsModule extends _BaseModule.BaseModule {
         totalDurationMs: +(performance.now() - enqueuedAt).toFixed(2),
         error: errorMessage
       });
+      return false;
     }
   }
-
-  /**
-   * 增量 upsert 商品到 IndexDB，不清空表；用于 pubsub 批次合并后的变更商品。
-   *
-   * @example
-   * await this.patchProductsInIndexDB(changedProducts, 'pubsub.processProductSyncMessages', mergeActions)
-   */
-  async patchProductsInIndexDB(products, source, mergeActions = {}) {
-    if (!this.dbManager || products.length === 0) {
-      return;
-    }
+  async patchProductsInIndexDB(products, source, _mergeActions = {}) {
+    return this.persistProductDelta(products, [], source);
+  }
+  async persistProductDelta(products, deletedIds, source) {
+    if (this.isMemoryReplica() || !this.dbManager) return false;
     const validProducts = products.filter(p => p?.id !== undefined && p?.id !== null);
-    if (validProducts.length === 0) {
-      return;
-    }
+    if (!validProducts.length && !deletedIds.length) return true;
+    const startedAt = performance.now();
     try {
       await this.runInProductIndexDBSaveQueue(async () => {
-        this.logInfo('patchProductsInIndexDB 开始', {
-          source,
-          count: validProducts.length
-        });
-        const t0 = performance.now();
-        if (typeof this.dbManager.bulkUpdate === 'function') {
-          await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, validProducts);
-        } else if (typeof this.dbManager.update === 'function') {
-          for (const product of validProducts) {
-            await this.dbManager.update(INDEXDB_STORE_NAME, product);
+        for (const id of deletedIds) await this.dbManager.delete(INDEXDB_STORE_NAME, id);
+        if (validProducts.length) {
+          if (typeof this.dbManager.bulkUpdate === 'function') {
+            await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, validProducts);
+          } else if (typeof this.dbManager.update === 'function') {
+            for (const product of validProducts) await this.dbManager.update(INDEXDB_STORE_NAME, product);
+          } else {
+            throw new Error('Product persistence adapter has no upsert method');
           }
         }
-        (0, _product.perfMark)('patchProductsInIndexDB', performance.now() - t0, {
-          count: validProducts.length
+        await this.recordProductCommit({
+          kind: 'delta',
+          upserts: validProducts,
+          deletedIds
         });
         this.logInfo('patchProductsInIndexDB 完成', {
           source,
-          count: validProducts.length
+          productCount: validProducts.length,
+          deletedCount: deletedIds.length,
+          durationMs: Math.round(performance.now() - startedAt)
         });
       });
+      return true;
     } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      this.logError('增量保存商品到 IndexDB 失败', {
+      this.productPersistenceFailed = true;
+      this.logError('增量保存商品失败', {
         source,
-        error: errorMessage,
-        productCount: validProducts.length
+        productCount: validProducts.length,
+        deletedCount: deletedIds.length,
+        error: String(error)
       });
+      return false;
     }
   }
 
@@ -1287,6 +1411,10 @@ class ProductsModule extends _BaseModule.BaseModule {
    * 在模块注册后自动调用
    */
   async preload() {
+    if (this.isMemoryReplica()) {
+      await this.refreshFromReplica('preload');
+      return;
+    }
     const tTotal = performance.now();
     this.logInfo('开始预加载数据');
     try {
@@ -1391,6 +1519,7 @@ class ProductsModule extends _BaseModule.BaseModule {
       return;
     }
     const createHandler = channelKey => message => {
+      if (this.isMemoryReplica()) return;
       const data = message?.data || message;
       if (!data) return;
       this.logInfo('收到同步消息', {
@@ -1449,14 +1578,25 @@ class ProductsModule extends _BaseModule.BaseModule {
    * 处理完成后 emit onProductsSyncCompleted（携带 changedIds），
    * Server 层监听该事件后对变更商品增量执行 prepareProductsWithPrice 并更新缓存
    */
-  async processProductSyncMessages() {
+  processProductSyncMessages() {
+    const run = () => this.processProductSyncBatch();
+    const task = this.productSyncQueue.then(run, run);
+    this.productSyncQueue = task.catch(error => {
+      this.logError('商品同步批次失败', {
+        error: String(error)
+      });
+    });
+    return this.productSyncQueue;
+  }
+  async processProductSyncBatch() {
+    if (this.isMemoryReplica()) return;
     const messages = [...this.pendingSyncMessages];
     this.pendingSyncMessages = [];
     if (messages.length === 0) return;
     this.logInfo('processProductSyncMessages: 开始处理', {
       count: messages.length
     });
-    const deleteIds = [];
+    const deleteIds = new Set();
     const bodyUpdates = new Map();
     const sseRefreshIds = [];
     const priceRefreshIds = [];
@@ -1469,10 +1609,18 @@ class ProductsModule extends _BaseModule.BaseModule {
         }
         // 1. 删除场景：operation === 'delete' 或 action === 'delete'
         if (msg.operation === 'delete' || msg.action === 'delete') {
-          if (msg.ids?.length) deleteIds.push(...msg.ids);else if (msg.id) deleteIds.push(msg.id);
+          const ids = msg.ids?.length ? msg.ids : msg.id ? [msg.id] : [];
+          for (const id of ids) {
+            deleteIds.add(id);
+            bodyUpdates.delete(id);
+          }
           continue;
         }
 
+        // The last explicit product operation wins within the existing sync batch.
+        for (const id of msg.ids || (msg.id ? [msg.id] : [])) deleteIds.delete(id);
+        if (msg.body?.id) deleteIds.delete(msg.body.id);
+
         // 2. change_types 包含 price → 仅收集需要刷新价格的 IDs（不走 SSE 拉取）
         if (msg.change_types?.includes('price')) {
           const ids = msg.ids || (msg.id ? [msg.id] : []);
@@ -1513,18 +1661,20 @@ class ProductsModule extends _BaseModule.BaseModule {
         }
       }
     }
-    const uniqueDeleteIds = [...new Set(deleteIds)];
-    const uniqueSSEIds = [...new Set(sseRefreshIds)];
-    const uniquePriceIds = [...new Set(priceRefreshIds)];
+    const uniqueDeleteIds = [...deleteIds];
+    const uniqueSSEIds = [...new Set(sseRefreshIds)].filter(id => !deleteIds.has(id));
+    const uniquePriceIds = [...new Set(priceRefreshIds)].filter(id => !deleteIds.has(id));
 
     // 1. 处理删除
     if (uniqueDeleteIds.length > 0) {
-      await this.removeProductsByIds(uniqueDeleteIds);
+      await this.removeProductsByIds(uniqueDeleteIds, {
+        skipIndexDB: true,
+        skipEmit: true
+      });
     }
 
     /** 本批次待 patch 的商品（按 id 去重，SSE 覆盖 body） */
     const patchProductMap = new Map();
-    const patchMergeActions = {};
     let storeMutated = uniqueDeleteIds.length > 0;
 
     // 2. 处理 body 直接覆盖（仅内存，IndexDB 批次末统一 patch）
@@ -1535,7 +1685,6 @@ class ProductsModule extends _BaseModule.BaseModule {
       });
       for (const product of bodyResult.changedProducts) {
         patchProductMap.set(product.id, product);
-        patchMergeActions[product.id] = bodyResult.mergeActions[product.id];
       }
       storeMutated = true;
     }
@@ -1551,7 +1700,6 @@ class ProductsModule extends _BaseModule.BaseModule {
         });
         for (const product of mergeResult.changedProducts) {
           patchProductMap.set(product.id, product);
-          patchMergeActions[product.id] = mergeResult.mergeActions[product.id];
         }
         storeMutated = true;
       }
@@ -1561,8 +1709,14 @@ class ProductsModule extends _BaseModule.BaseModule {
       });
     }
     const patchProducts = [...patchProductMap.values()];
-    if (patchProducts.length > 0) {
-      await this.patchProductsInIndexDB(patchProducts, 'pubsub.processProductSyncMessages', patchMergeActions);
+    // Publish one committed delta for the entire batch, including deletions and price-only IDs.
+    const committedUpserts = new Map(patchProducts.map(p => [p.id, p]));
+    for (const id of uniquePriceIds) {
+      const product = this.store.map.get(id);
+      if (product && !uniqueDeleteIds.includes(id)) committedUpserts.set(id, product);
+    }
+    if (committedUpserts.size || uniqueDeleteIds.length) {
+      await this.persistProductDelta([...committedUpserts.values()], uniqueDeleteIds, 'pubsub.batch');
     }
     if (storeMutated) {
       this.core.effects.emit(_types.ProductsHooks.onProductsChanged, this.store.list);
@@ -1761,6 +1915,7 @@ class ProductsModule extends _BaseModule.BaseModule {
    * @returns 刷新后的商品列表
    */
   async silentRefresh(options = {}) {
+    if (this.isMemoryReplica()) return this.refreshFromReplica(options.trigger || 'background');
     const t0 = performance.now();
     const now = Date.now();
     const trigger = options.trigger || 'background';
@@ -1820,6 +1975,9 @@ class ProductsModule extends _BaseModule.BaseModule {
    * 销毁同步资源（取消 pubsub 订阅、清除定时器）
    */
   destroyProductSync() {
+    void this.core.effects.emit(_types.ProductsHooks.onProductSyncDestroyed, null);
+    this.disableProductReplicationSource();
+    this.requestReplicaRefresh = undefined;
     if (this.syncTimer) {
       clearTimeout(this.syncTimer);
       this.syncTimer = undefined;
@@ -1830,6 +1988,11 @@ class ProductsModule extends _BaseModule.BaseModule {
     this.pendingSyncMessages = [];
     this.logInfo('destroyProductSync: 同步资源已销毁');
   }
+  destroy() {
+    this.runtimeSyncGeneration += 1;
+    this.destroyProductSync();
+    super.destroy();
+  }
 
   /**
    * 获取模块的路由定义

package/lib/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/lib/server/modules/products/replication.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CommittedProductState = void 0;
+/** A separate committed view: failed writes must never leak into recovery snapshots. */
+class CommittedProductState {
+  products = new Map();
+  revision = 0;
+  commit(change) {
+    const copy = structuredClone(change);
+    if (copy.kind === 'snapshot') this.products.clear();
+    for (const id of copy.deletedIds) this.products.delete(id);
+    for (const product of copy.upserts) this.products.set(product.id, product);
+    return {
+      ...copy,
+      revision: ++this.revision
+    };
+  }
+  snapshot() {
+    return {
+      kind: 'snapshot',
+      revision: this.revision,
+      upserts: structuredClone([...this.products.values()]),
+      deletedIds: []
+    };
+  }
+}
+exports.CommittedProductState = CommittedProductState;

package/lib/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/lib/server/modules/products/types.js

@@ -13,6 +13,7 @@ exports.ProductsHooks = void 0;
 /**
  * 商品轻量查询范围
  */
+/** Raw product data only; each screen applies its own query/pricing context. */
 /**
  * 加载报价单商品价格参数
  */
@@ -34,6 +35,8 @@ let ProductsHooks = exports.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;
 }({});
 /** pubsub 商品同步消息结构 */