@pisell/pisellos 2.3.28 → 2.3.30

package/lib/modules/Payment/types.d.ts

@@ -87,12 +87,30 @@ export interface PaymentMethod {
     /** 其他配置信息 */
     [key: string]: any;
 }
+/** 支付项扩展元数据 */
+export interface PaymentItemMetadata {
+    /** 钱箱 ID */
+    shop_wallet_pass_id?: string;
+    /** 三方支付交易流水号 */
+    unique_payment_number?: string;
+    /** 刷卡机设备快照；PaymentModule 不解析内部字段 */
+    card_reader_snapshot?: Record<string, unknown>;
+    /** rounding 规则 */
+    rounding_rule?: any;
+    /** 实付金额（现金支付时的实际给出金额） */
+    actual_paid_amount?: number;
+    /** 找零金额（现金支付时的找零金额） */
+    change_given_amount?: number;
+    [key: string]: unknown;
+}
 /**
  * 支付项
  */
 export interface PaymentItem {
     /** 当前支付项的唯一 ID */
     uuid: string;
+    /** 支付项稳定唯一号 */
+    payment_number?: string;
     /** 当前支付方式付出去多少钱 */
     amount: string;
     /** 支付类型，跟支付列表上对应的支付方式保持一致 */
@@ -110,18 +128,7 @@ export interface PaymentItem {
     /** Wallet Pass 本次使用值 */
     wallet_pass_use_value?: string | number | null;
     /** 拓展参数字段 */
-    metadata?: {
-        /** 钱箱 ID */
-        shop_wallet_pass_id?: string;
-        /** 唯一支付号 */
-        unique_payment_number?: string;
-        /** rouding规则 */
-        rounding_rule?: any;
-        /** 实付金额（现金支付时的实际给出金额） */
-        actual_paid_amount?: number;
-        /** 找零金额（现金支付时的找零金额） */
-        change_given_amount?: number;
-    };
+    metadata?: PaymentItemMetadata;
     /** rouding金额 */
     rounding_amount?: string;
     /** 三方支付手续费 */
@@ -228,6 +235,10 @@ export interface UpdateOrderParams {
  * 支付项输入类型（允许 amount 为数字）
  */
 export interface PaymentItemInput {
+    /** 调用方已有的支付项运行态 UUID；存在时复用为 payment_number 的唯一号段 */
+    uuid?: string;
+    /** 支付项稳定唯一号 */
+    payment_number?: string;
     /** 当前支付方式付出去多少钱 */
     amount: string | number;
     /** 支付类型，跟支付列表上对应的支付方式保持一致 */
@@ -256,18 +267,7 @@ export interface PaymentItemInput {
     /** 订单支付类型 */
     order_payment_type?: 'normal' | 'deposit';
     /** 扩展参数字段 */
-    metadata?: {
-        /** 钱箱 ID */
-        shop_wallet_pass_id?: string;
-        /** 唯一支付号 */
-        unique_payment_number?: string;
-        /** rounding规则 */
-        rounding_rule?: any;
-        /** 实付金额（现金支付时的实际给出金额） */
-        actual_paid_amount?: number;
-        /** 找零金额（现金支付时的找零金额） */
-        change_given_amount?: number;
-    };
+    metadata?: PaymentItemMetadata;
     /** 支付项创建时间 (格式: YYYY-MM-DD HH:mm:ss, 可选，不传则自动生成) */
     created_at?: string;
     /** 支付项更新时间 (格式: YYYY-MM-DD HH:mm:ss, 可选，不传则自动生成) */
@@ -302,6 +302,8 @@ export interface PaymentUpdateFields {
     voucher_id?: string;
     /** 该支付项是否已经同步给后端服务器（只有网络请求成功后才为true） */
     isSynced?: boolean;
+    /** 支付项扩展元数据；更新时与原 metadata 浅合并 */
+    metadata?: PaymentItemMetadata;
     /** 同步错误信息（业务错误时记录错误信息，用于区分"未同步"和"同步失败"） */
     syncError?: {
         error: string;

package/lib/modules/Product/index.d.ts

@@ -49,5 +49,5 @@ export declare class Product extends BaseModule implements Module {
     getCategories(): ProductCategory[];
     setOtherParams(key: string, value: any): void;
     getOtherParams(): any;
-    getProductType(): "normal" | "duration" | "session";
+    getProductType(): "duration" | "session" | "normal";
 }

package/lib/server/index.d.ts

@@ -55,6 +55,7 @@ declare class Server {
     private readonly BOOKING_REMOTE_CACHE_MAX_ENTRIES;
     private salesSearchSubscribers;
     private deviceTaskActionsRegistered;
+    private localPaymentUpdateQueues;
     private floorPlanQuerySubscribers;
     private moduleRegistry;
     constructor(core: PisellCore);
@@ -409,6 +410,18 @@ declare class Server {
      */
     private handleUpdateLocalOrder;
     private handleOrderSalesCheckout;
+    private handleOrderSalesDraft;
+    private createLocalPaymentOperationId;
+    private buildLocalPaymentOrderLogContext;
+    private isValidLocalPaymentDecimal;
+    private getInvalidLocalPaymentSurchargeFields;
+    private buildLocalPaymentSurchargeUpdate;
+    private handleGetLocalPayment;
+    private handleUpdateLocalPayment;
+    private runLocalPaymentUpdateInQueue;
+    private processLocalPaymentUpdate;
+    private processSuccessfulLocalPayment;
+    private sanitizeLocalRecoveryOrder;
     private handleOrderCheckout;
     private getDeviceTaskPlugin;
     private getIdGeneratorPlugin;
@@ -436,6 +449,7 @@ declare class Server {
     private syncMachinecodeRedeemStatusToLocalOrder;
     private handleOrderCheckoutSubmit;
     private handleSyncCheckoutSubmit;
+    private handleOrderDraftSubmit;
     private handlePendingSyncCheckoutOrder;
     private buildPendingSyncCheckoutOrder;
     private shouldBuildSmallTicketData;