ballrush-core 0.6.6 → 0.7.0

package/dist/domain/user.d.ts

@@ -4,17 +4,25 @@ export declare class User {
     private readonly firstName;
     private readonly username?;
     private language;
+    private avatarUrl?;
+    private telegramAvatarId?;
     private constructor();
     static create(params: {
         userId: number;
         firstName: string;
         username?: string;
         language?: LanguageType;
+        avatarUrl?: string;
+        telegramAvatarId?: string;
     }): User;
     getUserId(): number;
     getFirstName(): string;
     getUsername(): string | undefined;
     getLanguage(): LanguageType;
     setLanguage(language: LanguageType): void;
+    getAvatarUrl(): string | undefined;
+    setAvatarUrl(url: string): void;
+    getTelegramAvatarId(): string | undefined;
+    setTelegramAvatarId(id: string): void;
     getFullName(): string;
 }

package/dist/domain/user.js

@@ -2,11 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.User = void 0;
 class User {
-    constructor(userId, firstName, username, language = "ru") {
+    constructor(userId, firstName, username, language = "ru", avatarUrl, telegramAvatarId) {
         this.userId = userId;
         this.firstName = firstName;
         this.username = username;
         this.language = language;
+        this.avatarUrl = avatarUrl;
+        this.telegramAvatarId = telegramAvatarId;
     }
     static create(params) {
         if (!params.userId) {
@@ -15,7 +17,7 @@ class User {
         if (!params.firstName) {
             throw new Error(`User creation failed: missing firstName (userId=${params.userId ?? 'N/A'})`);
         }
-        return new User(params.userId, params.firstName, params.username, params.language ?? "ru");
+        return new User(params.userId, params.firstName, params.username, params.language ?? "ru", params.avatarUrl, params.telegramAvatarId);
     }
     getUserId() {
         return this.userId;
@@ -32,6 +34,18 @@ class User {
     setLanguage(language) {
         this.language = language;
     }
+    getAvatarUrl() {
+        return this.avatarUrl;
+    }
+    setAvatarUrl(url) {
+        this.avatarUrl = url;
+    }
+    getTelegramAvatarId() {
+        return this.telegramAvatarId;
+    }
+    setTelegramAvatarId(id) {
+        this.telegramAvatarId = id;
+    }
     getFullName() {
         return this.username
             ? `${this.firstName} (${this.username})`

package/dist/mongo/schemas/user.schema.d.ts

@@ -5,6 +5,8 @@ export interface UserDoc {
     language: LanguageType;
     userId: number;
     username?: string;
+    avatarUrl?: string;
+    telegramAvatarId?: string;
 }
 export declare function createUserSchema(): Schema<UserDoc, import("mongoose").Model<UserDoc, any, any, any, import("mongoose").Document<unknown, any, UserDoc> & UserDoc & {
     _id: import("mongoose").Types.ObjectId;

package/dist/mongo/schemas/user.schema.js

@@ -8,6 +8,8 @@ function createUserSchema() {
         username: { type: String },
         userId: { type: Number, required: true, unique: true, index: true },
         language: { type: String, enum: ["ru", "en", "ua"], default: "ru" },
+        avatarUrl: { type: String },
+        telegramAvatarId: { type: String },
     });
     return UserSchema;
 }

package/dist/ports/index.d.ts

@@ -9,6 +9,7 @@ export * from "./stat-group-last-100-games.repository";
 export * from "./stat-group-activity-chart.repository";
 export * from "./stat-user-profile.repository";
 export * from "./stat-user-match-history.repository";
+export * from "./stat-user-context.repository";
 export * from "./stat-event.repository";
 export * from "./seasons.repository";
 export * from "./achievements.repository";

package/dist/ports/index.js

@@ -25,6 +25,7 @@ __exportStar(require("./stat-group-last-100-games.repository"), exports);
 __exportStar(require("./stat-group-activity-chart.repository"), exports);
 __exportStar(require("./stat-user-profile.repository"), exports);
 __exportStar(require("./stat-user-match-history.repository"), exports);
+__exportStar(require("./stat-user-context.repository"), exports);
 __exportStar(require("./stat-event.repository"), exports);
 __exportStar(require("./seasons.repository"), exports);
 __exportStar(require("./achievements.repository"), exports);

package/dist/ports/stat-user-context.repository.d.ts

@@ -0,0 +1,16 @@
+import { StatUserGroupItem } from "../types/stat-user-groups.types";
+import { StatUserGroupSeasons } from "../types/stat-user-group-seasons.types";
+/**
+ * Repository interface for user context data
+ * Provides methods to query user groups and seasons
+ */
+export interface StatUserContextRepository {
+    /**
+     * Список групп, в которых пользователь имеет матчи / статистику.
+     */
+    findUserGroups(userId: number): Promise<StatUserGroupItem[]>;
+    /**
+     * Список уникальных сезонов пользователя для конкретной группы.
+     */
+    findUserSeasonsInGroup(userId: number, groupId: number): Promise<StatUserGroupSeasons | null>;
+}

package/dist/ports/stat-user-context.repository.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/repositories/index.d.ts

@@ -9,6 +9,7 @@ export * from "./mongo/stat-group-last-100-games.repository";
 export * from "./mongo/stat-group-activity-chart.repository";
 export * from "./mongo/stat-user-profile.repository";
 export * from "./mongo/stat-user-match-history.repository";
+export * from "./mongo/stat-user-context.repository";
 export * from "./mongo/stat-event.repository";
 export * from "./mongo/season.repository";
 export * from "./mongo/achievement.repository";

package/dist/repositories/index.js

@@ -25,6 +25,7 @@ __exportStar(require("./mongo/stat-group-last-100-games.repository"), exports);
 __exportStar(require("./mongo/stat-group-activity-chart.repository"), exports);
 __exportStar(require("./mongo/stat-user-profile.repository"), exports);
 __exportStar(require("./mongo/stat-user-match-history.repository"), exports);
+__exportStar(require("./mongo/stat-user-context.repository"), exports);
 __exportStar(require("./mongo/stat-event.repository"), exports);
 __exportStar(require("./mongo/season.repository"), exports);
 __exportStar(require("./mongo/achievement.repository"), exports);

package/dist/repositories/mongo/stat-user-context.repository.d.ts

@@ -0,0 +1,15 @@
+import type { Model } from "mongoose";
+import type { StatUserContextRepository } from "../../ports/stat-user-context.repository";
+import type { StatUserMatchHistoryDoc } from "../../mongo/schemas/stat-user-match-history.schema";
+import type { StatUserGroupItem } from "../../types/stat-user-groups.types";
+import type { StatUserGroupSeasons } from "../../types/stat-user-group-seasons.types";
+/**
+ * MongoDB implementation of StatUserContextRepository
+ * Provides methods to query user groups and seasons from match history
+ */
+export declare class MongoStatUserContextRepository implements StatUserContextRepository {
+    private readonly model;
+    constructor(model: Model<StatUserMatchHistoryDoc>);
+    findUserGroups(userId: number): Promise<StatUserGroupItem[]>;
+    findUserSeasonsInGroup(userId: number, groupId: number): Promise<StatUserGroupSeasons | null>;
+}

package/dist/repositories/mongo/stat-user-context.repository.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoStatUserContextRepository = void 0;
+const errors_1 = require("../../errors");
+/**
+ * MongoDB implementation of StatUserContextRepository
+ * Provides methods to query user groups and seasons from match history
+ */
+class MongoStatUserContextRepository {
+    constructor(model) {
+        this.model = model;
+    }
+    async findUserGroups(userId) {
+        try {
+            // Validate input
+            if (!userId || userId === 0) {
+                throw new errors_1.ValidationError('StatUserContext', 'userId', userId, 'must be a non-zero number');
+            }
+            // Aggregation pipeline to get distinct groups with statistics
+            const pipeline = [
+                // Match all matches for the user
+                {
+                    $match: {
+                        userId: userId,
+                    },
+                },
+                // Group by groupId to aggregate statistics
+                {
+                    $group: {
+                        _id: '$groupId',
+                        totalMatches: { $sum: 1 },
+                        lastMatchAt: { $max: '$date' },
+                    },
+                },
+                // Lookup group name from Groups collection
+                {
+                    $lookup: {
+                        from: 'groups',
+                        localField: '_id',
+                        foreignField: 'groupId',
+                        as: 'groupInfo',
+                    },
+                },
+                // Unwind group info (handle case where group doesn't exist)
+                {
+                    $unwind: {
+                        path: '$groupInfo',
+                        preserveNullAndEmptyArrays: true,
+                    },
+                },
+                // Project final result
+                {
+                    $project: {
+                        userId: { $literal: userId },
+                        groupId: '$_id',
+                        groupName: {
+                            $ifNull: ['$groupInfo.groupName', ''],
+                        },
+                        lastMatchAt: '$lastMatchAt',
+                        totalMatches: '$totalMatches',
+                    },
+                },
+                // Sort by lastMatchAt descending (most recent first)
+                {
+                    $sort: { lastMatchAt: -1 },
+                },
+            ];
+            const results = await this.model.aggregate(pipeline).exec();
+            // Map to domain types
+            return results.map((item) => ({
+                userId: item.userId,
+                groupId: item.groupId,
+                groupName: item.groupName,
+                lastMatchAt: item.lastMatchAt ? new Date(item.lastMatchAt) : null,
+                totalMatches: item.totalMatches,
+            }));
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError) {
+                throw error;
+            }
+            throw new errors_1.QueryError('findUserGroups', 'StatUserContext', userId, error);
+        }
+    }
+    async findUserSeasonsInGroup(userId, groupId) {
+        try {
+            // Validate input
+            if (!userId || userId === 0) {
+                throw new errors_1.ValidationError('StatUserContext', 'userId', userId, 'must be a non-zero number');
+            }
+            if (!groupId || groupId === 0) {
+                throw new errors_1.ValidationError('StatUserContext', 'groupId', groupId, 'must be a non-zero number');
+            }
+            // Get distinct seasonIds for the user in the group
+            const seasonIds = await this.model.distinct('seasonId', {
+                userId,
+                groupId,
+            });
+            // If no seasons found, return null
+            if (!seasonIds || seasonIds.length === 0) {
+                return null;
+            }
+            // Sort seasons (assuming they're strings like "Autumn 2025")
+            const sortedSeasons = seasonIds.sort();
+            return {
+                userId,
+                groupId,
+                seasons: sortedSeasons,
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError) {
+                throw error;
+            }
+            throw new errors_1.QueryError('findUserSeasonsInGroup', 'StatUserContext', `${userId}:${groupId}`, error);
+        }
+    }
+}
+exports.MongoStatUserContextRepository = MongoStatUserContextRepository;

package/dist/repositories/mongo/user.mapper.js

@@ -8,7 +8,9 @@ function toDomain(doc) {
         firstName: doc.firstName,
         username: doc.username,
         userId: doc.userId,
-        language: doc.language
+        language: doc.language,
+        avatarUrl: doc.avatarUrl,
+        telegramAvatarId: doc.telegramAvatarId,
     });
 }
 function toDoc(user) {
@@ -17,5 +19,7 @@ function toDoc(user) {
         username: user.getUsername(),
         userId: user.getUserId(),
         language: user.getLanguage(),
+        avatarUrl: user.getAvatarUrl(),
+        telegramAvatarId: user.getTelegramAvatarId(),
     };
 }

package/dist/types/index.d.ts

@@ -5,4 +5,6 @@ export * from "./stat-group-last-100-games.types";
 export * from "./stat-group-activity-chart.types";
 export * from "./stat-user-profile.types";
 export * from "./stat-user-match-history.types";
+export * from "./stat-user-groups.types";
+export * from "./stat-user-group-seasons.types";
 export * from "./stat-event.types";

package/dist/types/index.js

@@ -21,4 +21,6 @@ __exportStar(require("./stat-group-last-100-games.types"), exports);
 __exportStar(require("./stat-group-activity-chart.types"), exports);
 __exportStar(require("./stat-user-profile.types"), exports);
 __exportStar(require("./stat-user-match-history.types"), exports);
+__exportStar(require("./stat-user-groups.types"), exports);
+__exportStar(require("./stat-user-group-seasons.types"), exports);
 __exportStar(require("./stat-event.types"), exports);

package/dist/types/stat-user-group-seasons.types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Statistics: User Group Seasons Types
+ * Types for user seasons within a group
+ */
+export interface StatUserGroupSeasons {
+    userId: number;
+    groupId: number;
+    seasons: string[];
+}

package/dist/types/stat-user-group-seasons.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Statistics: User Group Seasons Types
+ * Types for user seasons within a group
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/stat-user-groups.types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Statistics: User Groups Types
+ * Types for user group context data
+ */
+export interface StatUserGroupItem {
+    userId: number;
+    groupId: number;
+    groupName: string;
+    lastMatchAt: Date | null;
+    totalMatches: number;
+}

package/dist/types/stat-user-groups.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Statistics: User Groups Types
+ * Types for user group context data
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ballrush-core",
-    "version": "0.6.6",
+    "version": "0.7.0",
     "private": false,
     "license": "MIT",
     "main": "./dist/index.js",