@r2wa-org/eden 0.0.48

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

@@ -0,0 +1,347 @@
+/**
+ * 通知类型枚举
+ */
+export declare const notificationTypeEnum: import("drizzle-orm/pg-core").PgEnum<["system", "transaction", "activity", "security"]>;
+/**
+ * 通知优先级枚举
+ */
+export declare const notificationPriorityEnum: import("drizzle-orm/pg-core").PgEnum<["low", "normal", "high", "urgent"]>;
+/**
+ * 收件箱状态枚举
+ */
+export declare const notificationInboxStatusEnum: import("drizzle-orm/pg-core").PgEnum<["unread", "read", "archived", "deleted"]>;
+/**
+ * 通知内容表
+ * 存储通知的实际内容，一条通知可以发送给多个用户
+ */
+export declare const notification: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "notification";
+    schema: undefined;
+    columns: {
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "notification";
+            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: "notification";
+            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: "notification";
+            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;
+        }, {}, {}>;
+        type: import("drizzle-orm/pg-core").PgColumn<{
+            name: "type";
+            tableName: "notification";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "system" | "transaction" | "activity" | "security";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["system", "transaction", "activity", "security"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        category: import("drizzle-orm/pg-core").PgColumn<{
+            name: "category";
+            tableName: "notification";
+            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;
+        }, {}, {}>;
+        title: import("drizzle-orm/pg-core").PgColumn<{
+            name: "title";
+            tableName: "notification";
+            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;
+        }, {}, {}>;
+        content: import("drizzle-orm/pg-core").PgColumn<{
+            name: "content";
+            tableName: "notification";
+            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;
+        }, {}, {}>;
+        priority: import("drizzle-orm/pg-core").PgColumn<{
+            name: "priority";
+            tableName: "notification";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "normal" | "low" | "high" | "urgent";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["low", "normal", "high", "urgent"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        isBroadcast: import("drizzle-orm/pg-core").PgColumn<{
+            name: "is_broadcast";
+            tableName: "notification";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        expiresAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "expires_at";
+            tableName: "notification";
+            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";
+}>;
+/**
+ * 用户收件箱表
+ * 存储每个用户与通知的关系及状态
+ */
+export declare const notificationInbox: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "notification_inbox";
+    schema: undefined;
+    columns: {
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "notification_inbox";
+            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: "notification_inbox";
+            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: "notification_inbox";
+            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;
+        }, {}, {}>;
+        notificationId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "notification_id";
+            tableName: "notification_inbox";
+            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;
+        }, {}, {}>;
+        userId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "user_id";
+            tableName: "notification_inbox";
+            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;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "notification_inbox";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "archived" | "unread" | "read" | "deleted";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["unread", "read", "archived", "deleted"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        readAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "read_at";
+            tableName: "notification_inbox";
+            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;
+        }, {}, {}>;
+        archivedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "archived_at";
+            tableName: "notification_inbox";
+            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";
+}>;
+export declare const notificationRelations: import("drizzle-orm").Relations<"notification", {
+    inboxes: import("drizzle-orm").Many<"notification_inbox">;
+}>;
+export declare const notificationInboxRelations: import("drizzle-orm").Relations<"notification_inbox", {
+    notification: import("drizzle-orm").One<"notification", true>;
+    user: import("drizzle-orm").One<"user", true>;
+}>;

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

@@ -0,0 +1,195 @@
+import type { PgTransaction } from "drizzle-orm/pg-core";
+import type { NotificationBatchReadInputType, NotificationCreateInputType, NotificationListQueryType, NotificationStatsResponseType } from "./dto.schemas";
+import { notification } from "./schema";
+/**
+ * 通知基础服务（抽象类）
+ * 提供共享的验证方法
+ */
+declare abstract class BaseNotificationService {
+    protected static validateUserId(userId: string): void;
+    protected static validateNotificationId(notificationId: string): void;
+}
+/**
+ * 用户侧通知服务
+ * 用户可以查看自己的通知、标记已读
+ */
+export declare abstract class UserNotificationService extends BaseNotificationService {
+    /**
+     * 查询用户的通知列表（包含系统广播）
+     */
+    static listNotifications(userId: string, filters?: NotificationListQueryType): Promise<{
+        data: {
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            status: "archived" | "unread" | "read" | "deleted";
+            archivedAt: Date | null;
+            notificationId: string;
+            readAt: Date | null;
+            notification: {
+                type: "system" | "transaction" | "activity" | "security";
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                expiresAt: Date | null;
+                category: string;
+                title: string;
+                content: string;
+                priority: "normal" | "low" | "high" | "urgent";
+                isBroadcast: boolean;
+            };
+        }[];
+        pagination: {
+            pageSize: number;
+            pageIndex: number;
+            total: number;
+            totalPages: number;
+            hasNextPage: boolean;
+        };
+    }>;
+    /**
+     * 获取通知详情
+     */
+    static getNotification(inboxId: string, userId: string): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        status: "archived" | "unread" | "read" | "deleted";
+        archivedAt: Date | null;
+        notificationId: string;
+        readAt: Date | null;
+        notification: {
+            type: "system" | "transaction" | "activity" | "security";
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            expiresAt: Date | null;
+            category: string;
+            title: string;
+            content: string;
+            priority: "normal" | "low" | "high" | "urgent";
+            isBroadcast: boolean;
+        };
+    }>;
+    /**
+     * 标记通知为已读
+     */
+    static markAsRead(notificationInboxId: string, userId: string): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        status: "archived" | "unread" | "read" | "deleted";
+        archivedAt: Date | null;
+        notificationId: string;
+        readAt: Date | null;
+    } | {
+        createdAt: Date;
+        updatedAt: Date;
+        id: string;
+        notificationId: string;
+        userId: string;
+        status: "archived" | "unread" | "read" | "deleted";
+        readAt: Date | null;
+        archivedAt: Date | null;
+    }[]>;
+    /**
+     * 批量标记已读
+     */
+    static batchMarkAsRead(userId: string, input: NotificationBatchReadInputType): Promise<{
+        count: number;
+    }>;
+    /**
+     * 获取未读通知数量
+     */
+    static getUnreadCount(userId: string): Promise<number>;
+}
+/**
+ * 管理员通知服务
+ * 管理员可以创建通知、查看所有通知、查看统计
+ */
+export declare abstract class AdminNotificationService extends BaseNotificationService {
+    /**
+     * 创建通知并发送给指定用户
+     */
+    static createNotification(data: NotificationCreateInputType): Promise<{
+        type: "system" | "transaction" | "activity" | "security";
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        expiresAt: Date | null;
+        category: string;
+        title: string;
+        content: string;
+        priority: "normal" | "low" | "high" | "urgent";
+        isBroadcast: boolean;
+    }>;
+    /**
+     * 为广播通知创建所有用户的 inbox 记录（异步）
+     */
+    private static createBroadcastInboxAsync;
+    /**
+     * 查询通知列表（管理员视角，查看所有通知内容）
+     */
+    static listNotifications(filters?: NotificationListQueryType): Promise<{
+        data: {
+            sentCount: number;
+            readCount: number;
+            status: "unread";
+            readAt: null;
+            createdAt: Date;
+            updatedAt: Date;
+            id: string;
+            type: "system" | "transaction" | "activity" | "security";
+            category: string;
+            title: string;
+            content: string;
+            priority: "normal" | "low" | "high" | "urgent";
+            isBroadcast: boolean;
+            expiresAt: Date | null;
+        }[];
+        pagination: {
+            pageSize: number;
+            pageIndex: number;
+            total: number;
+            totalPages: number;
+            hasNextPage: boolean;
+        };
+    }>;
+    /**
+     * 获取统计数据
+     */
+    static getStats(): Promise<NotificationStatsResponseType>;
+}
+/**
+ * 内部通知服务
+ * 供其他模块内部调用的业务逻辑，无权限控制
+ */
+export declare abstract class InternalNotificationService extends BaseNotificationService {
+    /**
+     * 创建单用户通知并写入收件箱
+     */
+    static createUserNotification(tx: PgTransaction<any, any, any>, data: {
+        userId: string;
+        type: (typeof notification.$inferInsert)["type"];
+        category: string;
+        title: string;
+        content: string;
+        priority?: (typeof notification.$inferInsert)["priority"];
+        expiresAt?: Date | null | undefined;
+    }): Promise<{
+        type: "system" | "transaction" | "activity" | "security";
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        expiresAt: Date | null;
+        category: string;
+        title: string;
+        content: string;
+        priority: "normal" | "low" | "high" | "urgent";
+        isBroadcast: boolean;
+    }>;
+}
+export {};