feat(nestjs): migrate to NestJS

packages/server/src/modules/Items/dtos/Item.dto.ts

@@ -0,0 +1,204 @@
+import {
+  IsString,
+  IsIn,
+  IsOptional,
+  IsBoolean,
+  IsNumber,
+  IsInt,
+  IsArray,
+  ValidateIf,
+  MaxLength,
+  Min,
+  Max,
+  IsNotEmpty,
+} from 'class-validator';
+import { Type } from 'class-transformer';
+import { ApiProperty } from '@nestjs/swagger';
+
+export class CommandItemDto {
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(255)
+  @ApiProperty({ description: 'Item name', example: 'Office Chair' })
+  name: string;
+
+  @IsString()
+  @IsIn(['service', 'non-inventory', 'inventory'])
+  @ApiProperty({
+    description: 'Item type',
+    enum: ['service', 'non-inventory', 'inventory'],
+    example: 'inventory',
+  })
+  type: 'service' | 'non-inventory' | 'inventory';
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(255)
+  @ApiProperty({
+    description: 'Item code/SKU',
+    required: false,
+    example: 'ITEM-001',
+  })
+  code?: string;
+
+  // Purchase attributes
+  @IsOptional()
+  @IsBoolean()
+  @ApiProperty({
+    description: 'Whether the item can be purchased',
+    required: false,
+    example: true,
+  })
+  purchasable?: boolean;
+
+  @IsOptional()
+  @IsNumber({ maxDecimalPlaces: 3 })
+  @Min(0)
+  @ValidateIf((o) => o.purchasable === true)
+  @ApiProperty({
+    description: 'Cost price of the item',
+    required: false,
+    minimum: 0,
+    example: 100.5,
+  })
+  costPrice?: number;
+
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  @ValidateIf((o) => o.purchasable === true)
+  @ApiProperty({
+    description: 'ID of the cost account',
+    required: false,
+    minimum: 0,
+    example: 1,
+  })
+  costAccountId?: number;
+
+  // Sell attributes
+  @IsOptional()
+  @IsBoolean()
+  @ApiProperty({
+    description: 'Whether the item can be sold',
+    required: false,
+    example: true,
+  })
+  sellable?: boolean;
+
+  @IsOptional()
+  @IsNumber({ maxDecimalPlaces: 3 })
+  @Min(0)
+  @ValidateIf((o) => o.sellable === true)
+  @ApiProperty({
+    description: 'Selling price of the item',
+    required: false,
+    minimum: 0,
+    example: 150.75,
+  })
+  sellPrice?: number;
+
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  @ValidateIf((o) => o.sellable === true)
+  @ApiProperty({
+    description: 'ID of the sell account',
+    required: false,
+    minimum: 0,
+    example: 2,
+  })
+  sellAccountId?: number;
+
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  @ValidateIf((o) => o.type === 'inventory')
+  @ApiProperty({
+    description: 'ID of the inventory account (required for inventory items)',
+    required: false,
+    minimum: 0,
+    example: 3,
+  })
+  inventoryAccountId?: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty({
+    description: 'Description shown on sales documents',
+    required: false,
+    example: 'High-quality ergonomic office chair',
+  })
+  sellDescription?: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty({
+    description: 'Description shown on purchase documents',
+    required: false,
+    example: 'Ergonomic office chair with adjustable height',
+  })
+  purchaseDescription?: string;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty({
+    description: 'ID of the tax rate applied to sales',
+    required: false,
+    example: 1,
+  })
+  sellTaxRateId?: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty({
+    description: 'ID of the tax rate applied to purchases',
+    required: false,
+    example: 1,
+  })
+  purchaseTaxRateId?: number;
+
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  @ApiProperty({
+    description: 'ID of the item category',
+    required: false,
+    minimum: 0,
+    example: 5,
+  })
+  categoryId?: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty({
+    description: 'Additional notes about the item',
+    required: false,
+    example: 'Available in multiple colors',
+  })
+  note?: string;
+
+  @IsOptional()
+  @IsBoolean()
+  @ApiProperty({
+    description: 'Whether the item is active',
+    required: false,
+    default: true,
+    example: true,
+  })
+  active?: boolean;
+
+  @IsOptional()
+  @IsArray()
+  @Type(() => Number)
+  @IsInt({ each: true })
+  @ApiProperty({
+    description: 'IDs of media files associated with the item',
+    required: false,
+    type: [Number],
+    example: [1, 2, 3],
+  })
+  mediaIds?: number[];
+}
+
+export class CreateItemDto extends CommandItemDto {}
+export class EditItemDto extends CommandItemDto {}