@pisell/pisellos 0.0.567 → 0.0.568

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

@@ -1,34 +1,109 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";
 
-// src/server/modules/order/types.ts
-var types_exports = {};
-__export(types_exports, {
-  OrderHooks: () => OrderHooks
-});
-module.exports = __toCommonJS(types_exports);
-var OrderHooks = /* @__PURE__ */ ((OrderHooks2) => {
-  OrderHooks2["onOrdersLoaded"] = "order:onOrdersLoaded";
-  OrderHooks2["onOrdersChanged"] = "order:onOrdersChanged";
-  OrderHooks2["onOrdersSyncCompleted"] = "order:onOrdersSyncCompleted";
-  return OrderHooks2;
-})(OrderHooks || {});
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  OrderHooks
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
+exports.OrderHooks = void 0;
+/**
+ * Order 模块主键类型（对齐标准 Sales 协议的 order_id）
+ */
+/**
+ * 协议中金额类字段多为 string 快照（交易时价格不可从基准商品重算）
+ */
+// ─────────────────────────────────────────────────────────────────
+// 订单类型 / 平台 / 渠道（Sales 协议枚举，保留 string 并置常用字面量）
+// ─────────────────────────────────────────────────────────────────
+/** 订单类型。文档：appointment_booking / ticket / virtual。来源：Order.type */
+/**
+ * 来源平台。文档：shop / pos / kiosk / h5 / app / mini-program。
+ * 来源：Order.platform
+ */
+/** 订单状态（仅输出）。文档：open / completed / cancelled。来源：Order.status */
+/** 支付状态。来源：Order.payment_status */
+/** 发货状态（仅输出）。来源：Order.shipping_status */
+/**
+ * 预约子事件状态（仅输出）。
+ * 文档：new / confirmed / arrived / started / completed / cancelled。
+ * 来源：ScheduleEvent.appointment_status
+ */
+/** 折扣类型：shop（整单）/ product（商品）。来源：Discount.type */
+/** 支付记录状态：paid / voided / payment_pending 等。来源：OrderPayment.status */
+/** 附加费类型。来源：OrderSurcharge.type */
+// ─────────────────────────────────────────────────────────────────
+// 3.3 products / 3.3.1 discount_list / 3.3.2 product_bundle
+// ─────────────────────────────────────────────────────────────────
+/** 商品折扣 metadata，常含 unique_identification_number */
+/**
+ * 商品折扣项（3.3.1 discount_list）
+ */
+/**
+ * 套餐子商品（3.3.2 product_bundle）
+ */
+/** 商品行 metadata，常含 unique_identification_number */
+/**
+ * 订单级商品行（3.3 products）。
+ * 订单级别的非预约关联商品；预约关联商品在 bookings 内。
+ * product_id 为关联 ID，展示信息从本地基准数据取；价格为交易快照须保留在 Sales 数据中。
+ */
+// ─────────────────────────────────────────────────────────────────
+// 3.4 bookings
+// ─────────────────────────────────────────────────────────────────
+/** 预约条目 metadata，常含 unique_identification_number */
+/**
+ * 单条预约（子 schedule_event，parent_id != 0）。
+ * product 结构同 products 单项；relation_products 结构同 products 数组。
+ */
+// ─────────────────────────────────────────────────────────────────
+// 3.5 payments
+// ─────────────────────────────────────────────────────────────────
+/** 支付记录 metadata，常含 unique_payment_number */
+/**
+ * 支付记录（3.5 payments）
+ */
+// ─────────────────────────────────────────────────────────────────
+// 3.6 surcharges
+// ─────────────────────────────────────────────────────────────────
+/**
+ * 订单附加费（3.6 surcharges）
+ */
+// ─────────────────────────────────────────────────────────────────
+// 3.7 summary（仅输出，由 OrderV2Service::computeOrderSummaryData 计算）
+// ─────────────────────────────────────────────────────────────────
+/**
+ * 订单数据结构（Server 侧对齐《统一 Sales 数据协议》）
+ */
+/** 去掉 bookings 后的订单快照；展开预约行时挂在 {@link BookingData.order} 上 */
+/**
+ * 展开后的单条预约视图：协议 {@link OrderBookingItem} 平铺字段 + 所属订单（不含 bookings）
+ */
+/**
+ * 订单列表筛选条件（与 order.ts getFilterButtonList 等 UI 对齐）
+ */
+/**
+ * 预约展开列表筛选条件（订单级条件匹配 booking.order.*，预约级匹配 booking 自身）
+ */
+/** 分页筛选结果通用结构 */
+/**
+ * SSE 同步配置
+ */
+/**
+ * Ably 事件类型
+ */
+/**
+ * Ably 事件载荷
+ */
+/**
+ * OrderSyncMessage - pubsub 同步消息结构
+ */
+/**
+ * Order 模块状态
+ */
+/**
+ * Order 模块钩子
+ */
+let OrderHooks = exports.OrderHooks = /*#__PURE__*/function (OrderHooks) {
+  OrderHooks["onOrdersLoaded"] = "order:onOrdersLoaded";
+  OrderHooks["onOrdersChanged"] = "order:onOrdersChanged";
+  OrderHooks["onOrdersSyncCompleted"] = "order:onOrdersSyncCompleted";
+  return OrderHooks;
+}({});

package/lib/server/modules/order/utils/filterBookings.js

@@ -1,78 +1,70 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";
 
-// src/server/modules/order/utils/filterBookings.ts
-var filterBookings_exports = {};
-__export(filterBookings_exports, {
-  filterBookings: () => filterBookings,
-  filterBookingsFromOrders: () => filterBookingsFromOrders,
-  flattenOrdersToBookings: () => flattenOrdersToBookings,
-  sortBookings: () => sortBookings
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(filterBookings_exports);
+exports.filterBookings = filterBookings;
+exports.filterBookingsFromOrders = filterBookingsFromOrders;
+exports.flattenOrdersToBookings = flattenOrdersToBookings;
+exports.sortBookings = sortBookings;
+/** 预约状态：协议 appointment_status 优先，兼容历史 status */
 function getBookingAppointmentStatus(booking) {
-  return String(booking.appointment_status ?? booking.status ?? "");
+  return String(booking.appointment_status ?? booking.status ?? '');
 }
+
+// ─────────────────────────────────────────────────────────────────
+// 时间戳 / 范围解析
+// ─────────────────────────────────────────────────────────────────
+
 function toTimestamp(value) {
-  if (value === void 0 || value === null || value === "")
-    return 0;
-  if (typeof value === "number")
-    return value;
+  if (value === undefined || value === null || value === '') return 0;
+  if (typeof value === 'number') return value;
   return new Date(value).getTime();
 }
+
+/**
+ * 将 start_date / start_time（或 end_*）拼成可被 Date 稳定解析的字符串。
+ * 时间字段协议为 H:i（如 15:00）时补全为 H:i:00，避免部分环境对「无秒」非 ISO 串（空格分隔）解析不一致。
+ */
 function bookingDateTimeString(datePart, timePart) {
-  const d = (datePart ?? "").trim();
-  let t = (timePart ?? "").trim();
+  const d = (datePart ?? '').trim();
+  let t = (timePart ?? '').trim();
   if (t && /^\d{1,2}:\d{2}$/.test(t)) {
     t = `${t}:00`;
   }
   return `${d} ${t}`.trim();
 }
 function parseDateRange(range) {
-  if (!Array.isArray(range) || range.length < 2)
-    return null;
+  if (!Array.isArray(range) || range.length < 2) return null;
   const start = toTimestamp(range[0]);
   const end = toTimestamp(range[1]);
-  if (!start && !end)
-    return null;
+  if (!start && !end) return null;
   return [start, end];
 }
 function parseNumberRange(range) {
-  if (!Array.isArray(range) || range.length < 2)
-    return null;
+  if (!Array.isArray(range) || range.length < 2) return null;
   const min = Number(range[0]);
   const max = Number(range[1]);
-  if (isNaN(min) || isNaN(max))
-    return null;
+  if (isNaN(min) || isNaN(max)) return null;
   return [min, max];
 }
+
+// ─────────────────────────────────────────────────────────────────
+// 预编译过滤上下文：将 filters 一次性解析为高效的 Set / Range，
+// 供 matchOrder、matchBooking 复用，避免重复计算
+// ─────────────────────────────────────────────────────────────────
+
 function prepareFilters(f) {
-  var _a, _b, _c, _d, _e, _f;
-  const hasCustomerId = f.customer_id !== void 0 && f.customer_id !== null;
+  const hasCustomerId = f.customer_id !== undefined && f.customer_id !== null;
   return {
-    orderPaymentStatusSet: ((_a = f.order_payment_status) == null ? void 0 : _a.length) ? new Set(f.order_payment_status) : null,
-    orderStatusSet: ((_b = f.order_status) == null ? void 0 : _b.length) ? new Set(f.order_status) : null,
-    orderSalesChannelSet: ((_c = f.order_sales_channel) == null ? void 0 : _c.length) ? new Set(f.order_sales_channel) : null,
-    paymentMethodSet: ((_d = f.payment_method) == null ? void 0 : _d.length) ? new Set(f.payment_method) : null,
-    appointmentStatusSet: ((_e = f.appointment_status) == null ? void 0 : _e.length) ? new Set(f.appointment_status) : null,
-    formRecordIdSet: ((_f = f.form_record_ids) == null ? void 0 : _f.length) ? new Set(f.form_record_ids) : null,
+    orderPaymentStatusSet: f.order_payment_status?.length ? new Set(f.order_payment_status) : null,
+    orderStatusSet: f.order_status?.length ? new Set(f.order_status) : null,
+    orderSalesChannelSet: f.order_sales_channel?.length ? new Set(f.order_sales_channel) : null,
+    paymentMethodSet: f.payment_method?.length ? new Set(f.payment_method) : null,
+    appointmentStatusSet: f.appointment_status?.length ? new Set(f.appointment_status) : null,
+    formRecordIdSet: f.form_record_ids?.length ? new Set(f.form_record_ids) : null,
     hasCustomerId,
-    customerIdStr: hasCustomerId ? String(f.customer_id) : "",
+    customerIdStr: hasCustomerId ? String(f.customer_id) : '',
     hasBusinessCode: !!f.business_code,
     businessCode: f.business_code,
     bookingTimeRange: parseDateRange(f.sales_time_between),
@@ -80,33 +72,30 @@ function prepareFilters(f) {
     updatedAtRange: parseDateRange(f.updated_at_between),
     numberRange: parseNumberRange(f.number_between),
     totalAmountRange: Array.isArray(f.total_amount_between) && f.total_amount_between.length === 2 ? f.total_amount_between : null,
-    keywordLower: f.keyword ? f.keyword.toLowerCase() : "",
+    keywordLower: f.keyword ? f.keyword.toLowerCase() : '',
     afterExecutionTimeMs: (() => {
       const raw = f.after_execution_time;
-      if (raw === void 0 || raw === null || raw === "")
-        return null;
+      if (raw === undefined || raw === null || raw === '') return null;
       const ms = toTimestamp(raw);
       return Number.isFinite(ms) ? ms : null;
     })(),
     enableChildBookingFilter: f.child_booking === 1
   };
 }
+
+// ─────────────────────────────────────────────────────────────────
+// 订单级匹配：不通过则整个 order 下所有 bookings 跳过
+// ─────────────────────────────────────────────────────────────────
+
 function matchOrder(order, ctx) {
-  var _a;
-  if (ctx.hasBusinessCode && order.business_code !== ctx.businessCode)
-    return false;
-  if (ctx.hasCustomerId && String(order.customer_id) !== ctx.customerIdStr)
-    return false;
-  if (ctx.orderPaymentStatusSet && !ctx.orderPaymentStatusSet.has(order.payment_status))
-    return false;
-  if (ctx.orderStatusSet && !ctx.orderStatusSet.has(order.status))
-    return false;
-  if (ctx.orderSalesChannelSet && !ctx.orderSalesChannelSet.has(order.order_sales_channel))
-    return false;
+  if (ctx.hasBusinessCode && order.business_code !== ctx.businessCode) return false;
+  if (ctx.hasCustomerId && String(order.customer_id) !== ctx.customerIdStr) return false;
+  if (ctx.orderPaymentStatusSet && !ctx.orderPaymentStatusSet.has(order.payment_status)) return false;
+  if (ctx.orderStatusSet && !ctx.orderStatusSet.has(order.status)) return false;
+  if (ctx.orderSalesChannelSet && !ctx.orderSalesChannelSet.has(order.order_sales_channel)) return false;
   if (ctx.paymentMethodSet) {
     const pm = order.payments;
-    if (!Array.isArray(pm) || pm.length === 0)
-      return false;
+    if (!Array.isArray(pm) || pm.length === 0) return false;
     let matched = false;
     for (let k = 0; k < pm.length; k++) {
       if (ctx.paymentMethodSet.has(pm[k].code)) {
@@ -114,101 +103,121 @@ function matchOrder(order, ctx) {
         break;
       }
     }
-    if (!matched)
-      return false;
+    if (!matched) return false;
   }
   if (ctx.createdAtRange) {
     const ts = toTimestamp(order.created_at);
-    if (ts < ctx.createdAtRange[0] || ts > ctx.createdAtRange[1])
-      return false;
+    if (ts < ctx.createdAtRange[0] || ts > ctx.createdAtRange[1]) return false;
   }
   if (ctx.updatedAtRange) {
     const ts = toTimestamp(order.updated_at);
-    if (ts < ctx.updatedAtRange[0] || ts > ctx.updatedAtRange[1])
-      return false;
+    if (ts < ctx.updatedAtRange[0] || ts > ctx.updatedAtRange[1]) return false;
   }
   if (ctx.totalAmountRange) {
-    const raw = ((_a = order.summary) == null ? void 0 : _a.total_amount) ?? order.total_amount;
+    const raw = order.summary?.total_amount ?? order.total_amount;
     const amt = Number(raw);
-    if (isNaN(amt))
-      return false;
-    if (ctx.totalAmountRange[0] != null && amt < ctx.totalAmountRange[0])
-      return false;
-    if (ctx.totalAmountRange[1] != null && amt > ctx.totalAmountRange[1])
-      return false;
+    if (isNaN(amt)) return false;
+    if (ctx.totalAmountRange[0] != null && amt < ctx.totalAmountRange[0]) return false;
+    if (ctx.totalAmountRange[1] != null && amt > ctx.totalAmountRange[1]) return false;
   }
   return true;
 }
+
+// ─────────────────────────────────────────────────────────────────
+// Booking 级匹配：在订单通过之后逐条检查每个 booking
+// orderInfo 用于 keyword 搜索时的 JSON 序列化
+// ─────────────────────────────────────────────────────────────────
+
 function matchBooking(booking, orderInfo, ctx) {
   if (ctx.enableChildBookingFilter) {
     const parentId = Number(booking.parent_id ?? 0);
-    const itemType = String(booking.item_type ?? "");
-    const isMatched = parentId !== 0 && itemType !== "recurring_booking" || parentId === 0 && itemType === "recurring_booking";
-    if (!isMatched)
-      return false;
+    const itemType = String(booking.item_type ?? '');
+    const isMatched = parentId !== 0 && itemType !== 'recurring_booking' || parentId === 0 && itemType === 'recurring_booking';
+    if (!isMatched) return false;
   }
-  if (ctx.appointmentStatusSet && !ctx.appointmentStatusSet.has(getBookingAppointmentStatus(booking)))
-    return false;
+  if (ctx.appointmentStatusSet && !ctx.appointmentStatusSet.has(getBookingAppointmentStatus(booking))) return false;
   if (ctx.bookingTimeRange) {
     const ts = toTimestamp(booking.start_date);
-    if (ts < ctx.bookingTimeRange[0] || ts > ctx.bookingTimeRange[1])
-      return false;
+    if (ts < ctx.bookingTimeRange[0] || ts > ctx.bookingTimeRange[1]) return false;
   }
   if (ctx.afterExecutionTimeMs != null) {
     const bookingStartMs = toTimestamp(bookingDateTimeString(booking.start_date, booking.start_time));
-    if (!Number.isFinite(bookingStartMs) || bookingStartMs < ctx.afterExecutionTimeMs)
-      return false;
+    if (!Number.isFinite(bookingStartMs) || bookingStartMs < ctx.afterExecutionTimeMs) return false;
   }
   if (ctx.numberRange) {
     const num = Number(booking.number);
-    if (isNaN(num) || num < ctx.numberRange[0] || num > ctx.numberRange[1])
-      return false;
+    if (isNaN(num) || num < ctx.numberRange[0] || num > ctx.numberRange[1]) return false;
   }
   if (ctx.formRecordIdSet) {
     let formMatched = false;
     const resources = booking.resources;
     if (Array.isArray(resources)) {
       for (let r = 0; r < resources.length; r++) {
-        if (resources[r].relation_type === "form" && ctx.formRecordIdSet.has(resources[r].relation_id)) {
+        if (resources[r].relation_type === 'form' && ctx.formRecordIdSet.has(resources[r].relation_id)) {
           formMatched = true;
           break;
         }
       }
     }
-    if (!formMatched && booking.relation_type === "form" && booking.relation_id && booking.relation_id > 0) {
+    if (!formMatched && booking.relation_type === 'form' && booking.relation_id && booking.relation_id > 0) {
       formMatched = ctx.formRecordIdSet.has(booking.relation_id);
     }
-    if (!formMatched)
-      return false;
+    if (!formMatched) return false;
   }
   if (ctx.keywordLower) {
-    const target = orderInfo ? { ...booking, order: orderInfo } : booking;
+    const target = orderInfo ? {
+      ...booking,
+      order: orderInfo
+    } : booking;
     const str = JSON.stringify(target).toLowerCase();
-    if (!str.includes(ctx.keywordLower))
-      return false;
+    if (!str.includes(ctx.keywordLower)) return false;
   }
   return true;
 }
+
+// ─────────────────────────────────────────────────────────────────
+// 转换：OrderData[] → BookingData[]（独立导出，供其他场景使用）
+// ─────────────────────────────────────────────────────────────────
+
 function flattenOrdersToBookings(orders) {
-  if (!orders || !Array.isArray(orders))
-    return [];
+  if (!orders || !Array.isArray(orders)) return [];
   const result = [];
   for (let i = 0, len = orders.length; i < len; i++) {
     const order = orders[i];
     const bookings = order.bookings;
-    if (!Array.isArray(bookings) || bookings.length === 0)
-      continue;
-    const { bookings: _omit, ...orderInfo } = order;
+    if (!Array.isArray(bookings) || bookings.length === 0) continue;
+    const {
+      bookings: _omit,
+      ...orderInfo
+    } = order;
     for (let j = 0, bLen = bookings.length; j < bLen; j++) {
-      result.push({ ...bookings[j], order: orderInfo });
+      result.push({
+        ...bookings[j],
+        order: orderInfo
+      });
     }
   }
   return result;
 }
+
+// ─────────────────────────────────────────────────────────────────
+// 核心：单遍扫描 — 展开 + 过滤 + 分页
+//
+// 性能策略：
+//  1. 订单级条件在外层循环 matchOrder 预判，不匹配则整组 bookings 跳过
+//  2. orderInfo 延迟到有命中 booking 时才创建，同一 order 只创建一次
+//  3. 只对最终命中的 booking 做 object spread
+// ─────────────────────────────────────────────────────────────────
+
 function filterBookingsFromOrders(orders, filters) {
   const f = filters || {};
   if (!orders || !Array.isArray(orders)) {
-    return { list: [], count: 0, size: 0, skip: 0 };
+    return {
+      list: [],
+      count: 0,
+      size: 0,
+      skip: 0
+    };
   }
   const size = f.num || 20;
   const page = f.skip || 1;
@@ -219,25 +228,39 @@ function filterBookingsFromOrders(orders, filters) {
   for (let i = 0, oLen = orders.length; i < oLen; i++) {
     const order = orders[i];
     const bookings = order.bookings;
-    if (!Array.isArray(bookings) || bookings.length === 0)
-      continue;
-    if (!matchOrder(order, ctx))
-      continue;
+    if (!Array.isArray(bookings) || bookings.length === 0) continue;
+
+    // 订单级预过滤
+    if (!matchOrder(order, ctx)) continue;
+
+    // 订单通过，遍历其 bookings；orderInfo 延迟创建
     let orderInfo = null;
     for (let j = 0, bLen = bookings.length; j < bLen; j++) {
       const booking = bookings[j];
+
+      // keyword 匹配需要 orderInfo，提前创建
       if (ctx.keywordLower && !orderInfo) {
-        const { bookings: _omit, ...rest } = order;
+        const {
+          bookings: _omit,
+          ...rest
+        } = order;
         orderInfo = rest;
       }
-      if (!matchBooking(booking, orderInfo, ctx))
-        continue;
+      if (!matchBooking(booking, orderInfo, ctx)) continue;
+
+      // 命中：收集到分页窗口内
       if (totalCount >= startIndex && paginatedList.length < size) {
         if (!orderInfo) {
-          const { bookings: _omit, ...rest } = order;
+          const {
+            bookings: _omit,
+            ...rest
+          } = order;
           orderInfo = rest;
         }
-        paginatedList.push({ ...booking, order: orderInfo });
+        paginatedList.push({
+          ...booking,
+          order: orderInfo
+        });
       }
       totalCount++;
     }
@@ -249,28 +272,32 @@ function filterBookingsFromOrders(orders, filters) {
     skip: page
   };
 }
+
+// ─────────────────────────────────────────────────────────────────
+// 排序预约列表
+// order_by 格式："field:direction"，如 "start_at:desc"
+// 不带方向后缀则不排序
+// ─────────────────────────────────────────────────────────────────
+
 function sortBookings(result, filters) {
   const f = filters || {};
   const orderBy = f.order_by;
-  if (!orderBy)
-    return result;
-  const separatorIdx = orderBy.lastIndexOf(":");
-  if (separatorIdx === -1)
-    return result;
+  if (!orderBy) return result;
+  const separatorIdx = orderBy.lastIndexOf(':');
+  if (separatorIdx === -1) return result;
   const field = orderBy.slice(0, separatorIdx);
   const direction = orderBy.slice(separatorIdx + 1);
-  if (direction !== "asc" && direction !== "desc")
-    return result;
-  const multiplier = direction === "asc" ? 1 : -1;
-  const getTimestamp = (booking) => {
+  if (direction !== 'asc' && direction !== 'desc') return result;
+  const multiplier = direction === 'asc' ? 1 : -1;
+  const getTimestamp = booking => {
     switch (field) {
-      case "start_at":
+      case 'start_at':
         return toTimestamp(bookingDateTimeString(booking.start_date, booking.start_time));
-      case "end_at":
+      case 'end_at':
         return toTimestamp(bookingDateTimeString(booking.end_date, booking.end_time));
-      case "created_at":
+      case 'created_at':
         return toTimestamp(booking.order.created_at);
-      case "updated_at":
+      case 'updated_at':
         return toTimestamp(booking.order.updated_at);
       default:
         return 0;
@@ -279,12 +306,26 @@ function sortBookings(result, filters) {
   const sorted = result.list.slice().sort((a, b) => {
     return (getTimestamp(a) - getTimestamp(b)) * multiplier;
   });
-  return { ...result, list: sorted };
+  return {
+    ...result,
+    list: sorted
+  };
 }
+
+// ─────────────────────────────────────────────────────────────────
+// 兼容独立调用：对已展开的 BookingData[] 做筛选
+// 复用 matchOrder + matchBooking，仅负责迭代与分页
+// ─────────────────────────────────────────────────────────────────
+
 function filterBookings(bookings, filters) {
   const f = filters || {};
   if (!bookings || !Array.isArray(bookings)) {
-    return { list: [], count: 0, size: 0, skip: 0 };
+    return {
+      list: [],
+      count: 0,
+      size: 0,
+      skip: 0
+    };
   }
   const size = f.num || 20;
   const page = f.skip || 1;
@@ -295,10 +336,10 @@ function filterBookings(bookings, filters) {
   for (let i = 0, len = bookings.length; i < len; i++) {
     const booking = bookings[i];
     const order = booking.order;
-    if (!matchOrder(order, ctx))
-      continue;
-    if (!matchBooking(booking, order, ctx))
-      continue;
+
+    // 订单级 + booking 级统一匹配
+    if (!matchOrder(order, ctx)) continue;
+    if (!matchBooking(booking, order, ctx)) continue;
     if (totalCount >= startIndex && paginatedList.length < size) {
       paginatedList.push(booking);
     }
@@ -310,11 +351,4 @@ function filterBookings(bookings, filters) {
     size,
     skip: page
   };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  filterBookings,
-  filterBookingsFromOrders,
-  flattenOrdersToBookings,
-  sortBookings
-});
+}