refactor

apps/api/src/domain/analytics/dtos/EngagementAction.ts

@@ -0,0 +1,12 @@
+// From core/analytics/domain/types/EngagementEvent.ts
+export enum EngagementAction {
+  CLICK_SPONSOR_LOGO = 'click_sponsor_logo',
+  CLICK_SPONSOR_URL = 'click_sponsor_url',
+  DOWNLOAD_LIVERY_PACK = 'download_livery_pack',
+  JOIN_LEAGUE = 'join_league',
+  REGISTER_RACE = 'register_race',
+  VIEW_STANDINGS = 'view_standings',
+  VIEW_SCHEDULE = 'view_schedule',
+  SHARE_SOCIAL = 'share_social',
+  CONTACT_SPONSOR = 'contact_sponsor',
+}

apps/api/src/domain/analytics/dtos/EngagementEntityType.ts

@@ -0,0 +1,9 @@
+// From core/analytics/domain/types/EngagementEvent.ts
+export enum EngagementEntityType {
+  LEAGUE = 'league',
+  DRIVER = 'driver',
+  TEAM = 'team',
+  RACE = 'race',
+  SPONSOR = 'sponsor',
+  SPONSORSHIP = 'sponsorship',
+}

apps/api/src/domain/analytics/dtos/EntityType.ts

@@ -0,0 +1,8 @@
+// From core/analytics/domain/types/PageView.ts
+export enum EntityType {
+  LEAGUE = 'league',
+  DRIVER = 'driver',
+  TEAM = 'team',
+  RACE = 'race',
+  SPONSOR = 'sponsor',
+}

apps/api/src/domain/analytics/dtos/RecordEngagementInputDTO.ts

@@ -0,0 +1,36 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString, IsOptional, IsEnum, IsObject } from 'class-validator';
+import { EngagementAction } from './EngagementAction';
+import { EngagementEntityType } from './EngagementEntityType';
+
+export class RecordEngagementInputDTO {
+  @ApiProperty({ enum: EngagementAction })
+  @IsEnum(EngagementAction)
+  action!: EngagementAction;
+
+  @ApiProperty({ enum: EngagementEntityType })
+  @IsEnum(EngagementEntityType)
+  entityType!: EngagementEntityType;
+
+  @ApiProperty()
+  @IsString()
+  entityId!: string;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsString()
+  actorId?: string;
+
+  @ApiProperty({ enum: ['anonymous', 'driver', 'sponsor'] })
+  @IsEnum(['anonymous', 'driver', 'sponsor'])
+  actorType!: 'anonymous' | 'driver' | 'sponsor';
+
+  @ApiProperty()
+  @IsString()
+  sessionId!: string;
+
+  @ApiProperty({ required: false, type: Object })
+  @IsOptional()
+  @IsObject()
+  metadata?: Record<string, string | number | boolean>;
+}

apps/api/src/domain/analytics/dtos/RecordEngagementOutputDTO.ts

@@ -0,0 +1,12 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString, IsNumber } from 'class-validator';
+
+export class RecordEngagementOutputDTO {
+  @ApiProperty()
+  @IsString()
+  eventId!: string;
+
+  @ApiProperty()
+  @IsNumber()
+  engagementWeight!: number;
+}

apps/api/src/domain/analytics/dtos/RecordPageViewInputDTO.ts

@@ -0,0 +1,42 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString, IsOptional, IsEnum } from 'class-validator';
+import { EntityType } from './EntityType';
+import { VisitorType } from './VisitorType';
+
+export class RecordPageViewInputDTO {
+  @ApiProperty({ enum: EntityType })
+  @IsEnum(EntityType)
+  entityType!: EntityType;
+
+  @ApiProperty()
+  @IsString()
+  entityId!: string;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsString()
+  visitorId?: string;
+
+  @ApiProperty({ enum: VisitorType })
+  @IsEnum(VisitorType)
+  visitorType!: VisitorType;
+
+  @ApiProperty()
+  @IsString()
+  sessionId!: string;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsString()
+  referrer?: string;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsString()
+  userAgent?: string;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsString()
+  country?: string;
+}

apps/api/src/domain/analytics/dtos/RecordPageViewOutputDTO.ts

@@ -0,0 +1,8 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString } from 'class-validator';
+
+export class RecordPageViewOutputDTO {
+  @ApiProperty()
+  @IsString()
+  pageViewId!: string;
+}

apps/api/src/domain/analytics/dtos/VisitorType.ts

@@ -0,0 +1,6 @@
+// From core/analytics/domain/types/PageView.ts
+export enum VisitorType {
+  ANONYMOUS = 'anonymous',
+  DRIVER = 'driver',
+  SPONSOR = 'sponsor',
+}