@pisell/pisellos 2.2.190 → 2.2.192

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

@@ -94,8 +94,6 @@ export interface OrderProductLineItem {
     num: number;
     /** 多规格 ID。来源：Detail.product_variant_id */
     product_variant_id?: number;
-    /** 选项配置 */
-    product_option_item?: unknown[];
     /**
      * 销售单价（交易快照，仅输出）。
      * 来源：Detail.selling_price

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

@@ -27,6 +27,12 @@ export declare class ProductsModule extends BaseModule implements Module {
     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;
     /**