@r2wa-org/eden 0.0.48

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

@@ -0,0 +1,235 @@
+/**
+ * 邀请关系闭包表
+ * 记录任意祖先-后代关系及层级深度
+ */
+export declare const referralRelation: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "referral_relation";
+    schema: undefined;
+    columns: {
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "referral_relation";
+            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: "referral_relation";
+            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: "referral_relation";
+            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;
+        }, {}, {}>;
+        ancestorId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "ancestor_id";
+            tableName: "referral_relation";
+            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;
+        }, {}, {}>;
+        descendantId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "descendant_id";
+            tableName: "referral_relation";
+            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;
+        }, {}, {}>;
+        depth: import("drizzle-orm/pg-core").PgColumn<{
+            name: "depth";
+            tableName: "referral_relation";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+/**
+ * 邀请绑定日志
+ * 记录用户首次绑定邀请关系的审计日志
+ */
+export declare const referralBindLog: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "referral_bind_log";
+    schema: undefined;
+    columns: {
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "referral_bind_log";
+            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: "referral_bind_log";
+            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: "referral_bind_log";
+            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: "referral_bind_log";
+            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;
+        }, {}, {}>;
+        inviterId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "inviter_id";
+            tableName: "referral_bind_log";
+            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;
+        }, {}, {}>;
+        referralCode: import("drizzle-orm/pg-core").PgColumn<{
+            name: "referral_code";
+            tableName: "referral_bind_log";
+            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;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const referralRelationRelations: import("drizzle-orm").Relations<"referral_relation", {
+    ancestor: import("drizzle-orm").One<"user", true>;
+    descendant: import("drizzle-orm").One<"user", true>;
+    depthConfig: import("drizzle-orm").One<"referral_depth_config", true>;
+}>;
+export declare const referralBindLogRelations: import("drizzle-orm").Relations<"referral_bind_log", {
+    user: import("drizzle-orm").One<"user", true>;
+    inviter: import("drizzle-orm").One<"user", true>;
+}>;

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

@@ -0,0 +1,42 @@
+import type { ReferralAdminQueryType, ReferralAdminSummaryType, ReferralBindInputType, ReferralBindResponseType, ReferralCodeCheckResponseType, ReferralMemberListQueryType, ReferralMemberListResponseType, ReferralSummaryType } from "./dto.schemas";
+/**
+ * 邀请基础服务（抽象类）
+ */
+declare abstract class BaseReferralService {
+    /** 绑定邀请码 */
+    static bindByCode(userId: string, payload: ReferralBindInputType): Promise<ReferralBindResponseType>;
+    protected static validateUserId(userId: string): void;
+    protected static ensureSelfRelation(tx: any, userId: string): Promise<void>;
+    protected static getSummaryInternal(userId: string): Promise<ReferralSummaryType>;
+}
+/**
+ * 用户侧服务
+ */
+export declare abstract class UserReferralService extends BaseReferralService {
+    /** 检查邀请码是否存在且有效 */
+    static checkReferralCode(referralCode: string): Promise<ReferralCodeCheckResponseType>;
+    /** 获取邀请概览 */
+    static getSummary(userId: string): Promise<{
+        referredBy?: string | undefined;
+        referralCode: string;
+        level1Count: number;
+        level2Count: number;
+        level3Count: number;
+        totalCount: number;
+    }>;
+    /** 获取被我邀请的成员列表 */
+    static listMembers(userId: string, query: ReferralMemberListQueryType): Promise<ReferralMemberListResponseType>;
+}
+/**
+ * 管理侧服务
+ */
+export declare abstract class AdminReferralService extends BaseReferralService {
+    static getSummaryByReferralCode(referralCode: string): Promise<ReferralAdminSummaryType>;
+    static listMembersByReferralCode(query: ReferralAdminQueryType): Promise<ReferralMemberListResponseType>;
+}
+/**
+ * 内部服务
+ */
+export declare abstract class InternalReferralService extends BaseReferralService {
+}
+export {};