@pisell/pisellos 2.1.119 → 2.1.121

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

@@ -0,0 +1,210 @@
+import { OrderModule, ProductList, SalesSummaryModule, ScanOrderLogInput, ScanOrderLoggerModule, ScanOrderLoggerProviderConfig, ScanOrderLoggerProviderType } from '../../modules';
+import type { QuantityCheckResult, QuantityLimitResult } from '../../model/strategy/adapter/itemRule';
+/**
+ * 扫码下单流程 hook
+ */
+export declare enum ScanOrderHooks {
+    onInited = "scanOrder:onInited",
+    onDestroy = "scanOrder:onDestroy",
+    onRetryInit = "scanOrder:onRetryInit",
+    onRefresh = "scanOrder:onRefresh",
+    onCartValidationChanged = "scanOrder:onCartValidationChanged"
+}
+export type ScanOrderStatus = 'idle' | 'initializing' | 'ready' | 'error';
+export type ScanOrderEntryContext = {
+    biz: string;
+    mode: 'scan' | 'append';
+    resourceId?: string;
+    sourceOrderId?: string;
+};
+export interface ScanOrderConfig {
+    orderSource: 'local' | 'remote';
+    scanTimeout: number;
+    allowAppend: boolean;
+    maxAppendCount: number;
+    features: {
+        autoMerge: boolean;
+        verifyResource: boolean;
+    };
+}
+export interface ScanOrderOrderProductIdentity {
+    product_id: number | null;
+    product_variant_id: number;
+    identity_key?: string;
+}
+export interface ScanOrderOrderProduct extends ScanOrderOrderProductIdentity {
+    order_detail_id: number | null;
+    num: number;
+    product_option_item: any[];
+    selling_price: string;
+    original_price: string;
+    payment_price: string;
+    tax_fee: string;
+    is_charge_tax: number;
+    discount_list: any[];
+    product_bundle: any[];
+    metadata: Record<string, any>;
+    _origin?: Record<string, any>;
+}
+export interface ScanOrderSubmitProduct extends Omit<ScanOrderOrderProduct, '_origin' | 'identity_key'> {
+}
+export interface ScanOrderSummary {
+    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;
+}
+/**
+ * ScanOrder 临时订单（runtime-clean 版本）
+ * 只保留运行时字段，不包含任何 __comment 字段
+ */
+export interface ScanOrderTempOrder {
+    order_id: number | null;
+    relation_id?: string;
+    table_form_id?: string;
+    resource_id?: string;
+    order_number: string;
+    shop_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;
+    schedule_date: string;
+    created_at: string;
+    products: ScanOrderOrderProduct[];
+    bookings: any[];
+    payments: any[];
+    surcharges: any[];
+    discount_list: any[];
+    relation_forms: any[];
+    contacts: any[];
+    contacts_info: any[];
+    holder: Record<string, any> | null;
+    summary: ScanOrderSummary;
+    metadata: Record<string, any>;
+}
+export interface ScanOrderSubmitPayload extends Omit<ScanOrderTempOrder, 'platform' | 'products' | 'created_at' | 'summary' | 'surcharges'> {
+    platform: 'H5' | 'PC';
+    request_unique_idempotency_token?: string;
+    form_record_ids?: Array<{
+        form_id: number | string;
+        form_record_ids: Array<number | string>;
+    }>;
+    products: ScanOrderSubmitProduct[];
+}
+export type ScanOrderAvailabilityMode = 'idle' | 'shop_closed' | 'resource_block' | 'resource_busy' | 'additional_order_with_code' | 'additional_order';
+export interface ScanOrderAvailabilityInfo {
+    mode: ScanOrderAvailabilityMode;
+    order_id?: string;
+    relation_id?: string;
+    table_form_id?: string;
+    deskmate_valid?: boolean;
+    errorTips?: string;
+    policy?: string | null;
+    partyroom_booking?: string | null;
+}
+export interface ScanOrderTableSnackConfig {
+    snack?: boolean | number | string;
+    table_validate?: boolean | number | string;
+}
+export interface ScanOrderOrderNumberPrefixConfig {
+    table_order?: string;
+    pos?: string;
+}
+export interface ScanOrderTableFormRecord {
+    policy?: string | null;
+}
+export interface ScanOrderTableConfigApiData {
+    table_max_number?: number | string | null;
+    order_count?: number | string | null;
+    order_id?: number | string | null;
+    last_order_id?: number | string | null;
+    relation_id?: number | string | null;
+    table_form_id?: number | string | null;
+    table_snack?: ScanOrderTableSnackConfig[] | null;
+    order_number_prefix?: ScanOrderOrderNumberPrefixConfig[] | null;
+    [key: string]: any;
+}
+export interface ScanOrderTableConfigApiResponse {
+    status?: boolean;
+    code?: number;
+    message?: string;
+    data?: ScanOrderTableConfigApiData | null;
+}
+export interface ScanOrderResourceState extends ScanOrderAvailabilityInfo {
+    tableMaxNumber: number;
+    orderCount: number;
+    relationId?: string;
+    tableFormId?: string;
+    currentOrderId?: string;
+    lastOrderId?: string;
+    allowSnack: boolean;
+    deskmateValid: boolean;
+    isExclusive: boolean;
+    isFull: boolean;
+    orderNumberPrefix: ScanOrderOrderNumberPrefixConfig[];
+    raw: ScanOrderTableConfigApiData | null;
+    table_form_record?: ScanOrderTableFormRecord | null;
+}
+export interface ScanOrderState {
+    entryContext: ScanOrderEntryContext | null;
+    status: ScanOrderStatus;
+    config: ScanOrderTableConfigApiData | null;
+    resource: ScanOrderResourceState | null;
+    flow: Record<string, any>;
+    error: string | null;
+    products?: ProductList;
+    order?: OrderModule;
+    salesSummary?: SalesSummaryModule;
+    scanOrderLogger?: ScanOrderLoggerModule;
+    itemRuleQuantityLimits: QuantityLimitResult[];
+    cartValidation: {
+        passed: boolean | null;
+        failures: QuantityCheckResult[];
+    };
+}
+export interface ScanOrderLoggerRuntimeConfig {
+    provider?: ScanOrderLoggerProviderType;
+    providerConfig?: ScanOrderLoggerProviderConfig;
+}
+export interface ScanOrderAddLogParams extends ScanOrderLogInput {
+}

package/dist/solution/ScanOrder/types.js

@@ -0,0 +1,16 @@
+/**
+ * 扫码下单流程 hook
+ */
+export var ScanOrderHooks = /*#__PURE__*/function (ScanOrderHooks) {
+  ScanOrderHooks["onInited"] = "scanOrder:onInited";
+  ScanOrderHooks["onDestroy"] = "scanOrder:onDestroy";
+  ScanOrderHooks["onRetryInit"] = "scanOrder:onRetryInit";
+  ScanOrderHooks["onRefresh"] = "scanOrder:onRefresh";
+  ScanOrderHooks["onCartValidationChanged"] = "scanOrder:onCartValidationChanged";
+  return ScanOrderHooks;
+}({});
+
+/**
+ * ScanOrder 临时订单（runtime-clean 版本）
+ * 只保留运行时字段，不包含任何 __comment 字段
+ */

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

@@ -0,0 +1,93 @@
+import { ScanOrderOrderProduct, ScanOrderOrderProductIdentity, ScanOrderSummary, ScanOrderTempOrder } from './types';
+import type { CartItemSummary, ItemRuleBusinessData, PaxInfo, QuantityLimitResult } from '../../model/strategy/adapter/itemRule';
+import type { StrategyConfig } from '../../model/strategy/type';
+/**
+ * 构建金额全为 0 的空 summary。
+ * 作为尚未计算金额时的兜底默认值，避免下游因 undefined 报错。
+ */
+export declare function createEmptySummary(): ScanOrderSummary;
+/**
+ * 商品数量安全取值。
+ * - NaN / undefined / < 1 均视作 1（最低起订量）
+ * - 有值时取整（不支持小数数量）
+ */
+export declare function getSafeProductNum(num?: number): number;
+/**
+ * 宽松布尔值转换。
+ * 兼容后端/配置中心常见的 boolean / number / string 表达，统一归一成 true/false。
+ */
+export declare function toBoolean(value: unknown): boolean;
+/**
+ * 将值归一化为有效的正向字符串。
+ * null / undefined / 空串 / '0' / 'null' 统一视为无效值并返回 undefined。
+ */
+export declare function toPositiveString(value: unknown): string | undefined;
+/**
+ * 归一化 item rule 策略模型 ID 列表。
+ * - 支持 string / number 混合输入
+ * - 仅保留 > 0 的合法数字
+ * - 自动去重
+ */
+export declare function normalizeEnabledItemRuleIds(rawIds: unknown): number[];
+/**
+ * 从 tableConfig 中提取合法策略模型 ID 列表。
+ */
+export declare function extractStrategyModelIdsFromTableConfig(tableConfig: Record<string, any> | null | undefined): number[];
+/**
+ * 仅保留 item_rule 类型策略。
+ */
+export declare function normalizeItemRuleStrategies(configs: unknown): StrategyConfig[];
+export declare function toNonNegativeNumber(value: unknown): number;
+export declare function toNonNegativeInt(value: unknown): number;
+export declare function toPriceString(value: unknown, fallback?: string): string;
+export declare function buildProductKey(productId: number, productVariantId: number): string;
+export declare function getTopLevelProductId(product: Record<string, any>): number | null;
+export declare function getTopLevelVariantId(product: Record<string, any>): number | null;
+export declare function buildQuantityLimitIndex(limits: QuantityLimitResult[]): {
+    exactLimitMap: Map<string, QuantityLimitResult[]>;
+    productLimitMap: Map<number, QuantityLimitResult[]>;
+};
+export declare function resolveSkuMatchedQuantityLimits(params: {
+    productId: number;
+    variantId: number | null;
+    limitIndex: {
+        exactLimitMap: Map<string, QuantityLimitResult[]>;
+        productLimitMap: Map<number, QuantityLimitResult[]>;
+    };
+}): QuantityLimitResult[];
+export declare function aggregateItemRuleLimit(matchedLimits: QuantityLimitResult[]): {
+    min: number | undefined;
+    max: number | undefined;
+    exact: number | undefined;
+    mustInclude: boolean;
+} | null;
+export declare function buildItemRuleBusinessData(params: {
+    tempOrder: ScanOrderTempOrder;
+    runtimeConfig: {
+        pax?: Partial<PaxInfo>;
+        historicalItems?: CartItemSummary[];
+        serviceType?: string;
+        submissionIndex?: number;
+        custom?: Record<string, any>;
+    };
+    itemRuleConfigs: StrategyConfig[];
+}): ItemRuleBusinessData;
+export declare function attachItemRuleLimitsToTopLevelProducts<T>(productList: T, limits: QuantityLimitResult[]): T;
+/**
+ * 判断两个商品 identity 是否匹配。
+ * 当双方都没有 identity_key 时回退到 product_id + product_variant_id 比较（向后兼容）；
+ * 一旦有一方携带 identity_key，则必须严格相等。
+ */
+export declare function isIdentityMatch(a: ScanOrderOrderProductIdentity, b: ScanOrderOrderProductIdentity): boolean;
+/**
+ * 根据 identity 在商品列表中定位下标。
+ * 用于判断商品是否已存在（已存在则累加数量，否则新增）。
+ */
+export declare function getProductIdentityIndex(products: ScanOrderOrderProduct[], identity: ScanOrderOrderProductIdentity): number;
+/**
+ * 对外部传入的商品对象做归一化：
+ * - 补全可选字段默认值（未传则使用兜底值，避免后续计算时因 undefined 导致异常）
+ * - 对 num 调用 getSafeProductNum 做安全处理
+ * - 保留 _origin 供后续业务流程（如促销规则）使用
+ */
+export declare function normalizeOrderProduct(product: Partial<ScanOrderOrderProduct> & ScanOrderOrderProductIdentity): ScanOrderOrderProduct;