ballrush-core 0.3.0 → 0.4.0

package/dist/domain/group.d.ts

@@ -1,4 +1,5 @@
-import { ParticipantGroup, PlayerPosition, LanguageType } from "../types";
+import { GroupStatistics } from "../ports";
+import { ParticipantGroup, PlayerPosition, LanguageType, RatingSource } from "../types";
 export declare class Group {
     private readonly groupId;
     private readonly groupName;
@@ -6,6 +7,8 @@ export declare class Group {
     private timezone;
     private isMessageLast;
     private language;
+    private isPublic;
+    private statistics;
     private constructor();
     static create(params: {
         groupId: number;
@@ -14,6 +17,8 @@ export declare class Group {
         timezone?: string;
         isMessageLast?: boolean;
         language?: LanguageType;
+        isPublic?: boolean;
+        statistics?: GroupStatistics;
     }): Group;
     getGroupId(): number;
     getGroupName(): string;
@@ -21,15 +26,18 @@ export declare class Group {
     getIsMessageLast(): boolean;
     getLanguage(): LanguageType;
     getParticipants(): ParticipantGroup[];
+    getIsPublic(): boolean;
+    getStatistics(): GroupStatistics;
     getAdmins(): ParticipantGroup[];
     getAdminIds(): number[];
     setTimezone(tz: string): void;
     setIsMessageLast(v: boolean): void;
     setLanguage(language: LanguageType): void;
+    setIsPublic(value: boolean): void;
     addAdmin(userId: number): void;
     removeAdmin(userId: number): void;
-    addParticipant(userId: number, isAdmin?: boolean, initialRating?: number): boolean;
+    addNewParticipant(userId: number, isAdmin?: boolean, initialRating?: number): boolean;
     removeParticipant(userId: number): void;
     setPosition(userId: number, pos: PlayerPosition): void;
-    addRatingPoint(userId: number, value: number, at?: Date): void;
+    addRatingPoint(userId: number, value: number, source: RatingSource): void;
 }

package/dist/domain/group.js

@@ -4,18 +4,20 @@ exports.Group = void 0;
 const types_1 = require("../types");
 const utils_1 = require("../utils");
 class Group {
-    constructor(groupId, groupName, participants, timezone = "UTC+0", isMessageLast = false, language = "en") {
+    constructor(groupId, groupName, participants, timezone = "UTC+0", isMessageLast = false, language = "en", isPublic = false, statistics = { seasonsCount: 0, eventsCount: 0, matchesCount: 0, participantsCount: 0 }) {
         this.groupId = groupId;
         this.groupName = groupName;
         this.participants = participants;
         this.timezone = timezone;
         this.isMessageLast = isMessageLast;
         this.language = language;
+        this.isPublic = isPublic;
+        this.statistics = statistics;
     }
     static create(params) {
         if (!params.groupName)
             throw new Error("Group name is required");
-        return new Group(params.groupId, params.groupName, (params.participants ?? []).map(p => ({ ...p, ratingHistory: [...p.ratingHistory] })), params.timezone ?? "UTC+0", params.isMessageLast ?? false, params.language ?? "en");
+        return new Group(params.groupId, params.groupName, (params.participants ?? []).map(p => ({ ...p, ratingHistory: [...p.ratingHistory] })), params.timezone ?? "UTC+0", params.isMessageLast ?? false, params.language ?? "en", params.isPublic ?? false, params.statistics ?? { seasonsCount: 0, eventsCount: 0, matchesCount: 0, participantsCount: 0 });
     }
     getGroupId() { return this.groupId; }
     getGroupName() { return this.groupName; }
@@ -23,6 +25,8 @@ class Group {
     getIsMessageLast() { return this.isMessageLast; }
     getLanguage() { return this.language; }
     getParticipants() { return this.participants; }
+    getIsPublic() { return this.isPublic; }
+    getStatistics() { return this.statistics; }
     getAdmins() {
         return this.participants.filter(p => p.isAdmin);
     }
@@ -38,6 +42,9 @@ class Group {
     setLanguage(language) {
         this.language = language;
     }
+    setIsPublic(value) {
+        this.isPublic = value;
+    }
     addAdmin(userId) {
         const p = this.participants.find(x => x.userId === userId);
         if (p) {
@@ -47,7 +54,7 @@ class Group {
             this.participants.push({
                 userId,
                 position: types_1.PlayerPosition.UN,
-                ratingHistory: (0, utils_1.addRating)([], 0),
+                ratingHistory: (0, utils_1.addRating)([], 0, new Date(), types_1.RatingSource.SYSTEM),
                 isAdmin: true,
             });
         }
@@ -57,13 +64,13 @@ class Group {
         if (p)
             p.isAdmin = false;
     }
-    addParticipant(userId, isAdmin = false, initialRating = 0) {
+    addNewParticipant(userId, isAdmin = false, initialRating = 0) {
         if (this.participants.some(p => p.userId === userId))
             return false;
         this.participants.push({
             userId,
             position: types_1.PlayerPosition.UN,
-            ratingHistory: (0, utils_1.addRating)([], initialRating),
+            ratingHistory: (0, utils_1.addRating)([], initialRating, new Date(), types_1.RatingSource.SYSTEM),
             isAdmin,
         });
         return true;
@@ -76,11 +83,11 @@ class Group {
         if (p)
             p.position = pos;
     }
-    addRatingPoint(userId, value, at = new Date()) {
+    addRatingPoint(userId, value, source) {
         const p = this.participants.find(x => x.userId === userId);
         if (!p)
             return;
-        p.ratingHistory = (0, utils_1.addRating)(p.ratingHistory, value, at);
+        p.ratingHistory = (0, utils_1.addRating)(p.ratingHistory, value, new Date(), source);
     }
 }
 exports.Group = Group;

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

@@ -7,6 +7,15 @@ export interface GroupDoc {
     timezone: string;
     isMessageLast: boolean;
     language: LanguageType;
+    isPublic?: boolean;
+    createdAt?: Date;
+    updatedAt?: Date;
+    statistics?: {
+        seasonsCount: number;
+        eventsCount: number;
+        matchesCount: number;
+        participantsCount: number;
+    };
 }
 export declare function createRatingPointSchema(): Schema<RatingPoint, import("mongoose").Model<RatingPoint, any, any, any, import("mongoose").Document<unknown, any, RatingPoint> & RatingPoint & {
     _id: import("mongoose").Types.ObjectId;

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

@@ -4,10 +4,12 @@ exports.createRatingPointSchema = createRatingPointSchema;
 exports.createParticipantSchema = createParticipantSchema;
 exports.createGroupSchema = createGroupSchema;
 const mongoose_1 = require("mongoose");
+const types_1 = require("../../types");
 function createRatingPointSchema() {
     return new mongoose_1.Schema({
         value: { type: Number, required: true },
         changedAt: { type: Date, default: Date.now },
+        source: { type: String, enum: types_1.RatingSource, default: types_1.RatingSource.SYSTEM },
     });
 }
 function createParticipantSchema() {
@@ -28,6 +30,15 @@ function createGroupSchema() {
         timezone: { type: String, default: "UTC+0" },
         isMessageLast: { type: Boolean, default: false },
         language: { type: String, enum: ['en', 'ru', 'ua'], default: 'en' },
+        isPublic: { type: Boolean, default: false, index: true },
+        statistics: {
+            seasonsCount: { type: Number, default: 0 },
+            eventsCount: { type: Number, default: 0 },
+            matchesCount: { type: Number, default: 0 },
+            participantsCount: { type: Number, default: 0 },
+        },
+    }, {
+        timestamps: true, // Adds createdAt and updatedAt automatically
     });
     return GroupSchema;
 }

package/dist/ports/groups.repository.d.ts

@@ -1,25 +1,62 @@
 import { Group } from "../domain/group";
-import { LanguageType } from "../types";
+import { LanguageType, RatingPoint } from "../types";
 export type GroupWrite = {
     groupId: number;
     groupName: string;
     participants: Array<{
         userId: number;
         position: string;
-        ratingHistory: Array<{
-            value: number;
-            changedAt: Date;
-        }>;
+        ratingHistory: Array<RatingPoint>;
         isAdmin: boolean;
     }>;
     timezone: string;
     isMessageLast: boolean;
     language: LanguageType;
+    isPublic: boolean;
+    statistics?: {
+        seasonsCount: number;
+        eventsCount: number;
+        matchesCount: number;
+        participantsCount: number;
+    };
 };
+export interface FindPublicGroupsOptions {
+    page: number;
+    limit: number;
+    search?: string;
+    sort: 'lastActivity' | 'name' | 'members' | 'games';
+}
+export interface GroupStatistics {
+    seasonsCount: number;
+    eventsCount: number;
+    matchesCount: number;
+    participantsCount: number;
+}
+export interface PublicGroupsResult {
+    groups: Array<{
+        groupId: number;
+        groupName: string;
+        updatedAt: Date;
+        statistics: GroupStatistics;
+    }>;
+    totalCount: number;
+}
 export interface GroupsRepository {
     create(groupData: Group): Promise<Group>;
     findById(groupId: number): Promise<Group | null>;
     update(groupId: number, updates: Group): Promise<Group | null>;
     findAll(): Promise<Group[]>;
     delete(groupId: number): Promise<void>;
+    /**
+     * Find public groups with pagination, search, and sorting
+     * @param options Query options for filtering, pagination, and sorting
+     * @returns Paginated list of public groups with statistics
+     */
+    findPublicGroups(options: FindPublicGroupsOptions): Promise<PublicGroupsResult>;
+    /**
+     * Update statistics for a specific group
+     * @param groupId The group ID
+     * @param updates Partial statistics to update
+     */
+    updateStatistics(groupId: number, updates: Partial<GroupStatistics>): Promise<void>;
 }

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

@@ -11,6 +11,8 @@ function toDomain(doc) {
         timezone: doc.timezone,
         isMessageLast: doc.isMessageLast,
         language: doc.language,
+        isPublic: doc.isPublic ?? false,
+        statistics: doc.statistics ?? { seasonsCount: 0, eventsCount: 0, matchesCount: 0, participantsCount: 0 },
     });
 }
 function toDoc(group) {
@@ -21,5 +23,7 @@ function toDoc(group) {
         timezone: group.getTimezone(),
         isMessageLast: group.getIsMessageLast(),
         language: group.getLanguage(),
+        isPublic: group.getIsPublic(),
+        statistics: group.getStatistics(),
     };
 }

package/dist/repositories/mongo/group.repository.d.ts

@@ -1,5 +1,5 @@
 import type { Model } from "mongoose";
-import type { GroupsRepository } from "../../ports/groups.repository";
+import type { GroupsRepository, FindPublicGroupsOptions, PublicGroupsResult, GroupStatistics } from "../../ports/groups.repository";
 import type { GroupDoc } from "../../mongo";
 import { Group } from "../../domain/group";
 export declare class MongoGroupsRepository implements GroupsRepository {
@@ -10,4 +10,6 @@ export declare class MongoGroupsRepository implements GroupsRepository {
     update(groupId: number, updates: Group): Promise<Group | null>;
     findAll(): Promise<Group[]>;
     delete(groupId: number): Promise<void>;
+    findPublicGroups(options: FindPublicGroupsOptions): Promise<PublicGroupsResult>;
+    updateStatistics(groupId: number, updates: Partial<GroupStatistics>): Promise<void>;
 }

package/dist/repositories/mongo/group.repository.js

@@ -96,5 +96,98 @@ class MongoGroupsRepository {
             throw new errors_1.QueryError('delete', 'Group', groupId, error);
         }
     }
+    async findPublicGroups(options) {
+        try {
+            const { page, limit, search, sort } = options;
+            const skip = (page - 1) * limit;
+            // Build query
+            const query = { isPublic: true };
+            // Add search filter if provided
+            if (search) {
+                query.groupName = { $regex: search, $options: 'i' }; // Case-insensitive search
+            }
+            // Build sort object based on sort parameter
+            let sortObj = {};
+            switch (sort) {
+                case 'lastActivity':
+                    sortObj = { updatedAt: -1 }; // Descending (newest first)
+                    break;
+                case 'name':
+                    sortObj = { groupName: 1 }; // Ascending (A-Z)
+                    break;
+                case 'members':
+                    // Sort by participants array length
+                    // Note: This is approximate - for exact sorting, use aggregation pipeline
+                    sortObj = { participants: -1 }; // Descending (most members first)
+                    break;
+                case 'games':
+                    // Sort by denormalized matchesCount
+                    sortObj = { 'statistics.matchesCount': -1 }; // Descending (most games first)
+                    break;
+            }
+            // Execute query
+            const groups = await this.GroupModel
+                .find(query)
+                .select('groupId groupName updatedAt participants statistics')
+                .sort(sortObj)
+                .skip(skip)
+                .limit(limit)
+                .lean()
+                .exec();
+            const totalCount = await this.GroupModel.countDocuments(query);
+            return {
+                groups: groups.map(g => ({
+                    groupId: g.groupId,
+                    groupName: g.groupName,
+                    updatedAt: g.updatedAt, // guaranteed to exist with timestamps: true
+                    statistics: {
+                        seasonsCount: g.statistics?.seasonsCount ?? 0,
+                        eventsCount: g.statistics?.eventsCount ?? 0,
+                        matchesCount: g.statistics?.matchesCount ?? 0,
+                        participantsCount: g.participants.length,
+                    },
+                })),
+                totalCount,
+            };
+        }
+        catch (error) {
+            throw new errors_1.QueryError('findPublicGroups', 'Group', 'public', error);
+        }
+    }
+    async updateStatistics(groupId, updates) {
+        try {
+            // Validate input
+            if (!groupId || groupId === 0) {
+                throw new errors_1.ValidationError('Group', 'groupId', groupId, 'must be a non-zero number');
+            }
+            if (!updates || Object.keys(updates).length === 0) {
+                throw new errors_1.ValidationError('Group', 'updates', updates, 'updates object cannot be empty');
+            }
+            // Build update object with proper nesting
+            const updateObj = {};
+            if (updates.seasonsCount !== undefined) {
+                updateObj['statistics.seasonsCount'] = updates.seasonsCount;
+            }
+            if (updates.eventsCount !== undefined) {
+                updateObj['statistics.eventsCount'] = updates.eventsCount;
+            }
+            if (updates.matchesCount !== undefined) {
+                updateObj['statistics.matchesCount'] = updates.matchesCount;
+            }
+            if (updates.participantsCount !== undefined) {
+                updateObj['statistics.participantsCount'] = updates.participantsCount;
+            }
+            const result = await this.GroupModel.updateOne({ groupId }, { $set: updateObj });
+            if (result.matchedCount === 0) {
+                throw new errors_1.EntityNotFoundError('Group', groupId, 'updateStatistics');
+            }
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError || error instanceof errors_1.EntityNotFoundError) {
+                throw error;
+            }
+            throw new errors_1.QueryError('updateStatistics', 'Group', groupId, error);
+        }
+    }
 }
 exports.MongoGroupsRepository = MongoGroupsRepository;

package/dist/types/shared.d.ts

@@ -71,6 +71,12 @@ export interface SelectedParticipantsDate {
 export interface RatingPoint {
     value: number;
     changedAt: Date;
+    source: RatingSource;
+}
+export declare enum RatingSource {
+    ADMIN_MANUAL = "ADMIN_MANUAL",
+    GAME_RESULT = "GAME_RESULT",
+    SYSTEM = "SYSTEM"
 }
 export declare const ACHIEVEMENTS: {
     readonly WinStreak: {

package/dist/types/shared.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ACHIEVEMENTS = exports.PlayerPosition = void 0;
+exports.ACHIEVEMENTS = exports.RatingSource = exports.PlayerPosition = void 0;
 var PlayerPosition;
 (function (PlayerPosition) {
     PlayerPosition["FW"] = "FW";
@@ -9,6 +9,12 @@ var PlayerPosition;
     PlayerPosition["GK"] = "GK";
     PlayerPosition["UN"] = "UN";
 })(PlayerPosition || (exports.PlayerPosition = PlayerPosition = {}));
+var RatingSource;
+(function (RatingSource) {
+    RatingSource["ADMIN_MANUAL"] = "ADMIN_MANUAL";
+    RatingSource["GAME_RESULT"] = "GAME_RESULT";
+    RatingSource["SYSTEM"] = "SYSTEM";
+})(RatingSource || (exports.RatingSource = RatingSource = {}));
 exports.ACHIEVEMENTS = {
     WinStreak: {
         emoji: '🔥',

package/dist/utils/rating.d.ts

@@ -1,4 +1,4 @@
-import { RatingPoint } from "../types";
-export declare function addRating(rating: ReadonlyArray<RatingPoint>, newValue: number, date?: Date): RatingPoint[];
+import { RatingPoint, RatingSource } from "../types";
+export declare function addRating(rating: ReadonlyArray<RatingPoint>, newValue: number, date: Date | undefined, source: RatingSource): RatingPoint[];
 export declare function latestEntry(rating: ReadonlyArray<RatingPoint>): RatingPoint | null;
 export declare function getCurrentRating(rating?: ReadonlyArray<RatingPoint>): number;

package/dist/utils/rating.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.addRating = addRating;
 exports.latestEntry = latestEntry;
 exports.getCurrentRating = getCurrentRating;
-function addRating(rating, newValue, date = new Date()) {
-    return [...rating, { value: newValue, changedAt: date }];
+function addRating(rating, newValue, date = new Date(), source) {
+    return [...rating, { value: newValue, changedAt: date, source }];
 }
 function latestEntry(rating) {
     if (!rating || rating.length === 0)

package/package.json

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