@pisell/pisellos 2.2.148 → 2.2.149

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

@@ -0,0 +1,305 @@
+import { OrderModule, ProductList, SalesSummaryModule, ScanOrderLoggerModule as BaseSalesLoggerModule, ScheduleModule } from '../../modules';
+import type { ScanOrderLogInput as BaseSalesLogInput, ScanOrderLoggerProviderConfig as BaseSalesLoggerProviderConfig, ScanOrderLoggerProviderType as BaseSalesLoggerProviderType } from '../../modules/ScanOrderLogger/types';
+import type { QuantityCheckResult, QuantityLimitResult } from '../../model/strategy/adapter/itemRule';
+/**
+ * BaseSales 流程 hook 后缀。
+ * 完整事件名应由当前模块名动态拼接，避免多个实例共享固定事件 key。
+ */
+export declare const BaseSalesHookNames: {
+    readonly onInited: "onInited";
+    readonly onDestroy: "onDestroy";
+    readonly onRetryInit: "onRetryInit";
+    readonly onRefresh: "onRefresh";
+    readonly onCartValidationChanged: "onCartValidationChanged";
+};
+export type BaseSalesHookName = typeof BaseSalesHookNames[keyof typeof BaseSalesHookNames];
+export declare function createBaseSalesHook(moduleName: string, hookName: BaseSalesHookName): string;
+export type BaseSalesStatus = 'idle' | 'initializing' | 'ready' | 'error';
+export type BaseSalesPaymentStatus = 'paid' | 'partially_paid' | 'unpaid' | 'payment_processing' | string;
+export interface BaseSalesEntryContext {
+    biz: string;
+    mode: 'scan' | 'append';
+    resourceId?: string;
+    sourceOrderId?: string;
+}
+export interface BaseSalesConfig {
+    orderSource: 'local' | 'remote';
+    scanTimeout: number;
+    allowAppend: boolean;
+    maxAppendCount: number;
+    features: {
+        autoMerge: boolean;
+        verifyResource: boolean;
+    };
+}
+export interface BaseSalesOrderProductIdentity {
+    product_id: number | null;
+    product_variant_id: number;
+    /** @deprecated 行级唯一值统一使用 metadata.unique_identification_number */
+    identity_key?: string;
+    unique_identification_number?: string;
+    /** 参与合并/匹配；与 remove 通配语义见 isSkuOnlyDeleteIdentity */
+    product_option_item?: any[];
+    product_bundle?: any[];
+}
+export interface BaseSalesOrderProduct extends BaseSalesOrderProductIdentity {
+    order_detail_id: number | null;
+    num: number;
+    product_option_item: any[];
+    /**
+     * 券后 **行 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[];
+    /** 关联 booking.metadata.unique_identification_number */
+    booking_uid?: string;
+    /**
+     * 行级扩展 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;
+    /** @deprecated UI/SDK 运行态数据迁移到 tempOrder._extend */
+    _origin?: Record<string, any>;
+}
+/**
+ * 出站 payload 版本的商品行。
+ *
+ * 与 tempOrder 内部 `BaseSalesOrderProduct` 的字段差异：
+ * - `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 BaseSalesSubmitProduct extends Omit<BaseSalesOrderProduct, '_origin' | 'identity_key'> {
+    /**
+     * 出站兼容字段：SDK 内部不再消费 payment_price，
+     * 仅在提交后端时由 selling_price 派生，保持原有后端契约。
+     * 新语义 v2 下 selling_price 是 composite（含 option、含 bundle、含主商品折扣），
+     * 因此 payment_price 同样是 composite。
+     */
+    payment_price: string;
+}
+export interface BaseSalesSummary {
+    product_quantity: number;
+    product_original_amount: string;
+    product_amount: string;
+    product_expect_amount: string;
+    product_tax_fee: string;
+    shipping_fee: string;
+    shipping_tax_fee: string;
+    tax_fee: string;
+    surcharge_fee: string;
+    discount_amount: string;
+    deposit_amount: string;
+    deposit?: {
+        total: string;
+        deposit_policy_ids: number[];
+        hasDeposit: boolean;
+    };
+    expect_amount: string;
+    total_amount: string;
+    amount_gap: string;
+    rounding_amount: string;
+    pay_service_charge_amount: string;
+    tax_title?: string;
+    tax_rate?: number;
+}
+/**
+ * BaseSales 临时订单（runtime-clean 版本）
+ * 只保留运行时字段，不包含任何 __comment 字段
+ */
+export interface BaseSalesTempOrder {
+    order_id: number | null;
+    /** @deprecated 资源运行态迁移到 Solution store */
+    relation_id?: string;
+    /** @deprecated 资源运行态迁移到 Solution store */
+    table_form_id?: string;
+    /** @deprecated 资源运行态迁移到 Solution store */
+    resource_id?: string;
+    external_sale_number: string;
+    order_number: string;
+    shop_order_number: string;
+    shop_full_order_number: string;
+    type: string;
+    business_code: string;
+    platform: string;
+    sales_channel: string;
+    order_sales_channel: string;
+    status: string;
+    payment_status: string;
+    shipping_status: string;
+    customer_id: number | null;
+    customer_name: string;
+    country_calling_code: string;
+    phone: string;
+    email: string;
+    is_price_include_tax: number;
+    tax_title: string;
+    tax_country_code: string;
+    currency_code: string;
+    currency_symbol: string;
+    currency_format: string;
+    is_deposit: number;
+    deposit_amount: string;
+    shop_discount: string;
+    surcharge_fee: string;
+    note: string;
+    buzzer?: string;
+    delivery_type?: string;
+    table_number?: Record<string, any>;
+    schedule_date: string;
+    created_at: string;
+    request_unique_idempotency_token?: string;
+    products: BaseSalesOrderProduct[];
+    bookings: any[];
+    payments: any[];
+    surcharges: any[];
+    discount_list: any[];
+    relation_forms: any[];
+    contacts: any[];
+    contacts_info: Record<string, any> | null;
+    holder: Record<string, any> | null;
+    metadata: Record<string, any>;
+    _extend?: {
+        productsByUid?: Record<string, Record<string, any>>;
+        [key: string]: any;
+    };
+}
+export interface BaseSalesSubmitPayload extends Omit<BaseSalesTempOrder, 'platform' | 'products' | '_extend' | 'shop_full_order_number'> {
+    platform: string;
+    request_unique_idempotency_token?: string;
+    form_record_ids?: Array<{
+        form_id: number | string;
+        form_record_id: number | string;
+    }>;
+    products: BaseSalesSubmitProduct[];
+}
+export type BaseSalesAvailabilityMode = 'idle' | 'shop_closed' | 'submit_disabled' | 'resource_busy' | 'additional_order_with_code' | 'additional_order';
+export interface BaseSalesTableFormRecord {
+    policy?: string | null;
+    partyroom_booking?: string | null;
+    capacity?: number | string | null;
+    [key: string]: any;
+}
+export interface BaseSalesAvailabilityInfo {
+    mode: BaseSalesAvailabilityMode;
+    order_id?: string;
+    relation_id?: string;
+    table_form_id?: string;
+    deskmate_valid?: boolean;
+    errorTips?: string;
+    /** 透传 `availability.closed_behavior`，便于 UI 识别拦截类型（如 show_menu_disabled） */
+    closed_behavior?: string;
+    /** `/order/resource/occupy-detail` 返回的 `form_record` 原样透出 */
+    table_form_record?: BaseSalesTableFormRecord | null;
+    policy?: string | null;
+    partyroom_booking?: string | null;
+    /** 预约规则关联商品存在 custom 容量时，由 checkResourceAvailable 置为 1 */
+    requestEntryPax?: number;
+    /** 首个 `capacity.type === 'custom'` 商品里 `custom[0]` 的 min（人数下限） */
+    requestPaxMin?: number;
+    /** 首个 `capacity.type === 'custom'` 商品里 `custom[0]` 的 max（人数上限） */
+    requestPaxMax?: number;
+}
+/** `resource_capacity[i].capacity_list[j]` */
+export interface BaseSalesResourceCapacitySlot {
+    start_at?: string;
+    end_at?: string;
+    pax?: number | string;
+}
+export interface BaseSalesResourceCapacity {
+    capacity?: number | string;
+    capacity_list?: BaseSalesResourceCapacitySlot[];
+}
+/** `/order/resource/occupy-detail` 单条 `occupy_details[i]` */
+export interface BaseSalesResourceOccupyDetail {
+    form_record_id?: number | string | null;
+    form_id?: number | string | null;
+    order_id?: number | string | null;
+    last_order_id?: number | string | null;
+    resource_capacity?: BaseSalesResourceCapacity[] | null;
+    form_record?: BaseSalesTableFormRecord | null;
+    [key: string]: any;
+}
+export interface BaseSalesResourceOccupyDetailApiResponse {
+    status?: boolean;
+    code?: number;
+    message?: string;
+    data?: {
+        occupy_details?: BaseSalesResourceOccupyDetail[] | null;
+    } | null;
+}
+export type BaseSalesResourceSelectType = 'single' | 'multiple' | 'capacity';
+export interface BaseSalesResourceState extends BaseSalesAvailabilityInfo {
+    relationId?: string;
+    tableFormId?: string;
+    currentOrderId?: string;
+    lastOrderId?: string;
+    allowSnack: boolean;
+    deskmateValid: boolean;
+    isExclusive: boolean;
+    isFull: boolean;
+    /** 来自首个预约规则商品 product_resource.resources 中与 form_id 匹配的 resource type */
+    resourceSelectType?: BaseSalesResourceSelectType;
+    raw: BaseSalesResourceOccupyDetail | null;
+}
+export interface BaseSalesState {
+    entryContext: BaseSalesEntryContext | null;
+    status: BaseSalesStatus;
+    config: Record<string, any> | null;
+    resource: BaseSalesResourceState | null;
+    flow: Record<string, any>;
+    error: string | null;
+    products?: ProductList;
+    order?: OrderModule;
+    salesSummary?: SalesSummaryModule;
+    baseSalesLogger?: BaseSalesLoggerModule;
+    schedule?: ScheduleModule;
+    itemRuleQuantityLimits: QuantityLimitResult[];
+    cartValidation: {
+        passed: boolean | null;
+        failures: QuantityCheckResult[];
+    };
+    entryPaxNumber: number | null;
+}
+export interface BaseSalesLoggerRuntimeConfig {
+    provider?: BaseSalesLoggerProviderType;
+    providerConfig?: BaseSalesLoggerProviderConfig;
+}
+export interface BaseSalesAddLogParams extends BaseSalesLogInput {
+}
+/** BaseSales.scanPromotionCode 对外的轻量结果（不含 discountList，UI 在 resolve 后调 getDiscountList） */
+export interface BaseSalesScanCodeResult {
+    isAvailable: boolean;
+    type?: 'server' | string;
+    unavailableReason?: 'time_limit' | string;
+}

package/dist/solution/BaseSales/types.js

@@ -0,0 +1,38 @@
+/**
+ * BaseSales 流程 hook 后缀。
+ * 完整事件名应由当前模块名动态拼接，避免多个实例共享固定事件 key。
+ */
+export var BaseSalesHookNames = {
+  onInited: 'onInited',
+  onDestroy: 'onDestroy',
+  onRetryInit: 'onRetryInit',
+  onRefresh: 'onRefresh',
+  onCartValidationChanged: 'onCartValidationChanged'
+};
+export function createBaseSalesHook(moduleName, hookName) {
+  return "".concat(moduleName, ":").concat(hookName);
+}
+
+/**
+ * 出站 payload 版本的商品行。
+ *
+ * 与 tempOrder 内部 `BaseSalesOrderProduct` 的字段差异：
+ * - `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 契约。
+ */
+
+/**
+ * BaseSales 临时订单（runtime-clean 版本）
+ * 只保留运行时字段，不包含任何 __comment 字段
+ */
+
+/** `resource_capacity[i].capacity_list[j]` */
+
+/** `/order/resource/occupy-detail` 单条 `occupy_details[i]` */
+
+/** BaseSales.scanPromotionCode 对外的轻量结果（不含 discountList，UI 在 resolve 后调 getDiscountList） */

package/dist/solution/BaseSales/utils/parseSalesResponse.d.ts

@@ -0,0 +1,143 @@
+/**
+ * 把 `/order/sales/{id}` 响应（OrderData）解析为 ISalesDetail。
+ *
+ * - 纯函数：不依赖任何运行时模块/插件，便于单测与 view-model 适配
+ * - products 保留 tempOrder / 后端详情原字段，仅做浅拷贝，避免丢失 product_sku 等协议字段
+ * - bookings 平铺保留服务端原顺序，同时输出 byProductUid 反查表与 rootBooking
+ * - header 收敛"非数组顶层字段"，便于 ticketBooking view-model 直接消费
+ *
+ * 设计原则参考 `.cursor/rules/data-field-semantics.mdc`：
+ * - 字段命名以《统一 Sales 数据协议》为准（OrderData 类型）
+ * - root booking 以 `parent_id === 0` 判定，沿用 ticketBooking 现有约定
+ *   （`packages/private-materials/src/components/ticketBooking/index.tsx`：
+ *    `booking.parent_id === 0 ? 'list' : 'detail'`）
+ * - 不在此处发明等价关系；UI 侧（ticketBooking）若需要别的字段，由 view-model 适配层做转换
+ */
+import type { BaseSalesOrderProduct } from '../types';
+export interface ISalesDetailHeader {
+    order_id: number | string | null;
+    order_number?: string;
+    shop_order_number?: string;
+    shop_full_order_number?: string;
+    type?: string;
+    business_code?: string;
+    platform?: string;
+    sales_channel?: string;
+    order_sales_channel?: string;
+    status?: string;
+    payment_status?: string;
+    shipping_status?: string;
+    customer_id?: number | string | null;
+    customer_name?: string;
+    country_calling_code?: string;
+    phone?: string;
+    email?: string;
+    is_price_include_tax?: 0 | 1;
+    tax_title?: string;
+    tax_country_code?: string;
+    currency_code?: string;
+    currency_symbol?: string;
+    currency_format?: string;
+    is_deposit?: 0 | 1;
+    deposit_amount?: string;
+    shop_discount?: string;
+    surcharge_fee?: string;
+    note?: string;
+    schedule_date?: string;
+    created_at?: string;
+    updated_at?: string | number;
+    metadata?: Record<string, any> | null;
+    total_amount?: string | number;
+    [key: string]: any;
+}
+export interface ISalesDetailCustomer {
+    id: number | string | null;
+    name: string;
+    phone?: string;
+    email?: string;
+    country_calling_code?: string;
+    [key: string]: any;
+}
+export interface ISalesBooking {
+    schedule_event_id?: number | null;
+    booking_id?: string;
+    appointment_status?: string;
+    status?: string;
+    start_date?: string;
+    start_time?: string;
+    end_date?: string;
+    end_time?: string;
+    duration?: number;
+    sub_type?: string;
+    number?: number;
+    resources?: any[];
+    product?: any;
+    relation_products?: any[];
+    relation_type?: string;
+    relation_id?: number;
+    parent_id?: number | null;
+    item_type?: string;
+    product_uid?: string;
+    metadata?: Record<string, any> | null;
+    [key: string]: any;
+}
+export interface ISalesPayment {
+    order_payment_id?: number | null;
+    custom_payment_id?: number;
+    code?: string;
+    name?: string;
+    type?: string;
+    voucher_id?: number | null;
+    amount: string;
+    origin_amount?: string;
+    rounding_amount?: string;
+    status?: string;
+    payment_time?: string | null;
+    service_charge?: Record<string, any> | null;
+    metadata?: Record<string, any> | null;
+    [key: string]: any;
+}
+export interface ISalesSurcharge {
+    order_surcharge_id?: number | null;
+    surcharge_id?: number;
+    type?: string;
+    name?: Record<string, string>;
+    description?: Record<string, string>;
+    percentage?: string | null;
+    fixed?: string | null;
+    amount?: string;
+    [key: string]: any;
+}
+export interface ISalesDetail {
+    /** 顶部订单字段集合（不含 products / bookings / payments / surcharges 等大数组） */
+    header: ISalesDetailHeader;
+    /** 商品行快照（保留 tempOrder / 后端详情原字段） */
+    products: BaseSalesOrderProduct[];
+    /** 全部 bookings，按服务端原始顺序输出（含 root + child） */
+    bookings: ISalesBooking[];
+    /** root booking（parent_id === 0），多个时取首个，无则为 null */
+    rootBooking: ISalesBooking | null;
+    /** product_uid → bookings 反查表，便于商品行 ↔ booking 映射 */
+    bookingsByProductUid: Record<string, ISalesBooking[]>;
+    /** 支付列表 */
+    payments: ISalesPayment[];
+    /** 附加费 */
+    surcharges: ISalesSurcharge[];
+    /** 订单级折扣列表 */
+    discount_list: any[];
+    /** 客户信息（按 header 抽取，必要时透传 raw.customer） */
+    customer: ISalesDetailCustomer | null;
+    /** 服务端 summary（仅输出） */
+    summary: Record<string, any>;
+    /** 原始响应快照，方便 UI 兜底使用 */
+    raw: Record<string, any>;
+}
+/**
+ * 将 `/order/sales/{id}` 响应解析为 ISalesDetail。
+ *
+ * 注意：
+ * - 入参允许是 `{ data: OrderData }` 或直接 `OrderData`，自动识别。
+ * - products 保留原字段；字段补齐由 OrderModule hydrate 负责。
+ * - 不做远程请求；不修改入参；返回新对象。
+ */
+export declare function parseSalesResponse(input: Record<string, any> | null | undefined): ISalesDetail;

package/dist/solution/BaseSales/utils/parseSalesResponse.js

@@ -0,0 +1,159 @@
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+/**
+ * 把 `/order/sales/{id}` 响应（OrderData）解析为 ISalesDetail。
+ *
+ * - 纯函数：不依赖任何运行时模块/插件，便于单测与 view-model 适配
+ * - products 保留 tempOrder / 后端详情原字段，仅做浅拷贝，避免丢失 product_sku 等协议字段
+ * - bookings 平铺保留服务端原顺序，同时输出 byProductUid 反查表与 rootBooking
+ * - header 收敛"非数组顶层字段"，便于 ticketBooking view-model 直接消费
+ *
+ * 设计原则参考 `.cursor/rules/data-field-semantics.mdc`：
+ * - 字段命名以《统一 Sales 数据协议》为准（OrderData 类型）
+ * - root booking 以 `parent_id === 0` 判定，沿用 ticketBooking 现有约定
+ *   （`packages/private-materials/src/components/ticketBooking/index.tsx`：
+ *    `booking.parent_id === 0 ? 'list' : 'detail'`）
+ * - 不在此处发明等价关系；UI 侧（ticketBooking）若需要别的字段，由 view-model 适配层做转换
+ */
+
+/** OrderData 中除大数组外的"顶层 header 字段"白名单，按需扩展。 */
+var HEADER_KEYS = ['order_id', 'order_number', 'shop_order_number', 'shop_full_order_number', 'type', 'business_code', 'platform', 'sales_channel', 'order_sales_channel', 'status', 'payment_status', 'shipping_status', 'customer_id', 'customer_name', 'country_calling_code', 'phone', 'email', 'is_price_include_tax', 'tax_title', 'tax_country_code', 'currency_code', 'currency_symbol', 'currency_format', 'is_deposit', 'deposit_amount', 'shop_discount', 'surcharge_fee', 'note', 'schedule_date', 'created_at', 'updated_at', 'metadata', 'total_amount', 'shop_id', 'create_date', 'holder', 'relation_forms', 'contacts', 'contacts_info'];
+function pickHeader(raw) {
+  var _raw$order_id;
+  var header = {
+    order_id: (_raw$order_id = raw === null || raw === void 0 ? void 0 : raw.order_id) !== null && _raw$order_id !== void 0 ? _raw$order_id : null
+  };
+  if (!raw || _typeof(raw) !== 'object') return header;
+  var _iterator = _createForOfIteratorHelper(HEADER_KEYS),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var _key = _step.value;
+      if (raw[_key] !== undefined) header[_key] = raw[_key];
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return header;
+}
+function pickCustomer(raw) {
+  var _raw$customer_id, _raw$customer_name;
+  if (!raw || _typeof(raw) !== 'object') return null;
+  var explicit = raw.customer;
+  if (explicit && _typeof(explicit) === 'object') {
+    var _ref, _explicit$id, _ref2, _explicit$name, _explicit$phone, _explicit$email, _explicit$country_cal;
+    return _objectSpread({
+      id: (_ref = (_explicit$id = explicit.id) !== null && _explicit$id !== void 0 ? _explicit$id : raw.customer_id) !== null && _ref !== void 0 ? _ref : null,
+      name: (_ref2 = (_explicit$name = explicit.name) !== null && _explicit$name !== void 0 ? _explicit$name : raw.customer_name) !== null && _ref2 !== void 0 ? _ref2 : '',
+      phone: (_explicit$phone = explicit.phone) !== null && _explicit$phone !== void 0 ? _explicit$phone : raw.phone,
+      email: (_explicit$email = explicit.email) !== null && _explicit$email !== void 0 ? _explicit$email : raw.email,
+      country_calling_code: (_explicit$country_cal = explicit.country_calling_code) !== null && _explicit$country_cal !== void 0 ? _explicit$country_cal : raw.country_calling_code
+    }, explicit);
+  }
+  if (raw.customer_id == null && !raw.customer_name) return null;
+  return {
+    id: (_raw$customer_id = raw.customer_id) !== null && _raw$customer_id !== void 0 ? _raw$customer_id : null,
+    name: (_raw$customer_name = raw.customer_name) !== null && _raw$customer_name !== void 0 ? _raw$customer_name : '',
+    phone: raw.phone,
+    email: raw.email,
+    country_calling_code: raw.country_calling_code
+  };
+}
+
+/**
+ * 判定根 booking。沿用 ticketBooking 现有约定：
+ *   `parent_id === 0` 视为根；其余为子（item_type === 'recurring_booking' 也按 parent_id 判定）。
+ *   见 `packages/private-materials/src/components/ticketBooking/index.tsx`：
+ *   `type: booking.parent_id === 0 ? 'list' : 'detail'`。
+ */
+function isRootBooking(booking) {
+  if (!booking || _typeof(booking) !== 'object') return false;
+  var parentId = booking.parent_id;
+  if (parentId === 0 || parentId === null || parentId === undefined) return true;
+  return false;
+}
+function indexBookingsByProductUid(bookings) {
+  var result = {};
+  var _iterator2 = _createForOfIteratorHelper(bookings),
+    _step2;
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var _b$metadata;
+      var b = _step2.value;
+      var uid = b && (b.product_uid || ((_b$metadata = b.metadata) === null || _b$metadata === void 0 ? void 0 : _b$metadata.product_uid)) || '';
+      if (!uid) continue;
+      var _key2 = String(uid);
+      if (!result[_key2]) result[_key2] = [];
+      result[_key2].push(b);
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  return result;
+}
+
+/**
+ * 将 `/order/sales/{id}` 响应解析为 ISalesDetail。
+ *
+ * 注意：
+ * - 入参允许是 `{ data: OrderData }` 或直接 `OrderData`，自动识别。
+ * - products 保留原字段；字段补齐由 OrderModule hydrate 负责。
+ * - 不做远程请求；不修改入参；返回新对象。
+ */
+export function parseSalesResponse(input) {
+  var raw = input && _typeof(input) === 'object' && input.data && input.order_id == null ? input.data : input || {};
+  var productsRaw = Array.isArray(raw === null || raw === void 0 ? void 0 : raw.products) ? raw.products : [];
+  var products = productsRaw.map(function (p, index) {
+    var row = _objectSpread({}, p || {});
+    var metadata = row.metadata && _typeof(row.metadata) === 'object' ? _objectSpread({}, row.metadata) : {};
+    if (!metadata.unique_identification_number) {
+      var _row$product_id, _row$product_variant_;
+      metadata.unique_identification_number = "sales-product-".concat((_row$product_id = row.product_id) !== null && _row$product_id !== void 0 ? _row$product_id : 'unknown', "-").concat((_row$product_variant_ = row.product_variant_id) !== null && _row$product_variant_ !== void 0 ? _row$product_variant_ : 0, "-").concat(index);
+    }
+    delete metadata.price_schema_version;
+    delete row.identity_key;
+    return _objectSpread(_objectSpread({}, row), {}, {
+      metadata: metadata
+    });
+  });
+  var bookingsRaw = Array.isArray(raw === null || raw === void 0 ? void 0 : raw.bookings) ? raw.bookings : [];
+  var bookings = bookingsRaw.map(function (b) {
+    return _objectSpread({}, b || {});
+  });
+  var rootBooking = bookings.find(isRootBooking) || null;
+  var bookingsByProductUid = indexBookingsByProductUid(bookings);
+  var payments = Array.isArray(raw === null || raw === void 0 ? void 0 : raw.payments) ? raw.payments.map(function (p) {
+    return _objectSpread({}, p || {});
+  }) : [];
+  var surcharges = Array.isArray(raw === null || raw === void 0 ? void 0 : raw.surcharges) ? raw.surcharges.map(function (s) {
+    return _objectSpread({}, s || {});
+  }) : [];
+  var discount_list = Array.isArray(raw === null || raw === void 0 ? void 0 : raw.discount_list) ? raw.discount_list.map(function (d) {
+    return _objectSpread({}, d || {});
+  }) : [];
+  var summary = raw !== null && raw !== void 0 && raw.summary && _typeof(raw.summary) === 'object' ? _objectSpread({}, raw.summary) : {};
+  return {
+    header: pickHeader(raw),
+    products: products,
+    bookings: bookings,
+    rootBooking: rootBooking,
+    bookingsByProductUid: bookingsByProductUid,
+    payments: payments,
+    surcharges: surcharges,
+    discount_list: discount_list,
+    customer: pickCustomer(raw),
+    summary: summary,
+    raw: raw
+  };
+}