@pisell/pisellos 2.2.147 → 2.2.149

package/lib/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/lib/solution/BaseSales/types.js

@@ -0,0 +1,40 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/solution/BaseSales/types.ts
+var types_exports = {};
+__export(types_exports, {
+  BaseSalesHookNames: () => BaseSalesHookNames,
+  createBaseSalesHook: () => createBaseSalesHook
+});
+module.exports = __toCommonJS(types_exports);
+var BaseSalesHookNames = {
+  onInited: "onInited",
+  onDestroy: "onDestroy",
+  onRetryInit: "onRetryInit",
+  onRefresh: "onRefresh",
+  onCartValidationChanged: "onCartValidationChanged"
+};
+function createBaseSalesHook(moduleName, hookName) {
+  return `${moduleName}:${hookName}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseSalesHookNames,
+  createBaseSalesHook
+});

package/lib/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/lib/solution/BaseSales/utils/parseSalesResponse.js

@@ -0,0 +1,160 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/solution/BaseSales/utils/parseSalesResponse.ts
+var parseSalesResponse_exports = {};
+__export(parseSalesResponse_exports, {
+  parseSalesResponse: () => parseSalesResponse
+});
+module.exports = __toCommonJS(parseSalesResponse_exports);
+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) {
+  const header = { order_id: (raw == null ? void 0 : raw.order_id) ?? null };
+  if (!raw || typeof raw !== "object")
+    return header;
+  for (const key of HEADER_KEYS) {
+    if (raw[key] !== void 0)
+      header[key] = raw[key];
+  }
+  return header;
+}
+function pickCustomer(raw) {
+  if (!raw || typeof raw !== "object")
+    return null;
+  const explicit = raw.customer;
+  if (explicit && typeof explicit === "object") {
+    return {
+      id: explicit.id ?? raw.customer_id ?? null,
+      name: explicit.name ?? raw.customer_name ?? "",
+      phone: explicit.phone ?? raw.phone,
+      email: explicit.email ?? raw.email,
+      country_calling_code: explicit.country_calling_code ?? raw.country_calling_code,
+      ...explicit
+    };
+  }
+  if (raw.customer_id == null && !raw.customer_name)
+    return null;
+  return {
+    id: raw.customer_id ?? null,
+    name: raw.customer_name ?? "",
+    phone: raw.phone,
+    email: raw.email,
+    country_calling_code: raw.country_calling_code
+  };
+}
+function isRootBooking(booking) {
+  if (!booking || typeof booking !== "object")
+    return false;
+  const parentId = booking.parent_id;
+  if (parentId === 0 || parentId === null || parentId === void 0)
+    return true;
+  return false;
+}
+function indexBookingsByProductUid(bookings) {
+  var _a;
+  const result = {};
+  for (const b of bookings) {
+    const uid = b && (b.product_uid || ((_a = b.metadata) == null ? void 0 : _a.product_uid)) || "";
+    if (!uid)
+      continue;
+    const key = String(uid);
+    if (!result[key])
+      result[key] = [];
+    result[key].push(b);
+  }
+  return result;
+}
+function parseSalesResponse(input) {
+  const raw = input && typeof input === "object" && input.data && input.order_id == null ? input.data : input || {};
+  const productsRaw = Array.isArray(raw == null ? void 0 : raw.products) ? raw.products : [];
+  const products = productsRaw.map((p, index) => {
+    const row = { ...p || {} };
+    const metadata = row.metadata && typeof row.metadata === "object" ? { ...row.metadata } : {};
+    if (!metadata.unique_identification_number) {
+      metadata.unique_identification_number = `sales-product-${row.product_id ?? "unknown"}-${row.product_variant_id ?? 0}-${index}`;
+    }
+    delete metadata.price_schema_version;
+    delete row.identity_key;
+    return { ...row, metadata };
+  });
+  const bookingsRaw = Array.isArray(raw == null ? void 0 : raw.bookings) ? raw.bookings : [];
+  const bookings = bookingsRaw.map((b) => ({ ...b || {} }));
+  const rootBooking = bookings.find(isRootBooking) || null;
+  const bookingsByProductUid = indexBookingsByProductUid(bookings);
+  const payments = Array.isArray(raw == null ? void 0 : raw.payments) ? raw.payments.map((p) => ({ ...p || {} })) : [];
+  const surcharges = Array.isArray(raw == null ? void 0 : raw.surcharges) ? raw.surcharges.map((s) => ({ ...s || {} })) : [];
+  const discount_list = Array.isArray(raw == null ? void 0 : raw.discount_list) ? raw.discount_list.map((d) => ({ ...d || {} })) : [];
+  const summary = (raw == null ? void 0 : raw.summary) && typeof raw.summary === "object" ? { ...raw.summary } : {};
+  return {
+    header: pickHeader(raw),
+    products,
+    bookings,
+    rootBooking,
+    bookingsByProductUid,
+    payments,
+    surcharges,
+    discount_list,
+    customer: pickCustomer(raw),
+    summary,
+    raw
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  parseSalesResponse
+});

package/lib/solution/BaseSales/utils.d.ts

@@ -0,0 +1,40 @@
+import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesSummary } from './types';
+/**
+ * 构建金额全为 0 的空 summary。
+ * 作为尚未计算金额时的兜底默认值，避免下游因 undefined 报错。
+ */
+export declare function createEmptySummary(): BaseSalesSummary;
+/**
+ * 将选项行 / 套餐行归一成稳定 JSON，用于「同 SKU 是否合并」判断。
+ * 数组元素先按主键排序再序列化，避免顺序差异导致误判为不同行。
+ */
+export declare function buildProductLineFingerprint(productOptionItem?: unknown, productBundle?: unknown): string;
+export declare function getSafeProductNum(num?: number): number;
+/**
+ * removeProductFromOrder 仅传 SKU 时的通配 identity（对象上未声明选项键）。
+ * 与显式 `product_option_item: []` 区分：后者只匹配「无选项」行。
+ */
+export declare function isSkuOnlyDeleteIdentity(x: BaseSalesOrderProductIdentity): boolean;
+/**
+ * 对外部传入的商品对象做归一化（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<BaseSalesOrderProduct> & BaseSalesOrderProductIdentity): BaseSalesOrderProduct;