@pisell/pisellos 2.1.129 → 2.1.131

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

@@ -1,4 +1,4 @@
-import { OrderModule, ProductList, SalesSummaryModule, ScanOrderLogInput, ScanOrderLoggerModule, ScanOrderLoggerProviderConfig, ScanOrderLoggerProviderType } from '../../modules';
+import { OrderModule, ProductList, SalesSummaryModule, ScanOrderLogInput, ScanOrderLoggerModule, ScanOrderLoggerProviderConfig, ScanOrderLoggerProviderType, ScheduleModule } from '../../modules';
 import type { QuantityCheckResult, QuantityLimitResult } from '../../model/strategy/adapter/itemRule';
 /**
  * 扫码下单流程 hook
@@ -31,26 +31,70 @@ export interface ScanOrderOrderProductIdentity {
     product_id: number | null;
     product_variant_id: number;
     identity_key?: string;
+    /** 参与合并/匹配；与 remove 通配语义见 isSkuOnlyDeleteIdentity */
+    product_option_item?: any[];
+    product_bundle?: any[];
 }
 export interface ScanOrderOrderProduct extends ScanOrderOrderProductIdentity {
     order_detail_id: number | null;
     num: number;
     product_option_item: any[];
-    /** 券后单品单价（= 订单域实际成交单价）。未应用券时等同 original_price。 */
+    /**
+     * 券后 **行 composite 单价** = `metadata.main_product_selling_price`
+     *   + Σ((bundle.bundle_selling_price ?? bundle.price) × (bundle.num ?? 1))
+     *
+     * 新语义 v2 下 `metadata.main_product_selling_price` 已经**含 option**、含主商品折扣，
+     * 因此本字段不再叠加 option。未应用券时等同 `original_price`。
+     * Rules 钩子、主商品计税、Summary 统一读 metadata，不以此字段反推。
+     */
     selling_price: string;
-    /** 券前单品单价（= 店铺售价），不承载后台划线价语义。 */
+    /**
+     * 券前 **行 composite 单价** = `metadata.main_product_original_price`
+     *   + Σ(bundle 原价 × num)
+     *
+     * 新语义 v2 下 `metadata.main_product_original_price` 已经**含 option**、不含折扣。
+     * 不承载后台划线价语义。
+     */
     original_price: string;
     tax_fee: string;
     is_charge_tax: number;
     discount_list: any[];
     product_bundle: any[];
+    /**
+     * 行级扩展 metadata。价格相关的权威字段：
+     *
+     * - `source_product_price`：主商品/variant 基础价（已应用报价单），**不含 option、不含折扣**。
+     *   是派生 `main_product_*` 的唯一源。variant 分支优先读 `metadata.origin.variant[vid].price`。
+     * - `main_product_original_price` = `source_product_price + Σ(option.price × option.num)`，
+     *   **含 option、不含折扣**。
+     * - `main_product_selling_price` = `main_product_original_price − 主商品券 per-unit amount`，
+     *   **含 option、含主商品折扣**。Rules 钩子 / Summary / 计税均以此为主商品权威源。
+     * - `price_schema_version`（当前 = 2）：schema 版本 sentinel，用于跨端协商价格口径、
+     *   区分 v1 旧缓存以便 `normalizeOrderProduct` 触发迁移。
+     */
     metadata: Record<string, any>;
+    /** 商品行备注（如顾客对单品的特殊要求） */
+    note?: string;
     _origin?: Record<string, any>;
 }
+/**
+ * 出站 payload 版本的商品行。
+ *
+ * 与 tempOrder 内部 `ScanOrderOrderProduct` 的字段差异：
+ * - `product_option_item[*]`：内部为 `{ product_option_item_id, option_group_id, num, price, ... }`，
+ *   出站由 `normalizeSubmitProduct` 重命名为 `{ option_group_item_id, option_group_id, num }`
+ *   （后端 checkout 协议；丢弃 `price` 等运行时辅助字段）。
+ * - `product_bundle[*].option[*]`：同上重命名规则。
+ *
+ * 运行时（UI 显示、加购合并、指纹、持久化）全部消费内部字段名 `product_option_item_id`，
+ * 仅在 SDK 提交边界做一次出站映射，不影响 opaque identity 契约。
+ */
 export interface ScanOrderSubmitProduct extends Omit<ScanOrderOrderProduct, '_origin' | 'identity_key'> {
     /**
      * 出站兼容字段：SDK 内部不再消费 payment_price，
      * 仅在提交后端时由 selling_price 派生，保持原有后端契约。
+     * 新语义 v2 下 selling_price 是 composite（含 option、含 bundle、含主商品折扣），
+     * 因此 payment_price 同样是 composite。
      */
     payment_price: string;
 }
@@ -114,6 +158,9 @@ export interface ScanOrderTempOrder {
     shop_discount: string;
     surcharge_fee: string;
     note: string;
+    buzzer?: string;
+    delivery_type?: string;
+    table_number?: Record<string, any>;
     schedule_date: string;
     created_at: string;
     products: ScanOrderOrderProduct[];
@@ -134,14 +181,15 @@ export interface ScanOrderSubmitPayload extends Omit<ScanOrderTempOrder, 'platfo
     request_unique_idempotency_token?: string;
     form_record_ids?: Array<{
         form_id: number | string;
-        form_record_ids: Array<number | string>;
+        form_record_id: number | string;
     }>;
     products: ScanOrderSubmitProduct[];
 }
-export type ScanOrderAvailabilityMode = 'idle' | 'shop_closed' | 'resource_block' | 'resource_busy' | 'additional_order_with_code' | 'additional_order';
+export type ScanOrderAvailabilityMode = 'idle' | 'shop_closed' | 'submit_disabled' | 'resource_busy' | 'additional_order_with_code' | 'additional_order';
 export interface ScanOrderTableFormRecord {
     policy?: string | null;
     partyroom_booking?: string | null;
+    capacity?: number | string | null;
     [key: string]: any;
 }
 export interface ScanOrderAvailabilityInfo {
@@ -151,7 +199,9 @@ export interface ScanOrderAvailabilityInfo {
     table_form_id?: string;
     deskmate_valid?: boolean;
     errorTips?: string;
-    /** `/order/dining/table/config` 返回的 `table_form_record` 原样透出 */
+    /** 透传 `availability.closed_behavior`，便于 UI 识别拦截类型（如 show_menu_disabled） */
+    closed_behavior?: string;
+    /** `/order/resource/occupy-detail` 返回的 `form_record` 原样透出 */
     table_form_record?: ScanOrderTableFormRecord | null;
     policy?: string | null;
     partyroom_booking?: string | null;
@@ -162,34 +212,36 @@ export interface ScanOrderAvailabilityInfo {
     /** 首个 `capacity.type === 'custom'` 商品里 `custom[0]` 的 max（人数上限） */
     requestPaxMax?: number;
 }
-export interface ScanOrderTableSnackConfig {
-    snack?: boolean | number | string;
-    table_validate?: boolean | number | string;
+/** `resource_capacity[i].capacity_list[j]` */
+export interface ScanOrderResourceCapacitySlot {
+    start_at?: string;
+    end_at?: string;
+    pax?: number | string;
 }
-export interface ScanOrderOrderNumberPrefixConfig {
-    table_order?: string;
-    pos?: string;
+export interface ScanOrderResourceCapacity {
+    capacity?: number | string;
+    capacity_list?: ScanOrderResourceCapacitySlot[];
 }
-export interface ScanOrderTableConfigApiData {
-    table_max_number?: number | string | null;
-    order_count?: number | string | null;
+/** `/order/resource/occupy-detail` 单条 `occupy_details[i]` */
+export interface ScanOrderResourceOccupyDetail {
+    form_record_id?: number | string | null;
+    form_id?: number | string | null;
     order_id?: number | string | null;
     last_order_id?: number | string | null;
-    relation_id?: number | string | null;
-    table_form_id?: number | string | null;
-    table_snack?: ScanOrderTableSnackConfig[] | null;
-    order_number_prefix?: ScanOrderOrderNumberPrefixConfig[] | null;
+    resource_capacity?: ScanOrderResourceCapacity[] | null;
+    form_record?: ScanOrderTableFormRecord | null;
     [key: string]: any;
 }
-export interface ScanOrderTableConfigApiResponse {
+export interface ScanOrderResourceOccupyDetailApiResponse {
     status?: boolean;
     code?: number;
     message?: string;
-    data?: ScanOrderTableConfigApiData | null;
+    data?: {
+        occupy_details?: ScanOrderResourceOccupyDetail[] | null;
+    } | null;
 }
+export type ScanOrderResourceSelectType = 'single' | 'multiple' | 'capacity';
 export interface ScanOrderResourceState extends ScanOrderAvailabilityInfo {
-    tableMaxNumber: number;
-    orderCount: number;
     relationId?: string;
     tableFormId?: string;
     currentOrderId?: string;
@@ -198,13 +250,14 @@ export interface ScanOrderResourceState extends ScanOrderAvailabilityInfo {
     deskmateValid: boolean;
     isExclusive: boolean;
     isFull: boolean;
-    orderNumberPrefix: ScanOrderOrderNumberPrefixConfig[];
-    raw: ScanOrderTableConfigApiData | null;
+    /** 来自首个预约规则商品 product_resource.resources 中与 form_id 匹配的 resource type */
+    resourceSelectType?: ScanOrderResourceSelectType;
+    raw: ScanOrderResourceOccupyDetail | null;
 }
 export interface ScanOrderState {
     entryContext: ScanOrderEntryContext | null;
     status: ScanOrderStatus;
-    config: ScanOrderTableConfigApiData | null;
+    config: Record<string, any> | null;
     resource: ScanOrderResourceState | null;
     flow: Record<string, any>;
     error: string | null;
@@ -212,6 +265,7 @@ export interface ScanOrderState {
     order?: OrderModule;
     salesSummary?: SalesSummaryModule;
     scanOrderLogger?: ScanOrderLoggerModule;
+    schedule?: ScheduleModule;
     itemRuleQuantityLimits: QuantityLimitResult[];
     cartValidation: {
         passed: boolean | null;
@@ -225,3 +279,9 @@ export interface ScanOrderLoggerRuntimeConfig {
 }
 export interface ScanOrderAddLogParams extends ScanOrderLogInput {
 }
+/** ScanOrder.scanCode 对外的轻量结果（不含 discountList，UI 在 resolve 后调 getDiscountList） */
+export interface ScanOrderScanCodeResult {
+    isAvailable: boolean;
+    type?: 'server' | string;
+    unavailableReason?: 'time_limit' | string;
+}

package/dist/solution/ScanOrder/types.js

@@ -10,7 +10,26 @@ export var ScanOrderHooks = /*#__PURE__*/function (ScanOrderHooks) {
   return ScanOrderHooks;
 }({});
 
+/**
+ * 出站 payload 版本的商品行。
+ *
+ * 与 tempOrder 内部 `ScanOrderOrderProduct` 的字段差异：
+ * - `product_option_item[*]`：内部为 `{ product_option_item_id, option_group_id, num, price, ... }`，
+ *   出站由 `normalizeSubmitProduct` 重命名为 `{ option_group_item_id, option_group_id, num }`
+ *   （后端 checkout 协议；丢弃 `price` 等运行时辅助字段）。
+ * - `product_bundle[*].option[*]`：同上重命名规则。
+ *
+ * 运行时（UI 显示、加购合并、指纹、持久化）全部消费内部字段名 `product_option_item_id`，
+ * 仅在 SDK 提交边界做一次出站映射，不影响 opaque identity 契约。
+ */
+
 /**
  * ScanOrder 临时订单（runtime-clean 版本）
  * 只保留运行时字段，不包含任何 __comment 字段
- */
+ */
+
+/** `resource_capacity[i].capacity_list[j]` */
+
+/** `/order/resource/occupy-detail` 单条 `occupy_details[i]` */
+
+/** ScanOrder.scanCode 对外的轻量结果（不含 discountList，UI 在 resolve 后调 getDiscountList） */

package/dist/solution/ScanOrder/utils.d.ts

@@ -1,4 +1,4 @@
-import { ScanOrderOrderProduct, ScanOrderOrderProductIdentity, ScanOrderSummary, ScanOrderTempOrder } from './types';
+import { ScanOrderOrderProduct, ScanOrderOrderProductIdentity, ScanOrderResourceCapacitySlot, ScanOrderResourceSelectType, ScanOrderSummary, ScanOrderTempOrder } from './types';
 import type { CartItemSummary, ItemRuleBusinessData, PaxInfo, QuantityLimitResult } from '../../model/strategy/adapter/itemRule';
 import type { StrategyConfig } from '../../model/strategy/type';
 import type { ProductData } from '../../modules/Product/types';
@@ -82,9 +82,24 @@ export declare function buildItemRuleBusinessData(params: {
 }): ItemRuleBusinessData;
 export declare function attachItemRuleLimitsToTopLevelProducts<T>(productList: T, limits: QuantityLimitResult[]): T;
 /**
- * 判断两个商品 identity 是否匹配。
- * 当双方都没有 identity_key 时回退到 product_id + product_variant_id 比较（向后兼容）；
- * 一旦有一方携带 identity_key，则必须严格相等。
+ * 将选项行 / 套餐行归一成稳定 JSON，用于「同 SKU 是否合并」判断。
+ * 数组元素先按主键排序再序列化，避免顺序差异导致误判为不同行。
+ */
+export declare function buildProductLineFingerprint(productOptionItem?: unknown, productBundle?: unknown): string;
+/**
+ * removeProductFromOrder 仅传 SKU 时的通配 identity（对象上未声明选项键）。
+ * 与显式 `product_option_item: []` 区分：后者只匹配「无选项」行。
+ */
+export declare function isSkuOnlyDeleteIdentity(x: ScanOrderOrderProductIdentity): boolean;
+/**
+ * 判断两个商品 identity 是否匹配（不透明 identity 契约）。
+ *
+ * 调用约定：始终 `isIdentityMatch(line, callerIdentity)`。
+ * - 若 SKU（product_id + product_variant_id）不一致 → 不匹配。
+ * - **双方都带** `identity_key` → 严格字符串相等比较（不再猜测合成 key / metadata 桥接）。
+ *   这是 opaque identity 契约的标准路径：UI 删改时透传 SDK 回灌的 identity_key。
+ * - 否则（即至少一侧未声明 identity_key）→ 进入「SKU 通配 / 显式空选项 / 指纹」回退路径，
+ *   忽略线侧 identity_key，按内容语义匹配。这给「行已 opaque、调用方却想按 SKU 通配 / 选项指纹删除」留兼容入口。
  */
 export declare function isIdentityMatch(a: ScanOrderOrderProductIdentity, b: ScanOrderOrderProductIdentity): boolean;
 /**
@@ -93,10 +108,26 @@ export declare function isIdentityMatch(a: ScanOrderOrderProductIdentity, b: Sca
  */
 export declare function getProductIdentityIndex(products: ScanOrderOrderProduct[], identity: ScanOrderOrderProductIdentity): number;
 /**
- * 对外部传入的商品对象做归一化：
+ * 对外部传入的商品对象做归一化（v2 composite 语义）：
  * - 补全可选字段默认值（未传则使用兜底值，避免后续计算时因 undefined 导致异常）
  * - 对 num 调用 getSafeProductNum 做安全处理
  * - 保留 _origin 供后续业务流程（如促销规则）使用
+ *
+ * 价格字段语义（metadata 权威源 + composite 派生）：
+ * - `metadata.source_product_price`：主商品/variant 基础价（已应用报价单），**不含 option**、
+ *   **不含折扣**。是推导 main_product_* 的起点。variant 分支优先读 `metadata.origin.variant[vid].price`。
+ * - `metadata.main_product_original_price`：`source + Σ(option.price × option.num)`，**含 option**、
+ *   **不含折扣**。
+ * - `metadata.main_product_selling_price`：`main_product_original_price - 主商品券 per-unit amount`，
+ *   **含 option**、**含折扣**。
+ * - 行级 `selling_price` = `main_product_selling_price + Σ(bundle_selling_price × num)`。
+ * - 行级 `original_price` = `main_product_original_price + Σ(bundle 原价 × num)`。
+ *
+ * 迁移与幂等：
+ * - `metadata.price_schema_version === 2` → 已新语义归一化，保留 main_product_* 原值（保留折扣）。
+ * - 其它情况（v1 / 缺字段 / 无 metadata）→ 按"main_product_selling_price 曾是 main-only"的旧约定
+ *   反推 legacyDiscount，再以新 source + options 基准重算。最终统一打上 `price_schema_version: 2`。
+ * - 因此多次 normalize 不会重复叠加 option/bundle。
  */
 export declare function normalizeOrderProduct(product: Partial<ScanOrderOrderProduct> & ScanOrderOrderProductIdentity): ScanOrderOrderProduct;
 /**
@@ -109,6 +140,18 @@ export declare function collectLinkProductIdsFromReservationRules(rules: unknown
 export declare function pickFirstDurationMinutesFromProducts(products: ProductData[]): number | undefined;
 /** 是否存在 capacity.type === 'custom' 的商品 */
 export declare function hasCustomCapacityProduct(products: ProductData[]): boolean;
+/**
+ * 根据预约规则商品的 resource.type 计算桌台是否已被"占满"。
+ * - single：只要有 `lastOrderId` 即视为占用
+ * - multiple：当前时间落在 `capacity_list[i]` 的 `[start_at, end_at]`（inclusive）内的 pax 之和 >= 总容量
+ * - 其他（'capacity' / undefined）：返回 false，不施加限制
+ */
+export declare function computeResourceIsFull(params: {
+    resourceSelectType?: ScanOrderResourceSelectType;
+    lastOrderId?: string;
+    capacityList?: ScanOrderResourceCapacitySlot[];
+    capacity?: number | string | null;
+}): boolean;
 /**
  * 在商品列表中找到第一个 `capacity.type === 'custom'` 的商品，取其 `custom` 数组第一项的 min/max。
  * 仅返回有限数字字段；若均无法解析则返回 `undefined`。
@@ -117,3 +160,8 @@ export declare function pickFirstCustomCapacityPaxBounds(products: ProductData[]
     min?: number;
     max?: number;
 } | undefined;
+/**
+ * 第一个 `capacity.type === 'custom'` 的商品，取其 `custom[0].id`（提交 booking metadata.capacity 维度 id）。
+ * 无匹配时返回 `undefined`，调用方应回退为 `0`。
+ */
+export declare function pickFirstCustomCapacityDimensionId(products: ProductData[]): string | number | undefined;