@pisell/pisellos 0.0.567 → 0.0.569

package/lib/solution/BookingTicket/utils/cartView.d.ts

@@ -0,0 +1,29 @@
+import type { BaseSalesOrderProduct } from '../../BaseSales';
+import type { ISalesBooking } from '../../BaseSales/utils/parseSalesResponse';
+import type { BookingTicketCartView, BookingTicketCustomerView, ICustomer } from '../types';
+import type { ScanOrderTempOrder } from '../../ScanOrder/types';
+export interface BuildCartViewOptions {
+    addTimeProducts?: any[];
+    bookingConfig?: Record<string, any> | null;
+    productsByUid?: Record<string, {
+        origin?: Record<string, any>;
+    }>;
+    shopOpeningHours?: string;
+}
+/**
+ * 仅按 booking.product_uid 建索引，避免发明 booking 与商品行之间的其它等价关系。
+ */
+export declare function indexBookingsByProductUid(bookings: ISalesBooking[] | undefined | null): Record<string, ISalesBooking[]>;
+/**
+ * 构建购物车 UI 视图：bookings 平铺附带关联商品；items 仅含未关联 booking 的商品行。
+ *
+ * 商品行直接透传 tempOrder.products，不做 enrichment。
+ * 关联规则（1:1）：booking.product_uid ↔ line.metadata.unique_identification_number；
+ * 同一 uid 已被更早的 booking 占用时，后续 booking 的 product 为 null。
+ */
+export declare function buildCartView(lines: BaseSalesOrderProduct[] | undefined | null, bookings: ISalesBooking[] | undefined | null, options?: BuildCartViewOptions): BookingTicketCartView;
+export declare function isWalkInCustomer(customer: Pick<ICustomer, 'id'> | null | undefined): boolean;
+/**
+ * selected 优先，缺失时回退 tempOrder.customer_*，统一输出 UI 客户视图。
+ */
+export declare function buildCustomerView(selected: ICustomer | null | undefined, tempOrder: ScanOrderTempOrder | null | undefined): BookingTicketCustomerView | null;

package/lib/solution/BookingTicket/utils/cartView.js

@@ -0,0 +1,200 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildCartView = buildCartView;
+exports.buildCustomerView = buildCustomerView;
+exports.indexBookingsByProductUid = indexBookingsByProductUid;
+exports.isWalkInCustomer = isWalkInCustomer;
+var _addTimeAvailability = require("./addTimeAvailability");
+/**
+ * 仅按 booking.product_uid 建索引，避免发明 booking 与商品行之间的其它等价关系。
+ */
+function indexBookingsByProductUid(bookings) {
+  if (!Array.isArray(bookings) || bookings.length === 0) return {};
+  return bookings.reduce((acc, booking) => {
+    const uid = booking?.product_uid;
+    if (uid === undefined || uid === null || uid === '') return acc;
+    const key = String(uid);
+    if (!acc[key]) acc[key] = [];
+    acc[key].push(booking);
+    return acc;
+  }, {});
+}
+
+/**
+ * 商品行按 unique_identification_number 建 1:1 索引（同 uid 多行时保留首行）。
+ */
+function indexProductsByUid(lines) {
+  return lines.reduce((acc, line) => {
+    const uid = line.metadata?.unique_identification_number;
+    if (uid === undefined || uid === null || uid === '') return acc;
+    const key = String(uid);
+    if (!acc[key]) acc[key] = line;
+    return acc;
+  }, {});
+}
+
+/**
+ * 读取 booking 的协议唯一值。
+ *
+ * @example
+ * const uid = getBookingUid(booking);
+ */
+function getBookingUid(booking) {
+  const uid = booking?.metadata?.unique_identification_number;
+  return uid === undefined || uid === null ? '' : String(uid);
+}
+
+/**
+ * 读取商品行绑定的 booking 唯一值。
+ *
+ * @example
+ * const bookingUid = getProductBookingUid(product);
+ */
+function getProductBookingUid(line) {
+  const uid = line?.booking_uid ?? line?.metadata?.booking_uid;
+  return uid === undefined || uid === null ? '' : String(uid);
+}
+
+/**
+ * 判断商品行是否为加时商品行。
+ *
+ * @example
+ * isAddTimeProductLine({ metadata: { product_add_schedule_time: 30 } } as any);
+ */
+function isAddTimeProductLine(line) {
+  return line?.metadata?.product_add_schedule_time !== undefined && line?.metadata?.product_add_schedule_time !== null;
+}
+
+/**
+ * 将加时商品按 booking_uid 建索引。
+ *
+ * @example
+ * const map = indexAddTimeProductsByBookingUid(products);
+ */
+function indexAddTimeProductsByBookingUid(lines) {
+  return lines.reduce((acc, line) => {
+    if (!isAddTimeProductLine(line)) return acc;
+    const bookingUid = getProductBookingUid(line);
+    if (!bookingUid) return acc;
+    if (!acc[bookingUid]) acc[bookingUid] = [];
+    acc[bookingUid].push(line);
+    return acc;
+  }, {});
+}
+
+/**
+ * 判断商品行是否是促销赠品行。
+ *
+ * @example
+ * isGiftProductLine({ metadata: { _giftInfo: {} } } as any); // true
+ */
+function isGiftProductLine(line) {
+  return Boolean(line?.metadata?._giftInfo);
+}
+
+/**
+ * 构建购物车 UI 视图：bookings 平铺附带关联商品；items 仅含未关联 booking 的商品行。
+ *
+ * 商品行直接透传 tempOrder.products，不做 enrichment。
+ * 关联规则（1:1）：booking.product_uid ↔ line.metadata.unique_identification_number；
+ * 同一 uid 已被更早的 booking 占用时，后续 booking 的 product 为 null。
+ */
+function buildCartView(lines, bookings, options = {}) {
+  const productLines = Array.isArray(lines) ? lines : [];
+  const bookingList = Array.isArray(bookings) ? bookings : [];
+  const linesByUid = indexProductsByUid(productLines);
+  const addTimeLinesByBookingUid = indexAddTimeProductsByBookingUid(productLines);
+  const claimedUids = new Set();
+  const claimedAddTimeLines = new Set();
+  const cartBookings = bookingList.filter(booking => booking.parent_id !== 0).reduce((acc, booking) => {
+    const uid = booking?.product_uid;
+    const bookingUid = getBookingUid(booking);
+    let product = null;
+    if (uid !== undefined && uid !== null && uid !== '') {
+      const key = String(uid);
+      if (!claimedUids.has(key)) {
+        const line = linesByUid[key];
+        // 赠品预约只作为提交数据保留，不在购物车顶部预约卡片区展示。
+        if (isGiftProductLine(line)) return acc;
+        if (line) {
+          claimedUids.add(key);
+          product = line;
+        }
+      }
+    }
+    const addTimeProduct = bookingUid ? addTimeLinesByBookingUid[bookingUid] || [] : [];
+    addTimeProduct.forEach(line => claimedAddTimeLines.add(line));
+    acc.push({
+      ...booking,
+      _extend: {
+        product,
+        addTimeProduct,
+        canAddTime: (0, _addTimeAvailability.resolveBookingCanAddTime)({
+          booking,
+          product,
+          addTimeProducts: options.addTimeProducts,
+          bookingConfig: options.bookingConfig,
+          productsByUid: options.productsByUid,
+          shopOpeningHours: options.shopOpeningHours
+        })
+      }
+    });
+    return acc;
+  }, []);
+  const items = productLines.filter(line => {
+    // 促销赠品行仅通过主商品 Gift 行展示，不在 items 单独占一行（对齐 legacy `isGift: !!_giftInfo`）
+    if (isGiftProductLine(line)) return false;
+    if (claimedAddTimeLines.has(line)) return false;
+    const uid = line.metadata?.unique_identification_number;
+    if (uid === undefined || uid === null || uid === '') return true;
+    return !claimedUids.has(String(uid));
+  });
+  return {
+    bookings: cartBookings,
+    items
+  };
+}
+function isWalkInCustomer(customer) {
+  if (!customer) return true;
+  const id = customer.id;
+  if (id === undefined || id === null) return true;
+  if (typeof id === 'string') {
+    return ['', '0', '1'].includes(id);
+  }
+  return [0, 1].includes(id);
+}
+
+/**
+ * selected 优先，缺失时回退 tempOrder.customer_*，统一输出 UI 客户视图。
+ */
+function buildCustomerView(selected, tempOrder) {
+  if (selected && selected.id !== undefined && selected.id !== null && selected.id !== '' && selected.id !== 0) {
+    return {
+      id: selected.id,
+      name: selected.name ?? '',
+      phone: selected.phone,
+      email: selected.email,
+      country_calling_code: selected.country_calling_code,
+      cover: selected.cover,
+      isWalkIn: isWalkInCustomer(selected)
+    };
+  }
+  if (tempOrder && (tempOrder.customer_id != null || tempOrder.customer_name)) {
+    const id = tempOrder.customer_id ?? '';
+    return {
+      id,
+      name: tempOrder.customer_name ?? '',
+      phone: tempOrder.phone,
+      email: tempOrder.email,
+      country_calling_code: tempOrder.country_calling_code,
+      cover: undefined,
+      isWalkIn: isWalkInCustomer({
+        id
+      })
+    };
+  }
+  return null;
+}

package/lib/solution/BookingTicket/utils/exampleData.d.ts

@@ -0,0 +1,123 @@
+declare let data: ({
+    id: number;
+    title: string;
+    price: number;
+    minMinutes: number;
+    maxMinutes: number;
+    unitMinutes: number;
+    unlimited: boolean;
+    _originalProduct: {
+        id: number;
+        extension_id: number;
+        extension_type: string;
+        shop_id: number;
+        title: string;
+        slug: string;
+        status: string;
+        stock_quantity: number;
+        sales_quantity: number;
+        sum_stock: number;
+        price: string;
+        original_price: string;
+        cost_price: string;
+        cover: string;
+        channel_application: string[];
+        is_track: number;
+        over_sold: number;
+        is_gst: number;
+        code: string;
+        barcode: string;
+        is_delivery: number;
+        weight_unit: string;
+        weight_value: string;
+        type: string;
+        unit: string;
+        sort: number;
+        subtitle: string;
+        minimum_markup_price: string;
+        is_bundle: number;
+        description: string;
+        open_sold_weight: number;
+        unit_value: number;
+        is_variant: number;
+        variant_count: number;
+        add_time: {
+            unit_duration: number;
+            min_add_time: number;
+            max_add_time: number;
+            calculate_type: string;
+            relation_product: {
+                type: string;
+                products: never[];
+            };
+            additional_time_options?: undefined;
+        };
+        shelf_product_datas: never[];
+        step_value: number;
+        min_num_unit: number;
+        is_charge_tax: number;
+        base_price: string;
+        variant: never[];
+    };
+} | {
+    id: number;
+    title: string;
+    price: number;
+    minMinutes: number;
+    maxMinutes: number;
+    unitMinutes: number;
+    unlimited: boolean;
+    _originalProduct: {
+        id: number;
+        extension_id: number;
+        extension_type: string;
+        shop_id: number;
+        title: string;
+        slug: string;
+        status: string;
+        stock_quantity: number;
+        sales_quantity: number;
+        sum_stock: number;
+        price: string;
+        original_price: string;
+        cost_price: string;
+        cover: string;
+        channel_application: string[];
+        is_track: number;
+        over_sold: number;
+        is_gst: number;
+        code: string;
+        barcode: string;
+        is_delivery: number;
+        weight_unit: string;
+        weight_value: string;
+        type: string;
+        unit: string;
+        sort: number;
+        subtitle: string;
+        minimum_markup_price: string;
+        is_bundle: number;
+        description: string;
+        open_sold_weight: number;
+        unit_value: number;
+        is_variant: number;
+        variant_count: number;
+        add_time: {
+            additional_time_options: string;
+            unit_duration: number;
+            min_add_time: number;
+            max_add_time: number;
+            calculate_type: string;
+            relation_product: {
+                type: string;
+                products: never[];
+            };
+        };
+        shelf_product_datas: never[];
+        step_value: number;
+        min_num_unit: number;
+        is_charge_tax: number;
+        base_price: string;
+        variant: never[];
+    };
+})[];

package/lib/solution/BookingTicket/utils/exampleData.js

@@ -0,0 +1,185 @@
+"use strict";
+
+let data = [{
+  "id": 58299,
+  "title": "玄-加时商品-与数量无关-不指定商品",
+  "price": 1,
+  "minMinutes": 30,
+  "maxMinutes": 30,
+  "unitMinutes": 30,
+  "unlimited": false,
+  "_originalProduct": {
+    "id": 58299,
+    "extension_id": 384,
+    "extension_type": "product_add_time",
+    "shop_id": 9,
+    "title": "玄-加时商品-与数量无关-不指定商品",
+    "slug": "玄-加时商品-与数量无关-指定商品",
+    "status": "published",
+    "stock_quantity": -119,
+    "sales_quantity": 113,
+    "sum_stock": -119,
+    "price": "1.00",
+    "original_price": "4.00",
+    "cost_price": "0.00",
+    "cover": "",
+    "channel_application": ["online-store", "pos", "bbc-module:mebook"],
+    "is_track": 0,
+    "over_sold": 0,
+    "is_gst": 1,
+    "code": "",
+    "barcode": "",
+    "is_delivery": 0,
+    "weight_unit": "KILOGRAMS",
+    "weight_value": "0.00",
+    "type": "physical",
+    "unit": "",
+    "sort": 9999999,
+    "subtitle": "",
+    "minimum_markup_price": "0.00",
+    "is_bundle": 0,
+    "description": "",
+    "open_sold_weight": 0,
+    "unit_value": 0,
+    "is_variant": 0,
+    "variant_count": 0,
+    "add_time": {
+      "unit_duration": 30,
+      "min_add_time": 30,
+      "max_add_time": 30,
+      "calculate_type": "not_related_to_quantity",
+      "relation_product": {
+        "type": "product_all",
+        "products": []
+      }
+    },
+    "shelf_product_datas": [],
+    "step_value": 1,
+    "min_num_unit": 1,
+    "is_charge_tax": 1,
+    "base_price": "1.00",
+    "variant": []
+  }
+}, {
+  "id": 58279,
+  "title": "加时商品2",
+  "price": 10,
+  "minMinutes": 30,
+  "maxMinutes": 120,
+  "unitMinutes": 10,
+  "unlimited": false,
+  "_originalProduct": {
+    "id": 58279,
+    "extension_id": 384,
+    "extension_type": "product_add_time",
+    "shop_id": 9,
+    "title": "加时商品2",
+    "slug": "加时商品2",
+    "status": "published",
+    "stock_quantity": -275,
+    "sales_quantity": 261,
+    "sum_stock": -275,
+    "price": "10.00",
+    "original_price": "10.00",
+    "cost_price": "0.00",
+    "cover": "",
+    "channel_application": ["online-store", "pos", "bbc-module:mebook"],
+    "is_track": 0,
+    "over_sold": 0,
+    "is_gst": 1,
+    "code": "",
+    "barcode": "",
+    "is_delivery": 0,
+    "weight_unit": "KILOGRAMS",
+    "weight_value": "0.00",
+    "type": "physical",
+    "unit": "",
+    "sort": 9999999,
+    "subtitle": "",
+    "minimum_markup_price": "0.00",
+    "is_bundle": 0,
+    "description": "",
+    "open_sold_weight": 0,
+    "unit_value": 0,
+    "is_variant": 0,
+    "variant_count": 0,
+    "add_time": {
+      "additional_time_options": "explicit_durations",
+      "unit_duration": 10,
+      "min_add_time": 30,
+      "max_add_time": 120,
+      "calculate_type": "not_related_to_quantity",
+      "relation_product": {
+        "type": "product_all",
+        "products": []
+      }
+    },
+    "shelf_product_datas": [],
+    "step_value": 1,
+    "min_num_unit": 1,
+    "is_charge_tax": 1,
+    "base_price": "10.00",
+    "variant": []
+  }
+}, {
+  "id": 58277,
+  "title": "测试加时商品",
+  "price": 2,
+  "minMinutes": 30,
+  "maxMinutes": 780,
+  "unitMinutes": 30,
+  "unlimited": true,
+  "_originalProduct": {
+    "id": 58277,
+    "extension_id": 384,
+    "extension_type": "product_add_time",
+    "shop_id": 9,
+    "title": "测试加时商品",
+    "slug": "测试加时商品",
+    "status": "published",
+    "stock_quantity": -7,
+    "sales_quantity": 8,
+    "sum_stock": -7,
+    "price": "2.00",
+    "original_price": "0.00",
+    "cost_price": "0.00",
+    "cover": "",
+    "channel_application": ["online-store", "pos", "bbc-module:mebook"],
+    "is_track": 0,
+    "over_sold": 0,
+    "is_gst": 1,
+    "code": "",
+    "barcode": "",
+    "is_delivery": 0,
+    "weight_unit": "KILOGRAMS",
+    "weight_value": "0.00",
+    "type": "physical",
+    "unit": "",
+    "sort": 9999999,
+    "subtitle": "",
+    "minimum_markup_price": "0.00",
+    "is_bundle": 0,
+    "description": "",
+    "open_sold_weight": 0,
+    "unit_value": 0,
+    "is_variant": 0,
+    "variant_count": 0,
+    "add_time": {
+      "additional_time_options": "unlimited",
+      "unit_duration": 30,
+      "min_add_time": 30,
+      "max_add_time": 780,
+      "calculate_type": "select_quantity",
+      "relation_product": {
+        "type": "product_all",
+        "products": []
+      }
+    },
+    "shelf_product_datas": [],
+    "step_value": 1,
+    "min_num_unit": 1,
+    "is_charge_tax": 1,
+    "base_price": "2.00",
+    "variant": []
+  }
+}];

package/lib/solution/BookingTicket/utils/orderCustomer.d.ts

@@ -0,0 +1,4 @@
+import type { ICustomer } from '../types';
+import type { OrderCustomerPatch } from '../../../modules/Order/types';
+/** 将 ICustomer 格式化为写入 tempOrder 的协议字段。 */
+export declare function formatOrderCustomerPatch(customer: ICustomer): OrderCustomerPatch;

package/lib/solution/BookingTicket/utils/orderCustomer.js

@@ -0,0 +1,35 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.formatOrderCustomerPatch = formatOrderCustomerPatch;
+/** 从 ICustomer 富字段解析展示名（与 SalesSdk getClientName 语义对齐）。 */
+function resolveCustomerDisplayName(customer) {
+  const c = customer;
+  const displayName = c.display_name;
+  if (typeof displayName === 'string' && displayName) return displayName;
+  const nickname = c.nickname;
+  if (typeof nickname === 'string' && nickname) return nickname;
+  const firstName = c.first_name;
+  const lastName = c.last_name;
+  if (typeof firstName === 'string' && firstName || typeof lastName === 'string' && lastName) {
+    return `${typeof firstName === 'string' ? firstName : ''} ${typeof lastName === 'string' ? lastName : ''}`.trim();
+  }
+  const customerName = c.customer_name;
+  if (typeof customerName === 'string' && customerName) return customerName;
+  return customer.name ?? '';
+}
+
+/** 将 ICustomer 格式化为写入 tempOrder 的协议字段。 */
+function formatOrderCustomerPatch(customer) {
+  const rawId = customer.id;
+  const numericId = typeof rawId === 'number' ? rawId : rawId !== undefined && rawId !== null && rawId !== '' ? Number(rawId) : null;
+  return {
+    customer_id: Number.isFinite(numericId) ? numericId : null,
+    customer_name: resolveCustomerDisplayName(customer),
+    phone: customer.phone ?? '',
+    email: customer.email ?? '',
+    country_calling_code: customer.country_calling_code?.toString() ?? ''
+  };
+}