@pisell/pisellos 2.2.78 → 2.2.79

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

@@ -19,6 +19,9 @@ export declare class ProductsModule extends BaseModule implements Module {
     private readonly CACHE_MAX_DAYS;
     private formatters;
     private isPriceFormatterRegistered;
+    private productDataSource;
+    private pendingSyncMessages;
+    private syncTimer?;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: any): Promise<void>;
     /**
@@ -107,26 +110,57 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 可用于手动刷新价格数据
      */
     clearPriceCache(): void;
+    /**
+     * 通过 ProductDataSource SSE 加载完整商品列表
+     */
+    loadProductsByServer(): Promise<any>;
+    /**
+     * 纯请求方法：通过 HTTP 接口获取商品列表（无副作用，不触发事件、不写 IndexDB）
+     * @param params 查询参数
+     * @returns 商品列表
+     */
+    private fetchProductsByHttp;
     /**
      * 加载完整商品列表通过接口（包含所有详细数据）
+     * 包含副作用：保存到 IndexDB + 触发 onProductsLoaded 事件
      * @param params 查询参数
      */
-    loadProductsByServer(params?: {
+    loadProductsByServerHttp(params?: {
         category_ids?: number[];
         product_ids?: number[];
         collection?: number | string[];
         customer_id?: number;
         cacheId?: string;
-    }): Promise<any>;
+    }): Promise<ProductData[]>;
     /**
-     * 获取商品列表（从缓存）
+     * 获取商品列表（深拷贝，供外部安全使用）
      */
     getProducts(): Promise<ProductData[]>;
+    /**
+     * 内部获取商品列表的直接引用（无拷贝）
+     * 仅供内部 formatter 流程使用，因为 formatter 会创建新对象
+     */
+    private getProductsRef;
     /**
      * 根据ID获取单个商品（从内存缓存）
      * 使用 Map 快速查询，时间复杂度 O(1)
      */
     getProductById(id: number): Promise<ProductData | undefined>;
+    /**
+     * 根据 ID 列表删除商品（用于 pubsub 同步删除场景）
+     * 同时更新 store.list、store.map、IndexDB 和价格缓存
+     */
+    removeProductsByIds(ids: number[]): Promise<void>;
+    /**
+     * 重新从服务器加载全量商品列表并更新本地 store
+     * 用于 pubsub 同步 create / update / batch_update 场景
+     */
+    refreshProducts(): Promise<ProductData[]>;
+    /**
+     * 局部更新指定商品的报价单价格
+     * 遍历所有已缓存的日期，为目标商品重新获取价格并覆盖到缓存中
+     */
+    updateProductPriceByIds(ids: number[]): Promise<void>;
     /**
      * 清空缓存
      */
@@ -152,6 +186,70 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 在模块注册后自动调用
      */
     preload(): Promise<void>;
+    /**
+     * 初始化 ProductDataSource 实例
+     * 与 pubsub 订阅和数据获取分开，仅负责创建实例
+     */
+    private initProductDataSource;
+    /**
+     * 初始化 pubsub 订阅，监听管理后台商品变更
+     * 仅负责订阅 product / product_quotation 频道，消息通过防抖合并后批量处理
+     * 数据获取由 loadProductsByServer 单独负责
+     */
+    private setupProductSync;
+    /**
+     * 处理防抖后的同步消息批次
+     *
+     * product 模块：
+     *   - operation === 'delete' → 本地删除
+     *   - 有 body（无 price change_types） → body 完整数据直接覆盖本地
+     *   - change_types 包含 price → SSE 增量拉取 + 刷新报价单价格缓存
+     *   - change_types 仅 stock → 跳过（暂不响应）
+     *
+     * product_collection / product_category / product_quotation：
+     *   - 按 relation_product_ids SSE 拉取受影响商品
+     *   - product_quotation 额外刷新报价单价格缓存
+     *
+     * 处理完成后 emit onProductsSyncCompleted 通知 Server 层
+     */
+    private processProductSyncMessages;
+    /**
+     * 通过 SSE 按 ids 增量拉取商品数据
+     * 请求 GET /shop/core/stream?type=product&ids={ids}
+     */
+    private fetchProductsBySSE;
+    /**
+     * 将 body 完整数据直接覆盖到本地 store（不调用报价单接口）
+     * 已存在的 → 直接替换；不存在的 → 追加
+     * 同时更新 Map 缓存、IndexDB，清空价格缓存，触发 onProductsChanged
+     */
+    private applyBodyUpdatesToStore;
+    /**
+     * 将增量拉取的商品合并到 store
+     * 已存在的 → 替换；新的 → 追加
+     * 同时更新 store.map、IndexDB，触发 onProductsChanged
+     */
+    private mergeProductsToStore;
+    /**
+     * 增量更新价格缓存中变更的商品
+     * 对每个已缓存的日期 key：替换/追加最新商品数据，重新拉取这些 ID 的价格并应用
+     */
+    private updatePriceCacheForProducts;
+    /**
+     * 全量重新拉取报价单价格并重建价格缓存
+     * 遍历当前已缓存的所有日期 key，对每个日期重新调用 loadProductsPrice
+     */
+    private refreshAllPriceCache;
+    /**
+     * 静默全量刷新：后台重新拉取全量 SSE 数据并更新本地
+     * 拿到完整数据后一次性替换 store，清除价格缓存，触发 onProductsSyncCompleted
+     * @returns 刷新后的商品列表
+     */
+    silentRefresh(): Promise<ProductData[]>;
+    /**
+     * 销毁同步资源（取消 pubsub 订阅、清除定时器）
+     */
+    destroyProductSync(): void;
     /**
      * 获取模块的路由定义
      * Products 模块暂不提供路由，由 Server 层统一处理