@ruiapp/rapid-core 0.2.13 → 0.3.0

package/dist/core/routeContext.d.ts

@@ -4,7 +4,6 @@ import { HttpStatus } from "./http-types";
 import { IRpdServer } from "./server";
 export type Next = () => Promise<void>;
 export declare class RouteContext {
-    #private;
     readonly request: RapidRequest;
     readonly response: RapidResponse;
     readonly state: Record<string, any>;
@@ -12,7 +11,8 @@ export declare class RouteContext {
     path: string;
     params: Record<string, string>;
     routeConfig: any;
-    constructor(server: IRpdServer, request: RapidRequest);
+    static newSystemOperationContext(server: IRpdServer): RouteContext;
+    constructor(server: IRpdServer, request?: RapidRequest);
     set(headerName: string, headerValue: string): void;
     json(obj: any, status?: HttpStatus, headers?: HeadersInit): void;
     redirect(url: string, status?: HttpStatus): void;

package/dist/index.d.ts

@@ -16,6 +16,10 @@ export * from "./plugins/sequence/SequencePluginTypes";
 export { default as WebhooksPlugin } from "./plugins/webhooks/WebhooksPlugin";
 export { default as AuthPlugin } from "./plugins/auth/AuthPlugin";
 export { default as FileManagePlugin } from "./plugins/fileManage/FileManagePlugin";
+export { default as MailPlugin } from "./plugins/mail/MailPlugin";
+export * from "./plugins/mail/MailPluginTypes";
+export { default as NotificationPlugin } from "./plugins/notification/NotificationPlugin";
+export * from "./plugins/notification/NotificationPluginTypes";
 export { default as ServerOperationPlugin } from "./plugins/serverOperation/ServerOperationPlugin";
 export * from "./plugins/serverOperation/ServerOperationPluginTypes";
 export { default as SettingPlugin } from "./plugins/setting/SettingPlugin";

package/dist/index.js

@@ -13,6 +13,7 @@ var bcrypt = require('bcrypt');
 var path = require('path');
 var fs = require('fs');
 var uuid = require('uuid');
+var nodemailer = require('nodemailer');
 var cron = require('cron');
 var xstate = require('xstate');
 
@@ -43,6 +44,7 @@ var crypto__default = /*#__PURE__*/_interopDefaultLegacy(crypto);
 var bcrypt__default = /*#__PURE__*/_interopDefaultLegacy(bcrypt);
 var path__default = /*#__PURE__*/_interopDefaultLegacy(path);
 var fs__default = /*#__PURE__*/_interopDefaultLegacy(fs);
+var nodemailer__default = /*#__PURE__*/_interopDefaultLegacy(nodemailer);
 var cron__namespace = /*#__PURE__*/_interopNamespace(cron);
 
 function fixBigIntJSONSerialize() {
@@ -1040,7 +1042,6 @@ class RapidResponse {
 }
 
 class RouteContext {
-    #logger;
     request;
     response;
     state;
@@ -1048,14 +1049,18 @@ class RouteContext {
     path;
     params;
     routeConfig;
+    static newSystemOperationContext(server) {
+        return new RouteContext(server);
+    }
     constructor(server, request) {
-        this.#logger = server.getLogger();
         this.request = request;
         this.state = {};
         this.response = new RapidResponse();
         // `method` and `path` are used by `koa-tree-router` to match route
-        this.method = request.method;
-        this.path = request.url.pathname;
+        if (this.request) {
+            this.method = request.method;
+            this.path = request.url.pathname;
+        }
     }
     // `koa-tree-router` uses this method to set headers
     set(headerName, headerValue) {
@@ -2548,11 +2553,16 @@ async function findEntities(server, dataAccessor, options) {
     return entities;
 }
 async function findEntity(server, dataAccessor, options) {
-    const entities = await findEntities(server, dataAccessor, options);
+    const entities = await findEntities(server, dataAccessor, {
+        ...options,
+        ...{
+            limit: 1,
+        },
+    });
     return lodash.first(entities);
 }
 async function findById(server, dataAccessor, options) {
-    const { id, properties, keepNonPropertyFields, routeContext } = options;
+    const { id, properties, relations, keepNonPropertyFields, routeContext } = options;
     return await findEntity(server, dataAccessor, {
         filters: [
             {
@@ -2562,6 +2572,7 @@ async function findById(server, dataAccessor, options) {
             },
         ],
         properties,
+        relations,
         keepNonPropertyFields,
         routeContext,
     });
@@ -5361,7 +5372,7 @@ var generateSn$1 = /*#__PURE__*/Object.freeze({
   handler: handler$e
 });
 
-var pluginActionHandlers$5 = [generateSn$1];
+var pluginActionHandlers$7 = [generateSn$1];
 
 var SequenceRule = {
     maintainedBy: "sequencePlugin",
@@ -5452,7 +5463,7 @@ var SequenceAutoIncrementRecord = {
     ],
 };
 
-var pluginModels$3 = [SequenceRule, SequenceAutoIncrementRecord];
+var pluginModels$5 = [SequenceRule, SequenceAutoIncrementRecord];
 
 var generateSn = {
     namespace: "svc",
@@ -5468,7 +5479,7 @@ var generateSn = {
     ],
 };
 
-var pluginRoutes$5 = [generateSn];
+var pluginRoutes$7 = [generateSn];
 
 const segmentType$5 = "literal";
 async function resolveSegmentValue$5(server, ruleCode, config, input) {
@@ -5664,7 +5675,7 @@ class SequenceService {
 /**
  * Sequence plugin
  */
-class SequencePlugin {
+class SequencePlugin$1 {
     #sequenceService;
     get sequenceService() {
         return this.#sequenceService;
@@ -5685,19 +5696,19 @@ class SequencePlugin {
         return [];
     }
     async registerActionHandlers(server) {
-        for (const actionHandler of pluginActionHandlers$5) {
+        for (const actionHandler of pluginActionHandlers$7) {
             server.registerActionHandler(this, actionHandler);
         }
     }
     async configureModels(server, applicationConfig) {
-        server.appendApplicationConfig({ models: pluginModels$3 });
+        server.appendApplicationConfig({ models: pluginModels$5 });
     }
     async configureServices(server, applicationConfig) {
         this.#sequenceService = new SequenceService(server);
         server.registerService("sequenceService", this.#sequenceService);
     }
     async configureRoutes(server, applicationConfig) {
-        server.appendApplicationConfig({ routes: pluginRoutes$5 });
+        server.appendApplicationConfig({ routes: pluginRoutes$7 });
     }
     async onApplicationLoaded(server, applicationConfig) {
         const models = server.getApplicationConfig().models;
@@ -6118,7 +6129,7 @@ var resetPassword$1 = /*#__PURE__*/Object.freeze({
   handler: handler$9
 });
 
-var pluginActionHandlers$4 = [changePassword$1, createSession, deleteSession, getMyProfile$2, resetPassword$1];
+var pluginActionHandlers$6 = [changePassword$1, createSession, deleteSession, getMyProfile$2, resetPassword$1];
 
 var AccessToken = {
     maintainedBy: "authManager",
@@ -6175,7 +6186,7 @@ var AccessToken = {
     ],
 };
 
-var pluginModels$2 = [AccessToken];
+var pluginModels$4 = [AccessToken];
 
 var changePassword = {
     namespace: "auth",
@@ -6247,7 +6258,7 @@ var signout$1 = {
     ],
 };
 
-var pluginRoutes$4 = [changePassword, getMyProfile$1, resetPassword, signin$1, signout$1];
+var pluginRoutes$6 = [changePassword, getMyProfile$1, resetPassword, signin$1, signout$1];
 
 /**
  * Auth manager plugin
@@ -6269,15 +6280,15 @@ class AuthPlugin {
         return [];
     }
     async registerActionHandlers(server) {
-        for (const actionHandler of pluginActionHandlers$4) {
+        for (const actionHandler of pluginActionHandlers$6) {
             server.registerActionHandler(this, actionHandler);
         }
     }
     async configureModels(server, applicationConfig) {
-        server.appendApplicationConfig({ models: pluginModels$2 });
+        server.appendApplicationConfig({ models: pluginModels$4 });
     }
     async configureRoutes(server, applicationConfig) {
-        server.appendApplicationConfig({ routes: pluginRoutes$4 });
+        server.appendApplicationConfig({ routes: pluginRoutes$6 });
     }
     async onPrepareRouteContext(server, routeContext) {
         const request = routeContext.request;
@@ -6498,7 +6509,7 @@ var signout = {
     ],
 };
 
-var pluginRoutes$3 = [getMyProfile, signin, signout];
+var pluginRoutes$5 = [getMyProfile, signin, signout];
 
 /**
  * File manager plugin
@@ -6524,9 +6535,211 @@ class FileManager {
         server.registerActionHandler(this, downloadFileActionHandler);
         server.registerActionHandler(this, uploadFileActionHandler);
     }
+    async configureRoutes(server, applicationConfig) {
+        server.appendApplicationConfig({ routes: pluginRoutes$5 });
+    }
+}
+
+var pluginActionHandlers$5 = [];
+
+var pluginModels$3 = [];
+
+var pluginRoutes$4 = [];
+
+class MailService {
+    #server;
+    #smtpServer;
+    constructor(server, smtpServer) {
+        this.#server = server;
+        this.#smtpServer = smtpServer;
+    }
+    async sendMail(routeContext, server, options) {
+        const smtpServer = this.#smtpServer;
+        const transporter = nodemailer__default["default"].createTransport({
+            host: smtpServer.host,
+            port: smtpServer.port,
+            secure: smtpServer.secure,
+            auth: {
+                user: smtpServer.username,
+                pass: smtpServer.password,
+            },
+        });
+        const info = await transporter.sendMail({
+            from: options.from,
+            to: options.to,
+            subject: options.subject,
+            text: options.text,
+            html: options.html,
+        });
+        return info;
+    }
+}
+
+/**
+ * Mail plugin
+ */
+class MailPlugin {
+    #mailService;
+    #config;
+    constructor(config) {
+        this.#config = config;
+    }
+    get mailService() {
+        return this.#mailService;
+    }
+    get code() {
+        return "mail";
+    }
+    get description() {
+        return null;
+    }
+    get extendingAbilities() {
+        return [];
+    }
+    get configurableTargets() {
+        return [];
+    }
+    get configurations() {
+        return [];
+    }
+    async registerActionHandlers(server) {
+        for (const actionHandler of pluginActionHandlers$5) {
+            server.registerActionHandler(this, actionHandler);
+        }
+    }
+    async configureModels(server, applicationConfig) {
+        server.appendApplicationConfig({ models: pluginModels$3 });
+    }
+    async configureServices(server, applicationConfig) {
+        this.#mailService = new MailService(server, this.#config.smtpServer);
+        server.registerService("mailService", this.#mailService);
+    }
+    async configureRoutes(server, applicationConfig) {
+        server.appendApplicationConfig({ routes: pluginRoutes$4 });
+    }
+    async onApplicationLoaded(server, applicationConfig) { }
+}
+
+var pluginActionHandlers$4 = [];
+
+var Notification = {
+    maintainedBy: "notification",
+    namespace: "svc",
+    name: "notification",
+    singularCode: "notification",
+    pluralCode: "notifications",
+    schema: "public",
+    tableName: "notifications",
+    properties: [
+        {
+            name: "id",
+            code: "id",
+            columnName: "id",
+            type: "integer",
+            required: true,
+            autoIncrement: true,
+        },
+        {
+            name: "标题",
+            code: "title",
+            columnName: "title",
+            type: "text",
+            required: true,
+        },
+        {
+            name: "内容",
+            code: "content",
+            columnName: "content",
+            type: "text",
+            required: false,
+        },
+        {
+            name: "已读",
+            code: "read",
+            columnName: "read",
+            type: "boolean",
+            required: false,
+            defaultValue: "false",
+        },
+        {
+            name: "详细信息",
+            code: "details",
+            columnName: "details",
+            description: '{"url": "", "actions": [{"text": "", "url": ""}]}',
+            type: "json",
+        },
+        {
+            name: "用户",
+            code: "user",
+            type: "relation",
+            targetSingularCode: "oc_user",
+            targetIdColumnName: "user_id",
+        },
+    ],
+};
+
+var pluginModels$2 = [Notification];
+
+var pluginRoutes$3 = [];
+
+class NotificationService {
+    #server;
+    constructor(server) {
+        this.#server = server;
+    }
+    async sendNotification(routeContext, server, options) {
+        const notificationManager = server.getEntityManager("notification");
+        return await notificationManager.createEntity({
+            routeContext,
+            entity: {
+                title: options.title,
+                content: options.content,
+                details: options.details,
+                user: options.userId,
+            },
+        });
+    }
+}
+
+/**
+ * Notification plugin
+ */
+class SequencePlugin {
+    #notificationService;
+    get notificationService() {
+        return this.#notificationService;
+    }
+    get code() {
+        return "notification";
+    }
+    get description() {
+        return null;
+    }
+    get extendingAbilities() {
+        return [];
+    }
+    get configurableTargets() {
+        return [];
+    }
+    get configurations() {
+        return [];
+    }
+    async registerActionHandlers(server) {
+        for (const actionHandler of pluginActionHandlers$4) {
+            server.registerActionHandler(this, actionHandler);
+        }
+    }
+    async configureModels(server, applicationConfig) {
+        server.appendApplicationConfig({ models: pluginModels$2 });
+    }
+    async configureServices(server, applicationConfig) {
+        this.#notificationService = new NotificationService(server);
+        server.registerService("notificationService", this.#notificationService);
+    }
     async configureRoutes(server, applicationConfig) {
         server.appendApplicationConfig({ routes: pluginRoutes$3 });
     }
+    async onApplicationLoaded(server, applicationConfig) { }
 }
 
 const code$5 = "runServerOperation";
@@ -7825,12 +8038,14 @@ exports.DataManagePlugin = DataManager;
 exports.EntityAccessControlPlugin = EntityAccessControlPlugin;
 exports.FileManagePlugin = FileManager;
 exports.GlobalRequest = GlobalRequest;
+exports.MailPlugin = MailPlugin;
 exports.MetaManagePlugin = MetaManager;
+exports.NotificationPlugin = SequencePlugin;
 exports.RapidRequest = RapidRequest;
 exports.RapidServer = RapidServer;
 exports.RouteContext = RouteContext;
 exports.RouteManagePlugin = RouteManager;
-exports.SequencePlugin = SequencePlugin;
+exports.SequencePlugin = SequencePlugin$1;
 exports.ServerOperationPlugin = ServerOperationPlugin;
 exports.SettingPlugin = SettingPlugin;
 exports.StateMachinePlugin = StateMachinePlugin;

package/dist/plugins/mail/MailPlugin.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Mail plugin
+ */
+import { RpdApplicationConfig } from "../../types";
+import { IRpdServer, RapidPlugin, RpdConfigurationItemOptions, RpdServerPluginConfigurableTargetOptions, RpdServerPluginExtendingAbilities } from "../../core/server";
+import MailService from "./MailService";
+import { MailPluginConfig } from "./MailPluginTypes";
+declare class MailPlugin implements RapidPlugin {
+    #private;
+    constructor(config: MailPluginConfig);
+    get mailService(): MailService;
+    get code(): string;
+    get description(): string;
+    get extendingAbilities(): RpdServerPluginExtendingAbilities[];
+    get configurableTargets(): RpdServerPluginConfigurableTargetOptions[];
+    get configurations(): RpdConfigurationItemOptions[];
+    registerActionHandlers(server: IRpdServer): Promise<any>;
+    configureModels(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any>;
+    configureServices(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any>;
+    configureRoutes(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any>;
+    onApplicationLoaded(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<void>;
+}
+export default MailPlugin;

package/dist/plugins/mail/MailPluginTypes.d.ts

@@ -0,0 +1,24 @@
+export type MailPluginConfig = {
+    smtpServer: RpdMailSmtpServer;
+};
+export type RpdMailSmtpServer = {
+    host: string;
+    port: number;
+    secure: boolean;
+    username: string;
+    password: string;
+};
+export type RpdMail = {
+    from?: string;
+    to?: string;
+    subject?: string;
+    text?: string;
+    html?: string;
+};
+export type SendMailOptions = {
+    from?: string;
+    to?: string;
+    subject?: string;
+    text?: string;
+    html?: string;
+};

package/dist/plugins/mail/MailService.d.ts

@@ -0,0 +1,8 @@
+import { IRpdServer } from "../../core/server";
+import { RpdMailSmtpServer, SendMailOptions } from "./MailPluginTypes";
+import { RouteContext } from "../../core/routeContext";
+export default class MailService {
+    #private;
+    constructor(server: IRpdServer, smtpServer: RpdMailSmtpServer);
+    sendMail(routeContext: RouteContext, server: IRpdServer, options: SendMailOptions): Promise<any>;
+}

package/dist/plugins/mail/actionHandlers/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any[];
+export default _default;

package/dist/plugins/mail/models/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any[];
+export default _default;

package/dist/plugins/mail/routes/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any[];
+export default _default;

package/dist/plugins/notification/NotificationPlugin.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Notification plugin
+ */
+import { RpdApplicationConfig } from "../../types";
+import { IRpdServer, RapidPlugin, RpdConfigurationItemOptions, RpdServerPluginConfigurableTargetOptions, RpdServerPluginExtendingAbilities } from "../../core/server";
+import NotificationService from "./NotificationService";
+declare class SequencePlugin implements RapidPlugin {
+    #private;
+    get notificationService(): NotificationService;
+    get code(): string;
+    get description(): string;
+    get extendingAbilities(): RpdServerPluginExtendingAbilities[];
+    get configurableTargets(): RpdServerPluginConfigurableTargetOptions[];
+    get configurations(): RpdConfigurationItemOptions[];
+    registerActionHandlers(server: IRpdServer): Promise<any>;
+    configureModels(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any>;
+    configureServices(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any>;
+    configureRoutes(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any>;
+    onApplicationLoaded(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<void>;
+}
+export default SequencePlugin;

package/dist/plugins/notification/NotificationPluginTypes.d.ts

@@ -0,0 +1,12 @@
+export type RpdNotification = {
+    id?: number;
+    title: string;
+    content?: string;
+    details?: any;
+};
+export type SendNotificationOptions = {
+    userId: number;
+    title: string;
+    content?: string;
+    details?: any;
+};

package/dist/plugins/notification/NotificationService.d.ts

@@ -0,0 +1,8 @@
+import { IRpdServer } from "../../core/server";
+import { SendNotificationOptions, RpdNotification } from "./NotificationPluginTypes";
+import { RouteContext } from "../../core/routeContext";
+export default class NotificationService {
+    #private;
+    constructor(server: IRpdServer);
+    sendNotification(routeContext: RouteContext, server: IRpdServer, options: SendNotificationOptions): Promise<RpdNotification>;
+}

package/dist/plugins/notification/actionHandlers/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any[];
+export default _default;

package/dist/plugins/notification/models/Notification.d.ts

@@ -0,0 +1,3 @@
+import { RpdDataModel } from "../../../types";
+declare const _default: RpdDataModel;
+export default _default;

package/dist/plugins/notification/models/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("../../..").RpdDataModel[];
+export default _default;

package/dist/plugins/notification/routes/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any[];
+export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruiapp/rapid-core",
-  "version": "0.2.13",
+  "version": "0.3.0",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,6 +11,7 @@
     "@types/jsonwebtoken": "^9.0.5",
     "@types/lodash": "^4.14.186",
     "@types/node": "^20.11.16",
+    "@types/nodemailer": "^6.4.16",
     "rimraf": "^3.0.2",
     "rollup": "^2.79.1",
     "rollup-plugin-tsc-alias": "^1.1.2",
@@ -29,6 +30,7 @@
     "xstate": "^5.13.0"
   },
   "peerDependencies": {
+    "nodemailer": "^6.9.15",
     "winston": "^3.11.0"
   },
   "scripts": {

package/src/core/routeContext.ts

@@ -8,7 +8,6 @@ import { Logger } from "~/facilities/log/LogFacility";
 export type Next = () => Promise<void>;
 
 export class RouteContext {
-  #logger: Logger;
   readonly request: RapidRequest;
   readonly response: RapidResponse;
   readonly state: Record<string, any>;
@@ -17,15 +16,20 @@ export class RouteContext {
   params: Record<string, string>;
   routeConfig: any;
 
-  constructor(server: IRpdServer, request: RapidRequest) {
-    this.#logger = server.getLogger();
+  static newSystemOperationContext(server: IRpdServer) {
+    return new RouteContext(server);
+  }
+
+  constructor(server: IRpdServer, request?: RapidRequest) {
     this.request = request;
     this.state = {};
     this.response = new RapidResponse();
 
     // `method` and `path` are used by `koa-tree-router` to match route
-    this.method = request.method;
-    this.path = request.url.pathname;
+    if (this.request) {
+      this.method = request.method;
+      this.path = request.url.pathname;
+    }
   }
 
   // `koa-tree-router` uses this method to set headers

package/src/dataAccess/entityManager.ts

@@ -347,12 +347,17 @@ async function findEntities(server: IRpdServer, dataAccessor: IRpdDataAccessor,
 }
 
 async function findEntity(server: IRpdServer, dataAccessor: IRpdDataAccessor, options: FindEntityOptions) {
-  const entities = await findEntities(server, dataAccessor, options);
+  const entities = await findEntities(server, dataAccessor, {
+    ...options,
+    ...{
+      limit: 1,
+    },
+  });
   return first(entities);
 }
 
 async function findById(server: IRpdServer, dataAccessor: IRpdDataAccessor, options: FindEntityByIdOptions): Promise<any> {
-  const { id, properties, keepNonPropertyFields, routeContext } = options;
+  const { id, properties, relations, keepNonPropertyFields, routeContext } = options;
   return await findEntity(server, dataAccessor, {
     filters: [
       {
@@ -362,6 +367,7 @@ async function findById(server: IRpdServer, dataAccessor: IRpdDataAccessor, opti
       },
     ],
     properties,
+    relations,
     keepNonPropertyFields,
     routeContext,
   });

package/src/index.ts

@@ -31,6 +31,12 @@ export { default as AuthPlugin } from "./plugins/auth/AuthPlugin";
 
 export { default as FileManagePlugin } from "./plugins/fileManage/FileManagePlugin";
 
+export { default as MailPlugin } from "./plugins/mail/MailPlugin";
+export * from "./plugins/mail/MailPluginTypes";
+
+export { default as NotificationPlugin } from "./plugins/notification/NotificationPlugin";
+export * from "./plugins/notification/NotificationPluginTypes";
+
 export { default as ServerOperationPlugin } from "./plugins/serverOperation/ServerOperationPlugin";
 export * from "./plugins/serverOperation/ServerOperationPluginTypes";
 

package/src/plugins/mail/MailPlugin.ts

@@ -0,0 +1,74 @@
+/**
+ * Mail plugin
+ */
+
+import { RpdApplicationConfig } from "~/types";
+import {
+  IRpdServer,
+  RapidPlugin,
+  RpdConfigurationItemOptions,
+  RpdServerPluginConfigurableTargetOptions,
+  RpdServerPluginExtendingAbilities,
+} from "~/core/server";
+
+import pluginActionHandlers from "./actionHandlers";
+import pluginModels from "./models";
+import pluginRoutes from "./routes";
+import MailService from "./MailService";
+import { MailPluginConfig } from "./MailPluginTypes";
+
+class MailPlugin implements RapidPlugin {
+  #mailService!: MailService;
+  #config: MailPluginConfig;
+
+  constructor(config: MailPluginConfig) {
+    this.#config = config;
+  }
+
+  get mailService() {
+    return this.#mailService;
+  }
+
+  get code(): string {
+    return "mail";
+  }
+
+  get description(): string {
+    return null;
+  }
+
+  get extendingAbilities(): RpdServerPluginExtendingAbilities[] {
+    return [];
+  }
+
+  get configurableTargets(): RpdServerPluginConfigurableTargetOptions[] {
+    return [];
+  }
+
+  get configurations(): RpdConfigurationItemOptions[] {
+    return [];
+  }
+
+  async registerActionHandlers(server: IRpdServer): Promise<any> {
+    for (const actionHandler of pluginActionHandlers) {
+      server.registerActionHandler(this, actionHandler);
+    }
+  }
+
+  async configureModels(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
+    server.appendApplicationConfig({ models: pluginModels });
+  }
+
+  async configureServices(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
+    this.#mailService = new MailService(server, this.#config.smtpServer);
+    server.registerService("mailService", this.#mailService);
+  }
+
+  async configureRoutes(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
+    server.appendApplicationConfig({ routes: pluginRoutes });
+  }
+
+  async onApplicationLoaded(server: IRpdServer, applicationConfig: RpdApplicationConfig) {}
+}
+
+export default MailPlugin;

package/src/plugins/mail/MailPluginTypes.ts

@@ -0,0 +1,27 @@
+export type MailPluginConfig = {
+  smtpServer: RpdMailSmtpServer;
+};
+
+export type RpdMailSmtpServer = {
+  host: string;
+  port: number;
+  secure: boolean; // true for port 465, false for other ports (normally 587).
+  username: string;
+  password: string;
+};
+
+export type RpdMail = {
+  from?: string;
+  to?: string;
+  subject?: string;
+  text?: string;
+  html?: string;
+};
+
+export type SendMailOptions = {
+  from?: string;
+  to?: string;
+  subject?: string;
+  text?: string;
+  html?: string;
+};

package/src/plugins/mail/MailService.ts

@@ -0,0 +1,38 @@
+import { IRpdServer } from "~/core/server";
+import { RpdMailSmtpServer, SendMailOptions } from "./MailPluginTypes";
+import { RouteContext } from "~/core/routeContext";
+import nodemailer from "nodemailer";
+
+export default class MailService {
+  #server: IRpdServer;
+  #smtpServer: RpdMailSmtpServer;
+
+  constructor(server: IRpdServer, smtpServer: RpdMailSmtpServer) {
+    this.#server = server;
+    this.#smtpServer = smtpServer;
+  }
+
+  async sendMail(routeContext: RouteContext, server: IRpdServer, options: SendMailOptions): Promise<any> {
+    const smtpServer = this.#smtpServer;
+
+    const transporter = nodemailer.createTransport({
+      host: smtpServer.host,
+      port: smtpServer.port,
+      secure: smtpServer.secure, // true for port 465, false for other ports
+      auth: {
+        user: smtpServer.username,
+        pass: smtpServer.password,
+      },
+    });
+
+    const info = await transporter.sendMail({
+      from: options.from,
+      to: options.to,
+      subject: options.subject,
+      text: options.text,
+      html: options.html,
+    });
+
+    return info;
+  }
+}

package/src/plugins/mail/actionHandlers/index.ts

@@ -0,0 +1,3 @@
+import { IPluginActionHandler } from "~/core/actionHandler";
+
+export default [] satisfies IPluginActionHandler[];

package/src/plugins/mail/models/index.ts

@@ -0,0 +1 @@
+export default [];

package/src/plugins/mail/routes/index.ts

@@ -0,0 +1 @@
+export default [];

package/src/plugins/notification/NotificationPlugin.ts

@@ -0,0 +1,68 @@
+/**
+ * Notification plugin
+ */
+
+import { RpdApplicationConfig } from "~/types";
+import {
+  IRpdServer,
+  RapidPlugin,
+  RpdConfigurationItemOptions,
+  RpdServerPluginConfigurableTargetOptions,
+  RpdServerPluginExtendingAbilities,
+} from "~/core/server";
+
+import pluginActionHandlers from "./actionHandlers";
+import pluginModels from "./models";
+import pluginRoutes from "./routes";
+import NotificationService from "./NotificationService";
+
+class SequencePlugin implements RapidPlugin {
+  #notificationService!: NotificationService;
+
+  get notificationService() {
+    return this.#notificationService;
+  }
+
+  get code(): string {
+    return "notification";
+  }
+
+  get description(): string {
+    return null;
+  }
+
+  get extendingAbilities(): RpdServerPluginExtendingAbilities[] {
+    return [];
+  }
+
+  get configurableTargets(): RpdServerPluginConfigurableTargetOptions[] {
+    return [];
+  }
+
+  get configurations(): RpdConfigurationItemOptions[] {
+    return [];
+  }
+
+  async registerActionHandlers(server: IRpdServer): Promise<any> {
+    for (const actionHandler of pluginActionHandlers) {
+      server.registerActionHandler(this, actionHandler);
+    }
+  }
+
+  async configureModels(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
+    server.appendApplicationConfig({ models: pluginModels });
+  }
+
+  async configureServices(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
+    this.#notificationService = new NotificationService(server);
+    server.registerService("notificationService", this.#notificationService);
+  }
+
+  async configureRoutes(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
+    server.appendApplicationConfig({ routes: pluginRoutes });
+  }
+
+  async onApplicationLoaded(server: IRpdServer, applicationConfig: RpdApplicationConfig) {}
+}
+
+export default SequencePlugin;

package/src/plugins/notification/NotificationPluginTypes.ts

@@ -0,0 +1,13 @@
+export type RpdNotification = {
+  id?: number;
+  title: string;
+  content?: string;
+  details?: any;
+};
+
+export type SendNotificationOptions = {
+  userId: number;
+  title: string;
+  content?: string;
+  details?: any;
+};

package/src/plugins/notification/NotificationService.ts

@@ -0,0 +1,25 @@
+import { IRpdServer } from "~/core/server";
+import { SendNotificationOptions, RpdNotification } from "./NotificationPluginTypes";
+import { RouteContext } from "~/core/routeContext";
+
+export default class NotificationService {
+  #server: IRpdServer;
+
+  constructor(server: IRpdServer) {
+    this.#server = server;
+  }
+
+  async sendNotification(routeContext: RouteContext, server: IRpdServer, options: SendNotificationOptions): Promise<RpdNotification> {
+    const notificationManager = server.getEntityManager("notification");
+
+    return await notificationManager.createEntity({
+      routeContext,
+      entity: {
+        title: options.title,
+        content: options.content,
+        details: options.details,
+        user: options.userId,
+      },
+    });
+  }
+}

package/src/plugins/notification/actionHandlers/index.ts

@@ -0,0 +1,3 @@
+import { IPluginActionHandler } from "~/core/actionHandler";
+
+export default [] satisfies IPluginActionHandler[];

package/src/plugins/notification/models/Notification.ts

@@ -0,0 +1,57 @@
+import { RpdDataModel } from "~/types";
+
+export default {
+  maintainedBy: "notification",
+  namespace: "svc",
+  name: "notification",
+  singularCode: "notification",
+  pluralCode: "notifications",
+  schema: "public",
+  tableName: "notifications",
+  properties: [
+    {
+      name: "id",
+      code: "id",
+      columnName: "id",
+      type: "integer",
+      required: true,
+      autoIncrement: true,
+    },
+    {
+      name: "标题",
+      code: "title",
+      columnName: "title",
+      type: "text",
+      required: true,
+    },
+    {
+      name: "内容",
+      code: "content",
+      columnName: "content",
+      type: "text",
+      required: false,
+    },
+    {
+      name: "已读",
+      code: "read",
+      columnName: "read",
+      type: "boolean",
+      required: false,
+      defaultValue: "false",
+    },
+    {
+      name: "详细信息",
+      code: "details",
+      columnName: "details",
+      description: '{"url": "", "actions": [{"text": "", "url": ""}]}',
+      type: "json",
+    },
+    {
+      name: "用户",
+      code: "user",
+      type: "relation",
+      targetSingularCode: "oc_user",
+      targetIdColumnName: "user_id",
+    },
+  ],
+} as RpdDataModel;

package/src/plugins/notification/models/index.ts

@@ -0,0 +1,3 @@
+import Notification from "./Notification";
+
+export default [Notification];

package/src/plugins/notification/routes/index.ts

@@ -0,0 +1 @@
+export default [];