wip

packages/identity/domain/repositories/IAchievementRepository.ts

@@ -0,0 +1,28 @@
+/**
+ * Repository Interface: IAchievementRepository
+ * 
+ * Defines operations for Achievement and UserAchievement entities
+ */
+
+import type { Achievement, AchievementCategory } from '../entities/Achievement';
+import type { UserAchievement } from '../entities/UserAchievement';
+
+export interface IAchievementRepository {
+  // Achievement operations
+  findAchievementById(id: string): Promise<Achievement | null>;
+  findAllAchievements(): Promise<Achievement[]>;
+  findAchievementsByCategory(category: AchievementCategory): Promise<Achievement[]>;
+  createAchievement(achievement: Achievement): Promise<Achievement>;
+  
+  // UserAchievement operations
+  findUserAchievementById(id: string): Promise<UserAchievement | null>;
+  findUserAchievementsByUserId(userId: string): Promise<UserAchievement[]>;
+  findUserAchievementByUserAndAchievement(userId: string, achievementId: string): Promise<UserAchievement | null>;
+  hasUserEarnedAchievement(userId: string, achievementId: string): Promise<boolean>;
+  createUserAchievement(userAchievement: UserAchievement): Promise<UserAchievement>;
+  updateUserAchievement(userAchievement: UserAchievement): Promise<UserAchievement>;
+  
+  // Stats
+  getAchievementLeaderboard(limit: number): Promise<{ userId: string; points: number; count: number }[]>;
+  getUserAchievementStats(userId: string): Promise<{ total: number; points: number; byCategory: Record<AchievementCategory, number> }>;
+}

packages/identity/domain/repositories/ISponsorAccountRepository.ts

@@ -0,0 +1,16 @@
+/**
+ * Repository Interface: ISponsorAccountRepository
+ * 
+ * Defines persistence operations for SponsorAccount entities.
+ */
+
+import type { SponsorAccount } from '../entities/SponsorAccount';
+import type { UserId } from '../value-objects/UserId';
+
+export interface ISponsorAccountRepository {
+  save(account: SponsorAccount): Promise<void>;
+  findById(id: UserId): Promise<SponsorAccount | null>;
+  findBySponsorId(sponsorId: string): Promise<SponsorAccount | null>;
+  findByEmail(email: string): Promise<SponsorAccount | null>;
+  delete(id: UserId): Promise<void>;
+}

packages/identity/domain/repositories/IUserRatingRepository.ts

@@ -0,0 +1,49 @@
+/**
+ * Repository Interface: IUserRatingRepository
+ * 
+ * Defines operations for UserRating value objects
+ */
+
+import type { UserRating } from '../value-objects/UserRating';
+
+export interface IUserRatingRepository {
+  /**
+   * Find rating by user ID
+   */
+  findByUserId(userId: string): Promise<UserRating | null>;
+
+  /**
+   * Find ratings by multiple user IDs
+   */
+  findByUserIds(userIds: string[]): Promise<UserRating[]>;
+
+  /**
+   * Save or update a user rating
+   */
+  save(rating: UserRating): Promise<UserRating>;
+
+  /**
+   * Get top rated drivers
+   */
+  getTopDrivers(limit: number): Promise<UserRating[]>;
+
+  /**
+   * Get top trusted users
+   */
+  getTopTrusted(limit: number): Promise<UserRating[]>;
+
+  /**
+   * Get eligible stewards (based on trust and fairness thresholds)
+   */
+  getEligibleStewards(): Promise<UserRating[]>;
+
+  /**
+   * Get ratings by driver tier
+   */
+  findByDriverTier(tier: 'rookie' | 'amateur' | 'semi-pro' | 'pro' | 'elite'): Promise<UserRating[]>;
+
+  /**
+   * Delete rating by user ID
+   */
+  delete(userId: string): Promise<void>;
+}