@pisell/pisellos 2.2.204 → 2.2.205

package/lib/modules/Payment/index.js

@@ -76,9 +76,6 @@ var PaymentModule = class extends import_BaseModule.BaseModule {
     this.defaultVersion = "1.0.0";
     // LoggerManager 实例
     this.voucherUpdateLockByOrderUuid = /* @__PURE__ */ new Map();
-    this.payMethodMemoryCache = null;
-    this.payMethodListInFlight = null;
-    this.isRefreshingPaymentMethods = false;
     this.otherParams = {};
     this.cash = new import_cash.CashPaymentImpl(this);
     this.eftpos = new import_eftpos.EftposPaymentImpl(this);
@@ -213,66 +210,18 @@ var PaymentModule = class extends import_BaseModule.BaseModule {
       }
     });
   }
-  async filterPayMethods(payMethods) {
-    payMethods = payMethods.filter((method) => method.status === 1 && method.disable === 0);
-    const walletPassMethod = payMethods.find((method) => method.code === "WALLET_PASS");
-    if (walletPassMethod) {
-      payMethods.forEach((method) => {
-        if (method.code === "PRODUCTVOUCHER" || method.code === "GIFTCARD" || method.code === "POINTCARD") {
-          method.channel_application = walletPassMethod.channel_application;
-        }
-      });
-    } else {
-      payMethods = payMethods.filter((method) => method.code !== "PRODUCTVOUCHER" && method.code !== "GIFTCARD" && method.code !== "POINTCARD");
-    }
-    return payMethods;
-  }
   /**
    * 获取支付方式列表
    */
   async getPayMethodListAsync() {
-    var _a;
     this.logInfo("Starting getPayMethodListAsync");
-    if ((_a = this.payMethodMemoryCache) == null ? void 0 : _a.length) {
-      return this.payMethodMemoryCache;
-    }
-    if (this.payMethodListInFlight) {
-      return this.payMethodListInFlight;
-    }
-    this.payMethodListInFlight = this.loadPayMethodListAsync().finally(() => {
-      this.payMethodListInFlight = null;
-    });
-    return this.payMethodListInFlight;
-  }
-  async loadPayMethodListAsync() {
     try {
-      let cachedMethods = [];
-      try {
-        cachedMethods = await this.dbManager.getAll("pay_method");
-      } catch (dbError) {
-        console.warn("[PaymentModule] pay_method 表不存在，将从服务器获取数据");
-      }
-      const hasCache = cachedMethods.length > 0;
-      if (hasCache) {
-        this.payMethodMemoryCache = cachedMethods;
-        this.refreshPaymentMethodsInBackground(cachedMethods);
-        return cachedMethods;
-      }
-      const response = await this.request.get("/pay/custom-payment/all");
-      response.data = await this.filterPayMethods(response.data);
-      const payMethods = response.data || [];
-      this.payMethodMemoryCache = payMethods;
-      try {
-        for (const method of payMethods) {
-          await this.dbManager.update("pay_method", method);
-        }
-      } catch (dbError) {
-        console.warn("[PaymentModule] 无法缓存支付方式，pay_method 表不存在");
-      }
-      await this.core.effects.emit(
-        `${this.name}:onPaymentMethodsLoaded`,
-        payMethods
-      );
+      const response = await this.request.get("/pay/custom-payment/all", {
+        filterPaymentMethods: true
+      }, {
+        osServer: true
+      });
+      const payMethods = (response == null ? void 0 : response.data) || response || [];
       this.logInfo("getPayMethodListAsync completed successfully", {
         payMethods
       });
@@ -283,98 +232,6 @@ var PaymentModule = class extends import_BaseModule.BaseModule {
       return [];
     }
   }
-  /**
-   * 后台刷新支付方式列表
-   */
-  async refreshPaymentMethodsInBackground(cachedMethods) {
-    if (this.isRefreshingPaymentMethods)
-      return;
-    this.isRefreshingPaymentMethods = true;
-    this.logInfo("Starting refreshPaymentMethodsInBackground", {
-      cachedMethodsCount: cachedMethods.length
-    });
-    try {
-      console.log("[PaymentModule] 后台刷新支付方式列表...");
-      const response = await this.request.get("/pay/custom-payment/all");
-      response.data = await this.filterPayMethods(response.data);
-      const newPayMethods = response.data || [];
-      this.payMethodMemoryCache = newPayMethods;
-      const hasChanges = this.hasPaymentMethodsChanged(
-        cachedMethods,
-        newPayMethods
-      );
-      if (hasChanges) {
-        console.log("[PaymentModule] 支付方式列表已更新");
-        this.logInfo("Payment methods updated in background", {
-          oldCount: cachedMethods.length,
-          newCount: newPayMethods.length
-        });
-        try {
-          for (const method of cachedMethods) {
-            await this.dbManager.delete("pay_method", method.id);
-          }
-          for (const method of newPayMethods) {
-            await this.dbManager.update("pay_method", method);
-          }
-        } catch (dbError) {
-          console.warn("[PaymentModule] 无法更新支付方式缓存", dbError);
-        }
-        const eventData = {
-          oldMethods: cachedMethods,
-          newMethods: newPayMethods
-        };
-        await this.core.effects.emit(
-          `${this.name}:onPaymentMethodsChanged`,
-          eventData
-        );
-      } else {
-        console.log("[PaymentModule] 支付方式列表无变化");
-      }
-    } catch (error) {
-      console.error("[PaymentModule] 后台刷新支付方式失败", error);
-    } finally {
-      this.isRefreshingPaymentMethods = false;
-    }
-  }
-  /**
-   * 检查支付方式列表是否有变化
-   */
-  hasPaymentMethodsChanged(oldMethods, newMethods) {
-    if (oldMethods.length !== newMethods.length) {
-      return true;
-    }
-    const oldMethodsMap = new Map(
-      oldMethods.map((method) => [method.id, method])
-    );
-    for (const newMethod of newMethods) {
-      const oldMethod = oldMethodsMap.get(newMethod.id);
-      if (!oldMethod) {
-        return true;
-      }
-      if (oldMethod.code !== newMethod.code || oldMethod.name !== newMethod.name || oldMethod.type !== newMethod.type || oldMethod.description !== newMethod.description || oldMethod.status !== newMethod.status || oldMethod.disable !== newMethod.disable || oldMethod.is_surcharge !== newMethod.is_surcharge || oldMethod.fixed !== newMethod.fixed || oldMethod.percentage !== newMethod.percentage || oldMethod.enabled !== newMethod.enabled || JSON.stringify(oldMethod.channel_application || []) !== JSON.stringify(newMethod.channel_application || []) || JSON.stringify(oldMethod.companies || []) !== JSON.stringify(newMethod.companies || []) || JSON.stringify(oldMethod.metadata || {}) !== JSON.stringify(newMethod.metadata || {})) {
-        console.log(`[PaymentModule] 支付方式 ${newMethod.id} (${newMethod.code}) 发生变化:`, {
-          id: newMethod.id,
-          changes: {
-            code: oldMethod.code !== newMethod.code ? { old: oldMethod.code, new: newMethod.code } : void 0,
-            name: oldMethod.name !== newMethod.name ? { old: oldMethod.name, new: newMethod.name } : void 0,
-            type: oldMethod.type !== newMethod.type ? { old: oldMethod.type, new: newMethod.type } : void 0,
-            description: oldMethod.description !== newMethod.description ? { old: oldMethod.description, new: newMethod.description } : void 0,
-            status: oldMethod.status !== newMethod.status ? { old: oldMethod.status, new: newMethod.status } : void 0,
-            disable: oldMethod.disable !== newMethod.disable ? { old: oldMethod.disable, new: newMethod.disable } : void 0,
-            is_surcharge: oldMethod.is_surcharge !== newMethod.is_surcharge ? { old: oldMethod.is_surcharge, new: newMethod.is_surcharge } : void 0,
-            fixed: oldMethod.fixed !== newMethod.fixed ? { old: oldMethod.fixed, new: newMethod.fixed } : void 0,
-            percentage: oldMethod.percentage !== newMethod.percentage ? { old: oldMethod.percentage, new: newMethod.percentage } : void 0,
-            enabled: oldMethod.enabled !== newMethod.enabled ? { old: oldMethod.enabled, new: newMethod.enabled } : void 0,
-            channel_application: JSON.stringify(oldMethod.channel_application || []) !== JSON.stringify(newMethod.channel_application || []) ? { old: oldMethod.channel_application, new: newMethod.channel_application } : void 0,
-            companies: JSON.stringify(oldMethod.companies || []) !== JSON.stringify(newMethod.companies || []) ? { old: oldMethod.companies, new: newMethod.companies } : void 0,
-            metadata: JSON.stringify(oldMethod.metadata || {}) !== JSON.stringify(newMethod.metadata || {}) ? { old: oldMethod.metadata, new: newMethod.metadata } : void 0
-          }
-        });
-        return true;
-      }
-    }
-    return false;
-  }
   /**
    * 获取订单列表
    */

package/lib/plugins/request.d.ts

@@ -69,6 +69,7 @@ export interface RequestOptions {
     customToast?: () => void;
     cache?: CacheProps;
     osServer?: boolean;
+    prefix?: boolean;
     callback?: (res: any) => void;
     subscriberId?: string;
 }

package/lib/server/index.d.ts

@@ -4,6 +4,7 @@ import { QuotationModule } from './modules/quotation';
 import { ScheduleModuleEx } from './modules/schedule';
 import { ResourceModule } from './modules/resource';
 import { FloorPlanModule } from './modules/floor-plan';
+import { PaymentServerModule } from './modules/payment';
 import { PisellCore, ServerModuleConfig, InitializeServerOptions } from '../types';
 import type { RouteHandler, HttpMethod, RouteDefinition, Router, ModuleRegistryConfig, RequestSetting } from './types';
 import { OrderModule } from './modules/order';
@@ -23,6 +24,9 @@ declare class Server {
     resource?: ResourceModule;
     order?: OrderModule;
     floor_plan?: FloorPlanModule;
+    payment?: PaymentServerModule;
+    private paymentRouteModule?;
+    private paymentRouteModuleInFlight?;
     /** GET 前缀路由（最长前缀优先匹配） */
     private prefixRouterGet;
     router: Router;
@@ -167,6 +171,8 @@ declare class Server {
      * @private
      */
     private registerServerRoutes;
+    private getPaymentRouteModule;
+    private handlePaymentMethods;
     /**
      * 根据 subscriberId 移除商品查询订阅者
      */

package/lib/server/index.js

@@ -41,6 +41,7 @@ var import_schedule = require("./modules/schedule");
 var import_resource = require("./modules/resource");
 var import_floor_plan = require("./modules/floor-plan");
 var import_types = require("./modules/floor-plan/types");
+var import_payment = require("./modules/payment");
 var import_schedule2 = require("./utils/schedule");
 var import_types2 = require("./modules/products/types");
 var import_product = require("./utils/product");
@@ -120,6 +121,15 @@ var Server = class {
           list: []
         }
       },
+      payment: {
+        name: "payment",
+        moduleClass: import_payment.PaymentServerModule,
+        moduleName: "server_payment",
+        version: "1.0.0",
+        defaultStore: {
+          payMethods: []
+        }
+      },
       resource: {
         name: "resource",
         moduleClass: import_resource.ResourceModule,
@@ -143,6 +153,18 @@ var Server = class {
         }
       }
     };
+    this.handlePaymentMethods = async ({ data, config }) => {
+      debugger;
+      const payment = await this.getPaymentRouteModule();
+      const payMethods = await payment.getPayMethodListAsync({
+        shouldFilter: (data == null ? void 0 : data.filterPaymentMethods) === true || (config == null ? void 0 : config.filterPaymentMethods) === true
+      });
+      return {
+        code: 200,
+        status: true,
+        data: payMethods
+      };
+    };
     /**
      * 处理商品查询请求
      * 存储订阅者信息，便于数据变更时推送最新结果
@@ -1262,6 +1284,11 @@ var Server = class {
         path: "/update/localOrder",
         handler: this.handleUpdateLocalOrder.bind(this)
       },
+      {
+        method: "get",
+        path: "/shop/pay/custom-payment/all",
+        handler: this.handlePaymentMethods.bind(this)
+      },
       {
         method: "post",
         path: "/shop/order/sales/checkout",
@@ -1286,6 +1313,25 @@ var Server = class {
       }
     ]);
   }
+  async getPaymentRouteModule() {
+    if (this.payment)
+      return this.payment;
+    if (this.paymentRouteModule)
+      return this.paymentRouteModule;
+    if (this.paymentRouteModuleInFlight)
+      return this.paymentRouteModuleInFlight;
+    this.paymentRouteModuleInFlight = (async () => {
+      const module2 = new import_payment.PaymentServerModule("server_payment_route", "1.0.0");
+      await module2.initialize(this.core, {
+        store: { payMethods: [] }
+      });
+      this.paymentRouteModule = module2;
+      return module2;
+    })().finally(() => {
+      this.paymentRouteModuleInFlight = void 0;
+    });
+    return this.paymentRouteModuleInFlight;
+  }
   /**
    * 根据 subscriberId 移除商品查询订阅者
    */

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

@@ -16,6 +16,8 @@ export type { ScheduleState, ScheduleItem } from './schedule/types';
 export { OrderModule } from './order';
 export type { OrderState, OrderData, OrderId, OrderSummary, OrderBookingItem, OrderProductLineItem, OrderPaymentItem, OrderSurchargeItem, OrderProductDiscountItem, OrderWithoutBookings, BookingData, OrderFilters, BookingFilters, OrderFilterResult, OrderFilterRejectDetail, OrderFilterRejectedEntry, BookingFilterResult, OrderModulePagedResult, } from './order/types';
 export { OrderHooks } from './order/types';
+export { PaymentServerModule } from './payment';
+export type { PaymentMethod, PaymentMethodsChangedEventData, PaymentServerState } from './payment/types';
 export { FloorPlanModule } from './floor-plan';
 export type { FloorPlanItem, FloorPlanState, FloorPlanSyncMessage } from './floor-plan/types';
 export { FloorPlanHooks } from './floor-plan/types';

package/lib/server/modules/index.js

@@ -25,6 +25,7 @@ __export(modules_exports, {
   MenuModule: () => import_menu.MenuModule,
   OrderHooks: () => import_types4.OrderHooks,
   OrderModule: () => import_order.OrderModule,
+  PaymentServerModule: () => import_payment.PaymentServerModule,
   ProductsHooks: () => import_types.ProductsHooks,
   ProductsModule: () => import_products.ProductsModule,
   QuotationHooks: () => import_types3.QuotationHooks,
@@ -44,6 +45,7 @@ var import_types3 = require("./quotation/types");
 var import_schedule = require("./schedule");
 var import_order = require("./order");
 var import_types4 = require("./order/types");
+var import_payment = require("./payment");
 var import_floor_plan = require("./floor-plan");
 var import_types5 = require("./floor-plan/types");
 var import_resource = require("./resource");
@@ -56,6 +58,7 @@ var import_resource2 = require("./resource");
   MenuModule,
   OrderHooks,
   OrderModule,
+  PaymentServerModule,
   ProductsHooks,
   ProductsModule,
   QuotationHooks,

package/lib/server/modules/payment/index.d.ts

@@ -0,0 +1,28 @@
+import { Module, ModuleOptions, PisellCore } from '../../../types';
+import { BaseModule } from '../../../modules/BaseModule';
+import type { PaymentMethod } from './types';
+export declare class PaymentServerModule extends BaseModule implements Module {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    private request;
+    private app;
+    private logger;
+    private store;
+    private payMethodMemoryCache;
+    private payMethodListInFlight;
+    constructor(name?: string, version?: string);
+    initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
+    getPayMethodListAsync(options?: {
+        shouldFilter?: boolean;
+    }): Promise<PaymentMethod[]>;
+    clearPayMethodCache(): void;
+    private loadPayMethodListAsync;
+    private fetchRemotePayMethods;
+    private shouldFilterPayMethods;
+    private resolvePayMethods;
+    private filterPayMethods;
+    private setPayMethodCache;
+    private logInfo;
+    private logWarning;
+    private logError;
+}

package/lib/server/modules/payment/index.js

@@ -0,0 +1,192 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server/modules/payment/index.ts
+var payment_exports = {};
+__export(payment_exports, {
+  PaymentServerModule: () => PaymentServerModule
+});
+module.exports = __toCommonJS(payment_exports);
+var import_BaseModule = require("../../../modules/BaseModule");
+var WALLET_PASS_CODE = "WALLET_PASS";
+var WALLET_DEPENDENT_CODES = /* @__PURE__ */ new Set(["PRODUCTVOUCHER", "GIFTCARD", "POINTCARD"]);
+var PAYMENT_METHODS_LOADED_EVENT = "payment:onPaymentMethodsLoaded";
+var PaymentServerModule = class extends import_BaseModule.BaseModule {
+  constructor(name, version) {
+    super(name || "payment", version);
+    this.defaultName = "payment";
+    this.defaultVersion = "1.0.0";
+    this.payMethodMemoryCache = null;
+    this.payMethodListInFlight = null;
+  }
+  async initialize(core, options) {
+    var _a, _b, _c;
+    this.core = core;
+    this.store = options == null ? void 0 : options.store;
+    if (!this.store)
+      this.store = { payMethods: [] };
+    if (!Array.isArray(this.store.payMethods))
+      this.store.payMethods = [];
+    this.request = core.getPlugin("request");
+    const appPlugin = core.getPlugin("app");
+    this.app = appPlugin == null ? void 0 : appPlugin.getApp();
+    this.logger = (_a = this.app) == null ? void 0 : _a.logger;
+    if (!this.request && !((_b = this.app) == null ? void 0 : _b.request)) {
+      throw new Error("PaymentServerModule 需要 request 插件或 app.request 支持");
+    }
+    this.logInfo("PaymentServerModule initialized successfully", {
+      hasAppRequest: !!((_c = this.app) == null ? void 0 : _c.request)
+    });
+  }
+  // getRoutes(): RouteDefinition[] {
+  //   return [
+  //     {
+  //       method: 'get',
+  //       path: '/pay/custom-payment/all',
+  //       handler: async ({ data, config }) => {
+  //         const payMethods = await this.getPayMethodListAsync({
+  //           shouldFilter: this.shouldFilterPayMethods(data, config),
+  //         });
+  //         return {
+  //           code: 200,
+  //           status: true,
+  //           data: payMethods,
+  //         };
+  //       },
+  //     },
+  //   ];
+  // }
+  async getPayMethodListAsync(options = {}) {
+    var _a;
+    this.logInfo("Starting getPayMethodListAsync");
+    if ((_a = this.payMethodMemoryCache) == null ? void 0 : _a.length) {
+      return this.resolvePayMethods(this.payMethodMemoryCache, options);
+    }
+    if (this.payMethodListInFlight) {
+      const payMethods2 = await this.payMethodListInFlight;
+      return this.resolvePayMethods(payMethods2, options);
+    }
+    this.payMethodListInFlight = this.loadPayMethodListAsync().finally(() => {
+      this.payMethodListInFlight = null;
+    });
+    const payMethods = await this.payMethodListInFlight;
+    return this.resolvePayMethods(payMethods, options);
+  }
+  clearPayMethodCache() {
+    this.payMethodMemoryCache = null;
+    this.store.payMethods = [];
+  }
+  async loadPayMethodListAsync() {
+    try {
+      const payMethods = await this.fetchRemotePayMethods();
+      this.setPayMethodCache(payMethods);
+      await this.core.effects.emit(PAYMENT_METHODS_LOADED_EVENT, payMethods);
+      this.logInfo("getPayMethodListAsync completed successfully", {
+        payMethods
+      });
+      return payMethods;
+    } catch (error) {
+      console.error("[PaymentServerModule] 获取支付方式列表失败", error);
+      this.logError("getPayMethodListAsync failed", error);
+      return [];
+    }
+  }
+  async fetchRemotePayMethods() {
+    var _a;
+    const requester = ((_a = this.app) == null ? void 0 : _a.request) || this.request;
+    const response = await requester.get("/shop/pay/custom-payment/all", void 0);
+    const payMethods = (response == null ? void 0 : response.data) || response || [];
+    return Array.isArray(payMethods) ? payMethods : [];
+  }
+  shouldFilterPayMethods(data, config) {
+    return (data == null ? void 0 : data.filterPaymentMethods) === true || (config == null ? void 0 : config.filterPaymentMethods) === true;
+  }
+  resolvePayMethods(payMethods, options) {
+    if (!options.shouldFilter)
+      return payMethods;
+    return this.filterPayMethods(payMethods);
+  }
+  filterPayMethods(payMethods) {
+    if (!Array.isArray(payMethods))
+      return [];
+    let availableMethods = payMethods.filter(
+      (method) => method.status === 1 && method.disable === 0
+    );
+    const walletPassMethod = availableMethods.find(
+      (method) => method.code === WALLET_PASS_CODE
+    );
+    if (!walletPassMethod) {
+      return availableMethods.filter(
+        (method) => !WALLET_DEPENDENT_CODES.has(method.code)
+      );
+    }
+    availableMethods = availableMethods.map((method) => {
+      if (!WALLET_DEPENDENT_CODES.has(method.code))
+        return method;
+      return {
+        ...method,
+        channel_application: walletPassMethod.channel_application
+      };
+    });
+    return availableMethods;
+  }
+  setPayMethodCache(payMethods) {
+    this.payMethodMemoryCache = payMethods;
+    this.store.payMethods = payMethods;
+  }
+  logInfo(title, metadata) {
+    try {
+      if (this.logger) {
+        this.logger.addLog({
+          type: "info",
+          title: `[PaymentServerModule] ${title}`,
+          metadata: metadata || {}
+        });
+      }
+    } catch {
+    }
+  }
+  logWarning(title, metadata) {
+    try {
+      if (this.logger) {
+        this.logger.addLog({
+          type: "warning",
+          title: `[PaymentServerModule] ${title}`,
+          metadata: metadata || {}
+        });
+      }
+    } catch {
+    }
+  }
+  logError(title, metadata) {
+    try {
+      if (this.logger) {
+        this.logger.addLog({
+          type: "error",
+          title: `[PaymentServerModule] ${title}`,
+          metadata: metadata || {}
+        });
+      }
+    } catch {
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PaymentServerModule
+});

package/lib/server/modules/payment/types.d.ts

@@ -0,0 +1,9 @@
+import type { PaymentMethod } from '../../../modules/Payment/types';
+export interface PaymentServerState {
+    payMethods: PaymentMethod[];
+}
+export interface PaymentMethodsChangedEventData {
+    oldMethods: PaymentMethod[];
+    newMethods: PaymentMethod[];
+}
+export type { PaymentMethod };

package/lib/server/modules/payment/types.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server/modules/payment/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

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

@@ -9,6 +9,7 @@ import { RequestPlugin, WindowPlugin } from '../../plugins';
 export * from './types';
 import { ProductList } from '../../modules/ProductList';
 import { PaymentModule } from '../../modules/Payment';
+import type { PaymentMethod } from '../../modules/Payment/types';
 import type { SalesSummaryModule } from '../../modules/SalesSummary';
 import type { ScheduleModule } from '../../modules/Schedule';
 import { QuotationModule } from '../../modules/Quotation';
@@ -41,6 +42,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     protected currentSalesDetail: ISalesDetail | null;
     protected discountConfigCacheKey: string | null;
     protected hasManualDiscountSelection: boolean;
+    private paymentMethodsCache;
     constructor(name?: string, version?: string);
     /**
      * 子类可覆盖此方法以追加/收敛要注册的子模块。
@@ -59,6 +61,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      * 记录错误日志
      */
     private logError;
+    private hydrateOrderPaymentNames;
     get payment(): PaymentModule | undefined;
     private getCurrentOrderCustomerId;
     private applyQuotationScheduleResolver;
@@ -212,7 +215,9 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
         email: string;
     };
     /** 获取可用支付方式列表，供 PaymentModal 渲染支付选项。 */
-    getPaymentMethodsAsync(): Promise<any[]>;
+    getPaymentMethodsAsync(): Promise<PaymentMethod[]>;
+    /** 同步读取初始化时缓存的支付方式列表。 */
+    getPaymentMethods(): PaymentMethod[];
     /** 轻量舍入能力，供现金支付 UI 计算 rounding_amount。 */
     roundAmount(params: {
         amount: string | number;