@r2wa-org/eden 0.0.48

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

@@ -0,0 +1,152 @@
+/**
+ * 用户余额表
+ * 记录用户余额
+ * 通过 Ledger 驱动更新，保证数据一致性
+ */
+export declare const userWallet: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "user_wallet";
+    schema: undefined;
+    columns: {
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "user_wallet";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "user_wallet";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "user_wallet";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        userId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "user_id";
+            tableName: "user_wallet";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        walletTypeId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "wallet_type_id";
+            tableName: "user_wallet";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        available: import("drizzle-orm/pg-core").PgColumn<{
+            name: "available";
+            tableName: "user_wallet";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        frozen: import("drizzle-orm/pg-core").PgColumn<{
+            name: "frozen";
+            tableName: "user_wallet";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        version: import("drizzle-orm/pg-core").PgColumn<{
+            name: "version";
+            tableName: "user_wallet";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const userBalanceRelations: import("drizzle-orm").Relations<"user_wallet", {
+    user: import("drizzle-orm").One<"user", true>;
+    walletType: import("drizzle-orm").One<"wallet_type", true>;
+}>;

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

@@ -0,0 +1,225 @@
+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: {
+            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;
+        };
+    }>;
+    static getWalletByCode(userId: string, walletCode: WalletTypeCodeType): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        walletTypeId: string;
+        available: string;
+        frozen: string;
+        version: number;
+        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;
+            isActive: boolean;
+            sortOrder: number;
+        };
+    }>;
+    /**
+     * 获取用户所有钱包（含钱包类型信息）
+     */
+    static getWalletsWithType(userId: string): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        walletTypeId: string;
+        available: string;
+        frozen: string;
+        version: number;
+        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;
+            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;
+    }[]>;
+}
+/**
+ * 管理侧服务
+ * 提供管理员查询任意用户余额的功能
+ */
+export declare abstract class AdminWalletService extends WalletBaseService {
+    static getWalletsWithType(userId: string): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        walletTypeId: string;
+        available: string;
+        frozen: string;
+        version: number;
+        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;
+            isActive: boolean;
+            sortOrder: number;
+        };
+    }[]>;
+    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 {};