create-skweb 2.1.0 → 3.0.3

package/templates/cjs/src/controllers/hello.js

@@ -16,6 +16,21 @@
  *                 message: { type: string, example: 'Welcome to SKWeb!' }
  *                 version: { type: string, example: '1.0.0' }
  *                 timestamp: { type: string, format: date-time }
+ */
+const helloIndex = {
+  method: 'get',
+  path: '/',
+  async handler() {
+    return {
+      message: 'Welcome to SKWeb!',
+      version: '1.0.0',
+      timestamp: new Date().toISOString()
+    }
+  }
+}
+
+/**
+ * @swagger
  * /health:
  *   get:
  *     summary: 健康检查
@@ -30,6 +45,20 @@
  *               properties:
  *                 status: { type: string, example: 'ok' }
  *                 timestamp: { type: string, format: date-time }
+ */
+const helloHealth = {
+  method: 'get',
+  path: '/health',
+  async handler() {
+    return {
+      status: 'ok',
+      timestamp: new Date().toISOString()
+    }
+  }
+}
+
+/**
+ * @swagger
  * /echo:
  *   post:
  *     summary: 回显请求体
@@ -44,36 +73,19 @@
  *       200:
  *         description: OK
  */
-module.exports = [
-  {
-    method: 'get',
-    path: '/',
-    async handler() {
-      return {
-        message: 'Welcome to SKWeb!',
-        version: '1.0.0',
-        timestamp: new Date().toISOString()
-      }
-    }
-  },
-  {
-    method: 'get',
-    path: '/health',
-    async handler() {
-      return {
-        status: 'ok',
-        timestamp: new Date().toISOString()
-      }
-    }
-  },
-  {
-    method: 'post',
-    path: '/echo',
-    async handler(req) {
-      return {
-        message: 'Echo received',
-        data: req.body
-      }
+const helloEcho = {
+  method: 'post',
+  path: '/echo',
+  async handler(req) {
+    return {
+      message: 'Echo received',
+      data: req.body
     }
   }
-]
+}
+
+module.exports = {
+  helloIndex,
+  helloHealth,
+  helloEcho
+}

package/templates/cjs/src/controllers/user.js

@@ -3,99 +3,212 @@ const { db } = require('../services/database.js')
 
 const { SysUser } = db.sequelize.models
 
-module.exports = [
-  {
-    method: 'get',
-    path: '/api/users',
-    async handler(req) {
-      const { page = 1, limit = 10 } = req.query
-      const users = await SysUser.findAndCountAll({
-        offset: (Number(page) - 1) * Number(limit),
-        limit: Number(limit)
-      })
-      return {
-        list: users.rows,
-        total: users.count
-      }
+/**
+ * @swagger
+ * /api/users:
+ *   get:
+ *     summary: 获取用户列表
+ *     tags: [Users]
+ *     parameters:
+ *       - in: query
+ *         name: page
+ *         schema: { type: integer, minimum: 1, default: 1 }
+ *         description: 页码
+ *       - in: query
+ *         name: limit
+ *         schema: { type: integer, minimum: 1, default: 10 }
+ *         description: 每页条数
+ *     responses:
+ *       200:
+ *         description: OK
+ */
+const userList = {
+  method: 'get',
+  path: '/api/users',
+  async handler(req) {
+    const { page = 1, limit = 10 } = req.query
+    const users = await SysUser.findAndCountAll({
+      offset: (Number(page) - 1) * Number(limit),
+      limit: Number(limit)
+    })
+    return {
+      list: users.rows,
+      total: users.count
     }
+  }
+}
+
+/**
+ * @swagger
+ * /api/users/{id}:
+ *   get:
+ *     summary: 获取单个用户
+ *     tags: [Users]
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema: { type: integer, minimum: 1 }
+ *     responses:
+ *       200:
+ *         description: OK
+ *       404:
+ *         description: 用户不存在
+ */
+const userGet = {
+  method: 'get',
+  path: '/api/users/:id',
+  paramsSchema: {
+    type: 'object',
+    required: ['id'],
+    properties: { id: { type: 'integer', minimum: 1 } }
   },
-  {
-    method: 'get',
-    path: '/api/users/:id',
-    paramsSchema: {
-      type: 'object',
-      required: ['id'],
-      properties: { id: { type: 'integer', minimum: 1 } }
-    },
-    async handler(req) {
-      const { id } = req.validatedParams
-      const user = await SysUser.findByPk(id)
-      if (!user) {
-        throw new createHttpError.NotFound('User not found')
-      }
-      return user
+  async handler(req) {
+    const { id } = req.validatedParams
+    const user = await SysUser.findByPk(id)
+    if (!user) {
+      throw new createHttpError.NotFound('User not found')
+    }
+    return user
+  }
+}
+
+/**
+ * @swagger
+ * /api/users:
+ *   post:
+ *     summary: 创建用户
+ *     tags: [Users]
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             required: [username, password]
+ *             properties:
+ *               username: { type: string, minLength: 3 }
+ *               password: { type: string, minLength: 6 }
+ *               email:    { type: string, format: email }
+ *               phone:    { type: string }
+ *     responses:
+ *       200:
+ *         description: 创建成功
+ */
+const userCreate = {
+  method: 'post',
+  path: '/api/users',
+  bodySchema: {
+    type: 'object',
+    required: ['username', 'password'],
+    properties: {
+      username: { type: 'string', minLength: 3 },
+      password: { type: 'string', minLength: 6 },
+      email: { type: 'string', format: 'email' },
+      phone: { type: 'string' }
     }
   },
-  {
-    method: 'post',
-    path: '/api/users',
-    bodySchema: {
-      type: 'object',
-      required: ['username', 'password'],
-      properties: {
-        username: { type: 'string', minLength: 3 },
-        password: { type: 'string', minLength: 6 },
-        email: { type: 'string', format: 'email' },
-        phone: { type: 'string' }
-      }
-    },
-    async handler(req) {
-      return await SysUser.create(req.validatedBody)
+  async handler(req) {
+    return await SysUser.create(req.validatedBody)
+  }
+}
+
+/**
+ * @swagger
+ * /api/users/{id}:
+ *   put:
+ *     summary: 更新用户
+ *     tags: [Users]
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema: { type: integer, minimum: 1 }
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             properties:
+ *               password: { type: string, minLength: 6 }
+ *               email:    { type: string, format: email }
+ *               phone:    { type: string }
+ *               status:   { type: integer }
+ *     responses:
+ *       200:
+ *         description: OK
+ *       404:
+ *         description: 用户不存在
+ */
+const userUpdate = {
+  method: 'put',
+  path: '/api/users/:id',
+  paramsSchema: {
+    type: 'object',
+    required: ['id'],
+    properties: { id: { type: 'integer', minimum: 1 } }
+  },
+  bodySchema: {
+    type: 'object',
+    properties: {
+      password: { type: 'string', minLength: 6 },
+      email: { type: 'string', format: 'email' },
+      phone: { type: 'string' },
+      status: { type: 'integer' }
     }
   },
-  {
-    method: 'put',
-    path: '/api/users/:id',
-    paramsSchema: {
-      type: 'object',
-      required: ['id'],
-      properties: { id: { type: 'integer', minimum: 1 } }
-    },
-    bodySchema: {
-      type: 'object',
-      properties: {
-        password: { type: 'string', minLength: 6 },
-        email: { type: 'string', format: 'email' },
-        phone: { type: 'string' },
-        status: { type: 'integer' }
-      }
-    },
-    async handler(req) {
-      const { id } = req.validatedParams
-      const user = await SysUser.findByPk(id)
-      if (!user) {
-        throw new createHttpError.NotFound('User not found')
-      }
-      await user.update(req.validatedBody)
-      return user
+  async handler(req) {
+    const { id } = req.validatedParams
+    const user = await SysUser.findByPk(id)
+    if (!user) {
+      throw new createHttpError.NotFound('User not found')
     }
+    await user.update(req.validatedBody)
+    return user
+  }
+}
+
+/**
+ * @swagger
+ * /api/users/{id}:
+ *   delete:
+ *     summary: 删除用户
+ *     tags: [Users]
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema: { type: integer, minimum: 1 }
+ *     responses:
+ *       200:
+ *         description: OK
+ *       404:
+ *         description: 用户不存在
+ */
+const userDelete = {
+  method: 'delete',
+  path: '/api/users/:id',
+  paramsSchema: {
+    type: 'object',
+    required: ['id'],
+    properties: { id: { type: 'integer', minimum: 1 } }
   },
-  {
-    method: 'delete',
-    path: '/api/users/:id',
-    paramsSchema: {
-      type: 'object',
-      required: ['id'],
-      properties: { id: { type: 'integer', minimum: 1 } }
-    },
-    async handler(req) {
-      const { id } = req.validatedParams
-      const user = await SysUser.findByPk(id)
-      if (!user) {
-        throw new createHttpError.NotFound('User not found')
-      }
-      await user.destroy()
-      return { message: 'User deleted' }
+  async handler(req) {
+    const { id } = req.validatedParams
+    const user = await SysUser.findByPk(id)
+    if (!user) {
+      throw new createHttpError.NotFound('User not found')
     }
+    await user.destroy()
+    return { message: 'User deleted' }
   }
-]
+}
+
+module.exports = {
+  userList,
+  userGet,
+  userCreate,
+  userUpdate,
+  userDelete
+}

package/templates/cjs/src/cronWorker.js

@@ -62,16 +62,14 @@ async function startCronWorker() {
   framework.start()
   logger.info('[cron-worker] Cron worker started')
 
-  process.on('SIGINT', async () => {
-    logger.info('[cron-worker] Received SIGINT, shutting down...')
-    await framework.stop()
-    process.exit(0)
+  // 未捕获异常：打印堆栈后直接退出。OS / 进程管理器负责回收资源。
+  process.on('uncaughtException', (err) => {
+    logger.error(`[cron-worker] uncaughtException: ${err.stack || err.message}`)
+    process.exit(1)
   })
-
-  process.on('SIGTERM', async () => {
-    logger.info('[cron-worker] Received SIGTERM, shutting down...')
-    await framework.stop()
-    process.exit(0)
+  process.on('unhandledRejection', (reason) => {
+    logger.error(`[cron-worker] unhandledRejection: ${reason instanceof Error ? reason.stack : String(reason)}`)
+    process.exit(1)
   })
 }
 

package/templates/mjs/package.json

@@ -20,27 +20,27 @@
     "clean:temp": "rm -rf .rollup.cache"
   },
   "dependencies": {
-    "@dotenvx/dotenvx": "^1.71.0",
-    "http-errors": "^2.0.0",
-    "skweb-express": "^1.1.0",
-    "skweb-express-jwt": "^2.0.0",
-    "skweb-express-logger": "^1.1.0",
-    "skweb-sequelize": "^1.1.0",
-    "skweb-redis": "^1.1.0",
-    "skweb-cron": "^1.1.0",
-    "skweb-framework": "^1.1.0",
-    "skweb-plugin": "^1.1.0",
-    "skweb-util": "^1.1.0",
-    "winston": "^3.17.0",
-    "sequelize": "^6.37.7",
-    "swagger-jsdoc": "^6.2.8",
+    "@dotenvx/dotenvx": "^1.75.1",
+    "http-errors": "^2.0.1",
+    "skweb-express": "^2.0.0",
+    "skweb-express-jwt": "^3.0.0",
+    "skweb-express-logger": "^2.0.0",
+    "skweb-sequelize": "^2.0.0",
+    "skweb-redis": "^2.0.0",
+    "skweb-cron": "^2.0.0",
+    "skweb-framework": "^2.0.0",
+    "skweb-plugin": "^2.0.0",
+    "skweb-util": "^2.0.0",
+    "winston": "^3.19.0",
+    "sequelize": "^6.37.8",
+    "swagger-jsdoc": "^6.3.0",
     "swagger-ui-express": "^5.0.1"
   },
   "devDependencies": {
-    "chai": "^6.2.1",
-    "mocha": "^11.7.5",
-    "eslint": "^9.39.1",
-    "@eslint/js": "^9.39.1"
+    "chai": "^6.2.2",
+    "mocha": "^11.7.6",
+    "eslint": "^10.5.0",
+    "@eslint/js": "^10.0.1"
   },
   "engines": {
     "node": ">=20.18.1"

package/templates/mjs/src/app.js

@@ -3,7 +3,7 @@ import 'dotenv/config'
 import path from 'path'
 import { fileURLToPath } from 'url'
 import express from 'skweb-express'
-import expressLogger from 'skweb-express-logger'
+import expressLogger, { errorHandler as expressErrorHandler } from 'skweb-express-logger'
 import swaggerUi from 'swagger-ui-express'
 import logger from './utils/logger.js'
 import { checkRequiredEnv } from './utils/config.js'
@@ -135,16 +135,14 @@ async function bootstrap() {
 
   logger.info('[app] Initialization complete (web process)')
 
-  process.on('SIGINT', async () => {
-    logger.info('[app] Received SIGINT, shutting down gracefully...')
-    await framework.stop()
-    process.exit(0)
+  // 未捕获异常：打印堆栈后直接退出。OS / 进程管理器负责回收资源。
+  process.on('uncaughtException', (err) => {
+    logger.error(`[app] uncaughtException: ${err.stack || err.message}`)
+    process.exit(1)
   })
-
-  process.on('SIGTERM', async () => {
-    logger.info('[app] Received SIGTERM, shutting down gracefully...')
-    await framework.stop()
-    process.exit(0)
+  process.on('unhandledRejection', (reason) => {
+    logger.error(`[app] unhandledRejection: ${reason instanceof Error ? reason.stack : String(reason)}`)
+    process.exit(1)
   })
 }
 

package/templates/mjs/src/controllers/hello.js

@@ -16,6 +16,21 @@
  *                 message: { type: string, example: 'Welcome to SKWeb!' }
  *                 version: { type: string, example: '1.0.0' }
  *                 timestamp: { type: string, format: date-time }
+ */
+const helloIndex = {
+  method: 'get',
+  path: '/',
+  async handler() {
+    return {
+      message: 'Welcome to SKWeb!',
+      version: '1.0.0',
+      timestamp: new Date().toISOString()
+    }
+  }
+}
+
+/**
+ * @swagger
  * /health:
  *   get:
  *     summary: 健康检查
@@ -30,6 +45,20 @@
  *               properties:
  *                 status: { type: string, example: 'ok' }
  *                 timestamp: { type: string, format: date-time }
+ */
+const helloHealth = {
+  method: 'get',
+  path: '/health',
+  async handler() {
+    return {
+      status: 'ok',
+      timestamp: new Date().toISOString()
+    }
+  }
+}
+
+/**
+ * @swagger
  * /echo:
  *   post:
  *     summary: 回显请求体
@@ -44,36 +73,19 @@
  *       200:
  *         description: OK
  */
-export default [
-  {
-    method: 'get',
-    path: '/',
-    async handler() {
-      return {
-        message: 'Welcome to SKWeb!',
-        version: '1.0.0',
-        timestamp: new Date().toISOString()
-      }
-    }
-  },
-  {
-    method: 'get',
-    path: '/health',
-    async handler() {
-      return {
-        status: 'ok',
-        timestamp: new Date().toISOString()
-      }
-    }
-  },
-  {
-    method: 'post',
-    path: '/echo',
-    async handler(req) {
-      return {
-        message: 'Echo received',
-        data: req.body
-      }
+const helloEcho = {
+  method: 'post',
+  path: '/echo',
+  async handler(req) {
+    return {
+      message: 'Echo received',
+      data: req.body
     }
   }
-]
+}
+
+export default {
+  helloIndex,
+  helloHealth,
+  helloEcho
+}