@pisell/pisellos 2.2.152 → 2.2.154

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

@@ -2,7 +2,7 @@ import { Module, PisellCore } from '../../../types';
 import { BaseModule } from '../../../modules/BaseModule';
 import { ProductData } from '../../../modules/Product/types';
 import type { RouteDefinition } from '../../types';
-import { ProductFormatter, ProductFormatterContext } from './types';
+import { ProductIdScope, ProductFormatter, ProductFormatterContext } from './types';
 /**
  * Products 模块 - 用于获取和管理完整的商品详细数据
  * 相比 ProductList 模块，Products 会获取所有详细信息并缓存
@@ -80,10 +80,12 @@ export declare class ProductsModule extends BaseModule implements Module {
      * @param extraContext 额外的上下文数据（可选，由 Server 层传入）
      * @param options 可选参数
      * @param options.changedIds 变更的商品 IDs，非空时仅对这些商品增量执行 prepare 并更新缓存
+     * @param options.productIds 指定商品 IDs，仅对这些商品执行价格计算；不传则处理全量
      * @returns 应用了价格的商品列表
      */
     getProductsWithPrice(schedule_date: string, extraContext?: Partial<ProductFormatterContext>, options?: {
         changedIds?: number[];
+        productIds?: number[];
     }): Promise<ProductData[]>;
     /**
      * 准备带价格的商品数据（通过格式化器流程处理）
@@ -96,6 +98,11 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     private prepareProductsWithPrice;
     private getProductsPriceCacheKey;
+    private normalizeProductIds;
+    /**
+     * 按轻量范围返回商品 ID，不做 structuredClone。
+     */
+    getProductIdsByScope(scope: ProductIdScope): number[];
     /**
      * 应用所有已注册的格式化器
      * @param products 商品列表
@@ -173,6 +180,10 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 仅供内部 formatter 流程使用，因为 formatter 会创建新对象
      */
     private getProductsRef;
+    /**
+     * 按 ID 从 Map 取商品引用，供内部 formatter 流程使用。
+     */
+    private getProductsRefByIds;
     /**
      * 根据ID获取单个商品（从内存缓存）
      * 使用 Map 快速查询，时间复杂度 O(1)

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

@@ -326,12 +326,16 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    * @param extraContext 额外的上下文数据（可选，由 Server 层传入）
    * @param options 可选参数
    * @param options.changedIds 变更的商品 IDs，非空时仅对这些商品增量执行 prepare 并更新缓存
+   * @param options.productIds 指定商品 IDs，仅对这些商品执行价格计算；不传则处理全量
    * @returns 应用了价格的商品列表
    */
   async getProductsWithPrice(schedule_date, extraContext, options) {
+    var _a;
     const t0 = performance.now();
-    const cacheKey = this.getProductsPriceCacheKey(schedule_date, extraContext);
-    const changedIds = options == null ? void 0 : options.changedIds;
+    const scopedProductIds = this.normalizeProductIds(options == null ? void 0 : options.productIds);
+    const cacheKey = this.getProductsPriceCacheKey(schedule_date, extraContext, scopedProductIds);
+    const scopedProductIdSet = scopedProductIds ? new Set(scopedProductIds) : void 0;
+    const changedIds = scopedProductIdSet ? (_a = options == null ? void 0 : options.changedIds) == null ? void 0 : _a.filter((id) => scopedProductIdSet.has(id)) : options == null ? void 0 : options.changedIds;
     if (this.productsPriceCache.has(cacheKey)) {
       const cachedProducts = this.productsPriceCache.get(cacheKey);
       if (changedIds && changedIds.length > 0) {
@@ -398,8 +402,15 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       });
       return cachedProducts;
     }
-    this.logInfo("商品价格缓存未命中，准备获取", { cacheKey });
-    const result = await this.prepareProductsWithPrice(schedule_date, extraContext);
+    this.logInfo("商品价格缓存未命中，准备获取", {
+      cacheKey,
+      scopedProductCount: scopedProductIds == null ? void 0 : scopedProductIds.length
+    });
+    const result = await this.prepareProductsWithPrice(
+      schedule_date,
+      extraContext,
+      scopedProductIds ? { productIds: scopedProductIds } : void 0
+    );
     this.productsPriceCache.set(cacheKey, result);
     this.logInfo("商品价格已缓存", {
       cacheKey,
@@ -425,7 +436,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     var _a, _b;
     const tTotal = performance.now();
     const targetIds = options == null ? void 0 : options.productIds;
-    const isIncremental = targetIds && targetIds.length > 0;
+    const isIncremental = Array.isArray(targetIds);
     this.logInfo("prepareProductsWithPrice 开始处理", {
       schedule_date,
       mode: isIncremental ? "incremental" : "full",
@@ -435,8 +446,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       let products;
       let ids;
       if (isIncremental) {
-        const idSet = new Set(targetIds);
-        products = this.getProductsRef().filter((p) => idSet.has(p.id));
+        products = this.getProductsRefByIds(targetIds);
         ids = products.map((p) => p.id);
       } else {
         products = this.getProductsRef();
@@ -499,9 +509,47 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     }
     return [];
   }
-  getProductsPriceCacheKey(schedule_date, extraContext) {
+  getProductsPriceCacheKey(schedule_date, extraContext, productIds) {
     const datetime = (extraContext == null ? void 0 : extraContext.schedule_datetime) || schedule_date;
-    return `${datetime}:customer:${(extraContext == null ? void 0 : extraContext.customer_id) ?? ""}`;
+    const productScope = productIds ? `:products:${productIds.join(",")}` : "";
+    return `${datetime}:customer:${(extraContext == null ? void 0 : extraContext.customer_id) ?? ""}${productScope}`;
+  }
+  normalizeProductIds(productIds) {
+    if (!Array.isArray(productIds))
+      return void 0;
+    return Array.from(new Set(
+      productIds.map((id) => Number(id)).filter((id) => Number.isFinite(id))
+    )).sort((a, b) => a - b);
+  }
+  /**
+   * 按轻量范围返回商品 ID，不做 structuredClone。
+   */
+  getProductIdsByScope(scope) {
+    const productIds = this.normalizeProductIds(scope.productIds) || [];
+    const collectionIds = this.normalizeProductIds(scope.collectionIds) || [];
+    if (scope.isAllProducts) {
+      return this.getProductsRef().map((product) => product.id);
+    }
+    if (productIds.length === 0 && collectionIds.length === 0)
+      return [];
+    const result = /* @__PURE__ */ new Set();
+    for (const id of productIds) {
+      if (this.store.map.has(id))
+        result.add(id);
+    }
+    if (collectionIds.length === 0)
+      return Array.from(result);
+    const collectionIdSet = new Set(collectionIds);
+    for (const product of this.getProductsRef()) {
+      if (result.has(product.id))
+        continue;
+      if (!Array.isArray(product.collection))
+        continue;
+      const isInCollection = product.collection.some((collection) => collectionIdSet.has(collection.id));
+      if (isInCollection)
+        result.add(product.id);
+    }
+    return Array.from(result);
   }
   /**
    * 应用所有已注册的格式化器
@@ -776,6 +824,18 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
   getProductsRef() {
     return this.store.list;
   }
+  /**
+   * 按 ID 从 Map 取商品引用，供内部 formatter 流程使用。
+   */
+  getProductsRefByIds(ids) {
+    const products = [];
+    for (const id of ids) {
+      const product = this.store.map.get(id);
+      if (product)
+        products.push(product);
+    }
+    return products;
+  }
   /**
    * 根据ID获取单个商品（从内存缓存）
    * 使用 Map 快速查询，时间复杂度 O(1)

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

@@ -17,6 +17,17 @@ export interface FormattedProductData extends ProductData {
     /** 购物车详情值 */
     cartDetailValue?: any;
 }
+/**
+ * 商品轻量查询范围
+ */
+export interface ProductIdScope {
+    /** 是否返回全部商品 ID */
+    isAllProducts?: boolean;
+    /** 指定商品 ID */
+    productIds?: number[];
+    /** 指定商品集合 ID */
+    collectionIds?: number[];
+}
 /**
  * 加载报价单商品价格参数
  */

package/lib/server/utils/product.js

@@ -195,7 +195,7 @@ var formatDataKey = (data) => {
   }
   if ((_a = _data == null ? void 0 : _data.option) == null ? void 0 : _a.length) {
     for (const item of _data.option) {
-      let str = `_${item.option_group_id}_${item.product_option_item_id}`;
+      let str = `_${item.option_group_id}_${item.option_group_item_id}`;
       key += str;
       rowKey += `${str}_${item.quantity || item.num}`;
     }
@@ -207,7 +207,7 @@ var formatDataKey = (data) => {
       rowKey += `${str}_${item.quantity || item.num}`;
       if (item == null ? void 0 : item.option) {
         for (const opt of item.option) {
-          let str2 = `_${opt.option_group_id}_${opt.product_option_item_id}`;
+          let str2 = `_${opt.option_group_id}_${opt.option_group_item_id}`;
           key += str2;
           rowKey += `${str2}_${opt.quantity || opt.num}`;
         }

package/lib/solution/BaseSales/index.d.ts

@@ -8,12 +8,15 @@ import type { Discount } from '../../modules/Discount/types';
 import { RequestPlugin, WindowPlugin } from '../../plugins';
 export * from './types';
 import { ProductList } from '../../modules/ProductList';
+import { PaymentModule } from '../../modules/Payment';
 import type { SalesSummaryModule } from '../../modules/SalesSummary';
 import type { ScheduleModule } from '../../modules/Schedule';
 import type { ISalesDetail, ISalesDetailHeader, ISalesBooking, ISalesPayment, ISalesSurcharge } from './utils/parseSalesResponse';
+import { type TransformBaseProductToOrderProductParams } from './utils/transformBaseProductToOrderProduct';
 export interface BaseSalesState {
     order?: OrderModule;
     products?: ProductList;
+    payment?: PaymentModule;
     salesSummary?: SalesSummaryModule;
     schedule?: ScheduleModule;
 }
@@ -22,6 +25,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     protected defaultVersion: string;
     isSolution: boolean;
     protected initializeOptions: ModuleOptions;
+    private logger;
     protected store: BaseSalesState;
     protected otherParams: Record<string, any>;
     protected cacheId: string | undefined;
@@ -35,15 +39,29 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     constructor(name?: string, version?: string);
     /**
      * 子类可覆盖此方法以追加/收敛要注册的子模块。
-     * 默认包含通用销售模块：products / order / salesSummary / schedule。
+     * 默认包含通用销售模块：products / order / salesSummary / schedule / payment。
      */
     protected getRegisteredModuleNames(): readonly string[];
+    /**
+     * 记录信息日志
+     */
+    private logInfo;
+    /**
+     * 记录警告日志
+     */
+    private logWarning;
+    /**
+     * 记录错误日志
+     */
+    private logError;
+    get payment(): PaymentModule | undefined;
     /**
      * 工厂入口：根据子模块名实例化对应模块。
      * 默认使用 BookingByStep 公共 `createModule`。子类若需引入额外类型（如 customer），
      * 可覆盖此方法并把未识别的 name 委托给 `super.createSubModule(name)`。
      */
     protected createSubModule(moduleName: string): Module | null;
+    protected getSubModuleHooks(moduleName: string): any;
     /**
      * 读取 sessionStorage[this.name][cacheId]，作为子模块 initialState 的来源。
      * sessionStorage 损坏时静默忽略，按空状态注册。
@@ -80,7 +98,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     getOrderAmountSnapshot(): import("../../modules/Order/types").OrderAmountSnapshot | null;
     getTempOrderNote(): string;
     updateTempOrderNote(note: string): string;
-    updateOrderShopDiscount(amount: string | number): string;
+    updateTempOrderShopDiscount(amount: string | number): string;
+    updateTempOrderContactsInfo(contactsInfo: Record<string, any> | null): Record<string, any> | null;
     private ensureTempOrder;
     addNewOrder(): Promise<import("../../modules/Order/types").OrderTempOrder>;
     saveDraft(): Promise<void>;
@@ -124,6 +143,10 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     deleteOrderPayment(paymentIdentity: string | number): OrderPaymentData[];
     /** 覆盖 wallet pass 支付项，同时保留普通支付项。 */
     updateVoucherOrderPayments(payments: OrderPaymentSource[]): OrderPaymentData[];
+    private getWalletProductList;
+    initWalletData(params?: {
+        order_wait_pay_amount?: number;
+    }): Promise<import("../../modules/Payment").WalletInitializationResult>;
     /**
      * 更新当前订单客户字段。
      *
@@ -159,6 +182,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
         order_ids?: Array<number | string>;
         submitBeforeSend?: boolean;
     }): Promise<T>;
+    transformBaseProductToOrderProduct(params: TransformBaseProductToOrderProductParams): import("./utils/transformBaseProductToOrderProduct").BaseProductOrderProductInput | null;
     addProductToOrder(product: Partial<BaseSalesOrderProduct> & BaseSalesOrderProductIdentity, booking?: AddProductBookingInput): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateProductInOrder(params: UpdateProductInOrderParams): Promise<import("../../modules/Order/types").OrderProduct[]>;
     /**

package/lib/solution/BaseSales/index.js

@@ -40,6 +40,7 @@ var import_types = require("../BookingByStep/types");
 var import_utils = require("../../modules/Order/utils");
 var import_dayjs = __toESM(require("dayjs"));
 __reExport(BaseSales_exports, require("./types"), module.exports);
+var import_transformBaseProductToOrderProduct = require("./utils/transformBaseProductToOrderProduct");
 var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   constructor(name, version) {
     super(name, version);
@@ -47,6 +48,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     this.defaultVersion = "1.0.0";
     this.isSolution = true;
     this.initializeOptions = {};
+    // LoggerManager 实例
     this.store = {
       order: void 0
     };
@@ -56,10 +58,52 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   }
   /**
    * 子类可覆盖此方法以追加/收敛要注册的子模块。
-   * 默认包含通用销售模块：products / order / salesSummary / schedule。
+   * 默认包含通用销售模块：products / order / salesSummary / schedule / payment。
    */
   getRegisteredModuleNames() {
-    return ["products", "order", "salesSummary", "schedule"];
+    return ["products", "order", "salesSummary", "schedule", "payment"];
+  }
+  /**
+   * 记录信息日志
+   */
+  logInfo(title, metadata) {
+    if (this.logger) {
+      const tempOrder = this.getTempOrder();
+      this.logger.addLog({
+        type: "info",
+        title: `[BaseSales]  ${tempOrder == null ? void 0 : tempOrder.order_id} ${tempOrder == null ? void 0 : tempOrder.external_sale_number} ${title}`,
+        metadata: metadata || {}
+      });
+    }
+  }
+  /**
+   * 记录警告日志
+   */
+  logWarning(title, metadata) {
+    if (this.logger) {
+      const tempOrder = this.getTempOrder();
+      this.logger.addLog({
+        type: "warning",
+        title: `[BaseSales] ${tempOrder == null ? void 0 : tempOrder.order_id} ${tempOrder == null ? void 0 : tempOrder.external_sale_number} ${title}`,
+        metadata: metadata || {}
+      });
+    }
+  }
+  /**
+   * 记录错误日志
+   */
+  logError(title, metadata) {
+    if (this.logger) {
+      const tempOrder = this.getTempOrder();
+      this.logger.addLog({
+        type: "error",
+        title: `[BaseSales] ${tempOrder == null ? void 0 : tempOrder.order_id} ${tempOrder == null ? void 0 : tempOrder.external_sale_number} ${title}`,
+        metadata: metadata || {}
+      });
+    }
+  }
+  get payment() {
+    return this.store.payment;
   }
   /**
    * 工厂入口：根据子模块名实例化对应模块。
@@ -69,6 +113,16 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   createSubModule(moduleName) {
     return (0, import_types.createModule)(moduleName, this.name);
   }
+  getSubModuleHooks(moduleName) {
+    var _a, _b;
+    const optionHooks = this.initializeOptions.hooks || {};
+    const otherHooks = this.otherParams.hooks || {};
+    if (moduleName === "order") {
+      const directOrderHooks = optionHooks;
+      return optionHooks.order || ((_a = this.otherParams.order) == null ? void 0 : _a.hooks) || otherHooks.order || (directOrderHooks.onBeforeMergeProductToOrder ? directOrderHooks : void 0);
+    }
+    return optionHooks[moduleName] || ((_b = this.otherParams[moduleName]) == null ? void 0 : _b.hooks) || otherHooks[moduleName];
+  }
   /**
    * 读取 sessionStorage[this.name][cacheId]，作为子模块 initialState 的来源。
    * sessionStorage 损坏时静默忽略，按空状态注册。
@@ -94,6 +148,12 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     this.cacheId = (_a = this.otherParams) == null ? void 0 : _a.cacheId;
     this.window = core.getPlugin("window");
     this.request = core.getPlugin("request");
+    const appPlugin = core.getPlugin("app");
+    if (!appPlugin) {
+      throw new Error("Checkout 解决方案需要 app 插件支持");
+    }
+    const app = appPlugin.getApp();
+    this.logger = app.logger;
     const targetCacheData = this.readSessionCacheData();
     const moduleNames = this.getRegisteredModuleNames();
     moduleNames.forEach((step) => {
@@ -101,9 +161,11 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       if (!targetModule) {
         throw new Error(`模块 ${step} 不存在`);
       }
+      const hooks = this.getSubModuleHooks(step);
       this.store[step] = targetModule;
       this.core.registerModule(targetModule, {
         initialState: (targetCacheData == null ? void 0 : targetCacheData[targetModule.name]) || {},
+        ...hooks ? { hooks } : {},
         otherParams: {
           ...this.otherParams,
           salesSummaryModuleName: `${this.name}_salesSummary`,
@@ -259,11 +321,16 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw error;
     }
   }
-  updateOrderShopDiscount(amount) {
+  updateTempOrderShopDiscount(amount) {
     if (!this.store.order)
       throw new Error("order 模块未初始化");
     return this.store.order.updateTempOrderShopDiscount(amount);
   }
+  updateTempOrderContactsInfo(contactsInfo) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    return this.store.order.updateTempOrderContactsInfo(contactsInfo);
+  }
   ensureTempOrder() {
     if (!this.store.order)
       throw new Error("order 模块未初始化");
@@ -496,6 +563,99 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw new Error("order 模块未初始化");
     return this.store.order.updateVoucherOrderPayments(payments);
   }
+  getWalletProductList() {
+    var _a, _b;
+    const tempOrder = (_a = this.store.order) == null ? void 0 : _a.getTempOrder();
+    if (!((_b = tempOrder == null ? void 0 : tempOrder.products) == null ? void 0 : _b.length))
+      return [];
+    return tempOrder.products.map((product) => {
+      const metadata = product.metadata || {};
+      return {
+        product_id: product.product_id,
+        product_variant_id: String(product.product_variant_id ?? ""),
+        quantity: product.num || 1,
+        is_price_include_tax: tempOrder.is_price_include_tax,
+        is_charge_tax: product.is_charge_tax ?? 0,
+        tax_fee: product.tax_fee,
+        selling_price: Number(product.selling_price || 0),
+        holder_id: product.holder_id ?? metadata.holder_id,
+        original_price: product.original_price,
+        main_product_original_price: metadata.main_product_original_price ?? product.original_price,
+        main_product_selling_price: metadata.main_product_selling_price ?? product.selling_price,
+        metadata: {
+          main_product_attached_bundle_tax_fee: metadata.main_product_attached_bundle_tax_fee,
+          main_product_attached_bundle_surcharge_fee: metadata.main_product_attached_bundle_surcharge_fee,
+          surcharge_rounding_remainder: metadata.surcharge_rounding_remainder
+        },
+        product_bundle: (product.product_bundle || []).map((bundle) => {
+          const bundleMetadata = bundle.metadata || {};
+          return {
+            is_price_include_tax: tempOrder.is_price_include_tax,
+            bundle_id: bundle.bundle_id,
+            bundle_product_id: bundle.bundle_product_id,
+            bundle_variant_id: bundle.bundle_variant_id,
+            price_type: bundle.price_type,
+            price_type_ext: bundle.price_type_ext,
+            bundle_sum_price: bundle.bundle_sum_price,
+            bundle_selling_price: bundle.bundle_selling_price,
+            num: bundle.num,
+            is_charge_tax: bundle.is_charge_tax,
+            tax_fee: bundle.tax_fee,
+            metadata: {
+              surcharge_fee: bundleMetadata.surcharge_fee,
+              surcharge_rounding_remainder: bundleMetadata.surcharge_rounding_remainder
+            }
+          };
+        })
+      };
+    });
+  }
+  async initWalletData(params) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const snapshot = this.store.order.getOrderSnapshot();
+    const tempOrder = snapshot == null ? void 0 : snapshot.tempOrder;
+    const amount = snapshot == null ? void 0 : snapshot.amount;
+    if (!tempOrder || !amount) {
+      return {
+        walletRecommendList: [],
+        userIdentificationCodes: [],
+        transformList: [],
+        noApplicableVoucher: [],
+        products: []
+      };
+    }
+    const walletBusinessData = {
+      customer_id: tempOrder.customer_id ? Number(tempOrder.customer_id) : void 0,
+      holder: tempOrder.holder,
+      amountInfo: {
+        totalAmount: amount.totalAmount,
+        subTotal: amount.summary.product_amount || amount.summary.product_expect_amount || amount.totalAmount,
+        depositAmount: amount.depositAmount,
+        isDeposit: tempOrder.is_deposit
+      },
+      products: this.getWalletProductList(),
+      order_wait_pay_amount: (params == null ? void 0 : params.order_wait_pay_amount) ?? Number(amount.amountGap || 0),
+      is_price_include_tax: tempOrder.is_price_include_tax ?? this.otherParams.is_price_include_tax ?? 1,
+      ...snapshot.identity.orderId ? { payment_order_id: String(snapshot.identity.orderId) } : {}
+    };
+    const result = await this.store.payment.wallet.initializeWalletDataFromBusinessAsync(
+      walletBusinessData
+    );
+    await this.core.effects.emit(`${this.name}:onWalletDataInitialized`, {
+      orderId: snapshot.identity.orderId,
+      customerId: walletBusinessData.customer_id,
+      walletBusinessData: {
+        customer_id: walletBusinessData.customer_id,
+        amountInfo: walletBusinessData.amountInfo,
+        order_wait_pay_amount: walletBusinessData.order_wait_pay_amount
+      },
+      timestamp: Date.now()
+    });
+    return result;
+  }
   /**
    * 更新当前订单客户字段。
    *
@@ -512,6 +672,9 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   }
   /** 获取可用支付方式列表，供 PaymentModal 渲染支付选项。 */
   async getPaymentMethodsAsync() {
+    if (this.store.payment) {
+      return this.store.payment.getPayMethodListAsync();
+    }
     const response = await this.request.get("/pay/custom-payment/all");
     return (response == null ? void 0 : response.data) || [];
   }
@@ -565,6 +728,9 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       order_ids: orderIds
     });
   }
+  transformBaseProductToOrderProduct(params) {
+    return (0, import_transformBaseProductToOrderProduct.transformBaseProductToOrderProduct)(params);
+  }
   async addProductToOrder(product, booking) {
     try {
       if (!this.store.order)

package/lib/solution/BaseSales/types.d.ts

@@ -91,13 +91,13 @@ export interface BaseSalesOrderProduct extends BaseSalesOrderProductIdentity {
  * 出站 payload 版本的商品行。
  *
  * 与 tempOrder 内部 `BaseSalesOrderProduct` 的字段差异：
- * - `product_option_item[*]`：内部为 `{ product_option_item_id, option_group_id, num, price, ... }`，
- *   出站由 `normalizeSubmitProduct` 重命名为 `{ option_group_item_id, option_group_id, num }`
+ * - `product_option_item[*]`：内部为 `{ option_group_item_id, option_group_id, num, price, ... }`，
+ *   出站保留 `{ option_group_item_id, option_group_id, num }`
  *   （后端 checkout 协议；丢弃 `price` 等运行时辅助字段）。
  * - `product_bundle[*].option[*]`：同上重命名规则。
  *
- * 运行时（UI 显示、加购合并、指纹、持久化）全部消费内部字段名 `product_option_item_id`，
- * 仅在 SDK 提交边界做一次出站映射，不影响 opaque identity 契约。
+ * 运行时（UI 显示、加购合并、指纹、持久化）与提交边界统一消费字段名
+ * `option_group_item_id`，保持 tempOrder 与后端协议一致。
  */
 export interface BaseSalesSubmitProduct extends Omit<BaseSalesOrderProduct, '_origin' | 'identity_key'> {
     /**

package/lib/solution/BaseSales/utils/transformBaseProductToOrderProduct.d.ts

@@ -0,0 +1,62 @@
+import type { OrderProduct, OrderProductIdentity } from '../../../modules/Order/types';
+import type { ProductData } from '../../../modules/Product/types';
+export interface BaseProductDetailOptionItem {
+    option_group_item_id?: number | string;
+    option_group_id?: number | string;
+    num?: number | string;
+    quantity?: number | string;
+    price?: number | string;
+    add_price?: number | string;
+    [key: string]: any;
+}
+export interface BaseProductDetailBundleItem {
+    option?: BaseProductDetailOptionItem[];
+    [key: string]: any;
+}
+export interface BaseProductDetailPayload {
+    id?: number | string | null;
+    product_id?: number | string | null;
+    variant_id?: number | string | null;
+    product_variant_id?: number | string | null;
+    quantity?: number | string;
+    num?: number | string;
+    option?: BaseProductDetailOptionItem[];
+    options?: BaseProductDetailOptionItem[];
+    product_option_item?: BaseProductDetailOptionItem[];
+    bundle?: BaseProductDetailBundleItem[];
+    product_bundle?: BaseProductDetailBundleItem[];
+    unique?: string;
+    unique_identification_number?: string;
+    session?: any;
+    form?: any;
+    service_times?: any;
+    machine_code?: string;
+    schedule_id?: number[];
+    duration?: number;
+    policy_id?: number;
+    source_shop_id?: number;
+    origin?: Record<string, any>;
+    _origin?: Record<string, any>;
+    price?: number | string;
+    selling_price?: number | string;
+    original_price?: number | string;
+    tax_fee?: number | string;
+    is_charge_tax?: number;
+    note?: string;
+    [key: string]: any;
+}
+export interface TransformBaseProductToOrderProductParams {
+    payload: BaseProductDetailPayload;
+    fallbackProductId?: number | string | null;
+    sourceProduct?: ProductData | Record<string, any> | null;
+    sourceItem?: ProductData | Record<string, any> | null;
+}
+export type BaseProductOrderProductInput = Partial<OrderProduct> & OrderProductIdentity & {
+    _origin?: Record<string, any>;
+};
+/**
+ * 将商品列表原始数据 + 商品详情选择回调转换成 OrderModule.addProductToOrder 入参。
+ *
+ * 注意：这里不生成 identity，缺省时由 OrderModule 自动补齐。
+ */
+export declare function transformBaseProductToOrderProduct(params: TransformBaseProductToOrderProductParams): BaseProductOrderProductInput | null;