create-hest-app 0.1.0

package/templates/cqrs/src/modules/users/users.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@hestjs/core';
+import { UsersController } from './users.controller';
+import { UsersService } from './users.service';
+
+@Module({
+  controllers: [UsersController],
+  providers: [UsersService],
+  exports: [UsersService],
+})
+export class UsersModule {}

package/templates/cqrs/src/modules/users/users.service.ts

@@ -0,0 +1,55 @@
+import { Injectable } from '@hestjs/core';
+import type { User } from './entities/user.entity';
+import type { CreateUserDto, UpdateUserDto } from './dto/user.dto';
+
+/**
+ * 用户服务
+ */
+@Injectable()
+export class UsersService {
+  private users: User[] = [
+    { id: 1, name: 'John Doe', email: 'john@example.com', age: 30 },
+    { id: 2, name: 'Jane Smith', email: 'jane@example.com', age: 25 },
+  ];
+
+  findAll(): User[] {
+    return this.users;
+  }
+
+  findOne(id: number): User | undefined {
+    return this.users.find(user => user.id === id);
+  }
+
+  create(createUserDto: CreateUserDto): Omit<User, 'password'> {
+    const newUser: User = {
+      id: this.users.length + 1,
+      ...createUserDto,
+    };
+    this.users.push(newUser);
+
+    // 不返回密码
+    const { password: _password, ...userWithoutPassword } = newUser;
+    return userWithoutPassword;
+  }
+
+  update(id: number, updateUserDto: UpdateUserDto): User {
+    const userIndex = this.users.findIndex(user => user.id === id);
+    if (userIndex === -1) {
+      throw new Error('User not found');
+    }
+
+    this.users[userIndex] = { ...this.users[userIndex], ...updateUserDto };
+    return this.users[userIndex];
+  }
+
+  remove(id: number): User {
+    const userIndex = this.users.findIndex(user => user.id === id);
+    if (userIndex === -1) {
+      throw new Error('User not found');
+    }
+
+    const deletedUser = this.users[userIndex];
+    this.users.splice(userIndex, 1);
+    return deletedUser;
+  }
+}

package/templates/cqrs/src/test-error-scenarios.ts

@@ -0,0 +1,54 @@
+import { logger } from '@hestjs/logger';
+
+// 模拟应用启动时的错误处理
+async function testErrorScenarios() {
+  console.log('=== Testing Real-world Error Scenarios ===\n');
+
+  // 场景 1: 数据库连接错误
+  try {
+    throw new Error('Database connection failed');
+  } catch (error) {
+    logger.error(
+      '❌ Failed to connect to database:',
+      error instanceof Error ? error : new Error(String(error)),
+    );
+  }
+
+  // 场景 2: API 调用失败
+  try {
+    const apiError = new Error('API request timeout');
+    (apiError as any).status = 504;
+    (apiError as any).endpoint = '/api/users';
+    throw apiError;
+  } catch (error) {
+    logger.error(
+      '❌ API call failed:',
+      error instanceof Error ? error : new Error(String(error)),
+      {
+        requestId: 'req-12345',
+        userId: 'user-67890',
+      },
+    );
+  }
+
+  // 场景 3: 验证错误
+  try {
+    const validationError = new Error('Validation failed');
+    (validationError as any).fields = ['email', 'password'];
+    (validationError as any).code = 'VALIDATION_ERROR';
+    throw validationError;
+  } catch (error) {
+    logger.error(
+      '❌ Validation failed:',
+      error instanceof Error ? error : new Error(String(error)),
+    );
+  }
+
+  // 场景 4: 使用简化的语法
+  const simpleError = new Error('Something went wrong');
+  logger.error('❌ Simple error logging:', simpleError);
+
+  console.log('\n=== Test Complete ===');
+}
+
+testErrorScenarios();

package/templates/cqrs/src/users/commands/create-user.command.ts

@@ -0,0 +1,8 @@
+import { Command } from '@hestjs/cqrs';
+import { CreateUserData, User } from '../entities';
+
+export class CreateUserCommand extends Command<User> {
+  constructor(public readonly userData: CreateUserData) {
+    super();
+  }
+}

package/templates/cqrs/src/users/commands/index.ts

@@ -0,0 +1,2 @@
+export * from './create-user.command';
+export * from './update-user.command';

package/templates/cqrs/src/users/commands/update-user.command.ts

@@ -0,0 +1,11 @@
+import { Command } from '@hestjs/cqrs';
+import { UpdateUserData, User } from '../entities';
+
+export class UpdateUserCommand extends Command<User> {
+  constructor(
+    public readonly userId: string,
+    public readonly userData: UpdateUserData,
+  ) {
+    super();
+  }
+}

package/templates/cqrs/src/users/entities/index.ts

@@ -0,0 +1 @@
+export * from './user.entity';

package/templates/cqrs/src/users/entities/user.entity.ts

@@ -0,0 +1,22 @@
+import { IQueryResult } from '@hestjs/cqrs';
+
+export interface User extends IQueryResult {
+  id: string;
+  name: string;
+  email: string;
+  age?: number;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface CreateUserData {
+  name: string;
+  email: string;
+  age?: number;
+}
+
+export interface UpdateUserData {
+  name?: string;
+  email?: string;
+  age?: number;
+}

package/templates/cqrs/src/users/events/index.ts

@@ -0,0 +1,2 @@
+export * from './user-created.event';
+export * from './user-updated.event';

package/templates/cqrs/src/users/events/user-created.event.ts

@@ -0,0 +1,8 @@
+import { Event } from '@hestjs/cqrs';
+import { User } from '../entities';
+
+export class UserCreatedEvent extends Event {
+  constructor(public readonly user: User) {
+    super();
+  }
+}

package/templates/cqrs/src/users/events/user-updated.event.ts

@@ -0,0 +1,8 @@
+import { Event } from '@hestjs/cqrs';
+import { User } from '../entities';
+
+export class UserUpdatedEvent extends Event {
+  constructor(public readonly user: User) {
+    super();
+  }
+}

package/templates/cqrs/src/users/handlers/create-user.handler.ts

@@ -0,0 +1,26 @@
+import { Injectable } from '@hestjs/core';
+import { CommandHandler, EventBus, ICommandHandler } from '@hestjs/cqrs';
+import { CreateUserCommand } from '../commands';
+import { User } from '../entities';
+import { UserCreatedEvent } from '../events';
+import { UserRepository } from '../repositories';
+
+@Injectable()
+@CommandHandler(CreateUserCommand)
+export class CreateUserHandler
+  implements ICommandHandler<CreateUserCommand, User>
+{
+  constructor(
+    private readonly userRepository: UserRepository,
+    private readonly eventBus: EventBus,
+  ) {}
+
+  async execute(command: CreateUserCommand): Promise<User> {
+    const user = await this.userRepository.create(command.userData);
+
+    // 发布用户创建事件
+    await this.eventBus.publish(new UserCreatedEvent(user));
+
+    return user;
+  }
+}

package/templates/cqrs/src/users/handlers/get-all-users.handler.ts

@@ -0,0 +1,15 @@
+import { Injectable } from '@hestjs/core';
+import { QueryHandler, IQueryHandler } from '@hestjs/cqrs';
+import { GetAllUsersQuery, GetAllUsersResult } from '../queries';
+import { UserRepository } from '../repositories';
+
+@Injectable()
+@QueryHandler(GetAllUsersQuery)
+export class GetAllUsersHandler implements IQueryHandler<GetAllUsersQuery, GetAllUsersResult> {
+  constructor(private readonly userRepository: UserRepository) {}
+
+  async execute(_query: GetAllUsersQuery): Promise<GetAllUsersResult> {
+    const users = await this.userRepository.findAll();
+    return { users };
+  }
+}

package/templates/cqrs/src/users/handlers/get-user.handler.ts

@@ -0,0 +1,15 @@
+import { Injectable } from '@hestjs/core';
+import { QueryHandler, IQueryHandler } from '@hestjs/cqrs';
+import { GetUserQuery, GetUserResult } from '../queries';
+import { UserRepository } from '../repositories';
+
+@Injectable()
+@QueryHandler(GetUserQuery)
+export class GetUserHandler implements IQueryHandler<GetUserQuery, GetUserResult> {
+  constructor(private readonly userRepository: UserRepository) {}
+
+  async execute(query: GetUserQuery): Promise<GetUserResult> {
+    const user = await this.userRepository.findById(query.userId);
+    return { user };
+  }
+}

package/templates/cqrs/src/users/handlers/index.ts

@@ -0,0 +1,6 @@
+export * from './create-user.handler';
+export * from './update-user.handler';
+export * from './get-user.handler';
+export * from './get-all-users.handler';
+export * from './user-created.handler';
+export * from './user-updated.handler';

package/templates/cqrs/src/users/handlers/update-user.handler.ts

@@ -0,0 +1,33 @@
+import { Injectable } from '@hestjs/core';
+import { CommandHandler, EventBus, ICommandHandler } from '@hestjs/cqrs';
+import { UpdateUserCommand } from '../commands';
+import { User } from '../entities';
+import { UserUpdatedEvent } from '../events';
+import { UserRepository } from '../repositories';
+
+@Injectable()
+@CommandHandler(UpdateUserCommand)
+export class UpdateUserHandler
+  implements ICommandHandler<UpdateUserCommand, User>
+{
+  constructor(
+    private readonly userRepository: UserRepository,
+    private readonly eventBus: EventBus,
+  ) {}
+
+  async execute(command: UpdateUserCommand): Promise<User> {
+    const user = await this.userRepository.update(
+      command.userId,
+      command.userData,
+    );
+
+    if (!user) {
+      throw new Error(`User with id ${command.userId} not found`);
+    }
+
+    // 发布用户更新事件
+    await this.eventBus.publish(new UserUpdatedEvent(user));
+
+    return user;
+  }
+}

package/templates/cqrs/src/users/handlers/user-created.handler.ts

@@ -0,0 +1,15 @@
+import { Injectable } from '@hestjs/core';
+import { EventsHandler, IEventHandler } from '@hestjs/cqrs';
+import { logger } from '@hestjs/logger';
+import { UserCreatedEvent } from '../events';
+
+@Injectable()
+@EventsHandler(UserCreatedEvent)
+export class UserCreatedHandler implements IEventHandler<UserCreatedEvent> {
+  async handle(event: UserCreatedEvent): Promise<void> {
+    logger.info(`User created: ${event.user.name} (${event.user.email})`);
+
+    // 这里可以执行其他业务逻辑，比如发送欢迎邮件等
+    // await this.emailService.sendWelcomeEmail(event.user);
+  }
+}

package/templates/cqrs/src/users/handlers/user-updated.handler.ts

@@ -0,0 +1,15 @@
+import { Injectable } from '@hestjs/core';
+import { EventsHandler, IEventHandler } from '@hestjs/cqrs';
+import { logger } from '@hestjs/logger';
+import { UserUpdatedEvent } from '../events';
+
+@Injectable()
+@EventsHandler(UserUpdatedEvent)
+export class UserUpdatedHandler implements IEventHandler<UserUpdatedEvent> {
+  async handle(event: UserUpdatedEvent): Promise<void> {
+    logger.info(`User updated: ${event.user.name} (${event.user.email})`);
+
+    // 这里可以执行其他业务逻辑，比如发送通知等
+    // await this.notificationService.sendUpdateNotification(event.user);
+  }
+}

package/templates/cqrs/src/users/index.ts

@@ -0,0 +1,8 @@
+export * from './entities';
+export * from './commands';
+export * from './queries';
+export * from './events';
+export * from './handlers';
+export * from './repositories';
+export * from './user.controller';
+export * from './user.module';

package/templates/cqrs/src/users/queries/get-all-users.query.ts

@@ -0,0 +1,8 @@
+import { Query, IQueryResult } from '@hestjs/cqrs';
+import { User } from '../entities';
+
+export interface GetAllUsersResult extends IQueryResult {
+  users: User[];
+}
+
+export class GetAllUsersQuery extends Query<GetAllUsersResult> {}

package/templates/cqrs/src/users/queries/get-user.query.ts

@@ -0,0 +1,12 @@
+import { Query, IQueryResult } from '@hestjs/cqrs';
+import { User } from '../entities';
+
+export interface GetUserResult extends IQueryResult {
+  user: User | null;
+}
+
+export class GetUserQuery extends Query<GetUserResult> {
+  constructor(public readonly userId: string) {
+    super();
+  }
+}

package/templates/cqrs/src/users/queries/index.ts

@@ -0,0 +1,2 @@
+export * from './get-user.query';
+export * from './get-all-users.query';

package/templates/cqrs/src/users/repositories/index.ts

@@ -0,0 +1 @@
+export * from './user.repository';

package/templates/cqrs/src/users/repositories/user.repository.ts

@@ -0,0 +1,51 @@
+import { Injectable } from '@hestjs/core';
+import { User, CreateUserData, UpdateUserData } from '../entities';
+
+@Injectable()
+export class UserRepository {
+  private users: Map<string, User> = new Map();
+  private nextId = 1;
+
+  async create(userData: CreateUserData): Promise<User> {
+    const id = this.nextId.toString();
+    this.nextId++;
+
+    const user: User = {
+      id,
+      ...userData,
+      createdAt: new Date(),
+      updatedAt: new Date(),
+    };
+
+    this.users.set(id, user);
+    return user;
+  }
+
+  async findById(id: string): Promise<User | null> {
+    return this.users.get(id) || null;
+  }
+
+  async findAll(): Promise<User[]> {
+    return Array.from(this.users.values());
+  }
+
+  async update(id: string, userData: UpdateUserData): Promise<User | null> {
+    const user = this.users.get(id);
+    if (!user) {
+      return null;
+    }
+
+    const updatedUser: User = {
+      ...user,
+      ...userData,
+      updatedAt: new Date(),
+    };
+
+    this.users.set(id, updatedUser);
+    return updatedUser;
+  }
+
+  async delete(id: string): Promise<boolean> {
+    return this.users.delete(id);
+  }
+}

package/templates/cqrs/src/users/user.controller.ts

@@ -0,0 +1,66 @@
+import { Controller, Get, Post, Put, Context } from '@hestjs/core';
+import type { HestContext } from '@hestjs/core';
+import { CommandBus, QueryBus } from '@hestjs/cqrs';
+import { CreateUserCommand, UpdateUserCommand } from './commands';
+import { CreateUserData, UpdateUserData } from './entities';
+import { GetAllUsersQuery, GetUserQuery } from './queries';
+
+@Controller('/users')
+export class UserController {
+  constructor(
+    private readonly commandBus: CommandBus,
+    private readonly queryBus: QueryBus,
+  ) {}
+
+  @Post('/')
+  async createUser(@Context() c: HestContext) {
+    const userData = await c.req.json<CreateUserData>();
+
+    // 基本验证（可以添加更复杂的验证逻辑）
+    if (!userData.name || !userData.email) {
+      return c.json(
+        { success: false, error: 'Name and email are required' },
+        400,
+      );
+    }
+
+    const user = await this.commandBus.execute(new CreateUserCommand(userData));
+    return c.json({ success: true, data: user }, 201);
+  }
+
+  @Get('/')
+  async getAllUsers(@Context() c: HestContext) {
+    const result = await this.queryBus.execute(new GetAllUsersQuery());
+    return c.json({ success: true, data: result.users });
+  }
+
+  @Get('/:id')
+  async getUserById(@Context() c: HestContext) {
+    const id = c.req.param('id');
+    const result = await this.queryBus.execute(new GetUserQuery(id));
+
+    if (!result.user) {
+      return c.json({ success: false, error: 'User not found' }, 404);
+    }
+
+    return c.json({ success: true, data: result.user });
+  }
+
+  @Put('/:id')
+  async updateUser(@Context() c: HestContext) {
+    const id = c.req.param('id');
+    const userData = await c.req.json<UpdateUserData>();
+
+    try {
+      const user = await this.commandBus.execute(
+        new UpdateUserCommand(id, userData),
+      );
+      return c.json({ success: true, data: user });
+    } catch (error) {
+      if (error instanceof Error && error.message.includes('not found')) {
+        return c.json({ success: false, error: 'User not found' }, 404);
+      }
+      throw error;
+    }
+  }
+}

package/templates/cqrs/src/users/user.module.ts

@@ -0,0 +1,30 @@
+import { Module } from '@hestjs/core';
+import { CqrsModule } from '@hestjs/cqrs';
+import { UserController } from './user.controller';
+import { UserRepository } from './repositories';
+import {
+  CreateUserHandler,
+  UpdateUserHandler,
+  GetUserHandler,
+  GetAllUsersHandler,
+  UserCreatedHandler,
+  UserUpdatedHandler,
+} from './handlers';
+
+@Module({
+  imports: [CqrsModule],
+  controllers: [UserController],
+  providers: [
+    UserRepository,
+    // Command Handlers
+    CreateUserHandler,
+    UpdateUserHandler,
+    // Query Handlers
+    GetUserHandler,
+    GetAllUsersHandler,
+    // Event Handlers
+    UserCreatedHandler,
+    UserUpdatedHandler,
+  ],
+})
+export class UserModule {}

package/templates/cqrs/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "extends": "@hestjs/typescript-config/base.json",
+  "compilerOptions": {
+    "strict": true,
+    "jsx": "react-jsx",
+    "jsxImportSource": "hono/jsx",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "./dist",
+    "declaration": true,
+    "sourceMap": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
+}

package/templates/cqrs_scalar/.prettierrc

@@ -0,0 +1,33 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "quoteProps": "as-needed",
+  "tabWidth": 2,
+  "printWidth": 80,
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "endOfLine": "lf",
+  "useTabs": false,
+  "overrides": [
+    {
+      "files": "*.json",
+      "options": {
+        "singleQuote": false
+      }
+    },
+    {
+      "files": "*.md",
+      "options": {
+        "proseWrap": "preserve"
+      }
+    },
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "options": {
+        "singleQuote": true,
+        "semi": true
+      }
+    }
+  ]
+}

package/templates/cqrs_scalar/.vscode/extensions.json

@@ -0,0 +1,79 @@
+{
+  "recommendations": [
+    // Cline
+    "saoudrizwan.claude-dev",
+
+    // Code Runner
+    "formulahendry.code-runner",
+
+    // Color Highlight
+    "naumovs.color-highlight",
+
+    // Draw Folder Structure
+    "jmkrivocapich.drawfolderstructure",
+
+    // ESLint
+    "dbaeumer.vscode-eslint",
+
+    // Git Graph
+    "mhutchie.git-graph",
+
+    // GitHub Copilot
+    "GitHub.copilot",
+
+    // GitHub Copilot Chat
+    "GitHub.copilot-chat",
+
+    // Github Actions
+    "github.vscode-github-actions",
+
+    // i18n Ally
+    "lokalise.i18n-ally",
+
+    // Iconify IntelliSense
+    "antfu.iconify",
+
+    // Indenticator
+    "SirTori.indenticator",
+
+    // Jest
+    "Orta.vscode-jest",
+
+    // Lingma - Alibaba
+    "Alibaba-Cloud.tongyi-lingma",
+
+    // Monorepo Workspace
+    "folke.vscode-monorepo-workspace",
+
+    // Prettier
+    "esbenp.prettier-vscode",
+
+    // Pretty TypeScript Errors
+    "YoavBls.pretty-ts-errors",
+
+    // Prisma
+    "Prisma.prisma",
+
+    // ,Todo Tree
+    "Gruntfuggly.todo-tree",
+
+    // Git Tags
+    "howardzuo.vscode-git-tags",
+
+    // JSON Comments
+    "wxzhang.json-comments",
+
+    // Markdown 相关
+    "kortina.vscode-markdown-notes",
+    "bierner.markdown-mermaid",
+    "DavidAnson.vscode-markdownlint",
+    "yzhang.markdown-all-in-one",
+    "zaaack.markdown-editor",
+
+    // 半透明背景
+    "illixion.vscode-vibrancy-continued",
+
+    // tailwindcss
+    "bradlc.vscode-tailwindcss"
+  ]
+}