@pisell/pisellos 2.3.81 → 2.3.83

package/dist/model/strategy/adapter/promotion/index.js

@@ -1,9 +0,0 @@
-// 导出评估器
-export { PromotionEvaluator } from "./evaluator";
-
-// 导出适配器
-export { PromotionAdapter } from "./adapter";
-export { default } from "./adapter";
-
-// 导出策略配置示例常量
-export { X_ITEMS_FOR_Y_PRICE_STRATEGY, BUY_X_GET_Y_FREE_STRATEGY, ITEM_REWARD_STRATEGY } from "./examples";

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

@@ -19,12 +19,15 @@ export declare class BookingContextModule extends BaseModule implements Module,
     protected defaultVersion: string;
     private request;
     private store;
+    private otherParams;
     /** 上次成功 loadBookingConfig 的 query key；命中则不再请求。 */
     private lastConfigQueryKey;
     /** 上次成功 loadResources 的 query key（date|bookingIds）；命中则不再请求。 */
     private lastResourcesQueryKey;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
+    /** 同步父级解决方案的运行态参数；platform 变化后会自然切换 config endpoint/cache key。 */
+    updateOtherParams(params: Record<string, any>): void;
     loadBookingConfig(params?: LoadBookingConfigParams, options?: {
         forceRefresh?: boolean;
     }): Promise<BookingContextConfig | null>;

package/dist/modules/BookingContext/index.js

@@ -26,6 +26,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 import dayjs from 'dayjs';
 import { BaseModule } from "../BaseModule";
 import { RequestModeENUM } from "../../plugins/request";
+import { normalizeRuntimePlatform } from "../../utils/platform";
 import { BookingContextEvent } from "./types";
 import { formatResourceListAndMap } from "./utils/formatResourceList";
 export * from "./types";
@@ -40,6 +41,8 @@ var DEFAULT_BOOKING_CONFIG_PARAMS = {
   item_type: 'appointment_booking',
   sub_type: 'ticket'
 };
+var BOOKING_CONFIG_ENDPOINT = '/core/board/management/config';
+var H5_BOOKING_CONFIG_ENDPOINT = '/core/board/config';
 var BOARD_CONFIG_CACHE = {
   useCache: true,
   cache: {
@@ -153,6 +156,24 @@ export function buildBookingConfigQueryKey() {
   });
   return JSON.stringify(sorted);
 }
+function resolveBookingConfigRequest(platform) {
+  var params = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var isH5 = normalizeRuntimePlatform(platform) === 'h5';
+  var endpoint = isH5 ? H5_BOOKING_CONFIG_ENDPOINT : BOOKING_CONFIG_ENDPOINT;
+  var query = isH5 ? {
+    item_type: params.item_type || DEFAULT_BOOKING_CONFIG_PARAMS.item_type
+  } : _objectSpread(_objectSpread({}, DEFAULT_BOOKING_CONFIG_PARAMS), params);
+  var keys = Object.keys(query).sort();
+  var sortedQuery = {};
+  keys.forEach(function (key) {
+    sortedQuery[key] = query[key];
+  });
+  return {
+    endpoint: endpoint,
+    query: query,
+    key: "".concat(endpoint, ":").concat(JSON.stringify(sortedQuery))
+  };
+}
 
 /** 稳定序列化资源列表查询（date + bookingIds），用于跳过重复 loadResources。 */
 export function buildBookingResourcesQueryKey() {
@@ -176,6 +197,7 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
     _defineProperty(_assertThisInitialized(_this), "defaultVersion", '1.0.0');
     _defineProperty(_assertThisInitialized(_this), "request", void 0);
     _defineProperty(_assertThisInitialized(_this), "store", _objectSpread({}, EMPTY_STATE));
+    _defineProperty(_assertThisInitialized(_this), "otherParams", {});
     /** 上次成功 loadBookingConfig 的 query key；命中则不再请求。 */
     _defineProperty(_assertThisInitialized(_this), "lastConfigQueryKey", null);
     /** 上次成功 loadResources 的 query key（date|bookingIds）；命中则不再请求。 */
@@ -201,6 +223,7 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
               }
               throw new Error('BookingContextModule 需要 request 插件支持');
             case 5:
+              this.otherParams = options.otherParams || {};
               this.store = {
                 bookingConfig: null,
                 resourcesOrigin: [],
@@ -218,7 +241,7 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
               if (initialState.date) {
                 this.store.date = initialState.date;
               }
-            case 10:
+            case 11:
             case "end":
               return _context.stop();
           }
@@ -228,16 +251,22 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
         return _initialize.apply(this, arguments);
       }
       return initialize;
-    }()
+    }() /** 同步父级解决方案的运行态参数；platform 变化后会自然切换 config endpoint/cache key。 */
+  }, {
+    key: "updateOtherParams",
+    value: function updateOtherParams(params) {
+      this.otherParams = params || {};
+    }
   }, {
     key: "loadBookingConfig",
     value: function () {
       var _loadBookingConfig = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
-        var _this2 = this;
+        var _this$otherParams,
+          _this2 = this;
         var params,
           options,
+          requestConfig,
           configKey,
-          query,
           sharedKey,
           _sharedBookingConfigC,
           cached,
@@ -250,14 +279,14 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
             case 0:
               params = _args3.length > 0 && _args3[0] !== undefined ? _args3[0] : {};
               options = _args3.length > 1 && _args3[1] !== undefined ? _args3[1] : {};
-              configKey = buildBookingConfigQueryKey(params);
+              requestConfig = resolveBookingConfigRequest((_this$otherParams = this.otherParams) === null || _this$otherParams === void 0 ? void 0 : _this$otherParams.platform, params);
+              configKey = requestConfig.key;
               if (!(!options.forceRefresh && this.store.bookingConfig != null && this.lastConfigQueryKey === configKey)) {
-                _context3.next = 5;
+                _context3.next = 6;
                 break;
               }
               return _context3.abrupt("return", this.store.bookingConfig);
-            case 5:
-              query = _objectSpread(_objectSpread({}, DEFAULT_BOOKING_CONFIG_PARAMS), params);
+            case 6:
               sharedKey = buildSharedCacheKey(this.request, configKey);
               if (!(!options.forceRefresh && sharedBookingConfigCache.has(sharedKey))) {
                 _context3.next = 12;
@@ -277,7 +306,7 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
                       case 0:
                         _context2.prev = 0;
                         _context2.next = 3;
-                        return _this2.request.get('/core/board/management/config', query, BOARD_CONFIG_CACHE);
+                        return _this2.request.get(requestConfig.endpoint, requestConfig.query, BOARD_CONFIG_CACHE);
                       case 3:
                         res = _context2.sent;
                         _config = (_res$data = res === null || res === void 0 ? void 0 : res.data) !== null && _res$data !== void 0 ? _res$data : null;
@@ -411,9 +440,9 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "isBookingContextReady",
     value: function isBookingContextReady() {
-      var _ref3, _params$date2;
+      var _this$otherParams2, _ref3, _params$date2;
       var params = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-      var configKey = buildBookingConfigQueryKey(params.bookingConfigParams);
+      var configKey = resolveBookingConfigRequest((_this$otherParams2 = this.otherParams) === null || _this$otherParams2 === void 0 ? void 0 : _this$otherParams2.platform, params.bookingConfigParams).key;
       var dateInput = (_ref3 = (_params$date2 = params.date) !== null && _params$date2 !== void 0 ? _params$date2 : this.store.date) !== null && _ref3 !== void 0 ? _ref3 : dayjs();
       var queryDate = toScheduleQueryDate(dateInput);
       var resourcesKey = buildBookingResourcesQueryKey({
@@ -428,7 +457,7 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
     key: "initBookingContext",
     value: function () {
       var _initBookingContext = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6() {
-        var _ref4, _params$date3;
+        var _ref4, _params$date3, _this$otherParams3;
         var params,
           dateInput,
           queryDate,
@@ -450,7 +479,7 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
               }
               return _context6.abrupt("return", this.getState());
             case 6:
-              configKey = buildBookingConfigQueryKey(params.bookingConfigParams);
+              configKey = resolveBookingConfigRequest((_this$otherParams3 = this.otherParams) === null || _this$otherParams3 === void 0 ? void 0 : _this$otherParams3.platform, params.bookingConfigParams).key;
               resourcesKey = buildBookingResourcesQueryKey({
                 date: queryDate,
                 bookingIds: params.bookingIds

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

@@ -1,7 +1,7 @@
 /**
  * BookingContext 子模块：承载「预约 UI 上下文」三件套。
  *
- *  - bookingConfig：来自 `/core/board/management/config` 的整套预约配置（service_time / resource_tab /
+ *  - bookingConfig：来自 staff `/core/board/management/config` 或 H5 `/core/board/config` 的整套预约配置（service_time / resource_tab /
  *    appointment_subject / subject_require / stock_setting / basic / capacity 等）。
  *  - resourcesOrigin / resourcesOriginMap：来自 `/schedule/resource/list` 的资源全集，含 times / event_list /
  *    combined_resource 等运行态信息，是 getResourceByIds / getResourceTimeIsUsable 的输入。
@@ -11,7 +11,7 @@
  *  - 默认由 `loadBookingConfig` / `loadResources` 拉取并写入 store；也支持消费方 `set*` 直接灌入（复用 ticketBooking 已拉到的数据）。
  *  - 所有读 API 返回浅克隆（数组）或原引用（map / config），避免 UI 写穿。
  */
-/** `loadBookingConfig` 入参，与 ticketBooking `getBookingConfig` 一致。 */
+/** `loadBookingConfig` 入参；H5 公共接口只消费 `item_type`。 */
 export interface LoadBookingConfigParams {
     item_type?: string;
     sub_type?: string;
@@ -42,7 +42,7 @@ export interface InitBookingContextParams {
 export type BookingContextResource = Record<string, any>;
 export type BookingContextResourceMap = Record<string, BookingContextResource>;
 /**
- * 形参 booking_config（结构来自 `/core/board/management/config` 接口）。
+ * 形参 booking_config（结构来自 staff management 或 H5 board config 接口的 `data`）。
  * OS 不强制 schema，保留 `Record<string, any>` 兼容现网；常用路径文档化在 SDK docs。
  */
 export type BookingContextConfig = Record<string, any>;
@@ -80,7 +80,7 @@ export interface BookingContextModuleAPI {
     getState(): BookingContextState;
     /** 一键清空，destroy / 切租户场景用。 */
     clear(): void;
-    /** 拉取 board config 并写入 store（`/core/board/management/config`）。 */
+    /** 按运行平台拉取 board config 并写入 store。 */
     loadBookingConfig(params?: LoadBookingConfigParams): Promise<BookingContextConfig | null>;
     /** 拉取资源全集并写入 store（`/schedule/resource/list`）。 */
     loadResources(params?: LoadBookingResourcesParams): Promise<BookingContextResource[]>;

package/dist/modules/BookingContext/types.js

@@ -1,7 +1,7 @@
 /**
  * BookingContext 子模块：承载「预约 UI 上下文」三件套。
  *
- *  - bookingConfig：来自 `/core/board/management/config` 的整套预约配置（service_time / resource_tab /
+ *  - bookingConfig：来自 staff `/core/board/management/config` 或 H5 `/core/board/config` 的整套预约配置（service_time / resource_tab /
  *    appointment_subject / subject_require / stock_setting / basic / capacity 等）。
  *  - resourcesOrigin / resourcesOriginMap：来自 `/schedule/resource/list` 的资源全集，含 times / event_list /
  *    combined_resource 等运行态信息，是 getResourceByIds / getResourceTimeIsUsable 的输入。
@@ -12,7 +12,7 @@
  *  - 所有读 API 返回浅克隆（数组）或原引用（map / config），避免 UI 写穿。
  */
 
-/** `loadBookingConfig` 入参，与 ticketBooking `getBookingConfig` 一致。 */
+/** `loadBookingConfig` 入参；H5 公共接口只消费 `item_type`。 */
 
 /** `loadResources` 入参，与 info2 `getResourceList` 一致。 */
 
@@ -24,7 +24,7 @@
  */
 
 /**
- * 形参 booking_config（结构来自 `/core/board/management/config` 接口）。
+ * 形参 booking_config（结构来自 staff management 或 H5 board config 接口的 `data`）。
  * OS 不强制 schema，保留 `Record<string, any>` 兼容现网；常用路径文档化在 SDK docs。
  */
 

package/dist/modules/ProductList/clientDataVariants.d.ts

@@ -17,7 +17,30 @@ export interface ResolveClientDataVariantsParams {
     handledByOsServer: boolean;
     scheduleList?: unknown;
     menuList?: unknown;
+    /** Quote fast paths require hydrated relations; legacy list resolution does not. */
+    requireCompleteDataVariantRelations?: boolean;
+    /** Quote fast paths require every referenced rule; legacy list resolution is best-effort. */
+    requireEvaluatorReady?: boolean;
 }
+export type ResolveClientDataVariantsResult = {
+    status: 'handled-by-os-server' | 'empty' | 'data-variants-unavailable' | 'evaluator-unavailable' | 'evaluator-not-ready';
+    products: ProductData[];
+} | {
+    status: 'resolved';
+    products: ProductData[];
+} | {
+    status: 'error';
+    products: ProductData[];
+    error: unknown;
+};
+/**
+ * Strict client-side Data Variant resolution for quote fast paths.
+ *
+ * Unlike resolveClientDataVariants, callers can distinguish a complete local
+ * result from a capability/readiness/error fallback and decide to query the
+ * remote product endpoint instead.
+ */
+export declare function tryResolveClientDataVariants({ core, otherParams, products, queryPayload, handledByOsServer, scheduleList: explicitScheduleList, menuList: explicitMenuList, requireCompleteDataVariantRelations, requireEvaluatorReady, }: ResolveClientDataVariantsParams): ResolveClientDataVariantsResult;
 /**
  * 未启用商品 OS 路由时，在客户端补做 Data Variant 解析。
  *

package/dist/modules/ProductList/clientDataVariants.js

@@ -13,13 +13,74 @@ export function isProductQueryHandledByOsServer(core, request) {
   var requestBaseUrl = String((request === null || request === void 0 ? void 0 : request.baseUrl) || '/shop').replace(/\/+$/, '');
   return server.hasRoute('post', "".concat(requestBaseUrl, "/product/query")) === true;
 }
+function getBundleItems(product) {
+  if (!Array.isArray(product.bundle_group)) return [];
+  return product.bundle_group.flatMap(function (group) {
+    return Array.isArray(group === null || group === void 0 ? void 0 : group.bundle_item) ? group.bundle_item : [];
+  });
+}
+function hasCompleteDataVariantRelations(products) {
+  return products.every(function (product) {
+    return Array.isArray(product === null || product === void 0 ? void 0 : product.data_variants);
+  });
+}
+function hasAnyDataVariants(products) {
+  return products.some(function (product) {
+    var _product$data_variant;
+    return (((_product$data_variant = product.data_variants) === null || _product$data_variant === void 0 ? void 0 : _product$data_variant.length) || 0) > 0 || getBundleItems(product).some(function (item) {
+      return Array.isArray(item === null || item === void 0 ? void 0 : item.data_variants) && item.data_variants.length > 0;
+    });
+  });
+}
+function collectReferencedRuleIds(products) {
+  var ids = new Set();
+  var remember = function remember(variants) {
+    if (!Array.isArray(variants)) return;
+    variants.forEach(function (variant) {
+      var _variant$data_variant;
+      var id = String((_variant$data_variant = variant === null || variant === void 0 ? void 0 : variant.data_variant_rule_id) !== null && _variant$data_variant !== void 0 ? _variant$data_variant : '').trim();
+      if (id) ids.add(id);
+    });
+  };
+  products.forEach(function (product) {
+    remember(product.data_variants);
+    getBundleItems(product).forEach(function (item) {
+      return remember(item === null || item === void 0 ? void 0 : item.data_variants);
+    });
+  });
+  return ids;
+}
+function isEvaluatorReady(evaluator, products) {
+  if (typeof evaluator.isReady === 'function') {
+    if (evaluator.isReady() === false) return false;
+  }
+  if (evaluator.isReady === false || evaluator.ready === false) return false;
+
+  // The built-in evaluator is installed before its strategy request completes.
+  // A referenced Data Variant cannot be evaluated authoritatively until those
+  // configs have arrived. Evaluators without this capability remain compatible.
+  if (typeof evaluator.getStrategyConfigs === 'function') {
+    var configs = evaluator.getStrategyConfigs();
+    if (!Array.isArray(configs) || configs.length === 0) return false;
+    var availableRuleIds = new Set(configs.map(function (config) {
+      var _config$metadata$id, _config$metadata;
+      return String((_config$metadata$id = config === null || config === void 0 || (_config$metadata = config.metadata) === null || _config$metadata === void 0 ? void 0 : _config$metadata.id) !== null && _config$metadata$id !== void 0 ? _config$metadata$id : '').trim();
+    }).filter(Boolean));
+    return Array.from(collectReferencedRuleIds(products)).every(function (id) {
+      return availableRuleIds.has(id);
+    });
+  }
+  return true;
+}
+
 /**
- * 未启用商品 OS 路由时，在客户端补做 Data Variant 解析。
+ * Strict client-side Data Variant resolution for quote fast paths.
  *
- * 商品列表和预约报价必须共用这个边界，避免 H5 的弹窗报价绕过客户端智能定价。
- * OS Server 已接管时直接信任服务端结果，确保同一批商品只评估一次。
+ * Unlike resolveClientDataVariants, callers can distinguish a complete local
+ * result from a capability/readiness/error fallback and decide to query the
+ * remote product endpoint instead.
  */
-export function resolveClientDataVariants(_ref) {
+export function tryResolveClientDataVariants(_ref) {
   var _core$context, _scheduleModule$getSc, _core$context2, _core$context3, _strategyContext$busi;
   var core = _ref.core,
     _ref$otherParams = _ref.otherParams,
@@ -28,11 +89,59 @@ export function resolveClientDataVariants(_ref) {
     queryPayload = _ref.queryPayload,
     handledByOsServer = _ref.handledByOsServer,
     explicitScheduleList = _ref.scheduleList,
-    explicitMenuList = _ref.menuList;
-  if (handledByOsServer || products.length === 0) return products;
+    explicitMenuList = _ref.menuList,
+    _ref$requireCompleteD = _ref.requireCompleteDataVariantRelations,
+    requireCompleteDataVariantRelations = _ref$requireCompleteD === void 0 ? true : _ref$requireCompleteD,
+    _ref$requireEvaluator = _ref.requireEvaluatorReady,
+    requireEvaluatorReady = _ref$requireEvaluator === void 0 ? true : _ref$requireEvaluator;
+  if (handledByOsServer) {
+    return {
+      status: 'handled-by-os-server',
+      products: products
+    };
+  }
+  if (products.length === 0) {
+    return {
+      status: 'empty',
+      products: products
+    };
+  }
+  if (requireCompleteDataVariantRelations && !hasCompleteDataVariantRelations(products)) {
+    return {
+      status: 'data-variants-unavailable',
+      products: products
+    };
+  }
+
+  // Explicit empty arrays mean the query hydrated the relation and there is no
+  // rule to apply. This is an authoritative local base-price result even when
+  // no evaluator has been installed.
+  if (!hasAnyDataVariants(products)) {
+    return {
+      status: 'resolved',
+      products: products
+    };
+  }
   var evaluator = core === null || core === void 0 || (_core$context = core.context) === null || _core$context === void 0 ? void 0 : _core$context.dataVariantEvaluator;
   if (!evaluator || typeof evaluator.resolveProducts !== 'function') {
-    return products;
+    return {
+      status: 'evaluator-unavailable',
+      products: products
+    };
+  }
+  try {
+    if (requireEvaluatorReady && !isEvaluatorReady(evaluator, products)) {
+      return {
+        status: 'evaluator-not-ready',
+        products: products
+      };
+    }
+  } catch (error) {
+    return {
+      status: 'error',
+      products: products,
+      error: error
+    };
   }
   var strategyContext = queryPayload.strategy_context && _typeof(queryPayload.strategy_context) === 'object' ? queryPayload.strategy_context : {};
   var fatherModule = String(otherParams.fatherModule || '').trim();
@@ -43,7 +152,7 @@ export function resolveClientDataVariants(_ref) {
   var businessData = {
     products: products,
     scheduleDateTime: queryPayload.schedule_datetime || queryPayload.schedule_date,
-    scheduleList: Array.isArray(explicitScheduleList) ? explicitScheduleList : Array.isArray(moduleScheduleList) ? moduleScheduleList : Array.isArray(contextScheduleList) ? contextScheduleList : [],
+    scheduleList: Array.isArray(explicitScheduleList) && explicitScheduleList.length > 0 ? explicitScheduleList : Array.isArray(moduleScheduleList) && moduleScheduleList.length > 0 ? moduleScheduleList : Array.isArray(contextScheduleList) ? contextScheduleList : [],
     menuList: Array.isArray(explicitMenuList) ? explicitMenuList : Array.isArray(otherParams.menuList) ? otherParams.menuList : Array.isArray(contextMenuList) ? contextMenuList : [],
     customerId: queryPayload.customer_id,
     channel: strategyContext.channel,
@@ -54,9 +163,54 @@ export function resolveClientDataVariants(_ref) {
   };
   try {
     var result = evaluator.resolveProducts(businessData);
-    return Array.isArray(result === null || result === void 0 ? void 0 : result.products) ? result.products : products;
+    if (!Array.isArray(result === null || result === void 0 ? void 0 : result.products)) {
+      return {
+        status: 'error',
+        products: products,
+        error: new Error('Data Variant evaluator returned an invalid product list')
+      };
+    }
+    return {
+      status: 'resolved',
+      products: result.products
+    };
   } catch (error) {
-    console.error('[ClientDataVariants] Data Variant 客户端解析失败', error);
-    return products;
+    return {
+      status: 'error',
+      products: products,
+      error: error
+    };
+  }
+}
+
+/**
+ * 未启用商品 OS 路由时，在客户端补做 Data Variant 解析。
+ *
+ * 商品列表和预约报价必须共用这个边界，避免 H5 的弹窗报价绕过客户端智能定价。
+ * OS Server 已接管时直接信任服务端结果，确保同一批商品只评估一次。
+ */
+export function resolveClientDataVariants(_ref2) {
+  var core = _ref2.core,
+    _ref2$otherParams = _ref2.otherParams,
+    otherParams = _ref2$otherParams === void 0 ? {} : _ref2$otherParams,
+    products = _ref2.products,
+    queryPayload = _ref2.queryPayload,
+    handledByOsServer = _ref2.handledByOsServer,
+    explicitScheduleList = _ref2.scheduleList,
+    explicitMenuList = _ref2.menuList;
+  var result = tryResolveClientDataVariants({
+    core: core,
+    otherParams: otherParams,
+    products: products,
+    queryPayload: queryPayload,
+    handledByOsServer: handledByOsServer,
+    scheduleList: explicitScheduleList,
+    menuList: explicitMenuList,
+    requireCompleteDataVariantRelations: false,
+    requireEvaluatorReady: false
+  });
+  if (result.status === 'error') {
+    console.error('[ClientDataVariants] Data Variant 客户端解析失败', result.error);
   }
+  return result.products;
 }

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

@@ -9,6 +9,7 @@ export declare class ProductList extends BaseModule implements Module {
     private store;
     private request;
     private otherParams;
+    private rawProductPriceSources;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: any): Promise<void>;
     /**
@@ -36,6 +37,19 @@ export declare class ProductList extends BaseModule implements Module {
         schedule_date?: string;
         channel?: string;
     }): Promise<any>;
+    /**
+     * Remember raw remote product records before client-side Data Variant
+     * evaluation. Quote-only reads can then always start from a clean baseline.
+     */
+    rememberRawProductQueryResult(products: Array<ProductData | Record<string, any>>): void;
+    private replaceRawProductQueryResult;
+    /**
+     * Return isolated raw price sources for the requested products.
+     *
+     * Missing IDs are intentionally omitted so callers can remotely fetch only
+     * the incomplete part of a batch quote.
+     */
+    getRawProductPriceSources(ids: number[]): Map<number, ProductData>;
     getProducts(): Promise<ProductData[]>;
     getProduct(id: number): Promise<ProductData | undefined>;
     getProductByIds(ids: number[]): Promise<ProductData[] | undefined>;