@pisell/pisellos 2.3.29 → 2.3.30

package/dist/server/modules/order/index.d.ts

@@ -2,6 +2,7 @@ import { Module, ModuleOptions, PisellCore } from '../../../types';
 import { BaseModule } from '../../../modules/BaseModule';
 import type { RouteDefinition } from '../../types';
 import { OrderData, OrderId } from './types';
+import { type OrderPaymentIdentityType } from '../../../modules/Order/payment-utils';
 /**
  * Order 模块 - 基础框架
  */
@@ -89,8 +90,31 @@ export declare class OrderModule extends BaseModule implements Module {
     getOrderById(id: OrderId): OrderData | undefined;
     /** 按 order_id 查询内存订单。 */
     getOrderByOrderId(orderId: OrderId): OrderData | undefined;
+    private buildLocalPaymentOrderLogContext;
     getLocalOrderFromMemoryByLookup(lookup: OrderId): OrderData | null;
-    getLocalOrderByLookup(lookup: OrderId): Promise<OrderData | null>;
+    getLocalOrderByLookup(lookup: OrderId, options?: {
+        operationId?: string;
+    }): Promise<OrderData | null>;
+    getLocalPayment(params: {
+        saleId: OrderId;
+        paymentNumber: OrderId;
+        operationId?: string;
+    }): Promise<{
+        order: OrderData;
+        payment: Record<string, any>;
+        paymentIndex: number;
+        matchedBy: OrderPaymentIdentityType;
+    } | null>;
+    updateLocalPayment(params: {
+        saleId: OrderId;
+        paymentNumber: OrderId;
+        operationId?: string;
+        updates: Record<string, any>;
+    }): Promise<{
+        order: OrderData;
+        payment: Record<string, any>;
+        previousPayment: Record<string, any>;
+    } | null>;
     loadOrdersByServer(): Promise<OrderData[]>;
     /**
      * 静默全量刷新：后台重新拉取全量 SSE 订单数据并更新本地
@@ -99,6 +123,7 @@ export declare class OrderModule extends BaseModule implements Module {
      */
     silentRefresh(): Promise<OrderData[]>;
     private normalizeOrderForMemoryList;
+    private withoutSyntheticDraftOrderId;
     /**
      * 仅覆盖本地已存在的订单；不存在则直接跳过，不落库、不 emit。
      * 适用于"按 order_id 主动刷新本地订单详情"的代理场景。
@@ -110,7 +135,7 @@ export declare class OrderModule extends BaseModule implements Module {
      * 将远端拉取的订单合并进本地 store（已存在则更新，不存在则追加），落库并 emit onOrdersChanged。
      * 供 /update/localOrder 等在「本地尚无该单」时写入新建单。
      */
-    upsertOrdersFromRemote(freshOrders: OrderData[]): Promise<void>;
+    upsertOrdersFromRemote(freshOrders: OrderData[], source?: string): Promise<void>;
     markOrderSyncedByExternalSaleNumber(params: {
         externalSaleNumber: OrderId;
         patch?: Partial<OrderData>;
@@ -122,7 +147,14 @@ export declare class OrderModule extends BaseModule implements Module {
      * 将本地待同步订单按 SQLite storage key 合并进 store 并落库。
      * checkout 离线兜底可能没有 order_id，但通常会有 external_sale_number。
      */
-    upsertPendingSyncOrders(pendingOrders: OrderData[]): Promise<void>;
+    upsertPendingSyncOrders(pendingOrders: OrderData[], options?: {
+        throwOnError?: boolean;
+    }): Promise<void>;
+    /**
+     * 将 POS 草稿订单按 SQLite storage key 合并进 store 并落库。
+     * 草稿只表示本地可恢复快照，不进入同步队列。
+     */
+    upsertLocalDraftOrders(draftOrders: OrderData[]): Promise<void>;
     /**
      * 通过 SSE 按自定义 query 拉取订单（支持 select/with 精简字段）
      */
@@ -222,6 +254,9 @@ export declare class OrderModule extends BaseModule implements Module {
     private findOrderIndexByIdentity;
     private getOrderCompletenessScore;
     private pickPreferredOrder;
+    private getProductIdentityKeys;
+    private mergeOrderProductLists;
+    private mergeOrderPaymentLists;
     private mergeOrderRecords;
     private summarizeDuplicateOrders;
     private logDuplicateOrders;
@@ -238,6 +273,8 @@ export declare class OrderModule extends BaseModule implements Module {
     private setStorageItem;
     private loadOrdersFromSQLite;
     private isPendingSyncOrder;
+    private isDraftOrder;
+    private shouldProtectDraftOrderFromIncoming;
     private normalizeRemoteSyncedOrder;
     private mergeRemoteSnapshotWithPendingOrders;
     /**