wip

packages/analytics/domain/entities/AnalyticsSnapshot.ts

@@ -1,52 +1,34 @@
 /**
  * Domain Entity: AnalyticsSnapshot
- * 
+ *
  * Aggregated analytics data for a specific entity over a time period.
  * Pre-calculated metrics for sponsor dashboard and entity analytics.
  */
 
-export type SnapshotPeriod = 'daily' | 'weekly' | 'monthly';
-export type SnapshotEntityType = 'league' | 'driver' | 'team' | 'race' | 'sponsor';
+import type { IEntity } from '@gridpilot/shared/domain';
+import type {
+  AnalyticsSnapshotProps,
+  AnalyticsMetrics,
+  SnapshotEntityType,
+  SnapshotPeriod,
+} from '../types/AnalyticsSnapshot';
+import { AnalyticsEntityId } from '../value-objects/AnalyticsEntityId';
 
-export interface AnalyticsMetrics {
-  pageViews: number;
-  uniqueVisitors: number;
-  avgSessionDuration: number;
-  bounceRate: number;
-  engagementScore: number;
-  sponsorClicks: number;
-  sponsorUrlClicks: number;
-  socialShares: number;
-  leagueJoins: number;
-  raceRegistrations: number;
-  exposureValue: number;
-}
-
-export interface AnalyticsSnapshotProps {
-  id: string;
-  entityType: SnapshotEntityType;
-  entityId: string;
-  period: SnapshotPeriod;
-  startDate: Date;
-  endDate: Date;
-  metrics: AnalyticsMetrics;
-  createdAt: Date;
-}
-
-export class AnalyticsSnapshot {
+export class AnalyticsSnapshot implements IEntity<string> {
   readonly id: string;
   readonly entityType: SnapshotEntityType;
-  readonly entityId: string;
   readonly period: SnapshotPeriod;
   readonly startDate: Date;
   readonly endDate: Date;
   readonly metrics: AnalyticsMetrics;
   readonly createdAt: Date;
 
+  private readonly entityIdVo: AnalyticsEntityId;
+
   private constructor(props: AnalyticsSnapshotProps) {
     this.id = props.id;
     this.entityType = props.entityType;
-    this.entityId = props.entityId;
+    this.entityIdVo = AnalyticsEntityId.create(props.entityId);
     this.period = props.period;
     this.startDate = props.startDate;
     this.endDate = props.endDate;
@@ -54,6 +36,10 @@ export class AnalyticsSnapshot {
     this.createdAt = props.createdAt;
   }
 
+  get entityId(): string {
+    return this.entityIdVo.value;
+  }
+
   static create(props: Omit<AnalyticsSnapshotProps, 'createdAt'> & { createdAt?: Date }): AnalyticsSnapshot {
     this.validate(props);
 

packages/analytics/domain/entities/EngagementEvent.ts

@@ -1,51 +1,35 @@
 /**
  * Domain Entity: EngagementEvent
- * 
+ *
  * Represents user interactions beyond page views.
  * Tracks clicks, downloads, sign-ups, and other engagement actions.
  */
 
-export type EngagementAction = 
-  | 'click_sponsor_logo'
-  | 'click_sponsor_url'
-  | 'download_livery_pack'
-  | 'join_league'
-  | 'register_race'
-  | 'view_standings'
-  | 'view_schedule'
-  | 'share_social'
-  | 'contact_sponsor';
+import type { IEntity } from '@gridpilot/shared/domain';
+import type {
+  EngagementAction,
+  EngagementEntityType,
+  EngagementEventProps,
+} from '../types/EngagementEvent';
+import { AnalyticsEntityId } from '../value-objects/AnalyticsEntityId';
 
-export type EngagementEntityType = 'league' | 'driver' | 'team' | 'race' | 'sponsor' | 'sponsorship';
-
-export interface EngagementEventProps {
-  id: string;
-  action: EngagementAction;
-  entityType: EngagementEntityType;
-  entityId: string;
-  actorId?: string;
-  actorType: 'anonymous' | 'driver' | 'sponsor';
-  sessionId: string;
-  metadata?: Record<string, string | number | boolean>;
-  timestamp: Date;
-}
-
-export class EngagementEvent {
+export class EngagementEvent implements IEntity<string> {
   readonly id: string;
   readonly action: EngagementAction;
   readonly entityType: EngagementEntityType;
-  readonly entityId: string;
   readonly actorId?: string;
   readonly actorType: 'anonymous' | 'driver' | 'sponsor';
   readonly sessionId: string;
   readonly metadata?: Record<string, string | number | boolean>;
   readonly timestamp: Date;
 
+  private readonly entityIdVo: AnalyticsEntityId;
+
   private constructor(props: EngagementEventProps) {
     this.id = props.id;
     this.action = props.action;
     this.entityType = props.entityType;
-    this.entityId = props.entityId;
+    this.entityIdVo = AnalyticsEntityId.create(props.entityId);
     this.actorId = props.actorId;
     this.actorType = props.actorType;
     this.sessionId = props.sessionId;
@@ -53,6 +37,10 @@ export class EngagementEvent {
     this.timestamp = props.timestamp;
   }
 
+  get entityId(): string {
+    return this.entityIdVo.value;
+  }
+
   static create(props: Omit<EngagementEventProps, 'timestamp'> & { timestamp?: Date }): EngagementEvent {
     this.validate(props);
 

packages/analytics/domain/entities/PageView.ts

@@ -1,47 +1,37 @@
 /**
  * Domain Entity: PageView
- * 
+ *
  * Represents a single page view event for analytics tracking.
  * Captures visitor interactions with leagues, drivers, teams, races.
  */
 
-export type EntityType = 'league' | 'driver' | 'team' | 'race' | 'sponsor';
-export type VisitorType = 'anonymous' | 'driver' | 'sponsor';
+import type { IEntity } from '@gridpilot/shared/domain';
+import type { EntityType, VisitorType, PageViewProps } from '../types/PageView';
+import { AnalyticsEntityId } from '../value-objects/AnalyticsEntityId';
+import { AnalyticsSessionId } from '../value-objects/AnalyticsSessionId';
+import { PageViewId } from '../value-objects/PageViewId';
 
-export interface PageViewProps {
-  id: string;
-  entityType: EntityType;
-  entityId: string;
-  visitorId?: string;
-  visitorType: VisitorType;
-  sessionId: string;
-  referrer?: string;
-  userAgent?: string;
-  country?: string;
-  timestamp: Date;
-  durationMs?: number;
-}
-
-export class PageView {
-  readonly id: string;
+export class PageView implements IEntity<string> {
   readonly entityType: EntityType;
-  readonly entityId: string;
   readonly visitorId?: string;
   readonly visitorType: VisitorType;
-  readonly sessionId: string;
   readonly referrer?: string;
   readonly userAgent?: string;
   readonly country?: string;
   readonly timestamp: Date;
   readonly durationMs?: number;
 
+  private readonly idVo: PageViewId;
+  private readonly entityIdVo: AnalyticsEntityId;
+  private readonly sessionIdVo: AnalyticsSessionId;
+
   private constructor(props: PageViewProps) {
-    this.id = props.id;
+    this.idVo = PageViewId.create(props.id);
     this.entityType = props.entityType;
-    this.entityId = props.entityId;
+    this.entityIdVo = AnalyticsEntityId.create(props.entityId);
     this.visitorId = props.visitorId;
     this.visitorType = props.visitorType;
-    this.sessionId = props.sessionId;
+    this.sessionIdVo = AnalyticsSessionId.create(props.sessionId);
     this.referrer = props.referrer;
     this.userAgent = props.userAgent;
     this.country = props.country;
@@ -49,6 +39,18 @@ export class PageView {
     this.durationMs = props.durationMs;
   }
 
+  get id(): string {
+    return this.idVo.value;
+  }
+
+  get entityId(): string {
+    return this.entityIdVo.value;
+  }
+
+  get sessionId(): string {
+    return this.sessionIdVo.value;
+  }
+
   static create(props: Omit<PageViewProps, 'timestamp'> & { timestamp?: Date }): PageView {
     this.validate(props);