@pisell/pisellos 2.2.205 → 2.2.207

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

@@ -23,6 +23,13 @@ export declare class OrderModule extends BaseModule implements Module {
     /** 最近一次 SSE 全量拉取完成时间 */
     private lastServerFullFetchAtMs;
     constructor(name?: string, version?: string);
+    /**
+     * 广播订单变更事件，兼容全量列表订阅并额外携带本次变更订单。
+     *
+     * @example
+     * await this.emitOrdersChanged([freshOrder], 'pubsub.bodyUpsert')
+     */
+    private emitOrdersChanged;
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     /**
    * 记录信息日志

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

@@ -63,6 +63,20 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     /** 最近一次 SSE 全量拉取完成时间 */
     this.lastServerFullFetchAtMs = 0;
   }
+  /**
+   * 广播订单变更事件，兼容全量列表订阅并额外携带本次变更订单。
+   *
+   * @example
+   * await this.emitOrdersChanged([freshOrder], 'pubsub.bodyUpsert')
+   */
+  async emitOrdersChanged(changedOrders = [], source) {
+    const payload = {
+      list: this.store.list,
+      changedOrders,
+      source
+    };
+    await this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, payload);
+  }
   async initialize(core, options) {
     var _a, _b;
     this.core = core;
@@ -119,7 +133,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     if (Array.isArray((_b = options == null ? void 0 : options.initialState) == null ? void 0 : _b.list)) {
       this.store.list = options.initialState.list;
       this.syncOrdersMap();
-      this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+      this.emitOrdersChanged([], "initialState");
     } else {
       this.store.list = [];
       this.store.map = /* @__PURE__ */ new Map();
@@ -336,7 +350,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       }
       this.store.list = (0, import_lodash_es.cloneDeep)(orders);
       this.syncOrdersMap();
-      this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+      this.emitOrdersChanged([], "preload");
       this.core.effects.emit(import_types.OrderHooks.onOrdersSyncCompleted, null);
     };
     getData();
@@ -416,7 +430,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       if (orders.length > 0) {
         this.store.list = (0, import_lodash_es.cloneDeep)(orders);
         this.syncOrdersMap();
-        this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+        this.emitOrdersChanged([], "silentRefresh");
         await this.core.effects.emit(import_types.OrderHooks.onOrdersSyncCompleted, null);
         this.logInfo("silentRefresh 完成", {
           orderCount: orders.length,
@@ -470,7 +484,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       orderId,
       storeOrderCountAfter: this.store.list.length
     });
-    await this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+    await this.emitOrdersChanged([fresh], "overwriteExistingOrder");
     return { overwritten: true };
   }
   /**
@@ -530,7 +544,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       count: patchedOrders.length,
       storeOrderCountAfter: this.store.list.length
     });
-    this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+    this.emitOrdersChanged(patchedOrders, "upsertPendingSyncOrders");
   }
   /**
    * 通过 SSE 按自定义 query 拉取订单（支持 select/with 精简字段）
@@ -879,7 +893,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       uniqueFreshCount,
       storeOrderCountAfter: this.store.list.length
     });
-    this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+    this.emitOrdersChanged(patchedOrders, source);
   }
   normalizeOrderSyncMessage(res) {
     const data = (res == null ? void 0 : res.data) || res;
@@ -1229,7 +1243,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       });
     }
     this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, "");
-    this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+    this.emitOrdersChanged([], "clear");
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

package/lib/server/modules/order/types.d.ts

@@ -524,6 +524,21 @@ export interface OrderAblyEventPayload {
     order_id?: OrderId;
     timestamp: number;
 }
+/**
+ * 订单变更广播载荷。
+ * 用于保留原有全量列表通知能力，同时让订阅方可按 changedOrders 做增量处理。
+ *
+ * @example
+ * const changedOrders = payload.changedOrders
+ */
+export interface OrderChangedPayload {
+    /** 当前订单 store 全量列表，兼容既有重算列表订阅 */
+    list: OrderData[];
+    /** 本次明确发生变更的订单；全量刷新等无法确定 delta 的场景可为空 */
+    changedOrders: OrderData[];
+    /** 触发来源，便于订阅者区分 pubsub / 远端覆盖 / 清空等场景 */
+    source?: string;
+}
 /**
  * OrderSyncMessage - pubsub 同步消息结构
  */

package/lib/server/utils/small-ticket.d.ts

@@ -0,0 +1,69 @@
+export interface SmallTicketShopInfo {
+    name?: string;
+    phone?: string;
+    address?: string;
+    address_street?: string;
+    address_detail?: string;
+    city?: string;
+    province?: string;
+    country?: string;
+    zip?: string;
+    tax_number?: string;
+    tax_title?: string;
+    currency_symbol?: string;
+    currency_code?: string;
+    primary_locale?: string;
+    timezone?: string;
+    [key: string]: any;
+}
+export interface BuildSmallTicketDataParams {
+    order: Record<string, any>;
+    shopInfo?: SmallTicketShopInfo | null;
+    locales?: string[];
+    productMap?: Record<string | number, Record<string, any>>;
+}
+export interface SmallTicketItem {
+    item: string;
+    value: string;
+    size?: number;
+    align?: string;
+}
+export interface SmallTicketProduct {
+    product_title: string;
+    product_quantity: number;
+    selling_price: string;
+    original_price: string;
+    total_original_price: string;
+    extension_list: any[];
+    options?: Array<{
+        name: string;
+        value: string;
+    }>;
+    variant?: string;
+    combinations?: any[];
+}
+export interface SmallTicketLocaleData {
+    base_data: Record<string, any>;
+    products: SmallTicketProduct[];
+    fees: {
+        fees: SmallTicketItem[];
+        countFee: Record<string, any>;
+    };
+    customer: SmallTicketItem[];
+    appointment: SmallTicketItem[];
+    delivery: SmallTicketItem[];
+    resources: Array<{
+        id: string | number;
+        code: string;
+        title: string;
+        form_title: string;
+    }>;
+    payment_data: SmallTicketItem[][];
+    tickets: any[];
+    source_shop: any[];
+    refund_data: any[];
+    expend_data: any[];
+}
+export type SmallTicketData = Record<string, SmallTicketLocaleData>;
+export declare function buildSmallTicketData(params: BuildSmallTicketDataParams): SmallTicketData;
+export declare function hasSmallTicketData(value: any): boolean;