@pisell/pisellos 2.2.153 → 2.2.154

package/dist/modules/Payment/types.d.ts

@@ -349,6 +349,18 @@ export interface EftposPayment {
 /**
  * 钱包支付接口
  */
+export interface WalletInitializationResult {
+    walletRecommendList: WalletRecommendItem[];
+    userIdentificationCodes: UserIdentificationCodeItem[];
+    transformList: any[];
+    noApplicableVoucher: any[];
+    products: any[];
+}
+export interface WalletStoredInitData {
+    transformList: any[];
+    noApplicableVoucher: any[];
+    products: any[];
+}
 export interface WalletPassPayment {
     /** 生成钱包API默认参数 */
     generateWalletParams: (businessData: WalletInitBusinessData) => WalletDeductionRecommendParams;
@@ -357,21 +369,25 @@ export interface WalletPassPayment {
     /** 清理已存储的钱包参数 */
     clearStoredWalletParams: () => void;
     /** 初始化钱包数据（从业务数据开始，内部生成参数） */
-    initializeWalletDataFromBusinessAsync: (businessData: WalletInitBusinessData) => Promise<{
-        walletRecommendList: WalletRecommendItem[];
-        userIdentificationCodes: UserIdentificationCodeItem[];
-    }>;
+    initializeWalletDataFromBusinessAsync: (businessData: WalletInitBusinessData) => Promise<WalletInitializationResult>;
     /** 初始化钱包数据（先获取推荐列表，再获取用户识别码列表） */
-    initializeWalletDataAsync: (baseParams: WalletDeductionRecommendParams) => Promise<{
-        walletRecommendList: WalletRecommendItem[];
-        userIdentificationCodes: UserIdentificationCodeItem[];
-    }>;
+    initializeWalletDataAsync: (baseParams: WalletDeductionRecommendParams) => Promise<WalletInitializationResult>;
     /** 获取钱包推荐扣款列表（异步获取并缓存） */
     getWalletPassRecommendListAsync: (params: WalletDeductionRecommendParams) => Promise<WalletRecommendItem[]>;
     /** 查询用户识别码列表（异步获取并缓存） */
     getUserIdentificationCodeListAsync: (params: UserIdentificationCodeParams) => Promise<UserIdentificationCodeItem[]>;
     /** 搜索识别码信息 */
-    searchIdentificationCodeAsync: (params: SearchIdentificationCodeParams) => Promise<SearchIdentificationCodeResult>;
+    searchIdentificationCodeAsync: (params: SearchIdentificationCodeParams, config?: {
+        noCache?: boolean;
+    }) => Promise<SearchIdentificationCodeResult>;
+    /** 将推荐钱包列表转换为 prepare_payments */
+    formatWalletPassList2PreparePayments: (list: WalletRecommendItem[]) => {
+        voucher_id: number;
+        amount: number;
+        tag: string;
+        wallet_pass_usage_unit?: unknown;
+        wallet_pass_use_value?: string | number | null;
+    }[];
     /** 获取缓存的搜索结果列表 */
     getSearchResults: () => SearchIdentificationCodeItem[];
     /** 根据识别码查找搜索结果 */
@@ -384,6 +400,10 @@ export interface WalletPassPayment {
     clearWalletRecommendList: () => void;
     /** 清除用户识别码列表 */
     clearUserIdentificationCodes: () => void;
+    /** 获取缓存的钱包初始化数据 */
+    getStoredWalletInitData: () => WalletStoredInitData | null;
+    /** 清除缓存的钱包初始化数据 */
+    clearStoredWalletInitData: () => void;
     /** 清除搜索结果缓存 */
     clearSearchResults: () => void;
     /** 清除所有缓存数据 */

package/dist/modules/SalesSummary/index.d.ts

@@ -5,20 +5,22 @@ export * from './types';
 export declare class SalesSummaryModule extends BaseModule implements Module, SalesSummaryModuleAPI {
     protected defaultName: string;
     protected defaultVersion: string;
-    private shopStore;
+    private appPlugin;
     private store;
     private request;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
     getSurchargeList(): Promise<void>;
+    private getAppData;
+    private getTaxConfig;
     getSummary(params: {
         products: any[];
         isPriceIncludeTax?: number;
         taxRate?: number;
         shopDiscount?: string | number;
     }): Promise<{
-        tax_title: any;
-        tax_rate: any;
+        tax_title: string;
+        tax_rate: number | undefined;
         product_quantity: number;
         product_original_amount: string;
         product_amount: string;
@@ -42,8 +44,8 @@ export declare class SalesSummaryModule extends BaseModule implements Module, Sa
         pay_service_charge_amount: string;
         is_price_include_tax?: number | undefined;
     } | {
-        tax_title: any;
-        tax_rate: any;
+        tax_title: string;
+        tax_rate: number | undefined;
         product_quantity: number;
         product_original_amount: string;
         product_amount: string;

package/dist/modules/SalesSummary/index.js

@@ -24,6 +24,11 @@ import { BaseModule } from "../BaseModule";
 import { ScheduleModule } from "../Schedule";
 import { calculateSalesSummary, createEmptySalesSummary } from "./utils";
 export * from "./types";
+var salesSummaryDataKeys = {
+  isPriceIncludeTax: 'is_price_include_tax',
+  taxRate: 'tax_rate',
+  taxTitle: 'tax_title'
+};
 export var SalesSummaryModule = /*#__PURE__*/function (_BaseModule) {
   _inherits(SalesSummaryModule, _BaseModule);
   var _super = _createSuper(SalesSummaryModule);
@@ -33,7 +38,7 @@ export var SalesSummaryModule = /*#__PURE__*/function (_BaseModule) {
     _this = _super.call(this, name, version);
     _defineProperty(_assertThisInitialized(_this), "defaultName", 'salesSummary');
     _defineProperty(_assertThisInitialized(_this), "defaultVersion", '1.0.0');
-    _defineProperty(_assertThisInitialized(_this), "shopStore", void 0);
+    _defineProperty(_assertThisInitialized(_this), "appPlugin", void 0);
     _defineProperty(_assertThisInitialized(_this), "store", void 0);
     _defineProperty(_assertThisInitialized(_this), "request", void 0);
     return _this;
@@ -48,15 +53,15 @@ export var SalesSummaryModule = /*#__PURE__*/function (_BaseModule) {
             case 0:
               this.core = core;
               this.store = options.store;
-              this.shopStore = this.core.getPlugin('shopStore');
+              this.appPlugin = this.core.getPlugin('app');
               this.request = this.core.getPlugin('request');
               this.store.surchargeList = ((_options$initialState = options.initialState) === null || _options$initialState === void 0 ? void 0 : _options$initialState.surchargeList) || [];
               this.store.summary = ((_options$initialState2 = options.initialState) === null || _options$initialState2 === void 0 ? void 0 : _options$initialState2.summary) || createEmptySalesSummary();
-              if (this.shopStore) {
+              if (this.appPlugin) {
                 _context.next = 8;
                 break;
               }
-              throw new Error('SalesSummaryModule 需要 shopStore 插件支持');
+              throw new Error('SalesSummaryModule 需要 app 插件支持');
             case 8:
               if (this.request) {
                 _context.next = 10;
@@ -114,17 +119,36 @@ export var SalesSummaryModule = /*#__PURE__*/function (_BaseModule) {
       }
       return getSurchargeList;
     }()
+  }, {
+    key: "getAppData",
+    value: function getAppData(key) {
+      var _this$appPlugin$getDa, _this$appPlugin, _app$models, _app$models$getStore, _app$models$getStore$, _app$models$getStore$2;
+      var getData = (_this$appPlugin$getDa = (_this$appPlugin = this.appPlugin).getData) === null || _this$appPlugin$getDa === void 0 ? void 0 : _this$appPlugin$getDa.call(_this$appPlugin);
+      if (typeof getData === 'function') return getData(key);
+      var app = this.appPlugin.getApp();
+      var coreData = app === null || app === void 0 || (_app$models = app.models) === null || _app$models === void 0 || (_app$models$getStore = _app$models.getStore) === null || _app$models$getStore === void 0 || (_app$models$getStore$ = (_app$models$getStore$2 = _app$models$getStore.call(_app$models)).getDataByModel) === null || _app$models$getStore$ === void 0 ? void 0 : _app$models$getStore$.call(_app$models$getStore$2, 'core', 'core');
+      return coreData === null || coreData === void 0 ? void 0 : coreData[key];
+    }
+  }, {
+    key: "getTaxConfig",
+    value: function getTaxConfig() {
+      return {
+        isPriceIncludeTax: this.getAppData(salesSummaryDataKeys.isPriceIncludeTax),
+        taxRate: this.getAppData(salesSummaryDataKeys.taxRate),
+        taxTitle: this.getAppData(salesSummaryDataKeys.taxTitle)
+      };
+    }
   }, {
     key: "getSummary",
     value: function () {
       var _getSummary = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(params) {
-        var _this$shopStore$get, _ref;
-        var _params$products, products, isPriceIncludeTax, taxRate, shopDiscount, shopInfo, summarySchedule, needScheduleIds, scheduleList, scheduleById, _iterator, _step, item, summary, summaryWithTaxMeta;
+        var _ref;
+        var _params$products, products, isPriceIncludeTax, taxRate, shopDiscount, taxConfig, summarySchedule, needScheduleIds, scheduleList, scheduleById, _iterator, _step, item, summary, summaryWithTaxMeta;
         return _regeneratorRuntime().wrap(function _callee3$(_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
               _params$products = params.products, products = _params$products === void 0 ? [] : _params$products, isPriceIncludeTax = params.isPriceIncludeTax, taxRate = params.taxRate, shopDiscount = params.shopDiscount;
-              shopInfo = ((_this$shopStore$get = this.shopStore.get('core')) === null || _this$shopStore$get === void 0 || (_this$shopStore$get = _this$shopStore$get.core) === null || _this$shopStore$get === void 0 ? void 0 : _this$shopStore$get.shop) || {};
+              taxConfig = this.getTaxConfig();
               summarySchedule = this.core.getModule("".concat(this.name.split('_')[0], "_schedule"));
               needScheduleIds = this.store.surchargeList.map(function (item) {
                 return item.available_schedule_ids;
@@ -146,16 +170,16 @@ export var SalesSummaryModule = /*#__PURE__*/function (_BaseModule) {
               }
               summary = calculateSalesSummary({
                 products: products,
-                isPriceIncludeTax: (_ref = isPriceIncludeTax !== null && isPriceIncludeTax !== void 0 ? isPriceIncludeTax : shopInfo === null || shopInfo === void 0 ? void 0 : shopInfo.is_price_include_tax) !== null && _ref !== void 0 ? _ref : 1,
-                taxRate: taxRate !== null && taxRate !== void 0 ? taxRate : shopInfo === null || shopInfo === void 0 ? void 0 : shopInfo.tax_rate,
+                isPriceIncludeTax: (_ref = isPriceIncludeTax !== null && isPriceIncludeTax !== void 0 ? isPriceIncludeTax : taxConfig.isPriceIncludeTax) !== null && _ref !== void 0 ? _ref : 1,
+                taxRate: taxRate !== null && taxRate !== void 0 ? taxRate : taxConfig.taxRate,
                 surchargeList: this.store.surchargeList,
                 scheduleById: scheduleById,
                 isInScheduleByDate: ScheduleModule.isInScheduleByDate,
                 shopDiscount: shopDiscount
               });
               summaryWithTaxMeta = _objectSpread(_objectSpread({}, summary), {}, {
-                tax_title: (shopInfo === null || shopInfo === void 0 ? void 0 : shopInfo.tax_title) || '',
-                tax_rate: taxRate !== null && taxRate !== void 0 ? taxRate : shopInfo === null || shopInfo === void 0 ? void 0 : shopInfo.tax_rate
+                tax_title: taxConfig.taxTitle || '',
+                tax_rate: taxRate !== null && taxRate !== void 0 ? taxRate : taxConfig.taxRate
               });
               this.store.summary = summaryWithTaxMeta;
               return _context3.abrupt("return", summaryWithTaxMeta);

package/dist/plugins/app.d.ts

@@ -1,8 +1,10 @@
 import { Plugin } from '../types';
 import App from './app-types/app';
+export type AppDataGetter = (key: string) => any;
 /**
  * AppPlugin 接口定义
  */
 export interface AppPlugin extends Plugin {
     getApp: () => App;
+    getData?: () => AppDataGetter;
 }

package/dist/server/index.d.ts

@@ -372,13 +372,10 @@ declare class Server {
      */
     private recomputeAndNotifyBookingQuery;
     /**
-     * 根据餐牌配置过滤商品
-     * @param products 所有商品列表
-     * @param activeMenuList 生效的餐牌列表
-     * @returns 过滤后的商品列表
+     * 根据餐牌配置提取轻量商品范围。
      * @private
      */
-    private filterProductsByMenuConfig;
+    private getProductScopeByMenuConfig;
     /**
      * 记录信息日志
      * @param title 日志标题

package/dist/server/index.js

@@ -3299,7 +3299,7 @@ var Server = /*#__PURE__*/function () {
       var _computeProductQueryResult = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee29(context, options) {
         var _menu_list_ids$length3,
           _this6 = this;
-        var tTotal, menu_list_ids, schedule_date, schedule_datetime, customer_id, product_id, _published$find, pid, _tPrice, _allProductsWithPrice, published, item, activeMenuList, tMenu, menuList, tPrice, allProductsWithPrice, tFilter, filteredProducts, tStatus, beforeStatusCount, tSort;
+        var tTotal, menu_list_ids, schedule_date, schedule_datetime, customer_id, product_id, _published$find, pid, _tPrice, allProductsWithPrice, published, item, activeMenuList, tMenu, menuList, tFilter, productScope, scopedProductIds, tPrice, filteredProducts, tStatus, beforeStatusCount, tSort;
         return _regeneratorRuntime().wrap(function _callee29$(_context29) {
           while (1) switch (_context29.prev = _context29.next) {
             case 0:
@@ -3339,12 +3339,12 @@ var Server = /*#__PURE__*/function () {
                 changedIds: options === null || options === void 0 ? void 0 : options.changedIds
               });
             case 11:
-              _allProductsWithPrice = _context29.sent;
+              allProductsWithPrice = _context29.sent;
               perfMark('computeQuery.getProductsWithPrice(single)', performance.now() - _tPrice, {
-                count: _allProductsWithPrice.length,
+                count: allProductsWithPrice.length,
                 productId: pid
               });
-              published = _allProductsWithPrice.filter(function (p) {
+              published = allProductsWithPrice.filter(function (p) {
                 return ((p === null || p === void 0 ? void 0 : p.status) || 'published') === 'published';
               });
               item = (_published$find = published.find(function (p) {
@@ -3405,25 +3405,39 @@ var Server = /*#__PURE__*/function () {
                   activeMenu: activeMenuList.length
                 });
               }
+              tFilter = performance.now();
+              productScope = this.getProductScopeByMenuConfig(activeMenuList);
+              scopedProductIds = this.products.getProductIdsByScope(productScope);
+              perfMark('computeQuery.filterByMenu', performance.now() - tFilter, {
+                scopedProductCount: scopedProductIds.length,
+                activeMenuCount: activeMenuList.length,
+                isAllProducts: !!productScope.isAllProducts
+              });
               tPrice = performance.now();
-              _context29.next = 29;
+              if (!(scopedProductIds.length > 0)) {
+                _context29.next = 37;
+                break;
+              }
+              _context29.next = 34;
               return this.products.getProductsWithPrice(schedule_date, {
                 scheduleModule: this.getSchedule(),
                 schedule_datetime: schedule_datetime,
                 customer_id: customer_id
               }, {
-                changedIds: options === null || options === void 0 ? void 0 : options.changedIds
+                changedIds: options === null || options === void 0 ? void 0 : options.changedIds,
+                productIds: productScope.isAllProducts ? undefined : scopedProductIds
               });
-            case 29:
-              allProductsWithPrice = _context29.sent;
+            case 34:
+              _context29.t0 = _context29.sent;
+              _context29.next = 38;
+              break;
+            case 37:
+              _context29.t0 = [];
+            case 38:
+              filteredProducts = _context29.t0;
               perfMark('computeQuery.getProductsWithPrice', performance.now() - tPrice, {
-                count: allProductsWithPrice.length
-              });
-              tFilter = performance.now();
-              filteredProducts = this.filterProductsByMenuConfig(allProductsWithPrice, activeMenuList);
-              perfMark('computeQuery.filterByMenu', performance.now() - tFilter, {
-                before: allProductsWithPrice.length,
-                after: filteredProducts.length
+                count: filteredProducts.length,
+                scopedProductCount: scopedProductIds.length
               });
               tStatus = performance.now();
               beforeStatusCount = filteredProducts.length;
@@ -3444,12 +3458,12 @@ var Server = /*#__PURE__*/function () {
                 count: filteredProducts.length
               });
               perfMark('computeProductQueryResult', performance.now() - tTotal, {
-                originalCount: allProductsWithPrice.length,
+                scopedProductCount: scopedProductIds.length,
                 filteredCount: filteredProducts.length,
                 activeMenuCount: activeMenuList.length
               });
               this.logInfo('computeProductQueryResult 完成', {
-                originalCount: allProductsWithPrice.length,
+                scopedProductCount: scopedProductIds.length,
                 filteredCount: filteredProducts.length,
                 activeMenuCount: activeMenuList.length
               });
@@ -3462,7 +3476,7 @@ var Server = /*#__PURE__*/function () {
                 message: '',
                 status: true
               });
-            case 44:
+            case 50:
             case "end":
               return _context29.stop();
           }
@@ -3717,24 +3731,22 @@ var Server = /*#__PURE__*/function () {
       return recomputeAndNotifyBookingQuery;
     }()
     /**
-     * 根据餐牌配置过滤商品
-     * @param products 所有商品列表
-     * @param activeMenuList 生效的餐牌列表
-     * @returns 过滤后的商品列表
+     * 根据餐牌配置提取轻量商品范围。
      * @private
      */
     )
   }, {
-    key: "filterProductsByMenuConfig",
-    value: function filterProductsByMenuConfig(products, activeMenuList) {
-      // 如果没有生效的餐牌，返回空数组
+    key: "getProductScopeByMenuConfig",
+    value: function getProductScopeByMenuConfig(activeMenuList) {
       if (!activeMenuList || activeMenuList.length === 0) {
         console.log('[Server] 没有生效的餐牌，返回空数组');
-        this.logInfo('filterProductsByMenuConfig: 没有生效的餐牌，返回空数组', {
-          productCount: products.length,
+        this.logInfo('getProductScopeByMenuConfig: 没有生效的餐牌，返回空数组', {
           activeMenuCount: 0
         });
-        return [];
+        return {
+          productIds: [],
+          collectionIds: []
+        };
       }
 
       // 收集允许的商品 IDs 和集合 IDs
@@ -3749,7 +3761,7 @@ var Server = /*#__PURE__*/function () {
           var config = menu.partyroom_package;
           if (!config) {
             console.warn('[Server] 餐牌缺少 partyroom_package 配置:', menu);
-            this.logWarning('filterProductsByMenuConfig: 餐牌缺少 partyroom_package 配置', {
+            this.logWarning('getProductScopeByMenuConfig: 餐牌缺少 partyroom_package 配置', {
               menuId: menu.form_record_id,
               menuName: menu.name
             });
@@ -3759,7 +3771,7 @@ var Server = /*#__PURE__*/function () {
           // 如果有任何一个餐牌是 product_all，则返回所有商品
           if (config.type === 'product_all') {
             console.log('[Server] 餐牌允许所有商品:', menu.name);
-            this.logInfo('filterProductsByMenuConfig: 餐牌允许所有商品', {
+            this.logInfo('getProductScopeByMenuConfig: 餐牌允许所有商品', {
               menuId: menu.form_record_id,
               menuName: menu.name,
               configType: config.type
@@ -3777,7 +3789,7 @@ var Server = /*#__PURE__*/function () {
               return id && allowedProductIds.add(id);
             });
             console.log('[Server] 餐牌允许指定商品 (product_ids):', menu.name, productIds);
-            this.logInfo('filterProductsByMenuConfig: 餐牌允许指定商品', {
+            this.logInfo('getProductScopeByMenuConfig: 餐牌允许指定商品', {
               menuId: menu.form_record_id,
               menuName: menu.name,
               configType: config.type,
@@ -3794,7 +3806,7 @@ var Server = /*#__PURE__*/function () {
               return id && allowedCollectionIds.add(id);
             });
             console.log('[Server] 餐牌允许商品集合 (product_collection):', menu.name, collectionIds);
-            this.logInfo('filterProductsByMenuConfig: 餐牌允许商品集合', {
+            this.logInfo('getProductScopeByMenuConfig: 餐牌允许商品集合', {
               menuId: menu.form_record_id,
               menuName: menu.name,
               configType: config.type,
@@ -3810,55 +3822,35 @@ var Server = /*#__PURE__*/function () {
         _iterator19.f();
       }
       if (hasProductAll) {
-        this.logInfo('filterProductsByMenuConfig: 返回所有商品（product_all）', {
-          productCount: products.length
-        });
-        return products;
+        this.logInfo('getProductScopeByMenuConfig: 返回所有商品 scope（product_all）');
+        return {
+          isAllProducts: true
+        };
       }
 
       // 如果没有收集到任何商品 ID 和集合 ID，返回空数组
       if (allowedProductIds.size === 0 && allowedCollectionIds.size === 0) {
         console.log('[Server] 没有允许的商品和集合');
-        this.logWarning('filterProductsByMenuConfig: 没有允许的商品和集合', {
-          productCount: products.length,
+        this.logWarning('getProductScopeByMenuConfig: 没有允许的商品和集合', {
           activeMenuCount: activeMenuList.length
         });
-        return [];
+        return {
+          productIds: [],
+          collectionIds: []
+        };
       }
       var allowedProductIdsArray = Array.from(allowedProductIds);
       var allowedCollectionIdsArray = Array.from(allowedCollectionIds);
       console.log('[Server] 允许的商品 IDs:', allowedProductIdsArray);
       console.log('[Server] 允许的集合 IDs:', allowedCollectionIdsArray);
-      this.logInfo('filterProductsByMenuConfig: 收集到的允许规则', {
+      this.logInfo('getProductScopeByMenuConfig: 收集到的允许规则', {
         allowedProductCount: allowedProductIds.size,
         allowedCollectionCount: allowedCollectionIds.size
       });
-
-      // 过滤商品
-      var filteredProducts = products.filter(function (product) {
-        // 1. 检查商品 ID 是否在允许列表中
-        if (allowedProductIds.has(product.id)) {
-          return true;
-        }
-
-        // 2. 检查商品是否属于允许的集合
-        if (allowedCollectionIds.size > 0 && Array.isArray(product.collection)) {
-          var hasMatchingCollection = product.collection.some(function (col) {
-            return allowedCollectionIds.has(col.id);
-          });
-          if (hasMatchingCollection) {
-            return true;
-          }
-        }
-        return false;
-      });
-      console.log('[Server] 过滤结果: 原始 %d 个，过滤后 %d 个', products.length, filteredProducts.length);
-      this.logInfo('filterProductsByMenuConfig: 过滤完成', {
-        originalCount: products.length,
-        filteredCount: filteredProducts.length,
-        removedCount: products.length - filteredProducts.length
-      });
-      return filteredProducts;
+      return {
+        productIds: allowedProductIdsArray,
+        collectionIds: allowedCollectionIdsArray
+      };
     }
 
     /**

package/dist/server/modules/index.d.ts

@@ -3,7 +3,7 @@
  * 包含新增的 Products、Menu、Quotation 和扩展的 Schedule 模块
  */
 export { ProductsModule } from './products';
-export type { ProductsState } from './products/types';
+export type { ProductIdScope, ProductsState } from './products/types';
 export { ProductsHooks } from './products/types';
 export { MenuModule } from './menu';
 export type { MenuState, MenuData } from './menu/types';

package/dist/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)