speedrun-cli 2.6.1

package/templates/base-crud/src/common/base/base.service.ts

@@ -0,0 +1,192 @@
+import {
+  Injectable,
+  NotFoundException,
+  BadRequestException,
+  Logger,
+  Type,
+} from '@nestjs/common';
+import { PaginationQueryDto, PaginatedResponseDto } from './swagger/paginated.dto';
+
+// ─────────────────────────────────────────────────────────────
+// Repository Contract Interface
+// Implement this interface in your concrete repository/service
+// to fulfill the abstract contract required by BaseService.
+// ─────────────────────────────────────────────────────────────
+export interface IBaseRepository<T, CreateDto, UpdateDto> {
+  create(dto: CreateDto): Promise<T>;
+  findAll(pagination: PaginationQueryDto): Promise<{ data: T[]; total: number }>;
+  findOne(id: string | number): Promise<T | null>;
+  update(id: string | number, dto: UpdateDto): Promise<T>;
+  remove(id: string | number): Promise<T>;
+}
+
+// ─────────────────────────────────────────────────────────────
+// Abstract Base Service
+//
+// Generic parameters:
+//   T         — Entity / Document type (e.g. Product, User)
+//   CreateDto — DTO for creation (e.g. CreateProductDto)
+//   UpdateDto — DTO for updates (e.g. UpdateProductDto)
+//
+// How to extend:
+// @Injectable()
+// export class ProductsService extends BaseService<Product, CreateProductDto, UpdateProductDto> {
+//   constructor(private readonly prisma: PrismaService) { super(); }
+//   protected getRepository(): IBaseRepository<...> { return new ProductRepository(this.prisma); }
+// }
+// ─────────────────────────────────────────────────────────────
+@Injectable()
+export abstract class BaseService<T, CreateDto, UpdateDto> {
+  protected readonly logger: Logger;
+
+  constructor() {
+    // Logger uses the concrete class name for traceability
+    this.logger = new Logger(this.constructor.name);
+  }
+
+  /**
+   * Subclasses MUST implement this to provide the data-access repository.
+   * This decouples the base service from any specific ORM/database driver.
+   */
+  protected abstract getRepository(): IBaseRepository<T, CreateDto, UpdateDto>;
+
+  // ─────────────────────────────────────────────────────────
+  // CREATE
+  // ─────────────────────────────────────────────────────────
+  /**
+   * Creates a new resource.
+   * The DTO is already validated and whitelisted by the global ValidationPipe.
+   *
+   * @param createDto - Validated creation payload
+   * @returns The newly created entity
+   * @throws BadRequestException on constraint violations (propagated from repo)
+   */
+  async create(createDto: CreateDto): Promise<T> {
+    try {
+      this.logger.debug(`Creating new ${this.constructor.name.replace('Service', '')} record`);
+      const entity = await this.getRepository().create(createDto);
+      this.logger.log(`Created record successfully`);
+      return entity;
+    } catch (error) {
+      if (error instanceof BadRequestException || error instanceof NotFoundException) {
+        throw error;
+      }
+      this.logger.error(`Failed to create record: ${(error as Error).message}`, (error as Error).stack);
+      throw new BadRequestException('Failed to create resource. Please check your input and try again.');
+    }
+  }
+
+  // ─────────────────────────────────────────────────────────
+  // READ ALL (Paginated)
+  // ─────────────────────────────────────────────────────────
+  /**
+   * Retrieves a paginated list of resources.
+   *
+   * @param pagination - Validated pagination query params (page, limit)
+   * @returns PaginatedResponseDto wrapping the result array and meta
+   */
+  async findAll(pagination: PaginationQueryDto): Promise<PaginatedResponseDto<T>> {
+    const { page = 1, limit = 10 } = pagination;
+    this.logger.debug(`Fetching records: page=${page}, limit=${limit}`);
+
+    const { data, total } = await this.getRepository().findAll(pagination);
+
+    const totalPages = Math.ceil(total / limit);
+
+    return {
+      success: true,
+      data,
+      meta: {
+        total,
+        page,
+        limit,
+        totalPages,
+        hasNext: page < totalPages,
+        hasPrevious: page > 1,
+      },
+    };
+  }
+
+  // ─────────────────────────────────────────────────────────
+  // READ ONE
+  // ─────────────────────────────────────────────────────────
+  /**
+   * Retrieves a single resource by its unique identifier.
+   *
+   * @param id - Entity ID (UUID string or integer, validated by pipe in controller)
+   * @returns The found entity
+   * @throws NotFoundException if no record exists with the given ID
+   */
+  async findOne(id: string | number): Promise<T> {
+    this.logger.debug(`Fetching record with id=${id}`);
+    const entity = await this.getRepository().findOne(id);
+
+    if (!entity) {
+      this.logger.warn(`Record not found: id=${id}`);
+      throw new NotFoundException(`Resource with id "${id}" was not found`);
+    }
+
+    return entity;
+  }
+
+  // ─────────────────────────────────────────────────────────
+  // UPDATE
+  // ─────────────────────────────────────────────────────────
+  /**
+   * Updates an existing resource (partial update — PATCH semantics).
+   * Validates existence before applying update.
+   *
+   * @param id - Entity ID
+   * @param updateDto - Validated partial update payload
+   * @returns The updated entity
+   * @throws NotFoundException if no record exists with the given ID
+   * @throws BadRequestException on constraint violations
+   */
+  async update(id: string | number, updateDto: UpdateDto): Promise<T> {
+    // Validate existence first (throws 404 if not found)
+    await this.findOne(id);
+
+    try {
+      this.logger.debug(`Updating record: id=${id}`);
+      const updated = await this.getRepository().update(id, updateDto);
+      this.logger.log(`Updated record: id=${id}`);
+      return updated;
+    } catch (error) {
+      if (error instanceof BadRequestException || error instanceof NotFoundException) {
+        throw error;
+      }
+      this.logger.error(`Failed to update record id=${id}: ${(error as Error).message}`, (error as Error).stack);
+      throw new BadRequestException('Failed to update resource. Please check your input and try again.');
+    }
+  }
+
+  // ─────────────────────────────────────────────────────────
+  // REMOVE (Soft Delete)
+  // ─────────────────────────────────────────────────────────
+  /**
+   * Soft-deletes a resource by setting `deletedAt` timestamp via the repository.
+   * Validates existence before deletion.
+   *
+   * NOTE: Your ORM entity MUST have a `deletedAt?: Date` field for soft-delete.
+   * For hard-delete, override this method in the concrete service.
+   *
+   * @param id - Entity ID
+   * @returns The soft-deleted entity snapshot
+   * @throws NotFoundException if no record exists with the given ID
+   */
+  async remove(id: string | number): Promise<T> {
+    // Validate existence first (throws 404 if not found)
+    await this.findOne(id);
+
+    try {
+      this.logger.debug(`Soft-deleting record: id=${id}`);
+      const deleted = await this.getRepository().remove(id);
+      this.logger.log(`Soft-deleted record: id=${id}`);
+      return deleted;
+    } catch (error) {
+      if (error instanceof NotFoundException) throw error;
+      this.logger.error(`Failed to remove record id=${id}: ${(error as Error).message}`, (error as Error).stack);
+      throw new BadRequestException('Failed to delete resource.');
+    }
+  }
+}

package/templates/base-crud/src/common/base/index.ts

@@ -0,0 +1,20 @@
+/**
+ * Base CRUD Architecture
+ * Barrel export for src/common/base
+ *
+ * @example
+ * import { BaseService, BaseController, PaginationQueryDto } from '../common/base';
+ */
+
+export { BaseService } from './base.service';
+export type { IBaseRepository } from './base.service';
+export { BaseController } from './base.controller';
+
+// Swagger DTOs
+export { ApiResponseDto, ApiMetaDto, ApiResponseSchema, ApiResponseArraySchema } from './swagger/api-response.dto';
+export {
+  PaginationQueryDto,
+  PaginationMetaDto,
+  PaginatedResponseDto,
+  PaginatedResponseSchema,
+} from './swagger/paginated.dto';

package/templates/base-crud/src/common/base/swagger/api-response.dto.ts

@@ -0,0 +1,82 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+
+// ─────────────────────────────────────────────────────────────
+// Meta Information DTO
+// ─────────────────────────────────────────────────────────────
+export class ApiMetaDto {
+  @ApiProperty({ description: 'Request correlation ID', example: 'abc-123' })
+  correlationId: string;
+
+  @ApiProperty({ description: 'Response timestamp (ISO 8601)', example: '2025-01-01T00:00:00.000Z' })
+  timestamp: string;
+
+  @ApiPropertyOptional({ description: 'Optional message about the operation', example: 'Product created successfully' })
+  message?: string;
+}
+
+// ─────────────────────────────────────────────────────────────
+// Generic API Response DTO Wrapper
+// Used with @ApiExtraModels + $ref for proper Swagger generic rendering
+// ─────────────────────────────────────────────────────────────
+export class ApiResponseDto<T = unknown> {
+  @ApiProperty({ description: 'Indicates if the request was successful', example: true })
+  success: boolean;
+
+  @ApiPropertyOptional({ description: 'Response payload (varies by endpoint)' })
+  data?: T;
+
+  @ApiPropertyOptional({ description: 'Error message (only present on failure)', example: 'Resource not found' })
+  message?: string;
+
+  @ApiProperty({ type: () => ApiMetaDto })
+  meta: ApiMetaDto;
+}
+
+// ─────────────────────────────────────────────────────────────
+// Factory Helper for Swagger Schema Injection
+// Usage: @ApiOkResponse(ApiResponseSchema(ProductDto))
+// ─────────────────────────────────────────────────────────────
+import { getSchemaPath } from '@nestjs/swagger';
+import { Type } from '@nestjs/common';
+
+/**
+ * Generates an inline Swagger schema for ApiResponseDto<T>.
+ * Use this with @ApiOkResponse({ schema: ApiResponseSchema(YourDto) }).
+ *
+ * @example
+ * \@ApiOkResponse({ schema: ApiResponseSchema(ProductDto) })
+ */
+export function ApiResponseSchema<T>(dataType: Type<T>) {
+  return {
+    allOf: [
+      { $ref: getSchemaPath(ApiResponseDto) },
+      {
+        properties: {
+          data: { $ref: getSchemaPath(dataType) },
+        },
+      },
+    ],
+  };
+}
+
+/**
+ * Generates an inline Swagger schema for ApiResponseDto<T[]> (array response).
+ *
+ * @example
+ * \@ApiOkResponse({ schema: ApiResponseArraySchema(ProductDto) })
+ */
+export function ApiResponseArraySchema<T>(dataType: Type<T>) {
+  return {
+    allOf: [
+      { $ref: getSchemaPath(ApiResponseDto) },
+      {
+        properties: {
+          data: {
+            type: 'array',
+            items: { $ref: getSchemaPath(dataType) },
+          },
+        },
+      },
+    ],
+  };
+}

package/templates/base-crud/src/common/base/swagger/paginated.dto.ts

@@ -0,0 +1,102 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsOptional, IsInt, Min, Max } from 'class-validator';
+import { Type } from 'class-transformer';
+import { getSchemaPath } from '@nestjs/swagger';
+import { Type as NestType } from '@nestjs/common';
+
+// ─────────────────────────────────────────────────────────────
+// Pagination Query DTO (Request)
+// Validates & transforms query params: ?page=1&limit=10
+// ─────────────────────────────────────────────────────────────
+export class PaginationQueryDto {
+  @ApiPropertyOptional({
+    description: 'Page number (1-indexed)',
+    example: 1,
+    minimum: 1,
+    default: 1,
+  })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt({ message: 'page must be an integer' })
+  @Min(1, { message: 'page must be at least 1' })
+  page?: number = 1;
+
+  @ApiPropertyOptional({
+    description: 'Number of items per page',
+    example: 10,
+    minimum: 1,
+    maximum: 100,
+    default: 10,
+  })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt({ message: 'limit must be an integer' })
+  @Min(1, { message: 'limit must be at least 1' })
+  @Max(100, { message: 'limit must not exceed 100' })
+  limit?: number = 10;
+}
+
+// ─────────────────────────────────────────────────────────────
+// Pagination Meta DTO (Response)
+// ─────────────────────────────────────────────────────────────
+export class PaginationMetaDto {
+  @ApiProperty({ description: 'Total number of records', example: 250 })
+  total: number;
+
+  @ApiProperty({ description: 'Current page number', example: 1 })
+  page: number;
+
+  @ApiProperty({ description: 'Number of items per page', example: 10 })
+  limit: number;
+
+  @ApiProperty({ description: 'Total number of pages', example: 25 })
+  totalPages: number;
+
+  @ApiProperty({ description: 'Whether a next page exists', example: true })
+  hasNext: boolean;
+
+  @ApiProperty({ description: 'Whether a previous page exists', example: false })
+  hasPrevious: boolean;
+}
+
+// ─────────────────────────────────────────────────────────────
+// Generic Paginated Response DTO Wrapper
+// ─────────────────────────────────────────────────────────────
+export class PaginatedResponseDto<T = unknown> {
+  @ApiPropertyOptional({ description: 'Array of paginated items (type varies by endpoint)' })
+  data: T[];
+
+  @ApiProperty({ type: () => PaginationMetaDto })
+  meta: PaginationMetaDto;
+
+  @ApiProperty({ description: 'Request was successful', example: true })
+  success: boolean;
+}
+
+// ─────────────────────────────────────────────────────────────
+// Factory Helper for Swagger Schema Injection
+// Usage: @ApiOkResponse({ schema: PaginatedResponseSchema(ProductDto) })
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * Generates an inline Swagger schema for PaginatedResponseDto<T>.
+ * Attach with @ApiOkResponse({ schema: PaginatedResponseSchema(YourDto) }).
+ *
+ * @example
+ * \@ApiOkResponse({ schema: PaginatedResponseSchema(ProductDto) })
+ */
+export function PaginatedResponseSchema<T>(dataType: NestType<T>) {
+  return {
+    allOf: [
+      { $ref: getSchemaPath(PaginatedResponseDto) },
+      {
+        properties: {
+          data: {
+            type: 'array',
+            items: { $ref: getSchemaPath(dataType) },
+          },
+        },
+      },
+    ],
+  };
+}

package/templates/base-crud/src/modules/products/dto/create-product.dto.ts

@@ -0,0 +1,44 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import {
+  IsString, IsNotEmpty, IsNumber, IsPositive, IsOptional,
+  IsEnum, MinLength, MaxLength, Min, IsInt, Matches,
+} from 'class-validator';
+import { Type } from 'class-transformer';
+
+export enum ProductStatus {
+  ACTIVE = 'ACTIVE',
+  INACTIVE = 'INACTIVE',
+  OUT_OF_STOCK = 'OUT_OF_STOCK',
+  DISCONTINUED = 'DISCONTINUED',
+}
+
+export class CreateProductDto {
+  @ApiProperty({ description: 'Product name', example: 'Wireless Mechanical Keyboard', minLength: 3, maxLength: 150 })
+  @IsString() @IsNotEmpty() @MinLength(3) @MaxLength(150)
+  name: string;
+
+  @ApiPropertyOptional({ description: 'Product description', example: 'Compact TKL layout with RGB', maxLength: 1000 })
+  @IsOptional() @IsString() @MaxLength(1000)
+  description?: string;
+
+  @ApiProperty({ description: 'Unique SKU (uppercase, numbers, hyphens)', example: 'KB-WL-MEC-001', pattern: '^[A-Z0-9-]+$' })
+  @IsString() @IsNotEmpty()
+  @Matches(/^[A-Z0-9-]+$/, { message: 'sku must contain only uppercase letters, numbers, and hyphens' })
+  sku: string;
+
+  @ApiProperty({ description: 'Price in smallest currency unit (cents)', example: 149999, minimum: 0 })
+  @Type(() => Number) @IsNumber() @IsPositive()
+  price: number;
+
+  @ApiProperty({ description: 'Available stock quantity', example: 250, minimum: 0 })
+  @Type(() => Number) @IsInt() @Min(0)
+  stock: number;
+
+  @ApiPropertyOptional({ description: 'Product category', example: 'Peripherals', maxLength: 100 })
+  @IsOptional() @IsString() @MaxLength(100)
+  category?: string;
+
+  @ApiPropertyOptional({ enum: ProductStatus, default: ProductStatus.ACTIVE, example: ProductStatus.ACTIVE })
+  @IsOptional() @IsEnum(ProductStatus)
+  status?: ProductStatus = ProductStatus.ACTIVE;
+}

package/templates/base-crud/src/modules/products/dto/product.dto.ts

@@ -0,0 +1,38 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { ProductStatus } from './create-product.dto';
+
+/** Product response DTO — shape returned from the API, used by Swagger @ApiExtraModels */
+export class ProductDto {
+  @ApiProperty({ description: 'Product UUID v4', example: '123e4567-e89b-12d3-a456-426614174000', format: 'uuid' })
+  id: string;
+
+  @ApiProperty({ example: 'Wireless Mechanical Keyboard' })
+  name: string;
+
+  @ApiPropertyOptional({ example: 'Compact TKL layout with RGB' })
+  description?: string;
+
+  @ApiProperty({ example: 'KB-WL-MEC-001' })
+  sku: string;
+
+  @ApiProperty({ description: 'Price in cents', example: 149999 })
+  price: number;
+
+  @ApiProperty({ example: 250 })
+  stock: number;
+
+  @ApiPropertyOptional({ example: 'Peripherals' })
+  category?: string;
+
+  @ApiProperty({ enum: ProductStatus, example: ProductStatus.ACTIVE })
+  status: ProductStatus;
+
+  @ApiProperty({ example: '2025-01-01T00:00:00.000Z' })
+  createdAt: Date;
+
+  @ApiProperty({ example: '2025-01-15T08:30:00.000Z' })
+  updatedAt: Date;
+
+  @ApiPropertyOptional({ nullable: true, example: null })
+  deletedAt?: Date | null;
+}

package/templates/base-crud/src/modules/products/dto/update-product.dto.ts

@@ -0,0 +1,12 @@
+import { PartialType } from '@nestjs/swagger';
+import { CreateProductDto } from './create-product.dto';
+
+/**
+ * Update Product DTO
+ *
+ * Uses PartialType from @nestjs/swagger (NOT @nestjs/mapped-types) to:
+ *   1. Make all fields optional (PATCH semantics)
+ *   2. Preserve @ApiProperty decorators for Swagger schema rendering
+ *   3. Keep all class-validator rules active on provided fields
+ */
+export class UpdateProductDto extends PartialType(CreateProductDto) {}

package/templates/base-crud/src/modules/products/products.controller.ts

@@ -0,0 +1,94 @@
+import {
+  Controller,
+  Get,
+  Param,
+  Query,
+  ParseUUIDPipe,
+  HttpStatus,
+  Type,
+} from '@nestjs/common';
+import {
+  ApiTags,
+  ApiOperation,
+  ApiResponse,
+  ApiBearerAuth,
+  ApiExtraModels,
+  ApiParam,
+} from '@nestjs/swagger';
+import { BaseController } from '../../common/base/base.controller';
+import {
+  ApiResponseDto,
+  ApiResponseSchema,
+  PaginatedResponseDto,
+  PaginatedResponseSchema,
+  PaginationQueryDto,
+} from '../../common/base';
+import { ProductsService, ProductEntity } from './products.service';
+import { CreateProductDto } from './dto/create-product.dto';
+import { UpdateProductDto } from './dto/update-product.dto';
+import { ProductDto } from './dto/product.dto';
+
+// ─────────────────────────────────────────────────────────────
+// Products Controller
+//
+// Extends BaseController which provides (via ORM-specific service):
+//   POST   /products          → create()
+//   GET    /products          → findAll()
+//   GET    /products/:id      → findOne()
+//   PUT    /products/:id      → update()
+//   DELETE /products/:id      → remove()
+//
+// @ApiExtraModels registers DTOs so Swagger renders
+// generic ApiResponseDto<ProductDto> and PaginatedResponseDto<ProductDto>.
+// ─────────────────────────────────────────────────────────────
+@ApiTags('Products')
+@ApiBearerAuth('bearer')
+@ApiExtraModels(ApiResponseDto, PaginatedResponseDto, ProductDto)
+@Controller('products')
+export class ProductsController extends BaseController<
+  ProductEntity,
+  CreateProductDto,
+  UpdateProductDto
+> {
+  constructor(private readonly productsService: ProductsService) {
+    super(productsService);
+  }
+
+  protected getDtoClass(): Type<ProductEntity> {
+    return ProductDto as unknown as Type<ProductEntity>;
+  }
+
+  // ── Overrides to inject Swagger response schemas ────────────
+
+  @Get()
+  @ApiOperation({ summary: 'Get all products (paginated)' })
+  @ApiResponse({ status: HttpStatus.OK, description: 'Paginated products', schema: PaginatedResponseSchema(ProductDto) })
+  @ApiResponse({ status: HttpStatus.UNAUTHORIZED, description: 'Unauthorized' })
+  override async findAll(@Query() pagination: PaginationQueryDto): Promise<PaginatedResponseDto<ProductEntity>> {
+    return super.findAll(pagination);
+  }
+
+  @Get('by-sku/:sku')
+  @ApiOperation({ summary: 'Get a product by SKU' })
+  @ApiParam({ name: 'sku', example: 'KB-WL-MEC-001', description: 'Unique Stock Keeping Unit' })
+  @ApiResponse({ status: HttpStatus.OK, description: 'Product found by SKU', schema: ApiResponseSchema(ProductDto) })
+  @ApiResponse({ status: HttpStatus.NOT_FOUND, description: 'Product not found' })
+  @ApiResponse({ status: HttpStatus.UNAUTHORIZED, description: 'Unauthorized' })
+  async findBySku(@Param('sku') sku: string): Promise<ApiResponseDto<ProductEntity>> {
+    const data = await this.productsService.findBySku(sku);
+    return { success: true, data, meta: { correlationId: '', timestamp: new Date().toISOString() } };
+  }
+
+  @Get(':id')
+  @ApiOperation({ summary: 'Get a product by UUID' })
+  @ApiParam({ name: 'id', format: 'uuid', example: '123e4567-e89b-12d3-a456-426614174000' })
+  @ApiResponse({ status: HttpStatus.OK, description: 'Product found', schema: ApiResponseSchema(ProductDto) })
+  @ApiResponse({ status: HttpStatus.NOT_FOUND, description: 'Product not found' })
+  @ApiResponse({ status: HttpStatus.BAD_REQUEST, description: 'Invalid UUID format' })
+  @ApiResponse({ status: HttpStatus.UNAUTHORIZED, description: 'Unauthorized' })
+  override async findOne(
+    @Param('id', new ParseUUIDPipe({ version: '4', errorHttpStatusCode: HttpStatus.BAD_REQUEST })) id: string,
+  ): Promise<ApiResponseDto<ProductEntity>> {
+    return super.findOne(id);
+  }
+}

package/templates/base-crud-drizzle/src/modules/products/products.controller.ts

@@ -0,0 +1,79 @@
+import {
+  Controller,
+  Get,
+  Param,
+  Query,
+  ParseUUIDPipe,
+  HttpStatus,
+  Type,
+} from '@nestjs/common';
+import {
+  ApiTags,
+  ApiOperation,
+  ApiResponse,
+  ApiBearerAuth,
+  ApiExtraModels,
+  ApiParam,
+} from '@nestjs/swagger';
+import { BaseController } from '../../common/base/base.controller';
+import {
+  ApiResponseDto,
+  ApiResponseSchema,
+  PaginatedResponseDto,
+  PaginatedResponseSchema,
+  PaginationQueryDto,
+} from '../../common/base';
+import { ProductsService, ProductEntity } from './products.service';
+import { CreateProductDto } from './dto/create-product.dto';
+import { UpdateProductDto } from './dto/update-product.dto';
+import { ProductDto } from './dto/product.dto';
+
+@ApiTags('Products')
+@ApiBearerAuth('bearer')
+@ApiExtraModels(ApiResponseDto, PaginatedResponseDto, ProductDto)
+@Controller('products')
+export class ProductsController extends BaseController<
+  ProductEntity,
+  CreateProductDto,
+  UpdateProductDto
+> {
+  constructor(private readonly productsService: ProductsService) {
+    super(productsService);
+  }
+
+  protected getDtoClass(): Type<ProductEntity> {
+    return ProductDto as unknown as Type<ProductEntity>;
+  }
+
+  @Get()
+  @ApiOperation({ summary: 'Get all products (paginated)' })
+  @ApiResponse({ status: HttpStatus.OK, schema: PaginatedResponseSchema(ProductDto) })
+  @ApiResponse({ status: HttpStatus.UNAUTHORIZED, description: 'Unauthorized' })
+  override async findAll(@Query() pagination: PaginationQueryDto): Promise<PaginatedResponseDto<ProductEntity>> {
+    return super.findAll(pagination);
+  }
+
+  @Get('by-sku/:sku')
+  @ApiOperation({ summary: 'Get a product by SKU' })
+  @ApiParam({ name: 'sku', example: 'KB-WL-MEC-001' })
+  @ApiResponse({ status: HttpStatus.OK, schema: ApiResponseSchema(ProductDto) })
+  @ApiResponse({ status: HttpStatus.NOT_FOUND, description: 'Product not found' })
+  async findBySku(@Param('sku') sku: string): Promise<ApiResponseDto<ProductEntity>> {
+    const data = await this.productsService.findBySku(sku);
+    return { success: true, data, meta: { correlationId: '', timestamp: new Date().toISOString() } };
+  }
+
+  @Get(':id')
+  @ApiOperation({ summary: 'Get a product by ID' })
+  @ApiParam({ name: 'id', format: 'uuid', example: '123e4567-e89b-12d3-a456-426614174000' })
+  @ApiResponse({ status: HttpStatus.OK, schema: ApiResponseSchema(ProductDto) })
+  @ApiResponse({ status: HttpStatus.NOT_FOUND, description: 'Product not found' })
+  @ApiResponse({ status: HttpStatus.BAD_REQUEST, description: 'Invalid UUID' })
+  override async findOne(
+    @Param('id', new ParseUUIDPipe({ version: '4', errorHttpStatusCode: HttpStatus.BAD_REQUEST }))
+    id: string,
+  ): Promise<ApiResponseDto<ProductEntity>> {
+    return super.findOne(id);
+  }
+}
+