@pisell/pisellos 2.2.122 → 2.2.124

package/lib/server/index.d.ts

@@ -29,6 +29,10 @@ declare class Server {
     private productQuerySubscribers;
     private orderQuerySubscribers;
     private bookingQuerySubscribers;
+    private bookingRemoteQuerySubscribers;
+    private bookingRemoteCache;
+    private readonly BOOKING_REMOTE_CACHE_TTL_MS;
+    private readonly BOOKING_REMOTE_CACHE_MAX_ENTRIES;
     private floorPlanQuerySubscribers;
     private moduleRegistry;
     constructor(core: PisellCore);
@@ -176,11 +180,68 @@ declare class Server {
      */
     private handleUnsubscribeOrderQuery;
     /**
-     * 判断预约查询的 sales_time_between 起始日期是否为今天
+     * 从查询值中提取 YYYY-MM-DD 日期串。
+     *
+     * @example
+     * this.extractQueryDate('2026-04-15 09:58:00') // => '2026-04-15'
      */
-    private isBookingQueryForToday;
+    private extractQueryDate;
     /**
-     * 非今天的预约查询：通过真实 API 获取数据，再做 flattenOrdersToBookings 拆分
+     * 判断时间范围是否「开始和结束都不是今天」。
+     *
+     * @example
+     * this.isRangeBothNotToday('2026-04-13', '2026-04-14') // => true
+     */
+    private isRangeBothNotToday;
+    /**
+     * 订单查询是否走本地：
+     * - 当 start_time 与 end_time 都不是今天时，走远端；
+     * - 其余情况走本地。
+     */
+    private shouldUseLocalOrderQuery;
+    /**
+     * 预约查询是否走本地：
+     * - 当 sales_time_between 的开始和结束都不是今天时，走远端；
+     * - 其余情况走本地。
+     */
+    private shouldUseLocalBookingQuery;
+    /**
+     * 日历 SSE 精简 with：由调用方显式声明 compact_fields 决定
+     * - compact_fields === true → 精简字段（周/月视图）
+     * - 其余（false / 未传）→ ['all']（日视图/表格/平面图合并）
+     */
+    private resolveBookingSalesWith;
+    /**
+     * 日历 SSE 精简 select：渲染 + filterBookingsFromOrders 所需的主表字段
+     * business_code / payment_status 不直接用于渲染，但 matchOrder 过滤依赖
+     */
+    private resolveBookingSalesSelect;
+    /**
+     * 日历（compact_fields）场景下要直接在 SSE 层排除的订单类型：
+     * 这些类型不会出现在日历上，拉取它们只会浪费带宽并增加前端过滤成本。
+     */
+    private readonly BOOKING_SALES_COMPACT_EXCLUDE_TYPES;
+    private normalizeBookingRemoteQueryPayload;
+    /**
+     * 远端预约查询内存缓存开关：默认 false，仅显式 true 才启用。
+     */
+    private isBookingRemoteMemoryCacheEnabled;
+    private stableSerialize;
+    private buildBookingRemoteCacheKey;
+    private parseBookingSalesRangeMeta;
+    private readBookingRemoteCache;
+    private writeBookingRemoteCache;
+    private toOrderIdKey;
+    private markBookingRemoteCacheAllStale;
+    private buildBookingResponse;
+    private notifyBookingRemoteSubscribersByCacheKey;
+    private syncBookingRemoteCacheFromOrderChanges;
+    /**
+     * 非本地窗口的订单查询：走真实 API。
+     */
+    private fetchOrderListFromAPI;
+    /**
+     * 非今天的预约查询：通过 SSE 流式拉取订单，再做本地 booking 筛选展开
      */
     private fetchBookingListFromAPI;
     /**