create-skweb 1.1.0

package/rollup.config.mjs

@@ -0,0 +1,71 @@
+import commonjs from '@rollup/plugin-commonjs'
+import resolve from '@rollup/plugin-node-resolve'
+import typescript from '@rollup/plugin-typescript'
+import terser from '@rollup/plugin-terser'
+import replace from '@rollup/plugin-replace'
+
+const isProduction = process.env.NODE_ENV === 'production'
+
+export default [
+  {
+    input: 'src/index.ts',
+    output: [
+      {
+        file: 'dist/index.js',
+        format: 'es',
+        sourcemap: true
+      },
+      {
+        file: 'dist/index.cjs',
+        format: 'cjs',
+        sourcemap: true,
+        exports: 'named'
+      }
+    ],
+    plugins: [
+      resolve(),
+      commonjs(),
+      typescript({ tsconfig: './tsconfig.json' }),
+      isProduction && terser()
+    ],
+    external: [
+      'commander',
+      'inquirer',
+      'ora',
+      'fs-extra',
+      'fs',
+      'path',
+      'child_process',
+      'os'
+    ]
+  },
+  {
+    input: 'src/cli.ts',
+    output: {
+      file: 'dist/cli.js',
+      format: 'es',
+      sourcemap: true,
+      banner: '#!/usr/bin/env node'
+    },
+    plugins: [
+      replace({
+        '#!/usr/bin/env node': '',
+        delimiters: ['', '']
+      }),
+      resolve(),
+      commonjs(),
+      typescript({ tsconfig: './tsconfig.json', declaration: false, declarationMap: false }),
+      isProduction && terser()
+    ],
+    external: [
+      'commander',
+      'inquirer',
+      'ora',
+      'fs-extra',
+      'fs',
+      'path',
+      'child_process',
+      'os'
+    ]
+  }
+]

package/src/cli.ts

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander'
+import inquirer from 'inquirer'
+import ora from 'ora'
+import { 
+  createProject, 
+  installDependencies, 
+  initGit, 
+  printBanner, 
+  printSuccess 
+} from './index'
+
+async function main() {
+  const program = new Command()
+  
+  program
+    .name('create-skweb')
+    .description('Create a new SKWeb project with TypeScript, CJS, or MJS support')
+    .argument('[name]', 'Project name')
+    .option('--template <type>', 'Template type: ts, mjs, cjs', 'ts')
+    .option('--dest <path>', 'Destination directory', '.')
+    .option('--skip-install', 'Skip dependency installation')
+    .option('--skip-git', 'Skip git initialization')
+    .action(async (name, options) => {
+      printBanner()
+      
+      if (!name) {
+        const answers = await inquirer.prompt([
+          {
+            type: 'input',
+            name: 'name',
+            message: 'Enter project name:',
+            default: 'my-skweb-app',
+            validate: (input: string) => {
+              if (!input || input.trim() === '') {
+                return 'Please enter a project name'
+              }
+              return true
+            }
+          },
+          {
+            type: 'list',
+            name: 'template',
+            message: 'Select project template:',
+            choices: [
+              { name: 'TypeScript', value: 'ts' },
+              { name: 'ES Modules (MJS)', value: 'mjs' },
+              { name: 'CommonJS (CJS)', value: 'cjs' }
+            ],
+            default: 'ts'
+          },
+          {
+            type: 'input',
+            name: 'dest',
+            message: 'Enter destination directory:',
+            default: '.'
+          },
+          {
+            type: 'confirm',
+            name: 'install',
+            message: 'Install dependencies?',
+            default: true
+          },
+          {
+            type: 'confirm',
+            name: 'git',
+            message: 'Initialize git repository?',
+            default: true
+          }
+        ])
+        
+        name = answers.name
+        options.template = answers.template
+        options.dest = answers.dest
+        options.skipInstall = !answers.install
+        options.skipGit = !answers.git
+      }
+      
+      const spinner = ora('Creating project...').start()
+      
+      try {
+        await createProject({
+          name,
+          template: options.template as 'ts' | 'mjs' | 'cjs',
+          dest: options.dest
+        })
+        spinner.succeed('Project files created')
+        
+        if (!options.skipInstall) {
+          spinner.text = 'Installing dependencies...'
+          spinner.start()
+          await installDependencies(options.dest)
+          spinner.succeed('Dependencies installed')
+        }
+        
+        if (!options.skipGit) {
+          spinner.text = 'Initializing git repository...'
+          spinner.start()
+          await initGit(options.dest)
+          spinner.succeed('Git repository initialized')
+        }
+        
+        spinner.stop()
+        
+        printSuccess(name, options.dest)
+        
+      } catch (error) {
+        spinner.fail('Failed to create project')
+        console.error(error)
+        process.exit(1)
+      }
+    })
+  
+  await program.parseAsync()
+}
+
+main().catch(console.error)

package/src/index.ts

@@ -0,0 +1,122 @@
+import fs from 'fs-extra'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { execSync } from 'child_process'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+export interface CreateOptions {
+  name: string
+  description?: string
+  template: 'ts' | 'mjs' | 'cjs'
+  dest: string
+}
+
+export async function createProject(options: CreateOptions): Promise<void> {
+  const { name, description = 'A SKWeb project', template, dest } = options
+  
+  const templateDir = path.join(__dirname, '..', 'templates', template)
+  const targetDir = path.resolve(dest)
+  
+  if (await fs.pathExists(targetDir)) {
+    if ((await fs.readdir(targetDir)).length > 0) {
+      throw new Error(`目标目录 ${targetDir} 不为空`)
+    }
+  } else {
+    await fs.mkdirs(targetDir)
+  }
+  
+  const files = await fs.readdir(templateDir, { recursive: true })
+  
+  for (const file of files) {
+    const fileName = String(file)
+    const srcPath = path.join(templateDir, fileName)
+    const stats = await fs.stat(srcPath)
+    
+    if (stats.isDirectory()) {
+      await fs.mkdirs(path.join(targetDir, fileName))
+      continue
+    }
+    
+    let content = await fs.readFile(srcPath, 'utf-8')
+    
+    content = content
+      .replace(/\{\{name\}\}/g, name)
+      .replace(/\{\{description\}\}/g, description)
+    
+    const destPath = path.join(targetDir, fileName)
+    await fs.writeFile(destPath, content)
+  }
+  
+  await fs.mkdirs(path.join(targetDir, 'logs'))
+}
+
+export async function installDependencies(dest: string): Promise<void> {
+  const targetDir = path.resolve(dest)
+  
+  execSync('npm install', {
+    cwd: targetDir,
+    stdio: 'inherit'
+  })
+  
+  execSync('npm install pm2 -g', {
+    cwd: targetDir,
+    stdio: 'inherit'
+  })
+}
+
+export async function initGit(dest: string): Promise<void> {
+  const targetDir = path.resolve(dest)
+  
+  execSync('git init', {
+    cwd: targetDir,
+    stdio: 'inherit'
+  })
+}
+
+export function printBanner(): void {
+  console.log(`
+╔════════════════════════════════════════════════════════════════════╗
+║                    Create SKWeb Project                           ║
+╚════════════════════════════════════════════════════════════════════╝
+`)
+}
+
+export function printSuccess(name: string, dest: string): void {
+  console.log(`
+╔════════════════════════════════════════════════════════════════════╗
+║                      项目创建成功！                               ║
+╚════════════════════════════════════════════════════════════════════╝
+
+项目名称: ${name}
+项目路径: ${path.resolve(dest)}
+
+接下来可以执行:
+
+  cd ${path.basename(path.resolve(dest))}
+  
+  # 开发模式运行
+  npm run start:dev
+  
+  # 生产模式运行 (需要先构建)
+  npm run build
+  npm run start
+  
+  # 查看日志
+  npm run logs
+  
+  # 停止服务
+  npm run stop
+  
+  # 重启服务
+  npm run restart
+
+项目特性:
+  ✅ TypeScript/MJS/CJS 支持
+  ✅ @dotenvx/dotenvx 环境变量管理
+  ✅ PM2 进程管理
+  ✅ SKWeb Express 集成
+  ✅ ESLint 代码检查
+  ✅ Mocha 测试框架
+`)
+}

package/templates/cjs/ecosystem.config.js

@@ -0,0 +1,32 @@
+module.exports = {
+  apps: [
+    {
+      name: '{{name}}-web',
+      script: 'src/index.js',
+      instances: 'max',
+      exec_mode: 'cluster',
+      env: {
+        NODE_ENV: 'production',
+        PORT: 3000
+      },
+      max_memory_restart: '512M',
+      error_file: 'logs/web-err.log',
+      out_file: 'logs/web-out.log',
+      log_date_format: 'YYYY-MM-DD HH:mm:ss Z'
+    },
+    {
+      name: '{{name}}-cron',
+      script: 'src/cronWorker.js',
+      instances: 1,
+      exec_mode: 'fork',
+      autorestart: true,
+      env: {
+        NODE_ENV: 'production'
+      },
+      max_memory_restart: '512M',
+      error_file: 'logs/cron-err.log',
+      out_file: 'logs/cron-out.log',
+      log_date_format: 'YYYY-MM-DD HH:mm:ss Z'
+    }
+  ]
+}

package/templates/cjs/eslint.config.js

@@ -0,0 +1,25 @@
+const js = require('@eslint/js')
+
+module.exports = [
+  { ignores: ['dist', 'node_modules', 'logs', 'test'] },
+  js.configs.recommended,
+  {
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: 'commonjs',
+      globals: {
+        process: 'readonly',
+        console: 'readonly',
+        Buffer: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+        require: 'readonly',
+        module: 'readonly',
+        exports: 'writable'
+      }
+    },
+    rules: {
+      'no-unused-vars': ['warn', { argsIgnorePattern: '^_' }]
+    }
+  }
+]

package/templates/cjs/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "{{name}}",
+  "version": "1.0.0",
+  "description": "{{description}}",
+  "type": "commonjs",
+  "scripts": {
+    "start": "pm2 start ecosystem.config.js",
+    "stop": "pm2 stop all",
+    "restart": "pm2 restart all",
+    "delete": "pm2 delete all",
+    "logs": "pm2 logs",
+    "web:dev": "npx dotenvx run -- node --watch src/index.js",
+    "cron:dev": "npx dotenvx run -- node --watch src/cronWorker.js",
+    "seed": "npx dotenvx run -- node src/commands/seed.js",
+    "migrate": "npx dotenvx run -- node src/commands/migrate.js",
+    "build": "cp -r src dist",
+    "lint": "eslint --fix --ext .js src",
+    "test": "npx dotenvx run -- mocha test/**/*.js",
+    "clean": "rm -rf dist",
+    "clean:temp": "rm -rf .rollup.cache"
+  },
+  "dependencies": {
+    "@dotenvx/dotenvx": "^1.71.0",
+    "http-errors": "^2.0.0",
+    "skweb-express": "^1.0.0",
+    "skweb-express-jwt": "^1.0.0",
+    "skweb-express-logger": "^1.0.0",
+    "skweb-sequelize": "^1.0.0",
+    "skweb-redis": "^1.0.0",
+    "skweb-cron": "^1.0.0",
+    "skweb-framework": "^1.0.0",
+    "skweb-plugin": "^1.0.0",
+    "skweb-util": "^1.0.0",
+    "winston": "^3.17.0",
+    "sequelize": "^6.37.7"
+  },
+  "devDependencies": {
+    "chai": "^6.2.1",
+    "mocha": "^11.7.5",
+    "eslint": "^9.39.1",
+    "@eslint/js": "^9.39.1"
+  },
+  "engines": {
+    "node": ">=20.18.1"
+  }
+}

package/templates/cjs/src/app.js

@@ -0,0 +1,91 @@
+require('dotenv/config')
+
+const path = require('path')
+const express = require('skweb-express')
+const expressLogger = require('skweb-express-logger').default || require('skweb-express-logger')
+const { WebFramework } = require('skweb-framework')
+const { logger } = require('./utils/logger.js')
+const { checkRequiredEnv } = require('./utils/config.js')
+
+async function bootstrap() {
+  logger.info('[app] Initializing web process...')
+
+  if (!checkRequiredEnv()) {
+    logger.error('[app] Configuration validation failed, exiting...')
+    process.exit(1)
+  }
+
+  const framework = new WebFramework({
+    db: {
+      host: process.env.DB_HOST || '127.0.0.1',
+      port: Number(process.env.DB_PORT) || 3306,
+      username: process.env.DB_USER || 'root',
+      password: process.env.DB_PASS || '',
+      database: process.env.DB_NAME || 'test-project',
+      dialect: process.env.DB_DIALECT || 'mysql',
+      charset: process.env.DB_CHARSET || 'utf8mb4',
+      underscored: true,
+      logging: process.env.DEBUG_DB === 'true' ? (msg) => logger.debug(msg) : false
+    },
+    redis: {
+      host: process.env.REDIS_HOST || '127.0.0.1',
+      port: Number(process.env.REDIS_PORT) || 6379,
+      password: process.env.REDIS_PASSWORD || undefined
+    }
+  })
+
+  await framework.runPluginBeforeSetup()
+  await framework.setupModels(path.join(__dirname, './models'))
+  await framework.loadPluginModels()
+  await framework.runPluginAfterSetup()
+
+  const app = framework.createApp()
+
+  app.disable('x-powered-by')
+  app.disable('etag')
+
+  app.set('trust proxy', true)
+
+  app.set('wrap response', true)
+  app.setOkCode(0)
+  app.setOkMessage('success')
+
+  app.setJWT('default', {
+    secret: process.env.JWT_SECRET || 'please-change-this-in-production',
+    algorithms: ['HS256'],
+    sign: { expiresIn: process.env.JWT_EXPIRES_IN || '7d' },
+    requestProperty: 'resolvedToken'
+  })
+  app.setJwtHintHeader('JwtHint')
+
+  app.use(expressLogger())
+  app.use(express.static(path.join(__dirname, '..', 'public')))
+
+  await framework.loadControllers(path.join(__dirname, './controllers'))
+  await framework.loadPluginControllers()
+
+  framework.start(Number(process.env.PORT) || 3000)
+
+  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)
+  })
+
+  process.on('SIGTERM', async () => {
+    logger.info('[app] Received SIGTERM, shutting down gracefully...')
+    await framework.stop()
+    process.exit(0)
+  })
+}
+
+if (require.main === module) {
+  bootstrap().catch((err) => {
+    logger.error('[app] Fatal error:', err)
+    process.exit(1)
+  })
+}
+
+module.exports = { bootstrap }

package/templates/cjs/src/commands/migrate.js

@@ -0,0 +1,35 @@
+require('dotenv/config')
+
+const path = require('path')
+const { Database } = require('skweb-sequelize')
+const { logger } = require('../utils/logger.js')
+
+async function runMigrate() {
+  logger.info('[migrate] Running database migrations...')
+
+  const db = new Database({
+    host: process.env.DB_HOST || '127.0.0.1',
+    port: Number(process.env.DB_PORT) || 3306,
+    username: process.env.DB_USER || 'root',
+    password: process.env.DB_PASS || '',
+    database: process.env.DB_NAME || 'test-project',
+    dialect: process.env.DB_DIALECT || 'mysql',
+    charset: process.env.DB_CHARSET || 'utf8mb4',
+    underscored: true,
+    logging: process.env.DEBUG_DB === 'true' ? (msg) => logger.debug(msg) : false
+  })
+
+  await db.loadModelsDir(path.join(__dirname, '..', 'models'))
+  db.associateAllModels()
+  await db.sequelize.sync({ alter: true })
+  logger.info('[migrate] Database schema synced')
+}
+
+if (require.main === module) {
+  runMigrate().catch((err) => {
+    logger.error('[migrate] Fatal error:', err)
+    process.exit(1)
+  })
+}
+
+module.exports = { runMigrate }

package/templates/cjs/src/commands/seed.js

@@ -0,0 +1,58 @@
+require('dotenv/config')
+
+const path = require('path')
+const fs = require('fs')
+const { Database } = require('skweb-sequelize')
+const { logger } = require('../utils/logger.js')
+
+async function runSeed() {
+  logger.info('[seed] Initializing database with seed data...')
+
+  const db = new Database({
+    host: process.env.DB_HOST || '127.0.0.1',
+    port: Number(process.env.DB_PORT) || 3306,
+    username: process.env.DB_USER || 'root',
+    password: process.env.DB_PASS || '',
+    database: process.env.DB_NAME || 'test-project',
+    dialect: process.env.DB_DIALECT || 'mysql',
+    charset: process.env.DB_CHARSET || 'utf8mb4',
+    underscored: true,
+    logging: process.env.DEBUG_DB === 'true' ? (msg) => logger.debug(msg) : false
+  })
+
+  await db.loadModelsDir(path.join(__dirname, '..', 'models'))
+  db.associateAllModels()
+
+  const seedsDir = path.join(__dirname, '..', 'seeds')
+  if (!fs.existsSync(seedsDir)) {
+    logger.warn('[seed] No seeds directory found')
+    return
+  }
+
+  const files = fs.readdirSync(seedsDir)
+  for (const file of files) {
+    if (!file.endsWith('.json')) continue
+    const modelName = path.basename(file, '.json')
+    const Model = db.sequelize.models[modelName]
+    if (!Model) {
+      logger.warn(`[seed] Model ${modelName} not found`)
+      continue
+    }
+    const data = JSON.parse(fs.readFileSync(path.join(seedsDir, file), 'utf-8'))
+    if (Array.isArray(data) && data.length > 0) {
+      await Model.bulkCreate(data, { ignoreDuplicates: true })
+      logger.info(`[seed] Seeded ${modelName} with ${data.length} records`)
+    }
+  }
+
+  logger.info('[seed] Database initialization complete')
+}
+
+if (require.main === module) {
+  runSeed().catch((err) => {
+    logger.error('[seed] Fatal error:', err)
+    process.exit(1)
+  })
+}
+
+module.exports = { runSeed }

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

@@ -0,0 +1,33 @@
+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
+      }
+    }
+  }
+]