@kne/fastify-message 1.0.3 → 1.0.5

package/index.js

@@ -7,13 +7,22 @@ module.exports = fp(async function (fastify, options) {
     {
       name: 'message',
       dbTableNamePrefix: 't_message_',
+      prefix: '/api/v1/message',
       getUserModel: () => {
         if (!fastify.account) {
           throw new Error('fastify-account plugin must be registered before fastify-trtc-conference,or set options.getUserModel');
         }
         return fastify.account.models.user;
       },
-      senders: {}
+      senders: {},
+      getAuthenticate: (type) => {
+        switch (type) {
+          case 'record':
+          case 'template':
+          default:
+            return [];
+        }
+      }
     },
     options
   );
@@ -29,7 +38,8 @@ module.exports = fp(async function (fastify, options) {
           getUserModel: options.getUserModel
         })
       ],
-      ['services', path.resolve(__dirname, './libs/services')]
+      ['services', path.resolve(__dirname, './libs/services')],
+      ['controllers', path.resolve(__dirname, './libs/controllers')]
     ]
   });
 

package/libs/controllers/main.js

@@ -1,24 +1,200 @@
 const fp = require('fastify-plugin');
 
 module.exports = fp(async (fastify, options) => {
-  const { services } = fastify.project;
+  const { services } = fastify[options.name];
+
+  // 查看发送记录列表
+  fastify.get(
+    `${options.prefix}/records`,
+    {
+      onRequest: options.getAuthenticate('record'),
+      schema: {
+        description: '获取消息发送记录列表',
+        summary: '查看发送记录',
+        querystring: {
+          type: 'object',
+          properties: {
+            currentPage: { type: 'integer', default: 1, description: '页码' },
+            perPage: { type: 'integer', default: 20, description: '每页数量' },
+            filter: {
+              type: 'object',
+              default: {},
+              properties: {
+                type: { type: 'integer', description: '发送类型: 0=邮件, 1=短信' },
+                code: { type: 'string', description: '模板编码' },
+                name: { type: 'string', description: '发送对象（邮箱/手机号）' }
+              }
+            }
+          }
+        },
+        response: {
+          200: {
+            type: 'object',
+            properties: {
+              totalCount: { type: 'integer', description: '总数量' },
+              currentPage: { type: 'integer', description: '当前页码' },
+              perPage: { type: 'integer', description: '每页数量' },
+              pageData: {
+                type: 'array',
+                items: {
+                  type: 'object',
+                  properties: {
+                    id: { type: 'string', description: '记录ID' },
+                    name: { type: 'string', description: '发送对象（邮箱/手机号）' },
+                    type: { type: 'integer', description: '发送类型: 0=邮件, 1=短信' },
+                    code: { type: 'string', description: '模板编码' },
+                    props: { type: 'object', description: '模板变量', additionalProperties: true },
+                    content: { type: 'object', description: '消息内容', additionalProperties: true },
+                    templateId: { type: 'string', description: '模板ID' },
+                    createdAt: { type: 'string', description: '创建时间' }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    async request => {
+      const { currentPage = 1, perPage = 20, filter = {} } = request.query;
+      const { type, code, name } = filter;
+      
+      const where = {};
+      if (type !== undefined) where.type = type;
+      if (code) where.code = code;
+      if (name) where.name = name;
+      
+      return await services.record.list({ filter: where, perPage, currentPage });
+    }
+  );
+
+  // 发送消息
+  fastify.post(
+    `${options.prefix}/templates/send`,
+    {
+      onRequest: options.getAuthenticate('template:send'),
+      schema: {
+        description: '根据模版发送消息',
+        summary: '发送消息',
+        body: {
+          type: 'object',
+          required: ['templateId', 'name'],
+          properties: {
+            templateId: { type: 'string', description: '模版ID' },
+            name: { type: 'string', description: '发送对象（邮箱/手机号）' },
+            props: { type: 'object', description: '模版变量', additionalProperties: true }
+          }
+        },
+        response: {
+          200: {
+            type: 'object',
+            properties: {
+              success: { type: 'boolean', description: '是否发送成功' }
+            }
+          }
+        }
+      }
+    },
+    async request => {
+      const { templateId, name, props = {} } = request.body;
+      try {
+        return await services.template.send({ templateId, name, props });
+      } catch (error) {
+        if (error.message === '模版已禁用，无法发送消息') {
+          throw fastify.httpErrors.badRequest(error.message);
+        }
+        throw fastify.httpErrors.notFound(error.message);
+      }
+    }
+  );
+
+  // 查看单条发送记录
+  fastify.get(
+    `${options.prefix}/records/:id`,
+    {
+      onRequest: options.getAuthenticate('record'),
+      schema: {
+        description: '获取单条消息发送记录详情',
+        summary: '查看发送记录详情',
+        params: {
+          type: 'object',
+          properties: {
+            id: { type: 'string', description: '记录ID' }
+          },
+          required: ['id']
+        },
+        response: {
+          200: {
+            type: 'object',
+            properties: {
+              id: { type: 'string', description: '记录ID' },
+              name: { type: 'string', description: '发送对象（邮箱/手机号）' },
+              type: { type: 'integer', description: '发送类型: 0=邮件, 1=短信' },
+              code: { type: 'string', description: '模板编码' },
+              props: { type: 'object', description: '模板变量', additionalProperties: true },
+              content: { type: 'object', description: '消息内容', additionalProperties: true },
+              templateId: { type: 'string', description: '模板ID' },
+              createdAt: { type: 'string', description: '创建时间' }
+            }
+          }
+        }
+      }
+    },
+    async request => {
+      const { id } = request.params;
+      try {
+        return await services.record.detail({ id });
+      } catch (error) {
+        throw fastify.httpErrors.notFound(error.message);
+      }
+    }
+  );
+
+  // 查看消息模版列表
   fastify.get(
-    `${options.prefix}/welcome`,
+    `${options.prefix}/templates`,
     {
-      onRequest: [],
+      onRequest: options.getAuthenticate('template'),
       schema: {
-        description: '接口说明',
-        summary: '接口主题',
-        query: {},
+        description: '获取消息模版列表',
+        summary: '查看消息模版',
+        querystring: {
+          type: 'object',
+          properties: {
+            currentPage: { type: 'integer', default: 1, description: '页码' },
+            perPage: { type: 'integer', default: 20, description: '每页数量' },
+            filter: {
+              type: 'object',
+              default: {},
+              properties: {
+                type: { type: 'integer', description: '模版类型: 0=邮件, 1=短信' },
+                code: { type: 'string', description: '模版编码' },
+                level: { type: 'integer', description: '模版级别: 0=系统, 1=业务' },
+                status: { type: 'integer', description: '状态: 0=启用, 1=禁用' }
+              }
+            }
+          }
+        },
         response: {
           200: {
-            description: '返回值说明',
-            content: {
-              'application/json': {
-                schema: {
+            type: 'object',
+            properties: {
+              totalCount: { type: 'integer', description: '总数量' },
+              currentPage: { type: 'integer', description: '当前页码' },
+              perPage: { type: 'integer', description: '每页数量' },
+              pageData: {
+                type: 'array',
+                items: {
                   type: 'object',
                   properties: {
-                    message: { type: 'string', description: '信息' }
+                    id: { type: 'string', description: '模版ID' },
+                    name: { type: 'string', description: '模版名称' },
+                    code: { type: 'string', description: '模版编码' },
+                    type: { type: 'integer', description: '模版类型: 0=邮件, 1=短信' },
+                    level: { type: 'integer', description: '模版级别: 0=系统, 1=业务' },
+                    status: { type: 'integer', description: '状态: 0=启用, 1=禁用' },
+                    content: { type: 'string', description: '模版内容' },
+                    createdAt: { type: 'string', description: '创建时间' }
                   }
                 }
               }
@@ -28,7 +204,58 @@ module.exports = fp(async (fastify, options) => {
       }
     },
     async request => {
-      return { message: 'welcome' };
+      const { currentPage = 1, perPage = 20, filter = {} } = request.query;
+      const { type, code, level, status } = filter;
+      
+      const where = {};
+      if (type !== undefined) where.type = type;
+      if (code) where.code = code;
+      if (level !== undefined) where.level = level;
+      if (status !== undefined) where.status = status;
+      
+      return await services.template.list({ filter: where, perPage, currentPage });
+    }
+  );
+
+  // 查看单个消息模版
+  fastify.get(
+    `${options.prefix}/templates/:id`,
+    {
+      onRequest: options.getAuthenticate('template'),
+      schema: {
+        description: '获取单个消息模版详情',
+        summary: '查看消息模版详情',
+        params: {
+          type: 'object',
+          properties: {
+            id: { type: 'string', description: '模版ID' }
+          },
+          required: ['id']
+        },
+        response: {
+          200: {
+            type: 'object',
+            properties: {
+              id: { type: 'string', description: '模版ID' },
+              name: { type: 'string', description: '模版名称' },
+              code: { type: 'string', description: '模版编码' },
+              type: { type: 'integer', description: '模版类型: 0=邮件, 1=短信' },
+              level: { type: 'integer', description: '模版级别: 0=系统, 1=业务' },
+              status: { type: 'integer', description: '状态: 0=启用, 1=禁用' },
+              content: { type: 'string', description: '模版内容' },
+              createdAt: { type: 'string', description: '创建时间' }
+            }
+          }
+        }
+      }
+    },
+    async request => {
+      const { id } = request.params;
+      try {
+        return await services.template.detail({ id });
+      } catch (error) {
+        throw fastify.httpErrors.notFound(error.message);
+      }
     }
   );
 });

package/libs/services/main.js

@@ -121,6 +121,78 @@ module.exports = fp(async (fastify, options) => {
   };
 
   Object.assign(fastify[options.name].services, {
-    includeTemplate, messageTemplate, parseTemplate, sendMessage
+    includeTemplate, messageTemplate, parseTemplate, sendMessage,
+    
+    // 发送记录相关服务
+    record: {
+      list: async ({ filter = {}, perPage = 20, currentPage = 1 }) => {
+        const { count, rows } = await models.record.findAndCountAll({
+          where: filter,
+          limit: perPage,
+          offset: (currentPage - 1) * perPage,
+          order: [['createdAt', 'DESC']]
+        });
+        
+        return {
+          pageData: rows,
+          totalCount: count,
+          perPage,
+          currentPage
+        };
+      },
+      
+      detail: async ({ id }) => {
+        const record = await models.record.findByPk(id);
+        if (!record) {
+          throw new Error('记录不存在');
+        }
+        return record;
+      }
+    },
+    
+    // 消息模版相关服务
+    template: {
+      list: async ({ filter = {}, perPage = 20, currentPage = 1 }) => {
+        const { count, rows } = await models.template.findAndCountAll({
+          where: filter,
+          limit: perPage,
+          offset: (currentPage - 1) * perPage,
+          order: [['createdAt', 'DESC']]
+        });
+        
+        return {
+          pageData: rows,
+          totalCount: count,
+          perPage,
+          currentPage
+        };
+      },
+      
+      detail: async ({ id }) => {
+        const template = await models.template.findByPk(id);
+        if (!template) {
+          throw new Error('模版不存在');
+        }
+        return template;
+      },
+
+      send: async ({ templateId, name, props = {} }) => {
+        const tpl = await models.template.findByPk(templateId);
+        if (!tpl) {
+          throw new Error('模版不存在');
+        }
+        if (tpl.status !== 0) {
+          throw new Error('模版已禁用，无法发送消息');
+        }
+        await sendMessage({
+          type: tpl.type,
+          name,
+          props,
+          code: tpl.code,
+          level: tpl.level
+        });
+        return { success: true };
+      }
+    }
   });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kne/fastify-message",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "管理消息发送，支持sms消息，email消息等.",
   "main": "index.js",
   "scripts": {
@@ -10,7 +10,9 @@
     "build:md": "npx @kne/md-doc",
     "start:md": "npx @kne/md-doc --watch",
     "prettier": "prettier --config .prettierrc --write '{libs/**/*,index}.{js,jsx,ts,tsx,json,css,scss}'",
-    "lint-staged": "npx lint-staged"
+    "lint-staged": "npx lint-staged",
+    "test": "mocha --exit test/**/*.test.js",
+    "test:coverage": "nyc --reporter=html --reporter=text mocha test/**/*.test.js --timeout 10000"
   },
   "lint-staged": {
     "**/*.md": [
@@ -43,12 +45,18 @@
   },
   "devDependencies": {
     "@fastify/env": "^4.4.0",
+    "@fastify/sensible": "^6.0.4",
     "@kne/fastify-sequelize": "^2.0.1",
+    "chai": "^6.2.2",
     "fastify": "^5.3.2",
     "fastify-plugin": "^5.0.1",
     "husky": "^9.0.11",
+    "mocha": "^11.7.5",
     "nodemon": "^3.1.3",
-    "prettier": "^3.2.5"
+    "nyc": "^17.1.0",
+    "prettier": "^3.2.5",
+    "qs": "^6.15.1",
+    "sqlite3": "^6.0.1"
   },
   "dependencies": {
     "fs-extra": "^11.3.0",