@pisell/pisellos 0.0.568 → 0.10.1

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

@@ -0,0 +1,144 @@
+/**
+ * 把 `/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;
+    vouchers?: any[];
+    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/bookings/payments 在此补齐集合身份；其余 runtime 字段由 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 import_orderCollectionIdentity = require("../../../modules/Order/utils/orderCollectionIdentity");
+var HEADER_KEYS = [
+  "order_id",
+  "order_number",
+  "shop_order_number",
+  "shop_full_order_number",
+  "type",
+  "business_code",
+  "platform",
+  "sales_channel",
+  "order_sales_channel",
+  "vouchers",
+  "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 sourceRaw = input && typeof input === "object" && input.data && input.order_id == null ? input.data : input || {};
+  const raw = (0, import_orderCollectionIdentity.normalizeOrderCollections)(sourceRaw).order;
+  const productsRaw = Array.isArray(raw == null ? void 0 : raw.products) ? raw.products : [];
+  const products = productsRaw.map((p) => {
+    const row = { ...p || {} };
+    const metadata = row.metadata && typeof row.metadata === "object" ? { ...row.metadata } : {};
+    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/quotationPrice.d.ts

@@ -0,0 +1,18 @@
+import type { QuotationModule } from '../../../modules/Quotation';
+import type { BaseSalesCalculateProductBookingPriceParams, BaseSalesProductBookingPriceResult } from '../types';
+interface BuildBaseSalesQuotationPriceParams extends BaseSalesCalculateProductBookingPriceParams {
+    quotation?: (Pick<QuotationModule, 'getPriceForProduct' | 'getQuotationShelfId'> & {
+        getQuotationMatchForProduct?: (params: {
+            productId: number;
+            variantId?: number;
+            datetime: string;
+            channel?: string;
+            customer_id?: number | string;
+        }) => {
+            price: string | null;
+            quotationShelfId: number;
+        } | null;
+    }) | null;
+}
+export declare function calculateBaseSalesProductBookingPrice(params: BuildBaseSalesQuotationPriceParams): BaseSalesProductBookingPriceResult;
+export {};

package/lib/solution/BaseSales/utils/quotationPrice.js

@@ -0,0 +1,289 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/solution/BaseSales/utils/quotationPrice.ts
+var quotationPrice_exports = {};
+__export(quotationPrice_exports, {
+  calculateBaseSalesProductBookingPrice: () => calculateBaseSalesProductBookingPrice
+});
+module.exports = __toCommonJS(quotationPrice_exports);
+var import_dayjs = __toESM(require("dayjs"));
+var import_decimal = __toESM(require("decimal.js"));
+function toFiniteNumber(value, fallback = 0) {
+  const parsedValue = Number(value);
+  if (!Number.isFinite(parsedValue))
+    return fallback;
+  return parsedValue;
+}
+function toPositiveInt(value, fallback = 1) {
+  const parsedValue = Math.floor(Number(value));
+  if (!Number.isFinite(parsedValue) || parsedValue < 1)
+    return fallback;
+  return parsedValue;
+}
+function toPriceString(value) {
+  return new import_decimal.default(Number(value) || 0).toDecimalPlaces(2).toFixed(2);
+}
+function normalizeDateTime(value) {
+  if (typeof value !== "string" || !value.trim())
+    return null;
+  const normalized = value.includes(":") ? value : `${value} 00:00:00`;
+  const datetime = (0, import_dayjs.default)(normalized);
+  if (!datetime.isValid())
+    return null;
+  return datetime;
+}
+function buildBookingDateTime(date, time) {
+  if (typeof date !== "string" || !date.trim())
+    return null;
+  const timeText = typeof time === "string" && time.trim() ? time.trim() : "00:00";
+  const datetime = (0, import_dayjs.default)(`${date.trim()} ${timeText}`);
+  if (!datetime.isValid())
+    return null;
+  return datetime;
+}
+function getDurationUnit(type) {
+  const normalizedType = String(type || "").toLowerCase();
+  if (normalizedType === "day" || normalizedType === "days")
+    return "day";
+  if (normalizedType === "minute" || normalizedType === "minutes")
+    return "minute";
+  return null;
+}
+function getProductId(product) {
+  const productId = toFiniteNumber(product.product_id ?? product.id, NaN);
+  if (!Number.isFinite(productId))
+    return null;
+  return productId;
+}
+function getProductVariantId(product) {
+  const variantId = toFiniteNumber(
+    product.product_variant_id ?? product.variant_id,
+    0
+  );
+  if (!Number.isFinite(variantId) || variantId <= 0)
+    return void 0;
+  return variantId;
+}
+function getFallbackPrice(params) {
+  const product = params.product || {};
+  return toPriceString(
+    params.fallback_price ?? product.price ?? product.selling_price ?? product.original_price ?? 0
+  );
+}
+function getProductQuantity(product) {
+  return toPositiveInt(product.num ?? product.quantity, 1);
+}
+function getBundleProductId(bundle) {
+  const productId = toFiniteNumber(
+    bundle.bundle_product_id ?? bundle._bundle_product_id,
+    NaN
+  );
+  if (!Number.isFinite(productId))
+    return null;
+  return productId;
+}
+function getBundleVariantId(bundle) {
+  const variantId = toFiniteNumber(
+    bundle.bundle_variant_id ?? bundle.variant_id,
+    0
+  );
+  if (!Number.isFinite(variantId) || variantId <= 0)
+    return void 0;
+  return variantId;
+}
+function getBundleFallbackPrice(bundle) {
+  return toPriceString(
+    bundle.bundle_selling_price ?? bundle.price ?? bundle.original_price ?? bundle.base_price ?? 0
+  );
+}
+function shouldSplitByDuration(duration, start, end) {
+  if (!duration)
+    return false;
+  if (!start || !end || !end.isAfter(start))
+    return false;
+  const unit = getDurationUnit(duration.type);
+  const value = toFiniteNumber(duration.value);
+  return !!unit && value > 0;
+}
+function buildTimeSegments(params) {
+  const booking = params.booking || {};
+  const explicitDatetime = normalizeDateTime(params.datetime);
+  const bookingStart = buildBookingDateTime(booking.start_date, booking.start_time);
+  const start = bookingStart || explicitDatetime || (0, import_dayjs.default)();
+  const bookingEnd = buildBookingDateTime(booking.end_date, booking.end_time);
+  if (!shouldSplitByDuration(params.duration, start, bookingEnd)) {
+    return [{ start }];
+  }
+  const unit = getDurationUnit(params.duration.type);
+  const value = toFiniteNumber(params.duration.value);
+  const segments = [];
+  let cursor = start;
+  let guard = 0;
+  while (cursor.isBefore(bookingEnd) && guard < 1e4) {
+    const next = cursor.add(value, unit);
+    segments.push({
+      start: cursor,
+      end: next.isBefore(bookingEnd) ? next : bookingEnd ?? void 0
+    });
+    cursor = next;
+    guard += 1;
+  }
+  return segments.length ? segments : [{ start }];
+}
+function formatTimePoint(datetime) {
+  return datetime.format("YYYY-MM-DD HH:mm:ss");
+}
+function buildPriceSegment(params) {
+  const timePoint = formatTimePoint(params.segment.start);
+  const match = params.quotation && params.productId !== null && params.quotation.getQuotationMatchForProduct ? params.quotation.getQuotationMatchForProduct({
+    productId: params.productId,
+    variantId: params.variantId,
+    datetime: timePoint,
+    channel: params.channel,
+    customer_id: params.customerId
+  }) : null;
+  const quotedPrice = match ? match.price : params.quotation && params.productId !== null ? params.quotation.getPriceForProduct({
+    productId: params.productId,
+    variantId: params.variantId,
+    datetime: timePoint,
+    channel: params.channel,
+    customer_id: params.customerId
+  }) : null;
+  const unitPrice = toPriceString(quotedPrice ?? params.fallbackPrice);
+  const quotationShelfId = quotedPrice !== null ? (match == null ? void 0 : match.quotationShelfId) ?? (params.quotation && params.productId !== null ? params.quotation.getQuotationShelfId({
+    productId: params.productId,
+    variantId: params.variantId,
+    datetime: timePoint,
+    channel: params.channel,
+    customer_id: params.customerId
+  }) : 0) : 0;
+  return {
+    start_datetime: timePoint,
+    end_datetime: params.segment.end ? formatTimePoint(params.segment.end) : void 0,
+    time_point: timePoint,
+    unit_price: unitPrice,
+    quantity: 1,
+    total_price: unitPrice,
+    quotation_shelf_id: quotationShelfId,
+    source: quotedPrice !== null ? "quotation" : "fallback"
+  };
+}
+function calculatePriceForProduct(params) {
+  var _a;
+  const segments = params.segments.map((segment) => buildPriceSegment({
+    quotation: params.quotation,
+    productId: params.productId,
+    variantId: params.variantId,
+    customerId: params.customerId,
+    channel: params.channel,
+    fallbackPrice: params.fallbackPrice,
+    segment
+  }));
+  const unitPrice = segments.reduce(
+    (total, segment) => total.plus(segment.total_price),
+    new import_decimal.default(0)
+  );
+  const totalPrice = unitPrice.times(params.quantity);
+  const quotationShelfId = ((_a = segments.find((segment) => segment.quotation_shelf_id)) == null ? void 0 : _a.quotation_shelf_id) || 0;
+  return {
+    unitPrice,
+    totalPrice,
+    quotationShelfId,
+    segments
+  };
+}
+function calculateBundlePrices(params, segments) {
+  var _a;
+  const bundleList = ((_a = params.product) == null ? void 0 : _a.product_bundle) || [];
+  if (!bundleList.length)
+    return void 0;
+  return bundleList.map((bundle) => {
+    const productId = getBundleProductId(bundle);
+    const variantId = getBundleVariantId(bundle);
+    const quantity = getProductQuantity(bundle);
+    const price = calculatePriceForProduct({
+      quotation: params.quotation,
+      productId,
+      variantId,
+      customerId: params.customer_id,
+      channel: params.channel,
+      quantity,
+      fallbackPrice: getBundleFallbackPrice(bundle),
+      segments
+    });
+    return {
+      bundle_id: bundle.bundle_id ?? bundle.id,
+      group_id: bundle.group_id,
+      bundle_group_id: bundle.bundle_group_id,
+      bundle_product_id: productId,
+      bundle_variant_id: variantId ?? 0,
+      unit_price: price.unitPrice.toDecimalPlaces(2).toFixed(2),
+      total_price: price.totalPrice.toDecimalPlaces(2).toFixed(2),
+      quantity,
+      quotation_shelf_id: price.quotationShelfId,
+      source: price.segments.some((segment) => segment.source === "quotation") ? "quotation" : "fallback",
+      segments: price.segments
+    };
+  });
+}
+function calculateBaseSalesProductBookingPrice(params) {
+  const product = params.product || {};
+  const productId = getProductId(product);
+  const variantId = getProductVariantId(product);
+  const productQuantity = getProductQuantity(product);
+  const fallbackPrice = getFallbackPrice(params);
+  const timeSegments = buildTimeSegments(params);
+  const price = calculatePriceForProduct({
+    quotation: params.quotation,
+    productId,
+    variantId,
+    customerId: params.customer_id,
+    channel: params.channel,
+    quantity: productQuantity,
+    fallbackPrice,
+    segments: timeSegments
+  });
+  const bundlePrices = calculateBundlePrices(params, timeSegments);
+  return {
+    product_id: productId,
+    product_variant_id: variantId ?? 0,
+    customer_id: params.customer_id,
+    unit_price: price.unitPrice.toDecimalPlaces(2).toFixed(2),
+    total_price: price.totalPrice.toDecimalPlaces(2).toFixed(2),
+    quantity: productQuantity,
+    duration: params.duration,
+    quotation_shelf_id: price.quotationShelfId,
+    segments: price.segments,
+    ...bundlePrices ? { product_bundle: bundlePrices } : {}
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  calculateBaseSalesProductBookingPrice
+});

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

@@ -0,0 +1,63 @@
+import type { OrderProduct, OrderProductIdentity } from '../../../modules/Order/types';
+import type { ProductData } from '../../../modules/Product/types';
+export interface BaseProductDetailOptionItem {
+    option_group_item_id?: number | string;
+    option_group_id?: number | string;
+    num?: number | string;
+    quantity?: number | string;
+    price?: number | string;
+    add_price?: number | string;
+    [key: string]: any;
+}
+export interface BaseProductDetailBundleItem {
+    option?: BaseProductDetailOptionItem[];
+    [key: string]: any;
+}
+export interface BaseProductDetailPayload {
+    id?: number | string | null;
+    product_id?: number | string | null;
+    variant_id?: number | string | null;
+    product_variant_id?: number | string | null;
+    quantity?: number | string;
+    num?: number | string;
+    option?: BaseProductDetailOptionItem[];
+    options?: BaseProductDetailOptionItem[];
+    product_option_item?: BaseProductDetailOptionItem[];
+    product_sku?: Record<string, any>;
+    bundle?: BaseProductDetailBundleItem[];
+    product_bundle?: BaseProductDetailBundleItem[];
+    unique?: string;
+    unique_identification_number?: string;
+    session?: any;
+    form?: any;
+    service_times?: any;
+    machine_code?: string;
+    schedule_id?: number[];
+    duration?: number;
+    policy_id?: number;
+    source_shop_id?: number;
+    origin?: Record<string, any>;
+    _origin?: Record<string, any>;
+    price?: number | string;
+    selling_price?: number | string;
+    original_price?: number | string;
+    tax_fee?: number | string;
+    is_charge_tax?: number;
+    note?: string;
+    [key: string]: any;
+}
+export interface TransformBaseProductToOrderProductParams {
+    payload: BaseProductDetailPayload;
+    fallbackProductId?: number | string | null;
+    sourceProduct?: ProductData | Record<string, any> | null;
+    sourceItem?: ProductData | Record<string, any> | null;
+}
+export type BaseProductOrderProductInput = Partial<OrderProduct> & OrderProductIdentity & {
+    _origin?: Record<string, any>;
+};
+/**
+ * 将商品列表原始数据 + 商品详情选择回调转换成 OrderModule.addProductToOrder 入参。
+ *
+ * 注意：这里不生成 identity，缺省时由 OrderModule 自动补齐。
+ */
+export declare function transformBaseProductToOrderProduct(params: TransformBaseProductToOrderProductParams): BaseProductOrderProductInput | null;