create-hest-app 0.1.0

package/templates/cqrs_scalar/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_scalar/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_scalar/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_scalar/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_scalar/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_scalar/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_scalar/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_scalar/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_scalar/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_scalar/src/users/queries/index.ts

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

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

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

package/templates/cqrs_scalar/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_scalar/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_scalar/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_scalar/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/*"]
+    }
+  }
+}