@pisell/pisellos 2.2.313 → 2.2.315

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

@@ -1,7 +1,10 @@
 import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BaseModule } from '../../modules/BaseModule';
-import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentStatus, BaseSalesUpdateOrderProductQuantityParams, BaseSalesCalculateProductBookingPriceParams, BaseSalesPriceRecalculationContextChange, BaseSalesProductBookingPriceResult, BaseSalesQuotationCustomerScopeInfo, BaseSalesScanCodeResult, BaseSalesCashPaymentOptions, BaseSalesCashPaymentConfig, BaseSalesPayCashParams, BaseSalesPayCashResult, BaseSalesCommitPaymentMethodParams, BaseSalesCommitPaymentMethodResult, BaseSalesConfirmWalletPaymentResult } from './types';
+import { type LocalEftposFinalization } from '../../modules/Order/localEftposState';
+import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentStatus, BaseSalesSubmitSalesOrderParams, BaseSalesUpdateOrderProductQuantityParams, BaseSalesCalculateProductBookingPriceParams, BaseSalesPriceRecalculationContextChange, BaseSalesProductBookingPriceResult, BaseSalesQuotationCustomerScopeInfo, BaseSalesScanCodeResult, BaseSalesCashPaymentOptions, BaseSalesCashPaymentConfig, BaseSalesPayCashParams, BaseSalesPayCashResult, BaseSalesCommitPaymentMethodParams, BaseSalesCommitPaymentMethodResult, BaseSalesConfirmWalletPaymentResult } from './types';
 import { OrderModule } from '../../modules/Order';
+import { type PickupTimingBookingInput } from '../../modules/Order/pickupTiming';
+import type { PickupTimingAvailability, PickupTimingSelection, PickupTimingValidationResult } from '../../modules/FulfillmentTiming';
 import type { AddProductBookingInput, AddProductToOrderOptions, LoadSalesDetailParams, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, ReplaceTempOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, ShopServiceData, ShopServiceType } from '../../modules/Order/types';
 import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
 import type { Discount, VirtualCurrencyAsset } from '../../modules/Discount/types';
@@ -16,6 +19,7 @@ import { QuotationModule } from '../../modules/Quotation';
 import type { ISalesDetail, ISalesDetailHeader, ISalesBooking, ISalesPayment, ISalesSurcharge } from './utils/parseSalesResponse';
 import { AppPlugin } from '../../plugins/app';
 import { type TransformBaseProductToOrderProductParams } from './utils/transformBaseProductToOrderProduct';
+import type { OpenDataConfig } from '../../modules/OpenData/types';
 export interface BaseSalesState {
     order?: OrderModule;
     products?: ProductList;
@@ -76,6 +80,9 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private serverOrderChangeHydrateInFlight;
     private queuedServerOrderChanges;
     private serverOrderChangeSyncEnabled;
+    protected pickupTimingEnabled: boolean;
+    private pickupTimingController?;
+    private fulfillmentItemRulesController?;
     constructor(name?: string, version?: string);
     /**
      * 子类可覆盖此方法以追加/收敛要注册的子模块。
@@ -99,6 +106,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private isCurrentSalesOrderRecord;
     setServerOrderChangeSyncEnabled(enabled: boolean): void;
     private queueLatestServerOrderChange;
+    private shouldSyncServerOrderChanges;
     private drainQueuedServerOrderChanges;
     private syncCurrentSalesDetailFromServerOrderChange;
     private registerServerOrderChangeSync;
@@ -153,6 +161,25 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private getAuthoritativeBundleUnitPrice;
     private mergeProductForPriceQuery;
     protected getSubmitOrderSalesChannel(): string | undefined;
+    /** Only solutions opting into Pickup Timing supply effective OpenData. */
+    protected loadPickupTimingOpenData(_force: boolean): Promise<Record<string, unknown>>;
+    protected loadFulfillmentItemRuleOpenData(): Promise<OpenDataConfig | null>;
+    private getFulfillmentItemRulesController;
+    protected isPickupTimingEnabled(): boolean;
+    protected getPickupTimingContextData(key: string): unknown;
+    protected getPickupTimingScope(): string;
+    protected resetPickupTimingCache(): void;
+    private getPickupTimingController;
+    getPickupTimingAvailability(params?: {
+        date?: string;
+        force?: boolean;
+    }): Promise<PickupTimingAvailability>;
+    getPickupTimingSelection(): PickupTimingSelection;
+    setPickupTimingSelection(selection: PickupTimingSelection): Promise<PickupTimingSelection>;
+    validatePickupTimingSelection(selection: PickupTimingSelection): Promise<PickupTimingValidationResult>;
+    preparePickupTimingForCheckout(options?: {
+        freeze?: boolean;
+    }): Promise<PickupTimingSelection>;
     /** Subclasses with target-scoped OpenData override this guard before reusing the cache. */
     protected isInvoiceOpenDataCacheCurrent(): boolean;
     private getFulfillmentRefModeConfigs;
@@ -249,7 +276,10 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     updateTempOrderShopDiscount(amount: string | number): string;
     updateTempOrderDepositAmount(amount: string | number): OrderSummary;
     setPickupReferenceMode(mode: PickupReferenceMode): ShopServiceData;
-    setServiceType(serviceType: ShopServiceType): ShopServiceData;
+    setServiceType(serviceType: ShopServiceType): Promise<ShopServiceData>;
+    getPickupTimingBooking(): import("../../modules/Order").PickupTimingBooking | null;
+    setPickupTimingBooking(input: PickupTimingBookingInput): import("../../modules/Order").PickupTimingBooking;
+    clearPickupTimingBooking(): void;
     updateTempOrderContactsInfo(contactsInfo: Record<string, any> | null): Record<string, any> | null;
     /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化。 */
     setEnableTempOrderPersist(enabled: boolean): void;
@@ -315,13 +345,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
         productList?: Record<string, any>[];
         discountList?: Discount[];
     }): Promise<void>;
-    submitScanOrder<T = any>(params?: {
-        payments?: OrderPaymentSource[];
-        paymentStatus?: BaseSalesPaymentStatus;
-        smallTicketDataFlag?: number;
-        confirmPendingVoucherPayments?: boolean;
-        enhancePayload?: SubmitPayloadEnhancer;
-    }): Promise<T>;
+    submitScanOrder<T = any>(params?: BaseSalesSubmitSalesOrderParams): Promise<T>;
+    private buildVirtualSettlementOrderData;
     private buildVirtualSettlementSubmitData;
     /**
      * 提交当前 Sales 订单。
@@ -329,13 +354,11 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      * PaymentModal 场景通过 smallTicketDataFlag=1 请求 B 端小票数据；
      * payments 会交给 OrderModule 统一映射为 Sales 协议支付项。
      */
-    submitSalesOrder<T = any>(params?: {
-        payments?: OrderPaymentSource[];
-        paymentStatus?: BaseSalesPaymentStatus;
-        smallTicketDataFlag?: number;
-        confirmPendingVoucherPayments?: boolean;
-        enhancePayload?: SubmitPayloadEnhancer;
-    }): Promise<T>;
+    submitSalesOrder<T = any>(params?: BaseSalesSubmitSalesOrderParams): Promise<T>;
+    private pendingLocalEftposFinalizations;
+    finalizeLocalEftposPayment(params: LocalEftposFinalization): Promise<any>;
+    /** Entry gate also reads SQLite state, so stale sessions/restarts cannot bypass it. */
+    ensureSalesOrderReadyForPayment(): Promise<void>;
     saveSalesOrderDraft<T = any>(params?: {
         platform?: string;
         businessCode?: string;