@pisell/pisellos 2.3.59 → 2.3.60

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

@@ -525,6 +525,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     return DEFAULT_ORDER_SYNC_THROTTLE_MS;
   }
   async preload() {
+    const preloadStartedAt = Date.now();
     let cachedOrders = null;
     if (this.dbManager) {
       try {
@@ -544,13 +545,27 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       this.syncOrdersMap();
       await this.core.effects.emit(import_types.OrderHooks.onOrdersLoaded, this.store.list);
       await this.emitOrdersChanged([], "preload.sqlite");
+      this.logInfo("预加载完成", {
+        trigger: "preload",
+        source: "SQLite",
+        orderCount: this.store.list.length,
+        duration: `${Date.now() - preloadStartedAt}ms`
+      });
       return;
     }
-    const orders = await this.loadOrdersByServer();
+    const orders = await this.loadOrdersByServer({
+      trigger: "preload"
+    });
     this.store.list = (0, import_lodash_es.cloneDeep)(orders);
     this.syncOrdersMap();
     await this.emitOrdersChanged([], "preload");
     await this.core.effects.emit(import_types.OrderHooks.onOrdersSyncCompleted, null);
+    this.logInfo("预加载完成", {
+      trigger: "preload",
+      source: "Server",
+      orderCount: this.store.list.length,
+      duration: `${Date.now() - preloadStartedAt}ms`
+    });
   }
   getOrders() {
     return this.store.list;
@@ -771,14 +786,16 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.logInfo("updateLocalPayment-变更事件完成", paymentContext);
     return { order: nextOrder, payment: nextPayment, previousPayment };
   }
-  async loadOrdersByServer() {
+  async loadOrdersByServer(options = {}) {
     var _a;
     let orderList = [];
     let hasFetchedRemoteSnapshot = false;
+    const trigger = options.trigger || "unknown";
     const protectedOrdersBeforeRemoteFetch = (await this.loadOrdersFromSQLite()).filter(
       (order) => this.shouldProtectLocalOrderFromRemoteSnapshot(order)
     );
     this.logInfo("loadOrdersByServer-开始", {
+      trigger,
       hasOrderDataSource: !!this.orderDataSource,
       query: ((_a = this.store) == null ? void 0 : _a.createdAtQuery) || null,
       protectedLocalOrderCount: protectedOrdersBeforeRemoteFetch.length,
@@ -796,6 +813,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         });
         orderList = data || [];
         this.logInfo("loadOrdersByServer-SSE拉取成功", {
+          trigger,
           count: orderList.length
         });
         hasFetchedRemoteSnapshot = true;
@@ -824,6 +842,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       "loadOrdersByServer.memory"
     );
     this.logInfo("loadOrdersByServer-结束", {
+      trigger,
       count: memoryOrders.length,
       persistedCount: mergedOrders.length,
       sqliteOnlyDraftCount: mergedOrders.length - memoryOrders.length
@@ -836,21 +855,34 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * 拿到完整数据后一次性替换 store，触发订单变更与同步完成事件
    * @returns 刷新后的订单列表
    */
-  async silentRefresh() {
+  async silentRefresh(options = {}) {
     const startTime = Date.now();
+    const trigger = options.trigger || "background";
     const elapsedSinceFullFetch = Date.now() - this.lastServerFullFetchAtMs;
     if (this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < ORDER_SILENT_REFRESH_MIN_INTERVAL_MS) {
+      this.logInfo("silentRefresh 跳过全量 SSE", {
+        trigger,
+        reason: "within_min_interval",
+        minIntervalMs: ORDER_SILENT_REFRESH_MIN_INTERVAL_MS,
+        elapsedSinceFullFetchMs: elapsedSinceFullFetch,
+        orderCount: this.store.list.length
+      });
       return this.store.list;
     }
-    this.logInfo("silentRefresh 开始");
+    this.logInfo("silentRefresh 开始", {
+      trigger,
+      elapsedSinceFullFetchMs: elapsedSinceFullFetch,
+      orderCount: this.store.list.length
+    });
     try {
       this.updateCreateStore();
-      const orders = await this.loadOrdersByServer();
+      const orders = await this.loadOrdersByServer({ trigger });
       this.store.list = (0, import_lodash_es.cloneDeep)(orders);
       this.syncOrdersMap();
       await this.emitOrdersChanged([], "silentRefresh");
       await this.core.effects.emit(import_types.OrderHooks.onOrdersSyncCompleted, null);
       this.logInfo("silentRefresh 完成", {
+        trigger,
         orderCount: orders.length,
         duration: `${Date.now() - startTime}ms`
       });
@@ -858,6 +890,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       this.logError("silentRefresh 失败", {
+        trigger,
         duration: `${Date.now() - startTime}ms`,
         error: errorMessage
       });

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

@@ -183,7 +183,9 @@ export declare class ProductsModule extends BaseModule implements Module {
     /**
      * 通过 ProductDataSource SSE 加载完整商品列表
      */
-    loadProductsByServer(): Promise<any>;
+    loadProductsByServer(options?: {
+        trigger?: string;
+    }): Promise<any>;
     /**
      * 纯请求方法：通过 HTTP 接口获取商品列表（无副作用，不触发事件、不写 IndexDB）
      * @param params 查询参数
@@ -333,7 +335,9 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 拿到完整数据后一次性替换 store，清除价格缓存，触发 onProductsSyncCompleted
      * @returns 刷新后的商品列表
      */
-    silentRefresh(): Promise<ProductData[]>;
+    silentRefresh(options?: {
+        trigger?: string;
+    }): Promise<ProductData[]>;
     /**
      * 销毁同步资源（取消 pubsub 订阅、清除定时器）
      */

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

@@ -814,12 +814,13 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
   /**
    * 通过 ProductDataSource SSE 加载完整商品列表
    */
-  async loadProductsByServer() {
+  async loadProductsByServer(options = {}) {
     if (!this.productDataSource) {
       this.logWarning("loadProductsByServer: ProductDataSource 不可用");
       return [];
     }
-    this.logInfo("开始通过 DataSource SSE 加载商品列表");
+    const trigger = options.trigger || "unknown";
+    this.logInfo("开始通过 DataSource SSE 加载商品列表", { trigger });
     const t0 = performance.now();
     try {
       const tSSE = performance.now();
@@ -827,6 +828,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       const list = productList || [];
       (0, import_product.perfMark)("loadProductsByServer.SSE", performance.now() - tSSE, { count: list.length });
       this.logInfo("通过 DataSource SSE 加载商品列表成功", {
+        trigger,
         productCount: list.length,
         duration: `${Math.round(performance.now() - t0)}ms`
       });
@@ -840,6 +842,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Products] 加载商品数据失败:", error);
       this.logError("通过 DataSource SSE 加载商品列表失败", {
+        trigger,
         duration: `${duration}ms`,
         error: errorMessage
       });
@@ -1030,7 +1033,9 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
   async refreshProducts() {
     const tTotal = performance.now();
     this.logInfo("refreshProducts 开始");
-    const products = await this.loadProductsByServer();
+    const products = await this.loadProductsByServer({
+      trigger: "product_sync"
+    });
     if (products && products.length > 0) {
       this.store.list = products;
       this.syncProductsMap();
@@ -1075,18 +1080,23 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       this.logWarning("loadProductsFromIndexDB: dbManager 不可用");
       return [];
     }
+    const startedAt = performance.now();
     try {
-      const t0 = performance.now();
       const products = await this.dbManager.getAll(INDEXDB_STORE_NAME);
-      (0, import_product.perfMark)("loadProductsFromIndexDB", performance.now() - t0, { count: (products == null ? void 0 : products.length) ?? 0 });
+      const durationMs = +(performance.now() - startedAt).toFixed(2);
+      (0, import_product.perfMark)("loadProductsFromIndexDB", durationMs, { count: (products == null ? void 0 : products.length) ?? 0 });
       this.logInfo("从 IndexDB 加载商品数据", {
-        productCount: (products == null ? void 0 : products.length) ?? 0
+        productCount: (products == null ? void 0 : products.length) ?? 0,
+        durationMs
       });
       return products || [];
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Products] 从 IndexDB 读取数据失败:", error);
-      this.logError("从 IndexDB 读取数据失败", { error: errorMessage });
+      this.logError("从 IndexDB 读取数据失败", {
+        durationMs: +(performance.now() - startedAt).toFixed(2),
+        error: errorMessage
+      });
       return [];
     }
   }
@@ -1114,22 +1124,54 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       this.logWarning("replaceProductsSnapshotInIndexDB: dbManager 不可用");
       return;
     }
+    const enqueuedAt = performance.now();
+    let queueWaitMs = 0;
+    let clearDurationMs = 0;
+    let writeDurationMs = 0;
     try {
       await this.runInProductIndexDBSaveQueue(async () => {
-        this.logInfo("replaceProductsSnapshotInIndexDB 开始", { source, productCount: products.length });
-        const t0 = performance.now();
-        await this.dbManager.clear(INDEXDB_STORE_NAME);
+        const operationStartedAt = performance.now();
+        queueWaitMs = +(operationStartedAt - enqueuedAt).toFixed(2);
+        this.logInfo("replaceProductsSnapshotInIndexDB 开始", {
+          source,
+          productCount: products.length,
+          queueWaitMs
+        });
+        const clearStartedAt = performance.now();
+        try {
+          await this.dbManager.clear(INDEXDB_STORE_NAME);
+        } finally {
+          clearDurationMs = +(performance.now() - clearStartedAt).toFixed(2);
+        }
         if (products.length > 0) {
-          await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products);
+          const writeStartedAt = performance.now();
+          try {
+            await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products);
+          } finally {
+            writeDurationMs = +(performance.now() - writeStartedAt).toFixed(2);
+          }
         }
-        (0, import_product.perfMark)("replaceProductsSnapshotInIndexDB", performance.now() - t0, { count: products.length });
-        this.logInfo("replaceProductsSnapshotInIndexDB 完成", { source, productCount: products.length });
+        const executeDurationMs = +(performance.now() - operationStartedAt).toFixed(2);
+        (0, import_product.perfMark)("replaceProductsSnapshotInIndexDB", executeDurationMs, { count: products.length });
+        this.logInfo("replaceProductsSnapshotInIndexDB 完成", {
+          source,
+          productCount: products.length,
+          queueWaitMs,
+          clearDurationMs,
+          writeDurationMs,
+          executeDurationMs,
+          totalDurationMs: +(performance.now() - enqueuedAt).toFixed(2)
+        });
       });
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       this.logError("全量保存商品到 IndexDB 失败", {
         source,
         productCount: products.length,
+        queueWaitMs,
+        clearDurationMs,
+        writeDurationMs,
+        totalDurationMs: +(performance.now() - enqueuedAt).toFixed(2),
         error: errorMessage
       });
     }
@@ -1211,6 +1253,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
           source: "IndexDB"
         });
         this.logInfo("预加载完成（从 IndexDB）", {
+          trigger: "preload",
           productCount: cachedData.length,
           duration: `${Math.round(performance.now() - tTotal)}ms`,
           source: "IndexDB"
@@ -1226,7 +1269,9 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       this.logWarning("从 IndexDB 加载数据失败，准备从服务器加载", { error: errorMessage });
     }
     const tServer = performance.now();
-    const products = await this.loadProductsByServer();
+    const products = await this.loadProductsByServer({
+      trigger: "preload"
+    });
     (0, import_product.perfMark)("preload.loadFromServer", performance.now() - tServer, { count: (products == null ? void 0 : products.length) ?? 0 });
     if (products && products.length > 0) {
       this.store.list = products;
@@ -1239,6 +1284,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         source: "Server"
       });
       this.logInfo("预加载完成（从服务器）", {
+        trigger: "preload",
         productCount: products.length,
         duration: `${Math.round(performance.now() - tTotal)}ms`,
         source: "Server"
@@ -1603,17 +1649,31 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    * 拿到完整数据后一次性替换 store，清除价格缓存，触发 onProductsSyncCompleted
    * @returns 刷新后的商品列表
    */
-  async silentRefresh() {
+  async silentRefresh(options = {}) {
     const t0 = performance.now();
     const now = Date.now();
-    const elapsedSincePreload = now - this.lastPreloadCompletedAtMs;
-    const elapsedSinceFullFetch = now - this.lastServerFullFetchAtMs;
-    if (this.lastPreloadCompletedAtMs > 0 && elapsedSincePreload < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS || this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS) {
+    const trigger = options.trigger || "background";
+    const elapsedSincePreloadMs = now - this.lastPreloadCompletedAtMs;
+    const elapsedSinceFullFetchMs = now - this.lastServerFullFetchAtMs;
+    if (this.lastPreloadCompletedAtMs > 0 && elapsedSincePreloadMs < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS || this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetchMs < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS) {
+      this.logInfo("silentRefresh 跳过全量 SSE", {
+        trigger,
+        reason: "within_min_interval",
+        minIntervalMs: PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS,
+        elapsedSincePreloadMs,
+        elapsedSinceFullFetchMs,
+        productCount: this.store.list.length
+      });
       return this.store.list;
     }
-    this.logInfo("silentRefresh 开始");
+    this.logInfo("silentRefresh 开始", {
+      trigger,
+      elapsedSincePreloadMs,
+      elapsedSinceFullFetchMs,
+      productCount: this.store.list.length
+    });
     try {
-      const products = await this.loadProductsByServer();
+      const products = await this.loadProductsByServer({ trigger });
       if (products && products.length > 0) {
         this.store.list = products;
         this.syncProductsMap();
@@ -1621,6 +1681,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
         await this.core.effects.emit(import_types.ProductsHooks.onProductsSyncCompleted, null);
         this.logInfo("silentRefresh 完成", {
+          trigger,
           productCount: products.length,
           duration: `${Math.round(performance.now() - t0)}ms`
         });
@@ -1632,6 +1693,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       this.logError("silentRefresh 失败", {
+        trigger,
         duration: `${Math.round(performance.now() - t0)}ms`,
         error: errorMessage
       });

package/package.json

@@ -1,7 +1,7 @@
 {
   "private": false,
   "name": "@pisell/pisellos",
-  "version": "2.3.59",
+  "version": "2.3.60",
   "description": "一个可扩展的前端模块化SDK框架，支持插件系统",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",