@pisell/pisellos 0.10.42 → 0.10.44

package/dist/solution/UnifiedBookingSales/types.d.ts

@@ -1,8 +1,12 @@
 import type { InvoiceLayoutConfig, InvoiceTemplateSettings, OpenDataConfig } from '../../modules/OpenData';
-import type { ProductListLoadProductsParams } from '../../modules/ProductList';
+import type { ProductListLoadProductsParams, ProductListStoreQueryParams } from '../../modules/ProductList';
+import type { ProductData } from '../../modules/Product/types';
 import type { LoadScheduleAvailableDateParams } from '../../modules/Schedule/types';
 import type { AvailabilityDateRange, AvailabilityErrorCode, AvailabilityId, AvailabilityOccupancy, AvailabilityProduct, AvailabilityProjection, AvailabilityQuery, AvailabilityRequirementSelection, AvailabilityResource, AvailabilitySelectionValidationResult, DateAvailabilityQueryResult, GetProductTimeRangesRequest, ProductAvailabilityQueryResult, ProductTimeRange, ProductTimeRangeGroup, ResourceAvailabilityGroup, ResourceAvailabilityRangeGroup, TimeAvailabilityGroup, TimeAvailabilityItem } from '../../modules/ResourcePlanner';
 import type { BookingTicketState } from '../BookingTicket/types';
+import type { AllergyRequirement } from '../../model/strategy/adapter/itemRule';
+import type { SalesNoteDraftInput } from '../../modules/Order/types';
+export type { ProductListStoreQueryParams } from '../../modules/ProductList';
 export type { AvailabilityAbsoluteRange, AvailabilityAssignment, AvailabilityCell, AvailabilityDateRange, AvailabilityDisplayRange, AvailabilityErrorCode, AvailabilityId, AvailabilityMode, AvailabilityOccupancy, AvailabilityProduct, AvailabilityProductKind, AvailabilityProjection, AvailabilityProjectionInput, AvailabilityProjectionMeta, AvailabilityQuery, AvailabilityQueryResult, AvailabilityRequirementGroup, AvailabilityRequirementGroupResult, AvailabilityRequirementSelection, AvailabilityResource, AvailabilityResourceOption, AvailabilityResourceType, AvailabilityResourceWindow, AvailabilityScheduleMode, AvailabilityScheduleRef, AvailabilityScheduleRule, AvailabilitySelectionValidationParams, AvailabilitySelectionValidationResult, AvailabilitySessionRange, AvailabilityStatus, DateAvailabilityGroup, DateAvailabilityItem, DateAvailabilityQuery, DateAvailabilityQueryResult, GetProductTimeRangesRequest, ProductAvailabilityGroup, ProductAvailabilityItem, ProductAvailabilityQuery, ProductAvailabilityQueryResult, ProductTimeRange, ProductTimeRangeGroup, QueryAvailabilityBaseRequest, ResourceAvailabilityGroup, ResourceAvailabilityQuery, ResourceAvailabilityQueryResult, ResourceAvailabilityRangeGroup, TimeAvailabilityGroup, TimeAvailabilityItem, TimeAvailabilityQuery, TimeAvailabilityQueryResult, } from '../../modules/ResourcePlanner';
 export interface UnifiedBookingSalesState extends BookingTicketState {
 }
@@ -24,6 +28,12 @@ export declare enum UnifiedBookingSalesHooks {
 export interface UnifiedBookingSalesOtherParams extends Record<string, any> {
     enableSessionStoragePersist?: boolean;
 }
+export type UnifiedBookingSalesAllergyRequirement = AllergyRequirement;
+export interface UnifiedBookingSalesResolveProductAllergyRequirementParams {
+    productId: number | string;
+    productVariantId?: number | string;
+    channel?: string;
+}
 export interface UnifiedBookingSalesLoadOpenDataParams {
     businessCode: string;
     channel: string;
@@ -151,6 +161,8 @@ export interface ContextualCommitAvailabilitySelectionParams {
     requirementSelections: AvailabilityRequirementSelection[];
     partySize: number;
     bookingCount?: number;
+    /** 新增商品行时与商品、预约在同一次 Order mutation 内写入的 Sales Notes。 */
+    salesNotes?: SalesNoteDraftInput[];
     /** 编辑预约时，允许本次显式报价覆盖已落库订单行的历史价格。 */
     allowBookingReprice?: boolean;
     /** 编辑预约重报价后，允许订单模块重新应用已选编辑态折扣。 */
@@ -214,6 +226,7 @@ export interface UnifiedBookingSalesApi {
     /** Date-first calendar availability backed by ScheduleModule. */
     loadScheduleAvailableDate: (params: LoadScheduleAvailableDateParams) => Promise<unknown>;
     loadProductsByScheduleDate: (params: UnifiedBookingSalesLoadProductsByScheduleDateParams) => Promise<unknown[]>;
+    queryProducts: (params?: ProductListStoreQueryParams) => Promise<ProductData[]>;
     stageRetailProducts: (params: UnifiedBookingSalesStageRetailProductsParams) => Promise<Record<string, any> | null>;
     addRetailProduct: (params: UnifiedBookingSalesAddRetailProductParams) => Promise<Record<string, any>[]>;
     prepareAvailabilityProjection: (params: UnifiedBookingSalesPrepareAvailabilityProjectionParams) => Promise<AvailabilityContextRef>;

package/dist/solution/VenueBooking/index.d.ts

@@ -15,6 +15,7 @@ interface VenueBookingItemRuleRuntimeConfig {
     pax?: Partial<PaxInfo>;
     historicalItems?: CartItemSummary[];
     serviceType?: string;
+    channel?: string;
     submissionIndex?: number;
     custom?: Record<string, any>;
 }

package/dist/solution/VenueBooking/index.js

@@ -3140,7 +3140,11 @@ export var VenueBookingImpl = /*#__PURE__*/function (_BaseSalesImpl) {
   }, {
     key: "getItemRuleRuntimeConfig",
     value: function getItemRuleRuntimeConfig() {
-      return this.itemRuleRuntimeConfig || {};
+      var _ref6, _runtimeConfig$channe, _runtimeConfig$custom, _this$otherParams21;
+      var runtimeConfig = this.itemRuleRuntimeConfig || {};
+      return _objectSpread(_objectSpread({}, runtimeConfig), {}, {
+        channel: (_ref6 = (_runtimeConfig$channe = runtimeConfig.channel) !== null && _runtimeConfig$channe !== void 0 ? _runtimeConfig$channe : (_runtimeConfig$custom = runtimeConfig.custom) === null || _runtimeConfig$custom === void 0 ? void 0 : _runtimeConfig$custom.channel) !== null && _ref6 !== void 0 ? _ref6 : (_this$otherParams21 = this.otherParams) === null || _this$otherParams21 === void 0 ? void 0 : _this$otherParams21.channel
+      });
     }
   }, {
     key: "ensureItemRuleConfigsLoaded",
@@ -3806,14 +3810,14 @@ export var VenueBookingImpl = /*#__PURE__*/function (_BaseSalesImpl) {
     key: "setOtherParams",
     value: function () {
       var _setOtherParams = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee46(params) {
-        var _ref7,
-          _ref7$cover,
+        var _ref8,
+          _ref8$cover,
           cover,
           _args46 = arguments;
         return _regeneratorRuntime().wrap(function _callee46$(_context46) {
           while (1) switch (_context46.prev = _context46.next) {
             case 0:
-              _ref7 = _args46.length > 1 && _args46[1] !== undefined ? _args46[1] : {}, _ref7$cover = _ref7.cover, cover = _ref7$cover === void 0 ? false : _ref7$cover;
+              _ref8 = _args46.length > 1 && _args46[1] !== undefined ? _args46[1] : {}, _ref8$cover = _ref8.cover, cover = _ref8$cover === void 0 ? false : _ref8$cover;
               if (cover) {
                 this.otherParams = params;
               } else {

package/lib/model/strategy/adapter/itemRule/adapter.d.ts

@@ -1,6 +1,6 @@
 import type { EvaluationResult, RuntimeContext, ActionEffect } from '../../type';
 import type { BusinessAdapter } from '../type';
-import { type ItemRuleBusinessData, type QuantityCheckResult, type PrefillItemResult, type QuantityLimitResult } from './type';
+import { type ItemRuleBusinessData, type QuantityCheckResult, type PrefillItemResult, type QuantityLimitResult, type AllergyRequirement } from './type';
 /**
  * ItemRule 适配器
  *
@@ -14,7 +14,10 @@ export declare class ItemRuleAdapter implements BusinessAdapter {
     transformResult(result: EvaluationResult, businessData?: ItemRuleBusinessData): {
         quantityChecks: QuantityCheckResult[];
         prefillItems: PrefillItemResult[];
+        allergyRequirements: AllergyRequirement[];
     };
+    private processAllergyCheck;
+    private normalizeAllergyDataSourceItems;
     formatConfig(result: EvaluationResult, businessData?: ItemRuleBusinessData): {
         result: EvaluationResult;
         businessData?: ItemRuleBusinessData;

package/lib/model/strategy/adapter/itemRule/adapter.js

@@ -19,14 +19,17 @@ class ItemRuleAdapter {
       pax,
       cartItems,
       serviceType,
+      channel,
       submissionIndex,
       custom
     } = businessData;
+    const resolvedChannel = String(channel ?? custom?.channel ?? '').trim();
     return {
       entities: {
         cartItems,
         historicalItems: businessData.historicalItems || [],
-        pax
+        pax,
+        currentProduct: businessData.currentProduct
       },
       attributes: {
         serviceType: serviceType || '',
@@ -36,7 +39,8 @@ class ItemRuleAdapter {
         submissionIndex: submissionIndex ?? 0,
         cartItemCount: cartItems.length,
         cartTotalQuantity: cartItems.reduce((sum, item) => sum + item.quantity, 0),
-        ...custom
+        ...custom,
+        channel: resolvedChannel
       },
       metadata: {
         timestamp: Date.now()
@@ -46,10 +50,12 @@ class ItemRuleAdapter {
   transformResult(result, businessData) {
     const quantityChecks = [];
     const prefillItems = [];
+    const allergyRequirements = [];
     if (!result.applicable || !businessData) {
       return {
         quantityChecks,
-        prefillItems
+        prefillItems,
+        allergyRequirements
       };
     }
     for (const action of result.matchedActions) {
@@ -61,13 +67,76 @@ class ItemRuleAdapter {
       } else if (action.type === _type.ITEM_RULE_ACTION_TYPES.PREFILL_CART) {
         const items = this.processPrefillCart(action, businessData);
         prefillItems.push(...items);
+      } else if (action.type === _type.ITEM_RULE_ACTION_TYPES.ALLERGY_CHECK) {
+        const requirement = this.processAllergyCheck(action, result, businessData);
+        if (requirement) allergyRequirements.push(requirement);
       }
     }
     return {
       quantityChecks,
-      prefillItems
+      prefillItems,
+      allergyRequirements
     };
   }
+
+  // ============================================
+  // Allergy Check 处理
+  // ============================================
+
+  processAllergyCheck(action, result, businessData) {
+    const config = action.config;
+    const currentProduct = businessData.currentProduct;
+    if (!config || config.targetType !== 'product' || config.promptScope !== 'once_per_order_product' || !Array.isArray(config.targets) || !currentProduct) {
+      return null;
+    }
+    const currentProductId = Number(currentProduct.product_id);
+    const currentVariantId = Number(currentProduct.product_variant_id ?? 0);
+    if (!Number.isFinite(currentProductId) || currentProductId <= 0) return null;
+    const productTargets = config.targets.filter(item => Number(item.product_id) === currentProductId);
+    const target = productTargets.find(item => currentVariantId > 0 && Number(item.product_variant_id ?? 0) === currentVariantId) ?? productTargets.find(item => Number(item.product_variant_id ?? 0) <= 0);
+    if (!target || target.dataSource?.type !== 'inline') return null;
+    const items = this.normalizeAllergyDataSourceItems(target.dataSource.items);
+    if (!items.length) return null;
+    return {
+      strategyId: result.config.metadata.id,
+      ruleId: action.id,
+      priority: action.priority ?? 0,
+      targetType: 'product',
+      product_id: currentProductId,
+      ...(Number(target.product_variant_id ?? 0) > 0 ? {
+        product_variant_id: Number(target.product_variant_id)
+      } : {}),
+      dataSource: {
+        type: 'inline',
+        items
+      },
+      promptScope: config.promptScope,
+      allowNote: config.allowNote === true
+    };
+  }
+  normalizeAllergyDataSourceItems(items) {
+    if (!Array.isArray(items)) return [];
+    const uniqueIds = new Set();
+    const normalized = [];
+    for (const item of items) {
+      const id = String(item?.id ?? '').trim();
+      const rawLabel = item?.label;
+      const label = typeof rawLabel === 'string' ? rawLabel.trim() : Object.entries(rawLabel || {}).reduce((labels, [locale, value]) => {
+        if (typeof value === 'string' && value.trim().length > 0) {
+          labels[locale] = value.trim();
+        }
+        return labels;
+      }, {});
+      const hasLabel = typeof label === 'string' ? label.length > 0 : Object.keys(label).length > 0;
+      if (!id || !hasLabel || uniqueIds.has(id)) continue;
+      uniqueIds.add(id);
+      normalized.push({
+        id,
+        label
+      });
+    }
+    return normalized;
+  }
   formatConfig(result, businessData) {
     return {
       result,

package/lib/model/strategy/adapter/itemRule/evaluator.d.ts

@@ -1,5 +1,5 @@
 import type { StrategyConfig } from '../../type';
-import { type ItemRuleBusinessData, type ItemRuleEvaluationResult, type QuantityCheckResult, type QuantityLimitResult, type PrefillItemResult } from './type';
+import { type ItemRuleBusinessData, type ItemRuleEvaluationResult, type QuantityCheckResult, type QuantityLimitResult, type PrefillItemResult, type AllergyRequirement } from './type';
 /**
  * ItemRule 评估器
  *
@@ -21,6 +21,13 @@ export declare class ItemRuleEvaluator {
      * 完整评估：数量校验 + 预填购物车
      */
     evaluate(businessData: ItemRuleBusinessData): ItemRuleEvaluationResult;
+    /**
+     * 获取当前商品优先级最高的过敏门禁要求。
+     *
+     * 不同商品或不同 Action 的数据源不会合并；相同优先级按
+     * strategyId + ruleId 稳定排序，保证多次评估结果一致。
+     */
+    getAllergyRequirement(businessData: ItemRuleBusinessData): AllergyRequirement | null;
     /**
      * 获取当前配置中各商品的数量限制
      *

package/lib/model/strategy/adapter/itemRule/evaluator.js

@@ -43,6 +43,7 @@ class ItemRuleEvaluator {
     const configs = businessData.strategyConfigs ? businessData.strategyConfigs.filter(c => c.metadata.type === 'item_rule') : this.strategyConfigs;
     const allQuantityChecks = [];
     const allPrefillItems = [];
+    const allAllergyRequirements = [];
     const rawResults = [];
     const context = this.adapter.prepareContext(businessData);
     for (const config of configs) {
@@ -50,21 +51,42 @@ class ItemRuleEvaluator {
       rawResults.push(evalResult);
       const {
         quantityChecks,
-        prefillItems
+        prefillItems,
+        allergyRequirements
       } = this.adapter.transformResult(evalResult, businessData);
       allQuantityChecks.push(...quantityChecks);
       allPrefillItems.push(...prefillItems);
+      allAllergyRequirements.push(...allergyRequirements);
     }
     const failedChecks = allQuantityChecks.filter(c => !c.passed);
     return {
       quantityChecks: allQuantityChecks,
       prefillItems: allPrefillItems,
+      allergyRequirements: allAllergyRequirements,
       allPassed: failedChecks.length === 0,
       failedChecks,
       rawResults
     };
   }
 
+  /**
+   * 获取当前商品优先级最高的过敏门禁要求。
+   *
+   * 不同商品或不同 Action 的数据源不会合并；相同优先级按
+   * strategyId + ruleId 稳定排序，保证多次评估结果一致。
+   */
+  getAllergyRequirement(businessData) {
+    const requirements = this.evaluate(businessData).allergyRequirements;
+    if (!requirements.length) return null;
+    return [...requirements].sort((left, right) => {
+      const priorityDiff = right.priority - left.priority;
+      if (priorityDiff !== 0) return priorityDiff;
+      const strategyDiff = left.strategyId.localeCompare(right.strategyId);
+      if (strategyDiff !== 0) return strategyDiff;
+      return left.ruleId.localeCompare(right.ruleId);
+    })[0];
+  }
+
   /**
    * 获取当前配置中各商品的数量限制
    *

package/lib/model/strategy/adapter/itemRule/type.d.ts

@@ -4,6 +4,8 @@ export declare const ITEM_RULE_ACTION_TYPES: {
     readonly QUANTITY_CHECK: "QUANTITY_CHECK";
     /** 预填购物车 */
     readonly PREFILL_CART: "PREFILL_CART";
+    /** 加购前过敏信息确认 */
+    readonly ALLERGY_CHECK: "ALLERGY_CHECK";
 };
 export type ItemRuleActionType = (typeof ITEM_RULE_ACTION_TYPES)[keyof typeof ITEM_RULE_ACTION_TYPES];
 export declare const ITEM_RULE_TEMPLATES: {
@@ -63,6 +65,42 @@ export interface TargetItem {
     /** 变体 ID */
     product_variant_id?: number;
 }
+/** 策略展示文案，可由调用方按当前 locale 解析。 */
+export type ItemRuleLocalizedText = string | Record<string, string>;
+/** 内联过敏源选项。稳定 id 用于保存选择，label 只负责展示。 */
+export interface AllergyDataSourceItem {
+    id: string;
+    label: ItemRuleLocalizedText;
+}
+/** 当前仅支持随策略下发的内联过敏源。 */
+export interface AllergyDataSource {
+    type: 'inline';
+    items: AllergyDataSourceItem[];
+}
+/** 每个目标商品独立持有自己的过敏源，禁止跨商品合并。 */
+export interface AllergyTargetItem extends TargetItem {
+    dataSource: AllergyDataSource;
+}
+export type AllergyPromptScope = 'once_per_order_product';
+/** ALLERGY_CHECK Action 的商品级配置。 */
+export interface AllergyCheckConfig {
+    targetType: 'product';
+    targets: AllergyTargetItem[];
+    promptScope: AllergyPromptScope;
+    allowNote?: boolean;
+}
+/** 当前商品命中的单条过敏门禁要求。 */
+export interface AllergyRequirement {
+    strategyId: string;
+    ruleId: string;
+    priority: number;
+    targetType: 'product';
+    product_id: number;
+    product_variant_id?: number;
+    dataSource: AllergyDataSource;
+    promptScope: AllergyPromptScope;
+    allowNote: boolean;
+}
 /**
  * 预填商品项
  */
@@ -119,6 +157,10 @@ export interface ItemRuleBusinessData {
     historicalItems?: CartItemSummary[];
     /** 服务类型（如 'dine-in', 'takeaway'） */
     serviceType?: string;
+    /** 当前业务渠道（如 'kiosk', 'pos', 'online_store'） */
+    channel?: string;
+    /** 当前正在加入购物车的商品；ALLERGY_CHECK 只读取该商品的 Target。 */
+    currentProduct?: Pick<TargetItem, 'product_id' | 'product_variant_id'>;
     /** 当前提交次数（0=首次提交, >0=追加提交） */
     submissionIndex?: number;
     /** 策略配置列表（可选，如果不传则使用 setStrategyConfigs 设置的） */
@@ -216,6 +258,8 @@ export interface ItemRuleEvaluationResult {
     quantityChecks: QuantityCheckResult[];
     /** 需要预填的商品列表 */
     prefillItems: PrefillItemResult[];
+    /** 当前商品命中的过敏门禁要求；不同 Action/商品不会合并。 */
+    allergyRequirements: AllergyRequirement[];
     /** 所有校验是否全部通过 */
     allPassed: boolean;
     /** 未通过的校验列表 */

package/lib/model/strategy/adapter/itemRule/type.js

@@ -12,7 +12,9 @@ const ITEM_RULE_ACTION_TYPES = exports.ITEM_RULE_ACTION_TYPES = {
   /** 数量校验 */
   QUANTITY_CHECK: 'QUANTITY_CHECK',
   /** 预填购物车 */
-  PREFILL_CART: 'PREFILL_CART'
+  PREFILL_CART: 'PREFILL_CART',
+  /** 加购前过敏信息确认 */
+  ALLERGY_CHECK: 'ALLERGY_CHECK'
 };
 // ============================================
 // Rule Template 类型（创建规则时的起始模板）
@@ -56,6 +58,22 @@ const ITEM_RULE_TEMPLATES = exports.ITEM_RULE_TEMPLATES = {
 
 /** 目标项 */
 
+// ============================================
+// Allergy Check 相关类型
+// ============================================
+
+/** 策略展示文案，可由调用方按当前 locale 解析。 */
+
+/** 内联过敏源选项。稳定 id 用于保存选择，label 只负责展示。 */
+
+/** 当前仅支持随策略下发的内联过敏源。 */
+
+/** 每个目标商品独立持有自己的过敏源，禁止跨商品合并。 */
+
+/** ALLERGY_CHECK Action 的商品级配置。 */
+
+/** 当前商品命中的单条过敏门禁要求。 */
+
 // ============================================
 // Prefill Cart 相关类型
 // ============================================

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

@@ -1,46 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "BUY_X_GET_Y_FREE_STRATEGY", {
-  enumerable: true,
-  get: function () {
-    return _examples.BUY_X_GET_Y_FREE_STRATEGY;
-  }
-});
-Object.defineProperty(exports, "ITEM_REWARD_STRATEGY", {
-  enumerable: true,
-  get: function () {
-    return _examples.ITEM_REWARD_STRATEGY;
-  }
-});
-Object.defineProperty(exports, "PromotionAdapter", {
-  enumerable: true,
-  get: function () {
-    return _adapter.PromotionAdapter;
-  }
-});
-Object.defineProperty(exports, "PromotionEvaluator", {
-  enumerable: true,
-  get: function () {
-    return _evaluator.PromotionEvaluator;
-  }
-});
-Object.defineProperty(exports, "X_ITEMS_FOR_Y_PRICE_STRATEGY", {
-  enumerable: true,
-  get: function () {
-    return _examples.X_ITEMS_FOR_Y_PRICE_STRATEGY;
-  }
-});
-Object.defineProperty(exports, "default", {
-  enumerable: true,
-  get: function () {
-    return _adapter.default;
-  }
-});
-var _evaluator = require("./evaluator");
-var _adapter = _interopRequireWildcard(require("./adapter"));
-var _examples = require("./examples");
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+"use strict";

package/lib/modules/Order/index.d.ts

@@ -3,7 +3,7 @@ import { BaseModule } from '../BaseModule';
 import { OrderModuleAPI, CommitOrderParams, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, CancelOrderParams, ChangeBookingStatusParams, CheckoutOrderParams } from './types';
 import { CartItem } from '../Cart/types';
 import { type SubmitPayloadEnhancer } from './utils';
-import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions } from './types';
+import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, ShopServiceData, ShopServiceType } from './types';
 import type { ICustomer } from '../AccountList/types';
 import type { Discount } from '../Discount/types';
 import { UnavailableReason } from '../Rules/types';
@@ -20,6 +20,8 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private openCache;
     private sessionStoragePersistEnabled;
     private sessionStorageRestoreRecord;
+    /** 只允许当前订单最新的 prepare/config 请求回写客户资产态。 */
+    private customerWalletPrepareConfigEpoch;
     private salesSummaryModuleName;
     private rulesHooksOverride?;
     private moduleHooksOverride?;
@@ -29,8 +31,10 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private promotionEvaluator;
     /** 赠品选择 resolver；由 SDK host bridge 注入 */
     private giftSelectResolver;
-    /** applyPromotion 递归保护 flag（写路径同步调 applyPromotion，禁止重入） */
+    /** 促销评估递归保护 flag（写路径同步评估促销，禁止重入） */
     private isApplyingPromotion;
+    /** 保持旧事件语义：同步事件监听器内触发的订单写入不得递归评估促销。 */
+    private isEmittingPromotionApplied;
     /** 商品曾应用过客户券卡，客户变更剥离后需强制跑一次 calcDiscount 复位价格 */
     private hasActiveCustomerBoundDiscount;
     /** 最近一次 applyPromotion 的未满足促销提示 */
@@ -76,6 +80,11 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private logError;
     private registerDiscountModules;
     private createDefaultRulesHooks;
+    /**
+     * Stable across notifyTempOrderChanged's immutable copy, but changes when a
+     * different local/server order becomes current.
+     */
+    private getDiscountConfigOrderIdentityKey;
     loadDiscountConfig(params: {
         customerId: number;
         action?: 'create' | 'edit';
@@ -85,6 +94,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     getDiscountList(): Discount[];
     getAvailableWalletIds(): number[];
     getVirtualCurrencyList(): import("../Discount/types").VirtualCurrencyAsset[];
+    getCustomerWalletPrepareConfigEpoch(): number;
     private syncScannedDiscountsToOriginalDiscountList;
     private ensureEditDiscountConfigForProductChange;
     scanCode(code: string, customerId?: number): Promise<{
@@ -124,7 +134,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      */
     appendPromotionTags<T extends Record<string, any>>(products: T[]): T[];
     /**
-     * 应用购物车促销：计算 → 差异化赠品 → 写回 tempOrder.products → emit onPromotionApplied。
+     * 只执行购物车促销评估与赠品写回，不发布稳定态事件。
      *
      * 调用时机：写路径（add/update/remove/clear/setCustomer）末尾自动触发；外部一般无需手动调。
      *
@@ -132,8 +142,13 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * - 不调用任何公开 CRUD API（如 removeProductFromOrder），全部内部 mutate tempOrder.products，避免事件风暴；
      * - 用 `isApplyingPromotion` 防递归；
      * - 多选项赠品依赖 giftSelectResolver，未注入则跳过且 console.warn；
-     * - 不主动调用 applyDiscount / recalculateSummary，调用方负责跟进。
+     * - 不主动调用 applyDiscount / recalculateSummary，调用方负责跟进；
+     * - 返回的 payload 只能在 applyDiscount（商品写路径还需 summary/persist）完成后发布。
      */
+    private evaluatePromotion;
+    /** 发布促销稳定态；products 必须读取折扣计算后的当前数组。 */
+    private emitPromotionApplied;
+    /** 公开入口：促销、折扣、summary 与持久化完成后发布稳定态事件。 */
     applyPromotion(): Promise<void>;
     /** 最近一次 applyPromotion 输出的未满足促销列表 */
     getUnfulfilledPromotions(): OrderUnfulfilledPromotion[];
@@ -169,8 +184,10 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     consumeSessionStorageRestore(): Record<string, any> | null;
     notifyTempOrderChanged(): void;
     private createDefaultTempOrderInstance;
-    private clearTempOrderPointCardSnapshot;
-    private writePointCardSnapshotFromPrepareConfig;
+    private clearTempOrderCustomerWalletSnapshots;
+    private clearCustomerWalletState;
+    private clearCustomerWalletRuntimeState;
+    private writeCustomerWalletSnapshotsFromPrepareConfig;
     private createExternalSaleNumber;
     private ensureExternalSaleNumber;
     private ensureRequestUniqueIdempotencyToken;
@@ -306,9 +323,24 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     updateTempOrderNote(note: string, sync: boolean): string | Promise<string>;
     syncTempOrderNoteToRemote(orderId: number | string, note: string): Promise<string>;
     getTempOrderNote(): string;
+    private ensureSalesNotesRuntimeState;
+    private ensureSalesNotesLoadedForMutation;
+    private normalizeSalesNoteUuid;
+    private getSalesNotePrimaryRelation;
+    private removeSalesNotesForMissingProductLines;
+    private setSalesNoteOnTempOrder;
+    getSalesNotes(): SalesNote[];
+    createSalesNotesMutationSnapshot(): SalesNotesMutationSnapshot;
+    restoreSalesNotesMutationSnapshot(snapshot: SalesNotesMutationSnapshot): void;
+    setSalesNote(input: SetSalesNoteInput): Promise<SalesNote>;
+    removeSalesNote(uuid: string): Promise<void>;
+    clearSalesNotes(): Promise<void>;
     updateTempOrderShopDiscount(amount: string | number): string;
     updateTempOrderDepositAmount(amount: string | number): OrderSummary;
     updateTempOrderBuzzer(buzzer: string): string;
+    private updateTempOrderShopServiceData;
+    updateTempOrderPickupReferenceMode(mode: PickupReferenceMode): ShopServiceData;
+    updateTempOrderServiceType(serviceType: ShopServiceType): ShopServiceData;
     updateTempOrderContactsInfo(contactsInfo: Record<string, any> | null): Record<string, any> | null;
     private buildTempOrderCustomer;
     private isCustomerBoundDiscount;
@@ -476,7 +508,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     removeProductFromOrder(identity: OrderProductIdentity, options?: RemoveProductsFromOrderOptions): Promise<OrderProduct[]>;
     /**
      * 仅清空购物车行（products / bookings），不重置整单。
-     * 用于「仅清空商品」；客户、备注、支付等协议字段保持不变。
+     * 普通整单 note 保持不变；以商品行为主体的 Sales Notes 同步删除。
      */
     clearOrderCartLines(): Promise<OrderTempOrder>;
     /**
@@ -618,4 +650,4 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     getOrderInfo(order_id: number): Promise<any>;
     getVouchers(): any[];
 }
-export type { AddProductToOrderOptions, OrderMetaList, PointCardSnapshotItem, RemoveProductsFromOrderOptions, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, } from './types';
+export type { AddProductToOrderOptions, OrderMetaList, PointCardSnapshotItem, VirtualCurrencySnapshotItem, RemoveProductsFromOrderOptions, SalesNote, SalesNoteDraftInput, SalesNoteLocalizedSelection, SalesNoteLocalizedText, SalesNoteRelation, SalesNoteTextInput, SetSalesNoteInput, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, } from './types';