@pisell/pisellos 2.2.260 → 2.2.262

package/lib/modules/SurchargeList/index.js

@@ -25,15 +25,17 @@ __export(SurchargeList_exports, {
 module.exports = __toCommonJS(SurchargeList_exports);
 var import_BaseModule = require("../BaseModule");
 __reExport(SurchargeList_exports, require("./types"), module.exports);
+var DEFAULT_SURCHARGE_CHANNEL = "online-store";
 var SurchargeListModule = class extends import_BaseModule.BaseModule {
   constructor(name, version) {
     super(name, version);
     this.defaultName = "surchargeList";
     this.defaultVersion = "1.0.0";
-    this.loadingPromise = null;
+    this.loadingPromises = /* @__PURE__ */ new Map();
+    this.requestVersion = 0;
   }
   async initialize(core, options) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     this.core = core;
     this.store = options.store;
     this.request = this.core.getPlugin("request");
@@ -41,44 +43,62 @@ var SurchargeListModule = class extends import_BaseModule.BaseModule {
       (_a = options.initialState) == null ? void 0 : _a.surchargeList
     );
     this.store.surchargeList = hasInitialSurchargeList ? (_b = options.initialState) == null ? void 0 : _b.surchargeList : [];
-    this.store.isLoaded = Boolean((_c = options.initialState) == null ? void 0 : _c.isLoaded) || hasInitialSurchargeList;
+    this.store.channel = ((_c = options.initialState) == null ? void 0 : _c.channel) || ((_d = options.otherParams) == null ? void 0 : _d.channel) || DEFAULT_SURCHARGE_CHANNEL;
+    this.store.isLoaded = Boolean((_e = options.initialState) == null ? void 0 : _e.isLoaded) || hasInitialSurchargeList;
     if (!this.request) {
       throw new Error("SurchargeListModule 需要 request 插件支持");
     }
   }
-  async getSurchargeList() {
-    if (this.store.isLoaded)
+  resolveChannel(query) {
+    return (query == null ? void 0 : query.channel) || DEFAULT_SURCHARGE_CHANNEL;
+  }
+  async getSurchargeList(query) {
+    const channel = this.resolveChannel(query);
+    if (this.store.isLoaded && this.store.channel === channel) {
       return this.store.surchargeList;
-    if (this.loadingPromise)
-      return this.loadingPromise;
-    this.loadingPromise = this.loadSurchargeList();
-    return this.loadingPromise;
+    }
+    const loadingPromise = this.loadingPromises.get(channel);
+    if (loadingPromise)
+      return loadingPromise;
+    const nextPromise = this.loadSurchargeList(channel);
+    this.loadingPromises.set(channel, nextPromise);
+    return nextPromise;
   }
-  async refreshSurchargeList() {
-    this.loadingPromise = this.loadSurchargeList();
-    return this.loadingPromise;
+  async refreshSurchargeList(query) {
+    const channel = this.resolveChannel(query);
+    const nextPromise = this.loadSurchargeList(channel);
+    this.loadingPromises.set(channel, nextPromise);
+    return nextPromise;
   }
-  async loadSurchargeList() {
+  async loadSurchargeList(channel) {
+    const currentRequestVersion = ++this.requestVersion;
     try {
       const surchargeList = await this.request.get(
         "/order/custom-surcharge/available/v2",
         {
-          channel: "online-store",
+          channel,
           is_assemble_product_data: 1,
           is_assemble_schedule_data: 1,
           with: ["relationSchedule"]
         }
       );
-      this.store.surchargeList = (surchargeList == null ? void 0 : surchargeList.data) || [];
-      this.store.isLoaded = true;
-      return this.store.surchargeList;
+      const nextSurchargeList = (surchargeList == null ? void 0 : surchargeList.data) || [];
+      if (currentRequestVersion === this.requestVersion) {
+        this.store.surchargeList = nextSurchargeList;
+        this.store.channel = channel;
+        this.store.isLoaded = true;
+      }
+      return nextSurchargeList;
     } catch (error) {
       console.warn("[SurchargeListModule] 加载附加费配置失败", error);
-      this.store.surchargeList = [];
-      this.store.isLoaded = true;
-      return this.store.surchargeList;
+      if (currentRequestVersion === this.requestVersion) {
+        this.store.surchargeList = [];
+        this.store.channel = channel;
+        this.store.isLoaded = true;
+      }
+      return [];
     } finally {
-      this.loadingPromise = null;
+      this.loadingPromises.delete(channel);
     }
   }
 };

package/lib/modules/SurchargeList/types.d.ts

@@ -4,8 +4,12 @@ export interface SurchargeListItem {
 export interface SurchargeListState {
     surchargeList: SurchargeListItem[];
     isLoaded: boolean;
+    channel?: string;
+}
+export interface SurchargeListQuery {
+    channel?: string;
 }
 export interface SurchargeListModuleAPI {
-    getSurchargeList(): Promise<SurchargeListItem[]>;
-    refreshSurchargeList(): Promise<SurchargeListItem[]>;
+    getSurchargeList(query?: SurchargeListQuery): Promise<SurchargeListItem[]>;
+    refreshSurchargeList(query?: SurchargeListQuery): Promise<SurchargeListItem[]>;
 }

package/lib/server/index.d.ts

@@ -475,6 +475,9 @@ declare class Server {
     private shouldLookupLocalPrintOrder;
     private getLocalPrintOrderLookup;
     private handleLocalPrintOrder;
+    private handleMachinecodeBatchMeta;
+    private resolveMachinecodeBatchMetadataLookup;
+    private syncMachinecodeRedeemStatusToLocalOrder;
     private handleOrderCheckoutSubmit;
     private handleSyncCheckoutSubmit;
     private handlePendingSyncCheckoutOrder;
@@ -486,6 +489,11 @@ declare class Server {
     private sumPaidOrderPayments;
     private toAmountNumber;
     private buildSmallTicketProductMap;
+    private collectSalesDetailProductIds;
+    private buildSalesDetailProductSnapshotMap;
+    private withProductCatalogSnapshots;
+    private withBundleCatalogSnapshots;
+    private withSalesDetailProductSnapshots;
     private withPendingSyncProductTitles;
     private buildProductTitleSnapshot;
     private getProductTitleSnapshotCurrentLocale;

package/lib/server/index.js

@@ -654,7 +654,8 @@ var Server = class {
           checkoutData,
           order: printableOrder,
           response: null,
-          requireFullyPaid: false
+          requireFullyPaid: false,
+          isManualPrint: true
         });
         return {
           code: 200,
@@ -676,6 +677,97 @@ var Server = class {
         };
       }
     };
+    this.handleMachinecodeBatchMeta = async ({ data }) => {
+      var _a, _b;
+      const title = "handleMachinecodeBatchMeta";
+      const backendPath = "/shop/machinecode/batch";
+      const ids = Array.isArray(data == null ? void 0 : data.ids) ? data.ids : [];
+      const status = data == null ? void 0 : data.status;
+      this.logInfo(`${title}: 开始处理`, {
+        backendPath,
+        batchSize: ids.length,
+        status,
+        order_lookup: this.resolveMachinecodeBatchMetadataLookup(data) ?? null
+      });
+      if (ids.length === 0) {
+        return {
+          code: 200,
+          status: true,
+          message: "",
+          data: []
+        };
+      }
+      if (status !== "used" && status !== "unused") {
+        return {
+          code: 400,
+          status: false,
+          message: "无效的核销状态",
+          data: null
+        };
+      }
+      try {
+        await this.syncMachinecodeRedeemStatusToLocalOrder(data, ids, status);
+      } catch (error) {
+        const message = this.getUnknownErrorMessage(error);
+        this.logError(`${title}: 本地订单核销状态更新失败`, {
+          error: message,
+          error_detail: this.normalizeUnknownError(error)
+        });
+        return {
+          code: 500,
+          status: false,
+          message,
+          data: null
+        };
+      }
+      if (!((_b = (_a = this.app) == null ? void 0 : _a.request) == null ? void 0 : _b.post)) {
+        this.logError(`${title}: app.request 不可用`, { backendPath });
+        return {
+          code: 500,
+          status: false,
+          message: "app.request 不可用",
+          data: null
+        };
+      }
+      try {
+        const response = await this.app.request.post(backendPath, {
+          ids,
+          status
+        }, {
+          isShopApi: true,
+          customToast: () => {
+          }
+        });
+        return {
+          code: (response == null ? void 0 : response.code) ?? 200,
+          status: (response == null ? void 0 : response.status) ?? true,
+          message: (response == null ? void 0 : response.message) ?? "",
+          data: (response == null ? void 0 : response.data) ?? response
+        };
+      } catch (error) {
+        const backendError = this.extractBackendErrorResponse(error);
+        if (backendError) {
+          return {
+            code: backendError.code ?? 500,
+            status: backendError.status ?? false,
+            message: backendError.message ?? "后端拒绝 batch-metadata",
+            data: backendError.data ?? null
+          };
+        }
+        const message = this.getUnknownErrorMessage(error);
+        this.logError(`${title}: 请求失败`, {
+          backendPath,
+          error: message,
+          error_detail: this.normalizeUnknownError(error)
+        });
+        return {
+          code: 500,
+          status: false,
+          message,
+          data: null
+        };
+      }
+    };
     this.handleOrderSalesDetail = async ({ url, data, path }) => {
       var _a;
       const requestPath = this.parseRequestPath(url, path);
@@ -692,12 +784,13 @@ var Server = class {
       if (!this.shouldForceRemoteSalesDetail(data)) {
         const localOrder = await this.order.getLocalOrderByLookup(lookup);
         if (localOrder) {
+          const enrichedOrder = await this.withSalesDetailProductSnapshots(localOrder);
           this.logInfo("handleOrderSalesDetail: 命中本地订单", { lookup });
           return {
             code: 200,
             status: true,
             message: "",
-            data: localOrder
+            data: enrichedOrder
           };
         }
       }
@@ -744,15 +837,16 @@ var Server = class {
           };
         }
         this.logInfo("handleOrderSalesDetail: 远端订单已同步到本地", { lookup });
+        const enrichedOrder = await this.withSalesDetailProductSnapshots(savedOrder);
         return {
           code: 200,
           status: true,
           message: "",
-          data: savedOrder
+          data: enrichedOrder
         };
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        this.logError("handleOrderSalesDetail: 请求失败", {
+        this.logInfo("handleOrderSalesDetail: 请求失败", {
           lookup,
           backendPath,
           error: errorMessage
@@ -1758,6 +1852,16 @@ var Server = class {
         method: "post",
         path: "/shop/local/print-order",
         handler: this.handleLocalPrintOrder.bind(this)
+      },
+      {
+        method: "post",
+        path: "/shop/machinecode/batch",
+        handler: this.handleMachinecodeBatchMeta.bind(this)
+      },
+      {
+        method: "post",
+        path: "/machinecode/batch",
+        handler: this.handleMachinecodeBatchMeta.bind(this)
       }
     ]);
     this.registerPrefixRoutes([
@@ -2822,10 +2926,12 @@ var Server = class {
         action: "print_all",
         device_id: params.deviceId ?? deviceId,
         payload: {
-          type: params.receiptOnly ? "0" : "99",
+          type: params.isManualPrint ? "0" : "99",
           data: params.receiptOnly ? {
             order_id: printIdentity,
-            small_ticket_data: (_b = (_a = params.syncedOrder) == null ? void 0 : _a.payment_info) == null ? void 0 : _b.small_ticket_data
+            small_ticket_data: (_b = (_a = params.syncedOrder) == null ? void 0 : _a.payment_info) == null ? void 0 : _b.small_ticket_data,
+            skip_wristband: true,
+            skip_voucher: true
           } : {
             order_id: printIdentity,
             machine_code_print_info: (_d = (_c = params.syncedOrder) == null ? void 0 : _c.payment_info) == null ? void 0 : _d.machine_code_print_info,
@@ -2836,7 +2942,7 @@ var Server = class {
         idempotency_key: this.buildPrintOtherReceiptIdempotencyKey(params.syncedOrder, {
           receiptOnly: params.receiptOnly
         }),
-        name: "打印转发",
+        name: "PRINT_V1",
         source: "server",
         source_type: "order",
         source_id: printIdentity
@@ -2876,7 +2982,8 @@ var Server = class {
       checkoutData: params.checkoutData,
       syncedOrder: printableOrder,
       response: params.response,
-      receiptOnly: true
+      receiptOnly: true,
+      isManualPrint: params.isManualPrint
     });
     return { printed: true, order: printableOrder };
   }
@@ -2894,6 +3001,110 @@ var Server = class {
     }
     return void 0;
   }
+  resolveMachinecodeBatchMetadataLookup(data) {
+    const candidates = [
+      data == null ? void 0 : data.order_lookup,
+      data == null ? void 0 : data.orderLookup,
+      data == null ? void 0 : data.external_sale_number,
+      data == null ? void 0 : data.externalSaleNumber,
+      data == null ? void 0 : data.order_id,
+      data == null ? void 0 : data.orderId,
+      data == null ? void 0 : data.order_number,
+      data == null ? void 0 : data.orderNumber,
+      data == null ? void 0 : data.shop_order_number,
+      data == null ? void 0 : data.shopOrderNumber,
+      data == null ? void 0 : data.shop_full_order_number,
+      data == null ? void 0 : data.shopFullOrderNumber
+    ];
+    return candidates.find((candidate) => candidate !== void 0 && candidate !== null && candidate !== "");
+  }
+  async syncMachinecodeRedeemStatusToLocalOrder(data, ids, status) {
+    var _a;
+    const title = "handleMachinecodeBatchMetadata";
+    const lookup = this.resolveMachinecodeBatchMetadataLookup(data);
+    if (lookup === void 0) {
+      this.logWarning(`${title}: order lookup 缺失，跳过本地订单核销状态更新`, {
+        batchSize: ids.length,
+        status
+      });
+      return;
+    }
+    if (!((_a = this.order) == null ? void 0 : _a.getLocalOrderByLookup)) {
+      this.logWarning(`${title}: Order 模块未注册，跳过本地订单核销状态更新`, {
+        lookup,
+        status
+      });
+      return;
+    }
+    const localOrder = await this.order.getLocalOrderByLookup(lookup);
+    if (!localOrder) {
+      this.logWarning(`${title}: 本地订单不存在，跳过核销状态更新`, {
+        lookup,
+        status
+      });
+      return;
+    }
+    const voucherIdSet = new Set(
+      ids.filter((id) => id !== void 0 && id !== null && id !== "").map((id) => String(id))
+    );
+    if (voucherIdSet.size === 0) {
+      this.logWarning(`${title}: voucher ids 缺失，跳过本地订单核销状态更新`, {
+        lookup,
+        status
+      });
+      return;
+    }
+    const vouchers = Array.isArray(localOrder.vouchers) ? localOrder.vouchers : [];
+    let hasUpdatedVoucher = false;
+    const nextVouchers = vouchers.map((voucher) => {
+      const voucherId = voucher == null ? void 0 : voucher.voucher_id;
+      if (voucherId === void 0 || voucherId === null)
+        return voucher;
+      if (!voucherIdSet.has(String(voucherId)))
+        return voucher;
+      hasUpdatedVoucher = true;
+      return {
+        ...voucher,
+        status
+      };
+    });
+    if (!hasUpdatedVoucher) {
+      this.logWarning(`${title}: 本地订单未命中任何 voucher，跳过核销状态更新`, {
+        lookup,
+        voucher_ids: Array.from(voucherIdSet),
+        status
+      });
+      return;
+    }
+    if (typeof this.order.overwriteExistingOrder === "function") {
+      await this.order.overwriteExistingOrder({
+        ...localOrder,
+        vouchers: nextVouchers
+      });
+      this.logInfo(`${title}: 本地订单 vouchers 核销状态已更新`, {
+        lookup,
+        updatedCount: voucherIdSet.size,
+        status
+      });
+      return;
+    }
+    if ((data == null ? void 0 : data.external_sale_number) && typeof this.order.markOrderSyncedByExternalSaleNumber === "function") {
+      await this.order.markOrderSyncedByExternalSaleNumber({
+        externalSaleNumber: data.external_sale_number,
+        patch: { vouchers: nextVouchers }
+      });
+      this.logInfo(`${title}: 本地订单 vouchers 核销状态已更新`, {
+        lookup,
+        updatedCount: voucherIdSet.size,
+        status
+      });
+      return;
+    }
+    this.logWarning(`${title}: Order 模块不支持本地订单覆盖，跳过核销状态更新`, {
+      lookup,
+      status
+    });
+  }
   async handleOrderCheckoutSubmit(params) {
     const { backendPath, data, title } = params;
     this.logInfo(`${title}: 开始处理`, {
@@ -3091,11 +3302,8 @@ var Server = class {
     );
   }
   shouldBuildSmallTicketData(order) {
-    var _a;
     if (!order || typeof order !== "object")
       return false;
-    if ((0, import_small_ticket.hasSmallTicketData)((_a = order.payment_info) == null ? void 0 : _a.small_ticket_data))
-      return false;
     return Number(order.small_ticket_data_flag ?? order.smallTicketDataFlag ?? 0) === 1;
   }
   shouldPrintSyncedOrder(params) {
@@ -3191,6 +3399,123 @@ var Server = class {
       return map;
     }, {});
   }
+  collectSalesDetailProductIds(order) {
+    const products = Array.isArray(order == null ? void 0 : order.products) ? order.products : [];
+    const productIds = /* @__PURE__ */ new Set();
+    const addProductId = (rawProductId) => {
+      if (rawProductId === void 0 || rawProductId === null || rawProductId === "")
+        return;
+      const productId = Number(rawProductId);
+      if (Number.isFinite(productId))
+        productIds.add(productId);
+    };
+    products.forEach((product) => {
+      addProductId((product == null ? void 0 : product.product_id) ?? (product == null ? void 0 : product.id));
+      if (Array.isArray(product == null ? void 0 : product.product_bundle)) {
+        product.product_bundle.forEach((bundle) => {
+          addProductId((bundle == null ? void 0 : bundle.bundle_product_id) ?? (bundle == null ? void 0 : bundle._bundle_product_id) ?? (bundle == null ? void 0 : bundle.product_id));
+        });
+      }
+    });
+    return Array.from(productIds);
+  }
+  async buildSalesDetailProductSnapshotMap(order) {
+    var _a;
+    const productIds = this.collectSalesDetailProductIds(order);
+    const getSnapshots = (_a = this.products) == null ? void 0 : _a.getProductSnapshotsByIds;
+    if (!productIds.length || typeof getSnapshots !== "function")
+      return {};
+    try {
+      return await getSnapshots.call(this.products, productIds);
+    } catch (error) {
+      this.logWarning("buildSalesDetailProductSnapshotMap: 查询本地商品快照失败", {
+        product_ids: productIds,
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return {};
+    }
+  }
+  withProductCatalogSnapshots(product, snapshotMap) {
+    if (!product || typeof product !== "object")
+      return product;
+    const rawProductId = (product == null ? void 0 : product.product_id) ?? (product == null ? void 0 : product.id);
+    if (rawProductId === void 0 || rawProductId === null || rawProductId === "")
+      return product;
+    const productId = Number(rawProductId);
+    if (!Number.isFinite(productId))
+      return product;
+    const snapshot = snapshotMap[String(productId)];
+    if (!snapshot)
+      return product;
+    const shouldFillCover = (product.product_cover === void 0 || product.product_cover === null || product.product_cover === "") && snapshot.cover !== void 0 && snapshot.cover !== null && snapshot.cover !== "";
+    const metadata = product.metadata && typeof product.metadata === "object" ? product.metadata : {};
+    const shouldFillHolderConfig = (metadata.holder_config === void 0 || metadata.holder_config === null) && snapshot.holder_config !== void 0 && snapshot.holder_config !== null;
+    if (!shouldFillCover && !shouldFillHolderConfig)
+      return product;
+    return {
+      ...product,
+      ...shouldFillCover ? { product_cover: snapshot.cover } : {},
+      ...shouldFillHolderConfig ? {
+        metadata: {
+          ...metadata,
+          holder_config: snapshot.holder_config
+        }
+      } : {}
+    };
+  }
+  withBundleCatalogSnapshots(product, snapshotMap) {
+    if (!Array.isArray(product == null ? void 0 : product.product_bundle))
+      return product;
+    let hasChanged = false;
+    const productBundle = product.product_bundle.map((bundle) => {
+      if (!bundle || typeof bundle !== "object")
+        return bundle;
+      const rawProductId = (bundle == null ? void 0 : bundle.bundle_product_id) ?? (bundle == null ? void 0 : bundle._bundle_product_id) ?? (bundle == null ? void 0 : bundle.product_id);
+      if (rawProductId === void 0 || rawProductId === null || rawProductId === "")
+        return bundle;
+      const productId = Number(rawProductId);
+      if (!Number.isFinite(productId))
+        return bundle;
+      const snapshot = snapshotMap[String(productId)];
+      const shouldFillCover = (bundle.cover === void 0 || bundle.cover === null || bundle.cover === "") && (snapshot == null ? void 0 : snapshot.cover) !== void 0 && snapshot.cover !== null && snapshot.cover !== "";
+      if (!shouldFillCover)
+        return bundle;
+      hasChanged = true;
+      return {
+        ...bundle,
+        cover: snapshot.cover
+      };
+    });
+    if (!hasChanged)
+      return product;
+    return {
+      ...product,
+      product_bundle: productBundle
+    };
+  }
+  async withSalesDetailProductSnapshots(order) {
+    const products = Array.isArray(order == null ? void 0 : order.products) ? order.products : null;
+    if (!(products == null ? void 0 : products.length))
+      return order;
+    const snapshotMap = await this.buildSalesDetailProductSnapshotMap(order);
+    if (!Object.keys(snapshotMap).length)
+      return order;
+    let hasChanged = false;
+    const enrichedProducts = products.map((product) => {
+      const productWithBundleSnapshots = this.withBundleCatalogSnapshots(product, snapshotMap);
+      const nextProduct = this.withProductCatalogSnapshots(productWithBundleSnapshots, snapshotMap);
+      if (nextProduct !== product)
+        hasChanged = true;
+      return nextProduct;
+    });
+    if (!hasChanged)
+      return order;
+    const enrichedOrder = {
+      ...order,
+      products: enrichedProducts
+    };
+    return enrichedOrder;
+  }
   withPendingSyncProductTitles(order, productMap) {
     const products = Array.isArray(order.products) ? order.products : null;
     if (!(products == null ? void 0 : products.length))

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

@@ -15,7 +15,6 @@ export declare class OrderModule extends BaseModule implements Module {
     private syncTimer?;
     private isProcessingSyncBatch;
     private isIdlePhase;
-    private resourceIdIndex;
     private logger;
     private storage;
     private orderSQLiteSaveQueue; /** 按 storageKey 记录最近一次 SQLite 写入来源与时间，用于去重 */
@@ -44,6 +43,16 @@ export declare class OrderModule extends BaseModule implements Module {
      */
     private logError;
     private logWarning;
+    /**
+     * 在订单进入内存或 SQLite 前统一压缩子项强身份重复并补齐协议 UID。
+     * 仅记录计数与订单标识，不输出商品、预约、支付或客户明细。
+     */
+    private normalizeOrderCollectionsForIngress;
+    /**
+     * incoming 决定权威成员集合；同一持久化行仍从 existing 补齐 incoming 省略的本地展示字段。
+     */
+    private mergeAuthoritativeOrderCollection;
+    private reconcileOverwriteOrderCollections;
     /**
      * 记录订单最近一次 SQLite 写入，供 pubsub 回声去重使用。
      *
@@ -89,7 +98,6 @@ export declare class OrderModule extends BaseModule implements Module {
      * @returns 刷新后的订单列表
      */
     silentRefresh(): Promise<OrderData[]>;
-    getOrdersByResourceId(resourceId: string | number): OrderData[];
     private normalizeOrderForMemoryList;
     /**
      * 仅覆盖本地已存在的订单；不存在则直接跳过，不落库、不 emit。
@@ -126,7 +134,6 @@ export declare class OrderModule extends BaseModule implements Module {
     private isBlankIdentityValue;
     private getOrderIdentityEntries;
     private getOrderIdentityKeys;
-    private extractResourceIds;
     private getOrderDateKey;
     /**
      * 初始化 OrderDataSource 实例
@@ -175,6 +182,28 @@ export declare class OrderModule extends BaseModule implements Module {
      * 将增量订单合并到 store
      */
     private mergeOrdersToStore;
+    /**
+     * 在身份索引中查找与目标订单共享任一身份键的已存在订单下标。
+     * 返回所有命中键里最小的下标，等价于原 findOrderIndexByIdentity 的「取首个匹配」语义。
+     *
+     * @example
+     * const idx = this.lookupOrderIndexByIdentityKeys(identityKeyToIndex, freshIdentityKeys)
+     */
+    private lookupOrderIndexByIdentityKeys;
+    private isRemoteEchoMergeSource;
+    /**
+     * 将订单的全部身份键登记到索引并指向其在列表中的下标。
+     * 合并后订单新增的身份字段（如挂单同步后拿到 order_id）也会被登记。
+     *
+     * @example
+     * this.registerOrderIdentityKeys(identityKeyToIndex, mergedOrder, matchIndex)
+     */
+    private registerOrderIdentityKeys;
+    /**
+     * 合并热路径去重兜底：默认直接返回原列表（增量索引已保证无重复）。
+     * 仅当 ORDER_MERGE_SELF_CHECK 开启时，额外做一次全表压缩并在发现残留重复时告警。
+     */
+    private runOrderStoreSelfCheck;
     private normalizeOrderSyncMessage;
     private normalizeOrderSyncPayload;
     private uniqueOrderIds;
@@ -193,10 +222,6 @@ export declare class OrderModule extends BaseModule implements Module {
     private findOrderIndexByIdentity;
     private getOrderCompletenessScore;
     private pickPreferredOrder;
-    private getProductIdentityKeys;
-    private mergeOrderProductLists;
-    private getPaymentMergeKey;
-    private mergeOrderPaymentLists;
     private mergeOrderRecords;
     private summarizeDuplicateOrders;
     private logDuplicateOrders;