@r2wa-org/eden 0.0.48

package/dist/src/user-kyc/schema.d.ts

@@ -0,0 +1,474 @@
+/** KYC 状态枚举 */
+export declare const kycStatusEnum: import("drizzle-orm/pg-core").PgEnum<["unverified", "pending", "approved", "rejected"]>;
+/** KYC 认证方式枚举 */
+export declare const kycMethodEnum: import("drizzle-orm/pg-core").PgEnum<["passport", "id_card", "selfie", "utility_bill"]>;
+/** 用户 KYC 主表（仅记录等级） */
+export declare const userKyc: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "user_kyc";
+    schema: undefined;
+    columns: {
+        deletedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "deleted_at";
+            tableName: "user_kyc";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "user_kyc";
+            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_kyc";
+            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;
+        }, {}, {}>;
+        userId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "user_id";
+            tableName: "user_kyc";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        kycLevel: import("drizzle-orm/pg-core").PgColumn<{
+            name: "kyc_level";
+            tableName: "user_kyc";
+            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;
+        }, {}, {}>;
+        currentMethod: import("drizzle-orm/pg-core").PgColumn<{
+            name: "current_method";
+            tableName: "user_kyc";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "passport" | "id_card" | "selfie" | "utility_bill";
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["passport", "id_card", "selfie", "utility_bill"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lastApprovedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "last_approved_at";
+            tableName: "user_kyc";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lastRejectedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "last_rejected_at";
+            tableName: "user_kyc";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lastSubmittedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "last_submitted_at";
+            tableName: "user_kyc";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+/** KYC 认证方式表 */
+export declare const userKycMethod: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "user_kyc_method";
+    schema: undefined;
+    columns: {
+        deletedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "deleted_at";
+            tableName: "user_kyc_method";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "user_kyc_method";
+            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_kyc_method";
+            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_kyc_method";
+            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_kyc_method";
+            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;
+        }, {}, {}>;
+        method: import("drizzle-orm/pg-core").PgColumn<{
+            name: "method";
+            tableName: "user_kyc_method";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "passport" | "id_card" | "selfie" | "utility_bill";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["passport", "id_card", "selfie", "utility_bill"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        documentName: import("drizzle-orm/pg-core").PgColumn<{
+            name: "document_name";
+            tableName: "user_kyc_method";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        documentNumber: import("drizzle-orm/pg-core").PgColumn<{
+            name: "document_number";
+            tableName: "user_kyc_method";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fileId1: import("drizzle-orm/pg-core").PgColumn<{
+            name: "file_id_1";
+            tableName: "user_kyc_method";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fileId2: import("drizzle-orm/pg-core").PgColumn<{
+            name: "file_id_2";
+            tableName: "user_kyc_method";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fileId3: import("drizzle-orm/pg-core").PgColumn<{
+            name: "file_id_3";
+            tableName: "user_kyc_method";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fileId4: import("drizzle-orm/pg-core").PgColumn<{
+            name: "file_id_4";
+            tableName: "user_kyc_method";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "user_kyc_method";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "unverified" | "pending" | "approved" | "rejected";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["unverified", "pending", "approved", "rejected"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        submittedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "submitted_at";
+            tableName: "user_kyc_method";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        reviewedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "reviewed_at";
+            tableName: "user_kyc_method";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        reviewedBy: import("drizzle-orm/pg-core").PgColumn<{
+            name: "reviewed_by";
+            tableName: "user_kyc_method";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        rejectionReason: import("drizzle-orm/pg-core").PgColumn<{
+            name: "rejection_reason";
+            tableName: "user_kyc_method";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const userKycRelations: import("drizzle-orm").Relations<"user_kyc", {
+    user: import("drizzle-orm").One<"user", true>;
+    methods: import("drizzle-orm").Many<"user_kyc_method">;
+}>;
+export declare const userKycMethodRelations: import("drizzle-orm").Relations<"user_kyc_method", {
+    user: import("drizzle-orm").One<"user", true>;
+    file1: import("drizzle-orm").One<"file_storage", false>;
+    file2: import("drizzle-orm").One<"file_storage", false>;
+    file3: import("drizzle-orm").One<"file_storage", false>;
+    file4: import("drizzle-orm").One<"file_storage", false>;
+    kyc: import("drizzle-orm").One<"user_kyc", true>;
+}>;

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

@@ -0,0 +1,170 @@
+import type { KycMethodAdminApproveSchemaType, KycMethodAdminListQuerySchemaType, KycMethodAdminRejectSchemaType, KycMethodParamsSchemaType, KycMethodSubmitSchemaType } from "./dto.schemas";
+/**
+ * KYC 基础服务（抽象类）
+ */
+declare abstract class BaseUserKycService {
+    protected static validateUserId(userId: string): void;
+    protected static ensureIdCardFields(method: KycMethodParamsSchemaType["kycMethod"], payload: KycMethodSubmitSchemaType): void;
+    protected static ensureStatusEditable(status: "unverified" | "pending" | "approved" | "rejected"): void;
+}
+/**
+ * 用户侧 KYC 服务
+ */
+export declare abstract class UserUserKycService extends BaseUserKycService {
+    static submitMethod(userId: string, method: KycMethodParamsSchemaType["kycMethod"], payload: KycMethodSubmitSchemaType): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        deletedAt: Date | null;
+        status: "unverified" | "pending" | "approved" | "rejected";
+        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;
+        submittedAt: Date | null;
+        reviewedAt: Date | null;
+        reviewedBy: string | null;
+        rejectionReason: string | null;
+    }>;
+    static getMethod(userId: string, method: KycMethodParamsSchemaType["kycMethod"]): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        deletedAt: Date | null;
+        status: "unverified" | "pending" | "approved" | "rejected";
+        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;
+        submittedAt: Date | null;
+        reviewedAt: Date | null;
+        reviewedBy: string | null;
+        rejectionReason: string | null;
+    }>;
+    static updateMethod(userId: string, method: KycMethodParamsSchemaType["kycMethod"], payload: KycMethodSubmitSchemaType): Promise<{
+        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;
+    }>;
+    static isMethodVerified(userId: string, method: KycMethodParamsSchemaType["kycMethod"]): Promise<{
+        verified: boolean;
+    }>;
+}
+/**
+ * 管理侧 KYC 服务
+ */
+export declare abstract class AdminUserKycService extends BaseUserKycService {
+    static listMethods(query: KycMethodAdminListQuerySchemaType): Promise<{
+        data: {
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            deletedAt: Date | null;
+            status: "unverified" | "pending" | "approved" | "rejected";
+            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;
+            submittedAt: Date | null;
+            reviewedAt: Date | null;
+            reviewedBy: string | null;
+            rejectionReason: string | null;
+        }[];
+        pagination: {
+            pageSize: number;
+            pageIndex: number;
+            total: number;
+            totalPages: number;
+            hasNextPage: boolean;
+        };
+    }>;
+    static getMethod(id: string): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        deletedAt: Date | null;
+        status: "unverified" | "pending" | "approved" | "rejected";
+        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;
+        submittedAt: Date | null;
+        reviewedAt: Date | null;
+        reviewedBy: string | null;
+        rejectionReason: string | null;
+    }>;
+    static approveMethod(id: string, reviewerId: string, input: KycMethodAdminApproveSchemaType): Promise<{
+        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;
+    }>;
+    static rejectMethod(id: string, reviewerId: string, input: KycMethodAdminRejectSchemaType): Promise<{
+        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;
+    }>;
+}
+/**
+ * 内部 KYC 服务（预留扩展）
+ */
+export declare abstract class InternalUserKycService extends BaseUserKycService {
+}
+export {};