wip

packages/analytics/application/use-cases/RecordEngagementUseCase.ts

@@ -0,0 +1,49 @@
+/**
+ * Use Case: RecordEngagementUseCase
+ * 
+ * Records an engagement event when a visitor interacts with an entity.
+ */
+
+import { EngagementEvent, type EngagementAction, type EngagementEntityType } from '../../domain/entities/EngagementEvent';
+import type { IEngagementRepository } from '../../domain/repositories/IEngagementRepository';
+
+export interface RecordEngagementInput {
+  action: EngagementAction;
+  entityType: EngagementEntityType;
+  entityId: string;
+  actorId?: string;
+  actorType: 'anonymous' | 'driver' | 'sponsor';
+  sessionId: string;
+  metadata?: Record<string, string | number | boolean>;
+}
+
+export interface RecordEngagementOutput {
+  eventId: string;
+  engagementWeight: number;
+}
+
+export class RecordEngagementUseCase {
+  constructor(private readonly engagementRepository: IEngagementRepository) {}
+
+  async execute(input: RecordEngagementInput): Promise<RecordEngagementOutput> {
+    const eventId = `eng-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+
+    const event = EngagementEvent.create({
+      id: eventId,
+      action: input.action,
+      entityType: input.entityType,
+      entityId: input.entityId,
+      actorId: input.actorId,
+      actorType: input.actorType,
+      sessionId: input.sessionId,
+      metadata: input.metadata,
+    });
+
+    await this.engagementRepository.save(event);
+
+    return {
+      eventId,
+      engagementWeight: event.getEngagementWeight(),
+    };
+  }
+}