@r2wa-org/eden 0.0.48 → 0.0.51

package/dist/src/wallet/service.d.ts

@@ -1,225 +1,100 @@
 import type { TransactionTx } from "../db/transaction";
-import { type WalletTypeCodeType } from "../wallet-type/constants";
-import type { AdminManualAdjustWalletBatchInput, AdminManualAdjustWalletInput } from "./dto.schemas";
-import { getOrCreateUserWallet } from "./ensure";
-/**
- * 钱包基础服务（抽象类）
- */
-declare abstract class WalletBaseService {
-    protected static validateUserId(userId: string): void;
-}
-/**
- * 用户侧服务
- * 提供用户能访问的余额查询功能
- */
-export declare abstract class UserWalletService extends WalletBaseService {
-    static getWalletByTypeId(userId: string, walletTypeId: string): Promise<{
-        id: string;
-        createdAt: Date;
-        updatedAt: Date;
-        userId: string;
-        walletTypeId: string;
-        available: string;
-        frozen: string;
-        version: number;
-        walletType: {
+import type { WalletListQueryType } from "./dto.schemas";
+declare abstract class BaseWalletService {
+    protected static listWalletsInternal(options?: WalletListQueryType, defaultToCurrentUserId?: string): Promise<{
+        items: {
             id: string;
             name: string;
             createdAt: Date;
             updatedAt: Date;
-            description: string | null;
-            code: "balance" | "profit" | "team" | "check_in" | "meeting_reward" | "reform_pioneer_allowance" | "reform_monthly_enjoy" | "basic_livelihood" | "basic_pension" | "basic_medical";
-            allowDeposit: boolean;
-            allowWithdraw: boolean;
-            minWithdrawAmount: string;
-            maxWithdrawAmount: string;
-            allowTransfer: boolean;
-            minTransferAmount: string;
-            maxTransferAmount: string;
-            allowExchange: boolean;
-            allowReceiveExchange: boolean;
-            minExchangeAmount: string;
-            maxExchangeAmount: string;
-            exchangeRate: string;
-            allowTransaction: boolean;
-            hasExpiry: boolean;
-            expiryDays: number | null;
+            userId: string;
             isActive: boolean;
-            sortOrder: number;
-        };
+            walletTypeId: string;
+            isPrimary: boolean;
+            walletType: {
+                id: string;
+                name: string;
+                createdAt: Date;
+                updatedAt: Date;
+                key: string;
+                isActive: boolean;
+                sortOrder: number;
+                isSingleton: boolean;
+            };
+        }[];
+        total: number;
     }>;
-    static getWalletByCode(userId: string, walletCode: WalletTypeCodeType): Promise<{
-        id: string;
-        createdAt: Date;
-        updatedAt: Date;
-        userId: string;
-        walletTypeId: string;
-        available: string;
-        frozen: string;
-        version: number;
-        walletType: {
+}
+export declare abstract class UserWalletService extends BaseWalletService {
+    static listWallets(userId: string, options?: Omit<WalletListQueryType, "userId">): Promise<{
+        items: {
             id: string;
             name: string;
             createdAt: Date;
             updatedAt: Date;
-            description: string | null;
-            code: "balance" | "profit" | "team" | "check_in" | "meeting_reward" | "reform_pioneer_allowance" | "reform_monthly_enjoy" | "basic_livelihood" | "basic_pension" | "basic_medical";
-            allowDeposit: boolean;
-            allowWithdraw: boolean;
-            minWithdrawAmount: string;
-            maxWithdrawAmount: string;
-            allowTransfer: boolean;
-            minTransferAmount: string;
-            maxTransferAmount: string;
-            allowExchange: boolean;
-            allowReceiveExchange: boolean;
-            minExchangeAmount: string;
-            maxExchangeAmount: string;
-            exchangeRate: string;
-            allowTransaction: boolean;
-            hasExpiry: boolean;
-            expiryDays: number | null;
+            userId: string;
             isActive: boolean;
-            sortOrder: number;
-        };
+            walletTypeId: string;
+            isPrimary: boolean;
+            walletType: {
+                id: string;
+                name: string;
+                createdAt: Date;
+                updatedAt: Date;
+                key: string;
+                isActive: boolean;
+                sortOrder: number;
+                isSingleton: boolean;
+            };
+        }[];
+        total: number;
     }>;
-    /**
-     * 获取用户所有钱包（含钱包类型信息）
-     */
-    static getWalletsWithType(userId: string): Promise<{
-        id: string;
-        createdAt: Date;
-        updatedAt: Date;
-        userId: string;
-        walletTypeId: string;
-        available: string;
-        frozen: string;
-        version: number;
-        walletType: {
+}
+export declare abstract class AdminWalletService extends BaseWalletService {
+    static listWallets(options?: WalletListQueryType): Promise<{
+        items: {
             id: string;
             name: string;
             createdAt: Date;
             updatedAt: Date;
-            description: string | null;
-            code: "balance" | "profit" | "team" | "check_in" | "meeting_reward" | "reform_pioneer_allowance" | "reform_monthly_enjoy" | "basic_livelihood" | "basic_pension" | "basic_medical";
-            allowDeposit: boolean;
-            allowWithdraw: boolean;
-            minWithdrawAmount: string;
-            maxWithdrawAmount: string;
-            allowTransfer: boolean;
-            minTransferAmount: string;
-            maxTransferAmount: string;
-            allowExchange: boolean;
-            allowReceiveExchange: boolean;
-            minExchangeAmount: string;
-            maxExchangeAmount: string;
-            exchangeRate: string;
-            allowTransaction: boolean;
-            hasExpiry: boolean;
-            expiryDays: number | null;
+            userId: string;
             isActive: boolean;
-            sortOrder: number;
-        };
-    }[]>;
-    /**
-     * 获取可用钱包类型列表
-     */
-    static getActiveWalletTypes(): Promise<{
-        id: string;
-        name: string;
-        createdAt: Date;
-        updatedAt: Date;
-        description: string | null;
-        code: "balance" | "profit" | "team" | "check_in" | "meeting_reward" | "reform_pioneer_allowance" | "reform_monthly_enjoy" | "basic_livelihood" | "basic_pension" | "basic_medical";
-        allowDeposit: boolean;
-        allowWithdraw: boolean;
-        minWithdrawAmount: string;
-        maxWithdrawAmount: string;
-        allowTransfer: boolean;
-        minTransferAmount: string;
-        maxTransferAmount: string;
-        allowExchange: boolean;
-        allowReceiveExchange: boolean;
-        minExchangeAmount: string;
-        maxExchangeAmount: string;
-        exchangeRate: string;
-        allowTransaction: boolean;
-        hasExpiry: boolean;
-        expiryDays: number | null;
-        isActive: boolean;
-        sortOrder: number;
-    }[]>;
+            walletTypeId: string;
+            isPrimary: boolean;
+            walletType: {
+                id: string;
+                name: string;
+                createdAt: Date;
+                updatedAt: Date;
+                key: string;
+                isActive: boolean;
+                sortOrder: number;
+                isSingleton: boolean;
+            };
+        }[];
+        total: number;
+    }>;
 }
-/**
- * 管理侧服务
- * 提供管理员查询任意用户余额的功能
- */
-export declare abstract class AdminWalletService extends WalletBaseService {
-    static getWalletsWithType(userId: string): Promise<{
+export declare abstract class InternalWalletService extends BaseWalletService {
+    static getOrCreateWallet(tx: TransactionTx, userId: string, walletTypeKey: string): Promise<{
         id: string;
+        name: string;
         createdAt: Date;
         updatedAt: Date;
         userId: string;
+        isActive: boolean;
         walletTypeId: string;
-        available: string;
-        frozen: string;
-        version: number;
+        isPrimary: boolean;
         walletType: {
             id: string;
             name: string;
             createdAt: Date;
             updatedAt: Date;
-            description: string | null;
-            code: "balance" | "profit" | "team" | "check_in" | "meeting_reward" | "reform_pioneer_allowance" | "reform_monthly_enjoy" | "basic_livelihood" | "basic_pension" | "basic_medical";
-            allowDeposit: boolean;
-            allowWithdraw: boolean;
-            minWithdrawAmount: string;
-            maxWithdrawAmount: string;
-            allowTransfer: boolean;
-            minTransferAmount: string;
-            maxTransferAmount: string;
-            allowExchange: boolean;
-            allowReceiveExchange: boolean;
-            minExchangeAmount: string;
-            maxExchangeAmount: string;
-            exchangeRate: string;
-            allowTransaction: boolean;
-            hasExpiry: boolean;
-            expiryDays: number | null;
+            key: string;
             isActive: boolean;
             sortOrder: number;
+            isSingleton: boolean;
         };
-    }[]>;
-    static manualAdjustWallet(operatorId: string, input: AdminManualAdjustWalletInput): Promise<import("../ledger").BalanceChangeResult>;
-    static manualAdjustWalletBatch(operatorId: string, input: AdminManualAdjustWalletBatchInput): Promise<{
-        userId: string;
-        success: boolean;
-        ledgerEntryId: string;
-        availableBefore: string;
-        availableAfter: string;
-        frozenBefore: string;
-        frozenAfter: string;
-        isIdempotent?: boolean;
-    }[]>;
-}
-/**
- * 内部服务
- * 供 Ledger 和其他模块内部调用的余额操作接口
- * 不暴露给用户/管理员路由，不涉及权限控制
- */
-export declare abstract class InternalWalletService extends WalletBaseService {
-    /**
-     * 获取或创建用户余额记录
-     * 内部调用，带行级锁保证并发安全
-     */
-    static getOrCreateUserWallet: typeof getOrCreateUserWallet;
-    /**
-     * 更新余额（通用方法，由 Ledger 调用）
-     * 使用乐观锁确保并发安全
-     */
-    static updateBalance(tx: TransactionTx, balanceId: string, version: number, updates: {
-        available?: string;
-        frozen?: string;
-    }): Promise<void>;
+    }>;
 }
 export {};