@pisell/pisellos 2.2.122 → 2.2.123

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

@@ -13,7 +13,8 @@ export declare class OrderModule extends BaseModule implements Module {
     private orderDataSource;
     private pendingSyncMessages;
     private syncTimer?;
-    private readonly ORDER_SYNC_DEBOUNCE_MS;
+    private isProcessingSyncBatch;
+    private isIdlePhase;
     private resourceIdIndex;
     private logger;
     private storage;
@@ -31,6 +32,7 @@ export declare class OrderModule extends BaseModule implements Module {
      * @param metadata 日志元数据
      */
     private logError;
+    private getOrderSyncThrottleMs;
     preload(): Promise<void>;
     getOrders(): OrderData[];
     getOrderById(id: OrderId): OrderData | undefined;
@@ -38,6 +40,10 @@ export declare class OrderModule extends BaseModule implements Module {
     getOrderByOrderId(orderId: OrderId): OrderData | undefined;
     loadOrdersByServer(): Promise<OrderData[]>;
     getOrdersByResourceId(resourceId: string | number): OrderData[];
+    /**
+     * 通过 SSE 按自定义 query 拉取订单（支持 select/with 精简字段）
+     */
+    fetchOrdersBySSE(query?: Record<string, any>): Promise<OrderData[]>;
     getRoutes(): RouteDefinition[];
     destroy(): void;
     private syncOrdersMap;
@@ -48,15 +54,31 @@ export declare class OrderModule extends BaseModule implements Module {
      */
     private initOrderDataSource;
     /**
-     * 初始化 pubsub 订阅，监听订单变更
+     * 初始化 pubsub 订阅，监听订单变更（纯订阅，不拉数据；全量 SSE 由 loadOrdersByServer 负责）
      */
     private setupOrderSync;
     /**
-     * 处理防抖后的同步消息批次
+     * 调度订单同步节流窗口（leading-edge throttle）：
+     * - 空闲状态下收到的第一条消息立即触发批处理，无需等待；
+     * - 首条处理后进入冷却窗口，窗口期间的后续消息聚合，窗口结束后批量处理；
+     * - 若当前批处理执行中，则由批处理结束后决定是否开启下一轮窗口。
+     */
+    private scheduleOrderSyncThrottle;
+    /**
+     * 执行一次节流批处理并在需要时续约下一轮窗口。
+     * 批处理完成且无后续消息时恢复空闲状态，下一条消息将立即触发。
+     */
+    private flushOrderSyncMessagesByThrottle;
+    /**
+     * 处理节流窗口内聚合后的同步消息批次
      *
      * 后端统一发送 change 消息，不再区分新增/编辑/删除。
      * - 单条（id/order_id）：若携带 body/data 则直接 upsert 到本地
      * - 批量（ids）：通过 HTTP 按 ids 增量拉取，再 merge 到本地
+     *
+     * @example
+     * // pending 队列中存在 8 条消息时，仅处理一次批次并统一 merge
+     * await this.processOrderSyncMessages()
      */
     private processOrderSyncMessages;
     /**