ballrush-core 0.6.7 → 0.7.0

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/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.7",
+    "version": "0.7.0",
     "private": false,
     "license": "MIT",
     "main": "./dist/index.js",