@r2wa-org/eden 0.0.48

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

@@ -0,0 +1,294 @@
+import type { TransactionTx } from "../db/transaction";
+import type { UserAdminSearchQuerySchemaType, UserProfileAdminListQuerySchemaType, UserProfileAdminUpdateSchemaType, UserProfileUpsertSchemaType } from "./dto.schemas";
+type UpsertUserProfileParams = UserProfileUpsertSchemaType & {
+    userId: string;
+};
+/**
+ * 用户基础服务（抽象类）
+ */
+declare abstract class UserBaseService {
+    protected static validateUserId(userId: string): void;
+    /** 确保用户资料存在，不存在则创建 - 内部方法 */
+    static getOrCreateUserProfile(tx: TransactionTx, userId: string): Promise<{
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        gender: "male" | "female" | "other";
+        uid: string;
+        birthday: string | null;
+        country: string | null;
+        city: string | null;
+        language: string | null;
+        timezone: string | null;
+        referralCode: string | null;
+        referredBy: string | null;
+        deletedAt: Date | null;
+    }>;
+}
+/**
+ * 管理侧服务
+ * 目前无管理侧逻辑，保留此类以保持架构一致性
+ */
+export declare abstract class AdminUserService extends UserBaseService {
+    static resetUserPassword(userId: string, headers: Headers): Promise<{
+        password: string;
+    }>;
+    static searchUsers(query: UserAdminSearchQuerySchemaType): Promise<{
+        data: {
+            id: string;
+            name: string;
+            email: string;
+            emailVerified: boolean;
+            image: string | null;
+            createdAt: Date;
+            updatedAt: Date;
+            twoFactorEnabled: boolean | null;
+            username: string | null;
+            displayUsername: string | null;
+            isAnonymous: boolean | null;
+            phoneNumber: string | null;
+            phoneNumberVerified: boolean | null;
+            role: string | null;
+            banned: boolean | null;
+            banReason: string | null;
+            banExpires: Date | null;
+        }[];
+        pagination: {
+            pageSize: number;
+            pageIndex: number;
+            total: number;
+            totalPages: number;
+            hasNextPage: boolean;
+        };
+    }>;
+    static listProfiles(query: UserProfileAdminListQuerySchemaType): Promise<{
+        data: {
+            userProfile: {
+                deletedAt: Date | null;
+                createdAt: Date;
+                updatedAt: Date;
+                userId: string;
+                uid: string;
+                gender: "male" | "female" | "other";
+                birthday: string | null;
+                country: string | null;
+                city: string | null;
+                language: string | null;
+                timezone: string | null;
+                referralCode: string | null;
+                referredBy: string | null;
+            } | undefined;
+            userKycMethod: {
+                deletedAt: Date | null;
+                createdAt: Date;
+                updatedAt: Date;
+                id: string;
+                userId: string;
+                method: "passport" | "id_card" | "selfie" | "utility_bill";
+                documentName: string | null;
+                documentNumber: string | null;
+                fileId1: string | null;
+                fileId2: string | null;
+                fileId3: string | null;
+                fileId4: string | null;
+                status: "unverified" | "pending" | "approved" | "rejected";
+                submittedAt: Date | null;
+                reviewedAt: Date | null;
+                reviewedBy: string | null;
+                rejectionReason: string | null;
+            } | undefined;
+            id: string;
+            name: string;
+            email: string;
+            emailVerified: boolean;
+            image: string | null;
+            createdAt: Date;
+            updatedAt: Date;
+            twoFactorEnabled: boolean | null;
+            username: string | null;
+            displayUsername: string | null;
+            isAnonymous: boolean | null;
+            phoneNumber: string | null;
+            phoneNumberVerified: boolean | null;
+            role: string | null;
+            banned: boolean | null;
+            banReason: string | null;
+            banExpires: Date | null;
+        }[];
+        pagination: {
+            pageSize: number;
+            pageIndex: number;
+            total: number;
+            totalPages: number;
+            hasNextPage: boolean;
+        };
+    }>;
+    static getProfile(userId: string): Promise<{
+        userProfile: {
+            deletedAt: Date | null;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            uid: string;
+            gender: "male" | "female" | "other";
+            birthday: string | null;
+            country: string | null;
+            city: string | null;
+            language: string | null;
+            timezone: string | null;
+            referralCode: string | null;
+            referredBy: string | null;
+        };
+        id: string;
+        name: string;
+        email: string;
+        emailVerified: boolean;
+        image: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+        twoFactorEnabled: boolean | null;
+        username: string | null;
+        displayUsername: string | null;
+        isAnonymous: boolean | null;
+        phoneNumber: string | null;
+        phoneNumberVerified: boolean | null;
+        role: string | null;
+        banned: boolean | null;
+        banReason: string | null;
+        banExpires: Date | null;
+    }>;
+    static updateProfile(userId: string, payload: UserProfileAdminUpdateSchemaType): Promise<{
+        userProfile: {
+            deletedAt: Date | null;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            uid: string;
+            gender: "male" | "female" | "other";
+            birthday: string | null;
+            country: string | null;
+            city: string | null;
+            language: string | null;
+            timezone: string | null;
+            referralCode: string | null;
+            referredBy: string | null;
+        };
+        id: string;
+        name: string;
+        email: string;
+        emailVerified: boolean;
+        image: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+        twoFactorEnabled: boolean | null;
+        username: string | null;
+        displayUsername: string | null;
+        isAnonymous: boolean | null;
+        phoneNumber: string | null;
+        phoneNumberVerified: boolean | null;
+        role: string | null;
+        banned: boolean | null;
+        banReason: string | null;
+        banExpires: Date | null;
+    }>;
+}
+/**
+ * 用户侧服务
+ * 用户端调用的业务逻辑，获取和修改个人资料
+ */
+export declare abstract class UserUserService extends UserBaseService {
+    /** 获取当前用户信息（含资料） */
+    static getUserWithProfile(userId: string): Promise<{
+        profile: {
+            deletedAt: Date | null;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            uid: string;
+            gender: "male" | "female" | "other";
+            birthday: string | null;
+            country: string | null;
+            city: string | null;
+            language: string | null;
+            timezone: string | null;
+            referralCode: string | null;
+            referredBy: string | null;
+        };
+        id: string;
+        name: string;
+        email: string;
+        emailVerified: boolean;
+        image: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+        twoFactorEnabled: boolean | null;
+        username: string | null;
+        displayUsername: string | null;
+        isAnonymous: boolean | null;
+        phoneNumber: string | null;
+        phoneNumberVerified: boolean | null;
+        role: string | null;
+        banned: boolean | null;
+        banReason: string | null;
+        banExpires: Date | null;
+    }>;
+    /** 获取用户个人资料 */
+    static getUserProfile(userId: string): Promise<{
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        gender: "male" | "female" | "other";
+        uid: string;
+        birthday: string | null;
+        country: string | null;
+        city: string | null;
+        language: string | null;
+        timezone: string | null;
+        referralCode: string | null;
+        referredBy: string | null;
+        deletedAt: Date | null;
+        user: {
+            email: string;
+            id: string;
+            name: string;
+            emailVerified: boolean;
+            image: string | null;
+            createdAt: Date;
+            updatedAt: Date;
+            twoFactorEnabled: boolean | null;
+            username: string | null;
+            displayUsername: string | null;
+            isAnonymous: boolean | null;
+            phoneNumber: string | null;
+            phoneNumberVerified: boolean | null;
+            role: string | null;
+            banned: boolean | null;
+            banReason: string | null;
+            banExpires: Date | null;
+        };
+    }>;
+    /** 创建或更新用户个人资料（保持 referredBy 只允许首绑且不可为本人） */
+    static upsertUserProfile(params: UpsertUserProfileParams): Promise<{
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        gender: "male" | "female" | "other";
+        uid: string;
+        birthday: string | null;
+        country: string | null;
+        city: string | null;
+        language: string | null;
+        timezone: string | null;
+        referralCode: string | null;
+        referredBy: string | null;
+        deletedAt: Date | null;
+    }>;
+}
+/**
+ * 内部服务
+ * 供其他模块内部调用的业务逻辑，无权限控制，只提供纯业务方法
+ * 跨模块权限在调用点由各模块自行处理
+ */
+export declare abstract class InternalUserService extends UserBaseService {
+}
+export {};