ballrush-core 0.5.1 → 0.5.3

package/dist/mongo/index.d.ts

@@ -9,3 +9,4 @@ export * from "./schemas/stat-group-last-100-games.schema";
 export * from "./schemas/stat-group-activity-chart.schema";
 export * from "./schemas/stat-user-profile.schema";
 export * from "./schemas/stat-user-match-history.schema";
+export * from "./schemas/stat-event.schema";

package/dist/mongo/index.js

@@ -25,3 +25,4 @@ __exportStar(require("./schemas/stat-group-last-100-games.schema"), exports);
 __exportStar(require("./schemas/stat-group-activity-chart.schema"), exports);
 __exportStar(require("./schemas/stat-user-profile.schema"), exports);
 __exportStar(require("./schemas/stat-user-match-history.schema"), exports);
+__exportStar(require("./schemas/stat-event.schema"), exports);

package/dist/mongo/schemas/stat-event.schema.d.ts

@@ -0,0 +1,96 @@
+import { Schema } from "mongoose";
+/**
+ * Mongoose document interface for StatEventPlayer
+ */
+export interface StatEventPlayerDoc {
+    userId: number;
+    playerName: string;
+    avatarUrl: string;
+    position: string;
+}
+/**
+ * Mongoose document interface for StatEventTeam
+ */
+export interface StatEventTeamDoc {
+    teamId: number;
+    teamName: string;
+    totalPoints: number;
+    avgTeamRating: number;
+    players: StatEventPlayerDoc[];
+}
+/**
+ * Mongoose document interface for StatEventStandingsRow
+ */
+export interface StatEventStandingsRowDoc {
+    rank: number;
+    teamName: string;
+    played: number;
+    wins: number;
+    draws: number;
+    losses: number;
+    goalsFor: number;
+    goalsAgainst: number;
+    goalDifference: number;
+    points: number;
+}
+/**
+ * Mongoose document interface for StatEventMatch
+ */
+export interface StatEventMatchDoc {
+    matchId: number;
+    matchNumber: number;
+    time: string;
+    status: string;
+    team1Name: string;
+    team1Score: number;
+    team2Name: string;
+    team2Score: number;
+}
+/**
+ * Mongoose document interface for StatEventHeader
+ */
+export interface StatEventHeaderDoc {
+    status: 'Finished' | 'In Progress' | 'Upcoming';
+    seasonName: string;
+    groupName: string;
+    eventName: string;
+    date: Date;
+    timeRange: string;
+    location: string;
+    winnerName: string | null;
+}
+/**
+ * Mongoose document interface for StatEventOverviewStats
+ */
+export interface StatEventOverviewStatsDoc {
+    totalGoals: number;
+    goalsPerMatch: number;
+}
+/**
+ * Mongoose document interface for StatEventOverview
+ */
+export interface StatEventOverviewDoc {
+    stats: StatEventOverviewStatsDoc;
+    standings: StatEventStandingsRowDoc[];
+    teams: StatEventTeamDoc[];
+}
+/**
+ * Mongoose document interface for StatEvent
+ */
+export interface StatEventDoc {
+    eventId: number;
+    header: StatEventHeaderDoc;
+    overview: StatEventOverviewDoc;
+    matches: StatEventMatchDoc[];
+    calculatedAt: Date;
+    version: number;
+}
+/**
+ * Factory function to create StatEvent schema
+ * Collection: stat_events
+ */
+export declare function createStatEventSchema(): Schema<StatEventDoc, import("mongoose").Model<StatEventDoc, any, any, any, import("mongoose").Document<unknown, any, StatEventDoc> & StatEventDoc & {
+    _id: import("mongoose").Types.ObjectId;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, StatEventDoc, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<StatEventDoc>> & import("mongoose").FlatRecord<StatEventDoc> & {
+    _id: import("mongoose").Types.ObjectId;
+}>;

package/dist/mongo/schemas/stat-event.schema.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStatEventSchema = createStatEventSchema;
+const mongoose_1 = require("mongoose");
+/**
+ * Factory function to create StatEvent schema
+ * Collection: stat_events
+ */
+function createStatEventSchema() {
+    const PlayerSchema = new mongoose_1.Schema({
+        userId: { type: Number, required: true },
+        playerName: { type: String, required: true },
+        avatarUrl: { type: String, required: true },
+        position: { type: String, required: true },
+    }, { _id: false });
+    const TeamSchema = new mongoose_1.Schema({
+        teamId: { type: Number, required: true },
+        teamName: { type: String, required: true },
+        totalPoints: { type: Number, required: true, min: 0, default: 0 },
+        avgTeamRating: { type: Number, required: true, min: 0, default: 0 },
+        players: { type: [PlayerSchema], default: [] },
+    }, { _id: false });
+    const StandingsRowSchema = new mongoose_1.Schema({
+        rank: { type: Number, required: true, min: 1 },
+        teamName: { type: String, required: true },
+        played: { type: Number, required: true, min: 0, default: 0 },
+        wins: { type: Number, required: true, min: 0, default: 0 },
+        draws: { type: Number, required: true, min: 0, default: 0 },
+        losses: { type: Number, required: true, min: 0, default: 0 },
+        goalsFor: { type: Number, required: true, min: 0, default: 0 },
+        goalsAgainst: { type: Number, required: true, min: 0, default: 0 },
+        goalDifference: { type: Number, required: true, default: 0 },
+        points: { type: Number, required: true, min: 0, default: 0 },
+    }, { _id: false });
+    const MatchSchema = new mongoose_1.Schema({
+        matchId: { type: Number, required: true },
+        matchNumber: { type: Number, required: true, min: 1 },
+        time: { type: String, required: true },
+        status: { type: String, required: true },
+        team1Name: { type: String, required: true },
+        team1Score: { type: Number, required: true, min: 0, default: 0 },
+        team2Name: { type: String, required: true },
+        team2Score: { type: Number, required: true, min: 0, default: 0 },
+    }, { _id: false });
+    const HeaderSchema = new mongoose_1.Schema({
+        status: { type: String, enum: ['Finished', 'In Progress', 'Upcoming'], required: true },
+        seasonName: { type: String, required: true },
+        groupName: { type: String, required: true },
+        eventName: { type: String, required: true },
+        date: { type: Date, required: true },
+        timeRange: { type: String, required: true },
+        location: { type: String, required: true },
+        winnerName: { type: String, default: null },
+    }, { _id: false });
+    const OverviewStatsSchema = new mongoose_1.Schema({
+        totalGoals: { type: Number, required: true, min: 0, default: 0 },
+        goalsPerMatch: { type: Number, required: true, min: 0, default: 0 },
+    }, { _id: false });
+    const OverviewSchema = new mongoose_1.Schema({
+        stats: { type: OverviewStatsSchema, required: true },
+        standings: { type: [StandingsRowSchema], default: [] },
+        teams: { type: [TeamSchema], default: [] },
+    }, { _id: false });
+    const StatEventSchema = new mongoose_1.Schema({
+        eventId: { type: Number, required: true, unique: true, index: true },
+        header: { type: HeaderSchema, required: true },
+        overview: { type: OverviewSchema, required: true },
+        matches: { type: [MatchSchema], default: [] },
+        calculatedAt: { type: Date, default: Date.now },
+        version: { type: Number, required: true, default: 1, min: 1 },
+    }, {
+        collection: 'stat_events',
+        versionKey: false,
+    });
+    // Index for fast lookup by eventId
+    StatEventSchema.index({ eventId: 1 }, { unique: true });
+    // Index for cache invalidation by calculatedAt
+    StatEventSchema.index({ calculatedAt: -1 });
+    return StatEventSchema;
+}

package/dist/mongo/schemas/stat-group-season.schema.d.ts

@@ -20,10 +20,15 @@ export interface StatGroupSeasonParticipantDoc {
 export interface StatGroupSeasonDoc {
     groupId: number;
     seasonName: string;
+    totalMatches: number;
+    totalGoals: number;
+    averageGoalsPerMatch: number;
+    totalEvents: number;
+    totalParticipants: number;
     participants: StatGroupSeasonParticipantDoc[];
     startDate: Date;
     endDate: Date | null;
-    status: 'in_progress' | 'completed';
+    status: 'upcoming' | 'in_progress' | 'ended';
     updatedAt: Date;
 }
 /**

package/dist/mongo/schemas/stat-group-season.schema.js

@@ -22,10 +22,15 @@ function createStatGroupSeasonSchema() {
     const StatGroupSeasonSchema = new mongoose_1.Schema({
         groupId: { type: Number, required: true, index: true },
         seasonName: { type: String, required: true },
+        totalMatches: { type: Number, required: true, min: 0, default: 0 },
+        totalGoals: { type: Number, required: true, min: 0, default: 0 },
+        averageGoalsPerMatch: { type: Number, required: true, min: 0, default: 0 },
+        totalEvents: { type: Number, required: true, min: 0, default: 0 },
+        totalParticipants: { type: Number, required: true, min: 0, default: 0 },
         participants: { type: [ParticipantSchema], default: [] },
         startDate: { type: Date, required: true },
         endDate: { type: Date, default: null },
-        status: { type: String, enum: ['in_progress', 'completed'], required: true },
+        status: { type: String, enum: ['upcoming', 'in_progress', 'ended'], required: true },
         updatedAt: { type: Date, default: Date.now },
     }, {
         collection: 'stat_group_seasons',

package/dist/ports/index.d.ts

@@ -9,3 +9,4 @@ 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-event.repository";

package/dist/ports/index.js

@@ -25,3 +25,4 @@ __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-event.repository"), exports);

package/dist/ports/stat-event.repository.d.ts

@@ -0,0 +1,14 @@
+import { StatEvent } from "../types/stat-event.types";
+/**
+ * Repository interface for StatEvent
+ * Provides pre-aggregated event data including standings, statistics,
+ * and enriched rosters/matches for the Event Page
+ */
+export interface StatEventRepository {
+    /**
+     * Finds complete event data by event ID
+     * @param eventId - The event ID
+     * @returns Complete event data or null if not found
+     */
+    findEventById(eventId: number): Promise<StatEvent | null>;
+}

package/dist/ports/stat-event.repository.js

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

package/dist/repositories/index.d.ts

@@ -9,3 +9,4 @@ 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-event.repository";

package/dist/repositories/index.js

@@ -25,3 +25,4 @@ __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-event.repository"), exports);

package/dist/repositories/mongo/stat-event.repository.d.ts

@@ -0,0 +1,13 @@
+import type { Model } from "mongoose";
+import type { StatEventRepository } from "../../ports/stat-event.repository";
+import type { StatEventDoc } from "../../mongo/schemas/stat-event.schema";
+import type { StatEvent } from "../../types/stat-event.types";
+/**
+ * MongoDB implementation of StatEventRepository
+ * Provides read-only access to pre-aggregated event data
+ */
+export declare class MongoStatEventRepository implements StatEventRepository {
+    private readonly model;
+    constructor(model: Model<StatEventDoc>);
+    findEventById(eventId: number): Promise<StatEvent | null>;
+}

package/dist/repositories/mongo/stat-event.repository.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoStatEventRepository = void 0;
+const errors_1 = require("../../errors");
+/**
+ * MongoDB implementation of StatEventRepository
+ * Provides read-only access to pre-aggregated event data
+ */
+class MongoStatEventRepository {
+    constructor(model) {
+        this.model = model;
+    }
+    async findEventById(eventId) {
+        try {
+            // Validate input
+            if (!eventId || eventId === 0) {
+                throw new errors_1.ValidationError('StatEvent', 'eventId', eventId, 'must be a non-zero number');
+            }
+            // Find event by ID
+            const doc = await this.model
+                .findOne({ eventId })
+                .lean();
+            if (!doc) {
+                return null;
+            }
+            // Map document to domain type
+            return {
+                eventId: doc.eventId,
+                header: {
+                    status: doc.header.status,
+                    seasonName: doc.header.seasonName,
+                    groupName: doc.header.groupName,
+                    eventName: doc.header.eventName,
+                    date: doc.header.date,
+                    timeRange: doc.header.timeRange,
+                    location: doc.header.location,
+                    winnerName: doc.header.winnerName,
+                },
+                overview: {
+                    stats: {
+                        totalGoals: doc.overview.stats.totalGoals,
+                        goalsPerMatch: doc.overview.stats.goalsPerMatch,
+                    },
+                    standings: doc.overview.standings.map(s => ({
+                        rank: s.rank,
+                        teamName: s.teamName,
+                        played: s.played,
+                        wins: s.wins,
+                        draws: s.draws,
+                        losses: s.losses,
+                        goalsFor: s.goalsFor,
+                        goalsAgainst: s.goalsAgainst,
+                        goalDifference: s.goalDifference,
+                        points: s.points,
+                    })),
+                    teams: doc.overview.teams.map(t => ({
+                        teamId: t.teamId,
+                        teamName: t.teamName,
+                        totalPoints: t.totalPoints,
+                        avgTeamRating: t.avgTeamRating,
+                        players: t.players.map(p => ({
+                            userId: p.userId,
+                            playerName: p.playerName,
+                            avatarUrl: p.avatarUrl,
+                            position: p.position,
+                        })),
+                    })),
+                },
+                matches: doc.matches.map(m => ({
+                    matchId: m.matchId,
+                    matchNumber: m.matchNumber,
+                    time: m.time,
+                    status: m.status,
+                    team1Name: m.team1Name,
+                    team1Score: m.team1Score,
+                    team2Name: m.team2Name,
+                    team2Score: m.team2Score,
+                })),
+                calculatedAt: doc.calculatedAt,
+                version: doc.version,
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError) {
+                throw error;
+            }
+            throw new errors_1.QueryError('findEventById', 'StatEvent', eventId, error);
+        }
+    }
+}
+exports.MongoStatEventRepository = MongoStatEventRepository;

package/dist/repositories/mongo/stat-group-season.repository.js

@@ -25,6 +25,11 @@ class MongoStatGroupSeasonRepository {
             return docs.map(doc => ({
                 groupId: doc.groupId,
                 seasonName: doc.seasonName,
+                totalMatches: doc.totalMatches,
+                totalGoals: doc.totalGoals,
+                averageGoalsPerMatch: doc.averageGoalsPerMatch,
+                totalEvents: doc.totalEvents,
+                totalParticipants: doc.totalParticipants,
                 participants: doc.participants.map(p => ({
                     userId: p.userId,
                     playerName: p.playerName,

package/dist/types/index.d.ts

@@ -5,3 +5,4 @@ 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-event.types";

package/dist/types/index.js

@@ -21,3 +21,4 @@ __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-event.types"), exports);

package/dist/types/stat-event.types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Statistics: Event Page Types
+ * Pre-aggregated event data with standings, statistics, and enriched rosters/matches
+ */
+export interface StatEventPlayer {
+    userId: number;
+    playerName: string;
+    avatarUrl: string;
+    position: string;
+}
+export interface StatEventTeam {
+    teamId: number;
+    teamName: string;
+    totalPoints: number;
+    avgTeamRating: number;
+    players: StatEventPlayer[];
+}
+export interface StatEventStandingsRow {
+    rank: number;
+    teamName: string;
+    played: number;
+    wins: number;
+    draws: number;
+    losses: number;
+    goalsFor: number;
+    goalsAgainst: number;
+    goalDifference: number;
+    points: number;
+}
+export interface StatEventMatch {
+    matchId: number;
+    matchNumber: number;
+    time: string;
+    status: string;
+    team1Name: string;
+    team1Score: number;
+    team2Name: string;
+    team2Score: number;
+}
+export interface StatEventHeader {
+    status: 'Finished' | 'In Progress' | 'Upcoming';
+    seasonName: string;
+    groupName: string;
+    eventName: string;
+    date: Date;
+    timeRange: string;
+    location: string;
+    winnerName: string | null;
+}
+export interface StatEventOverviewStats {
+    totalGoals: number;
+    goalsPerMatch: number;
+}
+export interface StatEventOverview {
+    stats: StatEventOverviewStats;
+    standings: StatEventStandingsRow[];
+    teams: StatEventTeam[];
+}
+export interface StatEvent {
+    eventId: number;
+    header: StatEventHeader;
+    overview: StatEventOverview;
+    matches: StatEventMatch[];
+    calculatedAt: Date;
+    version: number;
+}

package/dist/types/stat-event.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Statistics: Event Page Types
+ * Pre-aggregated event data with standings, statistics, and enriched rosters/matches
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/stat-group-season.types.d.ts

@@ -17,9 +17,14 @@ export interface StatGroupSeasonParticipant {
 export interface StatGroupSeason {
     groupId: number;
     seasonName: string;
+    totalMatches: number;
+    totalGoals: number;
+    averageGoalsPerMatch: number;
+    totalEvents: number;
+    totalParticipants: number;
     participants: StatGroupSeasonParticipant[];
     startDate: Date;
     endDate: Date | null;
-    status: 'in_progress' | 'completed';
+    status: 'upcoming' | 'in_progress' | 'ended';
     updatedAt: Date;
 }

package/package.json

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